# Data plateforme flturbo.dev

> Données de référence du site, exposées en lecture seule par une API PostgREST. Trois environnements de données, même API, même structure : dev (synthétique ou extrait), staging (anonymisé), prod (réel). Une appli lit l'URL de base dans la variable DATA_API_URL.

URL de base : dev = https://data-dev.flturbo.dev ; staging = https://data-staging.flturbo.dev ; prod = https://data-prod.flturbo.dev
Règles pour une application :
- Ne jamais copier ces données dans une base applicative : interroger l'API (ou lire les fichiers bruts dans MinIO).
- Une URL par dataset et par table : GET {base}/{dataset}/{table}?col=eq.valeur&select=a,b&order=a.desc&limit=50&offset=0 ; opérateurs eq, neq, gt, gte, lt, lte, like, ilike, in.(a,b), is.null ; en-tête "Prefer: count=exact" pour le total ; réponse JSON tableau d'objets.
- Si l'accès est "authentifié" ou "restreint", envoyer Authorization: Bearer <jeton> (variable DATA_API_TOKEN).
- Chaque dataset ci-dessous a un responsable ; les échantillons ne contiennent jamais de donnée réelle.
- Catalogue lisible par machine : https://data.flturbo.dev/catalog.json ; OpenAPI d'un dataset : {base}/{dataset}/ sur chaque environnement.

## Avis de non-conformité (dataset anc)

Avis de non-conformité : exports JSON de l'outil qualité, un fichier par ANC (objet article imbriqué, lignes de défaut en liste). Exemple de dataset poussé par fichiers JSON et zip, lié au référentiel articles.
Responsable : Marie Martin (@mmartin). Criticité : medium. Classification : internal.
Environnements : dev (nature sample, accès open, rafraîchi on_push) ; prod (nature real, accès restricted, rafraîchi daily).
### Endpoint /anc/anc (table anc, 15 lignes en dev)
Clé primaire : numero
Colonnes :
- article__ref (text)
- numero (text, non null) : Numéro d'ANC
- date_ouverture (text)
- atelier (text) : Atelier émetteur (USINAGE, MONTAGE, TRAITEMENT)
- statut (text)
- gravite (bigint)
- article__famille (text)
Exemple : GET https://data-prod.flturbo.dev/anc/anc?select=article__ref,numero,date_ouverture,atelier&limit=20
### Endpoint /anc/anc__lignes (table anc__lignes, 21 lignes en dev)
Colonnes :
- defaut (text)
- quantite (bigint)
Exemple : GET https://data-prod.flturbo.dev/anc/anc__lignes?select=defaut,quantite&limit=20

## Référentiel articles (dataset ref_articles)

Articles fabriqués et achetés du site, extraits de l'ERP. Un article = une référence unique (ref_article), une désignation, une famille technique, un statut (ACT actif, OBS obsolète), une unité et un poids. Sert de référentiel commun aux applications de production et de qualité.
Responsable : Jean Dupont (@jdupont). Criticité : high. Classification : internal.
Environnements : dev (nature synthetic, accès open, rafraîchi on_push) ; staging (nature anonymized, accès open, rafraîchi monthly) ; prod (nature real, accès open, rafraîchi weekly).
### Endpoint /ref_articles/articles (table articles, 300 lignes en dev)
Un enregistrement par article, actifs et obsolètes confondus.
Clé primaire : ref_article
Colonnes :
- ref_article (text, non null) : Référence ERP, 8 caractères, peut commencer par 0
- designation (text) : Libellé court de l'article
- famille (text) : Famille technique : ARBRE, ENGRENAGE, CARTER, ROULEMENT, VISSERIE
- type_article (text) : FAB (fabriqué) ou ACH (acheté)
- unite (text) : Unité de gestion : PCE, KG, M
- poids_kg (double) : Poids unitaire en kilogrammes
- statut (text) : ACT actif, OBS obsolète
- date_creation (date) : Date de création dans l'ERP
- prix_standard (double) : Prix standard HT en euros, arrondi en staging
- fournisseur (text) : Fournisseur principal (articles achetés), masqué en staging
Exemple : GET https://data-prod.flturbo.dev/ref_articles/articles?select=ref_article,designation,famille,type_article&limit=20