kaffeeliste/saas-app

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. Webserver auf public/ ausrichten.
2. Im Browser https://deine-domain.tld/install/ aufrufen.
3. .env, DB-Zugang und Tenancy-Werte ueber den Installer speichern.
4. SQL-Bundle erzeugen und wenn moeglich Migrationen direkt ausfuehren.
5. Installer sperren.
6. Einen ersten Mandanten und erste Benutzer anlegen.
7. Cron-Jobs fuer Queue, Import, Export und Benachrichtigungen einrichten.

Alternative mit PHP-CLI:

1. php ../scripts/check-prerequisites.php
2. php ../scripts/install-saas.php
3. php ../scripts/run-sql-migrations.php --connection=mysql --server=... --database=...

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_mysql lokal oder auf dem Hosting nicht verfuegbar ist, muss das erzeugte SQL-Bundle manuell gegen MySQL/MariaDB 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.