Files
kaffeeliste/README.md
T
clemens cb6e4e7dcb Add guided installer for SaaS application setup
- Updated README.md to include instructions for guided installation on webspace without shell access.
- Enhanced installationshandbuch.md with detailed steps for using the guided installer.
- Modified saas-app/README.md to summarize the installation process using the new installer.
- Generated SQL migration bundle now includes timestamp for better tracking.
- Introduced public/install/index.php as the entry point for the guided installer.
- Updated public/index.php to reflect changes in installation steps and added links to the installer.
- Refactored migration bundle generation and SQL execution scripts for improved error handling and modularity.
- Implemented session-based CSRF protection in the installer.
- Added form handling for environment variable configuration and migration execution in the installer.
- Created a user-friendly HTML interface for the installer with status messages and error handling.
2026-03-21 20:18:41 +01:00

2.0 KiB

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

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 SQL Server 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.