# 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). ## 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. - **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. ## 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). ## 7. Connector-/Plugin-System für Portale Portale wechseln → jedes Portal ist ein eigenständiger **Channel-Connector** hinter einer gemeinsamen Schnittstelle: ```php 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, Auto-Angebot per Mail, Vorreservierung mit Haltezeit, Sonderangebote, Sperrzeiten, Buchungsverwaltung. ✅ 3. **Buchungsworkflow:** Bestätigung, Mietvertrag-PDF, Zahlungsfristen & Erinnerungen. 4. **Webseite:** Design, Inhalte, Galerie, SEO, Barrierefreiheit. 5. **Connectoren:** iCal-Import/-Export, Sync-Log, Konfliktwarnung. 6. **Go-Live:** Strato-Deployment, Umleitungen, Inhalte/Rechtstexte, Testbuchungen. ## 11. Offene Punkte / benötigte Inhalte - [x] Strato-Tarif: Hosting Pro – noch prüfen: SSH, Cronjobs, PHP-Version - [x] 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? - [x] Nachbarwohnung: System ist mehrwohnungsfähig