Files
fewo-stommer/docs/KONZEPT.md
T
Lars StommerandClaude Opus 5.5 08b6582fa1 Phase 2: Kalender, Anfrage, Vorreservierung & Sonderangebote
- Gäste, Buchungen (Status-Workflow), Sperrzeiten, Sonderangebote
- Vorreservierung mit Haltezeit je Wohnung; abgelaufene Holds geben den Kalender sofort frei, Cron setzt Status und benachrichtigt
- Sonderangebote/Sonderkonditionen: %, € pro Aufenthalt, Sonderpreis/Nacht, Gratis-Nächte; Bedingungen u. a. Saison, Vorlauf, Wochentag, Nächte, Aktionscode; bestes Einzel- vs. kombinierte Angebote
- Öffentliche Seite /buchen: Belegungskalender, Live-Preis, Anfrageformular (Honeypot, Rate-Limit)
- E-Mails: Angebot an Gast, Benachrichtigung Vermieter, Bestätigung, Absage, Ablauf
- Filament: Anfragen & Buchungen (bestätigen, ablehnen, verlängern, stornieren, Telefonbuchung), Gäste, Sperrzeiten, Sonderangebote
- Deutsche Validierungstexte

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

149 lines
9.9 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).
## 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.
## 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.
## 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