# CLAUDE.md · OTO Enterprise OS · Digital Twin Platform (DTP)

## Objectif temporel
**8 semaines OU MOINS** — refactoring des modules existants (gain ~47%) permet livraison anticipée. Cible plancher réaliste : **4-5 semaines**.

## Vision
Construire une plateforme intégrée qui unifie :
- **BIM** (Blender + Bonsai + IFC + Speckle) pour faisabilités automatisées
- **ERPNext natif** (v15) comme moteur ERP/CRM/Vente/Achat/Compta
- **Console Helios** (frontend luxury dark+doré) comme UX unique
- **Faisabilités 4 volets** (Masterplan · Architecture · Paysage-Expérience · Ingénierie) niveau 4Big
- **OTOIA** (agent orchestrateur) qui pilote AEC + prompt engine + RAG

## Contraintes NON-NÉGOCIABLES
1. **ERPNext natif = priorité absolue** avant tout outil externe
2. **Gitea SEULE plateforme** git (repo `michel/otov7-platform` port 3015) — JAMAIS GitHub
3. **CRM = ERPNext natif** — JAMAIS EspoCRM ni HubSpot
4. **Design luxury** dark+doré `#0a0a12` + `#f0b429` (Fraunces + Cormorant Garamond)
5. **Score minimum 95/100** — niveau 4Big obligatoire sur tout livrable
6. **Zéro invention** de chiffres — toujours vérifier sources archives
7. **Standards 4 volets** faisabilité — OBLIGATOIRE tous projets
8. **VPS pour TOUS projets** — jamais local
9. **Frais édition doc 3%** · Marketing 8.5% · Point équilibre 52% pré-vente
10. **USD + DOP** devises · **Letter US** format · **Cardnet** paiements (pas Stripe)

## Architecture cible
- ERPNext v15 (moteur) + OTOAI UX (5 Portals rôle)
- OTOIA capabilities : aec.py + knowledge.py + prompt_engine.py + chat.py
- Speckle 3D viewer intégré (bim-cloud.otov7.com)
- Voix Amélie QC (multilingual_v2)
- RBAC 50 rôles

## Entités
- **WAF** (holding) · **WA SRL** · **AC Arias Cuevas** · **Consortium ECR DR** (paymaster RH)
- **Helios RD** (marque publique) sous WAG
- **Ploutos** (patrimoine/monétaire) · **9060 QC** (World Activities Cdn.)

## Projets
P01 Structure · P02 Coral del Sur · P03 Nakua · P04 Xamaná Cantiles · P05 Las Colinas Najayo Arriba · P06 Coco Real · P07 Aqua Terra Las Terrenas · P08 Fasano Espirilla · P09 1069 Crisfer

## VPS
IP 153.75.250.214 · Docker (erpnext-backend-1, erpnext-frontend-1) · nginx serve `/static/` depuis `/opt/oto/sites/static/` (SYMLINK depuis `/var/www/html/static`)

## Interdits absolus
- ❌ `git clean` (jamais)
- ❌ EspoCRM, HubSpot
- ❌ Rendus AI génériques sans lien avec projet réel
- ❌ Écrire directement dans `/var/www/html/static/` (use `/opt/oto/sites/static/`)
- ❌ Documenter code sans vérifier existence courante (memory peut être stale)

## Workflow
1. Analyser avant agir
2. Vérifier · Investiguer · Valider · Confirmer
3. Auto-vérification HTTP après chaque déploiement
4. Toujours 2+ solutions aux problèmes
5. Éliminer le vieux (JAMAIS accumuler doublons)


## Git — Gitea SEULEMENT
- **URL** : http://153.75.250.214:3015 (interne) · gitea.otov7.com (public si configuré)
- **Owner** : michel
- **Repo mandat DTP** : `michel/oto-enterprise-os-dtp`
- **JAMAIS** GitHub / GitLab / Bitbucket
- Auth : SSH key ou token Gitea (voir /etc/oto/credentials)


## ⭐ DÉROGATION 2026-08-03 · Michel a levé toutes les contraintes bloquantes
Voir `AUTORISATIONS_MICHEL_20260803.md` · TOUS les agents sont autorisés à ·
- `bench migrate` sur site `frontend`
- Modifier nginx, systemd, docker sans confirmation
- Créer DocTypes, Roles, Workflows dans ERPNext
- Continuer Sprints 3, 4, 5, 6, 7, 8 en autonome 24/7
- Voir la liste complète · `/opt/oto/claude_code_mandate_dtp/AUTORISATIONS_MICHEL_20260803.md`

**La contrainte #8 (hors périmètre worker) est LEVÉE.**