Aller au contenu

ADR : structurer Uimmo par usage et le refondre en 3 temps

Contexte

Uimmo est le design system. Tokens non sémantiques, règles d'usage non écrites, Storybook difficile à lire pour qui ne l'a pas construit, maquette et code qui divergent — P-BRI-518. Le projet vise un Uimmo exploitable par un humain et par un agent — P-BRI-518.

Le projet a été posé dans Linear le 2026-10-13 puis repris le 2026-10-14 et le 2026-10-15 — DM groupe 2026-10-13 · DM groupe 2026-10-14 · DM groupe 2026-10-15.

Options envisagées

Option A : atomic design strict (atomes, molécules, organismes)

Option B : 4 niveaux définis par l'usage

  • Avantages : un agent choisit un bloc selon ce à quoi il sert, pas selon sa taille ; colle à Storybook (Tokens, Components, Patterns) — P-BRI-518.

Décision

Option retenue : B — P-BRI-518 § Structure d'Uimmo. Statut proposed : le projet est en Backlog, sans date ni lead, et ne démarre pas avant validation de l'équipe — P-BRI-518 § Approche.

Structure

  1. Tokens : décisions de base nommées par rôle (ex. bg-canvas, pas white).
  2. Composants : briques autonomes, sans logique métier.
  3. Patterns : assemblages qui répondent à un problème d'usage — équivalent des organismes.
  4. Templates : structures de page avec emplacements ; les pages reviennent au builder.

Chaque élément a sa doc d'usage (quand l'utiliser, quand l'éviter, variantes, états). Ordre de travail du plus petit au plus gros : tokens → composants simples → composants composés → patterns → templates. Les designers ouvrent des PR, le Front merge. Le code fait foi. — P-BRI-518

Découpage Linear (3 milestones, sans date)

Milestone Périmètre Issues
Cadrer Se préparer sans rien modifier : traçabilité, choix d'un écran existant pour l'avant/après, analyse, état des lieux, Storybook lisible, grille de mesure, règles expérimentation vs exécution, non-régression BRI-2537 · BRI-2532 · BRI-2565 · BRI-2561 · BRI-2556 · BRI-2568 · BRI-2569 · BRI-2570
Pilote sur un parcours Refaire en code et en doc ce dont un parcours existant a besoin. Figma hors milestone BRI-2559 · BRI-2566 · BRI-2557 · BRI-2562 · BRI-2560 · BRI-2567 · BRI-2571 · BRI-2572
Généraliser Même méthode sur le reste, lot par lot, puis alignement Figma. Fini quand tous les composants existants sont traités ; peut déborder en 2027 BRI-2534 · BRI-2535 · BRI-2563 · BRI-2564 · BRI-2530

Source : milestones et rattachement des issues lus dans P-BRI-518 le 2026-10-15, resynchronisés le 2026-10-19.

  • Patterns / templates restants en Généraliser : pas d'issue dédiée à ce jour [à vérifier].
  • Parcours pilote : un parcours existant — milestone Pilote ; « en prod » [à vérifier] ; parcours non choisi à ce jour [à vérifier].
  • Mapping des tokens : écrit dans BRI-2559 (ancien token ou valeur brute → token sémantique, valable pour tout Uimmo). Bases : proposition issue d'un point Product Design × Front [source locale non partagée] et table V0 BRI-304 — rattachement de ces bases à BRI-2559 non écrit dans l'issue [à vérifier].
  • Notre goût : BRI-2567 formalise les principes visuels « à la Bricks » à partir des écarts du pilote, rattaché au milestone Pilote (Linear au 2026-10-19).
  • Build en code : projet séparé P-BRI-519, passage à l'échelle qui démarre après le go du pilote et sa mise en prod (BRI-2571) — P-BRI-519 § Démarrage · ADR 2026-10-16.

Conséquences

Positives attendues

  • Un humain et un agent désignent le même token — P-BRI-518.
  • Figma devient une copie conforme de Storybook (variables et composants) — P-BRI-518.

Négatives acceptées

Reversibilité

Découpage Linear modifiable ; « Rien n'est figé » — DM groupe 2026-10-15.

Métriques de succès

[outcome non formulé] — les résultats attendus du projet sont des outputs (tokens, docs, Figma aligné).

Review design

[parcours non spécifié] (parcours pilote à choisir) · [accessibilité non vérifiée].

Sources

Révisions

  • 2026-10-15 : création (proposed).
  • 2026-10-19 : milestones resynchronisés avec Linear (BRI-2568, 2569, 2570 en Cadrer ; BRI-2567, 2571, 2572 en Pilote) ; rôle de P-BRI-519 précisé.