kaffeeliste/README.md

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 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/migration/ fuer die webbasierte Legacy-Migration

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.

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.