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)

Monto de apartado: ¿$20,000 o $50,000? (los cotizadores usan 20,000; el inventario de DIAGONAL mencionaba 50,000).
Lista de vendedores para el round-robin (hoy rota entre todos los usuarios del workspace, incluidas cuentas administrativas).
Cuotas de mantenimiento de ATELIER, ESTANZA y SOLANA (en los Excel figuran "PENDIENTE").
Confirmar inventarios al día: ATELIER tiene solo 4 disponibles y SOLANA 3 según los archivos recibidos.
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.

5.6 KiB Raw Blame History