Vue d'ensemble du produit KySpectra

#Sommaire

---

#1. Ce qu'est KySpectra

#1.1 La définition de référence

KySpectra est la plateforme agentique qui transforme une intention en logiciel gouverné — de la spécification au déploiement en production — sans jamais rompre la traçabilité.

Cette phrase est la seule formulation de référence. Tout autre texte du dossier en est une reformulation fidèle, jamais une promesse plus large.

#1.2 Les trois natures superposées

KySpectra n'est pas un outil unique. C'est l'assemblage de trois couches distinctes, chacune utilisable seule, dont la valeur naît de leur continuité.

#1.3 Ce que KySpectra n'est pas

Poser les limites vaut mieux que de laisser le marché les inventer.

#1.4 Le pari fondateur

La spécification n'est pas de la paperasse d'avant-projet. C'est la structure de données centrale du cycle de vie. Une exigence est un objet versionné et relié, pas un paragraphe oublié. Un agent IA est un collaborateur avec un périmètre, un plafond d'autonomie et un journal, pas une boîte noire. Un déploiement est une décision approuvée, pas un effet de bord.

---

#2. Le problème traité

#2.1 Le déplacement du goulot d'étranglement

En deux ans, la génération assistée par IA a rendu l'écriture de code abondante et bon marché. La question posée aux équipes n'est plus « comment écrire ce composant ? » mais « qu'est-ce qui tourne réellement chez nous, et pourquoi ? ».

#2.2 La dette d'intelligibilité

Nous appelons dette d'intelligibilité l'écart entre le logiciel produit et le logiciel compris. Elle a quatre manifestations observables.

Cette dette ne figure à aucun budget. Elle se paie en incidents, en audits impossibles et en équipes qui n'osent plus toucher à leur propre système.

#2.3 La réponse de KySpectra

---

#3. La chaîne de valeur en six maillons

La chaîne de valeur est le cœur du produit. Chaque maillon est décrit ci-dessous par ses entrées, ses actions, ses sorties, la surface qui l'expose, et son statut vérifié.

Les deux flèches en pointillés sont la boucle de retour : un défaut détecté à la vérification et un incident constaté après livraison remontent vers l'exigence qui les a produits.

---

#3.1 Maillon 1 — Comprendre

Intention : partir de l'existant, pas d'une page blanche.

Les sept familles d'artefacts émis

Écart connu : la rétro-ingénierie depuis un dépôt GitHub public en production a nécessité une règle réseau dédiée sur le port 443, la politique de refus par défaut bloquant le clonage. Le correctif est appliqué et vérifié en ligne.

---

#3.2 Maillon 2 — Spécifier

Intention : faire de l'exigence un objet de données, pas un paragraphe.

Ce que la spécification exécutable apporte concrètement

Drapeaux de fonctionnalité pertinents : EARS_GENERATION_ENABLED (activé), SPEC_FIRST_ENABLED (activé), AUTO_PROMOTE_ENABLED (activé), SPEC_APPLY_ENABLED (désactivé par défaut).

---

#3.3 Maillon 3 — Concevoir

Intention : projeter la spécification en artefacts de conception, sans ressaisie.

Les familles de projection

---

#3.4 Maillon 4 — Fabriquer

Intention : faire travailler des agents IA sous contrainte explicite.

Le plan d'exécution du code

Le personnel virtuel IA — phase 1

---

#3.5 Maillon 5 — Vérifier

Intention : prouver que ce qui est fabriqué satisfait ce qui était demandé.

Les moyens de vérification

---

#3.6 Maillon 6 — Livrer

Intention : fermer la boucle jusqu'à un produit servi en ligne, sous décision approuvée.

Détail des cibles de livraison

L'interrupteur maître. Le drapeau DEPLOY_LIVE vaut false par défaut. Sans lui, aucun déploiement n'est simulé : le produit répond 501 Not Implemented avec un message explicite. Le drapeau DEPLOY_REQUIRE_APPROVAL impose une approbation humaine par une personne différente du demandeur, sous peine d'un conflit typé.

---

#3.7 Synthèse de la chaîne

---

#4. Architecture d'ensemble

#4.1 Diagramme de la plateforme

#4.2 Les couches, une par une

#4.3 Volumétrie du code au 2026-08-17

Discipline de chiffre. Le comptage direct de l'arbre donne 5 472 fonctions de test, mais le tableau de santé interne ne certifie que ~3 700 tests sur 21 suites vertes réellement exécutées. La communication publie « plus de 3 700 tests automatisés » et rien d'autre.

#4.4 Choix techniques structurants

---

#5. Le plan de contrôle transversal

Le plan de contrôle est ce qui distingue KySpectra d'un assemblage d'outils. Il traverse les six maillons et s'expose principalement dans le portail d'administration.

#5.1 Les douze mécanismes du plan de contrôle

#5.2 Le diagramme de gouvernance

Chaque étage peut refuser. Aucun n'accorde par omission.

---

#6. Les surfaces produit et leur statut réel

Règle d'or : ne jamais présenter une surface inexistante comme disponible.

#6.1 Découpage des fiches de ce dossier

---

#7. Le modèle multi-locataire

#7.1 Le principe

Toute donnée est scopée par identifiant de locataire. L'isolation est stricte : aucune fuite entre clients n'est tolérée, et la plateforme ne révèle pas même l'existence d'une ressource appartenant à un autre.

#7.2 La résolution du locataire

Règle de sécurité : un identifiant de locataire en désaccord avec la revendication du jeton renvoie 404, pas 403. On ne divulgue pas l'existence de la ressource d'autrui. Ce choix est motivé par la Loi 25 et le principe de minimisation.

#7.3 Les modes d'authentification

⚠️ Écart connu. Le mode dev-headers est la valeur par défaut du code et n'est surchargé dans aucun manifeste de déploiement. Le durcissement de cette posture figure au plan de la phase 0 de pré-lancement.

#7.4 Les rôles RBAC hiérarchiques

Un rang supérieur satisfait toujours l'exigence d'un rang inférieur. Les rôles de la plateforme d'administration sont distincts et décrits au fichier 05-portail-administration.md.

⚠️ Écart connu. Cinq rôles sectoriels hérités d'un domaine antérieur subsistent hors hiérarchie et ne satisfont jamais une exigence de rang minimum. Leur retrait fait partie du chantier de généricisation, préalable au lancement.

#7.5 Le locataire de plateforme

Un identifiant de locataire réservé désigne la plateforme elle-même. Seul un administrateur de plateforme vérifié peut le cibler. Il est exempté de l'application des limites de plan, puisqu'il n'est pas un client.

---

#8. Le modèle de gouvernance de l'IA

C'est le différenciateur central du produit : les agents IA sont gouvernés comme des employés.

#8.1 Le registre central d'agents

Un bundle d'agent — compétences, invite, serveurs d'outils, palier, mémoire — se résout depuis le registre central. Rien n'est accordé implicitement.

#8.2 Les capacités à trois niveaux

Le principe est le refus par défaut : une action non explicitement couverte est refusée et journalisée sous un identifiant de politique dédié.

#8.3 Le plafond d'autonomie N0 à N3

C'est la mesure la plus concrète de la gouvernance : jusqu'où un agent peut aller seul.

La règle de plafonnement. Le niveau effectif est le minimum entre le plafond du rôle virtuel et le plafond du plan commercial. En cas de valeur inconnue ou de dégradation du service d'entitlements, la plateforme retombe sur N1 — un repli vers le bas, jamais vers le haut.

⚠️ Écart connu. Le drapeau qui active les rôles virtuels et l'application des entitlements vaut false par défaut et n'est activé dans aucun manifeste de déploiement. Le plafonnement est écrit, testé et prouvé en développement ; son activation par environnement est une action de la phase 0.

#8.4 La séparation des devoirs

#8.5 Le journal d'audit

#8.6 Les budgets et la sobriété

#8.7 Les garde-fous et politiques d'exécution

Une action peut être évaluée à la volée depuis le portail d'administration, avant d'être autorisée en production.

---

#9. Les trois environnements

#9.1 La carte des environnements

Identité partagée par les trois : un serveur Keycloak unique, un realm dédié, clients publics en PKCE S256, sans secret côté navigateur.

#9.2 La discipline de déploiement

#9.3 Le pipeline de mise en ligne

---

#10. Récapitulatif Livré / En cours / Planifié

#10.1 Ce qui est Livré

#10.2 Ce qui est En cours

#10.3 Ce qui est Planifié

#10.4 Ce qui est Bloqué

---

#11. Écarts connus et dette assumée

Cette section existe parce qu'un dossier de lancement qui cache ses écarts se détruit au premier essai client.

---

#12. Lexique du produit

Le vocabulaire est imposé et doit être utilisé tel quel dans toutes les communications.

---

#13. Ce que ce document engage

---

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.