# OTO Enterprise OS · Digital Twin Platform (DTP)

Mandat de refactoring **8 semaines ou moins** : unifier BIM (Blender/Bonsai/IFC/Speckle),
ERPNext v15 natif, la Console Helios (luxury dark+doré) et les faisabilités 4 volets
niveau 4Big, pilotés par l'agent orchestrateur OTOIA. Vision et contraintes
NON-NÉGOCIABLES : [`CLAUDE.md`](CLAUDE.md).

> **Point d'entrée** de ce dépôt de mandat. Il indexe les artefacts et rapporte l'état
> courant. Chaque chiffre ci-dessous est **sourcé** vers un artefact commité (anti-invention
> `CLAUDE.md` #6) ; ce README n'introduit aucune donnée nouvelle.

## Navigation

| Zone | Contenu |
|---|---|
| [`CLAUDE.md`](CLAUDE.md) | Vision · 10 contraintes NON-NÉGOCIABLES · entités · projets · VPS |
| [`04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md`](04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md) | Plan 8 sprints · gains d'accélération (~47%) · métriques succès MVP |
| [`AGENTS_EXISTING_ASSETS.md`](AGENTS_EXISTING_ASSETS.md) | Modules OTOV7 réutilisés par agent (source des refactorings) |
| [`PORTAIL_BANCABLES_4BIG.md`](PORTAIL_BANCABLES_4BIG.md) | Cadre de bancabilité 4Big |
| [`02_master_prompt/`](02_master_prompt) | Prompt maître du mandat |
| [`03_agents/`](03_agents) | Fiches des **13 agents** (rôle · livrables · coordination) |
| [`05_deliverables_mvp/`](05_deliverables_mvp) | Livrables (générateurs déterministes + hand-off `out/`) |
| [`05_deliverables_mvp/GAP_ANALYSIS_SPRINT1.md`](05_deliverables_mvp/GAP_ANALYSIS_SPRINT1.md) | Audit d'assets + gap analysis (Sprint 1) |
| [`05_activity_log/`](05_activity_log) | Journal de session horodaté |
| [`.gitea/workflows/ci.yml`](.gitea/workflows/ci.yml) · [`ci/`](ci/README.md) | Gate CI Gitea Actions + guards locaux |
| [`run_ci.sh`](run_ci.sh) | Miroir **local** du gate : rejoue tout `gate.needs` (dérivé de ci.yml, sans liste en dur) |
| [`tests/`](tests) | Baseline E2E Playwright |

## Les 13 agents

Faisabilité & 3D : [`bim`](03_agents/bim/AGENT.md) · [`ifc_speckle`](03_agents/ifc_speckle/AGENT.md) ·
[`rendu`](03_agents/rendu/AGENT.md) · [`faisabilite`](03_agents/faisabilite/AGENT.md) ·
[`publiciste`](03_agents/publiciste/AGENT.md)
Plateforme : [`erpnext_backend`](03_agents/erpnext_backend/AGENT.md) ·
[`frontend_console`](03_agents/frontend_console/AGENT.md) · [`crm`](03_agents/crm/AGENT.md) ·
[`onapi_legal`](03_agents/onapi_legal/AGENT.md) · [`seo`](03_agents/seo/AGENT.md) ·
[`mobile`](03_agents/mobile/AGENT.md)
Transverses : [`devops`](03_agents/devops/AGENT.md) · [`qa`](03_agents/qa/AGENT.md)

## État courant (sourcé)

- **Qualité 4Big** : **24/24 modules gated à 100/100** (seuil 95 · `CLAUDE.md` #5), verdict `PASS`
  — source [`qa/audit_4big/out/quality_report.json`](05_deliverables_mvp/qa/audit_4big/out/quality_report.json).
- **Régression** : **24 suites gated** couvertes bijectivement vs CI. Le **compte de tests
  agrégé faisant autorité** vit dans [`qa/regression/out/regression_run.json`](05_deliverables_mvp/qa/regression/out/regression_run.json),
  artefact **commité et byte-gaté** : `ci/check_regression.sh` régénère un `run` frais et exige
  l'identité **byte-for-byte** avec la baseline commitée (verdict `PASS`). Recensement déterministe
  des suites : [`qa/regression/out/regression_plan.json`](05_deliverables_mvp/qa/regression/out/regression_plan.json).
- **Recette roadmap** : **15 promesses** (8 livrables sprint + 7 métriques MVP), **15 `in_repo`
  prouvées** (chacune traçant ses items hors-périmètre worker · #8 · ex. M5 « app publiée 2 stores »),
  verdict `true` — source [`qa/acceptance/out/acceptance_matrix.json`](05_deliverables_mvp/qa/acceptance/out/acceptance_matrix.json).
- **Guards** : [`ci/guard_constraints.sh`](ci/README.md) + [`ci/check_docs.sh`](ci/README.md) verts.

## Périmètre worker (in-repo) vs VPS

Ce dépôt produit des **générateurs déterministes** et leurs **hand-off `out/`**, gatés en CI.
Le **déploiement réel** (bench migrate, import fixtures, câblage nginx/systemd, builds stores,
indexation, voix Amélie) s'exécute sur le **VPS `153.75.250.214`** et reste **hors périmètre
worker** (`CLAUDE.md` #8). Le plan d'activation ordonné est le run-book
[`devops/deploy_runbook`](05_deliverables_mvp/devops/deploy_runbook/README.md).

## Git — Gitea uniquement

Dépôt de mandat : `michel/oto-enterprise-os-dtp` sur Gitea (`153.75.250.214:3015`).
**JAMAIS** GitHub / GitLab / Bitbucket (`CLAUDE.md` #2, garde `ci/guard_constraints.sh`).