smart_ide/docs/ux-navigation-model.md

Modèle UX — au-delà de l’explorateur fichiers

Renoncer à l’explorer classique

Renoncer à une vue fichiers / dossiers / explorateur ne signifie pas l’absence de structure : c’est une interface orientée intention, contexte, flux d’actions et artefacts.

Si Git est peu visible en surface, si les procédures sont déterministes, si les agents savent installer, importer et développer des outils génériques avant d’appeler l’IA, et si l’utilisateur travaille surtout via des commandes de haut niveau (ask, fix, improve, deploy, ticket, present, write, sheet, extract, think adversarial, etc.), l’explorer n’est pas remplacé par « rien », mais par des vues plus adaptées au modèle.

Ce que l’explorer faisait — et comment le redistribuer

Besoin historique (explorer)	Remplacement ciblé
Localiser physiquement les fichiers	Recherche, commandes, mémoire projet, points d’entrée contextuels
Comprendre la structure du projet	Vues sémantiques : modules, services, tickets, environnements, procédures, agents, artefacts, documents
Agir sur des objets concrets	Palette d’intentions + vues d’objets métier

Le bon niveau d’abstraction devient :

1. Ce que je veux faire
2. Sur quel objet logique
3. Avec quels droits
4. Dans quel contexte projet
5. Avec quelle procédure
6. Avec quel agent
7. Avec quel résultat attendu

→ Plus proche d’une machine de travail orientée opérations que d’un éditeur de fichiers.

Risques si l’explorer disparaît sans compensations

1. Perte de repère spatial
2. Difficulté d’inspection libre
3. Fragilité agentique si le graphe sémantique (agents, index, résumés, outils, procédures) est incomplet — l’absence d’explorer est alors vécue comme une privation, pas comme une abstraction supérieure
4. Effet boîte noire

Compensations obligatoires

Palette d’accès universelle (« go to anything »)

Trouver et ouvrir immédiatement, par nom, alias, rôle, description, historique, proximité contextuelle, permissions :

• fichier, module, service, fonction, procédure, agent, ticket, environnement, document, support de présentation, feuille, job, log, artefact généré, commande.

Vue des objets logiques

À la place d’une arborescence de fichiers : services, modules, environnements, tickets, bases, agents, recipes, tools, documents, supports, jobs, déploiements, artefacts.

L’utilisateur voit en permanence sur quoi il travaille : projet courant, tâche courante, commande active, agents impliqués, artefacts produits, documents de référence, état stable disponible, environnement concerné.

Recherche structurée (au-delà du grep fichiers)

Capacité de chercher dans : code, symboles, recettes, outils, historiques de session, tickets, documents, logs, artefacts ONLYOFFICE, métadonnées / références aux documents gérés par Local Office (API services/local-office/), sorties d’agents, mémoire AnythingLLM.

Vue artefacts

Artefacts récents et liés au contexte courant : scripts, documents, feuilles, présentations, tickets, logs, plans, sorties diverses.

Vue timeline / stream

Ce n’est pas la liste des fichiers, mais les actions : lancé, lu, généré, échoué, disponible, repris.

Types d’objets ouvrables

• Texte : source, config, script, note, document texte
• Logique : service, module, fonction, procédure, agent, ticket
• Exécution : job, déploiement, test, lint, run agentique, terminal de tâche
• Artefact : présentation, document, feuille, rapport, résumé, sortie de recette

Navigation sans penser « répertoire », en pensant « objet ».

Arborescence vs graphe

L’explorer repose sur un arbre. Le système cible un graphe : ticket → agents → recettes → scripts → artefacts → projet → environnements → procédures → documents → support → ticket, etc.

Rendre visible : structure logique, objets importants, actions disponibles, relations, état courant, artefacts récents modifiés, sorties d’agents, points d’entrée, chemins de reprise.

Conditions de réussite

1. Indexation solide : fichiers, symboles, modules, services, tickets, scripts, recettes, documents, artefacts, historiques
2. Palette universelle exceptionnelle
3. Recherche plein texte + sémantique
4. Vues contexte + timeline fiables
5. Mémoire projet fiable (AnythingLLM par projet + synchro)
6. Commandes principales réellement suffisantes au quotidien
7. Mode expert / secours pour accéder au niveau bas (y compris vue fichiers brute) si l’abstraction haute échoue

Ne pas supprimer totalement l’explorer du produit : le retirer de l’interface normale, mais garder un accès discret / désactivable par défaut si indexation, relations ou agents déraillent.

Trois niveaux proposés

Niveau	Rôle
Principal	Pas d’explorer classique ; commandes, recherche, contexte, timeline, objets logiques, artefacts
Secondaire	Vue « structure » non arborescente : services, modules, objets, procédures
Expert	Accès secours à la structure brute (fichiers / répertoires), discret, éventuellement désactivé par défaut

Grammaire des commandes

Plus l’explorer disparaît de la surface, plus les commandes doivent être rigoureuses :

• ask — interrogation du graphe de connaissances et d’objets
• fix — réparation guidée (tests), sans obligation de « trouver le fichier » manuellement
• improve — optimisation sur objet logique ou contexte courant
• deploy — action sur environnement et procédure, pas sur un répertoire
• ticket — entrée de navigation métier
• present, write, sheet — générateurs d’artefacts liés au contexte logique du projet
• extract — extraction structurée depuis sources / documents / contexte
• think adversarial — revue ou stress test (sécurité, hypothèses, angles de défaillance) sur l’objet ou le livrable courant

Synthèse : pas d’explorer comme surface principale ; navigation par intentions, recherche, objets logiques, timeline et artefacts ; accès brut réservé au mode expert.

Chaîne UX cible (rappel)

Éditeur → orchestrateur UX → runtime sécurisé → agents ia_dev → sous-agents → (préparation / scripts / tools) → IA avec éléments demandés → réponse intégrée à l’IDE.

L’explorer est remplacé par mieux : palette universelle, navigation par objets, vue contexte, timeline, recherche puissante, vue artefacts, niveau expert de secours.