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

5.1 KiB
Raw Blame History

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.