AIAnalytics - Parte 3: Los 7 modulos de analisis empresarial
Los 9 modulos de analisis empresarial
AIAnalytics incluye 9 modulos especializados, cada uno con su propio analizador y prompt experto de IA. Pueden ejecutarse individualmente o todos a la vez con "Analisis Completo".
Como funciona cada modulo
Cada modulo sigue el mismo flujo:
- DataCollector obtiene datos reales de tu ERP via SQL (compatible MySQL y PostgreSQL)
- El Analizador aplica reglas estadisticas y genera alertas con severidad
- Si hay IA activa (Ollama o Groq), el analizador genera una narrativa en formato XML con etiquetas anti-alucinacion
- La IA recibe la narrativa y un prompt experto del departamento correspondiente
- La IA puede elevar la severidad si detecta riesgos adicionales (nunca reducirla)
- El resultado se guarda como informe en la base de datos (upsert: reutiliza registros pendientes del mismo modulo)
Enriquecimiento con IA y anti-alucinacion
Cuando la IA esta activa, cada analizador genera una narrativa estructurada con:
- Etiquetas XML por seccion (ej:
<facturacion>,<stock>,<plantilla_empleados>) - Datos numericos reales del ERP sin nombres personales
- Avisos criticos: "NUNCA inventes datos que no aparezcan aqui"
- Prohibiciones especificas por modulo (ej: "no afirmes que los empleados cumplen horario contractual")
- Contexto temporal: fecha actual, dia del mes, periodo disponible
La IA responde con JSON estructurado que incluye severidad propuesta, recomendaciones y alertas adicionales.
1. Facturacion
Icono: Factura | Rol IA: Director Financiero
Que datos recoge
- Resumen general: Total facturado, numero de facturas, ticket medio
- Evolucion mensual: Facturacion mes a mes para detectar tendencias
- Facturas con retraso: Facturas vencidas pendientes de cobro con dias de retraso
- Top clientes: Los clientes que mas facturan, con importes
Que analiza
- Tasa de morosidad: porcentaje de facturacion vencida vs umbral configurable (por defecto 15%)
- Numero y valor de facturas vencidas
- Concentracion de ingresos en pocos clientes
- Tendencia de facturacion (crecimiento o caida mes a mes)
- Propone acciones concretas con plazos
2. Finanzas
Icono: Grafico de lineas | Rol IA: CFO
Que datos recoge
- Margenes por producto: Productos con margen negativo
- Cobros proximos 30 dias: Lo que vas a cobrar pronto
- Pagos proximos 30 dias: Lo que tienes que pagar pronto
- Flujo de caja 30 dias: Diferencia entre cobros y pagos previstos
- Evolucion mensual: Ingresos vs gastos por mes
Que analiza
- Productos con margen negativo (alerta critica)
- Flujo de caja: si los pagos superan los cobros en 30 dias
- Tendencia de rentabilidad
- Riesgos financieros inmediatos
3. Clientes
Icono: Grupo de personas | Rol IA: Director Comercial
Que datos recoge
- Top clientes por facturacion: Los mejores clientes con su cifra
- Clientes inactivos: Clientes que no compran desde hace X dias (configurable, por defecto 90)
- Clientes nuevos: Altas recientes de clientes
Que analiza
- Concentracion de facturacion en el top 3 (riesgo de dependencia)
- Clientes VIP que han dejado de comprar (riesgo de fuga)
- Tasa de retencion y churn
- Segmentacion por valor y frecuencia
4. Stock
Icono: Almacen | Rol IA: Director de Operaciones
Que datos recoge
- Productos bajo minimo: Articulos con stock inferior al minimo configurado
- Stock sin movimiento: Productos sin ventas recientes (capital inmovilizado)
- Top ventas: Productos mas vendidos para cruzar con disponibilidad
Que analiza
- Rotura de stock inminente en productos estrella
- Capital inmovilizado en stock muerto
- Eficiencia del inventario
- Recomendaciones de compra o liquidacion
5. Procesos
Icono: Engranajes | Rol IA: COO
Que datos recoge
- Embudo de ventas: Presupuestos, pedidos y facturas con importes
- Presupuestos sin convertir: Que no se han pasado a pedido o factura
- Rectificativas: Facturas rectificativas emitidas
Que analiza
- Tasa de conversion presupuesto a pedido a factura
- Valor de presupuestos perdidos
- Tasa de rectificativas (problemas de calidad o servicio)
- Cuellos de botella en el proceso comercial
6. Anomalias
Icono: Triangulo de alerta | Rol IA: Auditor Interno
Que datos recoge
- Facturas duplicadas: Misma referencia, cliente e importe en el mismo periodo
- Descuentos excesivos: Lineas con descuentos superiores al 30%
- Actividad en fines de semana: Facturas emitidas en sabado o domingo
Que analiza
- Posible fraude o error grave (duplicados)
- Abuso o politica comercial dudosa (descuentos)
- Actividad irregular fuera de horario
- Patrones sospechosos recurrentes
7. Horarios
Icono: Reloj | Rol IA: Experto en RRHH y Operaciones
Que datos recoge
- Pedidos estancados: Pedidos sin servir con mas de 7 dias de antiguedad
- Patrones de actividad: Distribucion horaria y por dia de la semana
- Vencimientos proximos: Facturas que vencen en los proximos 7 dias
- Actividad reciente: Registro de las ultimas 48 horas
Que analiza
- Trabajo acumulado sin procesar (pedidos estancados)
- Urgencias de cobro (vencimientos proximos)
- Patrones horarios del equipo
- Distribucion de carga semanal
8. RRHH (Equipo)
Icono: Usuarios con engranaje | Rol IA: Director de RRHH
Este modulo se conecta con los plugins de RRHH de FacturaScripts si estan instalados. Detecta automaticamente las tablas disponibles.
Que datos recoge
- Plantilla de empleados (tabla
rrhh_employees): Activos, bajas, altas recientes, distribucion por departamento - Fichajes y asistencia (tabla
rrhh_attendances): Registros de entrada/salida, empleados con/sin fichaje en 30 dias - Horas trabajadas (tabla
registro_horarios): Horas calculadas en los ultimos 30 dias - Imputaciones de horas (tabla
imputacioneshoras): Horas imputadas a proyectos con precio/hora, valor facturado y pendiente de facturar - Proyectos (tabla
proyectos): Proyectos abiertos y pendiente de facturar - Agentes comerciales (tabla
agentes): Ventas por agente en los ultimos 3 meses - Usuarios del ERP (tabla
users): Cuentas de acceso al sistema (distinto de empleados)
Que analiza
- Crecimiento de plantilla (alerta info si hay 2 o mas incorporaciones en 3 meses)
- Empleados sin fichaje en 30 dias (alerta medio/alto segun porcentaje)
- Horas facturables sin albaran (alerta medio si superan 500 EUR)
- Proyectos con pendiente de facturar elevado (alerta medio si supera 1.000 EUR)
- Agentes comerciales activos con ventas
Anti-alucinacion especifica
La narrativa de RRHH incluye protecciones estrictas:
- Si la tabla de empleados no existe, dice "NO_DISPONIBLE — no menciones numero de empleados"
- Los fichajes son solo eventos (entrada/salida): "NO contiene horas calculadas ni confirmacion de cumplimiento de horario contractual"
- Regla explicita: "no afirmes que los empleados cumplen su horario contractual — no tenemos ese dato"
- Usuarios ERP se marcan como "cuentas de acceso al software, NO son empleados"
9. Prevision
Icono: Grafico de area | Rol IA: Analista de Prevision
Este modulo usa regresion lineal para proyectar la facturacion a 3 meses vista.
Que datos recoge
- Historico de facturacion: Serie mensual de los ultimos 12 meses
- Evolucion financiera: Datos de ingresos y gastos
Como calcula la prevision
- Toma la serie mensual de facturacion (minimo 3 meses necesarios)
- Aplica regresion lineal (minimos cuadrados) sobre la serie temporal
- Calcula la pendiente (slope) y la interseccion (intercept)
- Proyecta los 3 meses siguientes usando la formula lineal
Que analiza
- Tendencia positiva: Facturacion al alza (slope > 0)
- Tendencia negativa: Alerta alta si la facturacion baja (slope < 0), indicando cuanto baja por mes
- Proyeccion mensual: Estimacion del proximo mes
Anti-alucinacion especifica
La narrativa de Prevision incluye:
- Periodo historico disponible explicito (ej: "06/03/2025 a 09/03/2026")
- Aviso: "NO hay datos anteriores a [fecha]. La proyeccion se basa SOLO en la tendencia de estos 12 meses"
- Prohibicion: "No compares con el ano anterior: no existe en los datos"
- Mes en curso marcado como "INCOMPLETO: solo X dias"
Compatibilidad MySQL y PostgreSQL
El DataCollector adapta automaticamente las consultas SQL segun el motor de base de datos:
- Intervalos de fecha:
DATE_SUB/NOW()en MySQL,CURRENT_DATE - INTERVALen PostgreSQL - Formato de fecha:
DATE_FORMATen MySQL,TO_CHARen PostgreSQL - Dia de la semana:
DAYOFWEEK()en MySQL,EXTRACT(DOW)en PostgreSQL - Hora:
HOUR()en MySQL,EXTRACT(HOUR)en PostgreSQL
No necesitas configurar nada: el plugin detecta automaticamente que motor usas.
Analisis completo vs modulo individual
- Analisis Completo: Ejecuta los 9 modulos en secuencia, guarda todos los informes y genera un resumen ejecutivo global. Registra un evento de auditoria con tiempo total, numero de alertas y backend utilizado.
- Modulo individual: Ejecuta solo un area. Util para investigar un problema concreto. Tambien registra auditoria.
Ambos modos generan informes que se almacenan en el historial y se muestran en el Listado de IA.