Files
fewo-stommer/docs/KONZEPT.md
T
Lars StommerandClaude Opus 5.5 66e82d61f5 Theme-System mit Basis-Theme Ostsee-Licht, Bausteinen und saisonalen Erscheinungsbildern
- Sites (Domain, Theme, Farben; mehrfähig für weitere Vermieter), Seiten aus Bausteinen mit Menüs, Erscheinungsbilder mit jährlichem Zeitplan, Priorität und signierter Vorschau
- Theme-Kern (app/Themes): Manifest, Registry, Vererbung (Child-Themes), Token-Farben als CSS-Variablen, Bausteinkatalog als Registry (config/themes.php)
- 15 Bausteine: Titelbereich mit Suche, Eckdaten, Text mit Bildern, Galerie, Ausstattung, Lage, Preise, Angebote, Kalender & Anfrage, Bewertungen, Gastgeber, FAQ, Abschluss, Kontakt, Fließtext
- Theme Ostsee-Licht: Layout, Kopf/Fuß, Banner, mobile Buchungsleiste, Lightbox, selbst gehostete Schriften, Reduced Motion
- Seiten Start, Wohnung, Kühlungsborn, Preise & Buchung, Kontakt, Impressum, Datenschutz; Sitemap, robots.txt, JSON-LD
- Admin: Seiten-Baukasten, Erscheinungsbilder, Websites
- Dokumentation docs/THEMES.md inkl. Übergabe für die Design-Sitzung

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 15:04:21 +02:00

176 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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, Texte, Farben/Akzente, Banner und hervorgehobene Angebote – nicht den Aufbau. 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.
- **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, Anreiseinfos. ✅ (Mietbedingungen/Storno noch als Muster)
4. **Webseite:** Theme-System, Bausteine, Erscheinungsbilder, Seiten, SEO ✅ · Basis-Theme „Ostsee-Licht“ funktionsfähig; gestalterische Überarbeitung offen (Übergabe: docs/THEMES.md §10).
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