Aller au contenu principal

Glossaire KySpectra — français / anglais

  • DocumentStrategielancement/09-guides/03-glossaire.md
  • Version1.0
  • Date2026-08-17
  • StatutLivré
  • Publicexterne
  • MarqueKySpectra (par Kyrieva)

Strategielancement/09-guides/03-glossaire.mdFichier source

#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 :

  1. 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.
  2. Les statuts de disponibilité suivent la même échelle que le reste du dossier : Livré, En cours, Planifié, Bloqué.
  3. 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 ciblesGénérer les casPrioriserSoumettreApprouver.
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 RapportsCas 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_LIVEFalse 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.