ldc-arcadia-api/documentation/Arcadia/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é.