# 🎯 DIRECTIVE · MODULE « CHOISIR MON UNITÉ » STYLE PLANPOINT.IO · 2026-08-03

## Exigence Michel (formelle · 2026-08-03)

Le module `/choisir-mon-unite/` doit devenir un **vrai configurateur virtuel** au niveau de **PlanPoint.io** avec ·

### Composants OBLIGATOIRES

1. **Vue 3D du bâtiment complet par projet**
   - Modèle BIM (IFC) exact du projet, converti en GLB
   - Rotation 360°, zoom, tilt tactile mobile
   - Rendu photoréaliste (lighting, ombres, matériaux)
   - Vue jour + nuit
   - Environnement (mer, palmiers, montagne selon projet)

2. **Filtres interactifs par unité**
   - Étage (slider ou liste)
   - Orientation (N / S / E / O / SE / SO / NE / NO)
   - Typologie (Studio / 1 Ch / 2 Ch / 3 Ch / Penthouse selon nomenclature standard OTOV7)
   - Superficie (min / max en m²)
   - Prix (min / max en devise sélectionnée)
   - Statut · Disponible / Réservée / Vendue (couleurs distinctes)

3. **Rendus intérieurs photoréalistes**
   - Au minimum 6 vues par typologie (salon, cuisine, chambre principale, salle de bain, terrasse, vue depuis fenêtre)
   - Générés via Flux (RunPod GPU · déjà configuré)
   - Ambiance cohérente avec la faisabilité (clientèle cible → palette → matériaux)
   - Multi-typologie par projet (Standard / Confort / Prestige / Panorama)

4. **Plans techniques**
   - Plan 2D de chaque étage cliquable
   - Plan 2D de chaque typologie
   - Plans PDF téléchargeables (résident / architecte / banque)

5. **Panoramas 360° immersifs**
   - Vue depuis la terrasse de chaque orientation
   - Vue depuis le lobby / hall d'entrée
   - Vue depuis chaque amenity majeur (piscine, gym, restaurant)

6. **Fiche unité détaillée au clic**
   - Photo hero de la vue
   - Superficie exacte, chambres, orientations, étage
   - Prix USD + conversion DOP/CAD/EUR live (widget devise)
   - Statut disponibilité real-time (query ERPNext)
   - Plan 2D téléchargeable
   - Modelisation 3D isolée de l'unité (juste l'appart)
   - CTA · « Réserver cette unité » → workflow OTO Dossier Vente créé auto
   - Comparateur · ajouter à liste comparative (max 3 unités)

7. **Système réservation intégré**
   - Click réserver → checkout Cardnet (acompte 20% résident / 30% étranger)
   - Génération auto Promesa Irrévocable (Ley 126-02)
   - Signature électronique OTO Sign™
   - Notification WhatsApp + email
   - Statut réservation live dans /mon-compte/

### Architecture technique demandée

- Frontend · React ou Vanilla JS + Three.js (viewer premium) OU model-viewer Google (déjà en place, extensible)
- Backend · endpoints ERPNext natif (DocType `Unite Immobiliere` + `Reservation Unite` déjà partiellement en place)
- Storage 3D · Speckle server local (déjà UP) pour versionning BIM
- Rendus · Flux via RunPod GPU (déjà configuré · voir memory otov7_runpod_api_key)
- Real-time · websocket pour updates disponibilité multi-utilisateur (voir concurrence)

### Références visuelles

- PlanPoint.io · https://planpoint.io/ (référence UX/UI)
- Kartorama · https://kartorama.com/
- ProjectCore · https://projectcore.io/
- Openn Real Estate · https://www.openn.au/

### Phasage recommandé (par ordre livraison MVP → complet)

**Phase 1 (MVP) · déjà LIVE ce soir**
- Viewer 3D basique avec model-viewer + GLBs placeholders
- Endpoint /api/units/by-project/<code>
- Sidebar liste unités + click → fiche

**Phase 2 · commander vrais IFC BIM**
- 1 IFC par projet actif (P01, P02, P03) auprès architectes
- Property `OTO_Code` sur chaque IfcSpace pour identifier unités
- Ajout renderings interior via Flux

**Phase 3 · Filtres avancés**
- Étage, orientation, typologie, prix, statut
- Comparateur 3 unités

**Phase 4 · Rendus photoréalistes**
- Batch Flux · 6 vues/typologie/projet · lighting cohérent
- Panoramas 360° via Blender/Bonsai

**Phase 5 · Réservation intégrée**
- Checkout Cardnet + Promesa auto + OTO Sign
- Statut real-time via websocket

### Estimation effort

- Phase 1 · **DONE** (Sprint 3 · viewer 3D LIVE)
- Phase 2 · 1 semaine si IFC disponibles rapidement
- Phase 3 · 3 jours
- Phase 4 · 2 semaines (batch renders 6× 8 projets = 48+ scènes)
- Phase 5 · 1 semaine (workflow signature + paiement)
- **Total · 5-6 semaines** pour équivalent PlanPoint 100%

### Gate qualité

Chaque phase doit passer QA 95+/100 avant passage à la suivante · test Playwright end-to-end · Michel valide visuellement.

### Contact Michel

Michel voyage · continuer en autonome. Publier fichier `SPRINT_3_PHASE_N_COMPLETE.md` au fur et à mesure des livraisons pour qu'il constate progression au retour.
