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).
- Interní nástroje pro učitele (PM Kanban, portfolio).
- AI asistentka Sofie (chat, email CC, hlas).
- CRM (Twenty):
- Správa leadů a zájemců o školu.
- Back Office (SaaS + Self-hosted):
- Ekonomika (Pohoda).
- Matrika (ŠkolaOnline).
- Knowledge Base (BookStack).
- Newsletter (Listmonk — Fáze 2+).
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
- Feed: Rodič otevře appku a vidí, co dítě dnes dělalo — fotky, aktivity, docházka. Jako Instagram školy.
- Sofie: AI asistentka, která odbavuje dotazy rodičů 24/7 a eskaluje na učitele jen to důležité.
- Evidence: Digitalizace prací žáka — fotka → AI štítek → v feedu rodiče.
- Bezpečnost: Google Auth, Apple Auth, Magic Links, Safety Gate pro vyzvedávání.
Struktura dokumentace
| Dokument | Obsah |
|---|---|
| Vize | Kontext školy, problémy, vize |
| Uživatelé | Role, user stories, onboarding |
| Požadavky | Funkční a nefunkční požadavky |
| Architektura | Tech stack, moduly, Feed |
| Datový model | Schema, ER diagramy |
| Sofie | AI persona, orchestrace, KB |
| Integrace | Storage, kanály, externí systémy |
| MVP | Scope a fázování |
| Deployment | Infrastruktura, prostředí, zálohy, CI/CD, denní workflow |
| Backlog | Fáze 2+ funkce, PM modul detail |
| Dev Log | Aktuální stav features, rozhodnutí |
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