# Kaffeeliste SaaS Workspace

Dieses Repository ist jetzt `SaaS-first` organisiert.

- `saas-app/` enthaelt die neue Zielanwendung fuer die mandantenfaehige
  Kaffeeliste.
- `docs/` enthaelt Architektur-, Installations- und Migrationsdokumentation.
- `legacy-app/` enthaelt den bisherigen PHP-Bestand als archivierte Referenz fuer
  Fachlogik und Datenmigration.

## Produktkern

Die SaaS-Version behaelt die wesentlichen Funktionen der alten Anwendung bei:

- persoenliches Dashboard mit Kontostand, Verbrauch und letzten Buchungen
- Mitgliederverwaltung pro Mandant
- Kaffee-Striche, Einzahlungen und Salden als gemeinsames Ledger
- Hinweise, FAQ und tenantbezogene Inhalte
- operative Importe, Exporte und Benachrichtigungen

Nicht mehr priorisierte Sonderseiten und Einmalskripte bleiben nur noch im
Archivbestand erhalten.

## Einstieg

1. Lies [docs/implementation-foundation.md](docs/implementation-foundation.md)
   fuer Zielbild und Scope.
2. Nutze [docs/installationshandbuch.md](docs/installationshandbuch.md) fuer
   Setup, Hosting und Betriebsablauf.
3. Arbeite anschliessend in [saas-app/README.md](saas-app/README.md) weiter.

## Hilfsskripte

- `scripts/check-prerequisites.ps1` prueft lokale Voraussetzungen.
- `scripts/prepare-saas-env.ps1` legt aus `.env.example` eine lokale `.env` an.

## Hinweise Zum Umbau

- `legacy-app/` ist absichtlich nicht geloescht, sondern als Referenz fuer die
  Daten- und Fachmigration verschoben.
- Das aktuelle `saas-app/` ist eine konsistente Zielarchitektur mit ueberarbeiteten
  Views, Modulgrenzen und Betriebsdokumentation.
- Ein vollstaendiges Laravel-Bootstrap mit Composer und Runtime bleibt der
  naechste technische Ausbauschritt.