# 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.