> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getovra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Intelligenz

> Spend-Analytics, Risk-Scoring, Anomalie-Detection und Audit-Trails.

Intelligenz ist die Observability-Säule. Echtzeit-Sichtbarkeit über jeden Agent und jede Transaktion, mit append-only Audit-Storage und optionalem AI-Insight pro Signal.

## Was du bekommst

<CardGroup cols={2}>
  <Card title="Spend-Analytics" icon="chart-line">
    Daily/Weekly/Monthly Rollups pro Agent, Karte, Merchant. Recharts-basiertes Dashboard plus CSV-Export.
  </Card>

  <Card title="Anomalie-Engine" icon="radar">
    Statistische Drift-Detection auf Spend-Patterns. Background-Loop läuft beim API-Startup; surface ungewöhnliche Deltas bevor sie kompoundieren.
  </Card>

  <Card title="Forecaster" icon="trending-up">
    Naive lineare Projektion pro Agent und Karte. Nützlich für Budgeting, nicht für Pricing.
  </Card>

  <Card title="In-House Narrative" icon="sparkles">
    Jede Anomalie und jeder Forecast wird mit einer template-basierten Erklärung gepaart, die in-process generiert wird. Kein externer LLM, kein API-Key, deterministisch.
  </Card>
</CardGroup>

## Audit-Log — append-only auf DB-Layer

Jede State-Change schreibt in `audit_events`. Die Tabelle hat `PG RULES` die `UPDATE` und `DELETE` zu `NOTHING` umschreiben — es gibt keinen Pfad, weder Application noch DBA, History zu mutieren.

Ein Runtime-Sanitizer schrubbt vor dem Persistieren Werte die Luhn (PAN), Bearer/API-Key-Patterns oder andere Key-Heuristiken matchen. Logs von Kartendaten sind physisch unmöglich zu schreiben.

### Audit-Log abfragen

```bash theme={}
curl "https://api.getovra.com/audit?actorType=agent&action=card.issue&from=2026-01-01" \
  -H "Authorization: Bearer $OVRA_API_KEY"
```

Filter nach `actorType`, `resourceType`, `action` (`a.b` oder `a.*`), `range`, `correlationId`, Freitext `q`. Cursor-paginated.

### CSV-Export

```bash theme={}
curl "https://api.getovra.com/audit/export?from=2026-01-01" \
  -H "Authorization: Bearer $OVRA_API_KEY" \
  -o audit.csv
```

Streaming, 500-row Batches, Hard-Cap 50.000 Rows pro Request.

## Decision-Logs

Jede Policy- und Risk-Auswertung schreibt eine Row in `decision_logs` mit vollem Input-Snapshot, Signal-Scores, Reason und Action. Inspizieren via `/audit` oder `/risk/violations`. Das ist worauf Auditoren achten — nicht „was hat der Agent getan" sondern „was hat das System entschieden und warum".

## Access-Events

Sensible Operations (Card-PAN-Reveal, GDPR-Delete, Secret-Reveal) schreiben separat in `access_events`. Das ist die Surface die dein Security-Team abonniert.

## Korrelation über Systeme

Jede Response trägt:

* `X-Request-Id` — UUIDv7, auch gestempelt auf Intents, Transactions, Transfers, Ledger-Einträgen
* `X-Ovra-Run` — Workflow-Korrelation über mehrere Agent-Calls

Damit lässt sich ein Customer-Support-Ticket von der User-Message bis zum Ledger-Eintrag der das Geld bewegt hat tracken.

## PDF-Reports

`pdfkit`-generierte Monatsabschlüsse mit Charts. Nützlich für Finance-Close. Verfügbar in Business und Enterprise.

## Dashboard-Surfaces

| Page                       | Was sie zeigt                                              |
| -------------------------- | ---------------------------------------------------------- |
| `/dashboard/overview`      | 30-Tage-Spend, aktive Agents, Recent Activity              |
| `/dashboard/analytics`     | Daily Trend, Cost-per-Agent, Top-Merchants                 |
| `/dashboard/activity`      | Konsolidierter Spend + Audit + Risk + Disputes mit Filtern |
| `/dashboard/audit`         | Production-grade Audit-Log mit Row-Drawer + CSV-Export     |
| `/dashboard/risk`          | Decision-Logs gefiltert auf Denied + Review                |
| `/dashboard/access-events` | Sensitive-Data-Access-Trail                                |

## Plan-Tier-Matrix

| Capability           | Free    | Starter | Business           | Enterprise  |
| -------------------- | ------- | ------- | ------------------ | ----------- |
| TX-History-Retention | 30 Tage | 90 Tage | 365 Tage           | 5 Jahre     |
| Audit-Log            | –       | –       | –                  | ✓           |
| Spend Intelligence   | basic   | basic   | spend-intelligence | custom      |
| Disputes Management  | –       | view    | full               | full + auto |

Siehe [Preise](/de/pricing) für die volle Matrix.

## Weiter

<CardGroup cols={2}>
  <Card title="Compliance" icon="scale-balanced" href="/de/concepts/compliance">
    DSGVO-Posture, Datenresidenz, was wir löschen vs anonymisieren.
  </Card>

  <Card title="Webhooks" icon="bell" href="/de/concepts/webhooks">
    Dieselben Signale in deinen eigenen Observability-Stack pushen.
  </Card>

  <Card title="Steuerung" icon="shield-check" href="/de/concepts/control">
    Die Engines die die Decisions produzieren, die Intelligenz aufzeichnet.
  </Card>

  <Card title="Disputes" icon="gavel" href="/de/concepts/disputes">
    Wo Audit-History auf Chargeback-Evidence trifft.
  </Card>
</CardGroup>