feat: DB backend and API implemementation

development-system/database/README.md

@@ -35,3 +35,23 @@ Der Import bricht ab, wenn die versionierten Contao-Tabellen bereits Inhalte ent
 ## Medien
 
 Medien gehören als Dateien nach `development-system/files/` und werden in Git eingecheckt. Sobald Contao-Medien verwendet werden, muss der Seed zusätzlich die Metadaten aus `tl_files` enthalten. Das ist absichtlich noch nicht automatisiert, weil die aktuelle Datenbank nur Verweise auf nicht versionierte lokale Dateien enthält.
+
+## Terminbuchungs-Migrationen
+
+Die Terminbuchung verwendet absichtlich keine Contao-Tabellen. Ihre separat
+versionierten SQL-Migrationen liegen unter `database/migrations/`. Jede Datei
+ist eigenständig und idempotent; sie kann deshalb auch später einzeln auf dem
+Produktivsystem ausgeführt werden.
+
+Lokal werden alle Migrationen in Dateireihenfolge ausgeführt mit:
+
+```powershell
+.\scripts\Invoke-BookingMigrations.ps1
+```
+
+Für ein Produktivsystem wird die jeweilige Datei mit einem dort berechtigten
+MariaDB-/MySQL-Client ausgeführt. Zugangsdaten gehören dabei in die
+Betriebskonfiguration und niemals in die SQL-Datei oder das Repository. Die
+erste Migration erstellt `sufw_booking_events` und
+`sufw_booking_registrations` sowie neun ungefährliche Demo-Termine für beide
+Instanzen.