docs: roles, Clientes, Contactos y mejoras de Mi dia en guia y guion

docs/GUIA-FLUJO-COMPLETO.md

@@ -41,6 +41,22 @@ duplicados.
 Sin ese paso las apps funcionan, pero "Mis leads", "Mis actividades" y las
 asignaciones automáticas no saben quién eres dentro de Monday.
 
+## Roles y qué módulos ve cada uno
+
+La landing solo muestra los módulos de tu rol (y cada app pide su sesión):
+
+| Rol | Módulos |
+|---|---|
+| **Vendedor** | Mi día · Alta de clientes · Alta afluencia · Cotizador · Mi tablero · Contactos · Chat Hermes |
+| **Administración de Venta** | Lo del vendedor + **Clientes** (cobranza) |
+| **Escrituración** | Igual que Administración de Venta |
+| **Director Ventas** | Lo de Administración de Venta + **Tablero comercial** |
+| **Dirección General** | Mi día · Tablero comercial · Clientes · Chat Hermes |
+| **Administradores** | Todo |
+
+El rol lo asigna un administrador. Todos los módulos tienen botón **← Menú**
+para regresar a la landing.
+
 ---
 
 ## 1. Ventas (vendedores)
@@ -56,8 +72,7 @@ Dos caminos de entrada, cada uno a su tablero:
   **Leads** (Estado *Nuevo*; asignado a ti si capturas con sesión
   vinculada, si no al round-robin del equipo VENDEDORES).
 - **Alta Afluencia** en `/client` (captura completa del perfil) → tablero
-  **Oportunidades** (Estado *Afluencia*, misma regla de asignación).
-- **Alta Afluencia** en `/client` — captura completa del perfil:
+  **Oportunidades** (Estado *Afluencia*, misma regla de asignación):
   - Nombre y teléfono (los únicos 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…).
@@ -67,24 +82,30 @@ Dos caminos de entrada, cada uno a su tablero:
     fijo; el resto texto libre).
   - Si el teléfono ya existe, el sistema avisa y no duplica.
 
-Todo esto aterriza en columnas del tablero **Oportunidades** y alimenta las
-gráficas de perfilamiento de `/dash`. (El tablero Leads queda como archivo
-histórico: el alta de clientes puede buscar en ambos.)
+El perfil aterriza en columnas del tablero **Oportunidades** y alimenta las
+gráficas de perfilamiento de `/dash`. El tablero **Leads** sigue activo para
+la captura rápida y la manual desde Monday.
 
 ### 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:
+- **Mis leads**: leads y oportunidades asignados (con insignia de origen), con
+  acciones de un toque y, en cada tarjeta, el **último cambio** (qué se hizo,
+  quién y cuándo, leído del historial de Monday):
   - **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**.
+  - **Descartar** (categoría + comentario) → pasa a *Perdido* / *Descartado* y
+    el motivo se registra en el tablero **Motivos No Compra**, en el grupo de
+    su categoría (Timing, Cliente, Competencia, Financiamiento, Ubicación,
+    Producto o Precio).
 - **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ó.
+  wizard va a medias, *Cliente* cuando se completó, y el **estado actual del
+  Apartado leído de Monday** (Pago Apartado, Alta Enkontrol…): si lo mueven en
+  Monday, la app lo refleja.
 
 ### 1.3 Cotización (`/quote`)
 
@@ -140,14 +161,15 @@ retomar otro día sobre el mismo contacto:
 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
+   **Apartado** (pipeline Enkontrol, etapa *Pago Apartado*, con ficha
+   completa: contacto, precios, vendedor y forma de pago), los checkboxes de
    documentos se prenden solos y la oportunidad pasa a **Aparto**.
 
 ---
 
-## 4. Cobranza
+## 4. Clientes (cobranza)
 
-**App:** `/pay`
+**App:** `/pay` — el módulo se llama **Clientes** en el menú
 
 - **Planes de pago** (enganche diferido): al corriente, parcial, vencido con
   **mora configurable**. Filtros por estado y vista **"Cobranza del día"**.
@@ -159,6 +181,11 @@ retomar otro día sobre el mismo contacto:
 - Tablero **Saldos a Favor** (Monday): devoluciones pendientes con monto y
   estado.
 
+## 4.1 Contactos
+
+Desde la landing, tarjeta **Contactos**: directorio del tablero Contactos de
+Monday (nombre, estado, teléfono, email), de solo lectura.
+
 ---
 
 ## 5. Escrituración
@@ -215,9 +242,9 @@ Monday:
 
 ---
 
-## 8. Agente IA (todas las áreas)
+## 8. Chat Hermes — agente IA (según rol)
 
-**App:** `/ai` (también enlazado desde la landing)
+**App:** `/ai` (módulo "Chat Hermes" en el menú) (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,

docs/GUION-DEMO.md

@@ -13,12 +13,16 @@
 # 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**.
+   **Cotizador · Alta de clientes · Clientes (cobranza) · Contactos ·
+   Tableros · Mi día · Chat Hermes**.
 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
+   **cambiar contraseña**, **← Menú** para volver a la landing y **Salir**.
+4. **Roles**: la landing solo muestra los módulos del rol del usuario
+   (vendedor, administración de venta, director de ventas, escrituración,
+   dirección general, administradores). Cambiar de rol cambia lo que ve.
+5. 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).
 
@@ -43,11 +47,13 @@
    **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*).
+3. En `/hoy` → **Mi día**: leads y oportunidades asignados con insignia de
+   origen, acciones rápidas y, en cada tarjeta, el **último cambio** (qué,
+   quién, cuándo — leído del historial de Monday). Marcar **"Agenda cita"** →
+   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* + el estado del Apartado en
+   vivo desde Monday).
 4. **Cotizador** `/quote/`:
    - Selector de desarrollo con disponibles (DIAGONAL · ATELIER · ESTANZA ·
      SENDA · SOLANA). Elegir DIAGONAL → unidad U-103.
@@ -62,8 +68,11 @@
    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**.
+6. **Descarte**: si no compra, "Descartar" eligiendo la **categoría** (Timing,
+   Cliente, Competencia, Financiamiento, Ubicación, Producto o Precio) → pasa a
+   **Perdido/Descartado** y el motivo se registra en el tablero **Motivos No
+   Compra**, dentro del **grupo de su categoría** (mostrar el tablero: cada
+   descarte cae agrupado en su causa).
 
 ## B. Coordinador de ventas (10 min)
 
@@ -76,7 +85,7 @@
    filtrable por **Desarrollo**.
 4. **Motivos No Compra**: por qué se caen las ventas, acumulado para análisis.
 
-## C. Administración y cobranza (12 min)
+## C. Administración y Clientes/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`**.
@@ -89,7 +98,7 @@
    - 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/`:
+2. **Clientes (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.