Files
FRASA-CAS/docs/GUION-DEMO.md

172 lines
8.9 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
**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 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).
---
# Parte 1 — Recorrido general (para todos, 5 min)
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).
---
# Parte 2 — Demo por departamento
## A. Ventas (vendedores, 15 min)
**El embudo completo: Afluencia → Cita → Cotización → Aparto.**
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"**: captura completa del perfil —
al elegir el desarrollo, "Departamento o casa de interés" muestra **los
modelos de ese desarrollo**; más estado civil, tipo de empleo, rango
salarial, crédito, tipo de economía, califica y "lo quiere para"
(alimenta las gráficas de perfilamiento de `/dash`).
2. **Mostrar en Monday (en vivo)**: en segundos aparece la afluencia en
**Oportunidades** con etapa **Afluencia**, todo el perfil en columnas y
**asignada a quien la capturó** (o al round-robin si no tiene Monday
vinculado). Un solo registro, sin duplicados. 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**.
Más abajo: **Mis capturas de afluencia** (lo que YO di de alta, con su
estado actual) y **Mis clientes** (altas que inicié, *En captura* /
*Cliente*).
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**.
## B. Coordinador de ventas (10 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.
## C. Administración y cobranza (12 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.
## D. Escrituración (10 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, y **Perfilamiento de la afluencia**: 11 gráficas (estado
civil, rango salarial MXN/USD, edad, empleo, economía, califica, crédito,
desarrollo, modelo, medio de contacto) alimentadas con cada captura — ya
incluye el **historial de agosto** importado (98 leads).
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):
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?"*
5. *"Cotiza la unidad U-103"* (hace la cotización con datos en vivo de Monday).
---
# Cierre — números para mencionar
- **288 unidades** de 5 desarrollos, sincronizadas con el maestro de Enkontrol.
- Cálculos **validados al centavo** contra los cotizadores Excel del cliente.
- **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)
- 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.