From 122c4d61023972fb8ec54071cf0435306638efa7 Mon Sep 17 00:00:00 2001 From: Consult AS Technology Date: Mon, 24 Aug 2026 05:18:47 +0000 Subject: [PATCH] docs: documento de entrega 2026-08-24 --- docs/ENTREGA-2026-08-24.md | 83 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 83 insertions(+) create mode 100644 docs/ENTREGA-2026-08-24.md diff --git a/docs/ENTREGA-2026-08-24.md b/docs/ENTREGA-2026-08-24.md new file mode 100644 index 0000000..86bb5c9 --- /dev/null +++ b/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.