Parte 1: Instalación, primeros pasos y configuración de Ollama

AIAnalytics - Tu consultor empresarial con IA

ℹ️ Qué es AIAnalytics

AIAnalytics es un plugin para FacturaScripts 2025+ que convierte tu ERP en un sistema de inteligencia empresarial. Analiza automáticamente facturación, finanzas, clientes, stock, procesos, anomalías, horarios, RRHH y previsiones, con dos opciones de IA: Ollama (100% local) o Groq (nube ultrarrápida con Zero Data Retention).

✨ Características principales

9 módulos de análisis: Facturación, Finanzas, Clientes, Stock, Procesos, Anomalías, Horarios, RRHH y Previsión
Doble backend de IA: Ollama (local, privado) y Groq (nube, rápido)
Selector inteligente (AIClient): Modo auto elige el mejor backend disponible con fallback automático
Dashboard con KPIs en tiempo real: Indicadores clave siempre visibles
Health Score: Puntuación de salud empresarial de 0 a 100
Chat conversacional: Pregunta lo que quieras sobre tu negocio en lenguaje natural
Previsión con regresión lineal: Proyección de facturación a 3 meses
Análisis automático diario: Cron configurable que analiza tu empresa cada día
Sistema de alertas por severidad: crítico, alto, medio, bajo, info
Exportación PDF y email: Envía el resumen ejecutivo por correo o descarga como PDF
Cumplimiento RGPD y AI Act: Auditoría 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)

📦 Instalación del plugin

Descarga el archivo AIAnalytics.zip
Ve a Panel de Control → Plugins en FacturaScripts
Pulsa Subir plugin y selecciona el ZIP
Activa el plugin y espera a que se complete la instalación
Verás el mensaje: "AIAnalytics instalado. Ve a Informes → IA Analytics."

El plugin crea automáticamente:

Tabla ai_config con 13 parámetros de configuración 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 métricas históricas
Tabla ai_audit_log para el log de auditoría de uso de IA (AI Act Art. 12)

🔑 Acceso al plugin

Una vez instalado, accede desde el menú:

Informes → IA Analytics

Verás el panel principal con:

Cabecera con indicador de estado de la IA y el backend activo (badge verde/amarillo/azul)
Dos pestañas: Dashboard y Chat IA
Botón de configuración (engranaje)

⚙️ Modos de funcionamiento

🔍 Modo Reglas (sin IA)

Es el modo por defecto. El plugin analiza tus datos usando reglas estadísticas inteligentes:

Detecta facturas vencidas y calcula morosidad
Identifica clientes inactivos y concentración de cartera
Revisa stock bajo mínimo y sin rotación
Analiza márgenes, flujo de caja y tendencias
Detecta duplicados, descuentos excesivos y anomalías
Calcula previsión por regresión lineal

El badge mostrará: Modo reglas (azul)

🖥️ Modo IA con Ollama (local)

IA 100% privada ejecutada en tu propio servidor:

Análisis contextual con recomendaciones accionables
Chat conversacional sobre cualquier aspecto del negocio
Tus datos NUNCA salen del servidor
Requiere hardware con recursos (mínimo 4 GB RAM libre)

☁️ Modo IA con Groq (nube)

IA ultrarrápida a través 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 automático de modelos si se agota la cuota
Las narrativas enviadas son agregadas, sin datos personales (privacidad por diseño)

🤖 Modo Auto (recomendado)

El selector inteligente AIClient gestiona automáticamente los backends:

Intenta usar Ollama primero (si está online)
Si Ollama no está disponible, cambia a Groq automáticamente
Si ninguno está disponible, usa las reglas inteligentes

Así siempre tienes cobertura de IA sin intervención manual.

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

🛠️ Instalar y configurar Ollama

ℹ️ Qué es Ollama

Ollama es un servidor de IA local que ejecuta modelos de lenguaje en tu propio servidor. No envía datos a ningún servicio externo. Es completamente gratuito.

🐧 Instalación en Linux

Desde el propio plugin puedes instalar Ollama:

Ve a Configuración (icono engranaje) → pestaña IA Local (Ollama)
Pulsa Instalar Ollama (solo Linux)
Espera 1-2 minutos a que termine la instalación

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:

En Configuración → IA Local, selecciona el modelo deseado
Pulsa Descargar Modelo
Espera a que se complete la descarga (puede tardar varios minutos)

📦 Modelos recomendados para Ollama

| Modelo | Tamaño | Descripción | |--------|--------|-------------| | Qwen 2.5 3B | ~2 GB | Rápido, buen español. Recomendado para empezar | | Qwen 2.5 7B | ~4.5 GB | Mejor calidad de análisis | | Llama 3.2 3B | ~2 GB | Equilibrado | | Llama 3.1 8B | ~4.7 GB | Muy preciso | | Mistral 7B | ~4 GB | Buena alternativa | | Gemma 2 9B | ~5.5 GB | Alto rendimiento | | Phi-3 3.8B | ~2.3 GB | Compacto |

✅ Verificar conexión

Pulsa Probar Conexión en la pestaña de configuración
Si todo está bien, verás: "Ollama activo. Modelos: qwen2.5:3b"
Si no detecta Ollama, verifica que el servicio esté corriendo:

systemctl status ollama

🌐 Configurar Groq (IA en la nube)

ℹ️ Qué es Groq

Groq es un servicio de IA en la nube que ofrece inferencia ultrarrápida. Tiene una capa gratuita generosa y política de Zero Data Retention (tus datos no se almacenan en sus servidores).

🔑 Obtener una API Key

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

⚙️ Configurar en el plugin

Ve a Configuración (engranaje) → sección de backends
Introduce tu API Key de Groq en el campo correspondiente
Selecciona el modelo deseado (por defecto: llama-3.3-70b-versatile)
Selecciona backend auto o groq
Pulsa Guardar

📄 Modelos disponibles en Groq

| Modelo | Descripción | |--------|-------------| | llama-3.3-70b-versatile | Modelo principal, muy potente. Recomendado | | llama-3.1-8b-instant | Rápido, menor consumo de cuota | | gemma2-9b-it | Alternativa de Google |

🔁 Fallback automático de modelos

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

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

También gestiona rate limits por minuto (TPM): si Groq dice "espera 3 segundos", el plugin espera y reintenta automáticamente.

🧭 Selector de backend (AIClient)

El parámetro backend_ia en configuración controla qué backend se usa:

| Valor | Comportamiento | |-------|----------------| | auto | Intenta Ollama primero, si falla usa Groq. Recomendado | | ollama | Solo Ollama. Si está offline, sin IA | | groq | Solo Groq API. Ignora Ollama | | off | Desactivado. Solo reglas inteligentes |

🚀 Primeros pasos recomendados

Sin IA: Pulsa "Análisis Completo" para ver qué detectan las reglas inteligentes con tus datos reales
Opción A — Ollama: Instala Ollama, descarga Qwen 2.5 3B, activa la IA
Opción B — Groq: Crea una cuenta en Groq, pega tu API Key, selecciona backend "groq" o "auto"
Opción ideal: Configura ambos y usa modo auto para máxima disponibilidad
Prueba el Chat: Pregunta "¿Cómo van las ventas este mes?" para ver la diferencia
Activa el Cron: Para recibir análisis automáticos cada día
Revisa RGPD: Acepta el aviso de privacidad y activa la auditoría de uso de IA