docs: guia operativa del flujo completo por area

Nueva GUIA-FLUJO-COMPLETO.md (mapa del embudo + paso a paso para
Ventas, Coordinacion, Administracion, Cobranza, Escrituracion, SAC,
DG/Obra y Agente IA, con tabla de que se ve en Monday en cada momento).
GUION-DEMO actualizado con captura completa de afluencia, Mis capturas,
Mis clientes y perfilamiento.

docs/GUIA-FLUJO-COMPLETO.md

@@ -0,0 +1,250 @@
+# Guía operativa — Flujo completo del ecosistema Frasa
+
+**Acceso:** https://frasa.consultoria-as.com (HTTPS, funciona desde cualquier red)
+**Contraseña inicial:** `Frasa2026` (cámbiala al primer ingreso, botón "Cambiar contraseña")
+**Monday:** workspace **Frasa-CAS** — todo lo que pasa en las apps queda reflejado ahí.
+
+> Esta guía describe el flujo operativo completo, área por área. Para el guion
+> de demostración en vivo usa `GUION-DEMO.md`; para el detalle técnico de las
+> automatizaciones, `AUTOMATIZACIONES-MONDAY.md`.
+
+---
+
+## Mapa general del flujo
+
+```
+AFLUENCIA            CITA              COTIZACIÓN         APARTO / ALTA
+─────────────        ──────────        ──────────────     ─────────────────────
+/client o /hoy  →    /hoy (acción   →  /quote (4          →  /client (wizard por
+captura + perfil     "Agenda cita")    propuestas + PDF)     pasos + documentos
+     │                    │                  │                     │
+     ▼                    ▼                  ▼                     ▼
+Monday: Leads      Oportunidad:        Oportunidad:         Contacto CLIENTE +
+(NUEVO, asignado   "Agendo Cita"       "Cotizador"          Apartado (pipeline)
+por round-robin)                                                │
++ Oportunidad                                                   ▼
+"Afluencia"                              COBRANZA → ESCRITURACIÓN → SAC
+                                         /pay (planes,   Unidades: etapas
+                                          recibos, mora)  Vendido→…→PostVenta
+```
+
+Regla de oro: **cada persona se captura UNA sola vez**. El sistema reconoce el
+teléfono y actualiza el mismo lead/oportunidad en cada etapa en vez de crear
+duplicados.
+
+## Prerrequisito para todos: vincular tu usuario de Monday
+
+1. Entra a la landing https://frasa.consultoria-as.com e inicia sesión abajo,
+   en **Configuración de cuenta**.
+2. Elige tu usuario de Monday en el selector y guarda.
+
+Sin ese paso las apps funcionan, pero "Mis leads", "Mis actividades" y las
+asignaciones automáticas no saben quién eres dentro de Monday.
+
+---
+
+## 1. Ventas (vendedores)
+
+**Apps:** `/hoy` (Mi día) · `/client` (Alta Afluencia) · `/quote` (Cotizador)
+
+### 1.1 Captura de afluencia (entrada al embudo)
+
+Dos caminos, ambos crean lo mismo: lead en **Leads** (estado NUEVO, asignado
+por round-robin) + oportunidad en etapa **Afluencia**:
+
+- **Captura rápida** en `/hoy` (lo mínimo: nombre, teléfono, origen, desarrollo).
+- **Alta Afluencia** en `/client` — captura completa del perfil:
+  - Nombre* y teléfono* (obligatorios), correo.
+  - **Desarrollo de interés** → al elegirlo, "Departamento o casa de interés"
+    se habilita con **los modelos de ese desarrollo** (ej. DIAGONAL → 1R, 2RA…).
+  - Medio de contacto, ¿cómo se enteró?, edad, **estado civil**, **tipo de
+    empleo**, ocupación, rango salarial, crédito, **tipo de economía**,
+    **califica**, "lo quiere para" y notas (los cuatro en negrita con catálogo
+    fijo; el resto texto libre).
+  - Si el teléfono ya existe, el sistema avisa y no duplica.
+
+Todo esto aterriza en columnas del tablero **Leads** y alimenta las gráficas de
+perfilamiento de `/dash`.
+
+### 1.2 Tu panel diario (`/hoy`)
+
+- **KPIs**: leads asignados, actividades de hoy, apartados por vencer, leads
+  nuevos de la semana.
+- **Mis actividades**: agenda del día (la generan las automatizaciones).
+- **Mis leads**: leads asignados con acciones de un toque:
+  - **Contactado / Intento** → actualiza el estado en Monday.
+  - **Agenda cita** (+ fecha) → la oportunidad pasa sola a *Agendo Cita*.
+  - **Descartar** (motivo + comentario) → la oportunidad pasa a *Perdido* y el
+    motivo se acumula en el catálogo **Motivos No Compra**.
+- **Mis capturas de afluencia**: historial de los leads que TÚ diste de alta,
+  con su estado actual (aunque el round-robin los haya asignado a otro).
+- **Mis clientes**: los clientes cuyo alta iniciaste — chip *En captura* si el
+  wizard va a medias, *Cliente* cuando se completó.
+
+### 1.3 Cotización (`/quote`)
+
+1. Selecciona desarrollo (con disponibilidad) y unidad.
+2. Ajusta acabados, descuento y apartado (mínimo $20,000, puede ser mayor).
+3. El sistema calcula las **4 propuestas** (bancario, Infonavit/cofinavit,
+   contado, semi-contado) **con las fórmulas del Excel de cada desarrollo** y
+   las muestra en el comparador lado a lado.
+4. Captura nombre y teléfono del cliente — **si usas el mismo teléfono del
+   lead, su oportunidad se actualiza** (unidad, precios, etapa *Cotizador*)
+   en vez de duplicarse.
+5. Genera el **PDF** (con vigencia y QR) y entégalo.
+
+### 1.4 Conversión a cliente
+
+- En el momento: tras registrar la afluencia, botón **"Pasar a Alta de
+  Cliente"** (wizard prellenado).
+- Después: `/client` → "Alta de Cliente" → busca el lead por nombre o teléfono
+  y arranca prellenado.
+- El alta la termina ventas o administración según el proceso (ver sección 3).
+
+---
+
+## 2. Coordinación de ventas
+
+**Apps:** `/hoy` (vista de equipo) · `/dash` · Monday
+
+- **Round-robin automático**: cada lead nuevo se asigna solo y en orden.
+- **Escalamiento**: lead sin contactar en 48 h se escala al coordinador; lead
+  inactivo 10 días genera recordatorio (cron diario 9 am).
+- **Tablero Actividades** (Monday): agenda generada sola ("Contactar a…").
+- **Tablero Oportunidades**: embudo completo por etapa, filtrable por
+  desarrollo.
+- **`/hoy` con rol coordinador/admin**: sección **Equipo** — leads por vendedor,
+  nuevos de la semana y nuevos sin asignar.
+- **Motivos No Compra**: causas de caída acumuladas para análisis.
+
+---
+
+## 3. Administración (alta de clientes)
+
+**App:** `/client` → "Alta de Cliente" (wizard por etapas)
+
+El wizard guarda y sincroniza con Monday **en cada paso** — se puede cerrar y
+retomar otro día sobre el mismo contacto:
+
+1. **Paso 1 (datos generales)**: al avanzar, el **Contacto se crea en Monday
+   como `PROSPECTO`**. Validación de CURP y datos cruzados.
+2. **Pasos siguientes**: domicilio, empleo, económicos, co-acreditado
+   (condicional), referencias, vivienda/crédito. Cada avance actualiza las
+   columnas del Contacto.
+3. **Documentos**: carga con vista previa, **OCR** y checklist del expediente.
+4. **Firma**: digital en pantalla o **liga remota** para que el cliente firme
+   desde su celular.
+5. **Generar**: el Contacto pasa a **`CLIENTE`**, se crea el item en el tablero
+   **Apartado** (pipeline Enkontrol, etapa *Pago Apartado*), los checkboxes de
+   documentos se prenden solos y la oportunidad pasa a **Aparto**.
+
+---
+
+## 4. Cobranza
+
+**App:** `/pay`
+
+- **Planes de pago** (enganche diferido): al corriente, parcial, vencido con
+  **mora configurable**. Filtros por estado y vista **"Cobranza del día"**.
+- **Registrar abono**: baja el saldo y recalcula la mora al momento.
+- **Recibo de pago en PDF** por abono y **notas** por plan.
+- **Automatizaciones** (cron diario 9:30 am): actividades de recordatorio por
+  pagos próximos a vencer y vencidos (visibles en Monday y en `/hoy`).
+- Al **liquidar** el plan, el Apartado en Monday pasa solo a *X Escriturar*.
+- Tablero **Saldos a Favor** (Monday): devoluciones pendientes con monto y
+  estado.
+
+---
+
+## 5. Escrituración
+
+**Monday:** tableros **Apartado** y **Unidades**
+
+- **Apartado** sigue el pipeline Enkontrol (Pago Apartado → Alta Enkontrol →
+  Integración → … → Firma Cliente); los checkboxes CURP/RFC/Comprobante se
+  prenden solos cuando administración sube documentos desde la app.
+- **Unidades**, columna **Etapa** — las 10 etapas oficiales:
+  Apartado → Reserva → **Vendido** → Integración → En Análisis → Autorizado →
+  Notaría → **Escriturado** → Entrega → PostVenta.
+  - **Vendido** = traspaso de Ventas a Escrituración: se genera sola la
+    actividad "lista para Escrituración".
+  - **Escriturado** = traspaso a SAC: se genera la actividad "pasa a SAC".
+- **Checklist documental por unidad**: Cert. Gas, TO / C4, Régimen inscrito,
+  Lista avalúo, Clave catastral, No. oficial.
+- **Venc. autorización**: fecha límite del crédito; con la receta nativa de
+  Monday (documentada en `AUTOMATIZACIONES-MONDAY.md`) avisa 7 días antes.
+
+---
+
+## 6. SAC (entrega y postventa)
+
+- Recibe el traspaso automático cuando la unidad llega a **Escriturado**.
+- Etapas **Entrega** y **PostVenta** cierran el ciclo de vida en el tablero
+  Unidades; todo el historial queda en el item.
+- Carpeta **Postventa** en Monday: tablero **Comunicación** para el seguimiento
+  con el cliente ya entregado.
+
+---
+
+## 7. Dirección General y Obra
+
+**App:** `/dash` · **Monday:** Unidades, Flujo Escrituras, Saldos a Favor
+
+`/dash` (tableros):
+- KPIs: leads, oportunidades activas, unidades disponibles, cartera vencida.
+- **Funnel comercial**: Leads → Oportunidades → Aparto o más → Ganado.
+- Unidades por desarrollo/estatus y por etapa del pipeline.
+- Cobranza: al corriente vs. vencido, monto vencido.
+- **Perfilamiento de la afluencia** (11 gráficas): estado civil, rango salarial
+  (rangos MXN/USD), edad, tipo de empleo, tipo de economía, califica, crédito,
+  desarrollo, modelo de interés, medio de contacto y "lo quiere para".
+  Se alimenta sola de cada afluencia capturada; ya incluye el **historial de
+  agosto** (98 registros importados).
+
+Monday:
+- **Unidades** (vista obra): % Avance, Contratista, Fecha entrega obra, Meses
+  atraso. Filtro "Meses atraso > 0" = lista de riesgo.
+- **Flujo Escrituras**: escrituras e ingreso cobrado por proyecto y semana
+  (mayo–agosto 2026).
+- **Saldos a Favor**: devoluciones por entregar.
+
+---
+
+## 8. Agente IA (todas las áreas)
+
+**App:** `/ai` (también enlazado desde la landing)
+
+Chat interno que responde con los documentos cargados de Frasa y cita fuentes:
+precios y modelos por desarrollo, reglas de negocio (apartado mínimo,
+vigencias), requisitos de crédito y checklist de expediente. Puede cotizar una
+unidad con datos en vivo de Monday ("Cotiza la unidad U-103").
+
+---
+
+## Anexos
+
+### Qué pasa en Monday en cada momento (resumen)
+
+| Momento | Dónde se ve en Monday |
+|---|---|
+| Captura de afluencia | Leads (NUEVO, asignado) + Oportunidades (Afluencia) |
+| Se agenda cita | Oportunidad → Agendo Cita |
+| Se cotiza | Oportunidad → Cotizador (con unidad y precios) |
+| Alta iniciada | Contactos (PROSPECTO), columnas llenándose por paso |
+| Alta completada | Contactos (CLIENTE) + Apartado (Pago Apartado) |
+| Descarte | Oportunidad → Perdido + Motivos No Compra |
+| Abono / liquidación | Cobranza local en `/pay`; al liquidar, Apartado → X Escriturar |
+| Unidad vendida | Unidades.Etapa → Vendido (+ actividad de traspaso) |
+| Escrituración | Unidades.Etapa → …→ Escriturado (+ actividad a SAC) |
+| Entrega | Unidades.Etapa → Entrega / PostVenta |
+
+### Notas y pendientes conocidos
+
+- El historial de agosto se importó al tablero Leads con su fecha original;
+  sus vendedores quedaron anotados en Notas (no asignados en la columna
+  Vendedor).
+- WhatsApp / WA CRM es fase futura (falta la cuenta de Meta Business).
+- SOLÉ y MUTUO no tienen inventario en el sistema (sus cotizaciones siguen en
+  Excel); el historial de SOLÉ sí está en Leads.
+- Recomendado: activar Cloudflare Access (código por correo) como segunda capa;
+  las ligas públicas de firma deben quedar fuera de esa política.

docs/GUION-DEMO.md

@@ -33,13 +33,19 @@
 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.
+   - `/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 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**.
+   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.
@@ -120,7 +126,10 @@
 
 1. **Tableros** `/dash/`: KPIs (leads, oportunidades, disponibles, cartera
    vencida), funnel, unidades por desarrollo/estatus, cobranza al corriente
-   vs. vencido.
+   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.