Kosmo: Digitální Ekosystém Sofie
Tato dokumentace popisuje kompletní digitální strategii a softwarový stack pro ZŠ a MŠ Sofie.
Co je součástí ekosystému?
- Aplikace Kosmo (Custom Vývoj):
- Portál pro rodiče (Feed, docházka, evidence, omluvenky — Fáze 3+).
- Interní nástroje pro učitele (Třídnice — implementováno, PM Kanban — Fáze 2).
- AI asistentka Sofie (chat, email CC, hlas — Fáze 3+).
- CRM (Twenty):
- Správa leadů a zájemců o školu.
- Back Office (SaaS + Self-hosted):
- Ekonomika (Pohoda).
- Matrika (ŠkolaOnline).
- Knowledge Base (BookStack).
- Newsletter (Resend transactional — Fáze 3+).
Aplikace Kosmo (Core)
Kosmo je srdcem ekosystému. Je to "lepidlo", které spojuje data a lidi. Cílem projektu je vytvořit moderní, bezpečnou a AI-powered aplikaci, která sjednotí komunikaci, evidenci a procesy v Montessori škole Sofie (MŠ + ZŠ).
Klíčové vlastnosti
- Třídnice (implementováno): Učitel ráno otevře app a vidí, co učí a kdo chybí. Viz intent/classbook + intent/attendance.
- Feed (Fáze 3+): Rodič otevře appku a vidí, co dítě dnes dělalo — fotky, aktivity, docházka.
- Sofie (Fáze 3+): AI asistentka, která odbavuje dotazy rodičů 24/7 a eskaluje na učitele jen to důležité.
- Evidence (Fáze 2+): Digitalizace prací žáka — fotka → AI štítek → ve feedu rodiče.
- Bezpečnost: Google Auth, Magic Links, role gating. Viz intent/auth-and-roles + invariants.md.
Struktura dokumentace
Kontrakt (I³ metodologie)
| Dokument | Obsah |
|---|---|
| Intent briefs | Co aplikace dělá a proč — 1 brief per feature |
| Invariants | Pravidla, která nesmí padnout (kritická mají test) |
| Decisions (ADRs) | Architektonická rozhodnutí — proč X, ne Y |
Reference
| Dokument | Obsah |
|---|---|
| Vize | Kontext školy, problémy, vize |
| Uživatelé | Role, user stories, onboarding |
| Datový model | Schema, ER diagramy |
| Sofie | AI persona (Fáze 3+) |
| Integrace | Storage, kanály, externí systémy |
| MVP | Scope a fázování |
| Deployment | Infrastruktura, prostředí, zálohy, CI/CD |
| Dev Log | Narativní changelog rozhodnutí |
| Glossary | Doménový slovník |
Vize a nápady (nezávazné)
| Dokument | Obsah |
|---|---|
| Roadmap | Fáze 2+ nápady (dříve BACKLOG) |
| Feed vision | Rodičovský Feed, Sofie chatbot (Fáze 3+) |
| Sofie architecture | Sofie chatbot architektura (Fáze 3+) |
| Knowledge Graph | Universal Knowledge Graph (Fáze 4+) |
Rychlý start
Pro vývojáře: viz CLAUDE.md v rootu repa, nebo:
1. supabase start — lokální databáze
2. cd web && pnpm dev — Next.js na localhost:3000