Documentación

    Documentación completa de casos de uso y arquitectura de flujos

    Roles del Sistema (8)

    Super Admin
    Branch Manager
    Gerente
    Gerente de Oficina
    Team Leader
    Analista
    Knocker
    Técnico

    Módulos y Casos de Uso

    1. Autenticación y Onboarding
    4 casos

    Registro de GerenteLanding → Formulario → Código verificación → Crear equipo → Dashboard
    Registro por InvitaciónCódigo invitación → Validar → Formulario → Asignar equipo + rol
    Login / LogoutAutenticación con email y contraseña
    Recuperar contraseñaFlujo de reset por email

    2. CRM y Ventas
    9 casos

    Captura de LeadsManual, Knocker, CSV, Webhook Facebook Ads
    Funnel de Ventas10 etapas: Prospectos → Sin Respuesta → Seguimiento → Agendados → Negociación → Ventas → Pre-instalado → Instalado → Fidelización → Plan de referidos
    Gestión de ContactosCRUD, historial, búsqueda
    Calendario / CitasAgendar, editar, cancelar citas con leads
    Rutas de VentaPlanificación de rutas, optimización, historial
    Knocker (D2D)Mapa interactivo, registro de visitas puerta a puerta, resultados
    Copilot / Coach IAAcciones sugeridas por IA, priorización de leads
    Biblioteca de ObjecionesTécnicas de cierre basadas en Brian Tracy
    CotizadorGeneración de cotizaciones con productos y paquetes

    3. Análisis de Agua
    3 casos

    Captura de análisisFormulario de parámetros de agua del cliente
    Generación de PDFReporte automático con resultados y diagnóstico IA
    Historial de análisisLista de análisis realizados con filtros

    4. Técnicos e Instalaciones
    8 casos

    Gestión de técnicosAlta, edición, fotos de perfil
    Órdenes de servicioCreación, asignación y seguimiento
    Rutas de técnicosPlanificación y optimización de recorridos
    Hoja de entregaFormulario con fotos y firma digital
    InventarioGestión de productos y equipos
    Calendario de servicioAgenda de instalaciones programadas
    DisponibilidadBoard visual de disponibilidad
    Vista móvil técnicoDashboard simplificado para campo

    5. Finanzas Personales
    8 casos

    Diario financieroRegistro de transacciones diarias
    Dashboard financieroPresupuesto y patrimonio neto
    Registro de millasTracking de viajes y kilometraje
    Coach financiero IAAnálisis inteligente con Gemini
    Psicología del dineroEmociones de gasto, días sin gastar, retos de ahorro
    Estimado de impuestosCalculadora fiscal automática
    Avances de comisiónAdelanto sobre comisiones futuras
    CategoríasConfiguración de categorías financieras personalizadas

    6. Equipo y RRHH
    5 casos

    Gestión de equipoInvitación por código, asignación de roles y metas
    ComisionesNiveles configurables, cálculo automático, historial
    Códigos de invitaciónGeneración y gestión de códigos con roles predefinidos
    RRHH (Branch Manager)Vista general de recursos humanos multi-equipo
    BienestarMódulo de bienestar: hábitos, gratitud, áreas de vida

    7. Comunicaciones
    3 casos

    Mensajes masivosSMS y WhatsApp vía Twilio
    Mensajes rápidosEnvío individual desde perfil del lead
    TemplatesGestión de plantillas de mensajes reutilizables

    8. Herramientas
    4 casos

    OCRExtracción de datos de imágenes con IA
    Tarjeta DigitalQR con perfil público compartible
    Reels GeneratorGenerador de contenido para redes sociales
    Analytics / MétricasReportes y dashboards de rendimiento

    9. Administración (BM / Super Admin)
    6 casos

    Panel Branch ManagerDashboard multi-equipo con vista general
    Energía (Solar/Eólico)Cotizador solar, análisis eólico, comparativo
    Costos APIMonitoreo de consumo y costos de servicios
    Config submódulosActivar/desactivar módulos por rol
    SuscripcionesGestión de planes con Stripe
    Atención al usuarioSoporte, tickets y webhooks

    10. Plan de referidos
    2 casos

    Portal de referidosAcceso exclusivo para clientes fidelizados
    Landing del Plan de referidosPágina pública del programa de fidelización

    Diagramas de Flujo

    Arquitectura General

    ┌─────────────────────────────────────────────────────────────┐ │ LANDING / AUTH │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ Landing │→ │ Registro │→ │ Login │ │ │ └──────────┘ └──────────┘ └──────────┘ │ │ │ │ │ ┌───────┴───────┐ │ │ │ Código Invit. │ │ │ └───────────────┘ │ └──────────────────────┬──────────────────────────────────────┘ ▼ ┌─────────────────────────────────────────────────────────────┐ │ DASHBOARD CENTRAL │ │ (según rol: BM, Gerente, TL, etc.) │ └──┬────────┬────────┬────────┬────────┬────────┬─────────────┘ ▼ ▼ ▼ ▼ ▼ ▼ ┌──────┐┌──────┐┌──────┐┌──────┐┌──────┐┌──────────┐ │ CRM ││FINAN ││EQUIPO││TECNI ││HERRA ││COMUNICA │ │ ││ ││ ││ ││ ││ │ │Leads ││Diario││Roles ││Orden ││OCR ││SMS/WA │ │Funnel││Coach ││Comis ││Rutas ││QR ││Templates │ │Citas ││Taxes ││RRHH ││Inven ││Reels ││Masivos │ │Rutas ││Psico ││Metas ││Firma ││Cotiz ││ │ │Cotiz ││Avance││ ││Fotos ││Analy ││ │ └──────┘└──────┘└──────┘└──────┘└──────┘└──────────┘

    Flujo CRM Detallado

    FLUJO CRM DETALLADO: Captura Lead ──→ PROSPECTOS ──→ SIN RESPUESTA ──→ SEGUIMIENTO │ │ ▼ ▼ AGENDADOS ──→ NEGOCIACION ──→ VENTAS │ ┌─────────────┤ ▼ ▼ PREINSTALADO Comisiones │ ▼ INSTALADO │ ▼ FIDELIZACION │ ▼ Plan de referidos

    🎨 Recomendaciones para Figma

    Frame principal

    1920×3000px para el mapa completo

    Código de colores por área

    CRM/Ventas #3B82F6
    Finanzas #8B5CF6
    Equipo/RRHH #22C55E
    Técnicos #06B6D4
    Herramientas #F97316
    Comunicaciones #EC4899
    Admin/BM #EAB308

    Tips

    • Usar flechas con labels para indicar el tipo de transición
    • Marcar con badges de color qué roles acceden a cada módulo
    • Los colores del funnel están en src/constants/funnelStages.ts
    • Visibilidad por rol controlada por tabla role_module_visibility

    Generado automáticamente · 29 de octubre de 2026