# Ménage pré-POC — Plan d'exécution

**Date** : 2026-05-29
**Objectif** : rendre le projet `rpa_vision_v3` propre, lisible et portable sur DGX Spark avant déploiement clinique J+15.
**Scénario retenu** : **médian** — tri code/tests/docs + archivage modules orphelins, sans ajout de nouveaux tests POC critiques (dette POC acceptée).

## Photo de départ

| Élément | Valeur |
|---------|--------|
| Taille totale | 112 Go |
| Fichiers Python | 44 172 |
| Tests | 273 fichiers, ~98 K lignes |
| Markdown | 1 149 fichiers (160 racine `docs/`) |
| Modules `core/` orphelins | 21 / 41 |
| Git non commité au démarrage | 79 untracked + 49 modifiés |

## Décisions validées (2026-05-29)

1. **`agent_v0/agent_v1/` (client Windows Léa) sort du repo principal** → repo dédié `agent_v1_windows_client`. Cycle de release indépendant (déjà géré par SCP auto `feedback_scp_auto_modif_client_windows`). Le DGX ne le porte pas.
2. **Tests POC critiques manquants** (ollama_client, vlm_config, dialog_handler) **non ajoutés en POC** — dette POC explicite, chantier post-POC.
3. **Politique archivage** : branche dédiée `cleanup/pre-poc-2026-05-29`, commit unique par phase, rollback possible. Pas de suppression bourrine — tout est archivé dans `archive/` ou `_legacy/` selon la nature.
4. **Filtrage transfert DGX** : `data/` (27 Go RGPD), `logs/`, `htmlcov/`, `_archive/`, `archive/`, `output/`, venvs, `agent_rust/`, `models/*` lourds **ne partent pas** sur DGX.

## Plan d'exécution — 9-10 j-h sur 15 j calendrier

Branche : `cleanup/pre-poc-2026-05-29`
Commits : un par phase avec préfixe `chore(cleanup):`

### Phase F — Git cleanup (1 j) — **À FAIRE EN PREMIER**

Pré-requis avant tout autre tri. État : 79 untracked + 49 modifiés.

- [ ] `git status --short` → catégoriser : à commit, à stash, à supprimer
- [ ] Commit le pertinent (1 ou plusieurs commits thématiques)
- [ ] Stash l'expérimental sur branche dédiée `experimental/<topic>`
- [ ] Supprimer fichiers morts confirmés
- [ ] `pending_uncommitted_files.md` à jour ou supprimé après tri

### Phase A — Filtrage transfert DGX (0,5 j)

- [ ] Créer `.dgxignore` ou `tar --exclude-from=`:
  - `data/`, `logs/`, `htmlcov/`, `output/`, `_archive/`, `archive/`
  - `venv_v3/`, `.venv/`, `node_modules/`
  - `agent_rust/` (Rust pas dans le POC)
  - `models/` sauf liste explicite POC
  - `*.pyc`, `__pycache__/`, `.pytest_cache/`, `.ruff_cache/`, `.vite/`
- [ ] Test tarball local : mesurer taille résultante (cible < 5 Go)

### Phase B — Code `core/` orphelin (2-3 j)

Cible : `archive/core_v3_projections_2026-05-29/`

Modules à archiver (21) : `analytics`, `capture`, `coaching`, `cognition`, `corrections`, `data`, `evaluation`, `extraction`, `gpu`, `healing`, `interfaces`, `monitoring`, `persistence`, `precision`, `security`, `supervision`, `system`, `training`, `variants`, `visual`

Méthode :
- [ ] Pour chaque module : `grep -r "from core.<module>" --include="*.py" .` → vérifier zéro import depuis points d'entrée actifs (api_stream, replay_engine, workflow_pipeline, VWB backend)
- [ ] Documenter dans `archive/core_v3_projections_2026-05-29/README.md` : raison d'archivage, modules dépendants éventuels, plan de réintégration possible
- [ ] `git mv` pour préserver l'historique
- [ ] Lancer fast suite → vérifier rien n'est cassé

Modules **gardés** (17 actifs) : `anonymisation`, `auth`, `detection`, `embedding`, `execution`, `federation`, `graph`, `grounding`, `knowledge`, `learning`, `llm`, `matching`, `models`, `pipeline`, `validation`, `vision`, `workflow`

### Phase C — Doublons code (1-1,5 j)

- [ ] **Consolider `config.py`** :
  - Source de vérité : `core/config.py`
  - Supprimer `agent_v0/config.py` (58 L), import depuis core
  - `agent_v0/agent_v1/config.py` (101 L) → suit phase H (externalisation)
- [ ] **Fusionner models orphelins** :
  - `core/corrections/models.py` (480 L) → archive (corrections est orphelin)
  - `core/system/models.py` (340 L) → archive (system est orphelin)
  - Pas de fusion nécessaire si les deux partent en archive — vérifier qu'aucun module actif ne les importe
- [ ] **Sortir `agent_v0/agent_v1/`** vers repo dédié (voir phase H)

### Phase D — Tests (2 j, sans ajout)

- [ ] Diagnostic full : `pytest --collect-only 2>&1 | tee /tmp/pytest_collect.log` → identifier import errors, xfail cascade
- [ ] Archiver tests orphelins → `archive/tests_orphan_2026-05-29/` :
  - `tests/unit/test_cognition_dataclasses.py`
  - `tests/unit/test_learning_pack.py`
  - `tests/unit/test_pii_blur.py`
  - `tests/unit/test_extraction_engine.py`
  - `tests/unit/test_process_mining_bridge.py` (xfail)
  - `tests/unit/test_circular_imports.py` (xfail)
  - `tests/property/test_analytics_properties.py` (620 L xfail)
- [ ] Supprimer tests cassés irrécupérables :
  - `tests/test_cross_frame_cache.py`
  - `tests/test_visual_rpa_checkpoint.py` (661 L, imports `core.visual` manquants)
- [ ] À investiguer avant action :
  - `tests/property/test_self_healing_properties.py` (~450 L, healing orphelin)
  - 4 fichiers `test_learning_*.py` (~800 L, learning module statut à confirmer)
- [ ] Valider fast suite reste verte : `pytest tests/test_pipeline_e2e.py tests/test_phase0_integration.py -q`
- [ ] Documenter dette POC dans `docs/POC/DETTE_POC.md` : 3 tests manquants (ollama_client, vlm_config, dialog_handler) à ajouter post-POC

### Phase E — Docs (1 j)

Cible structure DGX :
```
docs/
├─ POC/                  (gardé — actif)
├─ architecture/         (gardé)
├─ reference/            (gardé)
├─ guides/               (gardé)
├─ README.md, STATUS.md, CI_SETUP.md, OLLAMA_INTEGRATION.md, PLAYBOOK_DSI_RSSI.md
└─ archive/
   ├─ audits/            (17 AUDIT_*, BENCH_*, ANALYSE_*)
   ├─ sessions/          (12 HANDOFF_*, SESSION_*)
   ├─ plans/             (10 PLAN_*, VISION_*, ROADMAP_*)
   ├─ tasks-logs/        (71 TACHE_*, PHASE_*, RESOLUTION_*)
   ├─ brouillons/        (44 divers)
   └─ coordination-logs/ (567 fichiers coordination/)
```

- [ ] Script de tri par préfixe (`AUDIT_*` → `archive/audits/`, etc.)
- [ ] Déduplication doublons identifiés (3 groupes : CORRECTION_FINALE_TYPESCRIPT_VWB, RESOLUTION_FINALE_PALETTE, RESUME_FINAL_PHASE_2)
- [ ] QA liens internes (sed sur les chemins déplacés)

### Phase G — Requirements ARM (0,5 j)

- [ ] Désépingler tous les `nvidia-*-cu12` du `requirements.txt`
- [ ] Créer `requirements-server.txt` (sans PyQt5, mss, pyautogui, pynput, evdev, python-xlib)
- [ ] Garder `requirements-dev.txt` pour le poste Dom
- [ ] Vérifier coherence avec `setup.py`

### Phase H — Externalisation `agent_v0/agent_v1/` (incluse dans 1 j de Phase C)

- [ ] Créer nouveau repo Gitea `agent_v1_windows_client`
- [ ] `git subtree split --prefix=agent_v0/agent_v1 -b extract-agent-v1` pour préserver l'historique
- [ ] Push vers nouveau repo
- [ ] Supprimer `agent_v0/agent_v1/` du repo principal
- [ ] Mettre à jour `feedback_scp_auto_modif_client_windows` (chemin source change)
- [ ] Mettre à jour `tests/integration/conftest.py` (le workaround sur `agent_v0` n'est plus nécessaire)

### Validation finale (0,5 j)

- [ ] Fast suite verte : `pytest tests/test_pipeline_e2e.py tests/test_phase0_integration.py tests/integration/test_stream_processor.py -m "not slow" -q`
- [ ] Smoke test pipeline complet (mockup local)
- [ ] Tarball test avec `.dgxignore` → mesure taille
- [ ] PR ou merge sur main avec changelog clair

## Branche et commits

```
git checkout -b cleanup/pre-poc-2026-05-29

# Phase F : Git cleanup
git commit -m "chore(cleanup): trier 79 untracked + 49 modifiés pré-POC"

# Phase A : Filtrage transfert
git commit -m "chore(cleanup): ajouter .dgxignore pour transfert DGX"

# Phase B : core orphelins
git commit -m "chore(cleanup): archiver 21 modules core orphelins vers archive/core_v3_projections_2026-05-29"

# Phase C : Doublons
git commit -m "chore(cleanup): consolider config.py + sortir agent_v1 vers repo dédié"

# Phase D : Tests
git commit -m "chore(cleanup): archiver tests orphelins + supprimer tests cassés irrécupérables"

# Phase E : Docs
git commit -m "chore(cleanup): restructurer docs/ en archive/ par catégorie"

# Phase G : Requirements
git commit -m "chore(cleanup): désépingler nvidia-cu12 + split requirements-server.txt"

# Validation
git commit -m "chore(cleanup): valider fast suite + tarball DGX < 5Go"
```

Merge sur `main` à la fin uniquement si validation OK. Si problème → rollback ciblé par phase (`git revert <hash>`).

## Rollback plan

- Branche `cleanup/pre-poc-2026-05-29` reste intacte pendant le POC
- Modules archivés sont `git mv`, historique préservé → restauration en 1 commit
- Tag git `pre-cleanup-2026-05-29` posé sur `main` AVANT la branche cleanup
- En cas de besoin de récupérer un orphelin : `git checkout <tag> -- core/<module>`

## Dette POC explicite

À traiter après stabilisation POC clinique :

1. **Tests POC critiques manquants** : ollama_client (1 → 5+), vlm_config (1 → 4+), dialog_handler (0 → 3+)
2. **Modules orphelins** : revue cas par cas pour rebrancher ou supprimer définitivement
3. **Refacto profond doublons models** : `core/corrections/models.py` vs `core/system/models.py` (si rebranchés post-POC)
4. **Migration `OllamaClient` → `VLMClient` multi-backend** (cf. `PORTAGE_DGX_SPARK_2026-05-28` §3)

## Décisions

| # | Décision | Date |
|---|----------|------|
| 1 | Scénario médian retenu, ~9-10 j-h | 2026-05-29 |
| 2 | `agent_v0/agent_v1/` sort dans repo dédié `agent_v1_windows_client` | 2026-05-29 |
| 3 | Tests POC critiques (ollama_client, vlm_config, dialog_handler) acceptés en dette POC | 2026-05-29 |
| 4 | Politique archivage : branche `cleanup/pre-poc-2026-05-29`, commit par phase, tag `pre-cleanup-2026-05-29` sur main | 2026-05-29 |
| 5 | `data/`, `logs/`, `htmlcov/`, `archive/`, `_archive/`, `output/`, `agent_rust/`, `models/*` lourds ne partent pas sur DGX | 2026-05-29 |
| 6 | 17 modules `core/*` gardés actifs, 21 archivés | 2026-05-29 |
| 7 | `web_dashboard/` inclus dans le périmètre DGX — **interface de pilotage centrale** (admin modèles, prompts, supervision), pas un nice-to-have | 2026-05-29 |
| 8 | Amina = source de vérité métier (codage médical) **uniquement**. Ne participe pas au code, au tri, au déploiement. Dom (+ assistant technique) exécute la transformation en programme | 2026-05-29 |

## Questions ouvertes

- Quand démarrer ? (en parallèle de la prep DGX semaine 2026-06-01 ou avant ?)
- Politique de tag : `pre-cleanup-2026-05-29` ou autre nomenclature préférée ?
- `agent_chat/` (692 K, 7 678 L) : maintenu en POC ou archivé ? À trancher Phase B