• Parte 1: Instalacion, primeros pasos y configuracion de Ollama
  • Parte 2: Dashboard, KPIs en tiempo real y sistema de alertas +
    • AIAnalytics - Parte 3: Los 7 modulos de analisis empresarial +
      • AIAnalytics - Parte 4: Chat con tu consultor IA empresarial +
        • AIAnalytics - Parte 5: Configuracion avanzada, Cron automatico y personalizacion de la IA

Parte 1: Instalacion, primeros pasos y configuracion de Ollama

AIAnalytics - Tu consultor empresarial con IA

Que es AIAnalytics

AIAnalytics es un plugin para FacturaScripts 2025+ que convierte tu ERP en un sistema de inteligencia empresarial. Analiza automaticamente facturacion, finanzas, clientes, stock, procesos, anomalias, horarios, RRHH y previsiones, con dos opciones de IA: Ollama (100% local) o Groq (nube ultrarapida con Zero Data Retention).

Caracteristicas principales

• 9 modulos de analisis: Facturacion, Finanzas, Clientes, Stock, Procesos, Anomalias, Horarios, RRHH y Prevision
• Doble backend de IA: Ollama (local, privado) y Groq (nube, rapido)
• Selector inteligente (AIClient): Modo auto elige el mejor backend disponible con fallback automatico
• Dashboard con KPIs en tiempo real: Indicadores clave siempre visibles
• Health Score: Puntuacion de salud empresarial de 0 a 100
• Chat conversacional: Pregunta lo que quieras sobre tu negocio en lenguaje natural
• Prevision con regresion lineal: Proyeccion de facturacion a 3 meses
• Analisis automatico diario: Cron configurable que analiza tu empresa cada dia
• Sistema de alertas por severidad: critico, alto, medio, bajo, info
• Exportacion PDF y email: Envia el resumen ejecutivo por correo o descarga como PDF
• Cumplimiento RGPD y AI Act: Auditoria de uso IA, consentimiento, transparencia
• Funciona sin IA: Modo reglas inteligentes como fallback
• Compatible MySQL y PostgreSQL: Consultas SQL adaptadas a ambos motores

Requisitos previos

• FacturaScripts 2025.71 o superior
• PHP 8.0 o superior
• Extensiones PHP: curl, json
• Opcional: Ollama instalado en el servidor (para IA local)
• Opcional: API Key de Groq (para IA en la nube)

Instalacion del plugin

1. Descarga el archivo AIAnalytics.zip
2. Ve a Panel de Control > Plugins en FacturaScripts
3. Pulsa Subir plugin y selecciona el ZIP
4. Activa el plugin y espera a que se complete la instalacion
5. Veras el mensaje: "AIAnalytics instalado. Ve a Informes > IA Analytics."

El plugin crea automaticamente:

• Tabla ai_config con 13 parametros de configuracion predeterminados (incluyendo 3 de privacidad RGPD)
• Tabla ai_reports para almacenar los informes generados
• Tabla ai_chat para el historial de conversaciones
• Tabla ai_metrics para metricas historicas
• Tabla ai_audit_log para el log de auditoria de uso de IA (AI Act Art. 12)

Acceso al plugin

Una vez instalado, accede desde el menu:

Informes > IA Analytics

Veras el panel principal con:

• Cabecera con indicador de estado de la IA y el backend activo (badge verde/amarillo/azul)
• Dos pestanas: Dashboard y Chat IA
• Boton de configuracion (engranaje)

Modos de funcionamiento

Modo Reglas (sin IA)

Es el modo por defecto. El plugin analiza tus datos usando reglas estadisticas inteligentes:

• Detecta facturas vencidas y calcula morosidad
• Identifica clientes inactivos y concentracion de cartera
• Revisa stock bajo minimo y sin rotacion
• Analiza margenes, flujo de caja y tendencias
• Detecta duplicados, descuentos excesivos y anomalias
• Calcula prevision por regresion lineal

El badge mostrara: Modo reglas (azul)

Modo IA con Ollama (local)

IA 100% privada ejecutada en tu propio servidor:

• Analisis contextual con recomendaciones accionables
• Chat conversacional sobre cualquier aspecto del negocio
• Tus datos NUNCA salen del servidor
• Requiere hardware con recursos (minimo 4 GB RAM libre)

Modo IA con Groq (nube)

IA ultrarapida a traves de la API de Groq:

• Modelos potentes como llama-3.3-70b-versatile
• Respuestas en segundos, sin necesidad de hardware potente
• Zero Data Retention: Groq no almacena tus datos
• Requiere API Key gratuita de Groq
• Fallback automatico de modelos si se agota la cuota
• Las narrativas enviadas son agregadas, sin datos personales (privacidad por diseno)

Modo Auto (recomendado)

El selector inteligente AIClient gestiona automaticamente los backends:

1. Intenta usar Ollama primero (si esta online)
2. Si Ollama no esta disponible, cambia a Groq automaticamente
3. Si ninguno esta disponible, usa las reglas inteligentes

Asi siempre tienes cobertura de IA sin intervencion manual.

El badge mostrara: IA Activa (verde) con el nombre del backend activo y modelo

Instalar y configurar Ollama

Que es Ollama

Ollama es un servidor de IA local que ejecuta modelos de lenguaje en tu propio servidor. No envia datos a ningun servicio externo. Es completamente gratuito.

Instalacion en Linux

Desde el propio plugin puedes instalar Ollama:

1. Ve a Configuracion (icono engranaje) > pestana IA Local (Ollama)
2. Pulsa Instalar Ollama (solo Linux)
3. Espera 1-2 minutos a que termine la instalacion

O manualmente desde terminal:

curl -fsSL https://ollama.com/install.sh | sh

Descargar un modelo

Una vez instalado Ollama, necesitas descargar un modelo de IA:

1. En Configuracion > IA Local, selecciona el modelo deseado
2. Pulsa Descargar Modelo
3. Espera a que se complete la descarga (puede tardar varios minutos)

Modelos recomendados para Ollama

Verificar conexion

1. Pulsa Probar Conexion en la pestana de configuracion
2. Si todo esta bien, veras: "Ollama activo. Modelos: qwen2.5:3b"
3. Si no detecta Ollama, verifica que el servicio este corriendo:

systemctl status ollama

Configurar Groq (IA en la nube)

Que es Groq

Groq es un servicio de IA en la nube que ofrece inferencia ultrarapida. Tiene una capa gratuita generosa y politica de Zero Data Retention (tus datos no se almacenan en sus servidores).

Obtener una API Key

1. Ve a console.groq.com y crea una cuenta gratuita
2. Accede a API Keys y genera una nueva key
3. Copia la key (empieza por gsk_...)

Configurar en el plugin

1. Ve a Configuracion (engranaje) > seccion de backends
2. Introduce tu API Key de Groq en el campo correspondiente
3. Selecciona el modelo deseado (por defecto: llama-3.3-70b-versatile)
4. Selecciona backend auto o groq
5. Pulsa Guardar

Modelos disponibles en Groq

Fallback automatico de modelos

Si el modelo principal agota su cuota diaria (tokens per day), el plugin cambia automaticamente al siguiente modelo disponible:

llama-3.3-70b-versatile → llama-3.1-8b-instant → gemma2-9b-it

Tambien gestiona rate limits por minuto (TPM): si Groq dice "espera 3 segundos", el plugin espera y reintenta automaticamente.

Selector de backend (AIClient)

El parametro backend_ia en configuracion controla que backend se usa:

Primeros pasos recomendados

1. Sin IA: Pulsa "Analisis Completo" para ver que detectan las reglas inteligentes con tus datos reales
2. Opcion A — Ollama: Instala Ollama, descarga Qwen 2.5 3B, activa la IA
3. Opcion B — Groq: Crea una cuenta en Groq, pega tu API Key, selecciona backend "groq" o "auto"
4. Opcion ideal: Configura ambos y usa modo auto para maxima disponibilidad
5. Prueba el Chat: Pregunta "Como van las ventas este mes?" para ver la diferencia
6. Activa el Cron: Para recibir analisis automaticos cada dia
7. Revisa RGPD: Acepta el aviso de privacidad y activa la auditoria de uso de IA