# Kaffeeliste SaaS Workspace

Dieses Repository ist jetzt `SaaS-first` organisiert.

- `saas-app/` enthaelt die neue Zielanwendung fuer die mandantenfaehige
  Kaffeeliste.
- `docs/` enthaelt Architektur- und Installationsdokumentation.
- `legacy-app/` enthaelt den bisherigen PHP-Bestand als archivierte Referenz fuer
  fachliche Orientierung.

## 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.

Auf Webspace ohne Shell ist der bevorzugte Einstieg die gefuehrte Installation
unter `saas-app/public/install/`.

Nach dem Setup gibt es jetzt zwei zentrale Web-Einstiege:

- `saas-app/public/admin/login/` fuer den Global-Admin
- `saas-app/public/admin/` fuer die zentrale Verwaltung
- `saas-app/public/admin/updates/` fuer den webbasierten Update-Prozess

## SaaS-Betrieb

Die aktuelle Ausbaustufe enthaelt bereits die wichtigsten SaaS-Bausteine:

- Lizenzplaene pro Mandant mit Funktionsfreischaltung
- Mandanten-Einstellungen fuer Preise, PDF-Listen und Kommunikation
- Drucklisten als PDF-Ansicht plus Nacherfassung von Vorder- und Rueckseite
- Basis-Exporte fuer Mitglieder und Ledger als CSV
- Global-Admin-Zugriff zum direkten Oeffnen eines Mandanten

## Hilfsskripte

- `scripts/check-prerequisites.php` prueft lokale Voraussetzungen.
- `scripts/prepare-saas-env.php` legt aus `.env.example` eine lokale `.env` an.
- `scripts/install-saas.php` fuehrt den lokalen Setup-Grundlauf aus.
- `scripts/build-migration-bundle.php` baut die SQL-Migrationen zu einer Datei.
- `scripts/run-sql-migrations.php` fuehrt die SQL-Migrationen direkt per PDO fuer den konfigurierten DB-Treiber aus.
- `scripts/run-updates.php` fuehrt nachtraegliche System-Updates per PHP aus.

## Hinweise Zum Umbau

- `legacy-app/` ist absichtlich nicht geloescht, sondern als Referenz fuer
  fachliche Detailfragen 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.