docs: track design docs, plans, audits, coordination infrastructure, handoffs

- 21 docs/*.md: audits, design notes, deployment plans, checklists, memos
- Coordination: ROLES, runbooks (DGX reboot, Lea live), patches, registre, syntheses, systemd, QG template
- Handoffs: 6 Codex handoff documents + README + template
This commit is contained in:
Dom
2026-07-02 13:29:58 +02:00
parent 7dd5c872df
commit 6907ecc82f
42 changed files with 5267 additions and 0 deletions

View File

@@ -0,0 +1,105 @@
# Revue globale post-panne DGX — 2026-06-20
- `Pilote`: Codex
- `Contributeurs`: Claude, Qwen
- `Contexte`: coupure électrique à 02:07 CEST
- `Verdict`: **GO labo supervisé / NO-GO fonctionnement autonome et clinique**
## Résumé
Le DGX, les services, les données et la VM Windows ont survécu ou ont été récupérés. L'accès Dom à la VM est rétabli. La panne révèle cependant que l'accès graphique et le démarrage complet de Léa ne sont pas encore autonomes: le tunnel SSH et le mot de passe VNC sont volatils, et aucun agent Windows n'a encore prouvé une reconnexion après la panne.
## Checklist consolidée
| Domaine | Contrôle | État | Preuve / observation |
|---|---|---:|---|
| Coordination | Watcher Codex/Claude/Qwen | OK | service utilisateur persistant `enabled+active` |
| Réseau | DGX joignable sur `192.168.1.45` | OK | IP WiFi statique, SSH et services accessibles |
| Réseau | Exclusion/réservation `.45` dans le DHCP box | À FAIRE | risque de conflit futur |
| Réseau | Ethernet clinique inactif | OK | interface sans carrier |
| Réseau | Ethernet clinique `autoconnect=off` | KO | profil encore `autoconnect=yes` |
| Sécurité | 5900/5902/3389/22220/8000 fermés depuis le LAN | OK | nmap: filtered/closed; loopback conservé |
| Services | Services système RPA | OK | 10 units `enabled`; services critiques actifs, zéro erreur/restart |
| Dashboard | API et UI | OK | auth 401 sans creds; UI réelle rendue; Socket.IO/API 200 |
| Dashboard | Fallback user concurrent | KO | service user disabled mais actif en crash-loop, 167+ restarts, conflit 5001 |
| Dashboard | Monitoring 5003 / Session Cleaner 5006 | DÉGRADÉ | affichés arrêtés; non bloquants POC mais classification à clarifier |
| Dashboard | Liens navigateur vers `localhost` | DÉGRADÉ | liens 8000/5002/3002/5004/5005 incorrects depuis un poste distant |
| Dashboard | Backups/restore points | DÉGRADÉ | dashboard annonce 0 backup et aucun point de restauration |
| VWB | Backend/frontend | OK | health 200; UI réelle rendue; catalogue/session APIs 200 |
| VWB | Cohérence catalogue | DÉGRADÉ | DB=24 workflows; sélecteur UI=22; review=8 |
| VWB | Workflows appris | DÉGRADÉ | plusieurs entrées importables à 0 nœud/0 transition |
| Données | `workflows.db` | OK | SQLite `integrity_check=ok`, 24 workflows |
| Données | Workflows fichiers | OK | symlink runtime valide, 42 fichiers |
| Données | Anchors | OK | 468 fichiers anchors + 47 anchor images |
| FAISS | Index et métadonnées | OK | 13 666 vecteurs, test HTTP 200 `success=true`, index sain |
| Worker | Daemon et queue | OK | heartbeat post-panne; queue total/pending/failed=0 |
| Agent chat | Service | OK | status online, 79 workflows |
| Streaming | Service | OK | `/health=200`, version 1.0.0 |
| Upload API | Service 8000 | OK | `rpa-vision-v3-api` actif+enabled, 401 loopback attendu |
| Ollama/grounder | Services | OK/DÉGRADÉ | process/services présents; fonction modèle non exercée dans ce smoke |
| VM | Autostart QEMU | OK après recovery | user service active+enabled, linger, 0 restart |
| VM | Boot Windows | OK | framebuffer Windows lock screen, 8,6 Go RSS |
| VM | VNC serveur loopback | OK | RFB 3.8 sur `127.0.0.1:5902` |
| VM | Tunnel poste Dom | RÉTABLI MAIS VOLATIL | tunnel local actif; Remmina connecté; perdu au reboot poste |
| VM | Mot de passe VNC | RÉTABLI MAIS VOLATIL | auth de bout en bout validée; absent du script d'autostart |
| VM | SSH guest 22220 | KO | hostfwd présent mais aucune bannière guest |
| VM | Guest agent QEMU | KO/NON PROUVÉ | socket présent, aucune réponse `guest-ping` |
| Léa Windows | Reconnexion agent post-panne | KO/NON PROUVÉ | aucun `last_seen` fleet postérieur à la panne |
| Léa Windows | `config.txt` live vers `.45` | NON TESTÉ | le template build ne prouve pas la configuration installée |
| Git DGX | Branche | OK | `poc-dgx` |
| Git DGX | Reproductibilité déploiement | DÉGRADÉ | HEAD `ec1fb81`, patch auth `app.py` + DB modifiés, cible `cf81ce4c7` non intégrée |
| Installateur | Artefact autonome 1.0.1 | DÉGRADÉ | seul `deploy/Lea_v1.0.0.zip` visible dans ce checkout |
| Frontend | VWB servi par Vite dev | POC SEULEMENT | port 3002 LAN; à remplacer par build/proxy pour clinique |
## Cause de l'absence d'accès VM
1. Le poste Dom a redémarré: le tunnel SSH local a disparu.
2. Le VNC QEMU est volontairement loopback-only et filtré depuis le LAN.
3. QEMU redémarre avec `password=on`, mais aucun script ne réinjecte le mot de passe.
Correctif runtime appliqué: tunnel `localhost:5902` recréé, mot de passe VNC reposé sans exposition, authentification validée, Remmina connecté.
## Tests fonctionnels nécessitant Dom dans Windows
- [ ] Se connecter à la session Windows.
- [ ] Vérifier que Léa démarre automatiquement; sinon la lancer.
- [ ] Vérifier le `config.txt` live vers le DGX `.45`.
- [ ] Confirmer un nouveau `last_seen` de la machine dans Fleet.
- [ ] Ouvrir « Discuter avec Léa » et envoyer `Bonjour`.
- [ ] Vérifier les bulles/progressions d'une action simple.
- [ ] Importer un workflow JSON dans VWB.
- [ ] Ouvrir une étape avec anchor et confirmer le crop.
- [ ] Exécuter un replay supervisé sans action destructive.
## Actions prioritaires
### P0 — autonomie après reboot
1. Stopper proprement le fallback `rpa-vision-v3-dashboard-user` en crash-loop; garder le service système.
2. Rendre le tunnel VM persistant sur le poste Dom (`systemd --user` ou `autossh`).
3. Rendre l'auth VNC persistante via un secret local protégé, ou retirer le password QEMU et s'appuyer sur SSH+loopback.
4. Après login Windows, prouver le démarrage/re-enrôlement Léa et corriger le `config.txt` live si nécessaire.
### P1 — installation fiable
5. Exclure/réserver `.45` dans le DHCP de la box.
6. Passer le profil Ethernet clinique à `autoconnect=no` tant que non autorisé.
7. Réconcilier Git DGX avec backup de `workflows.db`; ne pas utiliser `reset --hard` sans procédure validée.
8. Produire/identifier l'installateur Léa 1.0.1 attendu.
9. Corriger les liens dashboard `localhost` et distinguer clairement services critiques/optionnels.
10. Mettre en place un vrai backup/restore point post-déploiement.
### P2 — dette produit
11. Diagnostiquer guest SSH/QEMU guest agent.
12. Réconcilier les 24 workflows DB avec les 22 affichés et traiter les 8 reviews/entrées à 0 nœud.
13. Remplacer Vite dev par un build statique/proxy avant clinique.
## Preuves visuelles
- `output/playwright/dgx-post-panne-dashboard-20260620-0241.png`
- `output/playwright/dgx-post-panne-vwb-20260620-0241.png`
## Divergences de revue résolues
La première matrice Qwen confondait `5006` avec l'upload API, inspectait les unités user au lieu des unités système et utilisait des chemins de données non runtime. Les contrôles Codex/Claude ont confirmé: upload API sur 8000, services système persistants, 42 fichiers workflows et 468+47 fichiers anchors. Les constats Qwen conservés sont le guest SSH KO, le fallback dashboard en crash-loop et le worktree DGX non reproductible.