# SaaS First Zielbild

Dieses Repository wird schrittweise von der Legacy-PHP-Anwendung auf eine
mandantenfaehige SaaS-Struktur umgestellt. Das neue Zielprojekt liegt in
`saas-app/`. Der Root-Bestand bleibt nur noch als Referenz fuer die bestehende
Fachlogik erhalten.

## Was in die SaaS-Version gehoert

Der fachliche Kern der bisherigen Anwendung ist klein und wird in der neuen
Version gebuendelt:

- Dashboard mit Kontostand und aktueller Uebersicht
- Mitgliederverwaltung pro Mandant
- Einzahlungen und Kaffee-Striche als Ledger-Buchungen
- Hinweise, FAQ und einfache Inhalte
- Export- und Import-Funktionen fuer den operativen Betrieb
- Mandanten- und Rollenverwaltung

## Was bewusst entfallen kann

Diese Bereiche sind fuer den ersten SaaS-Stand nicht zwingend notwendig und
koennen spaeter nachgezogen oder ganz entfallen:

- Jahresauswertung als Sonderprozess
- CSV-Sonderlogiken aus der alten Webanwendung
- manuelle Mail-Sammelaktionen ohne Workflow-Einbindung
- Umfrage-Module, sofern sie fachlich nicht mehr benoetigt werden
- alte PHP-Einzeldateien im Root, sobald die SaaS-Variante produktiv ist

## Migrationspfad

1. Legacy-Fachlogik aus dem Root als Referenz verstehen.
2. Kernbereiche in `saas-app/` neu umsetzen.
3. Datenmodell auf Mandanten, Benutzer, Mitglieder, Buchungen und Inhalte
   normalisieren.
4. Root-Anwendung nur noch fuer die Uebergangsphase vorhalten.
5. Nach erfolgreichem Cutover alte Root-Seiten deaktivieren oder archivieren.

## Technische Leitplanken

- `saas-app/` ist die Zielstruktur.
- Der Betrieb ist auf klassisches PHP-Hosting ausgerichtet.
- Cron-Jobs ersetzen dauerhafte Worker.
- OIDC ist der bevorzugte SSO-Pfad.
- Blade-Views und SSR sind fuer einfache Hosting-Setups vorgesehen.

## Derzeitiger Stand

Das Zielgeruest ist bewusst schlank gehalten. Es beschreibt die Architektur und
die Aufteilung der Module, ersetzt aber noch kein voll installiertes Laravel-
Projekt mit lauffaehiger Runtime.
