docs: documento de entrega 2026-08-24

docs/ENTREGA-2026-08-24.md

@@ -0,0 +1,83 @@
+# Entrega — 24 de agosto de 2026
+
+**Cliente:** Frasa Desarrollos S.A.P.I. de C.V.
+**Consultoría:** Consult (AS) Technology
+**Alcance:** Avance de implementación del ecosistema CRM + Apps Web (Fases 0, 1, 3, 4, 5 y 7 de la guía técnica v1.0)
+
+---
+
+## 1. Componentes entregados y operativos
+
+Acceso general (red interna): **http://192.168.10.123/** (landing con acceso a todos los módulos)
+
+| Módulo | URL | Estado |
+|---|---|---|
+| Landing / portal de acceso | http://192.168.10.123/ | ✅ Operativo |
+| Cotizador financiero | http://192.168.10.123/quote/ | ✅ Operativo |
+| Alta de clientes | http://192.168.10.123/client/ | ✅ Operativo |
+| Cobranza | http://192.168.10.123/pay/ | ✅ Operativo |
+| Chat con Hermes (agente IA) | http://192.168.10.123/ai/ | ✅ Operativo |
+| API Gateway | http://192.168.10.123/api/health | ✅ Operativo |
+
+Repositorio: `git.consultoria-as.com/consultoria-as/FRASA-CAS` (rama `main`, historial completo de cambios).
+
+## 2. Detalle por fase
+
+### Fase 0 — Fundamentos ✅
+- 9 tableros en Monday (workspace **Frasa-CAS**): Contactos, Desarrollos, Unidades, Leads, Oportunidades, Apartado, Ventas, Motivos No Compra y Actividades.
+- Estructura alineada al vocabulario del CRM real de Frasa (funnels, pipeline Enkontrol, perfil demográfico).
+- Inventario importado: **285 unidades** de los 5 desarrollos (DIAGONAL 38, ATELIER 34, ESTANZA 64, SENDA 139, SOLANA 10) con precios, superficies y status reales extraídos de los cotizadores Excel del cliente.
+- Catálogo maestro de Desarrollos con precio desde/hasta, m² y fechas de entrega calculados del inventario.
+
+### Fase 1 — Automatizaciones ✅
+- **Round-robin** de asignación de vendedor a leads nuevos (polling cada 5 min; webhook listo para cuando haya dominio/SSL público).
+- **Recordatorio de inactividad**: leads con +10 días sin movimiento generan aviso (cron diario 9:00 am).
+- **Actividades automáticas** en Monday: "Contactar a {lead}" al asignar; "Retomar contacto con {lead}" al detectar inactividad.
+- Panel de estado: `GET /api/automatizaciones/estado`.
+
+### Fase 3 — Cotizador financiero ✅
+- **Multi-desarrollo**: cada desarrollo calcula con las fórmulas de su propio Excel (validadas al centavo contra los archivos originales; 53 tests).
+- Selector de desarrollo y de unidad con búsqueda; solo unidades DISPONIBLEs.
+- Comparador de las 4 propuestas (ATELIER usa COFINAVIT en lugar de INFONAVIT, como en su Excel), vigencia de cotización y generación de PDF.
+- Las cotizaciones guardadas crean la Oportunidad en Monday en etapa "Cotizador".
+
+### Fase 4 — Alta de clientes ✅
+- Formulario completo (datos, domicilio, empleo, económicos, co-acreditado, referencias, vivienda, crédito).
+- Validación de CURP y datos cruzados, OCR de documentos, checklist de expediente, vista previa, firma digital y PDFs.
+- Integración Monday: crea Contacto + Apartado en "Pago Apartado" y **prende los checkboxes de documentos** (CURP/RFC/Comprobante) al subirlos; mapea perfil demográfico.
+
+### Fase 5 — Cobranza ✅
+- Planes de enganche en mensualidades, registro de abonos, mora configurable, filtros, vista "cobranza del día", recibo de pago en PDF y notas por plan.
+- Al liquidarse un plan, el Apartado en Monday pasa automáticamente a **"X Escriturar"**.
+
+### Fase 7 — Agente IA ✅
+- Chat interno con RAG sobre la base de conocimiento: catálogos de los 5 desarrollos, fórmulas de las 4 propuestas, requisitos de crédito, proceso de venta y apartado, FAQ y aviso de privacidad (10 documentos indexados).
+- Responde citando fuentes; base ampliable vía API (`POST /api/ai/documents`).
+
+### Calidad ✅
+- **172 tests automatizados** verdes (cotizador 53, alta 55, cobranza 61, landing 4, API 119 — solapamiento de suites incluido).
+- Cálculos de cotización con fixtures numéricos tomados de los Excel del cliente, al centavo.
+
+## 3. Fuera del alcance de esta entrega
+
+- **Fase 2 — WhatsApp / WA CRM**: fase futura según la guía; no iniciada.
+- **Fase 6 — Reportes**: dashboards nativos de Monday (se configuran en la UI de Monday).
+- **Login y roles**: las apps operan en red interna sin autenticación; JWT planificado como siguiente frente.
+- **SSL / dominio público**: `frasadesarrollos.ddns.net` aún no apunta al servidor; sin HTTPS los webhooks de Monday quedan en espera (el polling cubre la función).
+- **PostgreSQL**: el API corre en SQLite; migración planificada antes de producción.
+
+## 4. Datos requeridos del cliente (bloquean decisiones)
+
+1. **Monto de apartado**: ¿$20,000 o $50,000? (los cotizadores usan 20,000; el inventario de DIAGONAL mencionaba 50,000).
+2. **Lista de vendedores** para el round-robin (hoy rota entre todos los usuarios del workspace, incluidas cuentas administrativas).
+3. **Cuotas de mantenimiento** de ATELIER, ESTANZA y SOLANA (en los Excel figuran "PENDIENTE").
+4. **Confirmar inventarios al día**: ATELIER tiene solo 4 disponibles y SOLANA 3 según los archivos recibidos.
+5. **Ajustes manuales en Monday** (la API no los permite):
+   - Board *Actividades*: agregar columna de relación hacia *Leads* (Conectar tableros).
+   - Board *Leads*: quitar el valor por defecto `DESCARTADO` de la columna Estado.
+
+## 5. Observaciones técnicas
+
+- El cotizador Excel de SOLANA llegó con una falla de claves (`5` vs `'5A'` → `#N/A`); en el sistema ya está normalizado, pero el archivo fuente del cliente sigue roto.
+- Los Excel de ATELIER, ESTANZA y SENDA contienen hojas ocultas residuales de otro desarrollo (CÉNTRICO, en USD); se ignoraron deliberadamente.
+- Los archivos fuente contenían datos personales de clientes y asesores; **no se copiaron** al sistema ni a la base de conocimiento del agente IA.