From a555f69dcdf122e53cf420823b1c3e4390b9a11c Mon Sep 17 00:00:00 2001 From: Consult AS Technology Date: Fri, 4 Sep 2026 09:20:16 +0000 Subject: [PATCH] docs: roles, Clientes, Contactos y mejoras de Mi dia en guia y guion --- docs/GUIA-FLUJO-COMPLETO.md | 55 +++++++++++++++++++++++++++---------- docs/GUION-DEMO.md | 33 ++++++++++++++-------- 2 files changed, 62 insertions(+), 26 deletions(-) diff --git a/docs/GUIA-FLUJO-COMPLETO.md b/docs/GUIA-FLUJO-COMPLETO.md index 6473376..738c570 100644 --- a/docs/GUIA-FLUJO-COMPLETO.md +++ b/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, diff --git a/docs/GUION-DEMO.md b/docs/GUION-DEMO.md index a07fea7..6cfb9c2 100644 --- a/docs/GUION-DEMO.md +++ b/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.