ldc-arcadia-genesis-php-client/documentation/IncoStuffIntelligence.md

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é.