Initial Kaffeekasse SaaS restart

2026-06-15 17:13:38 +02:00
commit b08eb93547
54 changed files with 4617 additions and 0 deletions
@@ -0,0 +1,52 @@
+# Kaffeekasse SaaS Neustart
+
+Frischer Neustart fuer eine mandantenfaehige Kaffeeliste mit:
+
+- klassischer Papierliste inklusive Nacherfassung
+- digitaler Selbstbuchung fuer Browser, Tablet oder Kiosk
+- vorbereitetem RFID-Pfad ueber Device-, Tag- und Event-Modelle
+- Netcup-tauglichem PHP/MySQL-Betrieb ohne Root-Zwang
+- produktionsnaher Vermarktungs- und Betriebsdokumentation
+
+## Projektziel
+
+Dieses Repository bildet eine pragmatische SaaS-Basis fuer mehrere Kunden oder
+Mandanten. Jeder Tenant arbeitet unter `t/{slug}` in einer getrennten
+Organisation, waehrend Produktlogik, Betrieb und Vermarktung zentral bleiben.
+
+## Kernentscheidungen
+
+- `PHP 8.x + MySQL` ohne schwere Runtime-Voraussetzungen
+- `public/` als einziger Webroot
+- `tenant_id` auf allen tenantbezogenen Fachtabellen
+- ein gemeinsames Ledger fuer `digital`, `paper` und spaeter `rfid`
+- Webspace-freundliche Cron- und CLI-Hooks statt Daemons
+
+## Hauptfunktionen
+
+- Plattform-Installation per Browser
+- Self-Service-Registrierung fuer neue Mandanten
+- Plattform-Admin mit Tenant-Uebersicht
+- Tenant-Login mit Rollen `owner`, `admin`, `member`
+- Mitglieder, Produkte und Preisgrundlagen
+- digitale Buchungen und Einzahlungen
+- Papierlisten als Entwurf, Zeilen und Ledger-Posting
+- RFID-Geraete, Karten und Event-Inbox
+
+## Schnellstart lokal
+
+1. `.env.example` nach `.env` kopieren oder den Installer unter `/install` nutzen.
+2. `database/schema.sql` per `bin/migrate.php` gegen MySQL ausfuehren.
+3. Webroot auf `public/` zeigen lassen.
+4. Plattform-Admin anlegen und anschliessend Mandanten registrieren.
+
+## Wichtige Dateien
+
+- [public/index.php](/config/workspace/kaffeeliste-neustart/public/index.php)
+- [database/schema.sql](/config/workspace/kaffeeliste-neustart/database/schema.sql)
+- [DEPLOY.md](/config/workspace/kaffeeliste-neustart/DEPLOY.md)
+- [RUNBOOK.md](/config/workspace/kaffeeliste-neustart/RUNBOOK.md)
+- [docs/product-strategy.md](/config/workspace/kaffeeliste-neustart/docs/product-strategy.md)
+- [docs/marketing-ops.md](/config/workspace/kaffeeliste-neustart/docs/marketing-ops.md)
+- [docs/production-blueprint.md](/config/workspace/kaffeeliste-neustart/docs/production-blueprint.md)
+- [docs/rfid-roadmap.md](/config/workspace/kaffeeliste-neustart/docs/rfid-roadmap.md)