docs(erp): reconcile architecture with live Holded reality (v3)

Per the cross-session coordination note (Drive), reconcile the ERP
architecture with operational reality:

- Holded is LIVE and the canonical source of finance/accounting; it is no
  longer a pending build-vs-buy decision. Supabase stays as the bespoke
  operational layer and must not become a second ledger.
- Record the single cost/margin rules: cost by Holded projectid (not tags),
  exclude confirming, own labor = direct cost, one margin calculation;
  reference validation against the Palmeres work.
- One canonical Holded integration (direct API); any Make/Zapier bridge is
  automation-only, never a second source of truth.
- Note governance (Drive = memory, Cerebro repo = code) and the pending key
  rotation for previously-exposed Holded credentials.

https://claude.ai/code/session_01W9xh1kJCqtHqBgBAMQikon

Author: claude

docs/erp-grupo-tesela/ARQUITECTURA.md

@@ -1,6 +1,6 @@
 # Arquitectura del ERP — Grupo Tesela
 
-> Documento vivo. **v2 — corregida** a partir del diseño inicial.
+> Documento vivo. **v3 — reconciliada** con la realidad operativa (Holded en vivo).
 > Sector: **construcción · arquitectura · promoción inmobiliaria** (en ese orden).
 > Stack basado en los conectores (MCP) disponibles en el entorno de trabajo.
 
@@ -28,9 +28,29 @@ Esta versión corrige los problemas detectados en la revisión del diseño inici
 - **Aviso de disponibilidad:** **Coupler.io no tiene conector MCP** en este
   entorno hoy; su rol de ETL queda como "a confirmar / alternativa".
 
+### Reconciliación v3 (realidad operativa)
+
+Según la coordinación entre sesiones (`COORDINACION_SESIONES_HOLDED_2026-06-19`):
+
+- **Holded ya está EN VIVO** y es la **fuente canónica** de finanzas/contabilidad.
+  Deja de ser una decisión "build-vs-buy" pendiente: **está decidido y operativo**.
+  No se reimplementa contabilidad a medida.
+- **Una sola integración de Holded canónica = la API directa en vivo.** Cualquier
+  puente de automatización (p. ej. Holded↔Make) es **opcional y solo para
+  automatizar** (sync/alertas), **nunca** una segunda fuente de verdad.
+- **Reglas comunes de coste/margen** (única forma de calcular): coste imputado por
+  **`projectid`** (no por tags), **excluir confirming**, **mano de obra propia =
+  coste directo**, y **un único cálculo de margen** (nada de dos pipelines).
+- **Gobierno de la información:** **Drive = memoria** (notas/estado entre sesiones),
+  **repo "Cerebro" = código**. Evitar duplicados (índices/carpetas repetidos).
+
 > ⚠️ **Riesgo de ubicación:** este documento vive en un *fork* de
 > `github-mcp-server`. Una sincronización con el upstream lo borra (ya pasó). Lo
-> antes posible debería moverse a un **repositorio propio del ERP**.
+> antes posible debería moverse a un **repositorio propio del ERP** (¿el "Cerebro"?).
+>
+> 🔒 **Seguridad pendiente:** la nota menciona claves de Holded *expuestas* que
+> debían rotarse. Confirmar **rotación** y que viven solo en secretos/`.env`,
+> nunca en Drive ni en el repo.
 
 ---
 
@@ -56,7 +76,7 @@ Esta versión corrige los problemas detectados en la revisión del diseño inici
 | Capa | Herramienta | Notas |
 |------|-------------|-------|
 | **Núcleo de datos / Backend** | **Supabase** | Postgres + Auth + API + Storage + Edge Functions. El corazón. |
-| **Núcleo fiscal/contable** *(decisión pendiente)* | **Holded / Odoo** *(o Presto para obra)* | Ver §6 build-vs-buy. Evita reinventar contabilidad y fiscalidad ES. |
+| **Núcleo fiscal/contable** *(EN VIVO · canónico)* | **Holded** | Ya operativo y fuente única de finanzas. Integración por **API directa**. Ver §6. |
 | **Código y CI/CD** | **GitHub** | Repos, ramas, PRs, despliegues. |
 | **Automatización principal** | **Make.com** | Orquestador de flujos contra la API. |
 | **Automatización secundaria** | **Zapier** | Solo "larga cola" que Make no cubra (evitar solape con Make). |
@@ -98,8 +118,8 @@ flowchart TB
         ZAP["Zapier (larga cola)"]
     end
 
-    subgraph FIN["🧾 Núcleo fiscal/contable"]
-        HOLDED["Holded / Odoo / Presto"]
+    subgraph FIN["🧾 Núcleo fiscal/contable (EN VIVO)"]
+        HOLDED["Holded (canónico, API directa)"]
     end
 
     subgraph COLAB["👥 Colaboración"]
@@ -152,7 +172,7 @@ flowchart LR
 |---|--------|-----------|------|
 | 1 | **Obras / Proyectos** (presupuesto vs real, certificaciones, planificación) | Supabase + Linear/Airtable + Make | **Fase 1** |
 | 2 | **Promoción y ventas inmobiliarias** (promociones, unidades, reservas/arras, estado comercial) | Supabase + Attio/CRM inmobiliario + Make | **Fase 2** |
-| 3 | **Finanzas analítica por obra + fiscalidad ES** | Holded/Odoo + Supabase + Make | **Fase 1** |
+| 3 | **Finanzas analítica por obra + fiscalidad ES** | **Holded (en vivo)** + Supabase | **Fase 1** |
 | 4 | **Compras y subcontratas** (aprovisionamiento por obra) | Supabase + Gmail + Make | Fase 2 |
 | 5 | **Documentación de proyecto** (planos, licencias, CAD/BIM) | Drive + Notion + Supabase Storage | **Fase 1** |
 | 6 | CRM comercial | Attio + Supabase | Fase 2 |
@@ -174,21 +194,33 @@ flowchart LR
 
 ---
 
-## 6. Decisión clave: build-vs-buy del núcleo fiscal/contable
-
-En construcción/promoción la contabilidad es **analítica por obra** y la
-fiscalidad ES es exigente (IVA con **inversión del sujeto pasivo** en ejecuciones
-de obra, retenciones, **SII/Verifactu**, certificaciones). Reimplementar esto a
-medida sobre Supabase+Make es caro y arriesgado.
-
-| Opción | Pros | Contras |
-|--------|------|---------|
-| **Comprar (Holded / Odoo)** | Contabilidad y fiscalidad ES resueltas; rápido | Menos a medida; integrar vía API con el núcleo Supabase |
-| **Software de obra (Presto/Arquímedes)** | Presupuestos y certificaciones potentes | No es ERP completo; hay que integrarlo |
-| **A medida (Supabase)** | Control total y datos unificados | Mucho desarrollo; riesgo fiscal/legal |
-
-**Recomendación:** comprar el núcleo fiscal/contable (Holded u Odoo) e integrarlo
-por API con Supabase como fuente única; construir a medida solo Obras/Promoción.
+## 6. Núcleo fiscal/contable: DECIDIDO → Holded en vivo
+
+> **Decisión tomada (no pendiente).** Holded ya está **operativo** y es la
+> **fuente canónica** de finanzas/contabilidad. No se reimplementa a medida.
+
+Motivo (sigue vigente): en construcción/promoción la contabilidad es
+**analítica por obra** y la fiscalidad ES es exigente (IVA con **inversión del
+sujeto pasivo** en ejecuciones de obra, retenciones, **SII/Verifactu**,
+certificaciones). Holded lo resuelve sin reinventarlo.
+
+**Cómo encaja:**
+- **Holded = sistema de registro fiscal/contable** (canónico), integrado por
+  **API directa**.
+- **Supabase** = capa operativa del ERP a medida (Obras, Promoción, Compras,
+  Documentación) y, donde haga falta, espejo analítico para BI — **leyendo de
+  Holded, sin convertirse en segunda contabilidad**.
+- **Automatización (Make/Zapier)** = opcional, solo para sync/alertas contra la
+  API; **nunca** una segunda fuente ni un segundo cálculo.
+
+### Reglas de coste y margen (únicas y comunes)
+Para que haya **un solo número** por obra (sin pipelines divergentes):
+- Coste imputado por **`projectid`** de Holded (**no** por tags).
+- **Excluir confirming** del cómputo de coste.
+- **Mano de obra propia = coste directo** de la obra.
+- **Un único cálculo de margen** (venta − coste) por obra.
+- Validación de referencia: cuadrar cifras con la obra **Palmeres**
+  (venta ≈ 1.385.494, compras ≈ 1.257.796).
 
 ---
 
@@ -241,7 +273,7 @@ Entidades mínimas para arrancar Fase 0-1 (nombres orientativos):
 | 🔴 1 (ya) | **Supabase** | Pro | ~25 $/mes | SÍ. Es el núcleo. |
 | 🔴 1 (ya) | **Make.com** | Core/Pro | ~9–16 $/mes | SÍ. Motor de automatización. |
 | 🔴 1 (ya) | **Google Workspace** | Business Starter | ~6–7 €/usuario | SÍ. Correo + Drive. |
-| 🔴 1 (ya) | **Núcleo fiscal (Holded/Odoo)** | según módulos | ~consultar | SÍ, si se opta por comprar (§6). |
+| 🔴 1 (ya) | **Holded** (núcleo fiscal, EN VIVO) | según módulos | ~consultar | SÍ. Ya en uso, es la fuente canónica (§6). |
 | 🟠 2 | **Attio** | Plus/Pro | ~29 $/usuario | Al arrancar lo comercial. |
 | 🟠 2 | **Airtable** | Team | ~20 $/usuario | Solo si hay vistas operativas. |
 | 🟡 3 | **Supermetrics** | según fuentes | ~100–200+ €/mes | Solo con inversión publicitaria. |
@@ -268,7 +300,10 @@ del orden de **~40–50 €/mes** sin el ERP fiscal; con Holded/Odoo, sumar su p
 ## 12. Pendiente de confirmar
 
 - ✅ **Sector:** construcción · arquitectura · promoción inmobiliaria (resuelto).
-- **Decisión build-vs-buy** del núcleo fiscal (§6).
+- ✅ **Núcleo fiscal:** Holded en vivo, canónico (resuelto — §6).
+- **Confirmar la fuente canónica única de Holded** (API directa en vivo) y dejar
+  el puente Make solo para automatización, o cancelarlo si no aporta.
+- 🔒 **Rotación de claves de Holded** (las expuestas) y dónde viven (secretos/`.env`).
 - **Nº de usuarios** previstos (para dimensionar planes por usuario).
 - **Software actual** del que migrar datos (contabilidad, presupuestos de obra).
-- **Repo propio** del ERP (sacarlo del fork de github-mcp-server).
+- **Repo propio** del ERP / "Cerebro" (sacarlo del fork de github-mcp-server).