SchulyBackend-Dokumentation

SchulyBackend ist die ASP.NET Core 10 API hinter Schuly. Sie folgt einer Clean Architecture mit CQRS (über Mediator), verwendet EF Core auf PostgreSQL, authentifiziert mit OIDC und hostet Plugins, die zur Laufzeit aus einer Registry geladen werden.

Übersicht

• Architektur - Schichtenmodell, Zuständigkeiten der Projekte, der Ablauf zum Hinzufügen einer Entität und der Plugin-Host.
• Setup
  • Entwicklung - die API und Postgres lokal ausführen.
  • Self-Hosting - Schritt für Schritt: den ganzen Stack auf deinem eigenen Server betreiben.
  • Konfiguration - Einstellungen, OIDC, Rollen, Connection-Strings.
  • Produktion - Docker-Image, Release-Ablauf, Startup-Migrationen.
• Migrationen - EF Core Migrationsskripte und Verhalten beim Start.
• Plugin-Verwaltung - Plugin-Registry zur Laufzeit, Hot-Swap, Admin-Endpunkte.
• Mitwirken - Workflow und Konventionen von Issue über Branch bis PR.