[DTP-Worker] Sprint 8 · buffer L75 · Doc agent Frontend Console (stub→doc réelle · 2 générateurs sourcés : 5 Workspaces v15 Sprint 4 L49 + 5 Custom Block chat OTOIA Sprint 6 L63 · ERPNext natif #1 · anti-invention endpoint/module null · 50 tests verts)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

03_agents/frontend_console/AGENT.md

@@ -1,17 +1,106 @@
-# Frontend Console Agent · Helios Luxury
+# 🖥️ Frontend Console Agent · Helios Luxury (score 95+/100)
+
+**Rôle** : Cet agent matérialise la **console unifiée** de la plateforme sous forme
+d'**artefacts ERPNext natifs** (#1) — pas de framework de dashboard externe. Il
+livre les **portails de landing par rôle** (DocType `Workspace` v15) et le
+**montage de l'assistant OTOIA** dans chaque portail (DocType `Custom Block` v15).
+Chaque sortie est **déterministe, diffable et dérivée d'un contrat en-repo** :
+aucun lien, rôle, langue ni chiffre n'est fabriqué.
 
 ## Scope
-Console dark+doré uniformisée, 5 portails RBAC, dashboards entités
+5 portails rôle métier (Ventes / Construction / Achat / Compta / Direction) ·
+chat OTOIA (persona Amélie QC) embarqué par portail · thème luxury dark+doré
+(#4) · redesign `/choisir-mon-unite` (spec attribuée).
+
+## Principe directeur : ERPNext natif d'abord, hand-off VPS ensuite (#1, #8)
+Contrainte #1 « **ERPNext natif = priorité absolue avant tout outil externe** » :
+dans ERPNext v15, **le portail de landing par rôle EST le DocType `Workspace`** et
+**un bloc de contenu réutilisable EST le DocType `Custom Block`**. On ne fabrique
+donc aucun dashboard maison — on génère des **fixtures Frappe** prêtes à importer.
+L'application réelle (`bench migrate`), l'insertion dans le `content` des Workspaces,
+le câblage de l'endpoint OTOIA et l'application du thème desk restent côté **VPS**
+(agent ERPNext Backend / Frontend) — le worker n'écrit **jamais** sur le serveur.
+
+## Livrables réellement produits (`05_deliverables_mvp/frontend/`)
+
+| Module | Volet roadmap | Sortie | Métrique vérifiée |
+|---|---|---|---|
+| `portails/` | Sprint 4 (L49) — « 5 portails rôle » | `out/workspace.json` | **5 `Workspace` natifs v15** (`OTO Ventes` 4 cartes/11 liens/12 rôles · `OTO Construction` 4/9/10 · `OTO Achat` 3/8/5 · `OTO Compta` 4/11/8 · `OTO Direction` 4/14/9) |
+| `chat_otoia/` | Sprint 6 (L63) — « Chat OTOIA embedded » | `out/{custom_block,chat_mount}.json` | **5 `Custom Block` + 5 configs runtime** (persona Amélie QC · langues FR/EN/ES · `endpoint: null`) |
+
+- **Portails** : CLI `python3 workspaces_gen.py build|validate` · **12 invariants** ·
+  **19 tests** · job CI `frontend-portails-tests` (gated).
+- **Chat OTOIA** : CLI `python3 chat_otoia_gen.py build|validate` · **14 invariants** ·
+  **31 tests** · job CI `chat-otoia-tests` (gated).
+
+## Source de vérité unique (zéro invention · #6)
+La matière première est le **contrat RBAC** `05_deliverables_mvp/rbac/rbac_50_roles.json`,
+**jamais la spec de mise en page** :
+
+- **Aucun lien / raccourci inventé** : tout DocType visé par une carte ou un bloc
+  doit figurer dans les `permissions_cibles` du portail — le portail a donc
+  *prouvablement* le droit dessus. Couverture **exhaustive et bijective** : chaque
+  DocType autorisé apparaît dans **exactement une** carte (aucun oubli, aucun doublon).
+- **Rôles** dérivés du contrat, triés — **mêmes rôles** que le `Role Profile` du
+  portail ; un invariant vérifie leur synchronisation avec les Has Role des Workspaces.
+- **5 portails métier exacts** : la console technique `plateforme` (6ᵉ portail RBAC)
+  est **exclue** (invariant d'égalité stricte avec `portails_business` du contrat).
+- **`knowledge_scope`** du chat = **surface RBAC exacte** du portail — ancrage de
+  sécurité : l'assistant ne peut ni prétendre ni exposer un DocType hors périmètre.
+- **`endpoint` OTOIA** et **`Workspace.module`** laissés à **`null` · `a_confirmer`**
+  — jamais fabriqués (#6/#8).
+- **Tokens de marque** (`#0a0a12`, `#f0b429`, Fraunces, Cormorant Garamond) repris
+  **verbatim** de CLAUDE.md #4, chacun avec sa `source`.
+- **Langues** FR/EN/ES + défaut lues dans `../seo/seo_spec.json · site.langs`
+  (source unique · pas de re-déclaration).
+
+Génération **refusée** si un invariant casse (anti-régression) ; sortie
+déterministe (tri stable, zéro horodatage) → re-générable en CI.
+
+## Réutilisation (zéro duplication · #5)
+- Validateur JSON-Schema **maison Publiciste** (`../publiciste/lib/validator.py`)
+  + tokens de marque (`lib/branding.py`) — aucune dépendance pip sur le runner Gitea.
+- Le builder du chat **réutilise** le builder RBAC↔Workspaces des portails
+  (`portails/wslib/builder.py`) — même source de vérité, pas de réimplémentation.
+- Rôles / DocTypes **dérivés du contrat RBAC** — même source que les générateurs
+  RBAC (`fixtures_gen`, `userperm_gen`, `roleprofile_gen`).
 
 ## Non-négociables (voir CLAUDE.md racine pour la liste complète)
+- **ERPNext natif en priorité absolue** — Workspace / Custom Block, jamais un
+  dashboard externe (#1)
 - Gitea only (jamais GitHub)
-- ERPNext natif en priorité
 - Score 4Big 95+/100
-- Zéro invention chiffres
+- Zéro invention de chiffres — tout lien/rôle/langue est dérivé d'un contrat sourcé
+- **VPS pour tous projets** — le worker n'écrit jamais sur le serveur (#8)
+- Design luxury dark+doré `#0a0a12` + `#f0b429` (Fraunces + Cormorant Garamond) (#4)
 - Vérifier · Investiguer · Valider · Confirmer
 
-## Livrable attendu semaines 1-8
-Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.
+## Livrable attendu · roadmap
+Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md`. Volets Frontend Console :
+**Sprint 2** (L36 — clone `/waf-home` sur 5 entités), **Sprint 4** (L49 — 5 portails
+rôle) et **Sprint 7** (L67 — polish final). Le chat OTOIA (L63) est attribué roadmap
+à **ERPNext Backend** mais implémenté dans l'arbre `frontend/` car il étend
+directement le montage des Workspaces (réutilisation `wslib`) — coordination.
+
+## Hand-off → agent ERPNext Backend / Frontend (VPS · #8)
+1. Fixer `Workspace.module` au module de l'app OTO à l'import (le worker ne fabrique
+   pas de nom d'app).
+2. Créer les **DocTypes custom** avant import (sinon liens morts) : `CONFOTUR
+   Application`, `Faisabilité`, `Publiciste Log` — les autres sont natifs v15.
+3. Déposer les fixtures dans `fixtures/` puis `bench migrate` ; insérer chaque
+   `Custom Block` dans le `content` du `Workspace` (payload editor.js `a_confirmer`).
+4. Renseigner l'**endpoint OTOIA** + charger le web-component et appliquer les
+   tokens dark+doré (#4) via la couche thème desk.
+
+## Coordination inter-agents
+- **RBAC / ERPNext Backend** : fournit `rbac_50_roles.json` (source unique des rôles
+  et permissions) — même contrat que les `Role Profile`.
+- **Publiciste** : valideur + lexique/branding réutilisés (anti-duplication · #5).
+- **SEO** : fournit `seo_spec.json · site.langs` (langues du chat) et reçoit le
+  bundle SEO à injecter dans les pages `www/` (VPS #8).
+- **IFC/Speckle + CRM** : co-destinataires du redesign `/choisir-mon-unite`.
+- **QA** : les suites `frontend-portails-tests` et `chat-otoia-tests` sont agrégées
+  aux gates de régression et d'acceptation (découverte CI).
 
 ## Communication inter-agents
 - Rapports quotidiens dans `05_deliverables_mvp/daily_reports/`
@@ -23,10 +112,11 @@ Voir `04_roadmap/ROADMAP_8_WEEKS_OR_LESS.md` pour deliverables par sprint.
 - Voix Amélie QC (multilingual_v2) pour toute interaction OTOIA
 - Respect brand luxury dark+doré partout
 
+## Spec spécifique attribuée
+- `05_deliverables_mvp/specs/CHOISIR_MON_UNITE_SPEC.md` · redesign complet page
+  `/choisir-mon-unite` (coordination avec IFC/Speckle + CRM agents)
+
 ## 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 correspondante à cet agent.
 
 **Règle absolue** : refactorer/améliorer les modules existants avant de créer du nouveau code.
-
-## Spec spécifique attribuée
-- `05_deliverables_mvp/specs/CHOISIR_MON_UNITE_SPEC.md` · redesign complet page /choisir-mon-unite (coordination avec IFC/Speckle + CRM agents)