# thesis_analytics_export.py

Skript `thesis_analytics_export.py` slouží k vytvoření reprodukovatelného balíčku analytických výstupů pro demonstrační účely v diplomové práci.

## co skript exportuje

Skript postupně stáhne a uloží:
- přehled konverzací,
- měsíční vývoj konverzací,
- přehled odpovědí a jejich kvality,
- měsíční vývoj kvality odpovědí,
- nejčastější témata,
- trendující témata,
- témata s nezodpovězenými dotazy,
- přehled spokojenosti,
- měsíční vývoj spokojenosti,
- témata spojená s nespokojeností,
- agregované FAQ clustery pro vybrané entity,
- volitelně i detailní statistiky vybraných témat.

Výstupy jsou ukládány jako samostatné JSON soubory a současně i jako jeden společný soubor `analytics_bundle.json`.

## příklad spuštění

```bash
python scripts/thesis_analytics_export.py \
  --base-url https://example.com/api \
  --token "$TOKEN" \
  --customer-id 123 \
  --entity-id 10 \
  --entity-id 11 \
  --start-time 2025-01-01T00:00:00Z \
  --end-time 2025-12-31T23:59:59Z \
  --topic-name "Parkování" \
  --topic-name "Odpad" \
  --output-dir ./exports/thesis_demo
```

## popis parametrů

- `--base-url`
  - základní URL adresa API, ze kterého se analytická data stahují
  - příklad: `https://example.com/api`
- `--token`
  - autentizační bearer token pro přístup k API
  - používá se pouze při autorizovaném čtení dat
- `--customer-id`
  - identifikátor analyzovaného zákazníka
  - určuje, pro který subjekt budou analytické výstupy exportovány
- `--entity-id`
  - volitelný filtr na jednu nebo více konkrétních entit
  - parametr lze uvést opakovaně
- `--start-time`
  - počáteční čas exportovaného období ve formátu ISO-8601
  - příklad: `2025-01-01T00:00:00Z`
- `--end-time`
  - koncový čas exportovaného období ve formátu ISO-8601
  - příklad: `2025-12-31T23:59:59Z`
- `--topic-name`
  - volitelný název tématu, pro které se mají exportovat detailní tematické statistiky
  - parametr lze uvést opakovaně
- `--output-dir`
  - cílový adresář, do kterého budou JSON soubory uloženy
- `--timeout`
  - maximální délka HTTP požadavku v sekundách