docs: guion de demostración para el cliente

docs/GUION-DEMO.md

@@ -0,0 +1,88 @@
+# 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").
+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 con 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.