Files
FRASA-CAS/docs/GUION-DEMO.md
Consult AS Technology ccd4ca78ca feat(alta): guardado progresivo por etapa con réplica a Monday
- 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
2026-09-01 21:03:47 +00:00

92 lines
5.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.