smart_ide/docs/ux-navigation-model.md
2026-03-21 17:43:45 +01:00

117 lines
6.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Modèle UX — au-delà de lexplorateur fichiers
## Renoncer à lexplorer classique
Renoncer à une vue fichiers / dossiers / explorateur **ne signifie pas** labsence de structure : cest une interface **orientée intention**, **contexte**, **flux dactions** 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 dappeler lIA, et si lutilisateur travaille surtout via des commandes de haut niveau (`ask`, `fix`, `improve`, `deploy`, `ticket`, `present`, `write`, `sheet`, `extract`, `think adversarial`, etc.), lexplorer nest pas remplacé par « rien », mais par des **vues plus adaptées** au modèle.
## Ce que lexplorer faisait — et comment le redistribuer
| Besoin historique (explorer) | Remplacement ciblé |
|------------------------------|-------------------|
| Localiser physiquement les fichiers | Recherche, commandes, **mémoire projet**, points dentré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 dintentions** + vues d**objets métier** |
Le bon niveau dabstraction 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 dune **machine de travail orientée opérations** que dun éditeur de fichiers.
## Risques si lexplorer disparaît sans compensations
1. **Perte de repère spatial**
2. **Difficulté dinspection libre**
3. **Fragilité agentique** si le graphe sémantique (agents, index, résumés, outils, procédures) est **incomplet** — labsence dexplorer est alors vécue comme une **privation**, pas comme une abstraction supérieure
4. **Effet boîte noire**
## Compensations obligatoires
### Palette daccè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 dune arborescence de fichiers : **services**, **modules**, **environnements**, **tickets**, **bases**, **agents**, **recipes**, **tools**, **documents**, **supports**, **jobs**, **déploiements**, **artefacts**.
Lutilisateur 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, sorties dagents, **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 nest pas la liste des fichiers, mais les **actions** : lancé, lu, généré, échoué, disponible, repris.
## Types dobjets 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
Lexplorer 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 dagents, points dentré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 labstraction haute échoue
**Ne pas supprimer totalement lexplorer du produit** : le retirer de linterface **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 dexplorer 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 lexplorer disparaît de la surface, plus les commandes doivent être **rigoureuses** :
- `ask` — interrogation du graphe de connaissances et dobjets
- `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 dartefacts 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 lobjet ou le livrable courant
Synthèse : *pas dexplorer 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 à lIDE.
Lexplorer est remplacé par **mieux** : palette universelle, navigation par objets, vue contexte, timeline, recherche puissante, vue artefacts, niveau expert de secours.