- Al avanzar cada paso del wizard: upsert silencioso del borrador local + sync a Monday (iniciar → Contacto en PROSPECTO; pasos siguientes → PATCH con los campos mapeables: datos generales, dirección armada, actividad económica) - Al completar: Contacto pasa a CLIENTE + Apartado + funnel (dedup) - progresoId viaja con el borrador (se restaura solo); fallos de sync no bloquean el avance (aviso ámbar no bloqueante); submit final con fallback al endpoint legado si nunca hubo sync - API: POST /clientes/progreso/iniciar, PATCH /clientes/progreso/:id, POST /clientes/progreso/:id/completar; POST /clientes legado intacto - Tests: API 338 (+16), alta-clientes 112 (+4); smoke en vivo verificado (PROSPECTO → patch → CLIENTE + Apartado) y limpiado
92 lines
5.1 KiB
Markdown
92 lines
5.1 KiB
Markdown
# Guion de demostración — Ecosistema Frasa
|
||
|
||
**Duración estimada:** 25–30 minutos
|
||
**Acceso:** http://192.168.10.123/ (red interna)
|
||
**Usuario demo:** `gladis valenzuela medina` (o cualquier vendedor de la lista) — **Contraseña:** `Frasa2026`
|
||
**Usuario administrador:** `admin` — misma contraseña
|
||
|
||
> Tip: abrir antes la landing y Monday (workspace Frasa-CAS) en dos pestañas.
|
||
|
||
---
|
||
|
||
## 1. Portal de acceso (1 min)
|
||
|
||
1. Entrar a http://192.168.10.123/
|
||
2. Señalar las 5 tarjetas: **Cotizador · Alta de clientes · Cobranza · Tableros · Chat con Hermes**.
|
||
|
||
## 2. Login (2 min)
|
||
|
||
1. Entrar a cualquier módulo → aparece la pantalla de acceso.
|
||
2. Mostrar que **sin login no se ve nada** (es requisito PLD: datos sensibles).
|
||
3. Entrar con el usuario demo. Señalar la barra superior con **nombre · rol** y botón **Salir**.
|
||
|
||
## 3. Cotizador multi-desarrollo — `/quote/` (6 min)
|
||
|
||
1. Mostrar el **selector de desarrollo** con conteo de disponibles (DIAGONAL · ATELIER · ESTANZA · SENDA · SOLANA).
|
||
2. Elegir **DIAGONAL** → unidad **U-103** (1R, $3,269,000 con acabados).
|
||
- Mostrar el toggle **con/sin acabados** y cómo cambia el precio.
|
||
- Ajustar el **apartado** a $50,000 (mínimo $20,000) → el enganche baja, el total no cambia.
|
||
- Recorrer las **4 propuestas** (Bancario / Infonavit / Contado / Semi-contado) y el **comparador**.
|
||
- **Generar PDF** y abrirlo: encabezado con desarrollo, desglose, vigencia.
|
||
3. Cambiar a **SENDA** → cualquier casa disponible → señalar que los porcentajes son distintos (enganche bancario 5%, semi-contado 50/45/5) porque **cada desarrollo calcula con las fórmulas de su propio Excel**.
|
||
4. Cambiar a **ATELIER** → mostrar que ahí la 3ª propuesta es **COFINAVIT** (no Infonavit) y que no hay toggle de acabados (precio único).
|
||
|
||
## 4. Alta de clientes — `/client/` (6 min)
|
||
|
||
1. Iniciar un alta de prueba (usar datos ficticios, ej. "Cliente Demo").
|
||
- El alta se guarda **etapa por etapa**: al avanzar del primer paso se crea el
|
||
**Contacto en Monday con Estado `PROSPECTO`** y cada paso actualiza sus
|
||
columnas (se puede mostrar en Monday cómo va llenándose).
|
||
2. Mostrar: **validación de CURP** (escribir una mal formada → error), secciones del formulario, co-acreditado condicional.
|
||
3. Subir un PDF cualquiera como documento → mostrar **OCR**, **vista previa** y el **checklist** del expediente.
|
||
4. **Firma digital** en pantalla.
|
||
5. Guardar → ir a Monday y mostrar:
|
||
- El **Contacto** (creado como `PROSPECTO` al avanzar del paso 1) ahora con Estado `CLIENTE` y su perfil demográfico.
|
||
- El item en **Apartado** con estado `Pago Apartado` y el **checkbox del documento** ya prendido.
|
||
|
||
## 5. Cobranza — `/pay/` (5 min)
|
||
|
||
1. Mostrar los 3 planes demo: al corriente, vencido con mora, parcial.
|
||
2. **Filtros** y vista **"Cobranza del día"**.
|
||
3. Registrar un **abono** en el plan vencido → baja el saldo, se recalcula la mora.
|
||
4. Generar el **recibo de pago en PDF**.
|
||
5. Agregar una **nota** al plan.
|
||
6. Mencionar: cuando un plan se **liquida**, el Apartado en Monday pasa solo a `X Escriturar`.
|
||
|
||
## 6. Tableros — `/dash/` (4 min)
|
||
|
||
1. KPIs: leads, oportunidades activas, unidades disponibles por desarrollo, cartera vencida.
|
||
2. Gráficas: **unidades por desarrollo/estatus**, **funnel** leads→oportunidades→ganado, **cobranza** al corriente vs vencido.
|
||
3. Botón **Actualizar**.
|
||
|
||
## 7. Chat con Hermes (agente IA) — `/ai/` (4 min)
|
||
|
||
Preguntas sugeridas (responde con datos reales y cita fuentes):
|
||
|
||
1. *"¿Qué modelos hay en DIAGONAL y cuánto cuestan?"*
|
||
2. *"¿Cómo se calcula la propuesta semi-contado en SENDA?"*
|
||
3. *"¿Cuál es el apartado mínimo y qué pasa si el cliente no formaliza?"*
|
||
4. *"¿Qué documentos necesito para el expediente del cliente?"*
|
||
|
||
## 8. Monday — automatizaciones (4 min)
|
||
|
||
En el workspace **Frasa-CAS**:
|
||
|
||
1. **Leads**: crear un lead nuevo en vivo → en ~5 min aparece con **vendedor asignado** (round-robin) y en **Actividades** aparece "Contactar a {nombre}" para mañana.
|
||
2. Mostrar tablero **Actividades** (la lista de tareas diaria del vendedor) y **Motivos No Compra**.
|
||
3. Mostrar el pipeline del tablero **Apartado** (Enkontrol: Pago Apartado → Alta Enkontrol → … → Firma Cliente) con los checkboxes de documentos.
|
||
4. Mencionar: leads inactivos 10 días reciben recordatorio automático (diario 9 am); leads sin contactar 48 h escalan al coordinador; oportunidad en `Aparto`/`Ganado` crea sola el Apartado/Venta.
|
||
|
||
## Cierre — números para mencionar
|
||
|
||
- **285 unidades** de 5 desarrollos, sincronizadas con el reporte maestro de Enkontrol (16 correcciones de estatus aplicadas).
|
||
- Cálculos **validados al centavo** contra los cotizadores Excel del cliente.
|
||
- **370+ pruebas automatizadas**; código en `git.consultoria-as.com/consultoria-as/FRASA-CAS`.
|
||
|
||
## Pendientes por mencionar (honestidad = confianza)
|
||
|
||
- WhatsApp/WA CRM es fase futura (guía).
|
||
- Dashboards nativos de Monday: recetas listas para activar (documento entregado).
|
||
- Falta dominio/SSL público → por eso es IP interna; con el DNS apuntando se activa HTTPS y webhooks instantáneos.
|
||
- Los vendedores aún no tienen cuenta en Monday → el round-robin los asignará cuando los inviten.
|