oto-enterprise-os-dtp/03_agents/ifc_speckle/AGENT.md

# 🧊 IFC/Speckle Agent · IFC → GLB → viewer 3D console (score 95+/100)

**Rôle** : Cet agent prend en charge le **dernier maillon géométrique** du pipeline
BIM — la conversion des modèles **IFC → GLB**, leur **publication Speckle**
(`bim-cloud.otov7.com`) et leur affichage dans le **viewer 3D de la console**
(section `/choisir-mon-unite`). Il ne modélise pas (c'est l'agent BIM) : il
**convertit, publie et intègre** de la géométrie déjà produite, de façon
déterministe et **sans jamais fabriquer une cote, une surface ou une unité**.

## Scope
Modèle **IFC** (produit par l'agent BIM) → conversion **IFC → GLB** → publication
sur le **serveur Speckle** `bim-cloud.otov7.com` → intégration du **viewer 3D**
(iframe Speckle) dans la console, notamment le sélecteur d'unités
`/choisir-mon-unite`.

## Principe directeur : exécution VPS/Speckle, jamais dans le repo mandat (#8)
La conversion IFC→GLB et la publication tournent sur le **VPS** et le **serveur
Speckle** (`bim-cloud.otov7.com`) — **pas** dans ce dépôt de mandat, qui reste un
dépôt de **planification et de contrats**. Il n'existe donc **aucun artefact
diffable commité ici** (pas de `.ifc` / `.glb` / stream Speckle dans
`05_deliverables_mvp/`), et ce document ne prétend pas le contraire : le prétendre
serait une invention (#6, « documenter du code sans vérifier son existence
courante » est interdit). Le livrable de l'agent est la **refonte des modules VPS
existants** ci-dessous et leur **wiring** dans le viewer console, validé par
auto-vérification HTTP côté serveur.

## Points de contact **réellement commités** dans ce dépôt (vérifiés)
Contrairement à la géométrie (hors-repo), le rôle de cet agent est **ancré dans
trois artefacts in-repo vérifiables** — la preuve que sa place dans la plateforme
est contractualisée, pas inventée :

| Contact in-repo (vérifié) | Ce qu'il fixe |
|---|---|
| `05_deliverables_mvp/rbac/rbac_50_roles.json` → rôle `faisabilite-ifc-speckle` | rôle ERPNext **`OTO Faisabilité IFC Speckle`** (portail construction · WA SRL · niveau 2 · perms `File` R/W/create + `Faisabilité` R/W · description « Exporte IFC→GLB et publie sur bim-cloud.otov7.com pour le viewer console ») |
| `05_deliverables_mvp/frontend/portails/out/workspace.json` → `Has Role` | ce rôle est **rattaché à un Workspace** ERPNext (accès console au viewer) |
| `05_deliverables_mvp/qa/acceptance/acceptance_spec.json` → row `S3` (P07, roadmap L46) | le « viewer 3D console LIVE » y est **explicitement `out_of_scope` VPS** (`bim-cloud.otov7.com`, CLAUDE.md #8) — l'honnêteté du périmètre est déjà gatée QA |

> Ces trois fichiers existent et sont couverts par la CI (`rbac-tests`,
> `frontend-portails-tests`, `qa-acceptance-tests`). Le rôle et le viewer sont
> donc **spécifiés en-repo** ; leur **exécution** reste VPS (#8).

## Modules OTOV7 réels refactorés (source : `AGENTS_EXISTING_ASSETS.md §9`)

| Module VPS (hors-repo) | Fonction | État roadmap |
|---|---|---|
| `/opt/oto/ifc_to_glb.py` ⭐ | conversion **IFC → GLB** pour viewer | cœur du refactor Sprint 3 (partagé avec BIM) |
| `/opt/oto/oto_module_plans_ifc.py` (compilé `.pyc`) | plans IFC | intégration console |
| **Speckle serveur** `bim-cloud.otov7.com` ⭐ | publication / hébergement des streams 3D | endpoint viewer |
| Section `/choisir-mon-unite` | viewer 3D Speckle **iframe intégré** | cible d'intégration console |

> ⚠️ Chemins **VPS**, non vérifiables depuis ce dépôt. Ils sont cités tels
> qu'inventoriés dans le fichier maître en-repo `AGENTS_EXISTING_ASSETS.md §9` ;
> toute évolution doit **refactorer** ces modules, jamais les dupliquer (#5).

## Anti-invention (#6) — la règle du placeholder
Aucune géométrie, cote ou surface n'est fabriquée ici : le GLB dérive **1:1** de
l'IFC source produit par l'agent BIM ; une conversion ne « corrige » ni n'estime
jamais une valeur. Toute donnée absente reste un **placeholder** côté faisabilité
(volet Ingénierie en `{{…}}` dans
`05_deliverables_mvp/faisabilite/generator/genlib/renderer.py`) tant que le modèle
réel n'a pas été publié. L'URL de viewer injectée dans la console est traçable
jusqu'au stream Speckle correspondant.

## Non-négociables (voir CLAUDE.md racine pour la liste complète)
- Gitea only (jamais GitHub)
- ERPNext natif en priorité absolue avant tout outil externe
- Score 4Big 95+/100 · standards 4 volets obligatoires (le viewer sert le volet Ingénierie)
- Zéro invention de chiffres — géométrie uniquement depuis l'IFC source
- **VPS pour tous projets** — le worker n'écrit jamais sur le serveur (#8)
- Vérifier · Investiguer · Valider · Confirmer

## Livrable attendu · roadmap
Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md`. Volet IFC/Speckle : **Sprint 3**
(« Améliorer `ifc_to_glb.py` + intégrer viewer 3D console »). Cible de sprint
mesurable : **P07 Aqua Terra** — faisabilité 4 volets auto-générée en **< 1h**, le
modèle publié sur `bim-cloud.otov7.com` et affiché dans le viewer console.

## Coordination inter-agents
- **BIM** : produit l'IFC source + partage `ifc_to_glb.py` et le serveur Speckle ;
  amont direct de cet agent.
- **Frontend Console** : intègre l'iframe viewer dans la console
  (`/choisir-mon-unite`) sous le rôle `OTO Faisabilité IFC Speckle`
  (Workspace `Has Role` déjà spécifié).
- **Faisabilité** : consomme le viewer pour le volet Ingénierie / la présentation
  des unités.
- **ERPNext Backend** : porteur du rôle RBAC `OTO Faisabilité IFC Speckle` et des
  permissions `File`/`Faisabilité` (import fixtures VPS).
- **QA** : maintient la row d'acceptation `S3` (viewer LIVE = critère VPS `out_of_scope`).

## Communication inter-agents
- Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
- Handoffs formalisés dans `05_deliverables_mvp/handoffs/`
- Blockers escalés à Michel Roy via WhatsApp +18296296385

## Éthique
- Sensibilité culturelle FR/EN/ES + RD
- Voix Amélie QC (multilingual_v2) pour toute interaction OTOIA
- Respect brand luxury dark+doré partout

## Ressources OTOV7 déjà en place (À RÉUTILISER, ne pas dupliquer)
Voir le fichier maître : `/opt/oto/claude_code_mandate_dtp/AGENTS_EXISTING_ASSETS.md` section 9 (IFC/Speckle Agent).

**Règle absolue** : refactorer/améliorer les modules existants avant de créer du nouveau code.