docs: guion de demo reescrito — recorrido general + sección por departamento

Actualiza acceso (dominio público HTTPS), embudo afluencia→cliente,
alta progresiva PROSPECTO→CLIENTE, columnas de obra/hitos/saldos/flujo,
y pendientes honestos vigentes

docs/GUION-DEMO.md

@@ -1,65 +1,135 @@
 # 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
+**Acceso:** https://frasa.consultoria-as.com (funciona desde cualquier red, con HTTPS)
+**Usuario demo:** `gladis valenzuela medina` (o cualquier vendedor) — **Contraseña inicial:** `Frasa2026`
+**Usuario administrador:** `admin` — misma contraseña inicial
 
-> Tip: abrir antes la landing y Monday (workspace Frasa-CAS) en dos pestañas.
+> Tip: abrir la landing y Monday (workspace **Frasa-CAS**) en dos pestañas.
+> El recorrido completo dura ~45 min. Para mostrar a un solo departamento,
+> usa la Parte 1 (5 min) + solo la sección de ese departamento (10–15 min).
 
 ---
 
-## 1. Portal de acceso (1 min)
+# Parte 1 — Recorrido general (para todos, 5 min)
 
-1. Entrar a http://192.168.10.123/
-2. Señalar las 5 tarjetas: **Cotizador · Alta de clientes · Cobranza · Tableros · Chat con Hermes**.
+1. Entrar a https://frasa.consultoria-as.com → la landing muestra los módulos:
+   **Cotizador · Alta de clientes · Cobranza · Tableros · Mi día · Chat IA**.
+2. Entrar a cualquier módulo → pantalla de acceso. **Sin login no se ve nada**
+   (requisito PLD: datos sensibles).
+3. Iniciar sesión. Señalar la barra superior con **nombre · rol**, botón para
+   **cambiar contraseña** y **Salir**.
+4. En la landing, bajar a **Configuración de cuenta**: cada usuario elige ahí su
+   usuario de Monday y queda vinculado (eso activa sus leads, actividades y
+   alertas personales).
 
-## 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**.
+# Parte 2 — Demo por departamento
 
-## 3. Cotizador multi-desarrollo — `/quote/` (6 min)
+## A. Ventas (vendedores, 15 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).
+**El embudo completo: Afluencia → Cita → Cotización → Aparto.**
 
-## 4. Alta de clientes — `/client/` (6 min)
+1. **Captura de afluencia** — dos caminos:
+   - `/hoy` → "Captura rápida de lead": nombre, teléfono, email, origen y
+     **desarrollo de interés**.
+   - `/client` → tarjeta **"Alta Afluencia"**: el mismo registro con forma
+     completa.
+2. **Mostrar en Monday (en vivo)**: en segundos aparece el lead en **Leads**
+   (asignado por round-robin) **y** su oportunidad en **Oportunidades** con
+   etapa **Afluencia**. Ya no se captura en papel ni en Excel.
+3. En `/hoy` → **Mi día**: el lead asignado con acciones rápidas. Marcar
+   **"Agenda cita"** → en Monday la oportunidad pasa sola a **Agendo Cita**.
+4. **Cotizador** `/quote/`:
+   - Selector de desarrollo con disponibles (DIAGONAL · ATELIER · ESTANZA ·
+     SENDA · SOLANA). Elegir DIAGONAL → unidad U-103.
+   - Toggle **con/sin acabados**, **apartado** ajustable (mínimo $20,000).
+   - Las **4 propuestas** y el **comparador** lado a lado. Cada desarrollo
+     calcula con las fórmulas de su propio Excel (mostrar que SENDA tiene
+     porcentajes distintos y ATELIER usa COFINAVIT).
+   - Capturar el cliente **con el mismo teléfono del lead** → **Generar PDF**
+     (vigencia, QR). En Monday: la **misma oportunidad** se actualiza con
+     unidad, precios y pasa a **Cotizador** — nunca se duplica.
+5. **Conversión a cliente**: si el cliente aparta en ese momento, desde la
+   pantalla de éxito de afluencia hay **"Pasar a Alta de Cliente"** (formulario
+   prellenado). Si es después: en `/client` → "Alta de Cliente" → buscar el lead
+   por nombre/teléfono y arranca prellenado.
+6. **Descarte**: si no compra, "Descartar" con motivo → la oportunidad pasa a
+   **Perdido** y el motivo queda en el catálogo **Motivos No Compra**.
 
-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.
+## B. Coordinador de ventas (10 min)
 
-## 5. Cobranza — `/pay/` (5 min)
+1. Tablero **Leads**: el round-robin asigna solo; leads sin contactar en 48 h
+   **escalan** al coordinador; leads inactivos 10 días reciben recordatorio
+   (diario 9 am).
+2. Tablero **Actividades**: la agenda diaria generada sola ("Contactar a…").
+3. Tablero **Oportunidades**: el embudo completo visible por etapa
+   (Afluencia → Agendo Cita → Cotizador → Aparto → Ganado/Perdido/Abandono),
+   filtrable por **Desarrollo**.
+4. **Motivos No Compra**: por qué se caen las ventas, acumulado para análisis.
 
-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`.
+## C. Administración y cobranza (12 min)
 
-## 6. Tableros — `/dash/` (4 min)
+1. **Alta de cliente progresiva** — `/client` → "Alta de Cliente":
+   - Al avanzar del paso 1, el **Contacto se crea en Monday como `PROSPECTO`**.
+   - Cada paso del wizard actualiza sus columnas (mostrar en Monday cómo se va
+     llenando: dirección, empleo…). Si cierran y retoman otro día, sigue sobre
+     el mismo contacto.
+   - Validación de CURP, co-acreditado condicional, carga de documentos con
+     **vista previa + OCR + checklist**, firma digital y **liga remota** para
+     que el cliente firme desde su celular.
+   - Al generar: Contacto pasa a **`CLIENTE`**, se crea el item en **Apartado**
+     (`Pago Apartado`, pipeline Enkontrol) y los **checkboxes de documentos**
+     se prenden solos al subir archivos. La oportunidad pasa a **Aparto**.
+2. **Cobranza** — `/pay/`:
+   - Planes de enganche diferido: al corriente, vencido con **mora
+     configurable**, parcial. **Filtros** y vista **"Cobranza del día"**.
+   - Registrar un **abono** → baja el saldo, recalcula mora.
+   - **Recibo de pago en PDF** y **notas** por plan.
+   - Recordatorios automáticos diarios (9:30 am) por pago próximo a vencer y
+     por vencidos; al **liquidar**, el Apartado en Monday pasa solo a
+     `X Escriturar`.
+3. Tablero **Saldos a Favor** en Monday: devoluciones pendientes de clientes
+   (Estanza/Sole), con monto y estado Pendiente/Devuelto.
 
-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**.
+## D. Escrituración (10 min)
 
-## 7. Chat con Hermes (agente IA) — `/ai/` (4 min)
+1. Tablero **Apartado**: pipeline Enkontrol (Pago Apartado → Alta Enkontrol →
+   Integración → … → Firma Cliente) con checkboxes CURP/RFC/Comprobante que se
+   prenden solos desde la app.
+2. Tablero **Unidades**: columna **Etapa** con el pipeline de 10 etapas
+   (Apartado → Reserva → Vendido → Integración → En Análisis → Autorizado →
+   Notaría → Escriturado → Entrega → PostVenta).
+   - Al llegar a **Vendido** → se genera sola la actividad "lista para
+     Escrituración" (**traspaso de departamento**).
+3. **Hitos documentales por unidad** (nuevas columnas): checkboxes
+   **Cert. Gas · TO / C4 · Régimen inscrito · Lista avalúo**, más
+   **Clave catastral** y **No. oficial** — el checklist real para escriturar.
+4. Columna **Venc. autorización**: fecha límite del crédito autorizado; con la
+   receta nativa (documentada) Monday avisa al coordinador 7 días antes de que
+   se venza — **alerta de venta por caer**.
+
+## E. SAC — entrega y postventa (5 min)
+
+1. Al llegar una unidad a **Escriturado** → se genera sola la actividad
+   "pasa a SAC" (**segundo traspaso de departamento**).
+2. Etapas **Entrega** y **PostVenta** cierran el ciclo de vida en el mismo
+   tablero Unidades; el historial queda en el item.
+
+## F. Dirección General y Obra (10 min)
+
+1. **Tableros** `/dash/`: KPIs (leads, oportunidades, disponibles, cartera
+   vencida), funnel, unidades por desarrollo/estatus, cobranza al corriente
+   vs. vencido.
+2. Tablero **Flujo Escrituras** (Monday): escrituras e **ingreso cobrado** por
+   proyecto y semana, mayo–agosto 2026 (ago: 13 escrituras / $11.87M). Con un
+   dashboard nativo de Monday se grafica sin pedir el Excel.
+3. Tablero **Unidades** (vista de obra): **% Avance obra**, **Contratista**,
+   **Fecha entrega obra** y **Meses atraso** por unidad — cargado del reporte
+   de estatus. Filtrar "Meses atraso > 0" = lista de riesgo de incumplimiento.
+4. Tablero **Saldos a Favor**: devoluciones por entregar.
+
+## G. Agente IA (todos, 5 min) — `/ai/`
 
 Preguntas sugeridas (responde con datos reales y cita fuentes):
 
@@ -67,25 +137,24 @@ Preguntas sugeridas (responde con datos reales y cita fuentes):
 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?"*
+5. *"Cotiza la unidad U-103"* (hace la cotización con datos en vivo de Monday).
 
-## 8. Monday — automatizaciones (4 min)
+---
 
-En el workspace **Frasa-CAS**:
+# Cierre — números para mencionar
 
-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).
+- **288 unidades** de 5 desarrollos, sincronizadas con el maestro de Enkontrol.
 - 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`.
+- **670+ pruebas automatizadas**; código en
+  `git.consultoria-as.com/consultoria-as/FRASA-CAS`.
+- Todo el embudo (Afluencia → PostVenta) queda registrado en Monday sin
+  capturas duplicadas.
 
-## Pendientes por mencionar (honestidad = confianza)
+# 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.
+- WhatsApp/WA CRM es fase futura (falta la cuenta de Meta Business).
+- SOLE y MUTUO aún no están en el inventario del sistema (están en cierre);
+  su obra/atribución se puede cargar si se agregan.
+- Las contraseñas iniciales deben cambiarse al primer ingreso.
+- Recomendado activar Cloudflare Access (código por correo) como segunda capa
+  de acceso.