Kill_LIFE/docs/YIACAD_APPLE_UI_UX_AUDIT_2026-03-20.md

YiACAD UI/UX Audit Apple-native - 2026-03-20

Portée

Audit de la refonte UI/UX pour YiACAD, base KiCad + FreeCAD pilotée par la lane IA-native de Kill_LIFE, aligné sur les recommandations Apple officielles disponibles au 2026-03-20.

Résumé exécutif

YiACAD possède déjà trois atouts structurels forts:

• une base outillée et traçable;
• des surfaces CAD déjà installées dans les répertoires utilisateur;
• une culture de preuve par artefacts, lots et runbooks.

Le point faible principal n’est pas l’absence de fonctions, mais leur fragmentation. Aujourd’hui, l’opérateur passe entre cockpit, plugin KiCad, workbench FreeCAD, artefacts markdown et scripts shell. La refonte UI/UX doit donc unifier l’expérience autour d’un shell cohérent, lisible, hiérarchisé, avec des actions IA visibles mais discrètes.

Points forts

• Gouvernance déjà spec-first avec plans, TODOs, artefacts et runbooks.
• Surfaces natives déjà présentes dans les répertoires utilisateur KiCad et FreeCAD.
• Utilitaires IA concrets déjà posés pour ERC/DRC, BOM Review, ECAD/MCAD Sync et Status.
• Pipeline de logs et d’artefacts déjà compatible avec une expérience “inspectable”.
• Découpage agentique permettant d’isoler clairement PM, Architect, SyncOps et désormais DesignOps-UI.

Points faibles

• Absence d’architecture d’information commune entre KiCad, FreeCAD et le cockpit.
• Boutons présents, mais hiérarchie d’action encore insuffisante: pas de command palette, pas de regroupement par tâche, peu d’états visuels.
• Trop de surfaces textuelles secondaires pour accéder à l’essentiel: l’utilisateur doit déjà savoir quoi lancer.
• Le shell IA est encore largement Python/plugin-level, pas encore compilé et natif au cœur des forks.
• Peu de conventions visuelles partagées entre status, review, sync, artifacts.

Opportunités majeures

• Unifier l’architecture en sidebar -> canvas -> inspector.
• Introduire une command palette commune pour les actions transverses.
• Transformer l’IA en couche d’assistance contextuelle, jamais en panneau bavard permanent.
• Faire du review center la destination unique pour ERC, DRC, BOM, sync, warnings, suggestions et preuves.
• Aligner les surfaces sur les patterns Apple/macOS: toolbars sobres, sidebars claires, search field centrale, inspecteurs contextuels, SF Symbols cohérents, génération IA explicitement balisée.

Recommandations Apple 2026 retenues

Structure

• Utiliser une navigation stable et visible.
• Réduire la concurrence visuelle dans la toolbar.
• Préférer les inspecteurs contextuels plutôt que des modales répétées.
• Donner à la recherche et aux commandes une place de premier rang.

IA

• Signaler explicitement quand une sortie est générée ou suggérée par IA.
• Garder l’utilisateur en contrôle de l’action finale.
• Présenter le résultat avec source, contexte, confiance et possibilité d’annulation.
• Utiliser l’IA pour accélérer la tâche, pas pour masquer l’état du système.

Architecture cible

flowchart LR
  Sidebar["Sidebar<br/>Projet / Review / Sync / Artifacts"] --> Canvas["Canvas principal<br/>EDA / MCAD / Preview / Diff"]
  Canvas --> Inspector["Inspector contextuel<br/>Props / warnings / AI suggestions / provenance"]
  Toolbar["Toolbar sémantique<br/>Search / Command / Review / Sync"] --> Canvas
  Palette["Command palette<br/>review.erc_drc / review.bom / sync.ecad_mcad / ai.explain"] --> Canvas
  AI["AI assistance lane<br/>suggest / summarize / trace"] --> Inspector
  Logs["Artifacts + logs"] --> Inspector

Carte des écarts

Surface	État actuel	Écart	Cible
KiCad plugin	boutons fonctionnels, surface modale	trop plate, peu hiérarchisée	palette + review center + inspector
FreeCAD workbench	commandes disponibles	peu de narration d’état et peu de convergence visuelle	dock d’assistance + sync panel
Cockpit	puissant mais orienté lot	peu tourné usage design quotidien	TUI dédiée UI/UX + résumés ciblés
Documentation	riche	dispersée	un corpus UI/UX relié depuis le README et le manifeste
Forks natifs	hooks directs présents	pas encore intégrés aux surfaces compilées	shell natif YiACAD

Intégration IA recommandée

Cas d’usage	Entrée	Sortie	Garde-fou
ERC/DRC Assist	board + schematic + violations	regroupement des priorités, suggestions de correction	ne jamais auto-appliquer
BOM Review	BOM exportée	manquants, duplications, champs vides	lister les preuves et les lignes concernées
ECAD/MCAD Sync	STEP KiCad + STEP FreeCAD	delta, état d’alignement, lot de preuves	conserver les deux exports bruts
AI Explain	warning sélectionné	explication + contexte + doc liée	source et confiance visibles
Review Digest	artefacts d’un lot	résumé opérateur	lien vers artefacts originaux

Phasage recommandé

P0

• stabiliser la taxonomie visuelle des actions;
• publier le shell documentaire et la TUI UI/UX;
• préparer l’intégration native des hooks dans les forks.

P1

• introduire la command palette unifiée;
• créer le review center;
• ajouter les inspecteurs contextuels KiCad/FreeCAD.

P2

• remonter ces patterns dans le code natif compilé des forks;
• ouvrir la voie à App Intents, Spotlight actions et modèles on-device lorsque la pile le permet;
• mesurer adoption, latence et taux d’usage.

Risques

• surcouche “Apple-like” superficielle sans gain métier;
• duplication entre plugin Python temporaire et shell natif futur;
• confusion si les états IA ne sont pas parfaitement explicités.

Décision de passe

La bonne trajectoire n’est pas de “repeindre” les boutons. Il faut construire un shell opératoire unique, centré sur les workflows review, sync, inspect, artifacts, avec une IA contextuelle, traçable et toujours réversible.