From b8f9742ff78483b7a68e9ba2ca293e4adb6a9696 Mon Sep 17 00:00:00 2001 From: Consult AS Technology Date: Wed, 2 Sep 2026 05:31:14 +0000 Subject: [PATCH] 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 | 250 ++++++++++++++++++++++++++++++++++++ docs/GUION-DEMO.md | 15 ++- 2 files changed, 262 insertions(+), 3 deletions(-) create mode 100644 docs/GUIA-FLUJO-COMPLETO.md diff --git a/docs/GUIA-FLUJO-COMPLETO.md b/docs/GUIA-FLUJO-COMPLETO.md new file mode 100644 index 0000000..b0d8d9b --- /dev/null +++ b/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. diff --git a/docs/GUION-DEMO.md b/docs/GUION-DEMO.md index a1d9065..334d7d8 100644 --- a/docs/GUION-DEMO.md +++ b/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.