Architektur

KitaManager folgt einem Clean-Architecture-Muster mit klarer Trennung der Verantwortlichkeiten.

Systemübersicht

    graph TB
    subgraph Frontend
        UI[Next.js 16 UI]
    end

    subgraph Backend
        API[Gin REST API]
        Auth[JWT Auth]
        RBAC[Casbin RBAC]
        Services[Geschäftslogik]
        Store[Datenzugriffsschicht]
    end

    subgraph Datenbank
        PG[(PostgreSQL)]
    end

    UI --> API
    API --> Auth
    API --> RBAC
    API --> Services
    Services --> Store
    Store --> PG

RBAC-Architektur

Die Anwendung verwendet ein hybrides RBAC-System:

Datenbank speichert Benutzer-Rolle-Organisation-Zuweisungen (auditierbar, abfragbar)
Casbin speichert Rolle-Berechtigung-Zuordnungen (optimierte Richtlinienauswertung)

Rollenhierarchie

Rolle	Geltungsbereich	Berechtigungen
Superadmin	Global	Vollständiger Systemzugriff
Admin	Organisation	Vollständiger Org-Zugriff
Manager	Organisation	Operativer Zugriff
Mitglied	Organisation	Nur-Lese-Zugriff
Personal	Organisation	Anwesenheitsverwaltung

Organisationsbezogene Ressourcen

Ressourcen, die zu einer Organisation gehören, verwenden URL-Muster:

/api/v1/organizations/{orgId}/employees
/api/v1/organizations/{orgId}/children
/api/v1/organizations/{orgId}/sections

Report-Tool

Ein eigenständiges CLI-Tool (tools/report-pdf/) erzeugt PDF-Berichte, indem es die Druckseiten des Frontends über Playwright rendert. Es ist unabhängig von API und Frontend — es authentifiziert sich per HTTP und erzeugt dieselben Diagramme und Tabellen, die Benutzer im Browser sehen.

    graph LR
    Report[report-pdf Tool] -->|Login| API
    Report -->|Druckseiten rendern| UI
    Report -->|E-Mail senden| SMTP[SMTP-Server]

Das Tool unterstützt zwei Modi:

Einmalig: PDF-Erzeugung über die Kommandozeile
Geplant: Langlebiger Dienst, der Berichte per E-Mail nach einem wöchentlichen oder monatlichen Zeitplan versendet (konfiguriert per YAML-Datei)

Berichte werden zu einem einzelnen PDF zusammengeführt mit den Bereichen Kinder, Belegung, Personal und Finanzen.

Datenfluss

Anfrage erreicht den Gin-Router
Middleware behandelt Authentifizierung und Autorisierung
Handler validiert Eingaben und ruft die Service-Schicht auf
Service implementiert Geschäftslogik
Store führt Datenbankoperationen aus
Antwort wird serialisiert und zurückgegeben

Erste Schritte API-Referenz