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 fuer Zielbild und Scope.
2. Nutze docs/installationshandbuch.md fuer Setup, Hosting und Betriebsablauf.
3. Arbeite anschliessend in 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.