Developer conventions: logic keys on reference-table IDs, never on label strings (labels are translated and can change; IDs never do). README EN + FR, llms.txt

Author: BenGlut

docs/developers/README.md

@@ -95,6 +95,14 @@ flowchart LR
  own format version for backward compatibility.
 - **Naming** — self-describing names over encoded/clever ones; no
  multi-state magic values.
+- **IDs, never labels** — any logic that depends on a value from the
+ reference tables (`id_aspect`, `id_brand`, `id_material`, `id_type`,
+ `id_diameter`, `id_measure_unit`, `id_version`…) compares its **numeric ID**,
+ never its label as a string. A label is display text: it is translated, it
+ can be renamed or corrected in the reference database, and it reads
+ differently in every language — an ID never changes. Keep the ID next to the
+ label, name the IDs you branch on (e.g. aspect `Tricolor 24`, `Rainbow 145`,
+ `Bicolor 252`), and use labels for display only.
 - **Colour** — a spool's colour is stored as data, not as a picture, so every
  surface must turn that data into the same picture:
  [the material swatch convention](./material-swatch.md) is normative, and

i18n/fr/developers/README.md

@@ -1,5 +1,5 @@
 ---
-sourceHash: 8ae1c06de17fcd742ec5955b2ae95cc97016fada033c19b74bb58ac0e04bce58
+sourceHash: dbd78eb2f02db455a2f9d0c54788c50a84b2c83b37d02e49d90f48adbd504d71
 sourcePath: docs/developers/README.md
 ---
 
@@ -108,6 +108,15 @@ flowchart LR
  rétrocompatibilité.
 - **Nommage** — des noms auto-descriptifs plutôt qu'encodés ou astucieux ; pas
  de valeurs magiques à états multiples.
+- **Des ID, jamais des libellés** — toute logique qui dépend d'une valeur des
+ tables de référence (`id_aspect`, `id_brand`, `id_material`, `id_type`,
+ `id_diameter`, `id_measure_unit`, `id_version`…) compare son **ID
+ numérique**, jamais son libellé sous forme de chaîne. Un libellé est un texte
+ d'affichage : il est traduit, il peut être renommé ou corrigé dans la base de
+ référence, et il se lit différemment dans chaque langue — un ID ne change
+ jamais. Gardez l'ID à côté du libellé, nommez les ID sur lesquels vous
+ branchez (par ex. aspect `Tricolor 24`, `Rainbow 145`, `Bicolor 252`), et
+ réservez les libellés à l'affichage.
 - **Couleur** — la couleur d'une bobine est stockée comme une donnée, pas comme
  une image, donc chaque surface doit transformer cette donnée en la même image :
  [la convention de la pastille de matière](./material-swatch.md) est normative,

llms.txt

@@ -302,7 +302,10 @@ brand using TigerTag, and of spools makers tag themselves at home.
 - [Products](docs/products/README.md): one page per product
 - [Compatibility](docs/compatibility/README.md): per-brand printer links + native RFID formats
 - [Compatible third-party hardware](docs/compatibility/third-party-hardware.md): the growing list — ACR122U, AJAX-3D TD-1/TD1s, DYMO/HID USB scales, blank NTAG chips
-- [Developers](docs/developers/README.md): repo map, SDKs, cloud integration
+- [Developers](docs/developers/README.md): repo map, SDKs, cloud integration.
+ NORMATIVE convention: logic on a reference-table value (id_aspect, id_brand,
+ id_material, id_type…) compares the numeric ID, NEVER the label string —
+ labels are translated and can be renamed, IDs never change
 - [The material swatch](docs/developers/material-swatch.md): NORMATIVE — how spool
  colour data becomes a picture (bicolor and tricolor = 135° soft split — solid colours, 20 % blended seam — 4+ hard
  colours = camembert, rainbow/declared gradient = 135° ramp; convention v1.2;