# 🎨 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
