Files
fewo-stommer/docs/MANDANTEN-ANFORDERUNGEN.md
T
LarsandCursor 8ebc1a3878 Assign the existing site to one landlord so stommer.info can run tenancy.
Seebad 0.3 stays in this release. With a single landlord every host still reaches the default website.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-23 12:00:11 +02:00

124 lines
9.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Mandantenfähigkeit – Anforderungen
Stand: 23.10.2026 · Anforderungen, noch keine Planung · Planung und Umbau in einer eigenen Sitzung · Grundlage: [KONZEPT.md](KONZEPT.md) („Mehrfähigkeit offen halten“), [DESIGN-KONZEPT.md](DESIGN-KONZEPT.md) §7
> Plan zur Freigabe: [MANDANTEN-PLAN.md](MANDANTEN-PLAN.md) (23.10.2026). Noch nicht umgesetzt.
>
> **Kurz:** Kein Portal und kein Marktplatz. Das Produkt ist **„die individuelle Website mit Vermieter-Funktionen“**. Einige Vermieter aus dem Bekanntenkreis sollen das System für ihre **eigene** Website nutzen können, mit eigenem Admin-Bereich und eigenen Diensten. Außerdem sollen weitere **eigene** Wohnungen unter fewo-stommer.de angeboten werden können. Das Datenmodell ist dafür nur zur Hälfte vorbereitet (§4). Der Umbau soll jetzt sauber geplant werden, solange es nur einen Vermieter gibt.
---
## 1. Szenarien
| # | Szenario | Beispiel | Zeitpunkt |
|---|---|---|---|
| S1 | **Ein Vermieter, eine Website, eine Wohnung** | heute: Brigitte, fewo-stommer.de, Strandstraße 15 | jetzt |
| S2 | **Ein Vermieter, eine Website, mehrere Wohnungen** | weitere Wohnung der Familie unter fewo-stommer.de, evtl. an einem anderen Ort (z. B. Berge) | möglich |
| S3 | **Weitere Vermieter mit eigener Website und Domain** | Bekannte in Kühlungsborn nutzen das System als SaaS für ihre eigene Website | möglich, wenige Mandanten |
| – | *Kein Ziel:* gemeinsame Suche über alle Vermieter, Portal, Provisionsmodell | | |
## 2. Begriffe
| Begriff | Bedeutung |
|---|---|
| **Mandant (Vermieter)** | rechtlich und organisatorisch eigenständiger Vermieter. Besitzt Daten, Benutzer, Einstellungen, Dienste |
| **Website** | Domain mit Theme, Bildwelt, Seiten, Erscheinungsbildern; gehört genau einem Mandanten. Ein Mandant kann mehrere Websites haben |
| **Wohnung** | vermietbare Einheit; gehört genau einem Mandanten und wird auf einer (oder mehreren) seiner Websites gezeigt |
| **Betreiber** | wir (Lars): betreiben das System für alle Mandanten |
## 3. Anforderungen
### 3.1 Trennung der Daten
- A1 Jeder Mandant sieht und bearbeitet **nur seine eigenen** Daten: Wohnungen, Preise, Kalender, Buchungen, Zahlungen, Gäste, Bewertungen, Portale, Texte, Fotos, Seiten, Einstellungen.
- A2 **Gästekartei je Mandant.** Jeder Vermieter ist datenschutzrechtlich selbst Verantwortlicher; dieselbe Person kann bei zwei Mandanten zwei getrennte Gästeeinträge haben.
- A3 Die Trennung ist **technisch erzwungen** (automatische Filter, Richtlinien, Tests), nicht nur durch die Oberfläche.
- A4 Öffentliche Website, Buchungsformular, Angebots- und Bewertungslinks, iCal-Feeds und Cronjobs arbeiten jeweils im Kontext des richtigen Mandanten.
### 3.2 Admin-Bereich
- A5 **Eigener Admin-Bereich je Mandant**, mit dem gewohnten Aufbau (einfache Ansicht und Expertenansicht, 2FA für alle).
- A6 **Rollen je Mandant**, wie heute: **Mandanten-Administrator**, Vermietung, Inhalte. Der Mandanten-Administrator verwaltet seinen Mandanten vollständig, aber nur diesen.
- A6a Der **Mandanten-Administrator legt selbst Benutzer** für seinen Admin-Bereich an, vergibt und ändert Rollen, sperrt Konten, setzt 2FA zurück und vergibt Passwörter neu (wie heute Admin › Benutzer). Er kann **keine** Rechte über seinen Mandanten hinaus vergeben.
- A6b **Benutzer können mehreren Mandanten angehören**, mit einer eigenen Rolle je Mandant (Beispiel: Lars ist Administrator bei Stommer und Vermietung bei einem Bekannten). Ein Konto, eine 2FA; Mandantenwechsel im Benutzermenü.
- A6c Die **einfache/Expertenansicht** bleibt eine Einstellung je Benutzer (ggf. je Mandant), unabhängig von der Rolle; Rechte entscheiden weiterhin Rollen und Richtlinien.
- A6d Rollen sind so angelegt, dass später **weitere Rollen** ergänzt werden können (z. B. Reinigung/Hausmeister mit Lesezugriff auf den Belegungskalender, Steuerberater mit Lesezugriff auf Zahlungen), ohne den Umbau zu wiederholen.
- A7 **Betreiber-Bereich** für uns (Rolle **Betreiber**, außerhalb der Mandanten): Mandanten anlegen und sperren, den ersten Mandanten-Administrator anlegen, Dienste je Mandant freischalten, Domains zuordnen, in einen Mandanten wechseln (Support, protokolliert), Systemzustand (Cron, Mail, Backups) über alle Mandanten.
- A8 Mandanten können Themes nur **auswählen**, nicht hochladen (Vorlagen sind ausführbarer Code). Logos dürfen sie hochladen (PNG oder geprüftes SVG).
### 3.3 Pro Mandant einstellbar (heute global)
- A9 **Vermieterdaten:** Name, Anschrift, Telefon, E-Mail, Impressum, Bankverbindung, Steuerangaben. Heute in der `.env` (`FEWO_OWNER_*`, `FEWO_BANK_*`).
- A10 **Texte:** Mietbedingungen, Storno, Datenschutz, Mailtexte, Vertragsvorlage, FAQ, Hinweis-Banner.
- A11 **Kommunikation:** Absenderadresse, Benachrichtigungsadressen, Postfach für Portal-Mails, Betriebsart (Test / scharf).
- A12 **Regeln:** Fristen, Mindestaufenthalt-Regeln, Anzahlung, Löschfristen (innerhalb gesetzlicher Grenzen), Bot-Schutz-Grenzen.
- A13 **Buchungsnummern** je Mandant (eigener Nummernkreis, z. B. `2026-0001` je Vermieter).
- A14 **Marke:** Logo, Favicon, Logo für Mails und Vertrags-PDF – je Mandant, optional je Website abweichend.
### 3.4 Dienste
- A15 Dienste sind **je Mandant ein- und ausschaltbar**, z. B. KI-Angebotsentwürfe, KI-Vermarktungsassistent, KI-Gästekommunikation (mehrsprachig), Portal-Synchronisation, Mail-Schnellweg.
- A16 Verbrauchsabhängige Dienste (KI) sind **je Mandant messbar** (Grundlage für spätere Abrechnung); eigene API-Schlüssel je Mandant sollen möglich sein.
- A17 Abrechnung ist **kein** Teil des ersten Umbaus, die Datengrundlage soll aber entstehen.
### 3.5 Website und Design
- A18 Jede Website wählt **Theme** und **Bildwelt** (Grafik-Set: Bänder, Vignetten, Ornamente). Bildwelten sind Pakete wie Themes (Ordner mit Manifest und SVGs), z. B. „Ostsee“, später „Berge“.
- A19 Themes sind **ortsneutral**: sie greifen nur auf Bildwelt-Plätze zu (Trenner, Abschlussband, Vignette je Tipp-Kategorie …), nie direkt auf eine Ostsee-Grafik.
- A20 Bildwelt **je Wohnung überschreibbar** (S2: Berg-Wohnung unter fewo-stommer.de).
- A21 Für S2: Bausteine können eine **Wohnung wählen** (heute immer die Hauptwohnung), die Suche kann mehrere Wohnungen anbieten, die Startseite kann eine Übersicht zeigen.
- A22 Markengrafiken liegen nicht mehr global in `public/brand/`, sondern bei Mandant/Website (Marke) bzw. in der Bildwelt.
### 3.6 Betrieb
- A23 **Strato bleibt vorerst** (wenige Mandanten). Eigene Domains der Mandanten werden von Hand bei Strato eingerichtet (Domain, SSL, Weiterleitung auf die Anwendung). Die Anwendung erkennt den Mandanten über die Domain (wie heute die Website).
- A24 Bei Wachstum **Umzug auf einen eigenen Server**. Nichts im Umbau darf Strato-Besonderheiten fest einbauen; Umzug ohne Datenmodelländerung.
- A25 **Eine Datenbank für alle Mandanten** (Spalte je Mandant), kein eigener Datenbankserver je Mandant. Backups weiterhin gesamt; Export und Löschung **eines** Mandanten müssen möglich sein (Kündigung, DSGVO).
- A26 Bestehende Daten werden **ohne Ausfall** dem Mandanten „Stommer“ zugeordnet; für Brigitte ändert sich in der Bedienung nichts.
### 3.7 Recht (nicht technisch, aber Voraussetzung für S3)
- A27 Vertrag zur Auftragsverarbeitung (AVV) mit jedem Mandanten; Nutzungsbedingungen; Unterauftragsverarbeiter (Strato, ggf. KI-Anbieter) benennen.
- A28 Impressum und Datenschutzerklärung jeder Website sind die des Mandanten; der Betreiber erscheint nur als Dienstleister.
## 4. Ist-Stand (Prüfung vom 23.10.2026)
**Schon vorbereitet:** Tabelle `sites` (Domain, Theme); `pages` und `appearances` mit `site_id`; `properties.site_id`; Saisons, Extras, Buchungen, Sperrzeiten, Angebote, Fotos, Ausstattung, Bewertungen, Kanäle hängen an der Wohnung. Themes und Portal-Anbindung sind als austauschbare Pakete gebaut. Filament bietet eingebaute Mandantenfähigkeit (Mandantenwechsel, automatische Filter).
**Noch global (umzubauen):**
| Bereich | Ort |
|---|---|
| Benutzer und Rollen | `users.role` (eine Rolle systemweit; `App\Enums\UserRole`), Benutzerverwaltung nur für systemweite Administratoren |
| Gästekartei | `guests` |
| Einstellungen | `settings` (Schlüssel/Wert, ohne Zuordnung) |
| Texte, FAQ, Hinweis-Banner | `content_blocks`, `faqs`, `notices` |
| Vermieterdaten, Bank, Mail-Umleitung | `config/fewo.php` ← `.env` |
| Portal-Postfach, Absender | `.env` / `config` |
| Portal-Mails, Sync-Logs, Aufgaben | `portal_emails` (global), `channel_sync_logs`, `channel_tasks` (über Kanal → Wohnung, prüfen) |
| Zahlungen | `payments` (über Buchung, prüfen) |
| Buchungsnummern | ein Nummernkreis |
| Markengrafiken | `public/brand/` |
| Bausteine | nutzen immer `$theme->property()` (Hauptwohnung) |
## 5. Abgrenzung
- Kein Portal, keine gemeinsame Suche, keine Provisionen, keine Selbstregistrierung von Mandanten (der Betreiber legt sie an).
- Keine Abrechnung im ersten Schritt (A17).
- Kein eigener Server je Mandant (A25).
## 6. Abhängigkeiten zur Design-Arbeit
- Theme A (Designkonzept) kann **parallel** entstehen; es muss nur A19 einhalten (Bildwelt-Plätze statt fester Grafiken).
- **Marke** (A14, A22) und **Bildwelt** (A18, A20) bauen auf dem Mandanten bzw. der Website auf und kommen nach dem Grundumbau.
- Bis dahin liegen die neuen Grafiken als Quelle in `styles/satz3/svg/`.
## 7. Offene Fragen für die Planung
1. Mandant und Website trennen oder anfangs 1:1 zusammenlegen?
2. Wohnungen mehreren Websites eines Mandanten zuordnen (n:m) oder genau einer?
3. Welche Einstellungen bleiben bewusst global (z. B. Sicherheitsgrenzen, Backup)?
4. Portal-Postfach je Mandant: eigenes Postfach oder ein Sammelpostfach mit Zuordnung?
5. KI-Dienste: zentraler API-Schlüssel des Betreibers mit Verbrauchszählung, eigene Schlüssel der Mandanten oder beides?
6. Reihenfolge: Mandant → Marke/Bildwelt → mehrere Wohnungen je Website (S2)?