diff --git a/docs/GUION-DEMO.md b/docs/GUION-DEMO.md index 68d05eb..a1d9065 100644 --- a/docs/GUION-DEMO.md +++ b/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.