Guide utilisateur KySpectra — portail client

#Table des matières

---

#1 · À qui s'adresse ce guide

#1.1 Public visé

Ce guide documente le portail client de KySpectra, c'est-à-dire l'application où vous travaillez au quotidien. Il ne documente ni le portail d'administration de la plateforme, ni les interfaces de programmation.

#1.2 Prérequis

#1.3 Conventions de lecture

#1.4 Une règle de conception à connaître avant tout

KySpectra applique une règle qui explique la plupart de ses messages : le produit préfère refuser franchement plutôt que simuler un succès.

Concrètement :

Quand vous voyez un message qui dit ce qui manque, ce n'est pas une panne : c'est le comportement voulu.

---

#2 · Premiers pas

#2.1 Les trois environnements

Le portail d'administration (https://spectra.admin.kyrieva.com en production) est une application séparée, destinée aux opérateurs de la plateforme. Il n'est pas couvert par ce guide.

⚠️ Il n'existe pas de troisième portail dit « business ». Le vocabulaire correct est portail client ou espace de travail. « Business » désigne une persona à l'intérieur du portail client.

#2.2 Se connecter

Statut : Livré.

KySpectra délègue l'authentification à un fournisseur d'identité Keycloak (https://keycloak.i2tdigital.com), avec le flux OpenID Connect « code d'autorisation + PKCE » (méthode S256). Le flux implicite est désactivé.

Ce que cela implique pour vous :

1. Ouvrez l'adresse de votre environnement.
2. N'étant pas authentifié, vous êtes redirigé vers la page de connexion du fournisseur d'identité. Cette page n'est pas une page KySpectra — son apparence peut différer.
3. Saisissez vos identifiants. La politique de mot de passe du domaine exige au minimum 8 caractères, un chiffre, une majuscule, une minuscule, et un mot de passe différent du nom d'utilisateur. Une protection anti-force brute est active.
4. Complétez le second facteur si votre organisation l'impose.
5. Vous revenez sur /auth/callback. Cette page technique n'affiche qu'un état de progression annoncé aux lecteurs d'écran ; elle ne demande rien et ne se garde pas en historique.
6. Vous arrivez sur le Tableau de bord.

Points importants :

[Gabarit : capture d'écran à produire — page de connexion Keycloak, en français, avec le logo de l'organisation]

#2.3 L'organisation et le locataire actif

Statut : Livré.

Toutes vos données sont cloisonnées par locataire, identifié par un UUID.

Pour voir ou changer le locataire actif :

1. Repérez le contrôle de locataire dans la barre supérieure, à droite.
2. S'il affiche Aucun locataire défini, cliquez dessus.
3. Collez l'identifiant du locataire (un UUID) dans le champ dont l'invite est Identifiant du locataire (UUID).
4. Cliquez sur Définir le locataire.
5. Pour en changer plus tard, le même contrôle propose Changer de locataire.

Messages que vous pouvez rencontrer :

⚠️ Le locataire est aussi une frontière de sécurité. Si vous demandez une ressource appartenant à un autre locataire, le serveur répond 404, pas 403. C'est délibéré : révéler l'existence de la ressource d'autrui serait déjà une fuite d'information. Un lien reçu d'un collègue d'une autre organisation vous donnera donc « introuvable », pas « interdit ».

#2.4 Changer de langue

Statut : Livré.

Le produit est bilingue français / anglais, avec le français par défaut. Ce n'est pas une traduction ajoutée après coup : les deux jeux de messages sont maintenus en parité stricte.

1. Cliquez sur le sélecteur de langue dans la barre supérieure.
2. Choisissez le français ou l'anglais.
3. L'interface bascule immédiatement, sans rechargement.

Le libellé du réglage est Langue de l'interface. Vous retrouvez le même contrôle dans Paramètres → Apparence, avec l'aide « Français (par défaut) ou anglais. »

#2.5 Changer de thème

Statut : Livré.

1. Cliquez sur le sélecteur de thème dans la barre supérieure.
2. Choisissez Système, Clair ou Sombre.
3. Le thème s'applique immédiatement.

Le réglage s'appelle Thème de l'interface. Son aide dans Paramètres précise : « Système, clair ou sombre. Le choix explicite est mémorisé. » Le mode Système suit la préférence de votre système d'exploitation.

Un script de thème est appliqué avant le premier rendu de la page : vous ne verrez pas de « flash blanc » en mode sombre.

#2.6 La palette de commandes

Statut : Livré.

C'est le raccourci le plus rentable du produit.

1. Appuyez sur Ctrl + K (Windows, Linux) ou ⌘ + K (macOS). Vous pouvez aussi cliquer sur le bouton Rechercher de la barre supérieure, qui affiche la mention ⌘K.
2. Le champ propose Rechercher une page ou une action…
3. Tapez quelques lettres. Deux groupes de résultats apparaissent :
   • Naviguer — toutes les destinations du rail de navigation.
   • Actions — Nouveau projet, Demander au copilote IA.
4. Naviguez avec ↑ et ↓, ouvrez avec Entrée, fermez avec Échap.
5. Si rien ne correspond : Aucun résultat.

À l'intérieur d'un espace de travail projet, la palette change de contenu : l'invite devient Aller à une vue ou rechercher un élément…, et les deux groupes deviennent Vues et Éléments de spéc. Son aide affiche : « ↑↓ pour naviguer · Entrée pour ouvrir · Échap pour fermer ».

#2.7 Le copilote IA

Statut : Livré.

Le copilote est accessible depuis n'importe quelle page, par l'icône d'étincelle de la barre supérieure (Ouvrir le copilote IA) ou par l'action Demander au copilote IA de la palette.

Il a deux modes :

Points d'usage :

1. Ouvrez le copilote. Son en-tête affiche le contexte : Contexte global hors projet, ou le projet courant.
2. Basculez le Mode du copilote entre Assistant et Agent.
3. En mode Agent hors projet, le copilote affiche « Ouvrez un projet pour exécuter l'agent d'écriture d'objets. »
4. Rédigez votre demande. Exemple d'invite affiché : « Ex. : « Ajoute une exigence de connexion avec 2FA… » »
5. Lancez avec le bouton Envoyer, ou avec ⌘/Ctrl + Entrée en mode Agent.
6. Pendant l'exécution : Exécution de l'agent… Puis Terminé — N objet(s) créé(s). ou Échec : <raison>.
7. Réduire met le copilote de côté, Fermer le referme.

⚠️ Le copilote est ancré en bas à droite de l'écran. La zone de contenu réserve une marge basse pour qu'il ne recouvre pas les boutons d'action des pages.

#2.8 Le rail de navigation

Statut : Livré. Quinze destinations, en trois sections plus un pied de rail.

Comportements :

• L'entrée Tableau de bord n'est active qu'à la racine exacte. Toutes les autres restent actives sur l'ensemble de leur sous-arbre : /projects reste surligné quand vous êtes sur /projects/abc/spec.
• Le rail se replie et se déplie avec le bouton le plus à gauche de la barre supérieure (Replier la navigation / Déplier la navigation). Le choix est mémorisé sur l'appareil.
• Une entrée protégée par une capacité que vous n'avez pas est masquée, pas grisée : le produit ne propose pas une action qu'il devra refuser. La page elle-même reste protégée côté serveur.

#2.9 La barre supérieure

De gauche à droite : bouton de repli du rail · Fil d'Ariane · bouton Rechercher avec la mention ⌘K · cloche de Notifications (avec le compte de non-lues annoncé sous la forme « Notifications, N non lues ») · icône du Copilote IA · sélecteur de Thème · sélecteur de Langue · contrôle de Locataire · Menu du compte.

Le Menu du compte donne accès à Compte, Paramètres, Équipe et Identifiants. Il affiche Aucun locataire quand aucun n'est actif.

---

#3 · Les concepts du produit

Neuf notions suffisent à comprendre tout le reste. Le glossaire complet vit dans 03-glossaire.md.

#3.1 Projet

Le conteneur de tout le travail d'un produit ou d'un périmètre. Un projet porte :

#3.2 Spécification et élément de spécification

La spécification d'un projet est l'ensemble de ses éléments de spécification et de leurs relations.

Un élément est un objet typé, versionné, identifié et relié. Il porte au minimum :

Les sept statuts :

#3.3 Exigence

Une exigence est un élément de spécification qui énonce ce que le système doit faire ou garantir. C'est la racine de la traçabilité : c'est d'elle que partent les liens vers la conception, les tâches, le code, les tests et la vérification, et c'est vers elle que remontent les défauts.

Le contrôle le plus fréquent du produit s'appelle d'ailleurs Exigence sans test.

#3.4 Relation

Un lien orienté et typé entre deux éléments. Treize types existent :

#3.5 Artefact

Un livrable de conception projeté depuis la spécification, jamais saisi à la main : diagrammes DDD, C4/TOGAF/ArchiMate, UML, BPMN, ERD, artefacts de sécurité, graphe de mapping, graphe de dépendances.

La règle affichée dans la vue Artefacts est explicite : « Diagrammes produits par les services (Mermaid), rendus tels quels — jamais inventés. » Un onglet sans contenu affiche « Aucun diagramme pour cet artefact. » plutôt qu'une illustration décorative.

#3.6 Agent et exécution

Un agent est un programme fondé sur un modèle de langage, doté d'un périmètre, d'outils, d'un budget et d'un journal. Le produit en nomme six profils dans le composeur de flux : Analyste, Extracteur, Rédacteur, Relecteur, Calcul, Conseiller.

Une exécution (un run) est une invocation d'agent. Elle a :

#3.7 Espace de travail

L'Espace SDD est la surface centrale d'un projet. Son sous-titre le résume : « Poste de travail piloté par la spec — source de vérité de bout en bout. » Il regroupe onze vues canoniques dans une seule page, sans rechargement.

Point structurant : l'état de l'écran vit dans l'URL (?view=<vue>&item=<identifiant>). Copier l'URL et l'envoyer suffit à faire ouvrir exactement le même écran à quelqu'un d'autre. Un dernier état est aussi mémorisé par projet sur votre appareil, uniquement pour amorcer votre premier atterrissage.

#3.8 Provenance et la pastille violette

Quatre provenances possibles :

Le sens de la pastille violette. La charte du produit réserve la couleur violette (#7c5cfc en clair, #9b85ff en sombre) exclusivement à ce qui provient d'un agent. Cette couleur n'est utilisée nulle part ailleurs — ni pour un état, ni pour une catégorie, ni pour une décoration.

Ce que cela vous dit, concrètement :

1. Violet = écrit par une machine. Vous devez le lire avec l'exigence que vous appliqueriez à une contribution non relue.
2. Pas de violet = écrit ou validé par une personne.
3. La distinction survit dans le temps : la provenance est un attribut persisté de l'élément, pas un affichage transitoire. Six mois plus tard, vous saurez encore ce qu'un modèle a écrit.
4. Le copilote et les logos utilisent le violet en dégradé avec le bleu de marque — c'est le même signal : cette surface est une surface d'IA.

#3.9 Locataire et isolation

Voir §2.3. À retenir : 404, pas 403, quand la ressource appartient à quelqu'un d'autre.

#3.10 Plafond d'autonomie

Le degré maximal d'initiative qu'un agent peut prendre sans validation humaine.

Le plafond est doublement borné :

1. Par le rôle virtuel lui-même — affiché comme Plafond {niveau}.
2. Par le forfait de l'organisation — role.max_autonomy : N1 en gratuit, N2 en Équipe, N3 en Entreprise.

C'est le minimum des deux qui s'applique, affiché comme Effectif {niveau}. En cas de dégradation d'un service de résolution, le système retombe vers N1 — il échoue vers le bas, jamais vers le haut.

---

#4 · Chaque écran, une section

Les écrans sont présentés dans l'ordre de la navigation. Chaque section indique : à quoi sert l'écran, ce qu'on y voit, les actions pas à pas, les contraintes réelles, les messages d'erreur, et les permissions requises.

#4.1 Tableau de bord — /

Statut : Livré. · Permission : aucune capacité particulière. Un locataire actif est requis.

#À quoi ça sert

Donner en un écran l'état de votre locataire : projets, notifications, exécutions d'agents, consommation sur quatorze jours. Son sous-titre l'annonce : « Vue d'ensemble de vos projets, agents et budgets, calculée à partir de données réelles. »

#Ce qu'on y voit

#Actions pas à pas

1. Cliquez sur Commandes dans l'en-tête de page pour ouvrir la palette de commandes.
2. Cliquez sur Nouveau projet pour aller à la page Projets.
3. Dans les cartes d'indicateurs, cliquez sur Voir les projets, Ouvrir les notifications ou Voir les opérations agents pour rebondir vers la page correspondante.
4. Dans Actions rapides, choisissez Nouveau projet, Importer des documents, Demander à l'IA (ouvre le copilote) ou Consommation.

#Messages et états

⚠️ Une carte de démonstration peut apparaître sur certains environnements pour un locataire réservé. Son bouton de visite guidée est désactivé en permanence : c'est un emplacement réservé, pas une fonctionnalité. Statut : Planifié.

[Gabarit : capture d'écran à produire — tableau de bord avec données réelles : 4 indicateurs, courbe de consommation, activité récente]

#4.2 Projets — /projects

Statut : Livré. · Permission : lecture pour tous ; Renommer et Archiver exigent spec:write (EDITOR et au-dessus).

#À quoi ça sert

Créer un projet et ouvrir un projet existant. Sous-titre : « Créez un projet ou ouvrez-en un pour explorer ses spécifications. »

#Ce qu'on y voit

Deux blocs : le formulaire Nouveau projet (« Démarrez une nouvelle base de spécification pilotée par agents. ») et le tableau Vos projets avec les colonnes Préfixe, Nom, Créé le, Actions.

#Créer un projet — pas à pas

1. Renseignez Préfixe de code. Aide affichée : « Identifiant court en majuscules (ex. « APP »). » Le champ met automatiquement en majuscules ce que vous tapez.
2. Renseignez Nom du projet (invite : « Nom lisible du projet »).
3. Choisissez le Type de projet. Aide affichée : « Un projet « Tests » cible une application déployée existante pour la tester en profondeur. »
   • Standard (SDD/SDLC) — le cas courant.
   • Tests — active la vue Tests dans l'espace de travail.
4. Cliquez sur Créer le projet. Le bouton devient Création….

Contraintes réelles :

Résultat attendu : notification Projet créé — « Le projet « <nom> » a été créé. » — et une nouvelle ligne dans Vos projets.

#Renommer un projet — pas à pas

1. Sur la ligne du projet, colonne Actions, cliquez sur Renommer.
2. La boîte Renommer le projet s'ouvre : « Modifiez le nom affiché du projet. Le préfixe de code reste inchangé. »
3. Modifiez le champ Nom du projet.
4. Cliquez sur Enregistrer, ou sur Annuler.

Résultat attendu : Projet renommé — « Le projet s'appelle désormais « <nom> ». »

#Archiver un projet — pas à pas

1. Colonne Actions, cliquez sur Archiver.
2. Confirmez : « Voulez-vous archiver le projet « <nom> » ? Il n'apparaîtra plus dans la liste. »
3. Cliquez sur Archiver (bouton de danger) ou Annuler.

Résultat attendu : Projet archivé — « Le projet « <nom> » a été archivé. »

#Ouvrir un projet

Cliquez sur la ligne, ou sur l'action Ouvrir le projet.

#Messages et états

#4.3 Aperçu du projet — /projects/{projet}

Statut : Livré. · Permission : lecture. · Écran en lecture seule.

#À quoi ça sert

Prendre la mesure d'un projet en un coup d'œil : volume, répartition, écarts, éléments récents.

#Ce qu'on y voit

#Actions pas à pas

1. Cliquez sur un élément de Éléments récents pour ouvrir son détail.
2. Si le projet est vide, cliquez sur Ouvrir l'assistant Spécifier.

#Messages et états

#4.4 Explorateur de spécification — /projects/{projet}/spec

Statut : Livré. · Permission : lecture.

#À quoi ça sert

Parcourir, filtrer et ouvrir les éléments de spécification. Sous-titre : « Parcourez, filtrez et ouvrez les éléments de spécification de ce projet. »

#Ce qu'on y voit

Une barre de filtres, puis un tableau paginé à cinq colonnes : Identifiant, Type, Statut, Titre, Provenance. Vingt lignes par page.

#Actions pas à pas

1. Tapez dans Rechercher (invite : « Identifiant, titre ou chemin… »). La recherche se déclenche après une courte pause de saisie.
2. Sélectionnez un Type. La liste propose Tous les types ; les types courants sont proposés en premier. Effacez avec Effacer le type.
3. Sélectionnez un Statut, ou Tous les statuts.
4. Parcourez avec Précédent et Suivant. La plage affichée suit la forme « 1–20 sur 137 ».
5. Cliquez sur une ligne pour ouvrir le détail de l'élément.

#Messages et états

#4.5 Détail d'un élément — /projects/{projet}/spec/{élément}

Statut : Livré. · Permission : lecture pour tous ; Modifier, Créer la relation, Supprimer exigent spec:write.

#Ce qu'on y voit

#Modifier un élément — pas à pas

1. Cliquez sur Modifier.
2. La boîte Modifier l'élément rappelle : « Toute modification incrémente la version et requiert une raison de changement. »
3. Ajustez le Titre (obligatoire), le Statut, la Provenance (aide : « Origine de cette modification. »).
4. Renseignez la Raison du changement. Aide : « Expliquez brièvement pourquoi cet élément change (journalisé sur la révision). »
5. Enregistrez.

#Créer une relation — pas à pas

1. Dans le bloc Relations, lisez la note : « Créez une relation sortante depuis cet élément. Pour visualiser le graphe complet des relations existantes, ouvrez la traçabilité. »
2. Renseignez Identifiant de la cible (invite : « Identifiant de l'élément cible » ; aide : « L'identifiant canonique de l'élément vers lequel pointe la relation. »).
3. Choisissez le Type de relation parmi les treize.
4. Cliquez sur Créer la relation. Le bouton devient Création….

#Supprimer une relation — pas à pas

1. Cliquez sur Supprimer en regard de la relation.
2. La boîte Supprimer la relation ? explique : « Ceci supprime la relation « <type> » vers <cible>. »
3. Renseignez le Motif du changement (invite : « Pourquoi cette relation est-elle supprimée ? »). Sans motif, le bouton de confirmation reste inactif.
4. Confirmez. Résultat : Relation supprimée.

#Supprimer l'élément — pas à pas

1. Dans la Zone de danger, lisez l'avertissement : « La suppression de cet élément est gouvernée — elle exige un motif et est consignée dans la piste d'audit. »
2. Cliquez sur Supprimer l'élément.
3. La confirmation indique : « Ceci supprime définitivement « <titre> ». Cette action est consignée et irréversible. »
4. Renseignez le Motif du changement. Sans motif : Un motif de changement est requis.
5. Confirmez. Résultat : Élément supprimé.

#Champs personnalisés

⚠️ Statut : Livré, mais conditionnel. Ce panneau dépend d'un service externe. S'il n'est pas configuré, il affiche Champs personnalisés non raccordés et explique quelle variable manque, plutôt que d'afficher un formulaire vide trompeur.

Quand il est raccordé, vous y trouvez les attributs typés du registre de schémas et un bloc Données libres (JSON). Les valeurs retirées du schéma courant apparaissent sous Valeurs orphelines avec la note « Ces valeurs existent sur l'objet mais ne font plus partie du schéma actuel — elles ne sont jamais perdues. »

Validation du formulaire : Ce champ est requis., Nombre invalide., La valeur minimale est {min}., La valeur maximale est {max}., Au moins {min} caractères., Au plus {max} caractères., Le format est invalide., JSON invalide., Valeur non autorisée., Le JSON libre doit être un objet.

#Message d'introuvable

Élément introuvable — « Cet élément de spécification n'existe pas ou n'appartient pas au locataire actif. » Notez la formulation : elle couvre les deux cas sans dire lequel. C'est le masquage d'existence à l'œuvre.

#4.6 Spécifier — /projects/{projet}/specify

Statut : Livré. · Permission : l'écriture est contrôlée côté serveur. L'interface n'y masque pas les formulaires.

Cette page superpose deux surfaces : la génération assistée par IA et la composition manuelle d'un lot.

#Surface 1 — Générer avec l'IA

En-tête : badge IA, titre Générer avec l'IA, sous-titre « Décrivez ce que vous voulez spécifier en langage naturel. L'IA enregistre de vrais éléments de spécification et leurs relations, que vous retrouvez ensuite dans l'explorateur. »

Pas à pas :

1. Renseignez le champ Description. Aide : « Soyez précis : périmètre, exigences, entités et règles à créer. Vos éléments sont enregistrés réellement. » Invite proposée :

   « Ex. : Un module d'authentification avec inscription, connexion et réinitialisation de mot de passe. Ajoute les exigences fonctionnelles et les critères d'acceptation associés. »

2. Cliquez sur Générer. Le bouton devient Génération….
3. Suivez la section Activité. Le portail interroge périodiquement l'état réel de l'exécution ; les étapes s'affichent au fur et à mesure.
4. À la fin, la liste Éléments créés donne pour chaque ligne la Référence, le Type et l'Identifiant canonique.
5. Rebondissez avec Voir l'explorateur ou Générer un autre lot.

⚠️ Une génération consomme des crédits. Si votre solde est insuffisant, l'opération est refusée avant l'appel au modèle, avec un code 402 — jamais après avoir dépensé.

#Surface 2 — Composer un lot manuellement

Titre Spécifier, sous-titre : « Composez un lot d'éléments de spécification et leurs relations, puis enregistrez-les en une seule opération atomique. »

Pas à pas :

1. Choisissez la Provenance du lot. Aide : « Origine appliquée à tous les éléments de ce lot. » Options : Humaine, Agent, Rétro-ingénierie, Ingérée.
2. Cliquez sur Ajouter un élément. Chaque élément se nomme Élément 1, Élément 2…
3. Pour chaque élément, renseignez :

4. Renseignez les attributs propres au type choisi. Les principaux :

5. Reliez vos éléments dans le bloc Relations : « Reliez les éléments de ce lot entre eux. Chaque relation part d'une référence vers une autre. » Choisissez Source, Cible et Type de relation.
6. Cliquez sur Enregistrer le lot. Le bouton devient Enregistrement….

Contraintes et messages :

Résultat attendu : le panneau Lot enregistré — « N élément(s) et M relation(s) enregistrés avec succès. » — avec le tableau Éléments créés (Référence, Type, Identifiant canonique) et les rebonds Voir l'explorateur / Spécifier un autre lot.

L'enregistrement est atomique. Si une seule ligne du lot est refusée, rien n'est écrit. Vous n'obtiendrez jamais une moitié de lot.

[Gabarit : capture d'écran à produire — page Spécifier avec le panneau IA en haut et le composeur de lot en dessous]

#4.7 Analyse des écarts — /projects/{projet}/analyze

Statut : Livré. · Permission : lecture. · Écran strictement en lecture seule.

#À quoi ça sert

Mesurer objectivement ce qui manque à votre spécification, au regard du métamodèle actif et de la constitution du projet.

Sous-titre : « Analyse en lecture seule de la cohérence de la spécification. Aucune donnée n'est modifiée. » Le badge Lecture seule porte l'aide « Cette analyse n'altère aucune donnée. »

#Ce qu'on y voit

#Les neuf familles d'écarts

#Actions pas à pas

1. Ouvrez la page. L'analyse se lance automatiquement.
2. Lisez la synthèse, puis le détail.
3. Corrigez dans l'explorateur ou dans Spécifier.
4. Revenez et cliquez sur Actualiser (bouton en Actualisation… pendant le calcul).

#Messages et états

#4.8 Traçabilité — /projects/{projet}/trace

Statut : Livré. · Permission : lecture.

#À quoi ça sert

Explorer la fermeture des relations d'un élément : ce dont il dépend, ou ce qui dépend de lui. Sous-titre : « Explorez la fermeture des relations d'un élément, vers l'amont (parents) ou l'aval (enfants). »

#Actions pas à pas

1. Choisissez un élément dans le champ Élément à explorer. Aide : « Choisissez un élément dans la liste du projet. » Invite : « Rechercher un élément… »
2. Ou collez un identifiant directement dans Identifiant de l'élément. Aide : « Ou collez directement l'identifiant canonique (ex. « APP-FR-0001 »). » Puis cliquez sur Explorer.
3. Choisissez la Direction : Amont (parents) ou Aval (enfants). Aide : « « Amont » remonte vers les éléments dont dépend la racine ; « Aval » descend vers ceux qui en dépendent. »
4. Lisez les indicateurs : le nombre d'éléments, la Profondeur maximale, la Racine.
5. Cliquez sur un nœud de l'arbre pour ouvrir son détail.
6. Effacer la sélection remet à zéro.

Votre sélection et votre direction sont recopiées dans l'URL. Le lien est donc partageable en l'état.

#Messages et états

#4.9 Activité des agents du projet — /projects/{projet}/agents

Statut : Livré (tableau réel, alimenté par le service de copilote). · Permission : lecture.

#À quoi ça sert

Voir les exécutions réelles du copilote pour ce projet. Sous-titre : « Les exécutions réelles du copilote pour ce projet. Chaque génération par l'IA sur la page Spécifier apparaît ici, avec son activité en direct et les éléments créés. »

#Ce qu'on y voit

Un tableau Exécutions à cinq colonnes : Statut, Invite, Modèle, Éléments, Créée le. Statuts affichés : En file, En cours, Terminée, Échouée.

#Actions pas à pas

1. Cliquez sur une ligne pour ouvrir le Détail de l'exécution.
2. Le panneau montre : le badge En direct si l'exécution tourne encore, Créée le, Terminée le, l'Invite, l'Activité pas à pas, et Éléments créés (N).
3. Pour une exécution en cours, cliquez sur Arrêter l'exécution. La confirmation précise : « Ceci demande l'annulation de l'exécution. Le travail déjà effectué est conservé ; aucune étape supplémentaire ne s'exécute. »
4. Fermez le panneau avec Fermer.

#Messages et états

⚠️ Ne confondez pas cette page avec Opérations agents (/agents, §4.11). Celle-ci montre les exécutions du copilote pour un projet ; l'autre montre les exécutions du runtime d'agents pour tout le locataire. Ce sont deux services distincts.

#4.10 Sources du projet — /projects/{projet}/sources

Statut : Livré. · Permission : Ajouter une source et Scanner / Rétro-concevoir exigent spec:write ; Retirer une source exige org:capabilities:manage (ADMIN / OWNER), car la suppression est réservée aux administrateurs côté serveur.

#À quoi ça sert

Enregistrer les dépôts de code à rétro-concevoir, puis lancer un scan. Sous-titre : « Enregistrez les dépôts à rétro-concevoir, puis lancez un scan. »

C'est le point d'entrée recommandé quand vous partez d'un système existant plutôt que d'une page blanche.

#Ce qu'on y voit

#Ajouter une source — pas à pas

1. Cliquez sur Ajouter une source.
2. La boîte rappelle : « Pour un dépôt privé, le PAT est déposé dans Vault ; seul son chemin Vault est conservé. »
3. Choisissez le Fournisseur : GitHub, Azure DevOps ou Local.
4. Choisissez la Visibilité : Public ou Privé.
5. Renseignez l'URL du dépôt. Obligatoire. Pour un dépôt local, l'invite propose /chemin/vers/le/dépôt/local.
6. Renseignez la Branche si nécessaire. Aide : « Optionnel. Par défaut, la branche par défaut du dépôt. »
7. Pour un dépôt privé non local, renseignez le Jeton d'accès (PAT). Aide : « Écrit dans Vault. Non conservé en base, non ré-affiché. »
8. Cliquez sur Ajouter la source.

#Lancer un scan — pas à pas

1. Cliquez sur Scanner / Rétro-concevoir. Le bouton est inactif s'il n'y a aucune source enregistrée.
2. Une notification confirme : Tâche de rétro-ingénierie lancée.
3. Suivez l'avancement dans Tâches de rétro-ingénierie.

Les statuts d'une tâche :

Trois modes de tâche existent : Rétro-ingénierie, Hybride, Incrémental.

Les statuts d'une source : Enregistrée, Scan en cours, Scannée, Erreur.

#Retirer une source — pas à pas

1. Cliquez sur Retirer sur la ligne concernée. L'action n'apparaît qu'aux administrateurs.
2. Confirmez. Résultat : Source retirée.

#Messages et états

⚠️ Prérequis réseau côté plateforme. La rétro-ingénierie d'un dépôt public exige que l'environnement autorise la sortie réseau vers l'hébergeur du dépôt. Si le scan reste bloqué en En file, c'est une question d'infrastructure à remonter à votre exploitant, pas une erreur de saisie.

#4.11 Opérations agents — /agents

Statut : Livré. · Permission : lecture ; l'action Interrompre n'est pas masquée par le portail (le serveur arbitre).

#À quoi ça sert

Suivre les exécutions d'agents de tout le locataire, tous projets confondus. Exergue Runtime, sous-titre : « Exécutions d'agents en direct, progression du plan et interruption. »

#Ce qu'on y voit

#Actions pas à pas

1. Cliquez sur une ligne. Le panneau Agent <nom> s'ouvre.
2. Le panneau affiche : Identifiant, Statut, Exécuteur, Budget d'étapes, Mise à jour.
3. Pour une exécution en file, en cours ou suspendue, cliquez sur Interrompre.
4. Fermez avec Fermer.

#Messages et états

⚠️ Le panneau affiche la note « Le flux d'activité complet est diffusé en SSE par le runtime des agents. » Cette note est informative : sur cette page, le flux en direct n'est pas consommé. Le suivi pas à pas en temps réel se trouve sur la page Activité des agents d'un projet (§4.9) et dans la vue AgentOps de l'espace de travail (§5.5). Statut de la diffusion en direct sur cette page : Planifié.

#4.12 Approbations — /approvals

Statut : Livré. · Permission : l'interface ne masque pas les boutons ; le serveur applique la règle de rôle.

#À quoi ça sert

Traiter la file des propositions de changement avant leur application. Exergue Humain dans la boucle, sous-titre : « File des propositions de changement à valider avant application. »

#Ce qu'on y voit

#Approuver ou rejeter — pas à pas

1. Sur une carte de la file, cliquez sur Approuver ou Rejeter.
2. La boîte de confirmation s'intitule Approuver la proposition ou Rejeter la proposition, et identifie la proposition par son système et son identifiant.
3. Renseignez éventuellement le Motif (optionnel) (invite : « Justification de la décision… »).
4. Confirmez avec Approuver ou Rejeter, ou revenez avec Annuler.

Résultat attendu : Changement appliqué ou Changement rejeté.

#Messages et états

#4.13 Imports et remplissage automatique — /imports

Statut : Livré. · Permission : lecture et import ; le serveur arbitre l'écriture.

#À quoi ça sert

Téléverser un document, en extraire des candidats, les corriger, puis créer de vrais éléments. Exergue Ingestion, sous-titre : « Téléversez un document ; le pipeline l'extrait, vous corrigez, puis vous importez de VRAIS objets. »

#Actions pas à pas

1. Choisissez le Projet cible. Aide : « Les objets extraits sont rattachés au périmètre de ce projet. » Invite : Choisir un projet…
2. Dans le bloc Téléverser (« MD, PDF, DOCX ou image — extraction côté serveur »), glissez un fichier sur la zone Glissez un fichier ici, ou cliquez sur Choisir un fichier.
3. Formats acceptés, affichés à l'écran : MD · PDF · DOCX · TXT · PNG · JPG.
4. Le portail confirme : Document traité — « N objet(s) candidat(s) extrait(s). »
5. Dans Objets extraits (« Corrigez si besoin, puis importez. Un import crée un VRAI objet de spécification. »), examinez chaque candidat.
6. Cliquez sur Importer pour créer l'élément — la ligne passe à Importé — ou sur Rejeter pour l'écarter.
7. Consultez la liste Documents : Fichier, Source, Langue, Stockage, Candidats.

#Messages et états

⚠️ Le portail ne contrôle pas la taille du fichier avant l'envoi. Un fichier très volumineux peut être refusé par le serveur après téléversement.

#4.14 Flux de travail — /workflows

Statut : En cours. ⚠️ Lisez l'avertissement ci-dessous avant d'utiliser cette page.

#À quoi ça sert

Composer visuellement un enchaînement d'agents. Exergue Orchestration, sous-titre : « Composez un pipeline d'agents par glisser-déposer ou au clavier. »

#⚠️ Limite réelle, à connaître

Le produit l'affiche lui-même : « Le brouillon est enregistré localement. L'exécution est dispatchée au runtime des agents (écart de persistance côté serveur documenté). »

Concrètement, aujourd'hui :

Utilisez donc cette page comme un carnet de composition personnel, pas comme un orchestrateur partagé. La persistance côté serveur est Planifiée.

#Actions pas à pas

1. Dans Palette d'agents (« Ajoutez une étape au pipeline. »), cliquez sur un profil pour l'ajouter en fin de pipeline : Analyste, Extracteur, Rédacteur, Relecteur, Calcul, Conseiller.
2. Dans Pipeline (« Réordonnez par glisser-déposer ou avec les boutons. »), donnez un Nom du flux.
3. Réordonnez par glisser-déposer, ou avec les boutons Monter et Descendre — ce second chemin est le chemin accessible au clavier.
4. Ajoutez éventuellement une Instruction de l'étape (optionnel) sur chaque étape.
5. Supprimez une étape avec Retirer.
6. Vider efface tout le brouillon ; une notification confirme Brouillon vidé.

#Messages et états

#4.15 Mes prompts — /prompts

Statut : Livré, mais conditionné à un drapeau serveur. ⚠️ Voir ci-dessous.

#À quoi ça sert

Gérer vos prompts personnels, privés à vous seul. Exergue Personnel, sous-titre : « Vos prompts personnels, privés à vous seul. Ils sont proposés à vos agents. Ici, vous ne gérez QUE des prompts — ni skills, ni outils. »

#⚠️ Condition d'activation

Cette page dépend du drapeau serveur REGISTRY_TIERED_SCOPES_ENABLED, dont la valeur par défaut est False. Si le drapeau n'est pas levé sur votre environnement, la page affiche :

Prompts personnels désactivés — « Les prompts personnels ne sont pas activés sur cet environnement (indicateur REGISTRY_TIERED_SCOPES_ENABLED). Ils s'activeront une fois l'indicateur levé. »

Ce n'est pas une panne. Demandez l'activation à votre exploitant.

#Actions pas à pas

1. Cliquez sur Nouveau prompt.
2. Renseignez :

3. Cliquez sur Créer. Résultat : Prompt personnel créé.
4. Le tableau liste Nom, Phase, Dernière version, Risque, Mis à jour, Actions.
5. Pour supprimer, cliquez sur Supprimer. La confirmation Supprimer le prompt ? précise : « Cette action supprime définitivement votre prompt personnel (et ses versions). Elle est irréversible. » Résultat : Prompt supprimé.

#Messages et états

#4.16 Rôles IA — /roles

Statut : Livré, mais conditionné à un drapeau serveur ET au forfait. ⚠️ Voir ci-dessous.

#À quoi ça sert

Composer des capacités sur des rôles métier, et lier une capacité pour votre session ou de façon durable. Exergue Rôles virtuels IA, sous-titre : « Composez des capacités sur des rôles métier, et liez une capacité pour votre session ou de façon persistante. »

#⚠️ Trois conditions cumulatives

#Onglet Rôles d'équipe — pas à pas

1. Choisissez un Rôle dans le sélecteur (— choisir un rôle —). Aide : « Sélectionnez un rôle virtuel pour inspecter son bundle résolu et y adopter des capacités. »
2. Lisez les badges du rôle : Plafond {niveau}, Effectif {niveau}, RPA activé ou RPA désactivé, Modèle {niveau}.
3. Parcourez le bundle résolu : Compétences, Prompt, Outils.
4. Filtrez la liste des capacités globales avec Filtrer par type : Tous, Compétence, Outil MCP, Prompt.
5. Cliquez sur Adopter au rôle. Aide : « Liez une capacité globale à la portée agent du rôle sélectionné. Soumis à votre forfait (fonction d'adoption globale + quota d'adoptions). »
6. La confirmation Adopter au rôle précise : « Ceci lie la capacité à la portée agent du rôle. Elle se résout via le chemin gouverné, refus par défaut. »
7. Résultat : Adopté au rôle.

#Onglet Mes liaisons — pas à pas

1. Lisez l'aide : « Liez un outil MCP à un rôle pour cette session (gratuit) ou de façon persistante (module payant). »
2. Choisissez le Mode de liaison :
   • Cette session (gratuit) — « Une liaison gratuite et éphémère pour cette session de navigateur uniquement — elle expire automatiquement. »
   • Persistant (module) — « Une liaison durable qui persiste entre les sessions. Nécessite le module de liaison persistante. »
3. Choisissez la Capacité (outil MCP) (— choisir un outil —). Obligatoire.
4. Choisissez éventuellement la Portée du rôle (optionnel). Aide : « Indiquez éventuellement quel rôle cette liaison cible. »
5. Cliquez sur Lier pour cette session ou Lier de façon persistante.
6. Résultat : Lié pour cette session. ou Liaison persistante créée.

#Messages et états

#4.17 Consommation & budgets — /usage

Statut : Livré. · Permission : lecture. · Écran en lecture seule.

#À quoi ça sert

Suivre le solde, les budgets et la trajectoire de consommation. Exergue Facturation, sous-titre : « Suivi des budgets, du solde de crédits et de la trajectoire de consommation. »

#Ce qu'on y voit

Les cinq états de budget : Sain, Seuil d'alerte, Seuil élevé, Seuil critique, Dépassé.

#Actions pas à pas

1. Lisez les indicateurs.
2. Vérifiez l'état de chaque budget.
3. Cliquez sur Voir le grand livre pour ouvrir le détail des mouvements.

#Messages et états

Ne confondez pas l'Autonomie estimée (le nombre de jours que votre solde permet de tenir) avec le plafond d'autonomie d'un agent (§3.10). Ce sont deux notions sans rapport qui partagent un mot.

#4.18 Grand livre & facturation — /invoices

Statut : Livré. · Permission : lecture. · Écran en lecture seule.

#À quoi ça sert

Consulter le journal des mouvements de crédits. Exergue Facturation, sous-titre : « Journal des mouvements de crédits (ajouts, débits) — données réelles en lecture seule. »

#Ce qu'on y voit

#Actions pas à pas

1. Filtrez avec Filtrer par type (Tous les types).
2. Cliquez sur Exporter (CSV) pour télécharger la sélection courante. Le bouton est inactif si le filtre ne rend aucune ligne.

⚠️ L'export est produit par votre navigateur à partir des lignes déjà chargées. Ce n'est pas un export serveur : il ne contient donc que ce que vous voyez, filtre appliqué.

#Messages et états

#4.19 Identifiants — /credentials

Statut : Livré. · Permission : lecture et écriture ; le serveur arbitre.

#À quoi ça sert

Enregistrer vos clés de fournisseurs de modèles. Exergue Sécurité, sous-titre : « Enregistrez vos clés fournisseur ; elles sont déposées dans Vault et jamais affichées. »

#La règle centrale

L'avertissement affiché en haut de page est le contrat : « Les secrets sont écrits directement dans Vault. Le portail n'affiche que la référence Vault — jamais la valeur du secret. »

Vous ne pourrez donc jamais relire une clé enregistrée depuis le portail. C'est voulu.

#Enregistrer une clé — pas à pas

1. Cliquez sur Enregistrer une clé.
2. La boîte rappelle : « Le secret est déposé dans Vault et n'est jamais stocké en base ni ré-affiché. »
3. Renseignez le Nom du compte. Obligatoire. Invite : « Ex. : Espace Anthropic — prod ».
4. Choisissez le Fournisseur.
5. Choisissez le Type de compte : Espace API ou Abonnement.
6. Collez le Secret (clé API). Obligatoire. Aide : « Écrit dans Vault. Non persisté en base, non ré-affiché. »
7. Cliquez sur Enregistrer.

⚠️ Le portail ne vérifie pas le format de la clé. Une clé erronée sera acceptée à l'enregistrement et échouera à l'usage.

#Révoquer une clé — pas à pas

1. Cliquez sur Révoquer sur la ligne de la clé.
2. Le bouton devient Confirmer ?. Cliquez à nouveau pour confirmer. Si vous cliquez ailleurs, l'action s'annule d'elle-même.
3. Résultat : Clé révoquée.

#Ce qu'on y voit

Le bloc Comptes fournisseurs (« Comptes enregistrés et leurs identifiants (sans secret). ») liste, pour chaque identifiant : la Réf. Vault, la mention Éligible au pool le cas échéant, son état et sa date.

#Messages et états

#4.20 Équipe — /team

Statut : Livré. · Permission : lecture pour tous ; inviter, changer un rôle, retirer un membre, gérer les invitations exigent org:capabilities:manage (ADMIN / OWNER).

Voir §7 pour la lecture complète du modèle de collaboration.

#Ce qu'on y voit

#Inviter un membre — pas à pas

1. Cliquez sur Inviter un membre.
2. La boîte explique : « Envoyez une invitation par e-mail. Le membre rejoint avec le rôle choisi. »
3. Renseignez l'E-mail (invite : [email protected]).
4. Choisissez le Rôle. La valeur proposée par défaut est EDITOR.
5. Cliquez sur Envoyer l'invitation (bouton en Envoi…).

#Gérer une invitation en attente

#Changer le rôle d'un membre

1. Sur la ligne du membre, ouvrez le sélecteur de Rôle.
2. Choisissez le nouveau rôle. Résultat immédiat : Rôle mis à jour.

#Retirer un membre

1. Cliquez sur Retirer.
2. La confirmation Retirer le membre ? précise : « Ceci retire <courriel> de l'organisation. Cette personne perd tout accès à ce locataire. »
3. Confirmez. Résultat : Membre retiré.

#Messages et états

⚠️ Le tableau Rôles & capacités est calculé par le portail, à partir d'une matrice embarquée dans l'application. C'est une aide à la lecture, pas la source de vérité : la politique qui fait foi est celle du serveur. En cas de divergence apparente, croyez le comportement du serveur.

#4.21 Cabinet — capacités — /organization/capabilities

Statut : Livré ; les onglets d'adoption sont conditionnés à un drapeau serveur. · Permission : capacité org:capabilities:manage sur toute la page (ADMIN / OWNER). L'entrée est masquée du rail pour les autres rôles.

#À quoi ça sert

Gérer les capacités propres à votre organisation et adopter des capacités du registre global. Exergue Cabinet, sous-titre : « Adoptez des entrées du registre global, gérez les skills, prompts et outils PROPRES à votre cabinet (privés à l'organisation et à son équipe) et configurez quels agents les utilisent. »

#⚠️ Conditions

Notez bien : l'onglet Entrées du cabinet continue de fonctionner même quand le drapeau est baissé. Seuls Adopter et Adoptions sont neutralisés.

#Onglet Adopter (registre global)

1. Lisez l'aide : « Parcourez les capacités globales proposées par la plateforme et adoptez celles utiles à votre cabinet. Choisissez la portée : tout le cabinet, ou un agent précis. »
2. Filtrez par Type : Tous, Skills, Outils, Prompts.
3. Lisez les colonnes : Nom, Type, Risque, Version, État (Adopté / actif ou Disponible).
4. Cliquez sur Adopter.
5. Dans Adopter la capacité, choisissez la Portée d'adoption : Tout le cabinet ou Un agent précis. Dans ce second cas, renseignez l'Identifiant de l'agent. Aide : « L'entrée ne sera proposée qu'à cet agent (portée « agent:<id> »). »
6. Résultat : Capacité adoptée.

#Onglet Entrées du cabinet — Skills

1. Cliquez sur Nouveau skill.
2. Renseignez :

3. Cliquez sur Créer. Résultat : Skill créé (brouillon).

Un skill « atterrit en brouillon jusqu'à approbation (SoD) » : vous ne pouvez pas créer et approuver votre propre skill.

#Onglet Entrées du cabinet — Outils (MCP)

Rappel affiché : « Serveurs/outils MCP privés à votre cabinet. Aucun secret n'est stocké : seuls le CHEMIN Vault (credential_ref) et la forme d'authentification (non secrète) sont conservés. »

1. Cliquez sur Nouvel outil.
2. Renseignez le Nom du serveur et l'URL / endpoint (tous deux obligatoires), la Description, le Transport.
3. Choisissez le Type d'authentification : Aucune, OAuth2, Clé API, Basique (login).
   • Pour OAuth2 : Endpoint du jeton (token endpoint), Scopes (séparés par des virgules), Type d'octroi (grant) (client_credentials ou refresh).
   • Pour Clé API : Emplacement (En-tête ou Paramètre de requête) et Nom de l'en-tête / paramètre.
4. Renseignez le Chemin Vault du justificatif (credential_ref). Obligatoire dès que l'authentification n'est pas Aucune. Aide : « Les secrets vivent dans Vault — saisissez UNIQUEMENT le chemin Vault, jamais la valeur du secret. »
5. Renseignez éventuellement les En-têtes statiques (JSON non secret) — « Objet JSON d'en-têtes NON secrets (jamais de justificatif ici). » —, le Délai d'expiration (ms) et le Chemin de santé (optionnel).
6. Cliquez sur Créer. Résultat : Outil MCP enregistré.

Note affichée : « Seuls les NOMS des sous-clés Vault sont conservés (jamais leurs valeurs). »

#Onglet Entrées du cabinet — Prompts

Même formulaire que les prompts personnels (§4.15), à la portée près : ceux-ci sont privés au cabinet. « Le corps est stocké dans prompt-orchestration ; le catalogue ne conserve qu'un lien gouverné. »

#Révoquer une entrée

1. Cliquez sur Révoquer.
2. La confirmation (Révoquer le skill ?, Révoquer l'outil ?, Révoquer le prompt ?) précise : « La révocation désactive toutes les liaisons / permissions associées. Motif obligatoire (audité). Action irréversible. »
3. Renseignez le Motif de révocation. Sans motif, la confirmation reste inactive.
4. Résultat : Entrée révoquée.

#Onglet Adoptions

1. Lisez l'aide : « Entrées globales adoptées par votre cabinet et leur portée. Supprimez une adoption pour retirer l'accès. »
2. Colonnes : Type, Identifiant de capacité, Portée, Activée.
3. Cliquez sur Retirer pour révoquer une adoption. La confirmation précise : « L'entrée globale ne sera plus proposée pour cette portée. Action réversible (ré-adoptez à tout moment). »
4. Résultat : Adoption retirée.

#Messages et états

#4.22 Notifications — /notifications

Statut : Livré. · Permission : lecture.

#À quoi ça sert

Consulter les faits en attente et les événements récents. Exergue Centre, sous-titre : « Faits en attente et événements récents, avec liens profonds. »

#Actions pas à pas

1. Basculez entre Toutes et Non lues ({N}).
2. Cliquez sur Ouvrir pour suivre le lien profond d'une notification — il vous mène exactement à l'écran concerné.
3. Cliquez sur Marquer comme lu sur une ligne.
4. Cliquez sur Tout marquer comme lu pour l'ensemble. Le bouton est inactif quand il n'y a aucune non-lue.

#Ce qu'on y voit

Le bloc Boîte de réception. Une notification dont le fait n'a plus cours est marquée obsolète.

#Messages et états

⚠️ Tout marquer comme lu envoie une requête par notification, pas une requête unique. Sur une boîte très remplie, l'opération peut prendre quelques secondes. Statut de l'opération groupée : Planifié.

#4.23 Paramètres — /settings

Statut : Livré. · Permission : lecture ; les réglages sont locaux à votre appareil.

#À quoi ça sert

Régler l'apparence et consulter le contexte de travail. Exergue Préférences, sous-titre : « Apparence, espace de travail et informations produit. »

#Ce qu'on y voit et comment agir

Il n'y a pas de bouton Enregistrer : chaque changement s'applique immédiatement.

⚠️ La valeur affichée sous Build est une constante de l'application, pas une empreinte de compilation. Pour identifier précisément une version déployée, adressez-vous à votre exploitant.

#4.24 Retours & feuille de route — /projects/{projet}/feedback

Statut : Livré. · Permission : lecture et vote pour tous ; le composeur de commentaires exige spec:write. Le serveur arbitre les autres écritures.

#À quoi ça sert

Collecter, trier, prioriser et publier les retours, en les reliant au cycle de vie. Sous-titre : « Capture des retours, votes, priorisation RICE, feuille de route publique et changelog — reliés au cycle SDLC (admission → spec → livraison). »

Cinq onglets : Boîte de réception, Feuille de route, Changelog, Sondages, Widget.

#Onglet Boîte de réception

Consigner un retour — pas à pas :

1. Choisissez le Type : Bogue, Idée ou Général.
2. Renseignez le Titre (invite : « Résumé court (optionnel) »).
3. Renseignez les Détails (invite : « Décrivez le bug, l'idée ou le commentaire… »). Le bouton reste inactif tant que ce champ est vide.
4. Cliquez sur Ajouter le retour (bouton en Ajout…). Résultat : Retour consigné.

Voter : cliquez sur Voter sur une demande. Résultat : Vote enregistré.

Trier (triage) — pas à pas :

1. Cliquez sur Trier sur une demande.
2. Renseignez la Note de décision.
3. Choisissez l'action :

4. Résultat : Décision enregistrée, ou Échec de l'opération.

Prioriser en RICE : renseignez l'Impact, la Confiance (0–1) et l'Effort (p-mois), puis cliquez sur Calculer RICE. Le résultat vous place dans un quadrant : Gain rapide, Gros pari, Bouche-trou ou Gouffre.

⚠️ Les champs Confiance et Effort ne sont pas validés numériquement par le portail. Saisissez des nombres ; une valeur non numérique donnera un score aberrant sans message d'erreur.

Commenter : écrivez dans le champ Écrire un commentaire interne… puis Ajouter un commentaire. Vous pouvez Répondre à un commentaire (Envoyer la réponse, Annuler) et Mentionner un membre (Choisir un membre…, Retirer la mention). Les commentaires portent le badge Interne.

Partager : cliquez sur Partager, choisissez un membre dans Partager avec (Choisir un membre…), ajoutez une Note (optionnel), puis Partager. Résultat : Retour partagé / Partagé avec <personne>, ou Échec du partage.

Les sept statuts d'une demande : Nouveau, En examen, Planifié, En cours, Livré, Fermé, Fusionné.

#Onglet Feuille de route

Vue par statut des demandes retenues. Vide : Aucun élément.

#Onglet Changelog

1. Renseignez le Titre, la Version et le Contenu.
2. Cliquez sur Créer l'entrée. Résultat : Entrée de changelog créée. ou Échec de la création.
3. L'entrée apparaît avec le badge Brouillon.
4. Cliquez sur Publier. Résultat : Entrée publiée et badge Publié. En cas d'échec : Échec de la publication.
5. Le bloc Demandes liées montre les retours rattachés à l'entrée.

#Onglet Sondages

Titre : Sondages NPS / CSAT / CES.

1. Choisissez le Type.
2. Renseignez la Question.
3. Cliquez sur Créer. Résultat : Sondage créé ou Échec de la création.
4. Chaque sondage affiche Actif ou Inactif, et son nombre de réponses (ou Aucune réponse).
5. Vide : Aucun sondage pour l'instant.

#Onglet Widget

Titre : Clés du widget intégrable. Description : « Une clé publique par site : elle identifie le tenant et le projet, restreint les origines autorisées, et se révoque instantanément. »

1. Renseignez le Nom de la clé.
2. Renseignez les Origines autorisées (séparées par des virgules, vide = toutes).
3. Cliquez sur Générer une clé. Résultat : Clé générée ou Échec de la génération.
4. Copiez le Code d'intégration proposé et collez-le dans votre site.
5. Une clé peut être Active ou Révoquée ; utilisez Révoquer puis Réactiver.
6. Vide : Aucune clé pour l'instant.

Sécurité. Une clé de widget est publique par nature : elle est visible dans le code source de votre site. C'est pourquoi elle est restreinte par origine et révocable instantanément. Ne l'utilisez jamais comme un secret.

#Messages et états

Tous les onglets affichent Service non raccordé nommant le service de retours si celui-ci n'est pas configuré sur votre environnement.

#4.25 Page publique de retours — /public/feedback

Statut : Livré. · Permission : aucune — la page est anonyme. Elle exige en revanche une clé de widget dans l'URL : ?key=pk_…

#À quoi ça sert

Offrir à vos utilisateurs finaux une page où proposer des idées, voter et suivre ce qui est livré. Titre : Vos idées, notre feuille de route, sous-titre : « Proposez des améliorations, votez pour celles qui comptent, suivez ce qui est livré. »

Trois onglets : Demandes, Feuille de route, Nouveautés.

#Actions pas à pas

1. Ouvrez l'adresse avec la clé : …/public/feedback?key=pk_…
2. Pour voter, renseignez d'abord Votre courriel. Aide : « Utilisé uniquement pour compter votre vote (une voix par personne) et vous prévenir à la livraison. » Votre adresse est mémorisée sur votre appareil pour éviter de la retaper.
3. Cliquez sur le bouton de vote d'une demande.
4. Pour proposer, cliquez sur Proposer une idée.
5. Dans Proposer une idée ou signaler un problème, choisissez le Type, rédigez dans Décrivez votre demande, et renseignez éventuellement votre courriel (« Optionnel — pour être informé quand c'est livré. »).
6. Cliquez sur Envoyer (bouton en Envoi…).

#Messages et états

⚠️ Sur l'onglet Feuille de route de la page publique, une feuille de route sans aucun élément affiche une grille vide plutôt qu'un message. Ce n'est pas une erreur ; l'amélioration est Planifiée.

#4.26 Écrans techniques

Notez la référence d'incident. Quand vous signalez un problème, cette référence permet de retrouver la trace exacte côté serveur. C'est l'information la plus utile que vous puissiez transmettre.

---

#5 · L'espace de travail projet en profondeur

/projects/{projet}/workspace — Statut : Livré.

#5.0 Le cadre commun

#L'en-tête

Le fil d'Ariane n'est pas dans l'espace de travail : il vit dans la barre supérieure de l'application. Il traduit projects en Projets et workspace en Espace SDD, et abrège les identifiants techniques. ⚠️ Il ne reflète pas la vue active : deux vues différentes du même projet ont le même fil d'Ariane.

#Le sélecteur de vues

Une barre de pastilles, une par vue visible. Une vue est visible si — et seulement si — les deux conditions suivantes sont réunies :

1. Vous avez la capacité qui la protège.
2. Si la vue est réservée à un type de projet, votre projet est de ce type.

Une conséquence utile. Le rôle VIEWER détient déjà les neuf capacités de lecture. Un VIEWER voit donc les onze pastilles (dix sur un projet standard). Ce qu'il ne peut pas faire, ce sont les actions d'écriture — mais l'écran reste consultable.

#Le lien profond et la persistance

1. La vue active et l'élément ouvert vivent dans l'URL : ?view=<vue>&item=<identifiant>.
2. Changer de vue remplace l'entrée d'historique sans faire défiler la page : votre bouton « précédent » ne se remplit pas de dizaines d'étapes.
3. Une valeur de view inconnue retombe silencieusement sur Spéc.
4. Le dernier état est mémorisé par projet sur votre appareil. Il ne sert qu'à amorcer votre premier atterrissage ; un ?view= explicite gagne toujours.
5. Atterrissage automatique. Si vous ouvrez l'espace de travail sans ?view= :
   • un projet de type Tests ouvre directement la vue Tests ;
   • un projet de type livraison ouvre directement la vue Livraison.

#La palette de l'espace de travail

Ouvrez avec Ctrl+K / ⌘K. Elle préempte la palette globale : c'est la palette du projet qui s'ouvre, pas celle de l'application.

Choisir une vue y bascule. Choisir un élément bascule sur la vue Spéc et sélectionne l'élément.

#Contenir une panne

Chaque vue est encapsulée : si une vue plante, elle seule est remplacée par le bloc d'erreur. Le sélecteur de vues, l'en-tête et la navigation restent utilisables. Changer de vue efface l'erreur.

#Les gardes de l'espace de travail

[Gabarit : capture d'écran à produire — espace de travail avec le sélecteur des 11 vues, l'en-tête et les compteurs de contexte]

#5.1 Vue Spéc

Statut : Livré. · Capacité : spec:read pour voir ; cycle:run pour lancer le cycle.

#Ce qu'on y voit

Titre Éléments de spécification, sous-titre « Liste, filtres et recherche — données réelles du spec-service. » Quatre filtres, puis un tableau à cinq colonnes (Identifiant, Type, Statut, Titre, Provenance), vingt lignes par page.

Une provenance issue d'une méthode s'affiche comme une pastille violette — c'est le même code couleur que la provenance d'agent (§3.8).

#Actions pas à pas

1. Filtrez avec la recherche, le type, le statut ou la méthode.
2. Cliquez sur une ligne : elle se surligne et son identifiant passe dans l'URL (?item=).
3. Parcourez avec Précédent / Suivant. La plage s'affiche : « 1–20 sur 137 ».
4. Un élément étant sélectionné, cliquez sur Lancer le cycle SDD. ⚠️ Le bouton n'apparaît qu'avec la capacité cycle:run et reste inactif tant qu'aucun élément n'est sélectionné.

#Le panneau Cycle SDD

Titre Cycle SDD, sous-titre « Exécuter une étape du cycle sur l'élément ciblé (persistance réelle). »

Pas à pas :

1. Vérifiez l'Élément cible. S'il est vide : Sélectionnez d'abord un élément cible dans la vue Spéc.
2. Choisissez l'Étape.
3. Remplissez les champs propres à l'étape.
4. Cliquez sur Exécuter l'étape (bouton en Exécution…).
5. Une porte de validation humaine s'ouvre : Approbation requise — « Cette étape va écrire de vrais objets de spécification. Confirmez-vous ? »
6. Confirmez avec Approuver et exécuter, ou revenez avec Annuler.

Résultats affichés : « N élément(s) créé(s), M lien(s). » · « N artefact(s) créé(s), M lien(s). » · « N tâche(s), M dépendance(s). » · « Dispatch : <statut>. » · « N dérive(s), M transition(s). »

⚠️ L'étape Implémenter est une action coûteuse : elle mobilise des agents. Le serveur la réserve aux rôles ADMIN et OWNER. Le portail n'en masque pas le choix : si votre rôle ne suffit pas, l'exécution est refusée par le serveur avec un message d'erreur. Statut du masquage côté interface : Planifié.

#Le panneau Constitution

Ouvert par Gérer la constitution dans l'en-tête (capacité constitution:read).

Titre Constitution, sous-titre « Articles de gouvernance (org / projet / feature). Les non-négociables prévalent. »

Pas à pas :

1. Consultez le tableau : Article, Portée, Texte, Non négociable (Oui / Non).
2. Pour ajouter, renseignez :

3. Cliquez sur Ajouter l'article (bouton en Ajout…). Résultat : Article ajouté.
4. Vide : Aucun article de constitution pour ce locataire.

⚠️ Le portail n'exige pas la capacité constitution:write pour afficher le formulaire d'ajout. Si votre rôle ne le permet pas, le serveur refuse l'écriture. Statut du masquage : Planifié.

#Messages et états

#5.2 Vue Graphe

Statut : Livré. · Capacité : spec:read. · Vue en lecture seule.

#Ce qu'on y voit

Titre Graphe de traçabilité, sous-titre « Amont/aval calculés sur le graphe réel des relations. » Un sélecteur d'Élément racine, un sélecteur de Direction, puis le graphe.

#Actions pas à pas

1. Choisissez l'Élément racine (invite : « Choisir un élément… »). La liste propose les deux cents premiers éléments du projet.
2. Choisissez la Direction : Aval (dépendants) — la valeur par défaut — ou Amont (dépend de).
3. Le calcul de la disposition s'affiche comme Calcul de la disposition… Il s'exécute en arrière-plan pour ne pas figer l'interface.
4. Lisez le compteur : « N nœuds ».
5. Cliquez sur un nœud : il devient l'élément sélectionné (?item=).

#Messages et états

#5.3 Vue Tableaux

Statut : Livré. · Capacité : spec:read pour voir. ⚠️ L'écriture est arbitrée par le serveur.

#Ce qu'on y voit

Titre Tableau du cycle de vie, sous-titre « Glissez une carte pour proposer une transition d'état (gate serveur réel). » Un tableau de type Kanban, une colonne par statut, une carte par élément (titre, puis identifiant · type).

#Déplacer une carte — pas à pas

1. Faites glisser la carte vers la colonne cible.
2. La boîte Transition d'état s'ouvre : « Déplacer « <titre> » vers le statut « <statut> » ? » Les statuts de départ et d'arrivée sont affichés.
3. Renseignez le Motif du changement. Invite : « Pourquoi cette transition ? (obligatoire) ». Le bouton de confirmation reste inactif tant que ce champ est vide.
4. Cliquez sur Appliquer la transition, ou Annuler.

Résultat attendu : Transition appliquée.

Refus possibles :

⚠️ Le portail n'exige pas la capacité spec:transition pour ouvrir la boîte de dialogue. Un rôle VIEWER peut donc déclencher la tentative — et recevoir un refus du serveur. C'est cohérent avec le refus par défaut côté serveur, mais l'expérience serait meilleure si le portail masquait l'action. Statut : Planifié.

#Messages et états

Aucun élément à afficher sur le tableau.

#5.4 Vue Config

Statut : Livré ; le service de configuration produit n'est pas raccordé partout. · Capacité : config:read pour voir, config:write pour agir.

Titre Configuration produit, sous-titre « Config générée par product-config-service. » Deux onglets : Configuration et Métamodèles.

#Onglet Configuration — lecture seule

Deux blocs suivent : Valeurs par défaut de la stack et Standards de code.

#Onglet Métamodèles

Titre Métamodèles, sous-titre : « Métamodèle résolu du projet — types, attributs et relations — avec sa source, le catalogue par défaut et la validation de conformité. »

Ce qu'on y voit :

Activer un métamodèle par défaut — pas à pas (capacité config:write) :

1. Repérez le métamodèle voulu dans le catalogue.
2. Cliquez sur Utiliser un métamodèle par défaut. Le bouton passe à Activation….
3. Résultat : Métamodèle par défaut activé.

Valider la conformité — pas à pas :

1. Cliquez sur Valider la conformité (bouton en Validation…).
2. Lisez le taux de Conformité et le nombre d'Écart(s).
3. Si tout va bien : Aucun écart de conformité détecté.

Enrichir le modèle — pas à pas (capacité config:write) :

1. Lisez l'annonce : « Enrichissement profond : des experts comblent les attributs et liens manquants à partir de preuves. Par défaut, les changements sont proposés pour validation humaine (aucune écriture directe). »
2. Cliquez sur Enrichir le modèle (bouton en Enrichissement…).
3. Suivez l'Activité en direct. Les événements affichés : Enrichissement démarré, Métamodèle résolu, Écarts détectés, Passe d'expert, Écart, Revue, Proposition, Crédits réglés, Terminé, Échec.
4. Lisez le Rapport d'enrichissement : Politique d'écriture, Couverts avant, Couverts après, Renseignés, Propositions en attente, Écarts restants, Passes.
5. Chaque passe détaille les éléments Produits, Approuvés, Refusés, avec pour chacun le Hook, le champ Manquant, le Motif et les Preuve(s).

Les motifs de refus affichés : aucune preuve · proposition incomplète · revue refusée · revue inconclusive · non concluant · violation SoD · HITL indisponible · écriture refusée.

Le point important. L'enrichissement ne modifie pas votre métamodèle : il propose. Les propositions portent la mention en attente de validation. C'est le refus par défaut appliqué à l'écriture assistée par IA.

#5.5 Vue AgentOps

Statut : Livré. · Capacité : agentops:read. · Vue en lecture seule.

#Ce qu'on y voit

Titre AgentOps — runs en direct, sous-titre « Runs d'agents réels (copilot). Suivi SSE en direct des exécutions. » Un tableau de cent lignes maximum : Statut, Invite, Modèle, Éléments, Créé. Sous le tableau, le détail de l'exécution sélectionnée.

#Actions pas à pas

1. Cliquez sur une ligne. Le panneau de détail s'ouvre sous le tableau.
2. Pour une exécution en cours, l'activité s'affiche en direct, poussée par le serveur ; pour une exécution terminée, la chronologie persistée est rejouée.
3. Fermez le panneau pour revenir à la liste.

#Messages et états

#5.6 Vue Tests

Statut : Livré, réservé aux projets de type Tests. · Capacité : test:read.

#Quand cette vue apparaît

Elle apparaît si et seulement si votre projet a été créé avec le Type de projet : Tests, et que vous avez la capacité test:read.

#Ce qu'on y voit

Titre Tests — application déployée, sous-titre : « Test agentique en profondeur d'une application existante : environnements, plans HIL, runs (SSE en direct + preuves) et boucle correction → re-test. »

Douze onglets, l'onglet Couverture étant ouvert par défaut :

#5.6.1 Onglet Couverture

Lecture seule. Quatre indicateurs : Critères d'acceptation, Couverts, Cas verts, Couverture. Puis la liste Critères sans couverture.

#5.6.2 Onglet Environnements

Titre Environnements cibles, sous-titre : « URL et politique de chaque environnement de l'application à tester (dev/QA/prod). »

Ajouter un environnement — pas à pas :

1. Cliquez sur Ajouter un environnement.
2. La boîte rappelle deux règles : « Prod est toujours forcé en lecture seule. L'identifiant est un chemin Vault, jamais un secret. »
3. Renseignez :

4. Cliquez sur Ajouter. Résultat : Environnement ajouté — « L'environnement cible a été enregistré. »

Pour retirer : Retirer sur la ligne. Résultat : Environnement retiré.

Le tableau affiche : Environnement, Nom, URL de base, Auth, Dépôt, Parallélisme, Lecture seule (Oui / Non), avec le badge Lecture seule imposée le cas échéant.

#5.6.3 Onglet Plans

Titre Plans de test, sous-titre : « Dériver les cibles, générer les cas, prioriser, puis soumettre à approbation HIL. »

La chaîne complète, pas à pas :

1. Dériver les cibles — le service identifie ce qu'il faut tester. Résultat : « N cible(s) dérivée(s). »
2. Générer les cas — les cas de test sont produits. Résultat : « N cas généré(s). »
3. Prioriser — ouvrez Prioriser par risque. Aide : « Ordonne les cas existants du plan selon le risque de la cible, la criticité et l'historique d'échecs — rien n'est fabriqué. » Renseignez éventuellement le Nombre max d'éléments (« Plafonne les éléments planifiés (garde les plus à risque). Vide = sans limite. »). Résultat : « N cas planifié(s) par risque. »
4. Soumettre — ouvrez Soumettre le plan. Choisissez la Politique d'approbation :
   • require_hil (validation humaine) — une personne doit approuver.
   • auto_final (auto-approuvé) — pas de validation humaine.
   • conditional (conditionnel) — selon des conditions. Choisissez l'Environnement (Choisir un environnement…). Choisissez la Politique de correction — « Comment appliquer les correctifs (prod ⇒ toujours require_hil). » Résultat : Plan soumis à approbation.
5. Approuver — ouvrez Approuver le plan. L'aide est explicite : « L'approbation passe par la file HIL d'agentic-core (séparation des devoirs : l'approbateur doit différer du soumetteur — une auto-approbation renvoie 403 SoD). » Renseignez l'Identifiant de l'approbateur. Résultat : Plan approuvé.

Statuts d'un plan : Brouillon, Soumis, En attente d'approbation, Approuvé, Rejeté.

#5.6.4 Onglet Runs

Titre Runs de test, sous-titre : « Lancez un run contre un environnement ; suivez l'activité en direct et le rapport de preuves. »

Lancer un run — pas à pas :

1. Cliquez sur Lancer un run.
2. Choisissez l'Adaptateur : Playwright (UI), API directe, Sécurité, Accessibilité ou Performance.
3. Choisissez l'Environnement.
4. Choisissez éventuellement un Plan (optionnel) — « Restreindre le run à un plan approuvé. » ou Tous les cas.
5. Réglez la Concurrence max — « Nombre de cas exécutés en parallèle. » Le portail rappelle le Défaut de l'environnement.
6. Renseignez éventuellement une Branche (override) — « Re-tester une branche de correction précise. »
7. Cliquez pour lancer. Résultat : Run lancé.

Suivre et lire :

1. Le panneau Activité en direct affiche la progression réelle.
2. Cliquez sur Rapport pour ouvrir le Rapport du run : Totaux, Résultats, Recommandations, Trous de couverture, et le Défaut ouvert le cas échéant.

Statuts d'un run : En file, En cours, Terminé, Échec, Non concluant. Verdicts d'un résultat : Vert, Échec, Non concluant.

#5.6.5 Onglet Cas

Titre Bibliothèque de cas, sous-titre : « Dossiers hiérarchiques, cas versionnés, scénarios Gherkin et sessions manuelles/exploratoires. »

Organiser :

1. Filtrez par dossier (Tous les dossiers, (racine)).
2. Cliquez sur Nouveau dossier, nommez-le (invite : « Nom du dossier… »). Résultat : Dossier créé.
3. Sur un cas, utilisez Déplacer vers — « Change le dossier du cas (enregistré dans l'historique de versions). » Résultat : Cas déplacé.

Éditer un cas :

1. Cliquez sur Détails. L'aide rappelle : « Version courante : v<n>. Chaque modification ajoute un instantané à l'historique. »
2. Dans Étapes, ajoutez une étape avec son Action et son Assertion.
3. Vous pouvez Choisir une étape partagée… — « Référencer une étape partagée copie son action/assertion et garde le lien. »
4. Cochez Enregistrer aussi dans la bibliothèque partagée pour rendre l'étape réutilisable.
5. Résultat : Étape ajoutée.
6. Consultez l'Historique des versions et comparez deux versions : « Choisissez deux versions (A puis B) pour visualiser leurs différences. »

Éditer un scénario Gherkin :

1. Dans Scénarios (Gherkin) — « Éditez le Gherkin validé de chaque scénario et visualisez la liaison déterministe ligne → étape. » — cliquez sur Modifier.
2. Rédigez le scénario. Le scénario doit porter Étant donné / Quand / Alors.
3. Cliquez sur Enregistrer. Résultat : Scénario enregistré.
4. Consultez la Liaison ligne → étape — « Correspondance déterministe (texte normalisé) entre chaque ligne Gherkin et les étapes des cas liés — jamais inventée. » Une ligne sans correspondance est marquée non liée.

Conduire une session manuelle :

1. Sur un cas, cliquez sur Session manuelle.
2. Pour chaque étape, indiquez le Résultat : Réussie, Échouée, Bloquée, Ignorée ou Non concluante.
3. Renseignez le Résultat observé. Aide : « Ce qui s'est RÉELLEMENT passé — jamais le résultat attendu recopié. »
4. Joignez une Évidence (note) et/ou une Capture d'écran. Règle : « Obligatoire en cas d'échec : aucun verdict sans preuve. »
5. Cliquez sur Enregistrer l'étape.
6. Terminez avec Terminer la session, ou renoncez avec Abandonner.

Conduire une session exploratoire :

1. Cliquez sur Session exploratoire.
2. Renseignez la Charte — « La mission de la session (ex. « explorer la robustesse du panier »). »
3. Cliquez sur Démarrer, puis enregistrez vos observations étape par étape.

Statuts de session : Brouillon, En cours, Terminée, Abandonnée.

#5.6.6 Onglet Flux

Titre Flux utilisateur (pas à pas), sous-titre : « Composez un parcours cas-utilisateur ; le canvas visuel et l'éditeur DSL enregistrent le MÊME document (If-Match), compilé en Playwright. »

Créer un flux — pas à pas :

1. Cliquez sur Nouveau flux.
2. Lisez l'aide : « Décrivez le parcours en DSL — vous pourrez ensuite l'éditer visuellement. Un flux sans étape est rejeté (422). »
3. Rédigez le DSL du flux. Une ligne par étape :

   goto /login · fill [sélecteur] "valeur" · click sélecteur · expect_url /chemin …

4. Renseignez éventuellement l'URL de base — « Optionnelle — préfixe des chemins relatifs (goto /login). »
5. Validez. Résultat : Flux créé.

Éditer un flux : quatre onglets — Canvas, DSL, Playwright, Versions.

Matérialiser : cliquez sur Matérialiser pour transformer le flux en cas exécutable. Résultat : « Cas <id> matérialisé (N étapes). » Tant que ce n'est pas fait, la colonne affiche non matérialisé.

#5.6.7 Onglet Suites

Titre Suites de test, sous-titre : « Suites nommées (smoke / régression / e2e / release) et appartenance des cas. »

1. Cliquez sur Nouvelle suite.
2. Choisissez l'Objet : Smoke, Régression, E2E ou Release.
3. Renseignez la Portée — « Descripteur libre de la portée (ex. « portail client — panier »). »
4. Validez. Résultat : Suite créée.
5. Ouvrez Membres de la suite, cliquez sur Ajouter un cas (Choisir un cas…) puis Ajouter. Résultat : Cas ajouté à la suite.
6. Retirez un membre avec Retirer.

Vide : Aucune suite — « Créez une suite pour regrouper des cas. » · Aucun cas dans cette suite.

#5.6.8 Onglet Cycles

Titre Cycles, jalons et releases, sous-titre : « Regroupez plans et runs par cycle ; le rollup agrège uniquement les totaux de runs persistés. »

1. Cliquez sur Nouveau cycle. Choisissez le Type : Cycle, Jalon ou Release. Renseignez le Nom et la Description. Résultat : Cycle créé.
2. Cliquez sur Rattacher pour lier un Plan (« Les runs des plans rattachés comptent dans le rollup. ») ou un Run directement. Résultat : Rattachement effectué.
3. Cliquez sur Rollup pour lire le Rollup du cycle : Runs, Verts, Échecs, Taux de réussite, Plans rattachés, Runs agrégés. Sans verdict : aucun verdict.
4. Faites évoluer le cycle avec Activer puis Clôturer. Résultat : Cycle mis à jour.

Statuts : Planifié, Actif, Clôturé. Vide : Aucun cycle — « Créez un cycle pour regrouper plans et runs. »

#5.6.9 Onglet Traçabilité

Titre Matrice de traçabilité, sous-titre : « Exigence ↔ scénario ↔ cas ↔ défaut, assemblée depuis les liens EXISTANTS — un cas jamais exécuté reste sans verdict. »

Colonnes : Exigence, Scénarios, Cas (dernier verdict), Défauts, Couverture (Couverte ou Lacune).

1. Lisez l'en-tête : « N / M exigences couvertes ».
2. Filtrez avec Filtrer par exigence…, la case Lacunes uniquement ou la case Avec défauts uniquement.
3. Cliquez sur Export CSV pour extraire la matrice.

#5.6.10 Onglet Défauts

Titre Registre des défauts, sous-titre : « Chaque triage d'échec avec sa proposition, la décision humaine et le défaut ouvert. »

Colonnes : Id, Résultat, Proposé, Décision, Défaut, Confiance, Créé.

Catégories : Défaut produit, Test obsolète, Instable (flaky), Problème d'environnement, Problème de données. Une ligne non tranchée affiche en attente de décision.

Filtre : Avec défaut ouvert uniquement. Vide : Aucun triage — « Aucun échec n'a encore été trié pour ce projet. »

#5.6.11 Onglet Rapports

1. Choisissez la Fenêtre d'agrégation (« N derniers jours »).
2. Lisez les indicateurs : Runs, Résultats, Taux de réussite, Taux d'instabilité.
3. Parcourez les graphiques :

4. Consultez Cas instables — « Marqués flaky OU alternant pass/fail dans la fenêtre. »
5. Consultez Par suite — « Totaux persistés agrégés par suite. »
6. Exportez avec Export CSV ou Export PDF.

Vides : Aucune donnée · Aucun cas instable · Aucun run de suite.

#5.6.12 Onglet Corrections

Trois blocs : la file de triage, les approbations HIL, la boucle de correction.

Trier un échec — pas à pas :

1. Choisissez un Run (Choisir un run…). L'aide précise : « Choisissez un run pour trier ses échecs (le triage est par run — il n'existe pas de file projet). »
2. Sur un résultat en échec, cliquez sur Décider.
3. Choisissez la Décision : Défaut produit, Test obsolète (preuve de spec requise), Instable (flaky), Problème d'environnement ou Problème de données.
4. Renseignez la Note — « Contexte de la décision… »
5. Cochez éventuellement Ouvrir une boucle de correction.
6. Validez. Résultat : Triage enregistré.

Approuver un correctif — pas à pas :

1. Dans Approbation des corrections (HIL) — « File HIL d'agentic-core (séparation des devoirs). Approuvez un correctif avant application. » — repérez la tâche.
2. Les colonnes : Type, Résumé, État, Créé. Types : Correction, Re-test, Génération, Persistance, Acceptation, Export. États : Brouillon, En attente de revue, Approuvé, Final, Rejeté.
3. Renseignez l'Approbateur et cliquez sur Approuver. Résultat : Approbation enregistrée.

Suivre une boucle — pas à pas :

1. Dans Boucle de correction — « Statut de la boucle correction → re-test, avancement borné et audit des remédiations. » — collez l'Identifiant de la boucle.
2. Cliquez sur Charger.
3. Lisez le statut et la Tentative en cours.
4. Cliquez sur Avancer pour faire progresser. Résultat : Boucle avancée.
5. Consultez les Remédiations : Nouvel essai, Replanification, Escalade.

Les dix états d'une boucle :

Vides : Aucun résultat à trier · Aucune tâche HIL · Aucune remédiation pour l'instant.

⚠️ Une limite d'interface à connaître pour toute la vue Tests. Le portail n'applique aucun masquage d'action dans cette vue : un rôle VIEWER peut cliquer sur Ajouter un environnement, Lancer un run ou Approuver. Le serveur refuse — vous verrez Accès refusé —, mais l'action n'aurait pas dû être proposée. Statut du masquage : Planifié.

#5.7 Vue Revue

Statut : Livré. · Capacité : review:read.

#Ce qu'on y voit

Titre Revue & traçabilité, sous-titre « Écarts d'analyse et matrice de couverture — données réelles, lecture seule. »

#Actions pas à pas

1. Cliquez sur une exigence ou sur l'identifiant d'un écart : l'élément devient sélectionné. ⚠️ Le portail ne bascule pas automatiquement sur la vue Spéc : passez-y manuellement pour voir l'élément.
2. Dans Revues en attente, cliquez sur Approuver. Résultat : Revue approuvée.
3. Ou cliquez sur Rejeter. La confirmation Rejeter ce résultat ? précise : « Ceci abandonne le résultat brouillon « <résumé> ». Il ne sera pas appliqué. » Résultat : Revue rejetée.

C'est ici que le refus par défaut devient concret. Un agent qui produit un résultat ne l'applique pas : il le dépose en brouillon, et une personne décide. La colonne Source indique d'où vient le brouillon.

#Messages et états

⚠️ Le portail ne masque pas Approuver / Rejeter selon le rôle. Le serveur arbitre. Statut du masquage : Planifié.

#5.8 Vue Docs

Statut : Livré. · Capacité : docs:export.

#Ce qu'on y voit

Titre Documentation, sous-titre « Documentation et diagramme générés depuis la spec réelle. » Un bloc Graphe de la spécification rendant un diagramme construit depuis l'arbre PRD réel et la matrice de couverture, plus trois sections documentaires : Aperçu, Constitution, Éléments de spécification.

#Actions pas à pas

1. Attendez que le contexte du projet soit chargé — les boutons d'export restent inactifs avant.
2. Cliquez sur Exporter en Markdown. Un fichier <PRÉFIXE>-docs.md est téléchargé.
3. Cliquez sur Exporter le diagramme (.mmd). Un fichier <PRÉFIXE>-graph.mmd est téléchargé.
4. Le rendu du diagramme propose en outre ses propres exports d'image.
5. Chaque export confirme : Document exporté.

⚠️ Ces exports sont assemblés par votre navigateur, à partir des données déjà chargées. Ce n'est pas un rendu produit par un service. Concrètement : le contenu est exact, mais la mise en forme est simple, et le diagramme est plafonné pour rester lisible sur les très gros projets.

Vide : Aucune donnée à documenter pour l'instant.

#5.9 Vue Artefacts

Statut : Livré ; les exports PDF et DOCX ne sont pas encore disponibles. · Capacité : docs:export.

#Ce qu'on y voit

Titre Artefacts d'architecture, sous-titre : « Diagrammes produits par les services (Mermaid), rendus tels quels — jamais inventés. »

Huit onglets, navigables au clavier avec ← et → :

#L'onglet Dépendances

Un sélecteur Vue propose trois représentations du même graphe :

Vide : Aucune dépendance — « Aucune dépendance n'a encore été analysée pour ce projet. »

#Exporter — pas à pas

1. Dans l'en-tête, repérez Exporter :.
2. Cliquez sur Markdown, PDF ou DOCX.
3. Le portail résout le document projeté le plus récent du projet, puis lance l'export. Confirmation : Export lancé.

#5.10 Vue Livraison

Statut : Livré pour la préparation et l'approbation ; le déploiement réel est fermé par défaut. · Capacité : spec:read pour voir ; delivery:run, deploy:run, deploy:approve, deploy:execute selon l'action.

Titre Livraison — pipeline autonome, sous-titre : « Objectif → PRD BMAD → arbre de spécification → export tracker. États réels du flux, acceptation HIL (SoD) et résultats de push honnêtes. »

⚠️ Neuf onglets existent, cinq seulement sont traduits. Les onglets Pipeline, Arbre PRD, Tracker, Déploiement et Méthodes disposent de libellés français maintenus. Quatre onglets supplémentaires — Mise en ligne, Config déploiement, Intégrations, Qualité — portent des libellés français écrits en dur dans le code, sans clé de traduction : ils ne basculent pas en anglais et n'ont pas fait l'objet d'une relecture éditoriale. Statut de leur internationalisation : En cours.

#5.10.1 Onglet Pipeline

Lancer un pipeline — pas à pas (capacité delivery:run) :

1. Renseignez l'Objectif — « Décrivez le résultat produit attendu… ». Obligatoire.
2. Choisissez la Méthode — « Chaque méthode enregistrée (BMAD, Spec-Kit, Kiro…) définit ses propres cycles. » La valeur proposée est le premier pack de méthode actif du projet.
3. Choisissez le Cycle — « Cycles propres à la méthode sélectionnée. » Exemples : quick-spec (spécification rapide), full-sdlc (cycle complet), implementation (implémentation seule).
4. Choisissez la Politique d'acceptation : require_hil (validation humaine), auto_final (auto-approuvé) ou conditional (conditionnel).
5. Choisissez éventuellement un Tracker (optionnel) — « Lie le flux à un export tracker en fin de pipeline. » — et sa Clé du projet tracker (« Ex. KYS (Jira) ou le nom du projet Azure DevOps. »).
6. Cliquez sur Lancer le pipeline. Résultat : Pipeline lancé.

Suivre le flux :

Le bloc État du flux — « Suivi en direct (interrogation périodique) du plan de livraison — états réels d'agentic-core. » — affiche l'identifiant du Plan, celui du PRD, et un enchaînement en quatre étapes :

Génération → Persistance → Acceptation → Export

Chaque étape porte un état : à venir, en cours, terminé, échec.

Les états du flux : Prêt à générer, Généré, Persisté, En attente d'acceptation, Accepté, Rejeté, Livré, Auto-réparation (nouvel essai), Auto-réparation (replanification), Épuisé.

Le suivi s'arrête de lui-même sur un état terminal.

Faire avancer : cliquez sur Avancer. Résultat : Flux avancé.

Accepter ou rejeter — pas à pas (quand l'état est En attente d'acceptation) :

1. Lisez le bloc Acceptation requise (HIL) et son avertissement : « La décision passe par la file HIL d'agentic-core (séparation des devoirs : l'approbateur doit différer du soumetteur — une auto-approbation renvoie 403 SoD). »
2. Renseignez l'Identifiant de l'approbateur. Aide : « Doit différer du soumetteur (SoD). »
3. Pour un rejet, renseignez le Motif (rejet).
4. Cliquez sur Approuver ou Rejeter. Résultats : Acceptation enregistrée. ou Rejet enregistré.

Bannières terminales :

#5.10.2 Onglet Arbre PRD

Lecture seule. Sous-titre : « PRD générés par le pipeline (spec-service) et leur arbre PRD ▸ EPIC ▸ US (▸ FR/NFR ▸ AC) — données réelles, lecture seule. »

1. Choisissez un PRD (Choisir un PRD…).
2. Parcourez l'arbre. Chaque nœud porte son type, son identifiant, son titre, sa provenance de méthode et son statut.
3. Le compteur affiche « N nœuds ».

Vide : Aucun PRD — « Aucun PRD pour ce projet. Lancez le pipeline de livraison pour en générer un. »

#5.10.3 Onglet Tracker

Connecter un tracker — pas à pas (capacité delivery:run) :

1. Lisez l'avertissement : « Le PAT du tracker est référencé par un CHEMIN Vault uniquement — jamais un secret en clair. Déposez le PAT dans Vault à ce chemin ; le portail ne le voit, ne le stocke et ne l'affiche jamais. »
2. Cliquez sur Connecter un tracker.
3. Choisissez le Système : Jira ou Azure DevOps.
4. Renseignez l'URL de base. Obligatoire.
5. Renseignez le Chemin Vault de l'identifiant. Obligatoire. Aide : « Chemin Vault KV uniquement (ex. secret/kyspectra/dev/trackers/jira) — le PAT doit y être déposé au préalable ; il n'est jamais saisi ni affiché ici. »
6. Cliquez sur Connecter. Résultat : Connexion enregistrée.

Pousser un PRD — pas à pas (capacité delivery:run) :

1. Dans Pousser un PRD vers le tracker — « Exporte les EPIC et US canoniques du PRD sélectionné vers Jira / Azure DevOps (hiérarchie préservée). » — choisissez le PRD.
2. Choisissez le Système, la Clé du projet, le Type d'élément et l'Area path si nécessaire.
3. Le portail parcourt l'arbre réel et annonce : « N éléments (EPIC + US) à pousser ».
4. Cliquez sur Pousser vers le tracker.
5. Lisez le résultat : Demandés, Créés, Mis à jour, Échecs, et le tableau détaillé Élément, Action, Id externe, Parent externe, Erreur. Un résultat mixte est marqué partiel.

#5.10.4 Onglet Méthodes

Capacité : config:read pour voir, config:write pour activer. Sans config:read : Accès non autorisé.

1. Consultez le Catalogue des méthodes — « Registre des méthodes de l'ai-orchestrator — chaque méthode possède ses propres cycles et phases. » Colonnes : Méthode, Cycles, Phases, avec le badge Active.
2. Consultez les Packs de métamodèle — « Packs intégrés du registre de métamodèles — activez-en un ou plusieurs pour ce projet (multi-actif). » Colonnes : Pack, Types, Version.
3. Cochez les packs voulus, puis cliquez sur Activer la sélection (N). Résultat : Sélection activée.
4. Lisez la ligne Méthodes actives du projet : ou, à défaut, Aucune méthode active — le métamodèle résolu retombe sur le défaut intégré.
5. Consultez le Métamodèle résolu (composé) — « Résumé du métamodèle effectif du projet — source, types et relations composés des méthodes actives. »

Vides : Aucune méthode · Aucun pack · Aucun métamodèle résolu.

#5.10.5 Onglet Déploiement — le cœur de la gouvernance

C'est l'écran le plus encadré du produit. Lisez la bannière avant d'agir :

« La sécurité d'abord : cette étape prévisualise un plan À BLANC (ce qui serait déployé) et exige une approbation humaine explicite avant tout déploiement réel et contrôlé. Rien n'est déployé automatiquement en production sans intervention humaine. »

L'écran est organisé en trois étapes, qui apparaissent l'une après l'autre.

Étape 1 — Démarrer un run de pipeline (capacité deploy:run)

Sous-titre : « Initialise les six étapes ordonnées et non contournables (build → test → scan → gate → deploy → monitor) pour l'artefact livré. »

1. Vérifiez la Réf. projet — « Préfixe projet canonique (majuscules), ex. SPX. » Une valeur est proposée.
2. Choisissez l'Environnement : Dev, Staging ou Production.
3. Renseignez la Version. Obligatoire : sans elle, Une version est requise.
4. Renseignez éventuellement le Commit / branche — « Commit source sur lequel le pipeline construit (optionnel). »
5. Cliquez sur Démarrer le run. Résultat : Run de pipeline démarré.
6. Tant qu'aucun run n'existe : Aucun run — démarrez-en un pour prévisualiser un déploiement.

Étape 2 — Plan à blanc (capacité deploy:run)

Sous-titre : « Aperçu en lecture seule : la cible de déploiement exacte, l'état des gates et les blocages. N'enregistre rien, ne touche aucune infrastructure. »

1. Les six étapes du pipeline s'affichent avec leur verdict réel. Une étape non encore franchie reste neutre — jamais verte par optimisme.
2. Cliquez sur Prévisualiser (à blanc).
3. Lisez le plan :

Étape 3 — Approuver et déployer

Sous-titre : « Barrière de gouvernance : une approbation humaine explicite (séparation des tâches), puis le déploiement réel et contrôlé. »

Approuver (capacité deploy:approve — ADMIN et OWNER uniquement) :

1. Lisez l'aide du bloc Approbation humaine (HIL) : « L'approbateur doit être différent du demandeur du run (séparation des tâches). Enregistré et audité. »
2. Renseignez l'Approbateur — « L'identifiant de l'approbateur — ne doit pas être le demandeur. »
3. Renseignez le Motif — « Pourquoi ce déploiement est approuvé ».
4. Cliquez sur Approuver ou Rejeter. Résultats : Déploiement approuvé. / Déploiement rejeté.
5. Le plan est automatiquement recalculé pour rafraîchir l'état d'approbation.
6. La liste d'audit sous le bloc conserve chaque décision, son environnement, son auteur et son motif.

Déployer (capacité deploy:execute — ADMIN et OWNER uniquement) :

1. Lisez le verdict : Gates et approbation satisfaits — le déploiement est autorisé. ou Le déploiement est bloqué tant que tous les gates ne sont pas franchis et (si requis) qu'une approbation n'est pas enregistrée.
2. Cliquez sur Déployer. Le bouton n'est actif que si le plan est Prêt à déployer. En environnement de Production, il prend l'apparence d'un bouton de danger.
3. Résultat : Déploiement : <statut>.

Les trois refus que vous rencontrerez le plus :

⚠️ Ce que voit un rôle VIEWER. Un VIEWER a deploy:read mais pas deploy:run : il ne voit que la bannière de sécurité. Toutes les sections sont masquées, et aucun run ne peut exister de son fait. C'est la vue la plus verrouillée du produit — à raison.

⚠️ Rafraîchissement. Les six pastilles d'étapes ne s'actualisent pas toutes seules : elles se mettent à jour après une action réussie. Relancez Prévisualiser (à blanc) pour obtenir l'état courant.

#5.10.6 Les quatre onglets techniques

⚠️ Statut : En cours. Ces onglets fonctionnent mais ne sont pas internationalisés et n'ont pas fait l'objet d'une relecture éditoriale. Ils sont destinés à un public d'exploitation.

#5.11 Vue Personnel IA

Statut : Livré — phase 1. · Capacité : workforce:read pour voir, workforce:manage pour agir.

⚠️ Incohérence de libellé assumée. La pastille du sélecteur affiche Personnel IA ; le titre de la vue affiche Effectifs IA. Ce sont deux libellés concurrents pour le même écran. À l'écrit, employez personnel virtuel. Correction prévue avant le lancement public.

#Ce qu'on y voit

Titre Effectifs IA, sous-titre : « Gérez votre effectif d'agents IA : recrutement, files de travail, autonomie et supervision humaine. »

Le personnel virtuel est rattaché au locataire, pas au projet. Vous consultez le même effectif depuis n'importe quel projet. C'est voulu : une équipe d'agents sert plusieurs produits.

#Recruter un membre — pas à pas (capacité workforce:manage)

1. Cliquez sur Recruter.
2. La boîte Recruter un membre annonce : « Ajoutez un nouveau membre virtuel à votre effectif IA. »
3. Renseignez :

4. Cliquez sur Recruter (bouton en Recrutement…), ou Annuler.

Le niveau d'autonomie que vous choisissez n'est pas le dernier mot. Il est plafonné par le forfait de l'organisation (§3.10). Choisir N3 sur un forfait gratuit donne une autonomie effective N1.

#Assigner une tâche — pas à pas (capacité workforce:manage)

1. Sélectionnez d'abord un membre dans le bloc Effectif. Sans sélection : Sélectionnez un membre de l'effectif pour afficher sa file de travail. L'action n'apparaît pas.
2. Cliquez sur Assigner une tâche.
3. La boîte annonce : « Ajoutez une tâche à la file de travail de ce membre. »
4. Renseignez :

5. Cliquez sur Assigner (bouton en Attribution…).

#Déplacer une tâche — pas à pas

1. Faites glisser une carte d'une colonne à l'autre de la File de travail.
2. Le changement est appliqué immédiatement.

⚠️ Deux différences avec le tableau de la vue Tableaux (§5.3) : aucune confirmation n'est demandée, et aucun motif n'est enregistré. De plus, l'action n'est pas masquée pour les rôles en lecture seule : un VIEWER peut tenter le déplacement, et le serveur refuse. Statut de l'alignement : Planifié.

#Lire la file de travail

⚠️ Une tâche dont le statut sort des quatre colonnes — une tâche Annulé, par exemple — n'apparaît dans aucune colonne du tableau. Elle reste visible dans le Fil d'activité.

#Lire l'organigramme

1. Naviguez avec les flèches du clavier. L'aide affichée : « Utilisez les flèches pour naviguer, plus ou moins pour zoomer. »
2. Zoomez avec Zoom avant / Zoom arrière, recadrez avec Ajuster à l'écran.
3. La couleur d'un nœud de personnel suit son statut.

#Messages et états

⚠️ Limite connue de la phase 1. Vous pouvez affecter un membre à une équipe existante, mais vous ne pouvez pas créer une équipe depuis le portail : aucune commande ne l'expose. Statut de la création d'équipe : Planifié.

---

#6 · Parcours de bout en bout

Dix parcours composés à partir des écrans documentés ci-dessus. Chacun indique le point de départ, la suite d'écrans et le résultat vérifiable.

#6.1 Créer un projet

Résultat vérifiable : un projet existe, avec un préfixe immuable et un type figé.

#6.2 Importer un dépôt et le rétro-concevoir

Résultat vérifiable : des artefacts d'architecture rendus, et des éléments de spécification portant la provenance Rétro-ingénierie.

⚠️ Prérequis d'infrastructure. La sortie réseau vers l'hébergeur du dépôt doit être autorisée sur l'environnement. Sans elle, le scan reste en attente sans message explicite. C'est une action d'exploitation, pas de configuration produit.

#6.3 Rédiger une spécification assistée par IA

Résultat vérifiable : des éléments réels, tracés comme provenant d'un agent, et une file de revue vidée par décision humaine.

Variante manuelle : utilisez le composeur de lot de la même page (§4.6) — références i1, i2, relations entre références, Enregistrer le lot.

#6.4 Analyser et tracer

Résultat vérifiable : un nombre d'écarts qui diminue entre deux analyses, sur les mêmes règles.

#6.5 Générer des artefacts

Résultat vérifiable : des artefacts consultables et un livrable téléchargé, tous deux dérivés de la spécification réelle.

#6.6 Lancer et suivre des agents

Résultat vérifiable : une exécution tracée de bout en bout, du prompt à l'écriture, avec son coût imputé.

#6.7 Qualité et tests

Prérequis : un projet créé avec le Type de projet : Tests.

Résultat vérifiable : une matrice de traçabilité où les exigences passent de Lacune à Couverte, adossée à des verdicts réellement exécutés.

#6.8 Préparer et suivre un déploiement

Résultat vérifiable : un plan à blanc lisible, une décision d'approbation horodatée et auditée, et — si le chemin réel est activé sur l'environnement — un déploiement effectif.

⚠️ Sur la plupart des environnements, l'étape 9 renvoie un refus honnête (501) : le chemin réel est fermé par défaut. Les étapes 1 à 8 restent pleinement utiles : elles produisent la trace de décision qu'un audit demande.

#6.9 Recruter et affecter du personnel virtuel

Résultat vérifiable : un membre présent dans l'organigramme, avec au moins une tâche dans sa file et une entrée dans le fil d'activité.

#6.10 Collecter et traiter des retours

Résultat vérifiable : une demande d'utilisateur convertie en élément de spécification, puis annoncée dans un changelog publié.

---

#7 · Collaboration

#7.1 Les surfaces de collaboration

#7.2 Les cinq rôles et ce qu'ils permettent

Le portail calcule ce qu'il vous montre à partir de vingt et une capacités. Voici la matrice complète.

Trois lectures utiles :

1. VIEWER voit tout, n'écrit rien. Les onze vues de l'espace de travail lui sont ouvertes. C'est le rôle à donner à un auditeur, à un dirigeant, à un client.
2. PUBLISHER est identique à EDITOR dans le portail client. Le rôle existe pour la cohérence du modèle et prend son sens côté serveur sur d'autres services.
3. La ligne de partage la plus importante passe entre PUBLISHER et ADMIN : les quatre capacités qui coûtent de l'argent ou qui touchent la production sont réservées à ADMIN et OWNER.

#7.3 Inviter et gérer les membres

Voir §4.20 pour le pas à pas complet. En résumé :

#7.4 Commentaires, revues et approbations

La règle commune : dans KySpectra, personne n'approuve ce qu'il a soumis. Ce n'est ni un réglage ni une convention d'équipe : c'est appliqué par le serveur, et l'interface bloque le geste avant même l'appel quand elle le peut.

#7.5 Partager un écran

Le moyen le plus fiable de montrer quelque chose à un collègue est de copier l'URL. Trois cas :

Si votre collègue appartient à un autre locataire, il obtiendra Élément introuvable ou une page vide — jamais « accès refusé ». C'est le masquage d'existence (§2.3).

---

#8 · Compte et facturation

#8.1 Les quatre écrans du compte

#8.2 Comprendre la consommation

Ce qui consomme des crédits : toute opération faisant appel à un modèle de langage — génération dans Spécifier, mode Agent du copilote, étapes du Cycle SDD, enrichissement de métamodèle, génération de cas de test, pipeline de livraison.

Ce qui n'en consomme pas : la lecture, les filtres, l'analyse des écarts (en lecture seule), la traçabilité, les exports assemblés localement.

#8.3 Les plans et leurs limites

Statut : trois plans existent réellement dans le catalogue.

Les limites ouvertes par chaque plan :

Devise unique : le dollar canadien (CAD). Toute mention d'euro ou de dollar américain serait aujourd'hui une invention.

Essai : les profils d'inscription configurés prévoient 14 jours sans carte, avec des rappels à J-7, J-3 et J-1, et une rétrogradation vers le palier gratuit à l'expiration.

Quand vous atteignez une limite, l'interface affiche Forfait supérieur requis ou Module payant requis, avec Voir les forfaits et Forfait suggéré : <forfait>. Le refus est préventif : l'opération est bloquée avant d'engager une dépense.

#8.4 Identifiants et secrets — les règles à connaître

---

#9 · Notifications, imports et approbations

#9.1 Notifications

Voir §4.22. Points d'usage :

1. La cloche de la barre supérieure porte le compte de non-lues, annoncé aux lecteurs d'écran sous la forme « Notifications, N non lues ».
2. Chaque notification porte un lien profond : Ouvrir vous conduit exactement à l'écran concerné.
3. Une notification dont le fait n'a plus cours est marquée obsolète — elle reste visible pour l'historique.
4. Tout marquer comme lu peut prendre quelques secondes sur une boîte très remplie.

#9.2 Imports

Voir §4.13. Points d'usage :

1. Le Projet cible conditionne l'affichage du reste de la page.
2. L'extraction se fait côté serveur ; le portail n'analyse pas votre fichier.
3. Rien n'est écrit tant que vous n'avez pas cliqué sur Importer pour chaque candidat. Le pipeline propose, vous décidez.
4. Un candidat rejeté n'est pas perdu : il disparaît de la liste, mais le document reste consultable dans Documents.

#9.3 Approbations

Voir §4.12. Points d'usage :

1. La page /approvals traite les propositions de changement venues des systèmes intégrés — ce n'est pas la même file que les revues d'agents (§5.7) ni que les portes HIL de test et de déploiement.
2. Chaque carte affiche le différentiel des champs proposés : vous voyez ce qui changerait avant de décider.
3. Le Motif est facultatif mais conservé. Renseignez-le : c'est ce qui rendra la décision compréhensible dans six mois.

#9.4 Où se trouve chaque file d'approbation

---

#10 · Accessibilité et raccourcis clavier

#10.1 Raccourcis clavier

⚠️ Il n'existe pas de raccourci d'aide (?) affichant la liste des raccourcis. Statut : Planifié.

#10.2 Ce qui est prévu pour l'accessibilité

Statut : Livré, avec des limites connues.

#10.3 Limites d'accessibilité connues

---

#11 · Dépannage

#11.1 Tableau de diagnostic

#11.2 Comment signaler un problème utilement

Ces sept informations suffisent à retrouver la trace exacte côté serveur.

---

#12 · Ce qui n'est pas encore disponible

Cette section existe parce que le produit refuse de laisser croire qu'une chose fonctionne alors qu'elle ne fonctionne pas. Elle est aussi importante que le reste du guide.

#12.1 Ce qui n'existe pas du tout

#12.2 Ce qui est là mais fermé par défaut

Ces fonctionnalités sont livrées, mais un drapeau serveur les tient fermées. Sur un environnement où le drapeau n'est pas levé, elles répondent honnêtement plutôt que de simuler.

Comment savoir ce qui est ouvert chez vous ? Le produit vous le dit à l'écran, au moment où vous en avez besoin. Il n'existe pas de page listant l'état des drapeaux dans le portail client : c'est une information d'exploitation.

#12.3 Ce qui fonctionne partiellement

#12.4 Les limites d'interface assumées

Ces points ne sont pas des pannes : ce sont des écarts entre ce que le portail masque et ce que le serveur refuse. Le refus est toujours appliqué côté serveur ; c'est l'ergonomie qui est perfectible.

#12.5 Deux écarts de marque à corriger avant le lancement public

---

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.