# OlympOS — llms.txt

> Kratka dokumentacija za AI podršku. Ažuriraj po potrebi.

## Što je OlympOS
OlympOS je web platforma za pripremu hrvatske državne mature: vježbanje s NCVVO pitanjima, AI tutor po predmetima, generator zadataka, analitika, plan učenja, lektira (npr. Kiklop), bilježnica i upload gradiva.

## Glavne rute
- `/` — početna (marketing)
- `/login`, `/register` — autentikacija
- `/dashboard` — početna nakon prijave
- `/practice`, `/practice/[subject]` — vježbanje
- `/simulacija` — simulacija ispita
- `/vjezbanje/[subject]` — AI tutor za predmet
- `/generate` — AI generator zadataka
- `/analytics`, `/leaderboard` — napredak
- `/notebook` — bilježnica
- `/upload` — dodavanje gradiva
- `/lektira` — lektira po autorima
- `/plan` — plan učenja
- `/support` — podrška (ovaj agent)

## Česti problemi
1. **Ne mogu se prijaviti** — provjeri e-mail/lozinku; Google OAuth zahtijeva ispravan redirect URL u Supabase.
2. **Prazna pitanja u vježbanju** — u bazi trebaju biti `questions` za predmet; admin može pokrenuti seed SQL.
3. **Upload / PDF** — potreban `OPENAI_API_KEY` na serveru za neke funkcije; limit veličine datoteke 25 MB.
4. **Notebook / chat** — zahtijeva prijavu i konfigurirane API ključeve prema uputama u repou.

## Eskalacija
Ako ne znaš odgovor ili korisnik traži račun/naplatu/bazu, predloži slanje upita e-poštom putem gumba „Pošalji timu” na stranici podrške.

## Kontakt (placeholder)
Za produkciju zamijeni stvarnim support e-mailom u okolini (`SUPPORT_TO_EMAIL`).