#Comment lire ce glossaire
Ce glossaire couvre le vocabulaire du portail client KySpectra et de sa documentation. Chaque entrée donne :
| Colonne | Contenu |
|---|---|
| Terme (FR) | La forme française, seule autorisée dans les documents publics francophones. |
| EN | L'équivalent anglais utilisé dans l'interface anglaise du produit et dans le code. |
| Définition | Ce que le mot désigne, en général. |
| Dans KySpectra | Où vous rencontrez concrètement la notion dans le produit, et ce qu'elle y change. |
Trois conventions :
- Quand l'interface affiche un libellé différent du terme de ce glossaire, le libellé de l'interface fait foi pour ce que vous voyez à l'écran, et le glossaire fait foi pour ce que vous écrivez.
- Les statuts de disponibilité suivent la même échelle que le reste du dossier : Livré, En cours, Planifié, Bloqué.
- Les termes marqués d'un ⚠️ désignent une notion dont l'implémentation est partielle ou conditionnée à un drapeau de configuration ; la mention précise l'état.
#1. Les quinze notions structurantes
Ces quinze notions suffisent à comprendre le produit. Les sections suivantes complètent le vocabulaire par domaine.
#1.1 SDD — Spécification comme source de vérité
Terme anglais : SDD — Spec-Driven Development
Définition. Méthode de développement dans laquelle la spécification n'est pas un document préalable jeté après lecture, mais la structure de données centrale du projet : chaque exigence est un objet versionné, typé, relié aux autres, et interrogeable par une machine autant que par une personne.
Dans KySpectra. C'est le principe fondateur du produit. L'espace de travail projet s'appelle littéralement Espace SDD (workspace.title) et son sous-titre affiche « Poste de travail piloté par la spec — source de vérité de bout en bout ». La vue Spéc liste ces objets ; la vue Graphe montre leurs liens ; la vue Revue mesure ce qui n'est pas couvert.
#1.2 SDLC — Cycle de vie du logiciel
Terme anglais : SDLC — Software Development Life Cycle Définition. L'enchaînement complet des étapes qui mènent d'un besoin exprimé à un logiciel en service, puis à sa maintenance : cadrage, spécification, conception, réalisation, vérification, livraison, exploitation. Dans KySpectra. Le produit couvre la chaîne complète dans une seule application : de l'import d'un dépôt existant jusqu'au déploiement gouverné. Le sous-titre de la page Retours & feuille de route parle explicitement du « cycle SDLC (admission → spec → livraison) ».
#1.3 EARS — Syntaxe contrainte d'exigence
Terme anglais : EARS — Easy Approach to Requirements Syntax
Définition. Un ensemble de gabarits de phrase qui rendent une exigence non ambiguë et testable, en imposant une structure du type « Quand <déclencheur>, le système doit <réponse> ».
Dans KySpectra. La génération assistée par EARS est pilotée côté serveur par le drapeau EARS_GENERATION_ENABLED, à True par défaut. Dans le portail client, la forme la plus proche que vous manipulez directement est le format Gherkin (Étant donné / Quand / Alors) proposé à la saisie d'un critère d'acceptation dans la page Spécifier.
#1.4 Métamodèle
Terme anglais : Metamodel
Définition. Le modèle qui décrit ce qu'un modèle a le droit de contenir : quels types d'objets existent, quels attributs chaque type porte, quelles relations sont permises entre types, et quelles règles doivent être respectées.
Dans KySpectra. Chaque projet résout un métamodèle. Vous le consultez dans la vue Config, onglet Métamodèles : sa source (Défaut, Projet, Repli hors-ligne), ses Types, Attributs, Relations et Règles. L'action Valider la conformité mesure l'écart entre votre spécification réelle et ce que le métamodèle exige. L'action Utiliser un métamodèle par défaut active un métamodèle du catalogue intégré.
#1.5 Traçabilité
Terme anglais : Traceability Définition. La capacité à suivre un fil continu entre un besoin, sa spécification, sa réalisation, son test et sa vérification — dans les deux sens. Dans KySpectra. Deux surfaces distinctes : la page Traçabilité d'un projet explore la fermeture des relations d'un élément, Amont (parents) ou Aval (enfants) ; la vue Revue de l'espace de travail affiche la Matrice de traçabilité « Exigence × (conception · tâches · code · tests · vérification) » avec les colonnes Trous.
#1.6 Provenance
Terme anglais : Provenance
Définition. L'origine attestée d'une donnée : qui — ou quoi — l'a produite.
Dans KySpectra. Chaque élément de spécification porte l'une de quatre provenances : Humain, Agent, Rétro-ingénierie, Importé. Elle apparaît en colonne Provenance dans l'explorateur et dans la vue Spéc. La couleur violette #7c5cfc de la charte est réservée exclusivement à ce qui provient d'un agent : quand vous voyez une pastille violette, un modèle a écrit cette ligne, pas une personne. C'est une garantie de lisibilité, pas une décoration.
#1.7 HITL / HIL — Humain dans la boucle
Terme anglais : HITL — Human In The Loop (abrégé HIL dans le produit) Définition. Un point d'arrêt obligatoire où une personne décide avant qu'une action automatisée ne soit appliquée. Dans KySpectra. La page Approbations porte l'exergue « Humain dans la boucle ». On retrouve des files HIL dans la vue Tests (onglet Corrections, « Approbation des corrections (HIL) »), dans la vue Livraison (« Acceptation requise (HIL) », « Approbation humaine (HIL) ») et dans la vue Revue (« Revues en attente (validation humaine) »).
#1.8 SoD — Séparation des devoirs
Terme anglais : SoD — Separation of Duties Définition. Règle de contrôle interne interdisant qu'une même personne soumette et approuve la même décision. Dans KySpectra. La règle est appliquée côté serveur, pas seulement suggérée à l'écran. L'aide de l'approbation d'un plan de test le dit mot pour mot : « l'approbateur doit différer du soumetteur — une auto-approbation renvoie 403 SoD ». Le même contrôle protège l'acceptation d'un flux de livraison et l'approbation d'un déploiement.
#1.9 Locataire (tenant)
Terme anglais : Tenant Définition. L'unité d'isolation des données dans une application multi-client : tout ce qui appartient à un locataire est invisible aux autres. Dans KySpectra. Le locataire est identifié par un UUID. L'interface parle de Locataire (tenant), Locataire actif, Changer de locataire. Point important : si vous demandez une ressource d'un autre locataire, le serveur répond 404, pas 403 — on ne révèle pas l'existence de la donnée d'autrui.
#1.10 Entitlement — droit ouvert par le forfait
Terme anglais : Entitlement
Définition. Un droit d'usage attaché à un abonnement : une fonctionnalité ouverte ou fermée, ou un quota chiffré.
Dans KySpectra. Dix drapeaux et six quotas régissent le registre de capacités et les rôles virtuels : par exemple registry.max_skills vaut 0 sur le palier gratuit, 25 sur Équipe, 1 000 sur Entreprise. Quand une action dépasse votre forfait, l'interface affiche Forfait supérieur requis ou Module payant requis avec le bouton Voir les forfaits.
#1.11 Plafond d'autonomie
Terme anglais : Autonomy ceiling Définition. Le degré maximal d'initiative qu'un agent a le droit de prendre sans validation humaine. Dans KySpectra. Quatre niveaux, visibles au recrutement d'un membre du personnel virtuel :
| Niveau | Libellé affiché | Ce que cela signifie |
|---|---|---|
| N0 | N0 — Supervision totale | Chaque action est proposée, jamais appliquée seule. |
| N1 | N1 — Assistée | L'agent prépare, une personne valide. |
| N2 | N2 — Semi-autonome | L'agent agit dans un périmètre borné, escalade hors périmètre. |
| N3 | N3 — Autonome | L'agent agit et rend compte. |
Le plafond est doublement borné : par le rôle virtuel (« Plafond {niveau} ») et 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} ».
#1.12 MCP — Protocole de contexte de modèle
Terme anglais : MCP — Model Context Protocol Définition. Un protocole standard par lequel un modèle de langage accède à des outils et à des sources de contexte externes de façon déclarée et contrôlable. Dans KySpectra. Les Outils (MCP) sont l'une des trois familles de capacités du registre, aux côtés des Skills et des Prompts. Vous en déclarez dans Capacités du cabinet : nom du serveur, URL/endpoint, transport, type d'authentification, délai d'expiration, chemin de santé. Règle absolue affichée à l'écran : « les secrets vivent dans Vault — saisissez UNIQUEMENT le chemin Vault, jamais la valeur du secret ».
#1.13 RAG — Génération augmentée par la recherche
Terme anglais : RAG — Retrieval-Augmented Generation
Définition. Technique consistant à retrouver des extraits de documents pertinents avant d'interroger un modèle de langage, afin que sa réponse s'appuie sur des sources réelles plutôt que sur sa seule mémoire.
Dans KySpectra. Un service dédié (memory-rag-service) porte la mémoire et la recherche vectorielle de la plateforme. ⚠️ Le portail client ne propose aucune page de gestion du RAG : c'est une capacité d'infrastructure au service des agents, pas une surface utilisateur. Ne la présentez pas comme un écran.
#1.14 kaniko — Construction d'image sans démon
Terme anglais : kaniko
Définition. Outil qui construit une image de conteneur à l'intérieur d'un cluster Kubernetes, sans nécessiter d'accès au démon Docker de la machine hôte — donc sans privilège élevé.
Dans KySpectra. C'est la stratégie de construction retenue pour la chaîne de livraison (BUILD_STRATEGY accepte docker ou kaniko). Vous ne voyez jamais kaniko dans le portail client ; vous en voyez le résultat, une Image nommée dans le plan à blanc de l'onglet Déploiement.
#1.15 Rétro-ingénierie
Terme anglais : Reverse engineering Définition. Reconstituer la conception d'un système à partir de son implémentation. Dans KySpectra. C'est le point d'entrée recommandé quand vous partez d'un système existant. Page Sources du projet : vous enregistrez un dépôt, vous lancez Scanner / Rétro-concevoir, et le travail progresse par étapes visibles — En file, Ingestion…, Analyse…, Inférence…, Prêt. Le résultat alimente la vue Artefacts (DDD, C4/TOGAF, UML, BPMN, ERD, sécurité, dépendances) et promeut des éléments de spécification portant la provenance Rétro-ingénierie.
#2. Objets du modèle de spécification
| Terme (FR) | EN | Définition | Dans KySpectra |
|---|---|---|---|
| Projet | Project | Conteneur de tout le travail d'un produit ou d'un périmètre. | Créé depuis Projets avec un Préfixe de code (2 à 12 caractères majuscules) et un Nom du projet. Deux types : Standard (SDD/SDLC) et Tests. |
| Préfixe de code | Code prefix | Identifiant court en majuscules servant à préfixer les identifiants canoniques. | Saisi à la création ; il ne change plus ensuite, même si vous renommez le projet. Exemple d'identifiant produit : APP-FR-0001. |
| Élément de spécification | Spec item | L'unité atomique de la spécification : un objet typé, versionné, identifié. | Le mot le plus fréquent du produit. Colonnes affichées : Identifiant, Type, Statut, Titre, Provenance. |
| Exigence | Requirement | Un élément de spécification qui énonce ce que le système doit faire ou garantir. | Racine de la matrice de traçabilité et cible du contrôle « Exigence sans test ». |
| Critère d'acceptation | Acceptance criterion (AC) | La condition observable qui prouve qu'une exigence est satisfaite. | Saisissable en Gherkin, en Liste de contrôle ou en Règle. La vue Tests mesure la Couverture des critères d'acceptation. |
| Type | Type | La classe d'un élément, définie par le métamodèle actif. | Filtre Tous les types dans l'explorateur ; champ Type obligatoire à la création. |
| Statut | Status | L'état de l'élément dans son cycle de vie. | Sept valeurs : Brouillon, Clarifié, Planifié, En développement, Implémenté, Vérifié, Déprécié. |
| Chemin | Path | Le chemin logique de l'élément dans l'arborescence de spécification. | Champ obligatoire, exemple d'aide affiché : /exigences/authentification. |
| Attribut | Attribute | Une propriété typée portée par un élément, définie par son type. | Onglet Attributs du détail d'élément. Les types « libres » acceptent des paires clé/valeur arbitraires. |
| Relation | Relationship | Un lien orienté et typé entre deux éléments. | Treize types : contient, affine, dérive de, satisfait, vérifie, valide, implémente, dépend de, en conflit avec, tracé vers, gouverne, justifie, résout. |
| Empreinte du contenu | Content hash | Résumé cryptographique du contenu, servant à détecter toute altération. | Affichée dans le bloc Métadonnées du détail d'un élément. |
| Version | Version | Le numéro de révision de l'élément, incrémenté à chaque modification. | Toute modification exige une Raison du changement et incrémente la version. |
| Motif du changement | Change reason | Justification obligatoire consignée sur la révision. | Exigée à la modification, à la suppression d'un élément, à la suppression d'une relation et à toute transition de statut sur le tableau. |
| Constitution | Constitution | Le corpus d'articles de gouvernance qui prévalent sur les décisions locales. | Portée org, project:ID ou feature:ID. Un article peut être Non négociable et en Remplacer d'autres. Une infraction remonte comme écart « Violation de la constitution ». |
| Écart | Gap | Une incohérence détectée entre ce que la spécification devrait contenir et ce qu'elle contient. | Neuf familles, dont Exigence sans test, Critère sans scénario, Dépendance circulaire, Violation de la constitution, Attribut requis manquant. |
| Lot | Batch | Un ensemble d'éléments et de relations enregistrés en une seule opération atomique. | La page Spécifier enregistre un lot : tout passe, ou rien. |
| Référence de lot | Batch ref | Un identifiant court et temporaire (i1, i2…) qui sert à relier les éléments d'un même lot avant qu'ils n'aient d'identifiant canonique. |
Champ Référence dans le formulaire Spécifier. |
| Identifiant canonique | Canonical ID | L'identifiant définitif attribué par le serveur à l'enregistrement. | Colonne Identifiant canonique dans le récapitulatif d'un lot enregistré. |
| Champ personnalisé | Custom field | Un attribut typé défini par un registre de schémas externe. | ⚠️ Nécessite la variable NEXT_PUBLIC_CUSTOM_FIELDS_API_BASE ; sans elle, le portail affiche « Champs personnalisés non raccordés » plutôt qu'un formulaire vide. |
| Valeur orpheline | Orphaned value | Une valeur existant sur l'objet mais retirée du schéma courant. | Affichée à part avec la mention « elles ne sont jamais perdues ». |
#3. Agents, exécutions et gouvernance
| Terme (FR) | EN | Définition | Dans KySpectra |
|---|---|---|---|
| Agent | Agent | Un programme fondé sur un modèle de langage, doté d'un périmètre, d'outils et d'un journal. | Six profils nommés dans le composeur de flux : Analyste, Extracteur, Rédacteur, Relecteur, Calcul, Conseiller. |
| Copilote IA | AI companion | L'assistant conversationnel accessible depuis toutes les pages. | Deux modes : Assistant (question / action rapide) et Agent (« il enregistrera de VRAIS objets de spécification »). |
| Exécution / run | Run | Une invocation d'agent, avec son début, ses étapes, son coût et sa fin. | Statuts affichés : En file, En cours, Suspendu, Terminé, Échoué. |
| Étape d'exécution | Run event | Un jalon journalisé de l'exécution. | Neuf libellés : Mise en file d'attente, Démarrage de l'exécution, Appel au modèle, Réponse du modèle, Enregistrement des spécifications, Spécifications enregistrées, Exécution terminée, Exécution échouée, Message. |
| SSE | Server-Sent Events | Technique par laquelle le serveur pousse des événements vers le navigateur sur une connexion ouverte. | C'est ce qui fait vivre les badges En direct de la vue AgentOps et des runs de test. |
| Budget d'étapes | Step budget | Le nombre maximal d'étapes qu'une exécution a le droit de consommer. | Affiché dans le panneau de détail d'une exécution, page Opérations agents. |
| Interrompre | Interrupt | Demander l'arrêt d'une exécution en cours. | Bouton Interrompre / Arrêter l'exécution. Le travail déjà fait est conservé. ⚠️ Certains déploiements répondent « L'arrêt des exécutions n'est pas encore disponible sur ce déploiement. » |
| Exécuteur | Executor | Le moteur qui exécute concrètement les étapes de l'agent. | Colonne Exécuteur de la table des exécutions. |
| Rôle virtuel | Virtual role | Un profil métier auquel on rattache des capacités et un plafond d'autonomie. | Page Rôles. ⚠️ Gouvernée par REGISTRY_VIRTUAL_ROLES_ENABLED, False par défaut : sur un environnement où le drapeau n'est pas levé, la page affiche « Les rôles virtuels IA ne sont pas activés sur cet environnement. » |
| Personnel virtuel | AI staff / workforce | Des agents traités comme des membres d'équipe : recrutés, affectés, dotés d'une file de travail. | Vue Personnel IA de l'espace de travail (titre interne : « Effectifs IA »). Phase 1 livrée et prouvée en développement et en production. |
| File de travail | Work queue | La liste des tâches d'un membre du personnel virtuel. | Quatre colonnes de statut : En file, En cours, Bloqué, Terminé. |
| Organigramme | Org chart | La représentation hiérarchique des équipes de personnel virtuel. | Panneau Organigramme des équipes, navigable au clavier (flèches pour se déplacer, plus/moins pour zoomer). |
| Capacité | Capability | Une unité de pouvoir accordée : un skill, un prompt ou un outil MCP. | Trois portées : globale (plateforme), cabinet (locataire), personnelle (utilisateur). |
| Skill / compétence | Skill | Un bloc d'instructions réutilisable qui s'active sur un déclencheur décrit. | Créé dans Capacités du cabinet. Description du déclencheur ≥ 20 caractères. Atterrit en brouillon jusqu'à approbation (SoD). |
| Prompt | Prompt | Un modèle d'invite versionné, associé à une phase SDD et à une classe de risque. | Deux surfaces : Mes prompts (personnels, privés) et Capacités du cabinet (organisation). |
| Adoption | Adoption | Le fait de rendre une capacité du registre global disponible pour un cabinet ou pour un agent. | Onglet Adopter (registre global) puis onglet Adoptions pour la révision. Réversible : Retirer l'adoption. |
| Portée | Scope | Le périmètre sur lequel une capacité ou une liaison s'applique. | Tout le cabinet ou Un agent précis (agent:<id>). |
| Liaison | Binding | Le rattachement d'un outil à un rôle, pour une session ou de façon durable. | Cette session (gratuit) ou Persistant (module). ⚠️ Le mode session exige Redis ; sans lui l'interface le dit explicitement. |
| Classe de risque | Risk class | Le niveau de danger attribué à une capacité. | Faible, Moyen, Élevé, Non classé. |
| Refus par défaut | Deny by default | Politique où toute action non explicitement autorisée est refusée et journalisée. | Appliqué par le moteur de politique du runtime d'agents, sous l'identifiant de politique deny-by-default. |
| Registre central d'agents | Central agent registry | La source de vérité de tous les agents de la plateforme. | Administré depuis le portail d'administration, pas depuis le portail client. |
| Journal d'audit | Audit log | Le registre inaltérable des actions, chaîné par hachage. | Il sous-tend les mentions « consignée dans la piste d'audit » du produit et les rapports de conformité. |
| RPA | Robotic Process Automation | Automatisation d'interactions avec des interfaces qui n'exposent pas d'API. | Indicateurs RPA activé / RPA désactivé sur un rôle virtuel. ⚠️ RPA_BROWSER_ENABLED est à False par défaut. |
| Niveau de modèle | Model tier | La catégorie de modèle allouée à un rôle (rapide, standard, expert). | Badge Modèle {niveau} sur la fiche d'un rôle virtuel. |
#4. Qualité, tests et défauts
| Terme (FR) | EN | Définition | Dans KySpectra |
|---|---|---|---|
| Projet de type Tests | Test-only project | Un projet dont l'objet est de tester en profondeur une application déjà déployée. | Choisi à la création. C'est la seule condition d'apparition de la vue Tests ; ailleurs, le portail affiche « Non applicable à ce type de projet ». |
| Environnement cible | Target environment | Une instance de l'application à tester, avec son URL et sa politique. | Étiquettes dev, QA, staging, prod, personnalisé. La production est toujours forcée en lecture seule. |
| Plan de test | Test plan | L'ensemble ordonné des cas à exécuter, soumis à approbation. | Chaîne d'actions : Dériver les cibles → Générer les cas → Prioriser → Soumettre → Approuver. |
| Cas de test | Test case | La description reproductible d'une vérification. | Bibliothèque hiérarchique en dossiers, versionnée : « chaque modification ajoute un instantané à l'historique ». |
| Étape partagée | Shared step | Une étape de test réutilisable, référencée depuis plusieurs cas. | « Référencer une étape partagée copie son action/assertion et garde le lien. » |
| Scénario | Scenario | La formulation exécutable d'un critère d'acceptation. | Éditeur Gherkin ; refuse d'enregistrer si Étant donné / Quand / Alors n'est pas complet. |
| Gherkin | Gherkin | Langage semi-formel structuré en Étant donné / Quand / Alors. | Format proposé pour les critères d'acceptation et pour les scénarios de test. |
| Liaison ligne → étape | Line-to-step binding | La correspondance déterministe entre une ligne Gherkin et une étape de cas. | Explicitement « jamais inventée » : ce qui n'est pas liable reste marqué non liée. |
| Flux utilisateur | User flow | Un parcours pas à pas décrit une fois et compilé en test automatisé. | Canvas visuel et éditeur DSL enregistrant le même document. Compilation à sens unique vers Playwright ; le code produit est en lecture seule. |
| DSL | Domain-Specific Language | Un mini-langage dédié à un domaine précis. | Ici : une ligne par étape — goto /login, fill [sélecteur] "valeur", click sélecteur, expect_url /chemin. |
| Playwright | Playwright | Bibliothèque de pilotage de navigateur réel. | L'adaptateur Playwright (UI) exécute les tests d'interface. Les autres adaptateurs : API directe, Sécurité, Accessibilité, Performance. |
| Suite | Suite | Un regroupement nommé de cas. | Quatre objets : Smoke, Régression, E2E, Release. |
| Cycle / jalon / release | Cycle / milestone / release | Des regroupements temporels de plans et de runs. | Statuts Planifié, Actif, Clôturé. Le Rollup n'agrège que des totaux réellement persistés. |
| Verdict | Verdict | Le résultat d'un cas exécuté. | Vert, Échec, Ignoré, Instable, Non concluant. Un cas jamais exécuté reste sans verdict — il n'est pas compté comme réussi. |
| Instable (flaky) | Flaky | Un test qui alterne succès et échec sans changement du code. | Onglet Rapports → Cas instables : « Marqués flaky OU alternant pass/fail dans la fenêtre. » |
| Évidence | Evidence | La preuve attachée à un verdict : note et/ou capture d'écran. | Obligatoire en cas d'échec : « aucun verdict sans preuve ». Capture limitée à environ 512 Kio. |
| Session manuelle | Manual session | Une exécution pas à pas conduite par une personne, enregistrée étape par étape. | Le champ Résultat observé demande « ce qui s'est RÉELLEMENT passé — jamais le résultat attendu recopié ». |
| Session exploratoire | Exploratory session | Une exploration libre guidée par une charte de mission. | Champ Charte, exemple d'aide : « explorer la robustesse du panier ». |
| Triage | Triage | La qualification d'un échec avant d'ouvrir un défaut. | Cinq décisions : Défaut produit, Test obsolète, Instable (flaky), Problème d'environnement, Problème de données. |
| Défaut | Defect | Un dysfonctionnement confirmé du produit. | Registre dédié, avec proposition automatique, Confiance, décision humaine et défaut ouvert. |
| Boucle de correction | Fix loop | Le cycle borné correction → re-test jusqu'au vert ou à l'épuisement. | Dix états, dont Prêt à corriger, Correction en cours, Re-test en cours, Vert (re-test réussi), Épuisée. |
| Auto-réparation | Self-healing | La reprise automatique bornée d'un flux en échec. | Deux formes distinguées : Auto-réparation (nouvel essai) et Auto-réparation (replanification). |
| Politique de correction | Fix policy | La règle qui décide si un correctif peut s'appliquer sans validation humaine. | require_hil, auto_final, conditional. La production impose toujours require_hil. |
| Matrice de traçabilité | Traceability matrix | Le tableau croisant exigences, scénarios, cas et défauts. | Filtres Lacunes uniquement et Avec défauts uniquement, export CSV. |
#5. Artefacts, conception et documentation
| Terme (FR) | EN | Définition | Dans KySpectra |
|---|---|---|---|
| Artefact | Artifact | Un livrable de conception dérivé de la spécification. | Vue Artefacts : « Diagrammes produits par les services (Mermaid), rendus tels quels — jamais inventés. » |
| DDD | Domain-Driven Design | Approche de conception centrée sur le langage et les frontières du domaine métier. | Premier onglet de la vue Artefacts. |
| C4 | C4 model | Notation d'architecture à quatre niveaux d'abstraction (contexte, conteneurs, composants, code). | Onglet C4 / TOGAF / ArchiMate. |
| TOGAF | TOGAF | Cadre d'architecture d'entreprise. | Même onglet que C4. |
| ArchiMate | ArchiMate | Langage de modélisation d'architecture d'entreprise. | Même onglet que C4. |
| UML | UML | Notation de modélisation logicielle (classes, séquences, états). | Onglet dédié de la vue Artefacts. |
| BPMN | BPMN | Notation de modélisation de processus métier. | Onglet dédié de la vue Artefacts. |
| ERD | Entity-Relationship Diagram | Diagramme entités-associations d'une base de données. | Onglet dédié ; alimenté notamment par la rétro-ingénierie. |
| Graphe de mapping | Mapping graph | Représentation des correspondances entre couches. | Onglet dédié de la vue Artefacts. |
| DSM | Design Structure Matrix | Matrice carrée des dépendances d'un système. | Une des trois vues de l'onglet Dépendances, avec le graphe Mermaid et la Roue de dépendances. |
| Mermaid | Mermaid | Langage textuel de description de diagrammes, rendu par le navigateur. | Format d'export du diagramme de spécification (.mmd) et support de tous les diagrammes d'artefacts. |
| Documentation comme code | Docs-as-code | Documentation générée depuis les sources plutôt que rédigée à part. | Vue Docs : « Documentation et diagramme générés depuis la spec réelle », exportables en Markdown. |
| PRD | Product Requirements Document | Document de définition produit. | Vue Livraison, onglet Arbre PRD : hiérarchie PRD ▸ EPIC ▸ US (▸ FR/NFR ▸ AC), en lecture seule. |
| EPIC | Epic | Un regroupement de fonctionnalités de haut niveau. | Niveau intermédiaire de l'arbre PRD ; poussé tel quel vers le tracker. |
| US | User Story | L'expression d'un besoin du point de vue de l'utilisateur. | Feuille de l'arbre PRD poussée vers le tracker. |
| FR / NFR | Functional / Non-Functional Requirement | Exigence fonctionnelle / non fonctionnelle. | Niveaux terminaux de l'arbre PRD. |
| BMAD | BMAD | Méthode de cycle agentique intégrée à la plateforme (analyste, PM, architecte, dev, QA). | Une des méthodes du Catalogue des méthodes, avec ses propres cycles et phases. |
| Spec-Kit | Spec-Kit | Une autre méthode enregistrée du catalogue. | Citée dans l'aide du champ Méthode : « Chaque méthode enregistrée (BMAD, Spec-Kit, Kiro…) définit ses propres cycles. » |
| Pack de métamodèle | Metamodel pack | Un ensemble cohérent de types et relations activable sur un projet. | Multi-actif : plusieurs packs peuvent être actifs, et le métamodèle résolu est leur composition. |
| Cycle SDD | SDD cycle | La séquence d'étapes qui fait avancer un élément dans la méthode. | Cinq étapes : Clarifier, Planifier, Découper en tâches, Implémenter, Converger. |
| Convergence | Convergence | La réconciliation de la spécification avec une référence pour détecter la dérive. | Étape Converger : « Réconcilier la spec avec une référence (anti-dérive) », avec option Appliquer les transitions de dérive. |
#6. Livraison, déploiement et exploitation
| Terme (FR) | EN | Définition | Dans KySpectra |
|---|---|---|---|
| Pipeline de livraison | Delivery pipeline | La chaîne objectif → PRD → arbre de spécification → export tracker. | Quatre étapes visibles : Génération, Persistance, Acceptation, Export. |
| Tracker | Tracker | L'outil de suivi des travaux de l'organisation. | Deux systèmes pris en charge : Jira et Azure DevOps. |
| PAT | Personal Access Token | Jeton d'accès personnel à un service tiers. | Jamais saisi dans le portail : vous fournissez un chemin Vault, le PAT y est déposé au préalable. |
| Vault | Vault | Coffre de secrets centralisé. | Le portail n'affiche jamais qu'une Réf. Vault. Un chemin doit commencer par secret/. |
| Référence d'identifiant | Credential ref | Le chemin d'un secret dans le coffre, stocké à la place du secret. | Colonne Chemin Vault des connexions tracker, champ credential_ref des outils MCP. |
| Run de pipeline | Pipeline run | Une exécution de la chaîne de construction et de déploiement. | Six étapes ordonnées et non contournables : build → test → scan → gate → deploy → monitor. |
| Plan à blanc | Dry run | Un aperçu de ce qui serait fait, sans rien faire. | Bouton Prévisualiser (à blanc). « N'enregistre rien, ne touche aucune infrastructure. » |
| Gate / barrière | Gate | Un contrôle bloquant qui doit être franchi pour continuer. | Le plan à blanc affiche Prêt à déployer / Pas prêt et la liste des Blocages. |
| Chemin réel | Live path | L'exécution effective, par opposition au plan à blanc. | Affiché comme À blanc (chemin réel désactivé) ou Chemin réel activé, selon le drapeau serveur DEPLOY_LIVE — False par défaut. |
| Rollout | Rollout | Le déploiement progressif d'une nouvelle version. | Déclenché par le bouton Déployer, après approbation. |
| Retour arrière | Rollback | Le retour à la version précédente. | Capacité du service de déploiement, réservée aux rôles ADMIN et supérieurs. |
| Namespace | Namespace | Le cloisonnement logique d'un cluster Kubernetes. | Affiché dans la cible du plan à blanc, avec la Charge de travail et l'Image. |
| Mise en ligne | Go-live | La publication du produit construit sur un sous-domaine avec TLS. | ⚠️ Gouvernée par GOLIVE_ENABLED, False par défaut dans le code ; activée à l'exécution sur les environnements de développement et de production. |
| CI/CD | Continuous Integration / Continuous Delivery | Intégration et livraison continues. | Génération de pipeline pour quatre fournisseurs, avec commit réel dans le dépôt. |
| Cloudflare Pages | Cloudflare Pages | Plateforme d'hébergement de sites statiques. | L'un des supports de publication de front-end, et l'hébergement des portails eux-mêmes. |
| Export statique | Static export | Un site pré-généré, servi sans serveur applicatif. | Le portail client est exporté statiquement : toute la logique s'exécute dans votre navigateur. |
#7. Compte, accès et facturation
| Terme (FR) | EN | Définition | Dans KySpectra |
|---|---|---|---|
| Keycloak | Keycloak | Serveur d'identité open source. | Fournisseur d'identité de KySpectra : https://keycloak.i2tdigital.com. |
| OIDC | OpenID Connect | Protocole d'authentification bâti sur OAuth 2.0. | Protocole de connexion du portail. |
| PKCE | Proof Key for Code Exchange | Extension d'OAuth 2.0 qui sécurise l'échange de code pour un client public. | Méthode S256, flux implicite désactivé. C'est ce qui permet à un portail sans serveur de se connecter sans secret client. |
| JWT | JSON Web Token | Jeton signé porteur d'assertions vérifiables. | Porte notamment vos rôles et votre tenant_id. |
| Claim | Claim | Une assertion contenue dans un jeton. | Le claim tenant_id détermine votre locataire ; un désaccord avec l'en-tête produit un 404. |
| RBAC | Role-Based Access Control | Contrôle d'accès fondé sur les rôles. | Cinq rôles utilisateur : VIEWER, EDITOR, PUBLISHER, ADMIN, OWNER. |
| RLS | Row-Level Security | Filtrage des lignes d'une base par locataire, au niveau du moteur. | Mentionné dans le sous-titre du panneau Membres de la page Équipe. |
| Invitation | Invitation | La proposition faite à une personne de rejoindre un locataire avec un rôle. | Page Équipe : Inviter un membre, puis Renvoyer ou Révoquer tant qu'elle est en attente. |
| Forfait | Plan | Le niveau d'abonnement de l'organisation. | Trois entrées réelles au catalogue : gratuit (0 $ CAD), team (49,00 $ CAD/mois), enterprise (sur devis). Devise unique : CAD. |
| Crédit | Credit | L'unité de consommation prépayée de la plateforme. | Solde visible sur Consommation & budgets, mouvements détaillés dans le Grand livre. |
| Grand livre | Ledger | Le journal chronologique en ajout seul des mouvements de crédits. | « Journal chronologique en append-only » — aucune écriture n'est modifiée après coup. |
| Budget | Budget | Un plafond de dépense par périmètre, avec seuils d'escalade. | Cinq états : Sain, Seuil d'alerte, Seuil élevé, Seuil critique, Dépassé. |
| Taux de combustion | Burn rate | La dépense moyenne par jour. | KPI de la page Consommation, calculé sur une fenêtre affichée. |
| Autonomie estimée | Runway | Le nombre de jours que le solde permet encore de tenir au rythme actuel. | KPI Autonomie estimée, marqué estimation — à ne pas confondre avec le plafond d'autonomie d'un agent. |
| Quota | Quota | Une limite de volume sur une fenêtre de temps. | Exemple : registry.tool_calls_per_day — 200 en gratuit, 5 000 en Équipe, 1 000 000 en Entreprise. |
| Jeton (modèle) | Token | L'unité de découpage du texte facturée par les fournisseurs de modèles. | Colonne Jetons du grand livre. À ne pas confondre avec un jeton d'authentification. |
| BYOS | Bring Your Own Subscription | Le fait d'utiliser votre propre compte fournisseur plutôt que le pool de la plateforme. | Page Identifiants : type de compte Espace API ou Abonnement, et indicateur Éligible au pool. |
| LiteLLM | LiteLLM | Passerelle unifiant l'accès à plusieurs fournisseurs de modèles. | Sous-jacente à la passerelle LLM de la plateforme ; invisible dans le portail client. |
| Loi 25 | Quebec Law 25 | Loi québécoise sur la protection des renseignements personnels. | Motive le masquage d'existence par 404 et les rapports de conformité de la plateforme. |
| RGPD | GDPR | Règlement général européen sur la protection des données. | Même famille d'exigences que la Loi 25 pour les organisations européennes. |
#8. Interface, navigation et technique du portail
| Terme (FR) | EN | Définition | Dans KySpectra |
|---|---|---|---|
| Espace de travail | Workspace | La surface de travail unifiée d'un projet. | Espace SDD, à onze vues canoniques. Employez toujours « espace de travail », jamais l'anglicisme. |
| Vue canonique | Canonical view | L'une des onze vues déclarées de l'espace de travail. | Spéc, Graphe, Tableaux, Config, AgentOps, Tests, Revue, Docs, Artefacts, Livraison, Personnel IA. |
| Palette de commandes | Command palette | Le champ de recherche universel ouvert au clavier. | Ctrl/⌘ K. Deux groupes globalement (Naviguer, Actions) ; dans l'espace de travail, Vues et Éléments de spéc. |
| Lien profond | Deep link | Une URL qui restitue exactement un état d'écran. | Dans l'espace de travail, l'état vit dans l'URL : ?view=<vue>&item=<identifiant>. L'URL est la source de vérité, partageable telle quelle. |
| Fil d'Ariane | Breadcrumb | Le chemin de navigation affiché en haut de page. | Vingt libellés déclarés, de Projets à Sources. |
| Rail de navigation | Navigation rail | La colonne latérale de navigation. | Trois sections — Espace de travail, Opérer, Compte — plus un pied de rail. Repliable (Replier la navigation / Déplier la navigation). |
| Exergue | Eyebrow | Le petit intitulé de contexte placé au-dessus du titre d'une page. | Exemples : « Poste de commande », « Facturation », « Sécurité », « Humain dans la boucle », « Rétro-ingénierie ». |
| Zone de danger | Danger zone | La section regroupant les actions destructrices. | Présente sur le détail d'un élément de spécification ; la suppression y exige un motif et reste consignée. |
| Service non raccordé | Service not wired | Un service dont l'adresse n'est pas configurée pour ce portail. | Le portail l'affiche explicitement plutôt que d'afficher des zéros : « Aucune donnée n'est inventée. » |
| Widget de retours | Feedback widget | Le composant embarquable qui collecte les retours sur votre propre site. | Une clé publique par site (pk_…), avec restriction d'origines et révocation instantanée. |
| RICE | RICE scoring | Méthode de priorisation par portée, impact, confiance et effort. | Quatre quadrants affichés : Gain rapide, Gros pari, Bouche-trou, Gouffre. |
| NPS / CSAT / CES | Net Promoter Score / Customer Satisfaction / Customer Effort Score | Trois familles de sondages de satisfaction. | Onglet Sondages de la page Retours & feuille de route. |
| Changelog | Changelog | Le journal des nouveautés publiées. | Onglet dédié, avec états Brouillon et Publié, et Demandes liées. |
| Feuille de route | Roadmap | La vue publique de ce qui est prévu, en cours et livré. | Visible en interne et, via une clé publique, sur la page publique de retours. |
| If-Match / ETag | If-Match / ETag | Mécanisme d'écriture conditionnelle empêchant d'écraser une version plus récente. | Employé sur les flux utilisateur : « Enregistrement avec If-Match (409 si version périmée). » |
| Idempotence | Idempotency | Propriété d'une opération qu'on peut rejouer sans effet supplémentaire. | Protège les opérations sensibles contre les doubles soumissions et les reprises réseau. |
| Ajout seul | Append-only | Un registre où l'on ajoute sans jamais modifier ni supprimer. | Le grand livre de facturation et l'historique des versions de flux. |
| Export statique / sentinelle d'identifiant | Static export / route sentinel | Technique par laquelle un site pré-généré sert une coquille unique pour toutes les URL dynamiques, l'identifiant réel étant lu côté navigateur. | Explique pourquoi une page projet peut afficher brièvement un état de chargement avant de connaître l'identifiant. |
#9. Codes de réponse que vous pouvez rencontrer
| Code | Nom | Ce que cela signifie dans KySpectra |
|---|---|---|
| 401 | Unauthorized | Vous n'êtes pas authentifié, ou votre session a expiré. Reconnectez-vous. |
| 402 | Payment Required | Crédits épuisés ou budget dépassé. L'opération est refusée avant d'engager une dépense. |
| 403 | Forbidden | Votre rôle ne permet pas cette action — ou vous tentez d'approuver ce que vous avez soumis (SoD). |
| 404 | Not Found | La ressource n'existe pas ou n'appartient pas à votre locataire. Ce choix est délibéré : on ne révèle pas l'existence de la donnée d'autrui. |
| 409 | Conflict | Version périmée (quelqu'un a modifié entre-temps), ou étape déjà engagée, ou approbation requise et absente. |
| 412 / 422 | Precondition Failed / Unprocessable Entity | Condition d'écriture non satisfaite, ou charge utile invalide (par exemple : un flux sans aucune étape). |
| 428 | Precondition Required | Il manque une précondition obligatoire — typiquement un en-tête de version sur une écriture concurrente. |
| 429 | Too Many Requests | Quota atteint sur la fenêtre en cours. |
| 501 | Not Implemented | La fonctionnalité existe mais n'est pas activée sur cet environnement. C'est une réponse volontaire : le produit préfère refuser franchement plutôt que simuler un succès. |
| 503 | Service Unavailable | Le service visé est indisponible ou non configuré. |
#10. Termes à ne pas employer
| À éviter | Employer à la place | Pourquoi |
|---|---|---|
| Workspace | Espace de travail | Anglicisme évitable ; le vocabulaire imposé du dossier de marque. |
| Portail business | Portail client ou espace de travail | Il n'existe pas de troisième portail. « Business » est une persona à l'intérieur du portail client. |
SPECTRA seul |
KySpectra | SPECTRA est un nom de code interne. ⚠️ L'interface livrée l'affiche encore (common.appName) : c'est un écart identifié à corriger avant le lancement public. |
| Tenant seul | Locataire | Le produit affiche « Locataire (tenant) » ; à l'écrit, préférez la forme française. |
| Run seul | Exécution | « Run » subsiste dans certains libellés techniques de la vue Tests ; à l'écrit, préférez « exécution ». |
| Feature flag | Drapeau de fonctionnalité | Vocabulaire français d'abord. |
| Dry run | Plan à blanc | C'est le libellé réel de l'interface française. |
| Mobile app KySpectra | — | ⚠️ Aucune application mobile n'existe. Les portails sont utilisables sur mobile via navigateur ; toute autre affirmation serait fausse. |
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.