Files
fewo-stommer/docs/KONZEPT.md
T
Lars StommerandClaude Opus 5.5 2e9a391b37 Phase 1: Wohnungen, Saisons & Preisberechnung
- Datenmodell Property/Season/Extra (Beträge in Cent), Seeder mit Preisliste 2026
- PriceCalculator: Saison-Splitting, Mindestaufenthalt, Zusatzperson, Endreinigung, Extras, Anzahlung/Restzahlung
- Filament-Verwaltung: Wohnungen, Saisons (Überschneidungsprüfung, Lückenwarnung, Kopie ins Folgejahr, Preisrechner), Zusatzleistungen
- Tests für Preisberechnung und Saisonverwaltung

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-22 09:19:49 +02:00

8.3 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).

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.
  • Anfragen & Buchungen: Statusworkflow, Notizen, komplette Kommunikationshistorie.
  • Gäste: Kartei, Wiederkehrer, DSGVO-Löschfristen.
  • Vorlagen: E-Mail-Texte und Mietvertrag mit Platzhaltern editierbar.
  • Portale/Connectoren: siehe Abschnitt 7.

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:

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.

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.
  • Zu prüfen im Strato-Paket: PHP-Version ≥ 8.3, SSH-Zugang, Cronjobs, MySQL-Datenbank, SMTP-Postfach (fewo@stommer.de).
  • 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.
  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

  • Strato-Tarif prüfen (SSH, Cronjobs, PHP-Version)
  • 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: ebenfalls verwalten (Kombi-Buchung „zwei Familien“)?