Files
fewo-stommer/docs/KONZEPT.md
LarsandClaude Opus 5.5 791786ed3e Saisonfotos am Foto statt am Erscheinungsbild
Ein Foto gehoert zu keinem (ganzjaehrig) oder mehreren Erscheinungsbildern und
erscheint nur dort, vor den ganzjaehrigen Fotos. Bausteine waehlen "automatisch"
oder eine eigene Auswahl; Titelbereich und Abschluss zeigen das erste passende
Foto ihrer Liste. Titelbild und "Bilder je Baustein" des Erscheinungsbilds werden
in die Bausteine uebernommen und entfallen dort.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 18:53:56 +01:00

19 KiB
Raw Permalink 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 (seit 29.10.2026 am Foto festgelegt: „Zeigen in“ mehreren Erscheinungsbildern, leer = ganzjährig), 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 (Saisonfotos, 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