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>
124 lines
9.7 KiB
Markdown
124 lines
9.7 KiB
Markdown
# 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)?
|