84 lines
5.6 KiB
Markdown
84 lines
5.6 KiB
Markdown
# 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.
|