docs(erp): recover and correct Grupo Tesela ERP architecture (v2)

Recover docs/erp-grupo-tesela/ARQUITECTURA.md (lost from main in the
upstream reset; restored from commit e8cd954) and correct it per the
design review:

- Automations (Make/Zapier) now go through the API/Edge Functions instead
  of writing directly to Postgres, preserving the single-source-of-truth.
- Re-prioritize phases for the construction/architecture/real-estate-
  development sector: Works/Projects and property sales become the core.
- Add Spanish tax handling (reverse-charge VAT, SII/Verifactu,
  certificaciones), a build-vs-buy decision for the accounting core
  (Holded/Odoo/Presto), an initial data model, security/RGPD/backups, and
  per-phase KPIs.
- Trim overlap (Make+Zapier, Airtable+Notion+Supabase), move Supermetrics
  to a later phase, replace generic inventory with per-work procurement,
  and flag that Coupler.io has no MCP connector here.

https://claude.ai/code/session_01W9xh1kJCqtHqBgBAMQikon

Author: claude

docs/erp-grupo-tesela/ARQUITECTURA.md

@@ -0,0 +1,274 @@
+# Arquitectura del ERP — Grupo Tesela
+
+> Documento vivo. **v2 — corregida** a partir del diseño inicial.
+> Sector: **construcción · arquitectura · promoción inmobiliaria** (en ese orden).
+> Stack basado en los conectores (MCP) disponibles en el entorno de trabajo.
+
+---
+
+## 0. Qué ha cambiado respecto a la v1 (registro de correcciones)
+
+Esta versión corrige los problemas detectados en la revisión del diseño inicial:
+
+- **Coherencia arquitectónica:** las automatizaciones (Make/Zapier) **ya no
+  escriben directamente a Postgres**; pasan por la API / Edge Functions de
+  Supabase, para no saltarse las reglas de negocio ni romper la "fuente única de
+  verdad". (En la v1 el diagrama conectaba Make/Zapier directos a la BD.)
+- **Priorización por sector:** **Obras/Proyectos y Promoción inmobiliaria pasan
+  a ser el núcleo (Fase 1-2)**, no módulos tardíos. En construcción/promoción el
+  negocio es el control de costes por obra y la comercialización de unidades.
+- **Fiscalidad española añadida:** IVA con **inversión del sujeto pasivo**
+  (ejecuciones de obra), retenciones, **SII / Verifactu**, certificaciones.
+- **Build-vs-buy explícito** para el núcleo Finanzas/Contabilidad (Holded/Odoo o
+  software de construcción tipo Presto vs desarrollo a medida).
+- **Recortes:** se marca el solapamiento Make+Zapier y Airtable+Notion+Supabase;
+  Supermetrics se mueve a fase tardía; el "Inventario/Almacén" genérico se
+  sustituye por "Aprovisionamiento y subcontratas por obra".
+- **Secciones nuevas:** modelo de datos inicial, seguridad/RGPD/backups, KPIs.
+- **Aviso de disponibilidad:** **Coupler.io no tiene conector MCP** en este
+  entorno hoy; su rol de ETL queda como "a confirmar / alternativa".
+
+> ⚠️ **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**.
+
+---
+
+## 1. Principios de diseño
+
+1. **Fuente única de verdad:** todos los datos del negocio viven en una base de
+   datos central (Supabase/Postgres). El resto de herramientas leen/escriben
+   **a través de la API**, nunca directamente a las tablas.
+2. **Modular y por fases:** cada área es un módulo activable de forma
+   independiente. No se construye todo de golpe.
+3. **Automatización orquestada:** las tareas repetitivas se automatizan **contra
+   la API**, no contra la BD ni a mano.
+4. **API-first:** todo expone API para conectarse con cualquier herramienta.
+5. **Coste escalado:** plan gratuito primero; premium cuando el módulo lo
+   justifique.
+6. **Cumplimiento desde el día 1:** RGPD, copias de seguridad y control de
+   accesos no son una fase posterior.
+
+---
+
+## 2. Stack elegido
+
+| 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. |
+| **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). |
+| **Diseño de interfaz** | **Figma** | Frontend del ERP y design-to-code. |
+| **CRM / Ventas** | **Attio** | Pipeline comercial. Para venta de inmuebles, evaluar CRM inmobiliario específico. |
+| **Vistas operativas ligeras** | **Airtable** | Solo donde Supabase+frontend aún no llegue (evitar duplicar la BD). |
+| **Documentación / Wiki** | **Notion** | Manual y procesos internos. |
+| **Ofimática y correo** | **Google Workspace** | Gmail + Calendar + Drive. |
+| **Reuniones** | **Zoom** | Grabaciones y resúmenes. |
+| **Gestión dev** | **Linear** | Roadmap del propio ERP. |
+| **Marketing (tardío)** | **Supermetrics** | Solo con inversión publicitaria seria (Fase 3). |
+| **ETL / BI** *(a confirmar)* | **Coupler.io** | Sin conector MCP aquí hoy; alternativa: Edge Functions + Supabase. |
+
+---
+
+## 3. Arquitectura por capas (corregida)
+
+```mermaid
+flowchart TB
+    subgraph PRES["🖥️ Presentación"]
+        UI["Frontend ERP (Figma→código)"]
+        AIR["Airtable (vistas operativas)"]
+        NOT["Notion (wiki)"]
+    end
+
+    subgraph APP["⚙️ Aplicación / Lógica"]
+        API["API REST/GraphQL (auto)"]
+        EF["Edge Functions (reglas de negocio)"]
+    end
+
+    subgraph DATA["🗄️ Datos — FUENTE ÚNICA DE VERDAD"]
+        PG[("Supabase PostgreSQL")]
+        ST["Storage (planos, facturas, licencias)"]
+        AUTH["Auth (usuarios y roles)"]
+    end
+
+    subgraph AUTO["🔄 Automatización"]
+        MAKE["Make.com"]
+        ZAP["Zapier (larga cola)"]
+    end
+
+    subgraph FIN["🧾 Núcleo fiscal/contable"]
+        HOLDED["Holded / Odoo / Presto"]
+    end
+
+    subgraph COLAB["👥 Colaboración"]
+        GW["Google Workspace"]
+        ZOOM["Zoom"]
+        ATT["Attio (CRM)"]
+    end
+
+    subgraph DEV["🛠️ Desarrollo"]
+        GH["GitHub"]
+        LIN["Linear"]
+    end
+
+    UI --> API
+    AIR --> API
+    NOT --> API
+    API --> EF
+    EF --> PG
+    EF --> ST
+    EF --> AUTH
+    %% Las automatizaciones pasan por la API, no por la BD directamente
+    MAKE --> API
+    ZAP --> API
+    HOLDED <--> API
+    ATT <--> MAKE
+    COLAB <--> MAKE
+    GH --> EF
+    LIN -.gestiona.-> GH
+```
+
+---
+
+## 4. Módulos del ERP (reordenados por sector)
+
+```mermaid
+flowchart LR
+    CORE[("Núcleo Supabase\nDatos + Auth")]
+    CORE --- M1["🏗️ Obras / Proyectos\n(núcleo)"]
+    CORE --- M2["🏠 Promoción y\nVentas inmobiliarias"]
+    CORE --- M3["💰 Finanzas analítica\npor obra + fiscal ES"]
+    CORE --- M4["🧱 Compras y\nsubcontratas"]
+    CORE --- M5["📁 Documentación\n(planos, licencias)"]
+    CORE --- M6["🤝 CRM (Attio)"]
+    CORE --- M7["📣 Marketing\n(tardío)"]
+    CORE --- M8["📈 BI / Reporting"]
+    CORE --- M9["👤 RRHH y Nóminas"]
+```
+
+| # | Módulo | Conectores | Fase |
+|---|--------|-----------|------|
+| 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** |
+| 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 |
+| 7 | Marketing | Supermetrics | Fase 3 |
+| 8 | BI y reporting | Supabase + (Coupler.io a confirmar) | Fase 3 |
+| 9 | RRHH y nóminas | Supabase + Google Workspace + gestoría | Fase 3 |
+
+---
+
+## 5. Hoja de ruta por fases (corregida)
+
+- **Fase 0 — Cimientos:** Supabase (BD + Auth + RLS) + GitHub + estructura de
+  datos central + diseño en Figma + **backups y política RGPD**.
+- **Fase 1 — Núcleo de obra:** Obras/Proyectos (costes por obra, certificaciones)
+  + Finanzas analítica + Documentación de proyecto + automatizaciones core.
+- **Fase 2 — Comercial y compras:** Promoción/ventas inmobiliarias + CRM +
+  Compras/subcontratas.
+- **Fase 3 — Avanzado:** Marketing (Supermetrics), BI/reporting, RRHH/nóminas.
+
+---
+
+## 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.
+
+---
+
+## 7. Modelo de datos inicial (esqueleto, a detallar)
+
+Entidades mínimas para arrancar Fase 0-1 (nombres orientativos):
+
+- `obras` (proyecto, cliente, presupuesto, fechas, estado)
+- `partidas` / `capitulos` (presupuesto por obra)
+- `certificaciones` (avance/facturación por obra)
+- `proveedores` y `subcontratas`
+- `pedidos_compra` (ligados a obra)
+- `promociones` y `unidades` (inmuebles: estado comercial, precio, reserva)
+- `clientes` / `contactos`
+- `documentos` (planos, licencias; referencia a Storage)
+- `usuarios` y `roles` (Auth + RLS)
+
+> Cada tabla con **Row Level Security** y acceso solo vía API/Edge Functions.
+
+---
+
+## 8. Seguridad y cumplimiento (nuevo)
+
+- **RGPD:** base legal del tratamiento, registro de actividades, derechos ARCO,
+  encargados de tratamiento (proveedores cloud) y DPA firmados.
+- **Backups:** copias automáticas de Supabase + retención definida + prueba de
+  restauración periódica.
+- **Accesos:** roles por módulo, principio de mínimo privilegio, RLS en todas las
+  tablas, 2FA en cuentas críticas.
+- **Entornos:** separación dev / producción.
+
+---
+
+## 9. KPIs por fase (nuevo)
+
+- **Fase 1:** % obras con presupuesto vs real al día; nº certificaciones
+  gestionadas; tiempo de cierre mensual.
+- **Fase 2:** unidades comercializadas; conversión de leads; plazo medio de
+  reserva→venta.
+- **Fase 3:** coste de adquisición de cliente; cuadros de mando en uso.
+
+---
+
+## 10. Plan de cuentas premium (qué pagar y cuándo)
+
+> Precios **aproximados** y orientativos por mes; confirmar en cada web.
+
+| Prioridad | Servicio | Plan | Coste aprox. | ¿Premium? |
+|-----------|----------|------|--------------|-----------|
+| 🔴 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). |
+| 🟠 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. |
+| 🟡 3 | **Coupler.io** | según volumen | ~49–99 $/mes | Solo si se confirma su uso (sin MCP aquí). |
+| 🟡 3 | **Notion / Figma** | Plus / Pro | ~10–15 $/usuario | Opcional. |
+| 🟢 4 | **GitHub / Linear** | Free→Team | 0 → ~4–8 $ | Gratis basta al inicio. |
+| 🟢 4 | **Zapier / Zoom** | Starter / Pro | ~14–30 $ | Solo si hacen falta. |
+
+### Inversión mínima para arrancar (Fase 0-1)
+**Supabase Pro + Make Core + Google Workspace** (+ núcleo fiscal si se compra) →
+del orden de **~40–50 €/mes** sin el ERP fiscal; con Holded/Odoo, sumar su plan.
+
+---
+
+## 11. Cómo se gestiona
+
+- Se conecta cada herramienta **por módulo y por fase**, no todas el día 1.
+- Cada servicio que requiera login se pide **solo al activarlo**.
+- Código y configuración versionados en **GitHub** (idealmente, repo propio del
+  ERP — ver aviso de §0).
+
+---
+
+## 12. Pendiente de confirmar
+
+- ✅ **Sector:** construcción · arquitectura · promoción inmobiliaria (resuelto).
+- **Decisión build-vs-buy** del núcleo fiscal (§6).
+- **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).