---
type: doctrine
titre: "📜 PROTOCOLE — Migration documentaire OLYMPUS"
dossier: 01_LOIS
etage: long
source: true        # SOURCE (autorite) - les projections (Chroma/graphe) en derivent
maj: 2026-05-20
hash: ddae6187
---

> ⚠️ **OBSOLÈTE PARTIEL — audit 2026-05-13** : ce doc référence des ports morts (~~:9011~~ → :10001, ~~:9010~~ → :10001, etc.). Le seul port valide pour la sphère/cockpit est **:10001** (NEXUS). Mis à jour par 114-GAMEDIVINE. Voir `MNEMOSYNE/01_LOIS/DOCTRINE_PORTS_OLYMPUS.md`.

# 📜 PROTOCOLE — Migration documentaire OLYMPUS

> **Type** : protocole réutilisable (mémo CODEX)
> **Créé** : 25/04/2026 — session migration v10.0.3 → v10.1.0
> **Auteur méthode** : Claude (Dev+UX) sur demande de Vivien
> **Réutilisable pour** : toute future migration de version majeure ou mineure d'OLYMPUS

---

## 🎯 Quand utiliser ce protocole

Activer ce protocole quand :
- Vivien dit "migration", "passage à v10.x.0", "harmonisation"
- Un chantier touche à plusieurs documents (CODEX, GOD, MEMORY, etc.)
- Un changement de doctrine ou vocabulaire est en cours
- L'autre chat dispatcher / chats parallèles doivent être resynchronisés

---

## 📋 Étapes (ordre stricte)

### Phase A — Doctrine (toujours en premier)

| # | Étape | Outils | Validation | Estimation |
|---|---|---|---|---|
| A1 | MAJ HTML d'architecture (vocabulaire + schéma + ports + protocoles) | Read + Edit | Vivien | 30 min |
| A2 | Créer/MAJ PROTOCOLE de travail (ce document) | Write | auto | 20 min |
| A3 | Créer/MAJ VOCABULAIRE_OLYMPUS.md (source unique) | Write | Vivien | 30 min |

### Phase B — Audit (avant de modifier)

| # | Étape | Outils | Validation | Estimation |
|---|---|---|---|---|
| B1 | Compter les endpoints API réels (`Grep` sur `@app.get` `@app.post` + `@router.*`) | Grep | rapport | 45 min |
| B2 | Auditer cohérence vocabulaire (chercher widget / tuile / app / module et lister conflits) | Grep | rapport | 45 min |
| B3 | Auditer chemins en dur (`F:\` `C:\` chemins) → repérer les obsolètes | Grep | rapport | 30 min |

### Phase C — Marquage obsolète (avant suppression)

| # | Étape | Outils | Validation | Estimation |
|---|---|---|---|---|
| C1 | Lister tous les docs/pages/fichiers à marquer obsolètes | Glob | rapport | 15 min |
| C2 | Appeler `obsolete_marker.py` ou ajouter banner manuel sur chaque | Bash | auto | 25 min |

### Phase D — Réorganisation MNEMOSYNE

| # | Étape | Outils | Validation | Estimation |
|---|---|---|---|---|
| D1 | Créer dossier `09_ARCHIVES/v10.0.x/` | Bash | auto | 5 min |
| D2 | Déplacer obsolètes dedans | Bash | auto | 30 min |
| D3 | Vérifier que rien n'est cassé (NEXUS tourne toujours) | Bash | auto | 10 min |
| D4 | MAJ `MNEMOSYNE/CODEX.html` (régénération) | Bash POST `/api/codex/regenerate` | auto | 15 min |

### Phase E — Code

| # | Étape | Outils | Validation | Estimation |
|---|---|---|---|---|
| E1 | MAJ `codex_module.py` pour pointer vers nouveaux fichiers | Edit | auto | 30 min |
| E2 | Bump version (chercher v10.0.x dans le code, remplacer par v10.1.0) | Grep + Edit | auto | 20 min |

### Phase F — Structure

| # | Étape | Outils | Validation | Estimation |
|---|---|---|---|---|
| F1 | Créer structure AGORA vide (modules_maison, connecteurs_maison, ARSENAL) | Bash mkdir | auto | 10 min |
| F2 | Créer `AGORA/_index.json` (catalogue maître) | Write | Vivien | 20 min |
| F3 | Créer `AGORA/README.md` (doc usage) | Write | auto | 20 min |

### Phase G — Synchro chats parallèles

| # | Étape | Outils | Validation | Estimation |
|---|---|---|---|---|
| G1 | Préparer prompt pour autre chat (vocabulaire + doctrine + lien HTML) | Write | Vivien avant envoi | 45 min |
| G2 | Créer fichier dédié dans `06_PROJETS/OLYMPUS/PROMPT_<chantier>.md` | Write | auto | 10 min |

### Phase H — Documentation finale

| # | Étape | Outils | Validation | Estimation |
|---|---|---|---|---|
| H1 | Créer `CHANGELOG_v<X.Y.Z>.md` | Write | auto | 20 min |
| H2 | Créer `MIGRATION_GUIDE_v<X.Y.W>_TO_v<X.Y.Z>.md` | Write | auto | 30 min |
| H3 | Vérification finale (lire chaque doc, screenshot HTML) | Read + capture | Vivien | 20 min |

---

## ⚖️ Règles strictes

1. **Toujours backup avant** — copier dans `99_BACKUP/<date>/` ou `09_ARCHIVES/v<ancien>/` avant tout déplacement
2. **Doctrine Mona Lisa** — rien ne s'efface, on archive uniquement
3. **Validation Vivien** entre phases A et B (obligatoire), entre H et fin (obligatoire)
4. **Convention 3 voix** dans tous les rapports (Dev+UX / Limites / Bonus / Reco)
5. **Estimer le temps** pour chaque étape AVANT de la lancer
6. **Reporter le temps réel** après chaque étape (utile pour calibrer estimations futures)
7. **Ne JAMAIS toucher au code fonctionnel** pendant la migration documentaire (séparer doc et code)
8. **Régénérer le CODEX** après réorganisation (sinon les chats voient l'ancien état)
10. **🔥 PATTERN "URL STABLE + CONTENU ÉVOLUTIF" (ajout 25/04/2026 — Vivien)** :
   > Quand un document maître évolue (ex: GOD_OLYMPUS v10.0.1 → v10.1.0), **NE PAS** créer un nouveau fichier avec un nouveau nom et modifier 50 boutons partout.
   >
   > **Bonne pratique** :
   > 1. **Garder le nom de fichier original** (ex: `GOD_OLYMPUS_v10.0.1.html`) comme **adresse stable**
   > 2. **Remplacer son contenu** par le nouveau (ex: contenu v10.1.0)
   > 3. **Backup l'ancien contenu** dans `09_ARCHIVES/<date>_predates_<vnew>/backup_avant_replacement/` avant écrasement (Mona Lisa)
   > 4. **Tous les boutons existants** chargent automatiquement le nouveau contenu, **zéro lien à modifier**
   > 5. **Le titre dans le doc** précise la version réelle (ex: `<title>GOD v10.1.0</title>`) → pas de confusion à la lecture
   >
   > **Avantage** : 0 lien cassé, 0 boutton à patcher, sémantique URL = ressource stable, sémantique contenu = version actuelle.
   > **Pattern pro équivalent** : `latest.json` dans GitHub Releases, `:latest` Docker tags, `current` symlink Linux, `index.html` en web.

9. **🔥 RÈGLE DES MODIFS PÉRIPHÉRIQUES (ajout 25/04/2026 — Vivien)** :
   > Toute modification d'un fait (chiffre, version, port, nom, terme, structure) **DOIT être accompagnée d'un audit automatique des modifs périphériques** dans tous les fichiers/écrans/docs où ce fait est mentionné.
   >
   > **Vivien ne doit JAMAIS avoir à signaler "tu as oublié de mettre à jour X"** — c'est ton job de chercher en cascade.
   >
   > **Procédure systématique** :
   > 1. Quand on change une donnée — ex : `473 endpoints` → `457 endpoints`, ou `v10.0.3` → `v10.1.0`, ou `19 modules` → `19 modules`
   > 2. Lancer un `Grep` global sur l'ancienne valeur (TOUS dossiers, TOUS fichiers : `.html`, `.md`, `.py`, `.json`, `.js`...)
   > 3. Lister ce qu'on trouve, décider ce qu'on MAJ, ce qu'on archive (historique), ce qu'on laisse
   > 4. **Annoncer à Vivien** la liste des changements en cascade avant de les appliquer
   > 5. Appliquer puis vérifier
   >
   > **Endroits classiques à vérifier en cascade pour OLYMPUS** :
   > - `Cockpit/index.html` (tuiles avec chiffres affichés)
   > - `Cockpit/statique/ZEUS.html` (tuiles raccourci, headers)
   > - `Cockpit/statique/cockpit_classique.html`
   > - `Cockpit/statique/TODO_CHAT.html`
   > - `MNEMOSYNE/CODEX.html` (auto-régénéré, mais à forcer)
   > - `MNEMOSYNE/01_LOIS/*.md` et `*.html`
   > - `MNEMOSYNE/06_PROJETS/OLYMPUS/*` (HERITAGE, GOD, RECAP)
   > - `~/.claude/projects/.../memory/MEMORY.md`
   > - `Desktop/OLYMPUS/*.html` (raccourcis bureau)
   > - `AXIOM/codex_module.py` (générateur CODEX)
   > - Tous les `.bat` de boot

---

## 🛡️ Garde-fous (anti-casse)

- **Snapshot avant phase D** (réorganisation MNEMOSYNE) — `mirror_sync.py` vers Bureau + USB
- **Test que NEXUS tourne** avant chaque phase et après — ouvrir `http://127.0.0.1~~:10001~~ → :10001/api/health`
- **Si un test échoue** → STOP, restaurer depuis backup, demander à Vivien
- **Pas de migration en session de travail active** — toujours quand Vivien est dispo pour valider

---

## 🆕 v10.1.0 — Outils de pérennisation (Drift Detection + Data Binding)

Ne plus patcher en dur les chiffres dans tous les fichiers à chaque migration. Pattern pro :

### 1. Source unique de vérité (SSoT)

📄 `C:\OLYMPUS\OLYMPUS_STATE.json` — TOUT chiffre/version OLYMPUS découle de là.

### 2. Drift Detection (scan automatique)

📄 `C:\OLYMPUS\01_SERVEUR\NEXUS\AXIOM\drift_audit.py`

```bash
python drift_audit.py            # rapport coloré
python drift_audit.py --json     # sortie JSON
python drift_audit.py --strict   # exit 1 si drift détecté
```

**À lancer SYSTÉMATIQUEMENT** :
- Avant et après chaque modification de OLYMPUS_STATE.json
- Avant chaque commit
- Au début de chaque session migration (vérifier l'état)

### 3. Data binding HTML (auto-MAJ visuelle)

📄 `C:\OLYMPUS\01_SERVEUR\NEXUS\Cockpit\statique\js\auto-info.js`

Au lieu d'écrire `457 endpoints` en dur, écrire :
```html
<span data-bind="endpoints_count">457</span>
```

Au load, le JS appelle `/api/info` et remplace par la valeur canonique.

**Pages déjà câblées (v10.1.0)** : `Cockpit/index.html`, `Cockpit/statique/ZEUS.html`.

**Clés disponibles** : `version`, `endpoints_count`, `modules_count`, `tranches_count`, `olympus_maison`, `arsenal_total`, `tuiles_garage`, `widgets_cockpit`, `port`.

### 4. Workflow recommandé pour future migration

```
1. Modifier OLYMPUS_STATE.json (changer version + chiffres)
2. python drift_audit.py        # voir TOUS les fichiers qui driftent
3. Patcher en dur les fichiers code/JSON/MD non-bindables
4. Pour les HTML : data-bind suffit, /api/info auto-MAJ
5. Restart NEXUS pour activer le nouveau /api/info
6. python drift_audit.py --strict  # vérification finale
7. Régénérer CODEX (curl POST /api/codex/regenerate)
```

---

## 🔁 Auto-référence (si tâche similaire)

Quand un chat reçoit une demande type :
- *"On migre vers v10.x.0"*
- *"Harmonise tout"*
- *"Fais un audit puis MAJ"*
- *"Vérifie cohérence"*

→ Le chat doit lire ce protocole en PREMIER, l'appliquer phase par phase, et **déclarer** qu'il l'utilise dans sa réponse initiale (ex: *"J'applique PROTOCOLE_MIGRATION_DOCUMENTAIRE phases A→H"*).

---

## 📚 Référence dans CODEX

Le `codex_module.py` doit générer une section :

```md
## Protocoles disponibles

- 📜 [PROTOCOLE_MIGRATION_DOCUMENTAIRE.md](MNEMOSYNE/01_LOIS/PROTOCOLE_MIGRATION_DOCUMENTAIRE.md)
  → Pour migrations de versions et harmonisations doctrinales
```

---

## 📝 Historique d'application

| Date | Version | Phases appliquées | Durée totale | Réalisé par |
|---|---|---|---|---|
| 25/04/2026 | v10.0.3 → v10.1.0 | A1, A2, A3, B1-B3, C, D, E, F, G, H | (en cours) | Claude Opus |

---

**Fin du protocole.**

---
_Migre F:->C: par docs_portability_light 2026-05-10_