Kill_LIFE/specs/yiacad_uiux_apple_native_spec.md

Spec - YiACAD UI/UX Apple-native

Contexte

YiACAD est une app independante pilotee par la lane IA-native de Kill_LIFE. KiCad, FreeCAD et les runtimes CAD restent des moteurs integres de la plateforme YiACAD. La presente spec cadre la refonte UI/UX Apple-native du shell YiACAD.

Ancrages canoniques 2026-03-29:

• specs/yiacad_2026_stack_target_spec.md
• specs/yiacad_adr_20260329_sot.md
• specs/yiacad_90_day_delivery_plan.md

Objectifs

• unifier l'experience YiACAD desktop, web et cockpit autour d'une architecture coherente;
• rendre les actions review, sync, inspect et artifacts immédiatement accessibles;
• intégrer l’IA comme assistance contextualisée, traçable et révocable;
• aligner la hiérarchie visuelle sur les patterns Apple/macOS actuels.

Non-objectifs

• ne pas réécrire immédiatement les noyaux ECAD/MCAD;
• ne pas faire de KiCad ou FreeCAD le shell produit principal;
• ne pas auto-appliquer des correctifs IA sur les modèles CAD.

Principes UX

• clarity: navigation lisible, faible bruit, labels explicites;
• context: détails et suggestions dans l’inspector, pas dans des modales en cascade;
• focus: toolbar courte, actions primaires visibles, secondaires dans la palette;
• traceability: chaque sortie IA renvoie vers les artefacts et preuves;
• reversibility: aucune action destructive implicite.

Architecture fonctionnelle

flowchart LR
  Sidebar["Sidebar taches"] --> Canvas["YiACAD project view"]
  Toolbar["Toolbar"] --> Canvas
  Palette["Palette commandes"] --> Canvas
  Canvas --> Inspector["Inspector contextuel"]
  Inspector --> AI["IA contextualisée"]
  AI --> Artifacts["Artifacts / logs / preuves"]

Capacités clés

Capability	Description	Entrée	Sortie
review.erc_drc	lancer et résumer ERC + DRC	board + schematic	rapports JSON + digest
review.bom	exporter et auditer une BOM	schematic	CSV + résumé des champs vides
sync.ecad_mcad	exporter les artefacts STEP croisés	board + document FreeCAD	STEP + résumé de sync
status.surface	exposer l’état YiACAD	artefacts existants	snapshot markdown
ai.explain	expliquer un warning/signal	sélection utilisateur	explication + provenance

Contrat d’intégration IA

• l’IA n’est qu’une couche d’assistance;
• toutes les suggestions doivent être rattachées à une preuve ou à un artefact;
• les commandes doivent rester utilisables sans modèle distant;
• les sorties doivent être enregistrées dans artifacts/cad-ai-native/.

Instrumentation

• surfaces utilisateur: shell YiACAD, TUI cockpit et futurs clients web;
• utilitaires concrets: tools/cad/yiacad_native_ops.py;
• backend partage: tools/cad/yiacad_backend_service.py et tools/cad/yiacad_backend_client.py;
• TUI de pilotage: tools/cockpit/yiacad_uiux_tui.sh;
• documentation de référence: docs/YIACAD_APPLE_UI_UX_*.

Mesures de succès

• temps moyen pour lancer une review réduit;
• nombre d’étapes manuelles entre CAD et artefacts réduit;
• état et provenance compréhensibles sans lire les scripts;
• convergence visuelle entre le shell YiACAD, le web et le cockpit.

Plan de livraison

Phase 1

• audit, spec, feature map, recherche, plan et TODO;
• shell app autonome + contrats de sortie;
• TUI dédiée UI/UX.
• socle desktop-first authoring sur KiCad >= 10.0 et FreeCAD >= 1.1.

Phase 2

• command palette;
• review center;
• inspector contextuel.

Phase 3

• stabilisation des moteurs integres CAD et des imports/exports;
• extension vers App Intents / automatisation locale lorsque la pile est prete;
• raccord complet plugin KiCad, workbench FreeCAD, et lanes Linux KiBot / KiAuto.