# AI Insights — Deteccion de anomalias

AI Insights analiza continuamente tus datos financieros y detecta variaciones significativas respecto al trimestre anterior (QoQ — Quarter over Quarter). Cuando una metrica sale del patron esperado, Frihet la marca como anomalia y genera una explicacion en lenguaje natural con Gemini.

El objetivo no es alarmar, sino darte contexto antes de que tengas que buscarlo.

## Que metricas analiza Frihet

| Categoria         | Metrica                       | Umbral de alerta por defecto      |
| ----------------- | ----------------------------- | --------------------------------- |
| **Ingresos**      | Facturacion mensual total     | > 20% variacion QoQ               |
| **Ingresos**      | Ticket medio por cliente      | > 15% caida QoQ                   |
| **Gastos**        | Gastos por categoria          | > 30% aumento en una categoria    |
| **Margen**        | Margen bruto                  | > 10 puntos porcentuales de caida |
| **Cobros**        | Dias de cobro medio (DSO)     | > 15 dias aumento QoQ             |
| **Fiscal**        | IVA devengado vs. facturacion | > 5% desviacion                   |
| **Flujo de caja** | Saldo proyectado 30 dias      | < umbral configurado              |
| **Clientes**      | Clientes activos              | > 10% caida QoQ                   |

Los umbrales son configurables en **IA** → **Insights** → **Configuracion de alertas**.

## Como funciona la deteccion

1. **Calculo de deltas QoQ**: Frihet compara cada metrica con el mismo periodo del trimestre anterior y con la media movil de los ultimos 4 trimestres.
2. **Puntuacion de anomalia**: se calcula una puntuacion (0-100) combinando la magnitud de la variacion y la consistencia historica. Solo las anomalias con puntuacion > 60 se muestran en la interfaz.
3. **Clasificacion**: `Critica` (>85), `Alta` (70-85), `Media` (60-70).
4. **Generacion de explicacion**: Gemini recibe el delta, el contexto de los ultimos 4 trimestres y los datos anonimizados (ver seccion GDPR) y genera una explicacion en espanol.

## Panel de Insights

Accede desde **IA** → **Insights** o desde el **Dashboard** → bloque Insights (si esta activado).

El panel muestra las anomalias activas ordenadas por severidad:

```
CRITICA  Gastos de marketing +47% QoQ
         "El gasto en marketing de este trimestre (€8.450) es un 47% superior
          al trimestre anterior (€5.750). La mayor parte del incremento proviene
          de la categoria 'Meta Ads' (+€2.100) registrada en los ultimos 15 dias."
         [Ver detalle] [Marcar como revisada] [Ajustar umbral]

ALTA     Dias de cobro medio 68 dias (+18 vs Q1)
         "El periodo medio de cobro ha aumentado de 50 a 68 dias. Los clientes
          con mayor impacto son Empresa A (90 dias) y Empresa B (85 dias),
          que representan el 40% de la facturacion pendiente."
         [Ver clientes] [Marcar como revisada]
```

## Privacidad y GDPR — IDs opacos

Cuando Gemini genera las explicaciones, Frihet **nunca envia** nombres de clientes, NIFs, CIFs o datos de identificacion directa al modelo. Todos los identificadores se sustituyen por IDs opacos antes de la llamada a la API:

```
Datos enviados a Gemini (anonimizados):
{
  "client_id": "c_8f2a1b",     // no "EMPRESA EJEMPLO SL"
  "amount": 12450.00,
  "period": "Q1-2026",
  "category": "marketing"
}
```

La sustitucion y re-identificacion ocurre en los servidores de Frihet (Europa). Gemini solo recibe datos numericos y categoricos — nunca informacion personal identificable.

:::info Base legal GDPR
El procesamiento para Insights se basa en el **interes legitimo** del responsable del tratamiento (art. 6.1.f RGPD): mejorar la gestion financiera de la empresa usuario. Los datos de clientes (terceros) se anonimizan antes de salir del entorno controlado de Frihet. Ver [Politica de privacidad](../legal/privacidad).
:::

## Explicaciones de Gemini — como interpretarlas

Las explicaciones son orientativas, no diagnosticos definitivos. Gemini no tiene acceso al contexto completo de tu negocio — no sabe si lanzaste una campana intencionada, si tuviste una baja estacional o si firmaste un contrato nuevo.

Cada explicacion incluye un nivel de confianza:

- **Alta confianza**: el modelo tiene suficiente historico (>4 trimestres) y la variacion es consistente con un patron detectado.
- **Media confianza**: historico limitado o variacion atipica sin patron previo.
- **Baja confianza**: primer trimestre o datos insuficientes — la explicacion es especulativa.

Puedes proporcionar contexto adicional a Gemini pulsando **Anadir contexto** en la tarjeta de anomalia. Ese contexto se incluye en la siguiente generacion de explicacion para esa metrica.

## Alertas y notificaciones

Configura cuando quieres ser notificado:

1. Ve a **IA** → **Insights** → **Alertas**.
2. Selecciona los canales: email, notificacion push (movil), Telegram.
3. Define la frecuencia: en tiempo real, resumen diario (08:00) o resumen semanal (lunes 09:00).
4. Filtra por severidad minima: recibir solo Criticas, Criticas+Altas, o todas.

El **resumen semanal de insights** es el formato recomendado para la mayoria de usuarios — evita el ruido de alertas individuales y presenta todas las anomalias de la semana en un solo email/mensaje.

## Marcar como revisada

Cuando has revisado una anomalia y entiendes la causa, marcala como **Revisada** con una nota opcional. Esto:

- La mueve al historial (ya no aparece en el panel activo).
- La nota queda registrada en el expediente de la metrica.
- Si la anomalia persiste el trimestre siguiente, aparece de nuevo automaticamente.

## Gotchas

- **Primer trimestre con Frihet**: con menos de 2 trimestres de datos, los deltas QoQ no pueden calcularse. Insights muestra un mensaje informativo y no genera alertas hasta tener datos suficientes.
- **Empresa estacional**: si tu negocio tiene alta estacionalidad (turismo, hosteleria, agricultura), los deltas QoQ pueden disparar muchas alertas falsas en temporada alta/baja. Ajusta los umbrales o usa la comparacion **YoY** (ano contra ano) en lugar de QoQ desde **Insights** → **Configuracion** → **Modo comparacion**.
- **Categorias sin historial**: una categoria de gasto nueva (sin datos en trimestres anteriores) genera un falso positivo de +100%. Frihet marca estas anomalias con etiqueta **Nueva categoria** y las excluye del calculo de severidad.
- **Latencia de datos**: los insights se recalculan cada 6 horas. Un gasto registrado ahora puede tardar hasta 6 horas en aparecer en el panel de insights.

## Relacionado

- [Que puede hacer el asistente IA](./que-puede-hacer)
- [Dashboard fiscal](../dashboard-fiscal)
- [Informes de cumplimiento](../informes/informes-cumplimiento)
- [Prevision de tesoreria](../informes/prevision-tesoreria)