From f9364a896029e526e53a50847041e972c8326e8b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=A9r=C3=A9my=20Munsch?= Date: Thu, 20 Aug 2026 11:46:37 +0200 Subject: [PATCH] docs(Arcadia): add JSON examples for INCO legacy API Added example JSON files for INCO API endpoints to provide clear references for data structure and expected values. --- .../exampleIncoCompoSelectAll.json | 187 ++++++++++ .../exampleIncoSelectAll.json | 335 ++++++++++++++++++ .../Arcadia/IncoStuffIntelligence.md | 279 +++++++++++++++ 3 files changed, 801 insertions(+) create mode 100644 documentation/Arcadia/Exemples de l'api Legacy/exampleIncoCompoSelectAll.json create mode 100644 documentation/Arcadia/Exemples de l'api Legacy/exampleIncoSelectAll.json create mode 100644 documentation/Arcadia/IncoStuffIntelligence.md diff --git a/documentation/Arcadia/Exemples de l'api Legacy/exampleIncoCompoSelectAll.json b/documentation/Arcadia/Exemples de l'api Legacy/exampleIncoCompoSelectAll.json new file mode 100644 index 0000000..fc88299 --- /dev/null +++ b/documentation/Arcadia/Exemples de l'api Legacy/exampleIncoCompoSelectAll.json @@ -0,0 +1,187 @@ +{ + "VAL_ENERG_KCAL_R": "300", + "VAL_ENERG_KJ_P": "", + "VAL_ENERG_KCAL_P": "", + "VAL_ENERG_KJ_R": "1251", + "NUT_VITB12": "", + "POINTS_PROTEINES": "", + "POURCENT_APPORT_REF_FATSAT_P": "", + "NUT_FVALERIQ": "", + "NUT_WHEY": "", + "NUT_FHENTRIACONTYLIQ": "", + "NUT_FAPULC": "", + "POINTS_AGS": "", + "NUT_GLUS": "", + "NUT_F20D4": "", + "NUT_F19D": "", + "NUT_F20D5N3": "", + "ID": "44897", + "NUT_FLAURIQ": "", + "MAT_GRASS_R": "17", + "NUT_FFORMIQ": "", + "MAT_GRASS_P": "", + "NUT_INOTL": "", + "NUT_MALTDEX": "", + "AGS_R_PREC": "0", + "NUT_SUCS": "", + "NUT_FAPUN6": "", + "POURCENT_FNL_FRAIS": "", + "NUT_FHEXTRIACONTYLIQ": "", + "NUT_FERUCIQ": "", + "NUT_FAPUN9": "", + "NUT_NITRA": "", + "CLASSEMENT": "D", + "POINTS_SUCRES": "", + "NUT_CHOL": "", + "NUT_CHOCAL": "", + "NUT_CHOLN": "", + "NUT_FAPUN3": "", + "NUT_FCAPRYLIQ": "", + "NUT_VITE": "", + "NUT_VITD": "", + "NUT_VITC": "", + "POURCENT_APPORT_REF_KJO_P": "", + "NUT_F18D3N3": "", + "AGS_R": "7", + "NUT_VITA": "", + "NUT_F18D": "", + "SOURCE": "1", + "SEL_P": "", + "SEL_P_PREC": "", + "NUT_FPELARGONIQ": "", + "NUT_VITK": "", + "NUT_FRUS": "", + "NUT_FBUTYRIQ": "", + "NUT_FE": "", + "SEL_R": "1.4", + "NUT_NUCLEOTIDE": "", + "NUT_FD": "", + "POURCENT_APPORT_REF_FAT_P": "", + "NUT_BIOT": "", + "NUT_FIBSOL": "", + "POURCENT_APPORT_REF_PRO_P": "", + "NUT_FCEROTIQ": "", + "MAT_GRASS_R_PREC": "0", + "NUT_PANTAC": "", + "NUT_MG": "", + "NUT_G_HC": "", + "NUT_TAU": "", + "SEL_R_PREC": "0", + "GLUCIDES_R_PREC": "0", + "TAILLE_REF": "100", + "POURCENT_APPORT_REF_E14_P": "", + "NUT_FCARBOCERIQ": "", + "NUT_FLACEROIQ": "", + "FIB_ALIM_R": "1.3", + "FIB_ALIM_P": "", + "NUT_FPENTADECYLIQ": "", + "NUT_FBEHENIQ": "", + "NUT_FNONACOSYLIQ": "", + "NUT_FPSYLLIQ": "", + "NUT_F18D2CN6": "", + "NUT_FUNDECYLIQ": "", + "NUT_FAPUCIS": "", + "NUT_FMARGARIQ": "", + "PROTEINE_R": "11", + "NUT_MO": "", + "POINTS_SEL": "", + "NUT_MN": "", + "PROTEINE_P": "", + "NUT_F11EICO": "", + "SUCRE_R": "1.5", + "SUCRE_P": "", + "SUCRE_R_PREC": "0", + "NUT_FPALM": "", + "NUT_FGEDDIQ": "", + "NUT_FMYRISTIQ": "", + "APPORT_PORT": "Apport de r\u00e9f\u00e9rence pour un adulte type (8400Kj-2000Kcal)", + "NUT_CU": "", + "SCORE_NUTRI": "14", + "NUT_CR": "", + "NUT_MALS": "", + "NUT_F16D0": "", + "NUT_FOCTATRIACONTYLIQ": "", + "NUT_FRUFB": "", + "NUT_CASN": "", + "NUT_FMONTANIQ": "", + "POINTS_ENERGIE": "", + "FRUITS_R": "0", + "COMPOSANTE_N_2022": "", + "VIANDE_ROUGE": "", + "NUT_POLYL": "", + "NUT_VITB6": "", + "NUTRI_A_ART": "", + "PROTEINE_P_PREC": "", + "NUT_STARCH": "", + "P_SUR_L": ",65", + "NUT_RIBF": "", + "SODIUM_P": "", + "NUT_FENATIQ": "", + "NUT_K": "", + "NUT_FTRIDECYLIQ": "", + "SUCRE_P_PREC": "", + "NUT_SE": "", + "NUT_FTRICOSILIQ": "", + "NUT_P": "", + "SODIUM_R": "560", + "NUT_FARACHIDIQ": "", + "NUT_FPROPIONIQ": "", + "NUT_FNERVONIQ": "", + "SCORE_NUTRI_2022": "", + "NUT_FNONADYLIQUE": "", + "FIB_ALIM_P_PREC": "", + "NUT_CA": "", + "NUT_FMELISSIQ": "", + "GLUCIDES_P_PREC": "", + "POURCENT_FRUITS": "0", + "NUT_OLSAC": "", + "COMPOSANTE_P": "6", + "GLUCIDES_P": "", + "NUT_ZN": "", + "COMPOSANTE_N": "15", + "GLUCIDES_R": "25", + "NUT_FCEROPLASTIQ": "", + "FNL_FRAIS": "", + "NOM": "-", + "NUT_AAE": "", + "NUT_FSTEARIQ": "", + "TAILLE_PORT": "", + "POURCENT_APPORT_REF_CHOVAL_P": "", + "AGS_P_PREC": "", + "PROTEINE_R_PREC": "0", + "NUT_FCAPROIQ": "", + "NUT_S6": "", + "MAT_GRASS_P_PREC": "", + "NUT_FHEPTATRIACONTYLIQ": "", + "NUT_FAMSCIS": "", + "NUT_ID": "", + "NUT_CARNITINE": "", + "POINTS_FIBRES": "", + "AGS_P": "", + "NUT_FOLDFE": "", + "COMPOSANTE_P_2022": "", + "NUT_GALFB": "", + "NUT_CLD": "", + "NUT_THIA": "", + "POURCENT_APPORT_REF_SALTEQ_P": "", + "NUT_FHENEICOSYLIQ": "", + "NUT_FOLEIQ": "", + "NUT_AGT": "", + "POINTS_FNL_FRAIS": "", + "NUT_FACETIQ": "", + "NUT_NIA": "", + "NUT_FCAPRIQ": "", + "NUT_F22D6N3": "", + "FIB_ALIM_R_PREC": "0", + "NUTRI_SCORE_2022": "", + "NUT_LACS": "", + "POURCENT_APPORT_REF_SUGAR_P": "", + "NUMERO": "-", + "ID_INCO": { + "code": "77310", + "libelle": "SC 240GFX PALET CHEVR SOIGN IQF" + }, + "FRUITS_COQUE_SECH_R": "0", + "NUT_FHYENIQ": "", + "NUT_FLIGNOCERIQ": "" +} diff --git a/documentation/Arcadia/Exemples de l'api Legacy/exampleIncoSelectAll.json b/documentation/Arcadia/Exemples de l'api Legacy/exampleIncoSelectAll.json new file mode 100644 index 0000000..de7981f --- /dev/null +++ b/documentation/Arcadia/Exemples de l'api Legacy/exampleIncoSelectAll.json @@ -0,0 +1,335 @@ +{ + "VILLE_GRPMT_QUAL": "", + "DATEVERSION": "2022-03-07", + "TYP_PORTION": "2", + "NB_PORTION_QUAL": "", + "CAP4_AVANTAGE": "", + "EX_GOUT": "", + "ALIMENTATION": "", + "COMM_MKT": "", + "GRAM_ENT_CARCERAL": "", + "ANTIBIO": "", + "NOM_GRPMT_QUAL": "", + "DENOM_COMM": "Farce \u00e0 base de viande de dinde et de gras de dinde ayant fait l\u2019objet d\u2019un broyage, additionn\u00e9 \u00e0 une pr\u00e9paration aromatisante.", + "GRPMT_QUAL": "", + "NUTRISCORE_ON_PACK": "D", + "CALIBRE_OEUFS": "", + "AFF_DVT_FT": "", + "AROME_ARTIF": "", + "POIDS_MOYEN_UNI": "", + "REGLEMENTATION": "", + "PMC_EURO_UVC": "0", + "DATE_STATUT_QUAL": "2022-10-26", + "AROME_NATUREL": "", + "BRIQUE_GPC": { + "code": "10005784", + "libelle": "Dinde - Pr\u00e9par\u00e9e\/Transform\u00e9e" + }, + "CRIT_PHYSICO": "", + "DAT_CRE": "2017-06-29T16:12:00Z", + "AW": "", + "LIB_CONSO": "", + "AGEMINI": "", + "NB_PORTION": "\/", + "CONDI_SS_AP": "0", + "NB_ADDITIF_BLACKLIST": "0", + "UTIL_QUAL": { + "code": "SC4911560", + "libelle": "CHAUVEAU Severine" + }, + "GRAM_ENT_ELEM": "", + "PMC_MINI": "", + "MENTION_COMPL": "", + "CAP4_PREUVE": "", + "COLOR_ARTIF": "", + "UNITE_CDE": "0", + "GRAM_ENT_MATERN": "", + "NB_UVC": "", + "CONDIT_EMB": { + "code": "2", + "libelle": "SOUS VIDE" + }, + "CONDIT_CONSERV_1": "A conserver entre 0\u00b0C et +4\u00b0C", + "LIB_SERV_CONSO": "LE GAULOIS PROFESSIONNEL", + "DLC_RM": "", + "DLC_COMM_GRP": "10", + "POURCENT_CEREAL_MINI": "", + "ID_SERV_CONSO": { + "code": "2161", + "libelle": "LE GAULOIS PROFESSIONNEL" + }, + "COMM_COMPO": "", + "GRAM_ENT_ADO": "", + "CP_EXPLOIT": "61140", + "VILLE_EXPLOIT": "Rives d andaine", + "GRAM_ENT_AGEES": "", + "PAYS_ORIGINE_PROV_ING1": "", + "COD_FAMRGPT": { + "code": "4", + "libelle": "PRODUITS ELAB CRUS" + }, + "IS_HALAL": "0", + "UTIL_MKT": "", + "ADR_2_SERV_CONSO": "", + "FICHE_MERE": { + "code": "44863", + "libelle": "" + }, + "CONSEIL_PREPA": "A consommer cuit \u00e0 c\u0153ur\nUne farce de volaille \u00e0 utiliser au gr\u00e9 de vos envies pour farcir des l\u00e9gumes, des volailles, des r\u00f4tis\u2026", + "INNOVATION": "0", + "TRACES_SIT_PROD": "", + "POIDS_CST": "0", + "TYPE_STOCK": "", + "COMM_REF_COMPO": "", + "ALLEGAT_AUTRE": "", + "GENCOD_SYMBOL": "2667277", + "LONGUEUR": "400", + "IS_PAM": "0", + "FICH_REF_COMPO": "0", + "ALLEGATIONS": "", + "NO_HOMOLOGATION": "", + "ALLEGATION_MKT": "", + "IONISATION": "Aucun ingr\u00e9dients ionis\u00e9 dans cette recette.", + "STATUT_QUAL": "1", + "CAP2_AVANTAGE": "", + "DAT_MAJ": "2025-06-26T14:16:00Z", + "GRAM_PLAT_ELEM": "", + "ARG_VENTE": "Une farce de volaille moelleuse \u00e0 utiliser au gr\u00e9 de vos envies pour farcir des l\u00e9gumes, des volailles, des r\u00f4tis\u2026", + "COLORANT_NATUREL": "", + "CAP2_PREUVE": "", + "SS_FAMILLE_VTE": { + "code": "77", + "libelle": "FARCES" + }, + "POIDS_MAXI": "2700", + "SOC_REF_INCO": { + "code": "13", + "libelle": "SNV" + }, + "TRACES_RCT": [ + { + "code": "21", + "libelle": "Aucun allerg\u00e8ne" + } + ], + "CP_SERV_CONSO": "49640", + "CAP4_CARAC": "", + "CIBLE": "famille", + "CALIBRE": "", + "PDS_NET_UVC": "2500", + "PDS_BRUT_UVC": "2518", + "ADRESSE_OC": "", + "SIGLE_ALLERG": "", + "CONSEIL_PREPA_1": "A consommer cuit \u00e0 c\u0153ur", + "CONSEIL_PREPA_2": "Une farce de volaille \u00e0 utiliser au gr\u00e9 de vos envies pour farcir des l\u00e9gumes, des volailles, des r\u00f4tis\u2026", + "PROD_BIO": "0", + "REF_COMPO": { + "code": "44863", + "libelle": "" + }, + "NB_MUT_SHORT_LIST": "1", + "CP_GRPMT_QUAL": "", + "SAUCE": "", + "GRAM_PLAT_CARCERAL": "", + "LST_MUT": [ + { + "code": "7", + "libelle": "dextrose" + }, + { + "code": "11", + "libelle": "ar\u00f4me" + } + ], + "DESCRIPTIF": "Farce de volaille", + "TYPE_PRODUCTION": "", + "ALLEGAT_NUTRIT": "", + "PESTICIDE": "", + "DATE_JOUR_PONTE": "", + "LIBELLE_ARTICLE_INCO": "KG - LE GAULOIS PRO - 2.5KG FARCE POUR LEGUMES PURE DINDE S\/V", + "UPDATE_VERSION": "1", + "LST_ING": "Viande de dinde (origine France): 66%, gras de dinde, \u00e9chalote, conservateur: lactate de potassium, sel, persil, dextrose, betterave en poudre, oignon, ar\u00f4mes naturels, \u00e9pices, antioxydants: acide ascorbique - ascorbate de sodium, sucre.", + "LOGO_EXPLOIT": "SNV.png<\/a>", + "VISUEL_SUGG_PRESENTATION": "", + "ADRESSE_GRPMT_QUAL": "", + "L_ALLEG_NUTRITION": "0", + "COD_GENCOD_POIDS": "2767277", + "COD_EMBAL": { + "code": "44", + "libelle": "SOUS VIDE POCHE" + }, + "COMM_VOL_FERM": "", + "DENOM_LEG": "FARCE DE VOLAILLE POUR LEGUME PURE DINDE", + "NUM_AGR": "", + "COD_NDP": { + "code": "02072610", + "libelle": "DDE MRX DESOS FRAIS" + }, + "ART_COMM_ACTIF": "1", + "PROD_SAISON": "0", + "COMM_TARE_SUPPL": "", + "COD_COMPOSTAGE": "1", + "LARGEUR": "300", + "DATE_STATUT_CMCL": "2019-03-13", + "DEMARCHE_QUAL": "", + "FREQ_UTIL": "", + "NB_ADDITIF_TROUVE": "3", + "NITRITE": "", + "CLASSEMENT": "D", + "CRIT_ORGANO": "", + "CAP3_AVANTAGE": "", + "TYPE_CONSERV": { + "code": "1", + "libelle": "FRAIS : [0oC,4oC]" + }, + "GENCOD": "3571320448638", + "LST_ALLERGENE": [ + { + "code": "21", + "libelle": "Aucun allerg\u00e8ne" + } + ], + "CP_OC": "", + "ALLEGAT_SANTE": "", + "UTIL_CMCL": { + "code": "JJ2400325", + "libelle": "Jouin Joel" + }, + "RESIDU_PESTICIDE": "", + "PDS_MOY_THEO": "2500", + "NB_MUT_TROUVE": "2", + "TARE_BARQ": "18", + "GARNITURE": "", + "VILLE_OC": "", + "CAP2_CARAC": "", + "LST_ADDITIF_BLACKLISTES": "", + "COMMENTAIRE_PROCESS": "", + "GRAM_PLAT_MATERN": "", + "NO_ART": { + "code": "44863", + "libelle": "FARCE PR LEG PUR DDE 2.5KG SV LGP" + }, + "SPCB": "", + "EXTRA_FRAICHEUR": "", + "ISGENETICALMODIFIED": "", + "GRAM_PLAT_ADO": "", + "ALIM_ELEVAGE": "", + "PMC_EURO_KG": "1", + "ISNOTPLEINAIR": "", + "CAP3_CARAC": "", + "PMC_MAXI": "", + "DATE_STATUT_MKT": "2019-03-13", + "SITE_INT_SERV_CONSO": "www.legauloisprofessionnel.fr", + "OGM": "Conforme aux r\u00e8glements CE n\u00b0 1829\/2003 et n\u00b0 1830\/2003 : Produit Conventionnel.", + "CAP1_PREUVE": "", + "TARE_SUPPL": "", + "VERSION": "1", + "EXPLOITANT": { + "code": "13", + "libelle": "SNV" + }, + "NOM_FONCT_INCO_ART": "Volailles & gibiers", + "NUTRI_A_ART": "1", + "RESIDU_CONTAMIN": "Conforme au r\u00e8glement CE 2023\/915 et ses modifications", + "SANS_OGM": "", + "ADRESSE_EXPLOIT": "447 route de la chevroliere", + "SEL_AJOUTE": "", + "COD_RAYON": { + "code": "6", + "libelle": "BOUCHERIE TRAD" + }, + "LIST_NUM_AGREMENT": "FR 41.238.001 CE", + "LIST_COD_EMBAL": "EMB41238", + "COMM_NUTRI": "1", + "DUREE_VIE": "17", + "CAP1_AVANTAGE": "", + "TYPE_PAL": { + "code": "1", + "libelle": "Europe" + }, + "LIST_CERTIF": "IFS FOOD", + "CRIT_MICROBIO_J0": "", + "CAP1_CARAC": "", + "CARAC_ELEVAGE": "1", + "FAMILLE_VTE": { + "code": "313", + "libelle": "FARCE" + }, + "ETIQ_DONNEES_INCO": "2", + "MAIL_SERV_CONSO": "rhd@ldc.fr", + "NOM_SERV_CONSO": "GUILLET", + "INTERPROFESSION": [ + { + "code": "13", + "libelle": "VOLAILLE FRANCAISE (logo homologue APVF)" + } + ], + "NUTRISCORE_ON_PACK_QUALITE": "D", + "VILLE_SERV_CONSO": { + "code": "49119", + "libelle": "DAUMERAY" + }, + "STATUT_CMCL": "1", + "NOM_EXPLOITANT": "SNV", + "MARQUE": { + "code": "504", + "libelle": "LE GAULOIS PROFESSIONNEL" + }, + "UNITE_FACT": "2", + "VIAND_POISS": "", + "ASTUCES": "", + "DTS": "7", + "TEL_SERV_CONSO": "0241325665", + "ACTIVE": "1", + "SITE_REF_INCO": { + "code": "34", + "libelle": "SNV - VOLABRAYE" + }, + "CAP3_PREUVE": "", + "HAUTEUR": "80", + "CRIT_MICROBIO": "Selon r\u00e8glement europ\u00e9en CE n\u00b0 2073\/2005 du 15\/11\/2005 compl\u00e9t\u00e9 avec des normes internes.", + "SUIVI_MODIF": "", + "LIBELLE_FACTURE_ARTICLE": "2.5 KG FARCE POUR LEGUMES PURE DINDE SOUS VIDE LE GAULOIS PROFESSIONNEL", + "NOM_OC": "", + "FAX_SERV_CONSO": "", + "CONDIT_CONSERV": "A conserver entre 0\u00b0C et +4\u00b0C\n", + "ADR_1_SERV_CONSO": "ZA Le Grand Clos", + "CRIT_MICROBIO_DLC": "", + "ORG_CERTIF": "", + "GRAM_PLAT_AGEES": "", + "LST_MUT_SHORTLIST": [ + { + "code": "7", + "libelle": "dextrose" + } + ], + "LIB_TYP_EMB": "SOUS VIDE POCHE", + "PMC": "", + "IS_CALCUL_GEMRCN": "", + "AGE_ABATT_MOY": "", + "POIDS_MINI": "2300", + "LST_ADDITIF": [ + { + "code": "E326", + "libelle": "lactate de potassium" + }, + { + "code": "E301", + "libelle": "Ascorbate de sodium" + }, + { + "code": "E300", + "libelle": "Acide ascorbique" + } + ], + "NUTRI_SCORE_2022": "D", + "REF_RCT": "", + "ELEVAGE": "", + "PH": "", + "STATUT_MKT": "1", + "UTILISABLE_GROUPE": { + "code": "1", + "libelle": "Oui" + }, + "VIP": "" +} diff --git a/documentation/Arcadia/IncoStuffIntelligence.md b/documentation/Arcadia/IncoStuffIntelligence.md new file mode 100644 index 0000000..ac73e44 --- /dev/null +++ b/documentation/Arcadia/IncoStuffIntelligence.md @@ -0,0 +1,279 @@ +# Classification Inco demandée a TOTO GPT + +Voici une classification des champs en catégories sémantiques cohérentes pour des données nutritionnelles INCO : + +--- + +## 🏷️ Classification des champs nutritionnels + +### 1. **Identification / Métadonnées** +| Champ PHP | Constante | Description | +|---|---|---| +| `nom` | `NOM` | Nom du produit/fiche | +| `numero` | `NUMERO` | Numéro de la fiche | +| `source` | `SOURCE` | Source des données | + +--- + +### 2. **Valeurs énergétiques — par 100g/100ml (référence `_R`)** +| Champ PHP | Constante | Description | +|---|---|---| +| `tailleReference` | `TAILLE_REF` | Taille de la portion de référence | +| `valEnergKjReference` | `VAL_ENERG_KJ_R` | Énergie en kJ / 100g | +| `valEnergKcalReference` | `VAL_ENERG_KCAL_R` | Énergie en kcal / 100g | + +--- + +### 3. **Macronutriments — par 100g/100ml (`_R`) + précisions (`_PREC`)** +| Champ PHP | Constante | Description | +|---|---|---| +| `matGrassReference` / `matGrassReferencePrec` | `MAT_GRASS_R` | Matières grasses / 100g | +| `acideGrasSatureReference` / `acideGrasSatureReferencePrec` | `AGS_R` | Acides gras saturés / 100g | +| `glucidesReference` / `glucidesReferencePrec` | `GLUCIDES_R` | Glucides / 100g | +| `sucreReference` / `sucreReferencePrec` | `SUCRE_R` | Sucres / 100g | +| `fibAlimReference` / `fibAlimReferencePrec` | `FIB_ALIM_R` | Fibres alimentaires / 100g | +| `proteineReference` / `proteineReferencePrec` | `PROTEINE_R` | Protéines / 100g | +| `selReference` / `selReferencePrec` | `SEL_R` | Sel / 100g | +| `sodiumReference` | `SODIUM_R` | Sodium / 100g | + +--- + +### 4. **Fruits, légumes, noix — par 100g/100ml (`_R`)** +| Champ PHP | Constante | Description | +|---|---|---| +| `fruitsReference` | `FRUITS_R` | Teneur en fruits / 100g | +| `fruitsCoqueSechReference` | `FRUITS_COQUE_SECH_R` | Fruits à coque et séchés / 100g | +| `pourcentFruits` | `POURCENT_FRUITS` | % fruits (global) | + +--- + +### 5. **Valeurs nutritionnelles — par portion (`_P`) + précisions (`_PREC`)** +| Champ PHP | Constante | Description | +|---|---|---| +| `taillePortion` | `TAILLE_PORT` | Taille de la portion | +| `valEnergKjPortion` | `VAL_ENERG_KJ_P` | Énergie kJ / portion | +| `valEnergKcalPortion` | `VAL_ENERG_KCAL_P` | Énergie kcal / portion | +| `matGrassPortion` / `matGrassPortionPrec` | `MAT_GRASS_P` | Matières grasses / portion | +| `acideGrasSaturePortion` / `acideGrasSaturePortionPrec` | `AGS_P` | Acides gras saturés / portion | +| `glucidesPortion` / `glucidesPortionPrec` | `GLUCIDES_P` | Glucides / portion | +| `sucrePortion` / `sucrePortionPrec` | `SUCRE_P` | Sucres / portion | +| `fibAlimPortion` / `fibAlimPortionPrec` | `FIB_ALIM_P` | Fibres / portion | +| `proteinePortion` / `proteinePortionPrec` | `PROTEINE_P` | Protéines / portion | +| `sodiumPortion` | `SODIUM_P` | Sodium / portion | +| `selPortion` / `selPortionPrec` | `SEL_P` | Sel / portion | +| `fruitsPortion` | `FRUITS_P` | Fruits / portion | +| `fruitsCoqueSechPortion` | `FRUITS_COQUE_SECH_P` | Fruits à coque et séchés / portion | + +--- + +### 6. **Pourcentages des apports de référence (`POURCENT_APPORT_REF_*`)** +| Champ PHP | Constante | Description | +|---|---|---| +| `pourcentApportRefE14P` | `POURCENT_APPORT_REF_E14_P` | % AR énergie E14 / portion | +| `pourcentApportRefKjoP` | `POURCENT_APPORT_REF_KJO_P` | % AR énergie kJ / portion | +| `pourcentApportRefFatP` | `POURCENT_APPORT_REF_FAT_P` | % AR matières grasses / portion | +| `pourcentApportRefFatsatP` | `POURCENT_APPORT_REF_FATSAT_P` | % AR graisses saturées / portion | +| `pourcentApportRefChovalP` | `POURCENT_APPORT_REF_CHOVAL_P` | % AR glucides / portion | +| `pourcentApportRefSugarP` | `POURCENT_APPORT_REF_SUGAR_P` | % AR sucres / portion | +| `pourcentApportRefProP` | `POURCENT_APPORT_REF_PRO_P` | % AR protéines / portion | +| `pourcentApportRefSalteqP` | `POURCENT_APPORT_REF_SALTEQ_P` | % AR sel / portion | + +--- + +### 7. **Nutri-Score** +| Champ PHP | Constante | Description | +|---|---|---| +| `composanteN` | `COMPOSANTE_N` | Composante négative (énergie, graisses, sucres, sel) | +| `composanteN2022` | `COMPOSANTE_N_2022` | Composante négative — algorithme 2022 | +| `composanteP` | `COMPOSANTE_P` | Composante positive (fibres, protéines, fruits) | +| `composanteP2022` | `COMPOSANTE_P_2022` | Composante positive — algorithme 2022 | +| `scoreNutri` | `SCORE_NUTRI` | Score Nutri-Score brut | +| `scoreNutri2022` | `SCORE_NUTRI_2022` | Score Nutri-Score 2022 | +| `classement` | `CLASSEMENT` | Lettre Nutri-Score (A–E) | +| `nutriScore2022` | `NUTRI_SCORE_2022` | Nutri-Score lettre — algorithme 2022 | +| `nutriAArt` | `NUTRI_A_ART` | Flag article Nutri-Score A | + +--- + +### 8. **Points de calcul du Nutri-Score** +| Champ PHP | Constante | Description | +|---|---|---| +| `pointsEnergie` | `POINTS_ENERGIE` | Points énergie | +| `pointsAcideGrasSature` | `POINTS_AGS` | Points acides gras saturés | +| `pointsSucres` | `POINTS_SUCRES` | Points sucres | +| `pointsSel` | `POINTS_SEL` | Points sel | +| `pointsFibres` | `POINTS_FIBRES` | Points fibres | +| `pointsProteines` | `POINTS_PROTEINES` | Points protéines | +| `pointsFruitsLegumesNoixFrais` | `POINTS_FNL_FRAIS` | Points fruits/noix/légumes frais | + +--- + +### 9. **FNL (Fruits, Noix, Légumes)** +| Champ PHP | Constante | Description | +|---|---|---| +| `fruitLegumeNoixFrais` | `FNL_FRAIS` | Teneur FNL frais / 100g | +| `fruitLegumeNoixFraisPortion` | `FNL_FRAIS_PORTION` | Teneur FNL frais / portion | +| `pourcentFruitsLegumesNoixFrais` | `POURCENT_FNL_FRAIS` | % FNL frais | + +--- + +### 10. **Ratio / Indicateurs complémentaires** +| Champ PHP | Constante | Description | +|---|---|---| +| `pSurL` | `P_SUR_L` | Ratio P/L (protéines sur lipides) | +| `viandeRouge` | `VIANDE_ROUGE` | Flag viande rouge (impact Nutri-Score 2022) | + +--- + +### 11. **Micronutriments détaillés (`NUT_*`)** + +Cette famille regroupe les vitamines, minéraux, acides aminés et acides gras détaillés — typiquement issus de bases comme **Ciqual** ou **FoodData Central**. + +#### 11a. Minéraux & Oligo-éléments +| Champ PHP | Constante | +|---|---| +| `nutCa` | `NUT_CA` — Calcium | +| `nutMg` | `NUT_MG` — Magnésium | +| `nutK` | `NUT_K` — Potassium | +| `nutP` | `NUT_P` — Phosphore | +| `nutCld` | `NUT_CLD` — Chlorure | +| `nutFe` | `NUT_FE` — Fer | +| `nutZn` | `NUT_ZN` — Zinc | +| `nutCu` | `NUT_CU` — Cuivre | +| `nutMn` | `NUT_MN` — Manganèse | +| `nutSe` | `NUT_SE` — Sélénium | +| `nutId` | `NUT_ID` — Iode | +| `nutCr` | `NUT_CR` — Chrome | +| `nutMo` | `NUT_MO` — Molybdène | +| `nutS6` | `NUT_S6` — Soufre | +| `nutNitra` | `NUT_NITRA` — Nitrates | + +#### 11b. Vitamines +| Champ PHP | Constante | +|---|---| +| `nutVita` | `NUT_VITA` — Vitamine A | +| `nutVitb6` | `NUT_VITB6` — Vitamine B6 | +| `nutVitb12` | `NUT_VITB12` — Vitamine B12 | +| `nutVitc` | `NUT_VITC` — Vitamine C | +| `nutVitd` | `NUT_VITD` — Vitamine D | +| `nutVite` | `NUT_VITE` — Vitamine E | +| `nutVitk` | `NUT_VITK` — Vitamine K | +| `nutChocal` | `NUT_CHOCAL` — Cholécalciférol (vit. D3) | +| `nutNia` | `NUT_NIA` — Niacine (B3) | +| `nutRibf` | `NUT_RIBF` — Riboflavine (B2) | +| `nutThia` | `NUT_THIA` — Thiamine (B1) | +| `nutPantac` | `NUT_PANTAC` — Acide pantothénique (B5) | +| `nutBiot` | `NUT_BIOT` — Biotine (B8) | +| `nutFoldfe` | `NUT_FOLDFE` — Folates équivalents (B9) | + +#### 11c. Glucides détaillés +| Champ PHP | Constante | +|---|---| +| `nutStarch` | `NUT_STARCH` — Amidon | +| `nutMaltdex` | `NUT_MALTDEX` — Maltodextrines | +| `nutSucs` | `NUT_SUCS` — Saccharose | +| `nutGlus` | `NUT_GLUS` — Glucose | +| `nutLacs` | `NUT_LACS` — Lactose | +| `nutMals` | `NUT_MALS` — Maltose | +| `nutGalfb` | `NUT_GALFB` — Galactose | +| `nutGHc` | `NUT_G_HC` — Glucides hydrates de carbone | +| `nutFrufb` | `NUT_FRUFB` — Fructose lié (fibre) | +| `nutFrus` | `NUT_FRUS` — Fructose libre | +| `nutOlsac` | `NUT_OLSAC` — Oligosaccharides | +| `nutPolyl` | `NUT_POLYL` — Polyols | +| `nutFibsol` | `NUT_FIBSOL` — Fibres solubles | +| `nutInotl` | `NUT_INOTL` — Inositol | + +#### 11d. Lipides / Acides gras détaillés +> Nomenclature lipidique standard (IUPAC / Ciqual) — `FXXdY` = chaîne carbonée XX, Y insaturations + +| Champ PHP | Constante | Nom usuel | +|---|---|---| +| `nutAgt` | `NUT_AGT` | Acides gras trans | +| `nutChol` | `NUT_CHOL` | Cholestérol | +| `nutFd` | `NUT_FD` | Lipides totaux | +| `nutFpalm` | `NUT_FPALM` | Palmitoleïque (C16:1) | +| `nutF16d0` | `NUT_F16D0` | Acide palmitique (C16:0) | +| `nutFsteariq` | `NUT_FSTEARIQ` | Acide stéarique (C18:0) | +| `nutFoleiq` | `NUT_FOLEIQ` | Acide oléique (C18:1, ω-9) | +| `nutF18d` | `NUT_F18D` | C18 insaturé (générique) | +| `nutF18d2cn6` | `NUT_F18D2CN6` | Acide linoléique (C18:2, ω-6) | +| `nutF18d3n3` | `NUT_F18D3N3` | Acide α-linolénique (C18:3, ω-3) | +| `nutF20d4` | `NUT_F20D4` | Acide arachidonique (C20:4) | +| `nutF20d5n3` | `NUT_F20D5N3` | EPA (C20:5, ω-3) | +| `nutF22d6n3` | `NUT_F22D6N3` | DHA (C22:6, ω-3) | +| `nutF11eico` | `NUT_F11EICO` | Acide gondoïque (C20:1) | +| `nutFarachidiq` | `NUT_FARACHIDIQ` | Acide arachidique (C20:0) | +| `nutFeruciq` | `NUT_FERUCIQ` | Acide érucique (C22:1) | +| `nutFlauriq` | `NUT_FLAURIQ` | Acide laurique (C12:0) | +| `nutFmyristiq` | `NUT_FMYRISTIQ` | Acide myristique (C14:0) | +| `nutFbutyriq` | `NUT_FBUTYRIQ` | Acide butyrique (C4:0) | +| `nutFcaproiq` | `NUT_FCAPROIQ` | Acide caproïque (C6:0) | +| `nutFcapryliq` | `NUT_FCAPRYLIQ` | Acide caprylique (C8:0) | +| `nutFcapriq` | `NUT_FCAPRIQ` | Acide caprique (C10:0) | +| `nutFapun3` | `NUT_FAPUN3` | AG polyinsaturés ω-3 | +| `nutFapun6` | `NUT_FAPUN6` | AG polyinsaturés ω-6 | +| `nutFapun9` | `NUT_FAPUN9` | AG polyinsaturés ω-9 | +| `nutFapucis` | `NUT_FAPUCIS` | AG polyinsaturés cis | +| `nutFapulc` | `NUT_FAPULC` | AG polyinsaturés longue chaîne | +| `nutFamscis` | `NUT_FAMSCIS` | AG monoinsaturés cis | +| `nutFacetiq` | `NUT_FACETIQ` | Acide acétique (C2:0) | +| `nutFpropioniq` | `NUT_FPROPIONIQ` | Acide propionique (C3:0) | +| `nutFvaleriq` | `NUT_FVALERIQ` | Acide valérique (C5:0) | +| `nutFcarboceriq` | `NUT_FCARBOCERIQ` | Acide carbocérique (C26:0) | +| `nutFbeheniq` | `NUT_FBEHENIQ` | Acide béhénique (C22:0) | +| `nutFlignoceriq` | `NUT_FLIGNOCERIQ` | Acide lignocérique (C24:0) | +| `nutFnervoniq` | `NUT_FNERVONIQ` | Acide nervonique (C24:1) | +| `nutFlaceroiq` | `NUT_FLACEROIQ` | Acide lacéroïque (C32:0) | +| `nutFmelissiq` | `NUT_FMELISSIQ` | Acide mélissique (C30:0) | +| `nutFmontaniq` | `NUT_FMONTANIQ` | Acide montanique (C28:0) | +| `nutFcerotiq` | `NUT_FCEROTIQ` | Acide cérotique (C26:0 alt.) | +| `nutFpsylliq` | `NUT_FPSYLLIQ` | Acide psyllique | +| `nutFgeddiq` | `NUT_FGEDDIQ` | Acide geddique (C20:1) | +| `nutFmargariq` | `NUT_FMARGARIQ` | Acide margarique (C17:0) | +| `nutFenatiq` | `NUT_FENATIQ` | Acide énanthique (C7:0) | +| `nutFformiq` | `NUT_FFORMIQ` | Acide formique (C1:0) | +| `nutFhyeniq` | `NUT_FHYENIQ` | Acide hyénique | +| `nutFrufb` | `NUT_FRUFB` | *(déjà classé glucides)* | +| `nutFrus` | `NUT_FRUS` | *(déjà classé glucides)* | +| `nutFpelargoniq` | `NUT_FPELARGONIQ` | Acide pélargonique (C9:0) | +| `nutFundecyliq` | `NUT_FUNDECYLIQ` | Acide undécylique (C11:0) | +| `nutFpentadecyliq` | `NUT_FPENTADECYLIQ` | Acide pentadécylique (C15:0) | +| `nutFtridecyliq` | `NUT_FTRIDECYLIQ` | Acide tridécylique (C13:0) | +| `nutFtricosiliq` | `NUT_FTRICOSILIQ` | Acide tétracosanoïque (C23:0) | +| `nutFnonacosyliq` | `NUT_FNONACOSYLIQ` | Acide nonacosylique (C29:0) | +| `nutFnonadylique` | `NUT_FNONADYLIQUE` | Acide nonadylique | +| `nutFheneicosyliq` | `NUT_FHENEICOSYLIQ` | Acide héneicosylique (C21:0) | +| `nutFhentriacontyliq` | `NUT_FHENTRIACONTYLIQ` | C31:0 | +| `nutFheptatriacontyliq` | `NUT_FHEPTATRIACONTYLIQ` | C37:0 | +| `nutFhextriacontyliq` | `NUT_FHEXTRIACONTYLIQ` | C36:0 | +| `nutFoctatriacontyliq` | `NUT_FOCTATRIACONTYLIQ` | C38:0 | +| `nutF19d` | `NUT_F19D` | C19 insaturé | +| `nutFoldfe` | `NUT_FOLDFE` | *(déjà classé vitamines — folates)* | + +#### 11e. Acides aminés & protéines spécifiques +| Champ PHP | Constante | Description | +|---|---|---| +| `nutAae` | `NUT_AAE` | Acides aminés essentiels (total) | +| `nutCasn` | `NUT_CASN` | Caséines | +| `nutWhey` | `NUT_WHEY` | Protéines de lactosérum | + +#### 11f. Autres composés bioactifs / spéciaux +| Champ PHP | Constante | Description | +|---|---|---| +| `nutCholn` | `NUT_CHOLN` | Choline | +| `nutCarnitine` | `NUT_CARNITINE` | Carnitine | +| `nutTau` | `NUT_TAU` | Taurine | +| `nutNucleotide` | `NUT_NUCLEOTIDE` | Nucléotides | + +--- + +## ⚠️ Points d'attention + +1. **Doublon détecté** : `'acideGrasSaturePortion' => 'AGS_P'` est déclaré **deux fois** — l'une des deux entrées sera silencieusement ignorée par PHP. + +2. **Champs `_PREC`** : Les suffixes `_PREC` semblent indiquer la **précision de mesure** (ex. `<`, `~`, tracé) — à documenter explicitement. + +3. **Champs MISSING** : Nombreux champs présents dans le référentiel INCO mais absents du mapping — notamment toute la série `POURCENT_APPORT_REF_*_R` (apports de référence pour 100g) et certains AG comme `FATSAT_R`, `CHOVAL_R`, `SUGAR_R`. + +4. **`classement` / `nutriscore`** : Vous notez vous-même que `CLASSEMENT` ne devrait pas être dans `INCO_COMPO` — à externaliser dans un objet Nutri-Score dédié.