Glosář Kosmo / Sofie
Doménový slovník pro autonomní tým. Pokud termín zazní v /define dialogu, agent ho má najít zde místo aby ho re-derivoval. Žij dokumentem — když narazíš na pojem, který tu chybí, doplň ho (PR chore: glossary +<pojem>).
Brand & projekt
| Pojem |
Význam |
| Sofie |
Brand — vidí ho rodiče, učitelé, UI, chatbot. Doména sofie.education. |
| Sofie.Education |
Plný název produktu. |
| Kosmo |
Codename — interní označení v repo, tech docs, DB. Nikdy nepoužívej v UI. |
| ZŠ a MŠ Sofie |
Konkrétní škola v Říčanech, pilot / první zákazník. Nezaměňovat s brandem Sofie. |
| Sofie (AI persona) |
Chatbot postavený nad Gemini. Tyká, viz docs/SOFIE.md. |
Role v systému (DB enum profiles.role)
| Role |
Kdo to v reálu je |
MVP přístup |
teacher |
Průvodce — třídní učitel v Montessori terminologii. Většina učí v obou třídách. |
Plný (třídnice). |
parent |
Zákonný zástupce žáka. |
Žádný v MVP (jen kontakt v evidenci). |
director |
Ředitel školy. V Sofii zároveň majitel/data controller. |
Žádný v MVP (data zakládá vývojář). |
office |
Kancelář — administrativa, ŠkolaOnline sync. |
Žádný v MVP. |
pending |
Nový uživatel po prvním OAuth loginu, čeká na přiřazení role. |
Čekací obrazovka. |
student |
Žák. |
Žádný v MVP (od Fáze 4+ login pro 4.–7. třídu). |
Pedagogika / Montessori
| Pojem |
Význam |
| Třída |
Organizační jednotka v Kosmo. V Sofii: Kentaur (4.+5. ročník), Phenix (6.+7. ročník). DB tabulka classes. |
| Ročník |
Klasický stupeň (4., 5., 6., 7.). V Sofii dva ročníky v jedné třídě — heterogenní skupina, Montessori standard. |
| Slot |
Časový úsek v rozvrhu (typicky 90 min „blok práce"). DB tabulka schedule (slot × den × třída → předmět). |
| Téma |
Co se v daném slotu probírá. Přiřaditelné ročníku nebo konkrétnímu žákovi. DB tabulka topics. |
| Klíč |
Montessori prezentace lekce (např. „Golden Bead Addition"). Mapuje se na RVP kód. Synonymum „lekce" / „lesson" v TC API. |
| RVP |
Rámcový vzdělávací program — český kurikulární standard. Mapování Montessori → RVP je many-to-many. |
| TC |
Transparent Classroom — externí Montessori systém, dnes nasazený. Z něj se bude vytahovat kurikulum přes API. |
| Práce s materiálem |
Žák samostatně pracuje s konkrétní pomůckou (Montessori). Eviduje se přes fotku → Gemini Vision → competency record. |
Tech stack
| Pojem |
Význam |
| Web |
Adresář web/ — Next.js (App Router) + TypeScript + Tailwind + Shadcn/ui, pnpm. |
| Supabase |
Postgres + Auth + Storage + pgvector, region Frankfurt. Free plán, hosted. |
| RLS |
Row-Level Security — Supabase enforcement, každý query je filtrován per auth.uid(). Povinný pro každou tabulku se schválními daty. |
| Zod |
Schema validace na hraně server/client. Každý form i server action má Zod schema. |
| Server action |
Next.js mechanismus — RPC z UI do server kódu, alternativa REST endpointu. |
| Vertex AI / Gemini |
Google Cloud AI — gemini-flash-latest (laciné) a gemini-pro-latest (komplexní). Volané přímo z Next.js, ne přes n8n. |
| Resend |
SMTP/transactional email — odesílání. |
| Cloudflare Email Worker |
Příjem emailů na *@sofie.education → webhook. |
| Twenty |
CRM na GCP VM e2-small (samostatná infra, Fáze 3+ integrace). |
| BookStack |
Wiki pro učitele na stejné VM. |
| Sentry |
Runtime error tracking, region Frankfurt, Free 5k events/měs. |
Procesní pojmy
| Pojem |
Význam |
| PO |
Product Owner = Tomáš. Rozhoduje, schvaluje, neprogramuje. |
| DoR |
Definition of Ready — co musí nápad splňovat, aby šel přes /define. Viz AGENTS.md. |
| DoD |
Definition of Done — kdy je feature hotová. Viz AGENTS.md. |
| I³ |
Intent / Invariants / Implementation — metodologie pro spec-driven vibe development (zavedeno 2026-05-13). Viz AGENTS.md Methodology. |
| Intent brief |
1-stránkový dokument popisující WHAT a WHY feature. 4 sekce. Žije v docs/intent/<feature>.md. Výstup /define. |
| Invariant |
Pravidlo, které nesmí padnout ani při full rewriteu. Žije v docs/invariants.md. Critical má test v web/tests/invariants/. |
| ADR |
Architecture Decision Record — záznam architektonického rozhodnutí (proč X, ne Y). Append-only v docs/decisions/. |
| Next 3 |
Tři další nápady, které jsou „Ready for /define". Sekce v ideas/roadmap.md. |
| Merge gate |
Manuální checklist před merge do main (GitHub Free tier, žádné branch protection). |
| Greenfield optionality |
Žádná produkční data → přepsat je vždy legitimní varianta. Architekt je povinen ji zvážit. |
| Vibe coding |
Solo dev styl: Tomáš nepíše kód, popíše chování, agent realizuje. Verifikace přes Preview MCP + e2e. |
Doménová zkrácená slova
| Zkratka |
Význam |
U-XX |
User story ID v USERS.md (U-01 až U-08 v MVP). |
D1..D6, W1..W4, L1..L7, TC1..TC4 |
Otevřené otázky per feature v ideas/roadmap.md. |
MŠMT |
Ministerstvo školství. Export docházky/výkazů odsud — Fáze 4+. |
MŠ / ZŠ |
Mateřská škola / Základní škola. Sofie má obojí. |