Page bloquée

Cette page est actuellement bloquée pour modification par un autre utilisateur. Vous devez attendre que cet utilisateur ait terminé ou que le blocage de la page expire.
Actuellement bloqué par : 192.168.0.100,216.73.216.20
Le blocage expire à : 2026/07/22 10:26 (14 min)
Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
====== Sprint DOC-01 ======

Documentation Platform

Objectif :

Créer une plateforme de gestion documentaire "Documentation as Code" permettant de produire, maintenir, versionner, publier et générer automatiquement l'ensemble de la documentation de la plateforme SaaS.

Statut :

Nouveau

Priorité :

Très haute

Complexité :

Très élevée

Durée estimée :

2 à 4 semaines

----

===== Vision =====

La documentation devient un produit à part entière.

Les documents ne sont plus édités directement dans un Wiki.

La source de vérité est un dépôt Git.

Les sites documentaires sont générés automatiquement.

Les agents IA participent à la rédaction.

Les Playbooks deviennent la référence métier.

Toutes les procédures sont reliées :

  * aux Capabilities
  * aux APIs
  * aux Domain Events
  * aux Tests QA
  * aux User Stories
  * aux Prompts IA

----

===== Objectifs =====

Créer un référentiel documentaire unique.

Supprimer le copier/coller.

Versionner toute la documentation.

Publier automatiquement la documentation.

Permettre aux IA de créer les documents.

Garantir la cohérence documentaire.

Créer une traçabilité complète.

----

===== Architecture cible =====

<code>

Documentation Platform

├── Documentation Repository
├── Documentation Generator
├── Publication Engine
├── Search Engine
├── Documentation API
├── Documentation AI Agent
├── Documentation Validator
├── Documentation Preview
└── Documentation Portal

</code>

----

===== Arborescence Git =====

<code>

documentation/

    operating-model/

    playbooks/

        sales/

        platform/

        billing/

        support/

        marketing/

        owner/

        guest/

        reservation/

        property/

        ai/

        security/

        compliance/

    capabilities/

        sales/

        platform/

        billing/

        support/

        ...

    procedures/

        SALES/

        BILL/

        PLAT/

        SUP/

        ...

    user-stories/

    api/

    events/

    prompts/

    qa/

    diagrams/

    assets/

    templates/

</code>

----

===== Format documentaire =====

Tous les documents utilisent :

Markdown

Front Matter YAML

Mermaid

PlantUML

OpenAPI

JSON Schema

Aucun document n'est stocké dans une base SQL.

Git devient la source de vérité.

----

===== Front Matter =====

Tous les documents commencent par :

<code yaml>

id:

title:

version:

status:

playbook:

capability:

workspace:

roles:

owner:

created:

updated:

related:

tags:

</code>

----

===== Types de documents =====

Operating Model

Playbook

Capability

Procedure

Architecture

Decision Record

API

Prompt

Test

Diagram

Template

Release Note

Roadmap

----

===== Structure documentaire =====

Niveau 0

Operating Model

↓

Niveau 1

Playbooks

↓

Niveau 2

Capabilities

↓

Niveau 3

Procedures

↓

Niveau 4

User Stories

↓

Niveau 5

API

↓

Niveau 6

Events

↓

Niveau 7

Tests

↓

Niveau 8

Prompts IA

----

===== Générateur =====

Le générateur produit automatiquement :

Navigation

Index

Sommaires

Liens croisés

Graphes

Diagrammes

Recherche

Glossaire

PDF

Documentation HTML

Site documentaire

----

===== Documentation Portal =====

Créer une nouvelle application :

Documentation Portal

Fonctions :

Explorer

Rechercher

Prévisualiser

Comparer les versions

Visualiser les graphes

Télécharger PDF

Voir les diagrammes

Voir les dépendances

----

===== Documentation API =====

Créer une API interne.

Exemples :

GET /documentation/playbooks

GET /documentation/procedures

GET /documentation/capabilities

GET /documentation/search

GET /documentation/graph

GET /documentation/tree

POST /documentation/generate

POST /documentation/validate

----

===== Documentation Validator =====

Le validateur contrôle automatiquement :

unicité des IDs

références cassées

Playbooks inexistants

Capabilities inexistantes

API non référencées

liens morts

diagrammes invalides

Mermaid

OpenAPI

Front Matter

structure documentaire

numérotation

----

===== Documentation Search =====

Recherche globale :

Playbooks

Capabilities

Procédures

API

Events

Prompts

Tests

Glossaire

Recherche plein texte.

----

===== Documentation Graph =====

Construire automatiquement le graphe documentaire.

Exemple :

<code>

Sales Playbook

↓

CAP-SALES-PROSPECT

↓

SALES-001

↓

POST /prospects

↓

LeadCreated

↓

QA-SALES-001-001

↓

PROMPT-SALES-001

</code>

----

===== Documentation AI =====

Créer un agent spécialisé.

Fonctions :

Créer un document.

Modifier un document.

Créer une procédure.

Créer un Playbook.

Créer une Capability.

Créer les tests.

Créer les prompts.

Créer les diagrammes.

Vérifier la cohérence.

Préparer une Pull Request.

----

===== GitHub =====

Créer un dépôt :

documentation

Branches :

main

develop

feature/*

Toutes les modifications passent par Pull Request.

----

===== GitHub Actions =====

Déclencheurs :

Push

Pull Request

Release

Actions :

Validation

Génération

Publication

PDF

Recherche

Index

----

===== Publication =====

Produire automatiquement :

Documentation HTML

PDF

Version imprimable

Archive ZIP

----

===== Moteur documentaire =====

Utiliser :

MkDocs Material

Pourquoi :

Navigation exceptionnelle

Recherche rapide

Mermaid

PlantUML

OpenAPI

Versioning

Dark Mode

Responsive

Très utilisé

Documentation as Code

----

===== Documentation Workspace =====

Créer un Workspace spécifique.

Menus :

Dashboard

Playbooks

Capabilities

Procedures

Architecture

API

Tests

Prompts

Diagrams

Assets

Templates

Search

Publications

Settings

----

===== Dashboard =====

Afficher :

Nombre de Playbooks

Nombre de Capabilities

Nombre de Procédures

Couverture QA

Couverture API

Couverture IA

Liens cassés

Dernières modifications

Activité Git

----

===== Convention documentaire =====

Une Capability appartient toujours à un Playbook.

Une Procédure appartient toujours à une Capability.

Une User Story référence une Procédure.

Une API référence une Procédure.

Un Event référence une Procédure.

Un Test référence une Procédure.

Un Prompt référence une Procédure.

----

===== Sécurité =====

Versionnement Git obligatoire.

Historique complet.

Validation avant publication.

Aucune édition directe du site publié.

----

===== Livrables =====

✓ Documentation Repository

✓ Documentation Portal

✓ Documentation API

✓ Documentation Validator

✓ Documentation Generator

✓ Documentation Search

✓ Documentation Graph

✓ GitHub Actions

✓ MkDocs

✓ Agent IA

✓ Publication automatique

----

===== Définition de terminé =====

La Documentation Platform est considérée terminée lorsque :

✓ la documentation est entièrement versionnée dans Git

✓ tous les documents possèdent un Front Matter normalisé

✓ les Playbooks sont publiés automatiquement

✓ les Capabilities sont reliées aux Playbooks

✓ les Procédures sont reliées aux Capabilities

✓ les APIs sont reliées aux Procédures

✓ les Domain Events sont reliés aux Procédures

✓ les Tests sont reliés aux Procédures

✓ les Prompts IA sont reliés aux Procédures

✓ les liens sont validés automatiquement

✓ un site MkDocs est généré automatiquement

✓ une recherche plein texte est disponible

✓ un graphe documentaire est généré

✓ un agent IA est capable de créer et maintenir automatiquement la documentation

✓ aucune documentation n'est modifiée directement sur le site publié.