fy59 d65f9559e6 chore(checkpoint): preserve local investigation workbench

Preserve the local graph-first investigation stack through macro V1.

Include reviewed source, tests, contracts, documentation and synthetic assets.

Retain the standalone financial V21 test foundation without runtime migration.

Runtime remains V20; operational JobStore remains V3.

Local experimental checkpoint, not a stable release.

2026-09-27 08:34:46 +02:00

4.3 KiB

Raw Permalink Blame History

Design system cible

Statut : direction TARGET, avec un poste Web local CURRENT sur fixtures SPECIMEN documenté dans WEB_WORKBENCH.md.

1. Identité

L'interface cible utilise Catppuccin Mocha avec Lavender comme accent principal. Les couleurs deviennent des tokens sémantiques, jamais des valeurs éparpillées dans les composants.

Token	Valeur initiale	Usage
`surface.base`	`#1e1e2e`	fond principal
`surface.panel`	`#181825`	panneaux et focus workspace
`surface.raised`	`#313244`	cartes, menus et sélection
`accent.primary`	`#b4befe`	action principale et focus
`text.primary`	`#cdd6f4`	contenu principal
`text.muted`	`#a6adc8`	métadonnées
`state.success`	`#a6e3a1`	succès, avec icône et texte
`state.warning`	`#f9e2af`	avertissement, avec libellé
`state.danger`	`#f38ba8`	refus ou erreur, avec explication
`relation.info`	`#89b4fa`	information/provenance

Les valeurs seront contrôlées avec les composants réels. La couleur seule ne porte jamais type, confiance, disponibilité ou erreur.

2. Espace de travail

La cible est une interface de travail, pas une collection de tableaux :

graphe central et retour immédiat au contexte global ;
barre compacte avec recherche universelle ;
panneau contextuel Focus Workspace ;
palette de commandes ;
indicateur de jobs, progression honnête et arrêt global visible ;
vue liste/table accessible utilisant les mêmes objets.

Les nouveautés sont mises en évidence sans déplacer continuellement les nœuds. Les positions épinglées et la sélection sont conservées.

Le renderer CURRENT classe les preuves en rectangles, les extractions en losanges, les observations en capsules et les entités en cercles à partir de object_kind. Une disposition déterministe par étages et colonnes rend les directions lisibles sur le réseau alimenté ; les libellés suivent le zoom et restent accessibles par sélection, voisinage, liste et recherche.

3. Actions et pivots

Le poste local emploie un menu contextuel ancré, complété par un onglet Actions. Le critère reste le coût d'interaction minimal, sous réserve de ces invariants :

alternative linéaire visible et navigation complète au clavier ;
aucune action essentielle réservée au survol ou au clic droit ;
intention, disponibilité et motif d'indisponibilité lisibles ;
contact réseau, coût éventuel et confirmation annoncés avant exécution ;
backend toujours autoritaire pour scope, policy et budget.

Le tiroir réduit ne conserve que sa barre d’accès et libère sa rangée dans la grille. Le viewport SVG est recalculé après ce redimensionnement.

4. Lecture novice et expert

Le novice voit des intentions métier et un parcours guidé : créer une enquête synthétique, ajouter un élément, comprendre son type, voir les pivots, lancer une action autorisée, examiner ses sources, revoir une hypothèse et préparer un rapport.

L'expert déroule sans changer de vérité métier : outil et version, adapter, paramètres expurgés, tentatives, brut, normalisation, transformation, règle de corrélation et provenance.

5. Composants et états

Chaque composant prévoit chargement, vide, indisponible, résultat partiel, erreur, annulation et contenu obsolète. Aucun pourcentage n'est inventé quand l'outil ne fournit pas de mesure.

Les nœuds, arêtes, tableaux, badges de confiance et états de job partagent des libellés contrôlés. L'interface rend visibles les objets masqués ou agrégés.

6. Accessibilité

ordre de focus cohérent et focus visible ;
commandes clavier documentées ;
contrastes vérifiés sur les composants réels ;
réduction des animations respectée ;
informations disponibles autrement que par couleur, forme ou mouvement ;
zoom, tailles de texte et petites largeurs testés ;
vue liste/table équivalente pour l'exploitation des objets.

7. Critères futurs observables

Les prototypes synthétiques mesureront délai de première vue, latence de sélection, fluidité du focus, mémoire, volume visible et coût du layout. Ils testeront clavier, contraste, réduction des animations, états d'erreur et écrans de tailles pertinentes. J0 ne revendique aucune performance mesurée.

4.3 KiB Raw Permalink Blame History Unescape Escape