#0. Objet et mode d'emploi
Ce document décrit, pour chacune des douze personas du dossier de lancement, un scénario d'usage principal de bout en bout. Chaque scénario est présenté sous trois angles simultanés :
| Angle | Question à laquelle il répond |
|---|---|
| Ce que la personne voit | Quel écran, quelle route, quelle donnée affichée |
| Ce qu'elle décide | Quel arbitrage humain lui appartient — et n'appartient pas à la machine |
| Ce que le système fait | Quel endpoint réel, quelle écriture, quelle porte de gouvernance |
Chaque scénario se termine par deux sections que les dossiers de lancement omettent d'ordinaire : ce qui retient la personne sur la plateforme, et la limite honnête à lui annoncer. Une persona à qui l'on cache une limite se transforme en détracteur au premier essai.
Les identifiants WF-01 à WF-32 renvoient au document 20-workflows-bout-en-bout.md, qui porte le détail des endpoints, des codes d'erreur et des postconditions.
#0.1 Rappel des douze personas
| # | Persona | Douleur dominante | Rôle RBAC typique |
|---|---|---|---|
| P01 | Développeur / ingénieur logiciel | Reprendre du code généré dont l'intention est perdue | EDITOR |
| P02 | Product Owner / Product Manager | Écart entre ce qui a été demandé et ce qui est livré | EDITOR puis PUBLISHER |
| P03 | QA / Test Lead / SDET | Couverture de test non reliée aux exigences | EDITOR |
| P04 | Architecte logiciel ou d'entreprise | Architecture réelle inconnue et divergente du plan | EDITOR |
| P05 | CTO / VP Ingénierie, jeune pousse en croissance | Vitesse d'aujourd'hui payée par la paralysie de demain | OWNER |
| P06 | DSI / directeur TI, grande organisation | Prouver la maîtrise de l'IA à un comité et à un auditeur | ADMIN + rôle plateforme |
| P07 | Analyste d'affaires | Exigences qui meurent dans un document mort | EDITOR |
| P08 | Ops / SRE / DevOps | Déploiements sans traçabilité de décision | PUBLISHER puis ADMIN |
| P09 | Sécurité et conformité | Agents IA sans périmètre ni journal opposable | ADMIN + rôle plateforme |
| P10 | Agence, ESN ou intégrateur | Reprendre un système client sans documentation | ADMIN |
| P11 | PME, dirigeant non technique | Dépendance totale à un prestataire | VIEWER puis OWNER |
| P12 | Enseignant et étudiant | Enseigner le cycle de vie complet sans infrastructure | EDITOR |
#0.2 Vue d'ensemble — qui entre par quel maillon
Aucun diagramme à afficher
Diagramme 1 — flowchart
#P01 · Développeur ou ingénieur logiciel
| Élément | Valeur |
|---|---|
| Douleur dominante | Reprendre du code généré dont l'intention est perdue |
| Rôle RBAC typique | EDITOR |
| Surfaces principales | Routes /projects/[id]/sources, /projects/[id]/spec/[itemId], /projects/[id]/trace · vues Spéc, Graphe, Artefacts, AgentOps |
| Workflows déclenchés | WF-04, WF-05, WF-06, WF-08, WF-14, WF-23 |
| Statut des capacités mobilisées | 🟢 Livré, prouvé en production pour la rétro-ingénierie |
Scénario principal : reprendre un service dont personne ne connaît plus l'intention.
Aucun diagramme à afficher
Diagramme 2 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | Écran Sources du projet avec la liste des dépôts déclarés | Quel dépôt rattacher au projet | Enregistre une source durable ; refuse en 422 tout secret en clair, seul un chemin de coffre circule |
| 2 | Bouton de lancement d'analyse et badge d'état du travail | Le mode d'analyse | Crée un travail en état queued et planifie le traitement en tâche de fond ; répond 201 immédiatement |
| 3 | Progression : ingestion, analyse, inférence | Rien — la personne observe | Clone le dépôt en profondeur 1, analyse les fichiers Python par arbre syntaxique, range les autres langages en unsupported |
| 4 | Vue Artefacts : contexte et conteneurs, modèle de données, contrat d'interface, machines à états, séquences, dictionnaire, traçabilité | Quel artefact ouvrir | Reconstruit chaque artefact à la demande depuis les faits persistés, chacun citant son fichier:ligne |
| 5 | File de validation, candidats triés par confiance décroissante | Approuver ou rejeter chaque candidat | Une approbation crée l'objet de spécification dans la même transaction ; un rejet ne crée rien |
| 6 | Fiche d'objet de spécification avec provenance reverse:<mode> |
Corriger le titre ou les attributs | Versionne l'objet et conserve l'historique |
| 7 | Vue Graphe : traçabilité amont et aval | Où porter la modification | Calcule l'ensemble impacté sur des arêtes portant origine et preuve, imposées par la base |
| 8 | Vue Tests : critères d'acceptation non couverts | Générer les tests manquants | Produit des cas reliés aux critères, jamais des tests orphelins |
Ce qui la retient : le lien permanent entre une ligne de code et la décision qui l'a motivée, avec un locateur fichier:ligne vérifiable.
Limite honnête à lui annoncer : l'analyse profonde est Python uniquement. Un dépôt JavaScript, TypeScript, Go, Java, Ruby ou C# est reconnu, listé, puis rangé en non supporté — la plateforme ne devine rien. Le clonage s'exécute par ailleurs sans délai maximal ni plafond de taille de dépôt.
#P02 · Product Owner ou Product Manager
| Élément | Valeur |
|---|---|
| Douleur dominante | Écart entre ce qui a été demandé et ce qui est livré |
| Rôle RBAC typique | EDITOR pour rédiger, PUBLISHER pour décider et publier |
| Surfaces principales | Routes /projects/[id]/specify, /projects/[id]/feedback, /approvals · vues Spéc, Tableaux, Revue, Docs |
| Workflows déclenchés | WF-06, WF-07, WF-09, WF-11, WF-21, WF-22, WF-32 |
| Statut des capacités mobilisées | 🟢 Livré sur les trois environnements |
Scénario principal : passer d'une intention exprimée en réunion à une exigence testable et publiée.
Aucun diagramme à afficher
Diagramme 3 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | Écran Spécifier, zone de saisie libre | Comment formuler l'intention | Ouvre une exécution tracée et attribuable, gardée par la limite de vingt appels d'IA par minute |
| 2 | Flux d'événements en direct de l'exécution | Interrompre ou laisser aller | Émet les événements d'étape ; l'interruption est une route réelle et laisse la trace |
| 3 | Liste d'objets proposés, typés, non enregistrés | Retenir, modifier ou écarter chaque objet | N'écrit rien tant que la personne n'a pas tranché |
| 4 | Verdict de conformité à la grammaire EARS | Reformuler ou accepter | Valide à la génération, pas en revue tardive ; l'écart est nommé |
| 5 | Écran de revue avec le nom du soumissionnaire | Qui désigner comme décideur | Refuse en 409 toute décision dont l'auteur est le soumissionnaire ; l'interface bloque le bouton en amont |
| 6 | Vue Docs : document d'exigences et diagrammes générés | Quel format exporter | Projette depuis la spécification ; la documentation n'est jamais la source |
| 7 | Vue Tableaux : kanban par statut de cycle de vie | Quel objet faire avancer | Applique une transition contrôlée |
| 8 | Boîte de réception des retours et compteurs de votes | Quelles idées entrent dans la feuille de route | Convertit un retour retenu en objet de spécification rattaché |
| 9 | Feuille de route et journal des changements publics | Quand publier | La publication exige le rang PUBLISHER ; aucun brouillon n'est visible publiquement |
Ce qui la retient : l'écart entre le demandé et le livré devient mesurable, parce que la demande est un objet relié à ses tests et à ses artefacts.
Limite honnête à lui annoncer : la génération assistée par IA produit des propositions, jamais des exigences validées. La relecture humaine reste obligatoire, et c'est un choix de conception, pas une lacune.
#P03 · QA, responsable de test ou ingénieur de test logiciel
| Élément | Valeur |
|---|---|
| Douleur dominante | Couverture de test non reliée aux exigences |
| Rôle RBAC typique | EDITOR |
| Surfaces principales | Vue Tests de l'espace de travail · vue Revue · assistants de recette |
| Workflows déclenchés | WF-14, WF-15, WF-23, WF-08 |
| Statut des capacités mobilisées | 🟢 Livré sur les trois environnements · test navigateur réel prouvé en développement |
Scénario principal : prouver qu'une exigence nommée est couverte par un test nommé, puis vérifier le produit servi.
Aucun diagramme à afficher
Diagramme 4 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | Vue Tests avec les critères d'acceptation du projet | Quelle cible de test déclarer | Rattache la cible au projet ; cette vue est la seule des onze à porter la nature test_only |
| 2 | Cas de test générés, chacun relié à son critère | Conserver, éditer ou supprimer | Refuse en 422 toute exécution sans cas : un plan vide ne peut pas être vert |
| 3 | Éditeur Gherkin intégré | Comment formuler les scénarios | Persiste les scénarios en objets versionnés |
| 4 | Écran de données de test | Quel volume générer | Produit des données synthétiques ; aucune donnée personnelle réelle n'est utilisée |
| 5 | Résultats par cas, avec durée et verdict | Rejouer ou trier | Enregistre le résultat de campagne |
| 6 | Carte de chaleur de couverture par critère | Quels trous combler en priorité | Un critère sans test est nommé, jamais dissimulé |
| 7 | Matrice de traçabilité, exports au format tableur | Quoi transmettre à l'audit | Génère l'export à la demande |
| 8 | Écran de recette : vérification HTTP puis navigateur | Quelle adresse vérifier | Lance un Chromium réel en tâche éphémère ; assertions sur le statut, le titre non vide, le texte attendu et l'absence d'erreur de page |
| 9 | Verdict de recette et journal du pod | Ouvrir un défaut ou corriger le test | Classe entre défaut produit et test obsolète, puis ouvre la boucle correspondante |
Ce qui la retient : la couverture cesse d'être un pourcentage abstrait pour devenir une liste nominative de critères couverts et de critères découverts.
Limite honnête à lui annoncer : la recette n'écrit rien en base et ne fait avancer aucune étape de pipeline — le rapport vit dans la réponse HTTP. L'automatisation robotisée de navigateur reste 🟡 En cours, son drapeau est désactivé par défaut.
#P04 · Architecte logiciel ou d'entreprise
| Élément | Valeur |
|---|---|
| Douleur dominante | Architecture réelle inconnue et divergente du plan |
| Rôle RBAC typique | EDITOR |
| Surfaces principales | Vues Artefacts, Graphe, Config · routes /projects/[id]/trace, /projects/[id]/analyze |
| Workflows déclenchés | WF-04, WF-08, WF-09, WF-10, WF-16 |
| Statut des capacités mobilisées | 🟢 Livré · rétro-ingénierie prouvée en production |
Scénario principal : établir l'architecture réellement en service, puis imposer un métamodèle au projet.
Aucun diagramme à afficher
Diagramme 5 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | Vue Artefacts après analyse | Quel niveau C4 examiner | Reconstruit les trois niveaux depuis les faits, en citant les sources |
| 2 | Modèle entité-relation fusionné code et schéma | Quelles entités faire figurer au métamodèle | Fusionne les entités du code et les tables du schéma par nom |
| 3 | Contrat d'interface reconstitué | Quel écart au contrat publié corriger | Reconstruit un document d'interface avec un locateur par opération |
| 4 | Écran d'analyse de dérive | Lancer ou non le calcul | Persiste des constats de dérive datés |
| 5 | Plan de modernisation | Quel style cible viser | Produit un plan de découpage progressif à partir des faits réels |
| 6 | Catalogue de métamodèles par défaut | Lequel activer pour le projet | Active les méthodes retenues et résout le métamodèle effectif |
| 7 | Verdict de conformité du modèle du projet | Corriger le modèle ou le métamodèle | Liste les écarts objet par objet, sans blocage silencieux |
| 8 | Carte de contexte et agrégats du domaine | Où placer les frontières | Rend les agrégats sous forme de diagrammes |
| 9 | Rapport d'analyse de base en exploitation | Quelle exigence non fonctionnelle créer | Se connecte réellement à la base et lit ses statistiques ; un diagnostic impossible est marqué skipped |
Ce qui la retient : l'écart entre l'architecture décrite et l'architecture en service devient un constat daté, pas une impression.
Limite honnête à lui annoncer : quatorze types de diagrammes UML sont acceptés, mais cinq seulement disposent d'un générateur spécialisé — classe, machine à états, séquence, composant, déploiement. Les neuf autres retombent sur un diagramme de flux générique dont la sémantique doit être portée par le modèle fourni. La sortie graphique est du texte Mermaid ; il n'y a ni PlantUML, ni SVG, ni image matricielle.
#P05 · Direction technique de jeune pousse en croissance
| Élément | Valeur |
|---|---|
| Douleur dominante | La vitesse d'aujourd'hui payée par la paralysie de demain |
| Rôle RBAC typique | OWNER du locataire |
| Surfaces principales | Tableau de bord, routes /usage, /invoices, /roles, /team · portail d'administration /overview |
| Workflows déclenchés | WF-02, WF-12, WF-24, WF-25, WF-19 |
| Statut des capacités mobilisées | 🟢 Livré · 🟡 En cours pour le catalogue commercial |
Scénario principal : accélérer sans créer de dette d'intelligibilité, et savoir ce que l'IA coûte.
Aucun diagramme à afficher
Diagramme 6 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | Tableau de bord d'ouverture, état des projets | Où porter l'attention de l'équipe | Agrège les indicateurs par locataire |
| 2 | Écran Consommation et budgets, jauges dépensé, restant, pourcentage | Quel budget fixer et à quelle portée | Enregistre la limite, le seuil d'avertissement et le seuil critique |
| 3 | Fenêtres de quota par portée et par modèle | Quel modèle privilégier | Affiche la consommation réelle et la date de réinitialisation |
| 4 | Message de refus au franchissement de la limite | Relever ou attendre la réinitialisation | Répond 402 et n'exécute aucun appel de modèle |
| 5 | Catalogue de paliers avec leurs plafonds | Monter ou non de palier | Le plafond d'autonomie est plafonné par le plan : N1 au palier gratuit, N2 au palier Équipe, N3 au palier Entreprise |
| 6 | Écran de changement de plan | Quand basculer | Applique une proratisation réelle chez le prestataire de paiement, avec vérification de signature et idempotence |
| 7 | Vue Personnel IA : effectif, files, organigramme | Combien de membres virtuels recruter | Applique les quotas du palier ; l'autonomie effective est le minimum du plafond de rôle et du plafond de plan |
| 8 | Page Approbations | Qui approuve les déploiements | Refuse en 409 toute approbation par le demandeur |
Ce qui la retient : la dépense d'IA cesse d'être une surprise de fin de mois, et l'autonomie des agents est un réglage explicite, pas une confiance aveugle.
Limite honnête à lui annoncer : le catalogue commercial est 🟡 En cours — trois jeux de données de démarrage coexistent dans le dépôt, dont un sur un schéma périmé. Son nettoyage est un préalable bloquant au lancement. Par ailleurs, le drapeau qui active les rôles virtuels et l'application des droits vaut false par défaut et n'est positionné dans aucun manifeste : son activation par environnement est une action de phase 0.
#P06 · Direction des systèmes d'information en grande organisation
| Élément | Valeur |
|---|---|
| Douleur dominante | Prouver la maîtrise de l'IA à un comité et à un auditeur |
| Rôle RBAC typique | ADMIN du locataire, souvent doublé d'un rôle plateforme |
| Surfaces principales | Portail d'administration : /overview, /tenants, /users, /governance, /audit, /policies |
| Workflows déclenchés | WF-02, WF-13, WF-24, WF-26, WF-27, WF-29 |
| Statut des capacités mobilisées | 🟢 Livré sur les trois environnements |
Scénario principal : constituer un dossier de gouvernance opposable devant un comité de direction.
Aucun diagramme à afficher
Diagramme 7 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | État de santé des services et indicateurs de qualité | Où concentrer la revue | Sonde les services en amont ; l'agrégat répond 503 si l'un d'eux est indisponible — un vert honnête ou rien |
| 2 | Matrice rôle vers capacité | Quels rôles accorder | Trois rôles plateforme croisés avec seize capacités, dont dix réservées au rôle administrateur |
| 3 | Registre central d'agents | Quels agents autoriser | Le registre est la source de vérité unique ; rien n'est accordé implicitement |
| 4 | Écran de politiques de garde-fous | Quelle règle écrire | Enregistre motif d'action, effet, priorité, exigence d'approbation, activation |
| 5 | Évaluateur d'action à la volée | Tester avant d'autoriser | Renvoie le verdict sans appliquer la règle |
| 6 | Politiques d'exécution | Quelles bornes imposer | Impose une politique réseau qui doit commencer par un refus, une liste d'autorisations de sortie, une durée maximale, une politique de système de fichiers |
| 7 | Recherche dans le journal d'audit | Quelle période analyser | Filtre par acteur, action, ressource ou texte libre |
| 8 | Bouton de vérification de chaîne | Vérifier l'intégrité | Recalcule la chaîne de hachage et confirme ou infirme |
| 9 | Générateur de rapport de conformité | Quelle période produire | Génère et persiste le rapport, exportable localement |
Ce qui la retient : un dossier de gouvernance qui tient devant un auditeur parce que chaque affirmation est adossée à un enregistrement vérifiable, pas à une capture d'écran.
Limite honnête à lui annoncer : le mode d'authentification par en-têtes auto-déclarés est la valeur par défaut du code et n'est surchargé dans aucun manifeste de déploiement. Le durcissement de cette posture est une action de phase 0, à mener avant tout usage réglementé. Le flux d'activité du portail d'administration fonctionne par sondage, pas par événements serveur.
#P07 · Analyste d'affaires
| Élément | Valeur |
|---|---|
| Douleur dominante | Des exigences qui meurent dans un document mort |
| Rôle RBAC typique | EDITOR |
| Surfaces principales | Écran Spécifier, explorateur de spécification, route /imports · vues Spéc, Docs |
| Workflows déclenchés | WF-06, WF-07, WF-08, WF-10, WF-32 |
| Statut des capacités mobilisées | 🟢 Livré sur les trois environnements |
Scénario principal : transformer un cahier des charges dormant en objets reliés et vivants.
Aucun diagramme à afficher
Diagramme 8 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | Route /imports — Imports et remplissage automatique |
Quel document téléverser | Enregistre le document et lance le pipeline d'ingestion vers des candidats |
| 2 | Liste de documents avec leur état de traitement | Relancer ou attendre | Suit l'état du traitement, jamais un état simulé |
| 3 | File de candidats issus du document | Promouvoir ou écarter chaque candidat | Une promotion crée un objet de spécification ; un rejet n'écrit rien |
| 4 | Écran Spécifier pour compléter les objets | Comment formuler | Ouvre une exécution tracée lorsqu'un appui d'IA est demandé |
| 5 | Verdict de conformité EARS | Reformuler ou accepter | Nomme l'écart de patron plutôt que d'accepter silencieusement |
| 6 | Éditeur de relations entre objets | Quel lien poser | Refuse un lien que le métamodèle actif du projet n'autorise pas |
| 7 | Graphe de traçabilité du projet | Où sont les orphelins | Affiche les objets sans lien comme des trous nommés |
| 8 | Vue Docs : document d'exigences régénéré | Quand exporter | Reprojette depuis les objets ; le document est un artefact, jamais la source |
Ce qui la retient : ses exigences cessent d'être un document Word oublié : elles deviennent des objets typés, versionnés et interrogeables.
Limite honnête à lui annoncer : l'extraction depuis un document produit des candidats, avec un niveau de confiance ; rien ne devient exigence sans décision humaine. C'est plus lent qu'une promesse d'automatisation totale, et c'est délibéré.
#P08 · Ops, SRE ou ingénieur DevOps
| Élément | Valeur |
|---|---|
| Douleur dominante | Déploiements sans traçabilité de décision |
| Rôle RBAC typique | PUBLISHER pour publier, ADMIN pour déployer et approuver |
| Surfaces principales | Vue Livraison, page Approbations, route /credentials · portail d'administration /fleet |
| Workflows déclenchés | WF-17, WF-18, WF-19, WF-20, WF-30, WF-31, WF-15 |
| Statut des capacités mobilisées | 🟢 Livré, prouvé en production pour Kubernetes · 🟡 Partiel pour les nuages publics |
Scénario principal : livrer une version en production sans jamais perdre la trace de qui a décidé quoi.
Aucun diagramme à afficher
Diagramme 9 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | Assistant Identifiants | Quel secret déposer | Écrit la valeur au coffre puis la jette ; ne renvoie que la référence et le numéro de version |
| 2 | Assistant CI/CD, quatre fournisseurs | Quel fournisseur et quel mode de déploiement | Génère un contenu déterministe où les secrets sont référencés par nom ; le commit exige le rang PUBLISHER |
| 3 | Écran de vérification de registre | Quel registre cibler | Effectue une poignée de main réelle ; signale explicitement les registres de nuage public dont l'échange de jeton est absent |
| 4 | Journal de la tâche de construction | Relancer ou corriger | Construit sans démon en tâche éphémère et réinterroge le statut terminal |
| 5 | Vue Livraison : run et ses six étapes | Simuler avant d'exécuter | La simulation ne touche aucune infrastructure et n'écrit rien |
| 6 | Verdicts d'étape : construction, tests, analyse, porte | Corriger ou poursuivre | L'étape de porte dérive son verdict des trois verdicts réels précédents ; un scanner absent produit un 501 qui nomme l'outil manquant |
| 7 | Page Approbations | Qui approuve | Refuse en 409 l'approbation par le demandeur |
| 8 | État du rollout | Poursuivre ou revenir en arrière | Le statut live n'est posé que si les répliques prêtes, à jour, disponibles et souhaitées coïncident |
| 9 | Bouton de retour arrière | Quand revenir | Crée un nouveau déploiement portant la référence du déploiement annulé, et marque l'original comme annulé |
| 10 | Adresse publique du produit | Lancer la recette | Rend et applique déploiement, service et entrée ; le pod produit est durci par défaut |
Ce qui la retient : chaque mise en production porte le nom de la personne qui l'a demandée, celui de la personne qui l'a approuvée, et l'état réellement observé après coup.
Limite honnête à lui annoncer : DEPLOY_LIVE et GOLIVE_ENABLED valent false par défaut ; sans activation explicite par environnement, la plateforme répond 501 — elle ne simule jamais un déploiement. La création d'enregistrement DNS par hôte est écrite et testée mais non branchée : la mise en ligne repose sur un enregistrement générique préexistant. Les pilotes natifs de nuage public sont ⚪ Planifiés.
#P09 · Sécurité et conformité
| Élément | Valeur |
|---|---|
| Douleur dominante | Des agents IA sans périmètre déclaré ni journal opposable |
| Rôle RBAC typique | ADMIN du locataire, doublé d'un rôle plateforme |
| Surfaces principales | Portail d'administration : /governance, /policies, /registry, /audit, /budgets |
| Workflows déclenchés | WF-13, WF-26, WF-27, WF-29, WF-24 |
| Statut des capacités mobilisées | 🟢 Livré sur les trois environnements |
Scénario principal : borner ce qu'un agent peut faire, puis le prouver.
Aucun diagramme à afficher
Diagramme 10 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | Registre des compétences, outils et invites | Quel niveau de visibilité accorder | Trois niveaux réels : plateforme, locataire, utilisateur — le niveau utilisateur n'existe que pour les invites |
| 2 | Écran d'import gouverné | Importer ou refuser | Rejoue un tunnel de sept étapes ; même un import en lot passe entrée par entrée, rien ne le contourne |
| 3 | Statut de vérification de signature | Accepter un contenu non vérifié | Un contenu invérifiable reste marqué unverified — jamais faussé en vérifié |
| 4 | Rapport de recherche de secrets | Corriger la source | Bloque l'import en 422 si un secret est détecté, sans jamais échoer la matière offensante |
| 5 | Niveau de risque persisté | Exiger ou non une attestation | Un contenu importé et non vérifié est classé à risque élevé |
| 6 | File de revue avec le nom du soumissionnaire | Approuver ou rejeter | Refuse l'auto-approbation en 409, y compris au niveau de la base par une contrainte dédiée |
| 7 | Écran de permissions d'outil | Quelle portée autoriser | L'effet par défaut est deny ; sans ligne allow explicite, le verdict est le refus |
| 8 | Journal des appels d'outils | Quelle période exporter | N'expose que des empreintes, par minimisation des données personnelles |
| 9 | Bouton de révocation | Quand couper | Transition persistée et propagation immédiate : liaisons désactivées, permissions supprimées |
| 10 | Vérification de chaîne d'audit | Contrôler l'intégrité | Recalcule la chaîne de hachage et confirme ou infirme |
Ce qui la retient : le refus par défaut cesse d'être une intention pour devenir un comportement observable, journalisé sous un identifiant de politique dédié.
Limite honnête à lui annoncer : deux drapeaux maîtres du registre valent false par défaut et ne sont positionnés dans aucun manifeste de déploiement : sans eux, les routes de niveaux hiérarchisés et de rôles virtuels répondent 404. Par ailleurs, cinq rôles sectoriels hérités d'un domaine antérieur subsistent hors hiérarchie RBAC ; leur retrait fait partie du chantier de généricisation préalable au lancement.
#P10 · Agence, ESN ou intégrateur
| Élément | Valeur |
|---|---|
| Douleur dominante | Reprendre un système client sans documentation |
| Rôle RBAC typique | ADMIN sur le locataire du client |
| Surfaces principales | Routes /projects, /projects/[id]/sources, /team, /organization/capabilities · vues Artefacts, Docs |
| Workflows déclenchés | WF-02, WF-03, WF-04, WF-09, WF-17, WF-19, WF-28 |
| Statut des capacités mobilisées | 🟢 Livré · rétro-ingénierie prouvée en production |
Scénario principal : prendre la main sur un patrimoine logiciel client en quelques jours plutôt qu'en quelques mois.
Aucun diagramme à afficher
Diagramme 11 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | Portail d'administration, écran des locataires | Créer un locataire dédié au client | Crée le locataire ; l'isolation est stricte et un identifiant discordant renvoie 404 |
| 2 | Écran Équipe | Qui de l'agence et qui du client | Émet des invitations valables sept jours, résolubles publiquement puis acceptables sans compte préalable |
| 3 | Écran Sources du projet | Quel dépôt analyser | Clone en profondeur 1, analyse, infère, ouvre la file humaine |
| 4 | Vue Artefacts | Quel artefact livrer en premier | Reconstruit chaque artefact à la demande depuis les faits, avec ses locateurs |
| 5 | Vue Docs | Quel document exporter au client | Projette la documentation depuis la spécification |
| 6 | File de validation | Faire trancher le client plutôt que l'agence | Une approbation crée l'objet ; la décision est attribuable à son auteur |
| 7 | Assistant CI/CD | Quel fournisseur le client utilise | Génère puis commite réellement dans le dépôt du client |
| 8 | Vue Livraison et page Approbations | Faire approuver la mise en production par le client | Refuse l'auto-approbation ; la décision du client est consignée |
| 9 | Écran de démonstration du portail d'administration | Préparer l'avant-vente suivante | Provisionne un locataire de démonstration épinglé sur un identifiant réservé |
Ce qui la retient : la reprise d'un patrimoine devient un livrable daté et opposable, pas une promesse d'audit.
Limite honnête à lui annoncer : si le patrimoine du client n'est pas en Python, l'analyse profonde ne s'applique pas — les fichiers sont listés puis rangés en non supporté. Le module de démonstration est par ailleurs désactivé par défaut, et sa table de manifeste n'est pas affichée dans l'interface actuelle.
#P11 · Dirigeant de PME non technique
| Élément | Valeur |
|---|---|
| Douleur dominante | Dépendance totale à un prestataire |
| Rôle RBAC typique | VIEWER au départ, OWNER sur son propre locataire |
| Surfaces principales | Tableau de bord, vue Docs, route /public/feedback, route /invoices |
| Workflows déclenchés | WF-01, WF-21, WF-22, WF-25 · subit WF-19 et WF-20 |
| Statut des capacités mobilisées | 🟢 Livré |
Scénario principal : comprendre ce que l'on possède réellement, sans savoir lire du code.
Aucun diagramme à afficher
Diagramme 12 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | Tableau de bord d'ouverture | Quel projet suivre | Agrège les indicateurs du locataire |
| 2 | Vue Docs : document d'exigences lisible | Ce qu'elle valide ou conteste | Projette le document depuis la spécification, sans jargon de code |
| 3 | Feuille de route publique | Ce qui compte pour son activité | Sert la feuille de route par clé de widget publique, sans compte |
| 4 | Journal des changements | Vérifier qu'une promesse a été tenue | Ne publie que des entrées explicitement publiées par une personne de rang PUBLISHER |
| 5 | Formulaire public de dépôt d'idée | Formuler son besoin | Enregistre le retour, sans authentification |
| 6 | Compteur de votes | Mobiliser ses équipes pour voter | Déduplique les votes par adresse de courriel |
| 7 | Route /invoices — Grand livre et facturation |
Contrôler la dépense | Affiche l'abonnement, les factures et l'usage face aux limites du plan |
| 8 | Catalogue de paliers | Monter de palier ou non | Applique la proratisation réelle chez le prestataire de paiement |
Ce qui la retient : la propriété intellectuelle de son produit redevient lisible sans passer par son prestataire.
Limite honnête à lui annoncer : il n'existe aucune application mobile — les portails sont responsives et s'utilisent sur téléphone par navigateur, rien de plus. Un compteur d'usage du grand livre affiche par ailleurs des valeurs courantes figées : cet écart est identifié et fait partie du chantier de nettoyage du catalogue.
#P12 · Enseignant et étudiant
| Élément | Valeur |
|---|---|
| Douleur dominante | Enseigner le cycle de vie complet sans disposer d'une infrastructure |
| Rôle RBAC typique | EDITOR pour l'étudiant, ADMIN pour l'enseignant sur le locataire de cours |
| Surfaces principales | Espace de travail projet complet · portail d'administration /demo |
| Workflows déclenchés | WF-03, WF-28, WF-32, WF-04, WF-14, WF-19 |
| Statut des capacités mobilisées | 🟢 Livré · palier Éducation [Hypothèse], tarification à définir |
Scénario principal : dérouler en une session de cours les six maillons de la chaîne, sur un cas reproductible.
Aucun diagramme à afficher
Diagramme 13 — flowchart
Déroulé
| # | Ce que la personne voit à l'écran | Ce qu'elle décide | Ce que le système fait |
|---|---|---|---|
| 1 | Portail d'administration, écran de démonstration | Quel mode de jeu de données | Provisionne un locataire épinglé sur un identifiant réservé, isolé de tout client |
| 2 | Espace de travail à onze vues | Par quelle vue commencer le cours | Chaque vue déclare la capacité qui la garde ; une vue non autorisée n'apparaît pas |
| 3 | Analyse d'un dépôt public | Quel dépôt choisir comme cas d'étude | Analyse réellement le dépôt : c'est le même chemin qu'en production |
| 4 | File de validation humaine | Faire trancher les étudiants | Chaque approbation est attribuable à son auteur |
| 5 | Écran Spécifier et validation EARS | Quel patron enseigner | Nomme l'écart de grammaire, ce qui rend l'erreur pédagogique |
| 6 | Vue AgentOps | Quel plafond d'autonomie démontrer | Le plafond effectif est le minimum entre le plafond de rôle et le plafond de plan ; il retombe sur N1 en cas d'incertitude |
| 7 | Vue Tests | Comment relier tests et exigences | Affiche la carte de chaleur de couverture |
| 8 | Vue Livraison et page Approbations | Démontrer la séparation des devoirs | Refuse en 409 l'approbation par le demandeur — la démonstration est visible en direct |
| 9 | Bouton de réinitialisation | Quand remettre à zéro | Restaure l'état initial du locataire de démonstration |
Ce qui la retient : la démonstration de la séparation des devoirs et du plafond d'autonomie se fait en direct, sur un refus réel, pas sur une diapositive.
Limite honnête à lui annoncer : le palier Éducation est une [Hypothèse] — sa tarification et ses limites restent à définir par le propriétaire. Le module de démonstration est désactivé par défaut et doit être activé par environnement. Enfin, l'exécution réelle de déploiement exige des interrupteurs qui valent false par défaut : en salle de cours, le comportement attendu est un 501 explicite, ce qui est en soi un enseignement.
#13. Matrice persona × workflow
#13.1 Légende
| Symbole | Signification |
|---|---|
| D | La persona déclenche le workflow |
| S | La persona subit le workflow — elle en voit les effets sans le lancer |
| A | La persona approuve une porte de gouvernance du workflow |
| — | Sans interaction significative |
#13.2 Matrice — workflows WF-01 à WF-16
| Workflow | P01 | P02 | P03 | P04 | P05 | P06 | P07 | P08 | P09 | P10 | P11 | P12 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| WF-01 Découverte et inscription | D | D | D | D | D | D | D | D | D | D | D | D |
| WF-02 Organisation et invitations | S | S | S | S | D·A | D·A | S | S | S | D | S | D |
| WF-03 Création de projet | D | D | S | D | S | — | D | — | — | D | S | D |
| WF-04 Rétro-ingénierie | D | S | S | D | S | — | S | — | S | D | — | D |
| WF-05 Promotion automatique | S | A | — | S | S | — | A | — | S | S | — | S |
| WF-06 Rédaction assistée par IA | D | D | — | S | S | S | D | — | S | D | — | D |
| WF-07 Validation EARS | S | D | S | S | — | — | D | — | — | S | — | D |
| WF-08 Impact et traçabilité | D | D | D | D | S | S | D | S | S | D | — | D |
| WF-09 PRD et artefacts UML | S | D | S | D | S | S | D | — | S | D | S | D |
| WF-10 DDD et métamodèle | S | S | S | D | — | — | D | — | — | D | — | D |
| WF-11 Revue et approbation | D | D·A | D | D | A | A | D | — | A | A | S | D·A |
| WF-12 Personnel virtuel | S | S | S | S | D·A | A | — | — | A | D | — | D |
| WF-13 Exécution d'agent avec approbation | D | D | D | D | A | A | S | D | D·A | D | — | D |
| WF-14 Génération de tests | D | S | D | S | S | S | S | S | S | D | — | D |
| WF-15 Tests navigateur réels | S | S | D | — | S | — | — | D | — | D | — | D |
| WF-16 Analyse de base de données | D | — | S | D | S | S | — | D | S | D | — | S |
#13.3 Matrice — workflows WF-17 à WF-32
| Workflow | P01 | P02 | P03 | P04 | P05 | P06 | P07 | P08 | P09 | P10 | P11 | P12 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| WF-17 Pipeline CI/CD | S | — | S | S | S | S | — | D | S | D | — | D |
| WF-18 Construction et publication d'image | S | — | S | S | S | — | — | D | S | D | — | S |
| WF-19 Déploiement gouverné | S | A | S | S | A | A | — | D·A | A | D·A | S | D |
| WF-20 Mise en ligne sur sous-domaine | S | S | S | S | S | S | — | D | S | D | S | D |
| WF-21 Retours et vote | S | D | S | — | S | — | D | — | — | S | D | S |
| WF-22 Feuille de route et journal | S | D·A | S | — | A | S | S | — | — | D | D | S |
| WF-23 Défaut vers exigence | D | D·A | D | S | S | S | S | S | S | D | S | D |
| WF-24 Budget et plafonnement | S | S | S | — | D·A | D·A | — | S | D·A | D | S | S |
| WF-25 Montée en gamme de plan | — | S | — | — | D·A | D·A | — | — | S | D | D·A | S |
| WF-26 Enregistrement d'un outil MCP | S | — | — | S | A | D·A | — | S | D·A | D | — | S |
| WF-27 Publication d'une compétence globale | S | — | — | S | A | D·A | — | — | D·A | S | — | S |
| WF-28 Locataire de démonstration | — | — | — | — | S | D | — | — | S | D | — | D·A |
| WF-29 Rapport de conformité | — | — | S | — | S | D·A | — | S | D·A | S | S | S |
| WF-30 Dépôt d'un secret au coffre | S | — | — | S | S | S | — | D | A | D | — | S |
| WF-31 Publication d'un front statique | S | — | S | — | S | — | — | D | S | D | — | S |
| WF-32 Cycle spécification-première | D | D | S | D | S | — | D | — | — | D | S | D·A |
#13.4 Lecture de la matrice
| Constat | Conséquence pour la mise en marché |
|---|---|
| P08 et P10 déclenchent le plus de workflows | Ce sont les deux personas à qui l'essai produit doit s'adresser en priorité : elles parcourent la chaîne complète. |
| P06 et P09 approuvent plus qu'elles ne déclenchent | Le discours doit leur parler de portes, de journal et de preuve, non de productivité. |
| P11 subit presque tout | Sa valeur est la lisibilité : documentation projetée, feuille de route publique, journal des changements. Aucun argument technique. |
| P02 et P11 sont les seules à interagir avec le tableau public de retours | La surface publique est un point de contact commercial autant qu'un canal produit. |
| P12 approuve dans un cadre pédagogique | Le refus d'auto-approbation est un contenu de cours, pas seulement une contrainte. |
#13.5 Chemin d'entrée recommandé par persona
Aucun diagramme à afficher
Diagramme 14 — flowchart
KySpectra — Plateforme agentique SDD/SDLC · par Kyrieva
Documentation : kyspectradoc.kyrieva.com ·
Dossier de lancement : Strategielancement/
Document interne de pré-lancement — version 1.0 du 2026-08-17. Les données marquées
« [Gabarit : … ] » doivent être renseignées ou revalidées avant diffusion externe.