Inventory/docs/superpowers/specs/2026-03-31-reference-formula-builder-design.md

Spec : Formula Builder interactif pour la référence auto

Date : 2026-03-31 Scope : Frontend uniquement (pas de changement backend) Fichier impacté : frontend/app/components/model-types/ModelTypeForm.vue

Problème

L'utilisateur doit taper manuellement les noms exacts des custom fields dans la formule ({serie}{diametre}{type}) et re-lister les champs requis séparés par des virgules. C'est sujet aux erreurs de typo et peu ergonomique.

Solution

Remplacer la section "Génération de référence automatique" du ModelTypeForm par un formula builder interactif.

Composants UI

1. Chips de champs disponibles

• Afficher une rangée de boutons-chips avec les noms des custom fields définis dans pieceStructure.customFields
• Cliquer sur un chip insère {nom_du_champ} dans l'input formule à la position du curseur
• Si pieceStructure.customFields est vide, afficher un message "Aucun champ personnalisé défini"

2. Input formule

• Input texte classique (comme aujourd'hui) mais avec les chips comme aide à la saisie
• L'utilisateur peut aussi taper du texte libre (séparateurs -, /, préfixes SNU , etc.)
• Le format stocké reste {nom_du_champ} — aucun changement de format backend

3. Suppression du champ "Champs requis"

• Le champ requiredFieldsForReference est calculé automatiquement au submit en extrayant tous les {...} de la formule
• Suppression de l'input "Champs requis" et de la variable requiredFieldsInput
• La logique : tous les champs présents dans la formule sont requis. Si un champ n'a pas de valeur → pas de référence générée

4. Aperçu live

• Conserver l'aperçu existant mais l'améliorer : remplacer les placeholders par des valeurs d'exemple en majuscules
• Exemples par type de champ : text → VALEUR, number → 123, select → OPTION, boolean → OUI, date → 2026-01-01

Comportement

• Insert au curseur : quand l'utilisateur clique un chip, le placeholder est inséré à selectionStart de l'input, pas à la fin
• Formule vide : si la formule est vide, pas de référence auto (comportement actuel conservé)
• Readonly : les chips sont désactivés en mode readonly (comme l'input)
• Pas de custom fields : si aucun champ n'est défini dans la structure, la section reste visible mais les chips sont remplacés par un message informatif. L'utilisateur peut quand même taper une formule manuellement (cas edge)

Format de sortie (inchangé)

{
  referenceFormula: "SNU {serie}-{diametre}/{type}" | null,
  requiredFieldsForReference: ["serie", "diametre", "type"] | null  // auto-calculé
}

Pas de changement

• Backend (ReferenceAutoGenerator, ReferenceAutoSubscriber, entités) : aucun changement
• Format de stockage de la formule : identique ({placeholder} strings)
• API : identique