- Replaced PowerShell scripts with PHP scripts for checking prerequisites and preparing the environment. - Added new PHP scripts: `check-prerequisites.php`, `prepare-saas-env.php`, `install-saas.php`, `build-migration-bundle.php`, and `run-sql-migrations.php`. - Updated README and installation documentation to reflect the new PHP scripts and installation steps. - Created a generated SQL migration bundle file structure and added SQL migration scripts. - Enhanced the public index page with navigation and installation steps. - Removed obsolete PowerShell scripts.
SaaS App
saas-app/ ist das Zielprojekt fuer die mandantenfaehige Neuimplementierung
der Kaffeeliste als SaaS.
Kurzueberblick
- Mandantenfaehigkeit ueber Host/Subdomain
- Rollen und Benutzerbindung pro Tenant
- Kernfunktionen fuer Dashboard, Mitglieder, Einzahlungen und Striche
- Inhalte, Hinweise, Importe, Exporte und Benachrichtigungen als eigene Module
- SSR-orientierter Betrieb fuer klassischen Webspace
- Cron-basierter Betrieb statt dauerhafter Worker
Installation
Die komplette Installationsanleitung steht im Repo unter
../docs/installationshandbuch.md.
Kurzfassung:
php ../scripts/check-prerequisites.phpphp ../scripts/install-saas.php.envaus.env.exampleableiten und anpassen.- Datenbank und Tenancy-Werte konfigurieren.
- SQL-Migrationen ueber das erzeugte Bundle ausfuehren.
- Einen ersten Mandanten und erste Benutzer anlegen.
- Den Webserver auf
public/ausrichten. - Cron-Jobs fuer Queue, Import, Export und Benachrichtigungen einrichten.
Migrationen
Aktuell gibt es in diesem Verzeichnis keine lauffaehige artisan migrate-Strecke.
Die Dateien unter database/migrations/ liefern SQL und werden ueber folgende
Skripte verarbeitet:
..\scripts\build-migration-bundle.php..\scripts\run-sql-migrations.php
Wenn pdo_sqlsrv lokal nicht verfuegbar ist, muss das erzeugte SQL-Bundle
manuell gegen SQL Server ausgefuehrt werden.
Migration Aus Dem Legacy-System
Die fachliche Roadmap und der Uebergang aus dem alten Root-System sind in
../docs/implementation-foundation.md beschrieben.
Der relevante Kern der alten Anwendung besteht im Wesentlichen aus:
- Dashboard und Kontostand
- Mitgliederverwaltung
- Kaffee-Striche
- Einzahlungen
- Hinweise und Inhalte
- Exporte und operative Hilfsfunktionen
Hosting-Hinweise
- Das Projekt ist fuer Webspace geeignet, solange PHP, DB-Zugang und Cron vorhanden sind.
- Dauerhafte Queue-Worker sind nicht vorausgesetzt.
- Der zentrale Einstieg erfolgt ueber die mandantenfaehige Weboberflaeche.
- OIDC ist als bevorzugter SSO-Pfad vorgesehen, klassische Logins bleiben als Fallback moeglich.
Aktueller Stand
Das Verzeichnis ist als Zielarchitektur vorbereitet. Es ersetzt den Legacy-Root noch nicht vollstaendig, sondern dient als naechster konsistenter Zielzustand fuer die SaaS-Umstellung.