# Gyors indítás – Praktikus Analytics Hub

**Állapot:** GA4-alapú MVP és Linux/Docker telepítő kész; a szerveredre még nincs telepítve.

## 1. Google-oldalon

- Google Cloud Console → új projekt → **Google Analytics Data API** engedélyezése.
- Service account létrehozása, JSON-kulcs készítése.
- GA4 tulajdon (`300252586`) → Tulajdon hozzáférés-kezelése →
  service account e-mail-címe **Viewer / Megtekintő** jogosultsággal.

## 2. Linux szerveren (Docker)

```bash
mkdir -p /opt/praktikus-analytics-hub
# Csomag tartalmát ide másold ki.
cd /opt/praktikus-analytics-hub
cp .env.example .env
```

A Cloudból kapott JSON-t **a saját gépedről** másold ide:
`secrets/ga4-service-account.json`. Ne töltsd fel ChatGPT-be.

```bash
chmod 600 secrets/ga4-service-account.json
id -u; id -g
# A kapott UID és GID értékeket írd az .env PUID és PGID sorába.
docker compose up -d --build

docker compose exec analytics-hub python -m analytics_hub.cli health
```

## 3. Használat már ChatGPT-bekötés előtt

```bash
docker compose exec analytics-hub python -m analytics_hub.cli realtime
docker compose exec analytics-hub python -m analytics_hub.cli overview --days 7
docker compose exec analytics-hub python -m analytics_hub.cli email --days 7 --keyword black_friday
```

## 4. ChatGPT-be kötés

Az MCP-végpont a Linux szerver **saját localhostján** van:
`http://127.0.0.1:8765/mcp`. Ez szándékos biztonsági korlátozás.
A ChatGPT-hez **Secure MCP Tunnel** (ha fiókodban elérhető) vagy OAuth-tal védett
publikus HTTPS proxy szükséges. Ne tedd közvetlenül publikusra az 8765-ös portot.

További részletek: `README.md`.
