Wie Kinhavn gebaut ist

flowchart TB
  subgraph OP["Betreiber · central.kinhavn.de"]
    direction LR
    UI["Betreiberoberfläche"] --- ZE["Zentrale<br/>:4510 · KinhavnCentral"]
  end
  subgraph FAM["Zuhause · Familie"]
    direction LR
    C1["Client<br/>PWA · Android · iOS"] -- "IF-01<br/>Geräte- + Sitzungstoken" --> HS["Home Server<br/>:4520 · KinhavnHome"]
    HS -- "IF-06" --> OL1["Ollama<br/>Modelle + Guard"]
    HS -- "IF-08" --> SX1["SearXNG"]
    HS -. "IF-06 nur mit Freigabe" .-> API["KI-Anbieter<br/>eigener Zugang"]
  end
  subgraph SCH["Schule · Verein"]
    direction LR
    C2["Client"] -- "IF-01" --> SS["School Server<br/>:4530 · KinhavnSchool"]
    SS --> GW["Gateway +<br/>Warteschlange"] --> GPU["GPU-Modelle<br/>nur lokal"]
  end
  FAM -. "IF-02 · signiert<br/>Anmeldung · Herzschlag · Sicherung" .-> OP
  SCH -. "IF-03 · signiert" .-> OP
  classDef prod fill:#1b3a5c,stroke:#0f1f33,color:#ffffff
  classDef aux fill:#f7f5ef,stroke:#1b3a5c,color:#0f1f33
  classDef ext fill:#ffffff,stroke:#5b6673,color:#0f1f33,stroke-dasharray:5 4
  class HS,SS,ZE prod
  class C1,C2,OL1,SX1,GW,GPU,UI aux
  class API ext

flowchart BT
  contracts["@kinhavn/contracts<br/>OpenAPI · Signaturen · Sicherungsformat · Altersband-Schemata"]
  totp["@kinhavn/totp<br/>zweiter Faktor RFC 6238"]
  agent["@kinhavn/site-agent<br/>Anmeldung · Herzschlag · Sicherung"]
  core["@kinhavn/server-core<br/>Chat · Policy · Modelle · Suche · Budgets · Audit · Persistenz"]
  central["@kinhavn/central<br/>Zentrale"]
  home["@kinhavn/home-server"]
  school["@kinhavn/school-server"]
  client["@kinhavn/client-web<br/>React · Vite · PWA"]
  agent --> contracts
  core --> contracts
  core --> totp
  central --> contracts
  central --> totp
  home --> core
  home --> agent
  school --> core
  school --> agent
  client --> contracts
  classDef prod fill:#1b3a5c,stroke:#0f1f33,color:#ffffff
  classDef lib fill:#f7f5ef,stroke:#1b3a5c,color:#0f1f33
  class central,home,school,client prod
  class contracts,totp,agent,core lib

sequenceDiagram
  autonumber
  actor B as Betreiber
  participant Z as Zentrale
  actor E as Elternteil
  participant H as Home Server
  B->>Z: Lizenz anlegen (Art home, Updates bis)
  Z-->>B: Aktivierungscode, einmal angezeigt, 30 Tage
  B-->>E: Code (E-Mail, Papier)
  E->>H: Verwaltung → „Bei der Zentrale anmelden“ + Code
  H->>H: Ed25519-Schlüsselpaar erzeugen
  H->>Z: POST /enroll {Code, Art, öffentlicher Schlüssel, Version}
  alt Code gültig, unbenutzt, Art passt
    Z-->>H: 201 {Server-ID, Updates bis, Schlüssel der Zentrale}
  else irgendetwas falsch
    Z-->>H: 400 ENROLL_REFUSED (ohne Grund)
  end
  loop jede Minute
    H->>Z: POST /beat (signiert: Zustand, Version, Last — keine Inhalte)
    Z-->>H: Lizenzstand, Status, Serverzeit
  end
  Note over H: jede Nacht 03:00 lokale Sicherung (7 Stände)
  H->>Z: wöchentlich POST /backup (AIFB1, versiegelt)
  Z-->>H: gespeichert (3 Stände je Server)

stateDiagram-v2
  [*] --> offen: Lizenz angelegt
  offen --> aktiviert: Server meldet sich mit Code an
  aktiviert --> gesperrt: Betreiber sperrt Server
  gesperrt --> aktiviert: Betreiber gibt frei
  aktiviert --> offen: Server stillgelegt, Schlüssel widerrufen, Lizenz frei für neuen Code
  aktiviert --> zurückgezogen: Lizenz zurückgezogen
  offen --> zurückgezogen: Lizenz zurückgezogen
  zurückgezogen --> [*]
  note right of gesperrt
    signierte Anfragen: 403 SERVER_SUSPENDED
    Home Server arbeitet weiter
  end note

sequenceDiagram
  autonumber
  actor E as Elternteil
  participant H as Home Server
  participant G as Gerät des Kindes (Client)
  actor K as Kind
  E->>H: Kopplungscode für Familiengerät
  H-->>E: QR (Adresse + Geheimnis) · Code, 10 Min., einmalig
  G->>H: POST Kopplung mit Code
  H-->>G: Gerätetoken (nur für diesen Server, widerrufbar)
  Note over G: Token in IndexedDB bzw. sicherem Speicher der App
  K->>G: Profil wählen + PIN
  G->>H: Anmeldung (Authorization: Gerätetoken, PIN)
  H-->>G: Sitzungstoken (kurzlebig)
  G->>H: API-Aufrufe mit Authorization: Sitzungstoken, keine Cookies
  Note over G,H: Ein zweiter Server (Schule) bekommt eigene Token – der Client mischt nie Daten zweier Server

sequenceDiagram
  autonumber
  participant G as Client
  participant P as Policy-Schicht (Server)
  participant B as Budget
  participant M as Modell (lokal oder API)
  participant A as Audit · Lineage
  G->>P: Frage eines Kindes
  P->>P: Altersband aus Geburtsdatum im Schema ableiten
  P->>P: Regeln zusammenführen (Band · Profil · Schule), deny-wins
  P->>P: Eingang prüfen: Schlüsselwörter, Jailbreak, Guard-Modell
  alt Prüfung nicht möglich
    P-->>G: KI pausiert, verständliche Meldung
  else freigegeben
    P->>B: Obergrenze reservieren (Minuten, Tokens, €)
    P->>M: Anfrage mit Band-Prompt
    M-->>P: Antwort als Stream
    P->>P: Ausgang laufend prüfen (Stream-Screening)
    P-->>G: Antwort, als KI gekennzeichnet
    P->>B: exakt abrechnen
  end
  P->>A: Lauf als hash-verketteter Baum
  opt Krisensignal
    P->>A: Vorfall
    P-->>G: Hinweis an zuständige Erwachsene, ohne Textauszug
  end

flowchart TB
  subgraph H["Home Server"]
    T1["Topf der Familie<br/>Woche/Monat · Minuten · Tokens · € für API"] --> K1["Kind 1"]
    T1 --> K2["Kind 2"]
    T1 --> R1["Rest → Aufstockung durch Eltern"]
  end
  subgraph S["School Server"]
    T2["Topf der Schule<br/>Woche · Monat · Halbjahr · Minuten · Tokens"] --> G1["Lerngruppe Mathe 7b"]
    T2 --> G2["Kurs Informatik Q1"]
    T2 --> G3["AG Robotik"]
    G1 --> S1["Schüler·innen, gleichmäßig"]
    G2 --> S2["Schüler·innen"]
    G3 --> S3["Schüler·innen"]
  end

flowchart LR
  W["24 Wörter<br/>Wiederherstellungscode<br/>(nur auf Papier)"] -- "scrypt" --> K["Haushaltsschlüssel<br/>.data/household.key"]
  D["Daten des Haushalts"] --> S["Sicherung AIFB1<br/>AES-GCM"]
  K --> S
  S -- "jede Nacht 03:00" --> L["Ordner auf dem Server<br/>7 Stände"]
  S -- "wöchentlich, falls angemeldet" --> Z["Zentrale<br/>3 Stände, unlesbar"]
  L --> R["Neuer Home Server:<br/>Einrichtung → Wiederherstellen"]
  Z --> R
  W --> R
  classDef key fill:#f6e3b4,stroke:#e9a830,color:#0f1f33
  classDef store fill:#1b3a5c,stroke:#0f1f33,color:#ffffff
  class W,K key
  class L,Z store

flowchart TD
  Q["Anfrage einer Schülerin<br/>im Unterricht"] --> F{"Gateway frei?"}
  F -- ja --> M["Modell der Gruppe antwortet"]
  F -- nein --> W["Warteschlange<br/>höchstens 60 s"]
  W --> F2{"frei geworden?"}
  F2 -- ja --> M
  F2 -- nein --> S{"kleineres lokales<br/>Modell eingerichtet?"}
  S -- ja --> MS["kleines Modell antwortet"]
  S -- nein --> N["Hinweis: Alle sind gerade dran,<br/>gleich nochmal versuchen"]
  X["Wartungsfenster"] -.-> N2["Hinweis nennt das Ende"]
  classDef ok fill:#2f7d6b,stroke:#0f1f33,color:#ffffff
  classDef warn fill:#f6e3b4,stroke:#e9a830,color:#0f1f33
  class M,MS ok
  class N,N2 warn