Démarrage rapide KySpectra — votre premier projet en 30 minutes

#Avant de commencer

Ce parcours vous fait traverser la chaîne complète du portail client KySpectra en trente minutes chronométrées, en dix étapes. À la fin, vous aurez un projet réel, une spécification réelle enregistrée par un agent, un rapport d'écarts, un graphe de traçabilité, un document exporté et une trace de consommation.

Ce guide ne simule rien. Chaque étape produit des données réellement persistées dans votre locataire. Vous pouvez donc réutiliser le projet créé ici comme point de départ de votre travail.

#Prérequis

#Choisir votre environnement

Le portail d'administration (https://spectra.admin.kyrieva.com) est une application distincte, réservée aux opérateurs de la plateforme. Ce parcours ne l'utilise pas.

#Conventions du guide

• Les libellés en gras sont ceux que vous lisez à l'écran, en français.
• Les repères de temps (0:00 → 0:03) sont indicatifs. Aucun minuteur ne tourne dans le produit.
• Chaque étape se termine par un bloc Point de contrôle : si ce que vous voyez ne correspond pas, la ligne Si ce n'est pas le cas vous indique quoi faire.
• [Gabarit : capture d'écran à produire] signale un endroit où une image aiderait ; les captures seront ajoutées avant diffusion externe.

---

#Vue d'ensemble du parcours

---

#Étape 1 — Se connecter · 0:00 → 0:03

Objectif. Ouvrir une session authentifiée sur le portail client.

Où. L'adresse de votre environnement, par exemple https://spectra.kyrieva.com.

#Actions

1. Ouvrez l'adresse du portail dans votre navigateur.
2. Le portail détecte l'absence de session et vous redirige vers la page de connexion de votre fournisseur d'identité. C'est une page Keycloak, pas une page KySpectra : son apparence peut différer de celle du produit.
3. Saisissez votre identifiant et votre mot de passe, puis validez.
4. Si votre organisation impose un second facteur, complétez-le.
5. Le navigateur revient sur KySpectra à l'adresse /auth/callback. Cette page technique n'affiche qu'un état de chargement pendant l'échange du code d'autorisation ; elle ne demande rien.
6. Vous arrivez sur le Tableau de bord.

Ce qui se passe en coulisse. KySpectra utilise le flux OpenID Connect « code d'autorisation avec PKCE ». Le portail n'a pas de secret client, ne stocke pas votre mot de passe et n'a jamais accès à vos identifiants : c'est le fournisseur d'identité qui vous authentifie et remet au navigateur un jeton signé de courte durée.

#Point de contrôle

Vous devriez voir… une page dont l'exergue affiche Poste de commande, le titre Tableau de bord, et le sous-titre « Vue d'ensemble de vos projets, agents et budgets, calculée à partir de données réelles. » À gauche, un rail de navigation en trois sections : Espace de travail, Opérer, Compte.

Si ce n'est pas le cas :

[Gabarit : capture d'écran à produire — tableau de bord juste après connexion, rail déplié, langue française]

---

#Étape 2 — Langue, thème et locataire actif · 0:03 → 0:06

Objectif. Régler l'interface à votre convenance et vérifier sur quel locataire vous travaillez.

Où. La barre supérieure, à droite.

#Actions

1. Repérez, dans la barre supérieure, le groupe de contrôles à droite : recherche, notifications, copilote, puis les sélecteurs de thème, de langue, de locataire et le menu du compte.
2. Cliquez sur le sélecteur de thème. Trois choix : Système, Clair, Sombre. Choisissez celui qui vous convient. Le choix explicite est mémorisé sur cet appareil.
3. Cliquez sur le sélecteur de langue. Deux choix : français et anglais. Le français est la langue par défaut du produit ; l'anglais est une langue de plein droit, pas une traduction partielle.
4. Regardez le contrôle de locataire. S'il affiche un identifiant, vous avez un locataire actif. S'il affiche Aucun locataire défini, cliquez dessus et renseignez l'identifiant de votre organisation (un UUID) avec le bouton Définir le locataire.
5. Repliez ou dépliez le rail de navigation avec le bouton situé tout à gauche de la barre supérieure : Replier la navigation / Déplier la navigation. Ce choix est aussi mémorisé.

Pourquoi le locataire compte autant. Toutes vos données sont cloisonnées par locataire. Sans locataire actif, le portail affiche « Renseignez l'identifiant de votre locataire (UUID) pour charger vos données réelles. Rien n'est simulé tant qu'aucun locataire n'est défini. » C'est délibéré : le produit préfère une page vide honnête à un tableau de démonstration trompeur.

#Point de contrôle

Vous devriez voir… l'interface dans la langue choisie, le thème appliqué immédiatement, et un locataire actif dans la barre supérieure. Les indicateurs du tableau de bord (Projets, Notifications non lues, Exécutions agents actives, Consommation (14 j)) affichent des valeurs, même à zéro.

Si ce n'est pas le cas :

---

#Étape 3 — Créer votre premier projet · 0:06 → 0:09

Objectif. Créer le conteneur de tout ce qui suit.

Où. Rail de navigation → Projets.

#Actions

1. Dans le rail, section Espace de travail, cliquez sur Projets.
2. Le formulaire Nouveau projet est présenté en haut de la page, sous le sous-titre « Démarrez une nouvelle base de spécification pilotée par agents. »
3. Renseignez le champ Préfixe de code. Contrainte réelle : 2 à 12 caractères, lettres majuscules, chiffres ou tirets. L'exemple proposé est APP. Ce préfixe sert à construire les identifiants canoniques de vos éléments (par exemple APP-FR-0001) et ne changera plus.
4. Renseignez le champ Nom du projet. Il s'agit du nom lisible ; vous pourrez le modifier plus tard avec l'action Renommer.
5. Choisissez le Type de projet :
   • Standard (SDD/SDLC) — le cas courant, pour concevoir et livrer un produit. Choisissez celui-ci.
   • Tests — pour tester en profondeur une application déjà déployée. Il ouvre la vue Tests de l'espace de travail, mais n'est pas le sujet de ce parcours.
6. Cliquez sur Créer le projet. Le bouton passe à Création… pendant l'enregistrement.

#Point de contrôle

Vous devriez voir… une notification Projet créé avec le détail « Le projet « <votre nom> » a été créé. », puis votre projet apparaître dans le tableau Vos projets, avec les colonnes Préfixe, Nom, Créé le et Actions.

Si ce n'est pas le cas :

[Gabarit : capture d'écran à produire — formulaire Nouveau projet rempli, avant clic sur Créer le projet]

---

#Étape 4 — Générer une première spécification avec l'IA · 0:09 → 0:14

Objectif. Faire écrire par un agent de vrais éléments de spécification, puis les retrouver.

Où. Ouvrez votre projet, puis la page Spécifier.

#Actions

1. Dans le tableau Vos projets, cliquez sur Ouvrir le projet. Vous arrivez sur l'Aperçu du projet.
2. Comme le projet est vide, l'aperçu affiche « Ce projet n'a pas encore de spécification » et propose le bouton Ouvrir l'assistant Spécifier. Cliquez dessus. (Vous pouvez aussi naviguer par l'URL /projects/<identifiant>/specify.)
3. Repérez le panneau marqué du badge IA, intitulé Générer avec l'IA. Son sous-titre est explicite : « 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. »
4. Dans le champ Description, rédigez votre demande. Soyez précis : périmètre, exigences, entités et règles à créer. Exemple proposé par le produit :

   « 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. »

5. Cliquez sur Générer. Le bouton passe à Génération… et la section Activité affiche la progression réelle de l'exécution : 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.
6. À la fin, le panneau affiche Éléments créés avec, pour chaque ligne, sa Référence, son Type et son Identifiant canonique.

Ce que cette étape consomme. Une génération appelle un modèle de langage et consomme des crédits de votre locataire. C'est visible à l'étape 10. Si vos crédits sont épuisés, la génération est refusée avant l'appel — jamais après.

#Point de contrôle

Vous devriez voir… une notification Génération réussie indiquant « N élément(s) et M relation(s) enregistrés. », et la liste des éléments créés avec leurs identifiants canoniques préfixés par votre Préfixe de code.

Si ce n'est pas le cas :

Vous préférez tout saisir à la main ? La même page Spécifier contient un formulaire de composition de lot. Vous y ajoutez des éléments (Ajouter un élément), chacun avec une Référence courte et unique dans le lot (i1, i2…), un Type, un Titre et un Chemin (exemple : /exigences/authentification), puis des Relations entre ces références, et vous cliquez sur Enregistrer le lot. L'enregistrement est atomique : tout passe, ou rien.

---

#Étape 5 — Explorer et ouvrir un élément · 0:14 → 0:18

Objectif. Comprendre l'anatomie d'un élément de spécification.

Où. Page Explorateur de spécification du projet.

#Actions

1. Depuis le récapitulatif de génération, cliquez sur Voir l'explorateur. (Chemin direct : /projects/<identifiant>/spec.)
2. Observez le tableau. Cinq colonnes : Identifiant, Type, Statut, Titre, Provenance.
3. Regardez la colonne Provenance : vos éléments portent la valeur Agent, pas Humain. C'est la trace permanente de leur origine. Les deux autres valeurs possibles sont Rétro-ingénierie et Importé.
4. Essayez les filtres : le champ Rechercher accepte un identifiant, un titre ou un chemin ; le sélecteur Type propose Tous les types ; le sélecteur Statut propose Tous les statuts.
5. Cliquez sur la ligne d'une exigence pour ouvrir son détail.
6. Sur la page de détail, parcourez les trois blocs :
   • Métadonnées — Chemin, Justification, Créé le, Mis à jour le, Empreinte du contenu, Propriétaire, Version, Source de vérité.
   • Attributs — les propriétés typées définies par le métamodèle du projet.
   • Relations — les liens entrants et sortants.
7. Cliquez sur Modifier. Notez le champ Raison du changement : il est obligatoire, et son aide indique « Expliquez brièvement pourquoi cet élément change (journalisé sur la révision). » Renseignez-le, puis enregistrez — ou annulez si vous ne voulez rien changer.

#Point de contrôle

Vous devriez voir… le tableau peuplé, la mention de plage « 1–N sur N » sous la liste, et, sur le détail d'un élément, une Version au moins égale à 1 et une Empreinte du contenu non vide.

Si ce n'est pas le cas :

---

#Étape 6 — Créer une relation · 0:18 → 0:20

Objectif. Relier deux éléments pour rendre la traçabilité mesurable.

Où. Bloc Relations de la page de détail de l'élément.

#Actions

1. Restez sur le détail d'une exigence.
2. Dans le bloc Relations, repérez le champ Identifiant de la cible. Collez l'identifiant canonique d'un autre élément du projet — par exemple un critère d'acceptation créé à l'étape 4.
3. Choisissez le Type de relation. Treize types sont disponibles ; pour relier une exigence à son critère d'acceptation, vérifie ou satisfait sont les choix naturels.
4. Cliquez sur Créer la relation.
5. Vérifiez le résultat dans le bloc Relations existantes, qui distingue les relations Entrantes et Sortantes.
6. Cliquez sur Voir la traçabilité pour ouvrir l'arbre depuis cet élément. Choisissez la direction Amont (parents) ou Aval (enfants).

#Point de contrôle

Vous devriez voir… une notification Relation créée précisant « Relation « <type> » enregistrée. », la nouvelle relation listée sous Sortantes, et — sur la page Traçabilité — un arbre comportant au moins deux nœuds avec la mention Profondeur maximale.

Si ce n'est pas le cas :

---

#Étape 7 — Analyser les écarts · 0:20 → 0:22

Objectif. Obtenir une mesure objective de ce qui manque à votre spécification.

Où. Page Analyse des écarts du projet.

#Actions

1. Ouvrez /projects/<identifiant>/analyze, ou passez par le fil d'Ariane du projet, entrée Analyse.
2. Notez le badge Lecture seule et son aide : « Cette analyse n'altère aucune donnée. » Vous ne risquez rien à la lancer.
3. Lisez la Synthèse des écarts : Écarts au total, Exigences sans test, Critères sans scénario, Dépendances circulaires, Violations de constitution.
4. Descendez au Détail des écarts. Chaque ligne nomme l'élément concerné et la nature du problème, par exemple « L'exigence APP-FR-0001 n'a aucun test associé. »
5. Cliquez sur Actualiser après avoir corrigé quelque chose pour relancer l'analyse.

#Point de contrôle

Vous devriez voir… soit un nombre d'écarts supérieur à zéro avec la liste détaillée — c'est le cas normal sur une spécification neuve, car aucun test n'existe encore —, soit le message Aucun écart détecté : « La spécification est cohérente au regard des règles analysées. »

Si ce n'est pas le cas :

---

#Étape 8 — Ouvrir l'espace de travail · 0:22 → 0:26

Objectif. Découvrir la surface centrale du produit et ses onze vues.

Où. Page Espace SDD du projet.

#Actions

1. Ouvrez /projects/<identifiant>/workspace. L'espace de travail s'ouvre sur la vue par défaut, Spéc.
2. Repérez le sélecteur de vue. Les onze vues canoniques, dans l'ordre : Spéc, Graphe, Tableaux, Config, AgentOps, Tests, Revue, Docs, Artefacts, Livraison, Personnel IA.
3. Basculez sur Graphe. Choisissez un Élément racine dans le sélecteur, puis une Direction : Amont (dépend de) ou Aval (dépendants). Le compteur de nœuds s'affiche sous le graphe.
4. Basculez sur Tableaux. Vous voyez un tableau de type Kanban, une colonne par statut du cycle de vie. Faites glisser une carte vers une autre colonne : une boîte de dialogue Transition d'état s'ouvre et exige un Motif du changement — « Pourquoi cette transition ? (obligatoire) ». Validez avec Appliquer la transition, ou annulez.
5. Basculez sur Revue. Vous y retrouvez les Écarts détectés de l'étape 7, plus la Matrice de traçabilité « Exigence × (conception · tâches · code · tests · vérification) » et la ligne Avec trous.
6. Regardez l'URL de votre navigateur : elle contient ?view=.... L'URL est la source de vérité de l'état de l'écran. Copiez-la et envoyez-la à un collègue : il ouvrira exactement la même vue.
7. Appuyez sur Ctrl+K (ou ⌘K sur Mac) pour ouvrir la palette de l'espace de travail : deux groupes, Vues et Éléments de spéc. Tapez quelques lettres, naviguez avec ↑↓, ouvrez avec Entrée, fermez avec Échap.

Une vue peut manquer, c'est normal. Chaque vue déclare la capacité qui la protège : par exemple Config exige config:read, AgentOps exige agentops:read, Personnel IA exige workforce:read. Si votre rôle ne l'a pas, la vue affiche Accès non autorisé — « Votre rôle ne permet pas de consulter cette vue. » De plus, la vue Tests n'est applicable qu'aux projets de type Tests : ailleurs elle affiche Non applicable à ce type de projet.

#Point de contrôle

Vous devriez voir… le bandeau de contexte de l'espace de travail avec ses quatre compteurs — Éléments, Écarts, Vérifiés, Types — et un basculement instantané entre les vues sans rechargement de page.

Si ce n'est pas le cas :

[Gabarit : capture d'écran à produire — espace de travail, vue Graphe, avec le sélecteur de vues visible et le compteur de nœuds]

---

#Étape 9 — Exporter la documentation et regarder les artefacts · 0:26 → 0:28

Objectif. Sortir un livrable lisible de ce que vous venez de créer.

Où. Vues Docs et Artefacts de l'espace de travail.

#Actions

1. Basculez sur la vue Docs. Son sous-titre annonce la règle : « Documentation et diagramme générés depuis la spec réelle. »
2. Parcourez les trois sections produites : Aperçu, Constitution, Éléments de spécification.
3. Cliquez sur Exporter en Markdown. Le fichier se télécharge.
4. Cliquez sur Exporter le diagramme (.mmd) pour récupérer le graphe de spécification au format Mermaid, réutilisable dans votre propre documentation.
5. Basculez sur la vue Artefacts. Huit onglets : DDD, C4 / TOGAF / ArchiMate, UML, BPMN, ERD, Sécurité, Graphe de mapping, Dépendances.
6. Sur un projet neuf, la plupart de ces onglets afficheront « Aucun artefact pour ce projet pour l'instant. » C'est attendu : les artefacts d'architecture sont produits par la rétro-ingénierie d'un dépôt existant ou par les étapes de conception du cycle, pas par une simple génération d'exigences.

Le principe à retenir. Le sous-titre de la vue Artefacts est une promesse d'ingénierie : « Diagrammes produits par les services (Mermaid), rendus tels quels — jamais inventés. » Le portail n'affiche pas de diagramme décoratif pour meubler un écran vide.

#Point de contrôle

Vous devriez voir… une notification Document exporté et un fichier Markdown dans votre dossier de téléchargements, contenant vos éléments réels.

Si ce n'est pas le cas :

---

#Étape 10 — Consommation, facturation et invitation d'un coéquipier · 0:28 → 0:30

Objectif. Voir ce que votre parcours a coûté, et ouvrir le projet à quelqu'un d'autre.

Où. Rail → section Compte.

#Actions

1. Dans le rail, cliquez sur Consommation & budgets. Quatre indicateurs : Solde de crédits, Consommation (14 j), Taux de combustion / jour, Autonomie estimée.
2. Regardez le panneau Budgets. Chaque budget affiche son pourcentage « du budget » et un état parmi Sain, Seuil d'alerte, Seuil élevé, Seuil critique, Dépassé.
3. Cliquez sur Voir le grand livre. Vous arrivez sur Grand livre & facturation : chaque ligne porte Date, Type, Modèle, Jetons, Montant, Référence. C'est ici que votre génération de l'étape 4 apparaît. Le journal est en ajout seul.
4. Vous pouvez extraire l'ensemble avec Exporter (CSV).
5. Retournez au rail et cliquez sur Équipe.
6. Cliquez sur Inviter un membre. Renseignez l'E-mail et le Rôle, puis Envoyer l'invitation.
7. Vérifiez le panneau Invitations en attente : vous pouvez Renvoyer ou Révoquer tant que la personne n'a pas accepté.

Une remarque d'honnêteté. Si le service de facturation n'est pas joignable, les panneaux affichent explicitement Facturation non raccordée ou Grand livre non raccordé au lieu d'un solde à zéro. Un montant affiché est toujours un montant réellement mesuré.

#Point de contrôle

Vous devriez voir… au moins une écriture dans le grand livre correspondant à votre génération d'IA, et — après l'invitation — une ligne dans Invitations en attente avec l'adresse et la date d'invitation.

Si ce n'est pas le cas :

---

#Vous avez terminé

En trente minutes, vous avez :

#Les cinq gestes à retenir

#Et ensuite ?

Le guide utilisateur complet (01-guide-utilisateur.md) documente chaque route, chaque action, chaque message d'erreur, et dit explicitement ce qui n'est pas encore disponible.

---

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.