Přeskočit obsah

Integrace (INTEGRATIONS.md)

Tento dokument popisuje strategii integrace s externími systémy na základě analýzy dostupné dokumentace.

1. POHODA (Ekonomický systém)

Škola používá systém Pohoda pro účetnictví a fakturaci. Cíl: Automatizace fakturace školného/stravného a přenos plateb.

Technické Možnosti

Dle příručky Ekonomický systém POHODA (2024), kapitola 16 (Datová komunikace):

  1. XML Import/Export (Kapitola 16/6, str. 498)

    • Pohoda podporuje nativní XML formát pro výměnu dat.
    • Režim: Dávkový (soubor se nahraje do složky, Pohoda ho zpracuje).
    • Využití: Generování faktur za školné (Kosmo -> XML -> Pohoda).

  2. POHODA mServer (Kapitola 16/10, str. 511)

    • HTTP server běžící nad Pohodou.
    • Umožňuje zasílat XML požadavky přes API (např. dotaz na stav úhrady faktury).
    • Výhoda: Online komunikace (není třeba ručně přenášet soubory).
    • Nevýhoda: Vyžaduje veřejnou IP nebo VPN do školy (běží lokálně).

Doporučená Strategie (Fáze 2/3)

  • MVP: Generování XML souborů (Faktury) v aplikaci Kosmo, které účetní ručně nahraje do Pohody.
  • Cílový stav: Využití mServeru pro automatické párování plateb (rodič vidí v aplikaci "Zaplaceno").
  • Dopad na uživatele:
    • Rodič: Vidí ve Feedu 💳 stav platby ("Školné únor: zaplaceno ✅" / "Splatnost: 15.2.").
    • Ředitel: Dashboard s přehledem nezaplacených ("3 rodiče po splatnosti, celkem 25 500 Kč.").
    • Administrativa: Přehled faktur, automatické upomínky, export pro účetní.

1.5. CRM & Project Management (Interní rozhodnutí)

Detailní analýza včetně srovnání alternativ viz DECISION_PM.md.

CRM (Vztahy s rodiči vs. Leads)

  • Leads (Zájemci o školu): Používáme HubSpot Free.
    • Integrace: Outlook add-in (teď) → Gmail Extension (po migraci). Calendar Sync.
    • Pipeline: Nový kontakt → Telefonát → Prohlídka → Přihláška → Zapsán
    • Důvod: Pipeline management (Zájemce -> Prohlídka -> Zápis).
    • Hybridní režim: Ředitel (Gmail) + Kancelář (Outlook) mohou pracovat současně — HubSpot umožňuje každému uživateli vlastní email provider.
  • Rodiče (Klienti): Používáme Kosmo "AI Podatelna".
    • Důvod: Kontext dětí (známky, docházka). HubSpot nevidí do školních dat.
    • Emaily od rodičů se forwardují do Kosmo (Ticket System).

Project Management (Úkoly týmu)

  • Nástroj: Asana Free (10 interních uživatelů + neomezení hosté/rodiče).
  • Hosté: Rodiče zapojení do stavebních projektů (šatna, zahrada, statek) získají bezplatný přístup jen k „svému" projektu.
  • Gemini: Od ledna 2026 existuje Asana Gemini Workspace Connector (Google Marketplace) — Vortex vidí do Asany přes side panel.
  • Důvod: Stavět vlastní task manager v Kosmo je drahý nesmysl.
  • Pravidlo: Kosmo řeší školní agendu (omluvenky, evidence). Asana řeší provozní agendu (opravit lavici, připravit den otevřených dveří, dostavba šatny).
  • Migrace MS365→Google: Asana je platformově nezávislá — jen se přepojí email integrace, žádná migrace dat.

2. ŠkolaOnline (Školní Matrika)

ŠkolaOnline je hlavní evidenční systém (matrika). Cíl: Synchronizace žáků a rodičů (Single Source of Truth), přenos známek/omluvenek.

Analýza Dokumentace

Dokumentace naznačuje velmi komplexní datový model (tisíce polí pro MŠMT výkaznictví). - Struktura: Hierarchická (Kraje -> Školy -> Žáci -> Vzdělávací plány). - Data: Obsahuje citlivé údaje (RČ, zdravotní znevýhodnění, IVP).

Doporučená Strategie

  • Jednosměrná synchronizace (ŠkolaOnline -> Kosmo):
    • ŠkolaOnline je "master" pro seznam žáků.
    • Kosmo si stahuje data (ideálně přes API nebo noční CSV export).
  • Omluvenky:
    • Rodič zadá v Kosmo -> Kosmo pošle email učiteli / pokusí se zapsat do ŠOL (pokud API dovolí).

3. Google Workspace (Identita & Dokumenty)

Cíl: Single Sign-On (SSO) a úložiště. - Auth: OAuth 2.0 (přihlašování školním Google účtem). - Drive: Ukládání studentských prací (Evidence). Každý žák/třída může mít Shared Drive. - Docs/Sheets: Export reportů (vysvědčení, hodnocení).

4. Strava.cz (Školní Jídelna)

Cíl: Zobrazení jídelníčku v aplikaci (a odpovědi přes AI: "Co je dnes k obědu?").

Technické Možnosti

  • XML Feed (Oficiální): Strava.cz nabízí XML feed jídelníčku pro každou jídelnu.
    • URL: https://www.strava.cz/strava/...?xml=true&cisloJidelny=XXXXX
    • Stačí znát ID jídelny školy.
  • Neoficiální API: Existují komunitní projekty (OpenStravaCZ/StravaProtocol) s dokumentací protokolu.

Doporučená Strategie

  • MVP: Denní cron stáhne XML feed → uloží do DB/Knowledge Base → Sofie odpovídá.
  • TODO: Zjistit ID jídelny školy Sofie a ověřit XML feed.
  • Budoucnost: Objednávání obědů přes appku (pokud API dovolí).

5. Sofie Specifika (z Sofie - popis.pdf)

Dokument popisuje vzdělávací model, který musí Kosmo podporovat: - Slovní hodnocení: Nutnost rich-text editorů, ne jen známky 1-5. - Kompetence: Vazba na RVP (Klíčové kompetence). Evidence musí umožnit tagování ("Komunikativní", "Sociální"). - IVP: Individuální plány pro žáky se znevýhodněním (pole v databázi pro přílohy/cíle pro AI analýzu). - CLIL / Bilingvální třídy: Škola má bilingvální třídy s rodilými mluvčími i rodiče-expaty. - UI: Čeština + Angličtina (i18n od začátku — next-intl). - AI odpovědi: Sofie odpovídá v jazyce rodiče (auto-detect nebo nastavení profilu). - Reporty: Dvojjazyčné výstupy (česky pro MŠMT, anglicky pro expaty).