Files
kaffeeliste/saas-app
clemens 70e6d59c63 Refactor installation scripts and update documentation
- 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.
2026-03-21 19:49:52 +01:00
..
2026-03-20 15:31:03 +01:00
2026-03-20 15:31:03 +01:00
2026-03-20 15:31:03 +01:00
2026-03-20 15:31:03 +01:00

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:

  1. php ../scripts/check-prerequisites.php
  2. php ../scripts/install-saas.php
  3. .env aus .env.example ableiten und anpassen.
  4. Datenbank und Tenancy-Werte konfigurieren.
  5. SQL-Migrationen ueber das erzeugte Bundle ausfuehren.
  6. Einen ersten Mandanten und erste Benutzer anlegen.
  7. Den Webserver auf public/ ausrichten.
  8. 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.