DIRECTIVE CRITIQUE · Project Identity Engine (PIE) · faisabilité = SSOT · annexe 12 V10

DIRECTIVE_PIE_PROJECT_IDENTITY_ENGINE_20260803.md

@@ -0,0 +1,181 @@
+# 🎨 DIRECTIVE · OTO Project Identity Engine (PIE) · 2026-08-03
+
+**Priorité · CRITIQUE**
+**Source** · Directive Michel du 2026-08-03 (Directive_OTO_Project_Identity_Engine_Claude.docx)
+**Impact** · doit être intégrée au workflow V10 comme moteur central
+
+## Vision
+
+**La faisabilité devient le Project DNA · source unique de vérité (SSOT).**
+Aucun document ou support ne doit être recréé manuellement si les données existent déjà dans la faisabilité.
+
+## Objectif
+
+L'étude de faisabilité alimente automatiquement l'ensemble des modules OTO Enterprise OS. Toute modification de la faisabilité met à jour automatiquement tous les livrables downstream.
+
+## Project Master Data (champs obligatoires par projet)
+
+- **Identité** · nom, type, concept, vision, mission, valeurs
+- **Localisation** · adresse exacte, coordonnées GPS, province, ville, quartier
+- **Architecture** · style, matériaux, ambiances, palette matériaux
+- **Unités** · typologies, surfaces, orientations, quantités, prix, disponibilités
+- **Budget** · CAPEX, coûts construction, marges, break-even, apport promoteur
+- **Marketing** · positionnement, clientèle cible, USPs, canaux
+- **BIM** · IFC/GLB, plans, coupes, panoramas
+- **Finances** · plan de financement, fideicomiso, CONFOTUR, exonérations
+- **Juridique** · titres, permis, licences, contrats types
+- **Images** · rendus extérieurs, intérieurs, aériens, ambiances
+- **Services** · amenities, conciergerie, services inclus
+- **Calendrier** · phasage travaux, jalons, livraison
+
+## Project Identity Engine (PIE)
+
+Créer un **moteur** qui génère automatiquement l'identité complète du projet à partir des Project Master Data.
+
+### Production automatique (déclenchée par la faisabilité validée)
+
+**Identité visuelle**
+- Brand Book PDF (~30-50 pages)
+- Logo principal + variantes (horizontal, vertical, monochrome, dark, light)
+- Palette couleurs complète (accord clientèle cible + ambiance faisabilité)
+- Typographies primaire + secondaire
+- Iconographie sur mesure
+- Patterns et textures
+- Guidelines usage
+
+**Documents commerciaux**
+- Brochures PDF FR/EN/ES
+- Kit banquier PDF trilingue
+- One-pager investisseur
+- Trousse Client à compléter (pré-remplie données projet)
+- Contrats types (Promesa, Fideicomiso adhésion, HOA)
+
+**Présentations**
+- PPTX présentation commerciale
+- PPTX présentation banquier
+- PPTX présentation investisseur
+
+**Web & Mobile**
+- Page projet vente.otov7.com/projets/{slug}/ (auto-générée)
+- Section dans /choisir-mon-unite-3d/ (avec IFC + rendus)
+- Section dans app mobile (portail Client)
+- Portail admin ERPNext
+
+**Signatures & Communications**
+- Signature email standardisée
+- Templates WhatsApp
+- Modèles marketing (posts Meta, LinkedIn, X)
+- Templates newsletter
+
+## IA · OTO AI génère plusieurs propositions
+
+Pour chaque brief faisabilité validé, OTO AI produit ·
+- 3-5 propositions de logos (styles différents)
+- 5-10 slogans / taglines
+- 3 palettes complémentaires
+- 3 univers graphiques (mood boards)
+
+Michel (ou équipe validée) choisit la meilleure combo. Le PIE fige alors l'identité et déclenche la production automatique tous les livrables.
+
+## Synchronisation continue
+
+**Règle absolue** · toute modification de la faisabilité met à jour automatiquement TOUS les livrables downstream ·
+- Modification prix → régénère brochures + kit banquier + contrats + site + app
+- Modification typologie → régénère plans + rendus + fiche unité + BIM
+- Modification amenities → régénère brochures + site + slogan + brand book
+- Modification livraison → régénère calendrier + brochures + trackers chantier
+
+Le PIE maintient un **manifest de dépendances** (`/opt/oto/data/pie/{projet_code}/manifest.json`) qui liste tous les livrables générés et leur checksum. Un webhook sur les changements de faisabilité déclenche la régénération sélective.
+
+## Architecture Multi-Marques
+
+Support illimité de projets sans modification du code métier ·
+- Nakua (P03 · Bávaro)
+- Coral del Sur (P02 · San Cristóbal)
+- Aqua Terra (P07 · Las Terrenas)
+- Las Colinas (P05 · Najayo)
+- Fasano Espirilla (P08 · Santo Domingo Espirilla)
+- Résidence Gazcue (P09 · Santo Domingo centre historique)
+- Coco Real (P06 · Punta Cana Bávaro)
+- Xamaná Cantiles (P04 · Palenque)
+- Coralis (P01 · San Cristóbal)
+- + futurs projets (tours à venir · joint-ventures · marques blanches)
+
+Chaque projet a son propre Brand Book généré · aucun code spécifique à écrire pour un nouveau projet · uniquement remplir la faisabilité.
+
+## Workflow obligatoire
+
+```
+1. Validation Faisabilité (par OTO Auditeur Faisabilité IA)
+   ↓
+2. Extraction Project Master Data (JSON structuré /opt/oto/data/pie/{code}/master.json)
+   ↓
+3. Brand Book génération (Cormorant Garamond + palette · via IA + PIE templates)
+   ↓
+4. Logos génération (OTO AI Flux + variantes SVG)
+   ↓
+5. Thème appliqué (CSS variables + design tokens)
+   ↓
+6. Documents commerciaux (brochures PDF · kit banquier · Trousse · contrats)
+   ↓
+7. Portails web (page projet vente.otov7.com/projets/{slug}/ · viewer 3D · portail client)
+   ↓
+8. Applications mobiles (section projet + tab dédié)
+   ↓
+9. Synchronisation
+   → ERPNext (DocType Project + Unite + Reservation Unite)
+   → CRM (Lead + Opportunity pré-remplis projet)
+   → BIM (IFC + GLB + Speckle)
+   → OTO AI (context injection pour concierge · slogan · positionnement)
+   → OFAC + PEP + FinCEN (screening règles selon clientèle cible)
+   ↓
+10. Publication (site public + app + portail admin + ERPNext + Speckle + Google Search Console indexation)
+```
+
+## Architecture technique proposée
+
+### Modules
+- `/opt/oto/api/pie/master_data.py` · CRUD Project Master Data
+- `/opt/oto/api/pie/brand_generator.py` · génère Brand Book via IA
+- `/opt/oto/api/pie/logo_generator.py` · Flux + SVG variantes
+- `/opt/oto/api/pie/document_generator.py` · brochures/contrats depuis templates
+- `/opt/oto/api/pie/web_generator.py` · pages projet auto
+- `/opt/oto/api/pie/mobile_generator.py` · sections app mobile auto
+- `/opt/oto/api/pie/sync_manager.py` · propagation modifications
+- `/opt/oto/otoia/capabilities/pie.py` · orchestration OTOIA
+
+### Storage
+- `/opt/oto/data/pie/{projet_code}/master.json` · Project Master Data
+- `/opt/oto/data/pie/{projet_code}/brand/` · Brand Book assets
+- `/opt/oto/data/pie/{projet_code}/logos/` · Logos SVG/PNG
+- `/opt/oto/data/pie/{projet_code}/documents/` · PDF générés
+- `/opt/oto/data/pie/{projet_code}/manifest.json` · manifest dépendances + checksums
+
+### Événements
+- `pie.project.master_data.updated` → régénérer downstream
+- `pie.project.brand.approved` → figer identité
+- `pie.project.published` → activer sur site/app/portails
+- `pie.project.regenerated` → log audit
+
+## Livrables MVP (Sprint prochaine nuit)
+
+- **P0** · Créer schéma Project Master Data + endpoint CRUD + storage JSON
+- **P1** · Générateur Brand Book PDF basique (utilise assets faisabilité)
+- **P2** · Générateur logos via OTO AI Flux (3 propositions)
+- **P3** · Synchronisation vers ERPNext DocType Project
+- **P4** · Régénération auto brochures existantes (P01/P02/P03) depuis master data
+
+## Contribution à V10
+
+Ce PIE devient l'**Annexe 12** de V10 (Workflow Faisabilité V10 amendé) ·
+- V10 originale (11 annexes) + PIE = V10.1
+- PIE est le pivot qui unifie tous les modules autour de la faisabilité SSOT
+- Sans PIE · les 11 annexes de V10 sont indépendantes et risquent divergence
+- Avec PIE · cohérence garantie sur toute la stack
+
+## Références liées
+
+- V10 · `DIRECTIVE_WORKFLOW_FAISABILITE_V10_20260803.md`
+- Design System · `OTO_DESIGN_SYSTEM_v1.md`
+- OTOIA capabilities · aec.py (BIM) · knowledge.py (RAG) · prompt_engine.py · à créer `pie.py`
+- Constitution EAOF V7 · toujours référence pour Bureau Virtuel 12 directions