Files
fewo-stommer/docs/KONZEPT.md
T

19 KiB
Raw Blame History

Ferienwohnung Stommer – Konzept Webseite & Verwaltungssystem

Stand: 22.10.2026

1. Ziele

Heute (WordPress) Ziel
Preise als Tabelle von Hand gepflegt, fehleranfällig (z. B. „Weihnachten 19.12.–26.01.“ überschneidet sich mit Neujahr) Saisons & Preise im Admin, mit Validierung (keine Lücken/Überschneidungen), Preise werden automatisch berechnet
Belegungsplan extern (ferienundwohnen.de) Eigener Belegungskalender, synchronisiert mit allen Portalen
Anfrage nur per E-Mail, keine Auto-Antwort Strukturierte Anfrage mit sofortigem, verbindlich kalkuliertem Angebot
Mietvertrag per Hand Mietvertrag als PDF auf Knopfdruck bzw. automatisch bei Bestätigung
Zahlungen manuell verfolgt Anzahlung/Restzahlung mit Fälligkeiten und automatischen Erinnerungen

2. Rahmenbedingungen

  • Hosting: Strato Webhosting (PHP 8.x, MySQL). Kein Node.js im Betrieb – Frontend-Assets werden lokal gebaut und mit deployt.
  • Buchungsablauf: Anfrage → automatisches Angebot → Bestätigung durch Vermieter (1 Klick) → Vertrag + Zahlungsinfos automatisch.
  • Zahlung: Überweisung (Anzahlung 35 %, Rest 4 Wochen vor Anreise). Online-Zahlung später als Erweiterung möglich.
  • Portale: wechselnd (FeWo-direkt, Traum-Ferienwohnungen, ferienundwohnen.de, …) → erweiterbares Connector-System.

3. Technologie

Bereich Wahl Begründung
Backend Laravel 13 (PHP 8.4) Läuft auf Shared Hosting, ausgereift, Queue/Scheduler/Mail/PDF eingebaut
Admin Filament 5 Professionelles Verwaltungs-UI (Tabellen, Formulare, Kalender, Dashboards) ohne Eigenbau
Frontend Blade + Tailwind CSS + Alpine.js/Livewire Server-gerendert → schnell, SEO-stark, kaum JavaScript
Datenbank MySQL 8 (Strato), lokal SQLite
PDF dompdf / Browsershot-frei Läuft ohne Zusatzsoftware auf Shared Hosting
Bilder Responsive Images (AVIF/WebP, srcset), lazy loading Core Web Vitals
Hintergrundjobs Laravel Scheduler per Strato-Cronjob (jede Minute/5 Min.) iCal-Sync, Erinnerungs-Mails

Neueste Standards: HTTPS/HSTS, Core Web Vitals „grün“, semantisches HTML, WCAG 2.2 AA, strukturierte Daten (schema.org VacationRental/LodgingBusiness), Open Graph, sitemap.xml, hreflang (DE/EN vorbereitet), keine externen Fonts/Tracker (DSGVO, kein Cookie-Banner nötig).

4. Öffentliche Webseite

  • Start: großes Bild, Kernfakten (53 m², EG, Terrasse, 1–3 Pers., WLAN, Parkplatz), Verfügbarkeits-/Preis-Widget direkt oben.
  • Die Wohnung: Räume & Ausstattung strukturiert (Icons), Grundriss, Galerie mit Lightbox.
  • Preise & Belegung: Live-Kalender (frei/belegt, Mindestaufenthalt je Saison), Preisrechner mit Gesamtpreis inkl. aller Pflichtkosten (Preisangabenverordnung).
  • Kühlungsborn & Umgebung: Lage, Strand, Hafen, Karte (datenschutzfreundlich, z. B. statisches Kartenbild/OpenStreetMap nach Klick).
  • Anfrage/Buchung: Zeitraum, Personen, Extras (Bettwäsche, Handtücher), Kontaktdaten → sofortiges Angebot.
  • Bewertungen (eigene, aus abgeschlossenen Aufenthalten eingesammelt).
  • Kontakt, Impressum, Datenschutz, Mietbedingungen.
  • Spätere Erweiterung: Gästebereich (Buchung einsehen, Anreiseinfos).

4a. Theme- und Vorlagensystem (Entscheidungen vom 22.10.2026 – umgesetzt, Details: docs/THEMES.md)

  • Themes (Design) als Code-Pakete mit Manifest, eigenen Vorlagen und eigenem CSS; was ein Theme nicht mitbringt, kommt aus einem vollständigen Basis-Theme (Child-Theme-Prinzip). Erstes Theme: „Ostsee-Licht“ (Entwurf A, orientiert an der bisherigen Webseite). Die Entwürfe B/C können später als weitere Themes folgen.
  • Bausteinsystem (geführt): Seiten werden aus einem festen Katalog von Abschnitten zusammengestellt (Reihenfolge, Sichtbarkeit); Seiten und Menüs können je Ausrichtung unterschiedlich sein. Keine freie Seitengestaltung.
  • Saisonale Erscheinungsbilder: wechseln Fotos (Titelbild und Bilder je Baustein), Texte, Farben/Akzente und Banner – nicht den Aufbau. Bausteine können nur in bestimmten Erscheinungsbildern erscheinen (z. B. ein Weihnachts-Baustein). Sonderangebote werden seit 22.10.2026 unabhängig davon nach eigenen Regeln beworben (5a). Zeitplan jährlich wiederkehrend mit Priorität und Standard; Vorschau-Link vor Aktivierung. Startset: Sommer (Strand, Baden), Winter (raue See, stimmungsvoller Himmel), Weihnachten (gemütlich, besinnlich), Silvester (Party, Feuerwerk). Klickbare Vorschau: lokale HTML-Datei (Scratchpad der Sitzung).
  • Mehrfähigkeit offen halten: „Site“ = Domain + Theme/Erscheinungsbilder + angezeigte Wohnungen; kein Portal, aber andere Vermieter könnten die Funktionen über eine eigene Domain nutzen (Mandantenfähigkeit vorbereiten, nicht ausbauen).
  • Plugins: Theme- und Baustein-Plugins als Composer-Pakete (Registry wie bei den Portal-Connectoren); Auslieferung per Deployment – kein Upload von Vorlagen im Admin (Sicherheit).
  • Strato: CSS aller Themes wird beim Deployment gebaut; Seiten-Cache je Erscheinungsbild.

5. Verwaltungssystem (Admin)

  • Dashboard: nächste An-/Abreisen, offene Anfragen, fällige Zahlungen, Auslastung/Umsatz pro Jahr.
  • Kalender: alle Buchungen + Portal-Blockierungen + manuelle Sperrzeiten (Eigennutzung, Renovierung).
  • Saisons & Preise: pro Saison Zeitraum, Preis/Nacht, Mindestaufenthalt, optional An-/Abreisetage. Jahr kopieren („Preise 2027 = 2026“) mit einem Klick – optional mit Saisonbeginn auf einen Wochentag (z. B. Samstag; aneinandergrenzende Saisons bleiben lückenlos).
  • Ausnahmen vom Mindestaufenthalt (je Wohnung, „Preise & Angebote › Saisons › Regeln Mindestaufenthalt“): kürzer erlaubt, wenn die Buchung eine Kalenderlücke vollständig füllt oder am typischen Anreisetag endet; Sonderangebote jeder Art können ihn aufheben; absolute Untergrenze für alle Ausnahmen (Standard 2 Nächte).
  • Preisbestandteile (konfigurierbar): Endreinigung/Service (108 €), Zusatzperson ab 3. Person (7,50 €/Nacht), Extras (Bettwäsche 14 €, Handtücher 11 €, Paket 23 €), Kurtaxe (Hinweis, vor Ort), Anzahlungsquote 35 %, Restzahlungsfrist 4 Wochen.
    • Darstellung wahlweise wie heute („erste Nacht inkl. Endreinigung“) oder transparent getrennt – die Berechnung ist identisch.
  • Sonderangebote & Sonderkonditionen: werden bei jeder Preisberechnung automatisch geprüft (siehe 5a).
  • Anfragen & Buchungen: Statusworkflow, Notizen, komplette Kommunikationshistorie. Manuelle Erfassung von Telefonbuchungen mit automatischer Preisberechnung.
  • Gäste: Kartei, Wiederkehrer, DSGVO-Löschfristen.
  • Vorlagen: E-Mail-Texte und Mietvertrag mit Platzhaltern editierbar.
  • Portale/Connectoren: siehe Abschnitt 7.

5b. Rollen, Inhalte, Gäste, Customer Voice

  • Rollen: Administrator (alles + Benutzer), Vermietung (Buchungen, Gäste, Preise, Angebote, Bewertungen), Inhalte (Bilder, Texte, Ausstattung, FAQ, Hinweise, Bewertungen).
  • Inhalte ohne CMS-Risiko: feste Bausteine statt freier Seitenbau – Bilder (automatische WebP-Webgrößen, Sortierung per Drag & Drop), Webseiten-Texte (config/content.php), Ausstattung, FAQ, zeitgesteuerte Hinweis-Banner, Impressum/Datenschutz.
  • Gästeverzeichnis: Kontaktdaten, Markierungen, Aufenthalte & Umsatz, Stammgast-Filter, CSV-Export, Werbe-Einwilligung per Double-Opt-in (Abmeldelink), Anonymisierung (manuell und automatisch nach Aufbewahrungsfrist, Standard 10 Jahre – mit Steuerberater abstimmen).
  • Customer Voice: Einladung 2 Tage nach Abreise mit signiertem Link → Sterne (gesamt + Sauberkeit, Ausstattung, Lage, Gastgeber), Text, internes Feedback, Veröffentlichungs-Einwilligung → Freigabe im Admin, öffentliche Antwort möglich. Nur verifizierte Aufenthalte (§ 5b UWG-Hinweis auf der Webseite); Portalbewertungen manuell mit Quelle übernehmbar.

5a. Sonderangebote & Sonderkonditionen

Ein Angebot besteht aus einem Vorteil und beliebig vielen Bedingungen (leer = keine Einschränkung):

Vorteil Beispiel
Rabatt in % Last Minute −15 %
Rabatt in € pro Aufenthalt Stammgast −25 €
Sonderpreis pro Nacht Special Weekend 59 €/Nacht
Gratis-Nächte (die günstigsten) 7 = 6

Bedingungen: Saison(s) der Anreise · Vorlauf (max./min. Tage vor Anreise → Last Minute/Frühbucher) · Mindest-/Höchstnächte · Anreise-Wochentage · Aufenthaltszeitraum · Buchungszeitraum · Aktionscode (Sonderkondition, z. B. für Stammgäste).

Rabatte gelten auf den Übernachtungspreis (nicht auf Endreinigung/Extras); die Anzahlung wird auf den rabattierten Mietpreis berechnet. Treffen mehrere Angebote zu, erhält der Gast automatisch die günstigere Variante: das beste Einzelangebot oder die Summe aller als „kombinierbar“ markierten Angebote.

Angebotsarten (Entscheidung 22.10.2026): Rabattaktion (nur Bedingungen, z. B. Last Minute, „ab 3 Nächten −10 %“, 7 = 6, Special Weekend) · Fester Termin (genau diese An-/Abreise, z. B. „Ostsee-Woche 07.–14.11.“, oft mit Pauschalpreis für alle Nächte) · Lückenfüller (freie Lücken bis N Nächte zwischen zwei Belegungen, automatisch erkannt; kann den Mindestaufenthalt der Saison aufheben). Im Admin gibt es Vorlagen für die typischen Fälle.

Bewerbung unabhängig vom Erscheinungsbild (App\Pricing\OfferShowcase): gezeigt werden aktive, öffentliche Angebote ohne Code im Buchungszeitraum; feste Termine nur solange frei; Lückenfüller mit bis zu drei konkreten Lücken. Feste Termine und Lücken werden mit dem PriceCalculator gerechnet – der beworbene Preis ist exakt der spätere Angebotspreis („499 € statt 640 €“, Link mit vorausgefüllten Daten). Reihenfolge: hervorgehoben → Priorität → frühestes Datum. Gelten mehrere gleichzeitig, zeigt der Baustein sie wahlweise nebeneinander, als Liste oder rollierend; das wichtigste hervorgehobene Angebot erscheint optional im Titelbereich.

6. Workflows

Anfrage ──► Auto-Mail: Angebot (Preis, Zeitraum, Bedingungen), Termin wird 48 h „vorgemerkt“
   │
   ├─ Vermieter bestätigt (1 Klick) ──► Mail: Buchungsbestätigung + Mietvertrag (PDF) + Bankdaten/Anzahlung
   │                                     │
   │                                     ├─ Anzahlung nicht eingegangen nach X Tagen ──► Erinnerung
   │                                     ├─ Restzahlung fällig (−4 Wochen) ──► Zahlungsaufforderung, ggf. Erinnerung
   │                                     ├─ −7 Tage ──► Anreiseinformationen (Schlüssel, Parken, WLAN, Hausregeln)
   │                                     └─ +2 Tage nach Abreise ──► Dankeschön + Bitte um Bewertung
   │
   ├─ Vermieter lehnt ab ──► höfliche Absage, ggf. Alternativtermine
   └─ keine Reaktion/Ablauf ──► Vormerkung verfällt, Kalender wird frei

Status: Anfrage → Angebot → Bestätigt → Anzahlung erhalten → Bezahlt → Abgeschlossen (+ Abgelehnt, Storniert, Abgelaufen).

Zahlungseingang wird manuell im Admin abgehakt (später optional: Abgleich über Bank-CSV-Import).

6a. Buchungswege (Entscheidung Lars Stommer, 22.10.2026)

Weg 1 – über ein unverbindliches Angebot (jetzt umsetzen): Der Gast fragt unverbindlich an → der Zeitraum wird vorgemerkt → die Vermieterin erstellt ein Angebot (heute manuell im Admin, später mit KI-Entwurf und menschlicher Freigabe) → das Angebot geht per E-Mail an den Gast → nimmt der Gast das Angebot an (signierter, befristeter Link ohne Gästekonto), ist die Buchung abgeschlossen → Bestätigung + Mietvertrag, Zahlungsfristen laufen. Läuft die Angebotsfrist ab oder lehnt der Gast ab, wird der Kalender wieder frei.

Weg 2 – verbindliche Direktbuchung (Zukunft): Der Gast bucht direkt verbindlich, die Bestätigung geht sofort raus, Stornierungsfristen laufen an. Voraussetzung: sehr verlässliche, nahezu sofortige Synchronität mit den anderen Buchungssystemen mit Sofortbuchung (v. a. FeWo-direkt), damit keine Doppelbuchungen entstehen. Erst nach Lösung dieser Voraussetzung (z. B. Channel-Manager-API, siehe PORTALE.md).

Rechtliche Ausgestaltung (Wortlaut des Annahme-Buttons, Informationspflichten, Storno-Regeln, AGB) wird fachkundig geprüft; Impressum und Datenschutzerklärung werden separat erstellt.

6b. Weitere Festlegungen (22.10.2026)

  • Kurabgabe wird vor Ort durch den Ferienservice Balu erledigt – das System erhebt und meldet sie nicht. (Offen: ob Balu auch den Meldeschein übernimmt.)
  • Lösch- und Aufbewahrungsfristen nach allgemeiner Rechtsauffassung festlegen (fachkundig bestätigen lassen); technisch als Einstellungen umsetzen (Vorschläge: docs/LOESCHKONZEPT.md).
  • Auftragsverarbeitung mit Strato: Strato stellt dafür nach unserem Kenntnisstand einen Standardvertrag im Kundenbereich bereit – dort prüfen/abschließen.
  • Portalgäste = Gäste, die über ein Buchungsportal (FeWo-direkt u. a.) buchen; ihre Daten erreichen uns nur über die Portal-Benachrichtigungen. Wir betreiben selbst kein Portal.
  • Testbetrieb vs. scharf geschaltet (System › Betrieb): bis zum Scharfschalten gehen alle E-Mails nur an eine einstellbare Testadresse. Bot-Schutz der Anfrage ohne externe Dienste (DSGVO).
  • Verwaltung: mehrere Verwalter-Konten (mindestens Lars und Brigitte Stommer); einfache Ansicht (Anfragen/Buchungen/Verträge, Sperrzeiten, Gäste, Portal-Aufgaben, Bewertungen) und Expertenansicht (alle Einstellungen), umschaltbar je Benutzer – umgesetzt.
  • Die Dokumente BUCHUNGSPROZESS, DATENMODELL-KONZEPT, GAP-DELTA, GO-LIVE-CHECKLISTE, LOESCHKONZEPT und DATENSCHUTZ-* wurden von einem Analyse-Agenten erstellt; die dort genannten „verbindlichen Entscheidungen E1–E7“ sind dessen Annahmen. Maßgeblich sind die Festlegungen in diesem Dokument.

7. Connector-/Plugin-System für Portale

Portale wechseln → jedes Portal ist ein eigenständiger Channel-Connector hinter einer gemeinsamen Schnittstelle:

interface ChannelConnector
{
    public function key(): string;                      // 'fewo-direkt', 'traum-ferienwohnungen', …
    public function capabilities(): array;              // ['import_availability', 'export_availability', 'import_bookings', 'push_rates']
    public function settingsSchema(): array;            // Felder fürs Admin-Formular (z. B. iCal-URL)
    public function importBlockedPeriods(Channel $c): Collection;
}
  • Stufe 1 (alle Portale): generischer iCal-Connector – Import der Portal-Belegung (alle 15 Min.), Export eines eigenen iCal-Feeds pro Portal. Neues Portal = im Admin anlegen + URL eintragen, kein Code nötig.
  • Stufe 2 (bei Bedarf): portalspezifische Connectoren (API, z. B. Buchungsdetails, Preise) als eigene Klasse, registriert in config/channels.php.
  • Jeder Sync wird protokolliert; Konflikte (Doppelbelegung) lösen eine sofortige Warn-Mail aus.
  • Hinweis: iCal synchronisiert mit Verzögerung (Portale ziehen teils nur stündlich) – ein kleines Doppelbuchungsrisiko bleibt, wie bei allen Lösungen ohne Channel-Manager-API.

7a. Buchungshoheit & Architekturentscheidung

Anforderung: Geht auf einem Portal eine Buchung ein, muss der Zeitraum sofort überall (andere Portale + Webseite) gesperrt werden; Sync muss überwacht werden.

  • Unser System ist die zentrale Quelle der Belegung („Single Source of Truth“): Import aller Portale → Sperrzeiten; Export eines iCal-Feeds je Portal mit allen Belegungen außer denen dieses Portals.
  • Grenze von iCal: Wir können nur so schnell sperren, wie wir die Portale abfragen (bei uns alle 5 Min.) und wie oft die Portale unseren Feed abholen (portalabhängig, oft 30 Min. bis mehrere Stunden). Echtzeit gibt es nur über Portal-APIs – diese vergeben Booking.com, Airbnb und Vrbo/FeWo-direkt praktisch nur an zertifizierte Channel-Manager.
  • Stufe 1 (jetzt): iCal-Connectoren + Überwachung in Laravel bei Strato. Webseiten-Anfragen sind risikofrei, weil wir vor jeder Bestätigung gegen alle importierten Belegungen prüfen.
  • Stufe 2 (falls Doppelbuchungen zwischen Portalen nicht tragbar sind): Channel-Manager mit API und Webhooks als Portal-Hub (Kandidaten z. B. Smoobu, Beds24, Lodgify – Auswahl nach Portalabdeckung und Preis). Unser System bindet ihn als weiteren Connector an; Portalbuchungen kommen per Webhook in Sekunden.
  • Überwachung: Sync-Protokoll je Kanal, Warnung bei fehlgeschlagenem oder veraltetem Abruf, sofortige Konflikt-Mail bei Überschneidungen, Status-Endpunkt /health/sync für externe Überwachung.
  • Eigener Server (n8n/FastAPI): nicht als Kernbestandteil – ein zweites System würde Logik und Gästedaten aufteilen (Wartung, DSGVO). Sinnvoll als unabhängiger Wächter: n8n prüft /health/sync alle 5 Min. und alarmiert per Push/Telegram; optional Ersatz-Trigger für den Scheduler, falls der Strato-Cronjob ausfällt.

8. Rechtliches (Deutschland)

  • Impressum, Datenschutzerklärung (DSGVO), Mietbedingungen/AGB – Texte sollten juristisch geprüft werden.
  • Gesamtpreisangabe inkl. Pflichtkosten (PAngV); Kurtaxe als Hinweis.
  • Keine Drittanbieter-Einbindungen ohne Einwilligung → kein Cookie-Banner nötig.
  • Mietvertrag-Vorlage: bestehenden Vertrag übernehmen.

9. Hosting & Deployment (Strato)

  • Domain-Ziel auf das Verzeichnis public/ zeigen lassen.
  • Tarif: Strato Hosting Pro. Im Kundenlogin zu prüfen: PHP-Version ≥ 8.4, SSH-Zugang, Cronjobs, MySQL-Datenbank, SMTP-Postfach (fewo@stommer.de).
  • Cronjob (jede Minute oder alle 5 Min.): php artisan schedule:run – verarbeitet u. a. abgelaufene Vorreservierungen. Der Kalender gibt abgelaufene Vormerkungen auch ohne Cronjob sofort frei; der Cronjob setzt nur den Status und benachrichtigt den Vermieter.
  • Deployment per Skript (rsync/SFTP) mit Build lokal; Datenbank-Backups täglich.
  • Migration: Umleitungen (301) der alten WordPress-URLs, Bilder übernehmen.

10. Umsetzungsphasen

  1. Fundament: Laravel + Filament, Datenmodell, Saisons/Preise, Preisberechnung (mit Tests). ✅
  2. Kalender & Anfrage: Belegung, Anfrageformular, Vorreservierung mit Haltezeit, Sonderangebote (Rabattaktion, fester Termin, Lückenfüller), Mindestaufenthalt mit Ausnahmen, Sperrzeiten, Buchungsverwaltung. ✅
  3. Buchungsworkflow: Buchungsweg 1 Anfrage → Angebot → Annahme durch den Gast (§6a), Mietvertrag-PDF, Zahlungsfristen & Erinnerungen, Anreiseinfos. ✅ (Mietbedingungen/Storno/Angebotstexte noch als Muster)
  4. Webseite: Theme-System, Bausteine, Erscheinungsbilder (Bilder je Baustein, saisonale Bausteine), Seiten, SEO, Markengrafiken ✅ · neues Design-Theme in eigener Session (docs/ZUSAMMENARBEIT.md, docs/THEME-ERSTELLUNG.md).
  5. Connectoren: iCal-Import/-Export, Sync-Log, Konfliktwarnung, Portal-E-Mails. ✅ (echte Portal-Mails zur Feinabstimmung des Parsers fehlen)
  6. Go-Live: Strato-Deployment und Testbetrieb ✅ · offen: Cronjob, Produktion, Umleitungen, Rechtstexte, echte Testbuchungen (Stand: docs/STATUS.md).

11. Offene Punkte / benötigte Inhalte

  • Strato-Tarif: Hosting Pro – noch prüfen: SSH, Cronjobs, PHP-Version
  • Haltezeit der Vorreservierung: 48 h (je Wohnung einstellbar)
  • Bestehender Mietvertrag (Vorlage) und Mietbedingungen
  • Hochauflösende Fotos
  • An-/Abreisezeiten, Stornobedingungen, Haustiere/Rauchen
  • Preise 2027 bestätigen; Korrektur Weihnachten/Neujahr-Zeiträume
  • Bankverbindung für Zahlungsinformationen
  • Sprachen: Deutsch + Englisch?
  • Nachbarwohnung: System ist mehrwohnungsfähig