1. Introducción al CRM V3
Bienvenido al manual interactivo de la versión 3 de CRM Remprotec. Esta plataforma unifica la gestión de clientes, seguimiento de oportunidades comerciales, catálogo de inventario, flujos de aprobación financiera, contratos operacionales, órdenes de instalación técnica, facturación integrada y el panel de control de usuarios y reportes en un ecosistema robusto en tiempo real.
El sistema se apoya en un diseño responsivo limpio (estilo corporativo con acentos en amarillo Caterpillar y negro) y cargas de interfaz asíncronas con HTMX que evitan recargas innecesarias en el navegador, acelerando la navegación comercial diaria.
Seguridad Reforzada
El CRM cuenta con un mecanismo personalizado de protección contra ataques CSRF (Cross-Site Request Forgery) inyectado automáticamente en todas las peticiones POST tradicionales y llamadas reactivas HTMX/Fetch, blindando los datos de la compañía.2. Dashboard de KPIs
El Dashboard principal ofrece una vista en tiempo real sobre el estado financiero y operativo del negocio de Remprotec.
Características principales del Dashboard:
- Semaforización Inteligente: Los indicadores (Leads activos, Oportunidades abiertas, Contratos activos, Facturación del mes, etc.) están regulados paramétricamente. Se pintan automáticamente en verde (excelente), amarillo (estable) o rojo (alerta) según los umbrales de la base de datos.
- Embudo de Ventas: Gráfico dinámico que visualiza la distribución de negocios a lo largo de cada etapa del embudo comercial.
- Proyección de Ingresos: Muestra el total de facturación mensual esperado en comparación con el recuperado (cartera).
3. Pipeline Kanban y Alertas
El tablero Kanban centraliza el embudo comercial principal de la compañía. Permite hacer un seguimiento visual e interactivo de cada oportunidad de negocio.
Puntos Clave del Kanban:
- Arrastrar y Soltar (Drag-and-Drop): Puedes arrastrar negocios entre columnas de forma directa. La base de datos registra de inmediato el cambio y la probabilidad asociada.
- Sumatorias en Cabeceras: Cada columna calcula dinámicamente el número de negocios activos y la sumatoria total del valor estimado en tiempo real en el navegador al soltar la tarjeta.
- Columnas Adaptativas: Diseñado para hacer wrap y ajustarse al 100% de la pantalla para evitar scrolls horizontales excesivos.
Semaforización de Inactividad (Hito 12.1)
El Kanban ahora colorea de forma preventiva y visual las tarjetas de los negocios según el tiempo transcurrido desde su última actualización:- Borde Amarillo (Preventivo): Negocios sin cambios ni actualizaciones comerciales durante más de 15 días.
- Borde/Badge Rojo (Alerta Crítica): Negocios congelados o sin actividad durante más de 30 días, lo que exige seguimiento prioritario del vendedor asignado.
4. Módulo de Negocios (Oportunidades)
Permite administrar las oportunidades comerciales de Remprotec, registrando datos de la obra, información comercial e historial de auditoría.
Campos e Integración Paramétrica:
Al crear o editar un negocio, los selectores cargan sus opciones directamente desde la tabla de parámetros, garantizando la consistencia de los datos:
- Datos de Obra: Dirección, Ciudad, Tipo de proyecto (Residencial, Comercial, Mixto) y Etapa constructiva (Estructura, Excavación).
- Información Comercial: Tipo de negocio, Sistema requerido, Canal de origen, Valor estimado y Probabilidad.
- Responsable comercial: Selector dinámico que permite asignar el negocio a un vendedor o usuario del CRM.
Bitácora de Historial y Trazabilidad
Al final de la pantalla de detalle se muestra el Historial. Cualquier cambio crítico realizado en el negocio (valor estimado, probabilidad, responsable comercial o cambios de etapa) queda registrado automáticamente como log de auditoría con fecha y descripción.5. Catálogo de Productos y Servicios (Inventario)
El CRM integra un catálogo de inventario con productos y servicios divididos en categorías (Equipos, Servicios, Hardware, Software, etc.).
Vinculación a Oportunidades:
En el detalle de un negocio, el vendedor puede vincular múltiples productos del catálogo:
- Buscador Reactivo: Escribe el nombre del producto en el input dinámico. El buscador es insensible a tildes (usando `unaccent` en la BD) para evitar fallos de búsqueda.
- Recálculo de Totales sin Recargas: Al agregar o remover ítems, el subtotal, descuento e IVA se calculan inmediatamente y se actualizan dinámicamente mediante swaps OOB (Out-of-band) de HTMX. El valor estimado del negocio también se recalcula de forma automática en base a estos productos.
6. Módulo de Cotizaciones y Ciclo de Aprobación
Permite generar cotizaciones comerciales enlazadas a un negocio, definir descuentos globales y evaluar el margen de rentabilidad.
Reglas de Aprobación Paramétrica (Flujo de Control):
Al guardar una cotización, el sistema analiza el Margen de rentabilidad estimado % y el Descuento global % aplicando las reglas corporativas definidas en la base de datos:
- Nivel 1 (Margen ≥ 20% y Descuento ≤ 5%): Se auto-aprueba y no requiere autorización.
- Nivel 2 (Descuento > 5%): Se escala a Cristhian + Rodrigo en estado En revisión.
- Nivel 3 (Margen < 20% pero ≥ 10%): Se escala a Rodrigo en estado En revisión.
- Nivel 4 (Margen < 10%): Se escala a Gerencia en estado En revisión.
Cuando una cotización requiere aprobación, entra en estado En revisión, mostrando una tarjeta amarilla destacada con los botones administrativos para Aprobar o Rechazar de manera rápida.
Exportación e Impresión PDF:
El botón de acciones superior "Descargar PDF" permite compilar en tiempo real el documento comercial formateado a partir del código HTML compatible con ReportLab (utilizando `xhtml2pdf`), guardándolo directamente en tu equipo.
7. Conversión Automática a Contrato
Cuando el negocio supera todas las etapas de negociación y el cliente acepta la cotización, se realiza el cierre del trato.
Flujo de Automatización de Post-Cierre:
Al mover un negocio a la columna o etapa "Cerrado ganado" (Kanban, selector o edición de detalles), el sistema ejecuta el siguiente protocolo autónomo:
- Busca la cotización aprobada o más reciente vinculada al negocio.
- Genera automáticamente un registro de Contrato en estado Borrador.
- Asigna un número secuencial único estructurado en base al año corriente (ej.
CNT-2026-0005). - Asigna el valor de la cotización y mapea el tipo de negocio al tipo de contrato (venta -> venta_equipos, alquiler -> alquiler_equipos).
- Inserta los logs de auditoría en la bitácora del negocio y crea un enlace de acceso directo al contrato en la tarjeta de datos generales de la oportunidad.
8. Contratos y Operación
El listado de contratos permite dar seguimiento al estatus de los compromisos operacionales de Remprotec.
Los contratos tienen un ciclo de vida propio que avanza desde el borrador inicial, pasando por revisión y firma, hasta llegar a ejecución. Desde el formulario de edición de contratos es posible ajustar fechas de inicio y vencimiento, así como añadir notas y el objeto contractual del compromiso.
9. Módulo de Órdenes de Instalación (Hito 13)
El módulo de Instalaciones V3 permite planificar, programar y supervisar en campo las labores técnicas y montajes de equipos asociados a los contratos vigentes de Remprotec.
Flujo de Trabajo Operacional (Workflow):
Cada orden de instalación avanza por un flujo de etapas parametrizado que cambia los badges de color de forma dinámica en la interfaz:
- Programada (Gris / bg-secondary): La orden ha sido registrada e ingresada con fecha proyectada de ejecución.
- Asignada (Amarillo / bg-warning): Cuenta con un responsable técnico asignado para la labor.
- En ejecución (Azul / bg-primary): El equipo técnico se encuentra realizando el montaje en la obra.
- Ejecutada (Verde / bg-success): Montaje técnico terminado. Registra de forma automática la fecha real de ejecución.
- Verificada (Verde / bg-success): Interventoría y supervisión técnica aprobada y cerrada.
- Cancelada (Rojo / bg-danger): Orden cancelada operativamente.
Autogeneración de Orden de Instalación
Cuando el negocio se marca como "Cerrado ganado", el sistema no solo crea el contrato, sino que genera opcionalmente un borrador de Orden de Instalación Técnica con base en los productos y dirección física de la obra, reduciendo errores humanos de doble registro.10. Módulo de Facturación V3 (Hito 14)
El módulo de Facturas unifica la contabilidad de compromisos comerciales y contratos de alquiler o venta, calculando impuestos y controlando vencimientos.
Características de la Facturación V3:
- IVA al 19% Pre-cargado y Totalmente Editable: Al abrir el formulario de factura, el sistema pre-carga el impuesto nacional del 19.00%. Sin embargo, si el cobro tiene condiciones especiales, el usuario puede modificar directamente este campo.
- Cálculo Matemático del Total: El sistema procesa de forma automática la sumatoria del
subtotal + (subtotal * IVA / 100)al momento de guardar o actualizar la factura. - Ciclo de Vida de la Factura: Pasa de Borrador a Emitida, Enviada, Pagada o Vencida, actualizando los badges de color de manera acorde.
Integración con Cartera Comercial
Cuando una factura cambia su estado operacional a "Pagada", el sistema recalcula de forma automática la deuda activa de la Empresa (Cliente), rebajando el saldo de mora del informe general de Cartera.11. Informes de Cartera y Mora
El módulo de cartera y facturas consolidado permite vigilar la salud del flujo de caja de la organización.
Semaforización de Mora (Antigüedad de Cartera):
Las facturas se distribuyen automáticamente en bandas de antigüedad (Corriente, 1-30 días, 31-60 días, 61-90 días, Más de 90 días) en base a su fecha de vencimiento y fecha de pago:
- Antigüedad menor o igual a 30 días: Semáforo verde / estable.
- Antigüedad menor o igual a 60 días: Semáforo amarillo / preventivo.
- Antigüedad mayor a 60 días: Semáforo rojo / alerta (escalamiento gerencial).
12. Calendario Comercial
Centraliza la planeación y el registro de la actividad en campo del equipo comercial de Remprotec.
Navegación e Interactividad (HTMX):
- Navegación Asíncrona: Las flechas de cambio de mes cargan instantáneamente la cuadrícula utilizando llamadas asíncronas de HTMX, garantizando fluidez.
- Agenda del Día Lateral: Al hacer clic sobre cualquier número de día, el contenedor lateral derecho se actualiza en tiempo real mostrando las actividades programadas en esa fecha (prioridad, hora, asunto y responsable).
- Agendado Rápido: Al seleccionar un día sin tareas, el botón de crear actividad se pre-carga con la fecha seleccionada de forma automática.
13. Módulo de Reportes Analíticos (Hito 10)
El panel de Reportes ofrece un resumen ejecutivo detallado y dinámico en tres frentes operacionales clave para Remprotec:
Indicadores Disponibles en el Panel:
- Métricas Comerciales: Consolida la cantidad de negocios activos, ganados y perdidos en la base de datos viva, calcula el volumen monetario total de oportunidades abiertas, la tasa de conversión porcentual del embudo de ventas y una distribución de cantidad de negocios por etapa constructiva y comercial.
- Métricas Operativas: Informa sobre las actividades comerciales y técnicas totales, la proporción entre pendientes y completadas, la clasificación según el canal/tipo de gestión, y el estado actual de las cotizaciones en el sistema.
- Métricas Financieras / Gerenciales: Detalla el número de contratos totales, el monto total facturado, el valor total acumulado y la sumatoria exacta de la cartera vencida para monitoreo gerencial.
14. Módulo de Gestión de Usuarios y Seguridad (Hito 10 y 11)
El módulo de Usuarios e identidad unifica el control de accesos, roles administrativos y la matriz relacional de permisos del sistema.
Estructura Estética y de Seguridad:
- Identidad Unificada con Caja Menor: La interfaz ha sido diseñada para calcando exactamente la visual y comportamiento de Caja Menor V3 (fondo negro puro en formularios de login y cambio de contraseña, botones y detalles en amarillo Caterpillar).
- CRUD Completo: Permite registrar usuarios, editar nombres, correos corporativos, desactivar cuentas de forma lógica o eliminarlas por completo.
- Políticas de Seguridad: El sistema obliga al cambio de contraseña cada 90 días por expiración de cuenta, bloquea temporalmente al usuario tras 5 intentos fallidos consecutivos de contraseña, y requiere validación de contraseña segura.
Matriz Interactiva de Roles y Permisos:
En el submenú "Roles y Permisos", los administradores pueden gestionar de forma interactiva qué acciones puede realizar cada uno de los 4 roles (Administrativo, Gerencial, Comercial, Operativo) en cada módulo del sistema.
Al hacer clic en cualquier switch de la cuadrícula, la petición de cambio se envía asíncronamente mediante **HTMX** aplicando la modificación al instante en la base de datos sin recargar la página.
15. Automatizaciones y CLI
Centraliza la revisión de alertas operacionales de cartera y de inactividad de negocios.
Alertas de Negocios sin Gestión (Hito 12.1):
Muestra el listado de oportunidades que requieren atención inmediata debido al tiempo transcurrido desde su última acción.
CLI de Ejecución de Automatizaciones:
El CRM cuenta con un script CLI que se ejecuta de forma periódica (flask ejecutar-automatizaciones). Este script busca facturas vencidas en el sistema y gatilla automáticamente el cambio de estado a vencida, disparando alertas de cobro.
16. Parametrización y Configuración
El núcleo paramétrico del sistema permite configurar el comportamiento de todo el CRM sin necesidad de alterar el código fuente.
Tablas Paramétricas Editables:
- Grupos de Parámetro: Tipos de proyectos, etapas constructivas, categorías de productos, etc.
- Opciones de Parámetro: El contenido de las listas de selección, incluyendo colores, nombres y valores de umbrales.
- Reglas de Aprobación: Porcentajes de descuento permitidos y márgenes de rentabilidad mínimos para las alertas de cotización.