Files
fewo-stommer/docs/MANDANTEN-ANFORDERUNGEN.md
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

9.7 KiB
Raw Permalink Blame History

Mandantenfähigkeit – Anforderungen

Stand: 23.10.2026 · Anforderungen, noch keine Planung · Planung und Umbau in einer eigenen Sitzung · Grundlage: KONZEPT.md („Mehrfähigkeit offen halten“), DESIGN-KONZEPT.md §7

Plan zur Freigabe: 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)?