Admin accounts with simple/expert mode, blocked periods list, brand assets, decisions

- Per-user admin mode (simple: bookings/contracts, blocked periods, guests, portal tasks,
  reviews; expert: everything the role allows), user menu switch, FollowsAdminMode on all
  resources/pages (guarded by a test); roles keep deciding permissions.
- Users list shows mode and 2FA; admins can reset another user's 2FA.
- New "Sperrzeiten" list for all apartments (manual blocks editable, portal blocks read-only).
- styles/final: clean hand-built SVG mark, logo, favicon (dark-mode aware), 4 icons, wave
  divider, plus PNG/WebP for mail/PDF/touch icon; colours via --brand-* variables.
- Decisions recorded in KONZEPT §6a/6b (booking path 1 via offer + guest acceptance, direct
  booking later; tourist tax by Ferienservice Balu); agent documents added and marked as
  analysis with assumptions; styles excluded from the deploy package.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
Lars StommerandClaude Opus 5.5 committed 2026-10-22 21:08:09 +02:00
1 parent 7d0bc93abc
commit 82698f8eda
65 files changed
+1154 -5

No files matched your search

+5 -1
View File
@@ -103,7 +103,11 @@ ## 7. Zugang zur Verwaltung (`/admin`)
"cd test.fewo-stommer.de/current && /opt/RZphp84/bin/php-cli artisan users:create lars@stommer.com --name='Lars Stommer' --role=admin"
```
Weitere Benutzer legt ein Administrator in der Verwaltung an (System › Benutzer). Rollen: `admin` (alles inkl. Benutzer), `rentals` (Vermietung), `content` (Inhalte); ohne Rolle kein Zugang.
Weitere Benutzer legt ein Administrator in der Verwaltung an (System › Benutzer): Name, E-Mail, **Rolle** (was die Person darf) und **Ansicht** (was das Menü zeigt), Passwort. Rollen: `admin` (alles inkl. Benutzer), `rentals` (Vermietung), `content` (Inhalte); ohne Rolle kein Zugang. Empfehlung: Lars `admin`, Brigitte `rentals` mit einfacher Ansicht.
**Ansichten:** *Einfache Ansicht* – nur Anfragen & Buchungen (inkl. Bestätigen, Mietvertrag, Zahlungen), Sperrzeiten, Gäste, Portal-Aufgaben, Bewertungen. *Expertenansicht* – alle Einstellungen, die die Rolle erlaubt (Preise, Angebote, Portale, Webseite, System). Ohne Auswahl: Administratoren Experten-, alle anderen einfache Ansicht. Umschalten jederzeit über das Benutzermenü oben rechts („Zur … Ansicht wechseln“). Die Ansicht blendet nur Menüpunkte aus; Rechte regelt allein die Rolle.
**Passwort vergessen:** Ein Administrator vergibt unter System › Benutzer › Bearbeiten ein neues Passwort (eine Selbst-Zurücksetzung per E-Mail gibt es bewusst nicht). **Handy verloren:** dort Aktion „2FA zurücksetzen“ – die Person richtet die 2FA bei der nächsten Anmeldung neu ein.
**Zwei-Faktor-Anmeldung (2FA):** Filament-eigene Lösung mit Authenticator-App (TOTP, z. B. Bitwarden/Vaultwarden, Google oder Microsoft Authenticator) und Wiederherstellungscodes.
- **Pflicht für Administratoren:** Nach der ersten Anmeldung wird man auf die Einrichtungsseite geleitet (QR-Code scannen, Code bestätigen, Wiederherstellungscodes sichern). Umgesetzt mit `App\Http\Middleware\RequireTwoFactorForAdmins`.
+89
View File
@@ -0,0 +1,89 @@
# BUCHUNGSPROZESS – Vertrags-, Zahlungs- und Stornierungsablauf
> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu).
Stand: 22.10.2026 · **Entwurf zur Freigabe.** Keine Umsetzung. Juristische Einordnung (u. a. §§ 312j, 312k BGB) ist **offener Prüfpunkt** – nichts hier ist als rechtskonform bestätigt.
## 1. Ist-Stand (im Code belegt)
`Reserved` (Anfrage = zugleich zeitlich begrenzte Vorreservierung, `hold_hours`) → `Confirmed` (Vermieterin bestätigt: Vertrag-PDF + Mail, Anzahlungsfrist) → `DepositPaid` → `Paid` → `Completed`; Nebenpfade `Declined`, `Expired`, `Cancelled`. Alle Statuswechsel laufen manuell (Admin) oder per Zeitjob; Zahlungen werden manuell erfasst (`RecordPayment`). Quellen: `app/Enums/BookingStatus.php`, `app/Actions/*`.
Nicht vorhanden: Angebot als eigener Schritt, Annahme durch Gast, Nachweis des Vertragsschlusses, Stornokostenberechnung, Gäste-Storno, Erstattungsworkflow, Empfangsbestätigung mit Vertragstext.
## 2. Ziel-Statusmodell
| Status | Bedeutung | Belegt Kalender? | Übergang durch | Mail an Gast |
|---|---|---|---|---|
| `inquiry` | Unverbindliche Anfrage (nur Daten) | nein | Gast (Formular) | Eingangsbestätigung (nicht verbindlich) |
| `reserved` | Vorreservierung, befristet gehalten | ja (Hold) | Vermieterin/Automatik | Info zur Frist |
| `offer_sent` | Ausdrückliches Angebot mit Preis, Bedingungen, Frist | ja (bis `offer_expires_at`) | Vermieterin (später KI-Entwurf + Freigabe) | Angebot + Annahme-Link |
| `offer_expired` / `offer_declined` | Frist verstrichen / Gast lehnt ab | nein | Zeitjob / Gast | Info |
| `confirmed` | **Annahme durch Gast** → verbindliche Buchung (Vertrag geschlossen) | ja | Gast (Annahme) | Vertragsunterlagen + Zahlungsaufforderung |
| `deposit_paid`, `paid`, `completed` | wie bisher | ja | Zahlung/Zeit | Quittungen/Hinweise |
| `cancel_requested` | Stornierung/Kündigung vom Gast erklärt | ja bis Entscheidung | Gast | Eingangsbestätigung |
| `cancelled` | Storniert, Kosten berechnet | nein | Vermieterin/Automatik | Stornobeleg |
| `declined` | Vermieterin lehnt Anfrage ab | nein | Vermieterin | Absage |
| `no_show` (optional) | Nichtanreise | – | Vermieterin | – |
Bestehende Werte bleiben gültig (Spalte `status` ist String): `Reserved` bleibt, `Confirmed` wird semantisch auf „Annahme erfolgt“ geschärft. Migrationspfad: bestehende `Confirmed`-Buchungen gelten als angenommen (Entscheidung nötig).
**Zahlungspflicht:** Nur im Übergang `offer_sent → confirmed` durch eindeutigen Button (Beschriftung z. B. „zahlungspflichtig buchen“, ⚖ Wortlaut § 312j (3) BGB prüfen) wird sie begründet; alle übrigen Schritte sind ausdrücklich nicht zahlungspflichtig.
## 3. Ablauf Direktbuchung
1. **Anfrage** (Formular, bestehend `BookingRequest`): Pflichtfelder wie heute, Hinweis „unverbindlich“, Datenschutzhinweis (Art. 13). Eingangsbestätigung per Mail (bestehend `ReservationReceived`).
2. **Vorreservierung**: Datumshold wie `hold_expires_at`; Ablauf durch bestehenden Job.
3. **Angebot**: Vermieterin erstellt/prüft Angebot aus `PriceQuote` (bestehend) + Stornobedingungen + Kurabgabe-Hinweis + AGB/Datenschutz; Angebotsdokument als PDF (`documents.type=offer`), Hash gespeichert. Gültigkeit `offer_expires_at`.
4. **Annahme durch Gast** (ohne Konto): Mail mit **signiertem, befristeten, einmal nutzbaren Link** (Muster wie `URL::temporarySignedRoute` bei Newsletter/Bewertung) → Seite zeigt Angebot vollständig (Preis, Leistungen, Bedingungen) und Zusammenfassung; Bestätigung per Button. Zusätzlich möglich: Rückbestätigung per Mail-Link (Double-Check), falls ⚖ erforderlich.
5. **Verbindliche Buchung**: System setzt `accepted_at`, speichert **Annahmenachweis** (Zeitpunkt, Angebots-Hash, Angebotsversion, Bedingungenversion, IP-Hash/User-Agent – nur wenn zwingend nötig und ⚖ datenschutzrechtlich geprüft, sonst weglassen), Kalender belegt, Portal-Sperr-Aufgaben laufen (bestehender Observer).
6. **Vertragsunterlagen per E-Mail**: Bestätigungsmail + Vertrag/AGB/Stornobedingungen als PDF (bestehend `RentalContract`, `BookingConfirmed`) = **elektronische Empfangsbestätigung** des Annahme-Eingangs (⚖ § 312i BGB).
7. **Zahlung**: Anzahlung/Restzahlung wie `SendBookingReminders`/`RecordPayment`.
8. **Abschluss**: `Completed`; Bewertungsanfrage (bestehend).
Die Akteure „Vermieterin“ und später „KI-Agent“ sind getrennt: Angebotserstellung/Annahme-Prüfung dürfen automatisiert **vorbereiten**; Versand von Preis/Angebot/Absage erfordert zunächst menschliche Freigabe (offene Entscheidung zur späteren Autonomiestufe).
## 4. Technische Voraussetzungen (Prüfung Ist/Soll)
| Voraussetzung | Ist | Soll |
|---|---|---|
| Eindeutige Kennzeichnung der Zahlungspflicht | ❌ | Angebotsseite/Button; Text und Reihenfolge ⚖ |
| Dokumentation des Vertragsschlusses | ❌ (nur `confirmed_at`) | `accepted_at`, Angebots-/AGB-Version, Hash, Audit-Event |
| Vertragsunterlagen per E-Mail | ✅ (PDF bei Bestätigung) | Beibehalten, um Angebot/AGB-Hash ergänzen |
| Sichere Storno-/Kündigungserklärung ohne Konto | ❌ | Signierter Link in jeder Buchungsmail → Formular (Grund optional, Pflicht: Buchungsreferenz via Link-Token); Bestätigungsmail mit Zeitstempel; Alternative: Antwort-Mail; ⚖ ob Pflicht zur elektronischen Erklärung/Button nach § 312k BGB besteht (vermutlich Dauerschuldverhältnis-bezogen, **offen**) |
| Nachvollziehbare Stornokosten | ❌ (Freitext) | Staffel als Daten (`cancellation_policy`: ab Tag X vor Anreise Y % vom Mietpreis), Berechnung im `Action`, Anzeige im Angebot und Storno-Beleg; ⚖ Zulässigkeit der Pauschalen (§ 309 Nr. 5 BGB, ggf. Angemessenheit) |
| Rückerstattungen | ⚠ negative `Payment` möglich | Erstattungs-Action: Betrag aus Policy, Grund, Beleg, Zahlungsweg (Überweisung), Status in `payments` |
| Elektronische Empfangsbestätigung | ⚠ Anfragebestätigung ✅, Annahmebestätigung ❌ | Unmittelbare Mail nach Annahme/Storno |
| Zahlungsarten | Überweisung/bar | Keine Online-Zahlung geplant (damit PCI-DSS/PSD2-Thema nicht berührt) |
## 5. Stornierung (Entwurf)
1. Gast klickt Link → sieht Buchung, **berechnete Stornokosten** (Policy + Datum), erklärt Storno (Button).
2. System setzt `cancel_requested`/`cancelled`, speichert Zeitpunkt (`cancelled_at`, bestehend), `cancelled_by=guest`, berechnet `cancellation_fee`; sendet Bestätigung; Admin-Hinweismail; Observer erzeugt Portal-Entsperraufgaben (bestehend).
3. Erstattung: Differenz aus Zahlungen − Kosten → Erstattungsbuchung; Beleg als Dokument.
4. Storno durch Vermieterin: wie heute möglich, aber mit Grund, Gast-Mail, automatischer Erstattung (heute nur Statuswechsel).
5. Portalbuchungen: Storno läuft über das Portal; System importiert Stornomail (bestehend `PortalEmailType::Cancellation`) und gibt Block frei; Stornokosten/Erstattung nach Portalregeln (manuell, ggf. Portalabrechnung).
## 6. Kurabgabe, Küstenkarte, Gästemeldung (Kühlungsborn)
**Trennung der Rechtsgrundlagen (Prüfannahme, ⚖):**
- **Bundesrechtlich:** Meldepflicht Beherbergungsstätten (Bundesmeldegesetz, §§ 29 f. BMG; Länder-/Ortsregelungen zu elektronischer Meldung beachten). Zweck: Gästemeldung/Meldeschein; Daten laut Gesetz (u. a. Name, Anschrift, Ankunft/Abreise, Zahl und Staatsangehörigkeit Mitreisender – exakter Umfang ⚖). Aufbewahrungs- und Vernichtungsfristen: **gesetzlich**, nicht frei wählbar.
- **Kommunal:** Kurabgabe (Kommunalabgabengesetz M-V + Kurabgabesatzung Ostseebad Kühlungsborn): Abgabepflichtige Personen, Befreiungen, Erhebung durch Beherbergungsbetrieb, Abführung, ggf. Aufwandsentschädigung. Erforderliche Daten (je Person: Alter/Befreiung, Aufenthaltstage) und Fristen ⚖ der Satzung.
- **Küstenkarte** (digitale Gästekarte): Ausgabe an Gäste über das lokale System; Leistungen/Daten ⚖ bei Tourist-Information klären.
- **feratel MeldeClient:** Laut `docs/PORTALE.md` Schnittstelle für Software-Partner (Testbetrieb); Konditionen, Datenumfang, Rolle (Auftragsverarbeitung oder eigene Verantwortung der Gemeinde) ❓ offen.
**Datenfluss (Soll, vorbehaltlich Klärung):** Gast liefert Meldedaten (Pre-Check-In-Link, ohne Konto) → Daten **getrennt** vom Buchungs-CRM gespeichert (Tabellen `registrations`, `registration_guests`) → Übermittlung an feratel/Gemeinde → Löschung nach gesetzlicher Frist. Portalgäste: Meldedaten gesondert beim Gast erfragen, nicht aus Portalmails raten.
**Technische Datenfelder (Entwurf):** je Person Vorname, Nachname, Geburtsdatum/Altersgruppe, Anschrift/Staatsangehörigkeit (nur soweit gesetzlich), An-/Abreise, Befreiungsgrund; je Buchung Kurabgabebetrag (`tourist_tax_amount`) und Erhebungsstatus (`collected_by_host`/`portal`/`on_site`).
**Offen:** Formal Erhebung der Kurabgabe bei Portalbuchungen (Portal zieht ggf. ein), Abrechnungsweg mit Gemeinde, Rolle Tourist-Information (⚖).
## 7. Offene Rechtsfragen (Buchungsprozess)
1. Geltung und Ausgestaltung von § 312j BGB (Button, Informationspflichten) für Beherbergung/Ferienwohnung.
2. Anwendbarkeit von § 312k BGB (Kündigungsbutton) auf Ferienwohnungsmietverträge.
3. Widerrufsrecht bzw. gesetzliche Ausnahme bei Beherbergung zu bestimmtem Termin (§ 312g BGB).
4. Wirksamkeit/Angemessenheit der Stornopauschalen und AGB-Einbeziehung.
5. Beweisanforderungen an den Annahmenachweis; Umfang zulässiger Protokolldaten (IP).
6. Preisangaben-Pflichten (PAngV) bei Pflichtkosten/Kurabgabe.
7. Einbeziehung der Gäste-Informationspflichten (Art. 13/14) in Angebot/Vertrag.
8. Zulässigkeit automatisierter Entscheidungen bei Ablehnung/Preisbildung durch KI (Art. 22 DSGVO).
+95
View File
@@ -0,0 +1,95 @@
# DATENMODELL-KONZEPT – Zielarchitektur Gäste, Buchungen, Portale
> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu).
Stand: 22.10.2026 · **Entwurf zur Freigabe.** Keine Migration erstellt oder ausgeführt. Grundprinzipien: Datenminimierung, Quellenkennzeichnung, keine geratenen Daten, möglichst Wiederverwendung des Bestands.
## 1. Bestandsaufnahme (Implementiert?)
| Anforderung | Bestand | Status |
|---|---|---|
| Portalübergreifende Gästekartei, interne ID | `guests.id` ✅; aber nur Direktgäste, Dublette nur exakt per E-Mail | Teilweise |
| Herkunftsportal | `bookings.source` (Text, z. B. `website`), `referral_source` (Marketing), `blocked_periods.channel_id` + `source` | Teilweise (Portal nur am Block) |
| Externe Buchungsreferenz | `blocked_periods.external_uid`, `portal_emails.reference`; nicht am Buchungsdatensatz | Teilweise |
| Reservierungs-/Buchungsstatus | `BookingStatus` (8 Werte) ✅; kein Angebot/Annahme | Teilweise |
| Mietpreis | `bookings.total/deposit`, `quote` JSON ✅ (nur Direkt) | Teilweise |
| Portalgebühren | – | Fehlt |
| Kurtaxe | nur Hinweistext | Fehlt |
| Zahlungen | `payments` ✅ (Überweisung/bar/sonstige; Erstattung = negativer Betrag) | Vorhanden |
| Steuerrelevante Nachweise | Vertrags-PDF (`contract_path`) ✅; keine Rechnungen/Belege/Portalabrechnungen | Teilweise |
| Ein-/ausgehende Portalnachrichten | `portal_emails` (nur eingehende Benachrichtigungen, Auszug) | Teilweise |
| Dublettenprüfung / Zusammenführung | – | Fehlt |
| Datenquelle + Importzeitpunkt | `channel_sync_logs`, `portal_emails.received_at`; nicht am Gast/Buchung | Teilweise |
## 2. Leitentscheidung (Annahme)
**Portalbuchungen werden als `Booking` geführt** (nicht länger nur als `BlockedPeriod`), mit `source = <Kanal>`, optionalem Gast und leeren Feldern, wo keine Daten vorliegen. `BlockedPeriod` bleibt für Eigenbelegung, Wartung und rein per iCal bekannte Sperren. Zuordnung `BlockedPeriod` → `Booking` über neue FK, sobald eine Portal-Mail/API die Buchung identifiziert. Vorteil: ein Reporting, ein Zahlungs-/Belegmodell; bestehende `Booking::occupying()`-Logik und Observer greifen weiter. *(Entscheidung/Alternative zu bestätigen.)*
## 3. Zielmodell (Änderungen am Bestand, kursiv = neu)
### 3.1 `guests` (Erweiterung)
| Feld | Zweck |
|---|---|
| `id` (intern, bleibt) | eindeutige Gäste-ID |
| *`data_source`* (`direct`, `portal_mail`, `portal_api`, `manual`) | Herkunft der Stammdaten |
| *`imported_at`* | Importzeitpunkt |
| *`merged_into_id`* (nullable FK) | Zusammenführung, Quelle bleibt als „gemergt“ erhalten |
| *`address_verified`* / Feldquellen | Kennzeichnung, ob Daten vom Gast selbst stammen |
| bestehende Felder | unverändert; `email` darf bei Portalgästen **NULL** sein (Portale liefern oft maskierte Adressen) |
### 3.2 *`guest_identities`* (optional, später)
Mehrere Kennungen je Gast (E-Mail, Portal-Alias, Telefon) mit Quelle – Grundlage der Dublettenprüfung ohne Überschreiben (löst D8).
### 3.3 `bookings` (Erweiterung)
| Feld | Zweck |
|---|---|
| `source` (bestehend) | Kanal-Schlüssel (`website`, `fewo_direkt`, …) – mit `channels` verknüpfbar |
| *`channel_id`* (nullable) | exakte Portalzuordnung |
| *`external_reference`* (nullable, unique je Kanal) | Portal-Buchungsnummer, nur wenn belegt |
| *`imported_at`*, *`import_source`* (`ical`, `email`, `api`, `manual`) | Quelle/Zeitpunkt |
| *`offer_sent_at`, `offer_expires_at`, `accepted_at`, `acceptance_evidence`* (JSON) | Angebot/Annahme, s. BUCHUNGSPROZESS.md |
| *`rent_amount`* (bestehend `total` weiterverwendbar), *`portal_fee`*, *`tourist_tax_amount`*, *`tourist_tax_collected_by`* | Beträge in Euro-Cent |
| *`cancellation_fee`*, *`cancelled_by`*, *`cancellation_reason`* | Storno |
| `contract_path` (bestehend) | wird durch `documents` abgelöst (§3.5) |
Beträge unverändert als Integer-Cent (Projektregel).
### 3.4 `payments` (Erweiterung)
`type` (`deposit`, `balance`, `refund`, `portal_payout`, `tourist_tax`), `external_reference`, `currency` (EUR). Erstattungen weiter als negativer Betrag oder Typ `refund` (Entscheidung offen).
### 3.5 *`documents`* (neu) – steuerrelevante Nachweise
`booking_id`, `type` (`contract`, `offer`, `invoice`, `receipt`, `portal_statement`, `registration_form`, `correspondence`), `path`, `sha256` (Unveränderbarkeitsnachweis), `created_at`, `retain_until` (aus Löschkonzept), `contains_personal_data`. Dateien auf privatem Disk, nicht öffentlich. Ablösung des Einzelfelds `contract_path`.
### 3.6 *`messages`* (neu) – Portal-/Gästekommunikation
`booking_id`/`guest_id`, `direction` (`in`/`out`), `channel` (`email`, `portal`), `external_id` (z. B. Message-ID, bereits in `portal_emails.message_id`), `subject`, `body` (optional, **mit kurzer Frist**), `received_at`/`sent_at`, `source`. Bestehende `portal_emails` bleibt als Parsing-Protokoll; Auszug (`excerpt`) wird gekürzt/entfernt (D6).
### 3.7 *`guest_merge_candidates`* (neu, optional)
`guest_a_id`, `guest_b_id`, `score`, `reasons` (z. B. gleiche E-Mail, gleicher Name + Zeitraum), `status` (`open`, `merged`, `rejected`). Zusammenführung nur manuell im Admin.
### 3.8 *`audit_events`* (neu)
Wer/Was/Wann für Statuswechsel, Zusammenführung, Export, Anonymisierung, Dokumentabruf – ohne Inhalte, mit Löschfrist.
## 4. Datenquellen je Feld
| Feld | iCal | Portal-E-Mail | Autorisierte API | Direkt (Formular) |
|---|---|---|---|---|
| Zeitraum | ✅ | ✅ (Parser) | ✅ | ✅ |
| Portal/Kanal | ✅ (über Channel) | ✅ (Absender) | ✅ | – |
| Externe Referenz | UID (nicht Buchungsnr.) | ✅ falls im Text | ✅ | – |
| Gastname/E-Mail/Tel. | ❌ | ❓ nur wenn Mail sie enthält | ✅ (vertragsabhängig) | ✅ |
| Preis/Gebühren | ❌ | ❓ | ✅ | ✅ (Quote) |
| Zahlungen | ❌ | ❌ | ❓ | manuell |
| Nachrichten | ❌ | eingeschränkt | ✅ | ✅ (Mail) |
Regel: Importer schreiben **nur** belegte Felder; Unbekanntes = `NULL` + Kennzeichnung; Parser-Unsicherheit → `needs_review` (bereits so umgesetzt).
## 5. Dublettenprüfung und Zusammenführung
1. Exakter Treffer: normalisierte E-Mail (bestehend) → vorschlagen, **nicht** stillschweigend überschreiben.
2. Weiche Treffer: Name + Zeitraum/Portal-Referenz, Telefonnummer normalisiert → nur als Kandidat.
3. Zusammenführung manuell: Zielgast wählen, Felder einzeln übernehmen, Buchungen umhängen, Quellgast `merged_into_id`, Audit-Eintrag; keine Löschung der Historie.
4. Direktanfragen mit bekannter E-Mail aktualisieren Stammdaten **nur nach Bestätigung** (Fix für D8).
## 6. Wiederverwendung / Umsetzungsreihenfolge (nach Freigabe)
1. Felder/Migrationen (additiv, rückwärtskompatibel). 2. `documents` + Umzug von `contract_path`. 3. Importpfad Portal-Mail → `Booking` (Parser bleibt). 4. Merge-Kandidaten + Admin-Aktion. 5. Finanzfelder (Gebühren, Kurtaxe). 6. API-Connector über `ChannelConnector` (nur nach Anbieter-/AVV-Klärung).
+2
View File
@@ -1,5 +1,7 @@
# Datenschutz- und Datenfluss-Audit – Ferienwohnung Stommer
> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu).
Stand: 22.10.2026 · Art: **Read-only-Codeaudit** (Repository-Stand `main` + lokale, noch nicht committete Änderungen) · Verantwortliche: Brigitte Stommer
> **Hinweis zur Verwendung:** Dies ist eine technische Bestandsaufnahme, keine Rechtsberatung. Alle Rechtsgrundlagen sind *Prüfannahmen*. Vor Veröffentlichung der Datenschutzerklärung ist eine juristische Prüfung (ggf. Datenschutzbeauftragte/r bzw. Rechtsberatung) erforderlich. Der Bericht ist vor Weitergabe an Dritte zu prüfen und zu validieren.
+54
View File
@@ -0,0 +1,54 @@
# DATENSCHUTZ-FAKTENBASIS – Grundlage für die Datenschutzerklärung
> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu).
Stand: 22.10.2026 · **Kein Erklärungstext, sondern strukturierte Faktenlage.** Rechtsgrundlagen sind *vorgeschlagen* (Prüfannahme) und juristisch zu bestätigen. Grundlage: Code-Audit ([DATENSCHUTZ-AUDIT.md](DATENSCHUTZ-AUDIT.md)), [LOESCHKONZEPT.md](LOESCHKONZEPT.md), [BUCHUNGSPROZESS.md](BUCHUNGSPROZESS.md).
Status: ✅ im Code belegt · 📄 dokumentiert/konfiguriert · 🗓 geplant · ❓ unbekannt · ⚖ rechtlich zu prüfen. **Browserverhalten wurde nicht beobachtet** (nur Codebefund).
**Verantwortliche:** Brigitte Stommer (Kontaktdaten aus `config/fewo.php`/Impressum). Datenschutzbeauftragte/r: ❓ Pflicht ⚖ prüfen.
## Verarbeitungsvorgänge
| # | Vorgang | Datenkategorien | Zweck | Vorgeschlagene Rechtsgrundlage ⚖ | Herkunft | Empfänger | Drittland | Speicher-/Löschregel | Technische Schutzmaßnahmen | Offene Rechtsfragen | Status |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | Besuch der Website / Server-Logs | IP, Zeit, URL, User-Agent | Auslieferung, Sicherheit | Art. 6 (1) f | Besucher | STRATO (Hosting) | keins bekannt ❓ | Strato-Logs ❓; Anwendungslog: Rotation geplant | HTTPS, Throttling | Log-Dauer; AVV Strato | ❓ |
| 2 | Technisch notwendige Cookies | Session-Cookie, XSRF-Token (Session-ID, IP/UA in `sessions`) | Formularschutz, Session | Art. 6 (1) f; § 25 (2) Nr. 2 TDDDG | Besucher | STRATO | – | Lifetime 120 Min. (`config/session.php`) | httpOnly, SameSite=lax, Secure auf Staging gesetzt | Banner-Pflicht verneint? Browserprüfung | ✅ Code / ❓ Browser |
| 3 | Externe Ressourcen | – (keine Drittanfragen im Code) | – | – | – | – | – | – | Schriften lokal | Verifikation im Browser | ✅ Code |
| 4 | Link zu OpenStreetMap | beim Klick: IP, Referrer, Adresse als Suchparameter an OSMF | Orientierung | Art. 6 (1) f | Besucher (Klick) | OpenStreetMap Foundation (UK) | ⚖ Drittland UK (Angemessenheitsbeschluss prüfen) | – | Kein Einbetten, kein Laden bei Seitenaufruf | Hinweis in DSE | ✅ |
| 5 | Buchungsanfrage (Direkt) | Name, E-Mail, Telefon*, Anschrift*, Zeitraum, Personen, Extras, Nachricht*, Herkunft*, UTM* (*optional) | Vertragsanbahnung | Art. 6 (1) b; Herkunft/UTM: Art. 6 (1) f | Gast | Vermieterin; STRATO (Datenbank, SMTP) | keins bekannt | Anfragen ohne Vertrag: Frist vorgeschlagen 3–6 Monate (⚖); heute 10 J. | Rate-Limit, Honeypot, CSRF, Validierung | Fristen; Einwilligungstext im Formular | ✅ |
| 6 | Vorreservierung/Angebot/Annahme | Buchungsdaten, Preise, Angebotsversion, Annahmezeit (+ Nachweisdaten) | Vertragsabschluss | Art. 6 (1) b | Gast/Vermieterin | wie 5 | – | Beleg bis Steuerfrist ⚖ | Signierter, befristeter Annahme-Link | § 312i/j/k BGB; Umfang Nachweisdaten | 🗓 (Annahme nicht implementiert) |
| 7 | Vertrag & Rechnung/Quittung | Gast-, Buchungs-, Zahlungsdaten | Vertragserfüllung, steuerl. Pflichten | Art. 6 (1) b, c | Vermieterin/Gast | Gast; Steuerberater ❓ | – | steuerliche Frist ⚖ | privater Speicher, Rollenzugriff | Frist, Anonymisierung der Belege | ✅ PDF / 🗓 Rechnungen |
| 8 | Zahlungsabwicklung | Betrag, Datum, Methode, Notiz | Zahlungsverwaltung | Art. 6 (1) b, c | Vermieterin (manuell) | Bank der Vermieterin | – | steuerliche Frist ⚖ | Kein Zahlungsdienstleister im System | Banken als eigene Verantwortliche | ✅ |
| 9 | Transaktions-E-Mails | E-Mail, Name, Buchungsdaten | Information zur Buchung | Art. 6 (1) b | Anwendung | STRATO SMTP; Gast | – | Mail-Archiv ❓ | TLS ❓ | Mail-Aufbewahrung | ✅ Code / 📄 Betrieb |
| 10 | Bewertungsanfrage + Bewertung | E-Mail, Name, Bewertung, Anzeigename, Einwilligung | Qualitätssicherung, Veröffentlichung | Anfrage: Art. 6 (1) f (⚖ § 7 UWG); Veröffentlichung: Art. 6 (1) a | Gast | Öffentlichkeit (nach Freigabe) | – | siehe LOESCHKONZEPT | Signierter Link 90 Tage, Moderation | Zulässigkeit Anfrage-Mail | ✅ |
| 11 | Angebots-/Newsletter-Einwilligung | E-Mail, Name, Consent-Zeitpunkt | Marketing | Art. 6 (1) a; § 7 UWG | Gast | Vermieterin; Versanddienst ❓ | ❓ | Bis Widerruf; Nachweis ⚖ | DOI, signierte Links | Versandweg/Dienstleister | ✅ Consent / ❓ Versand |
| 12 | Gästekartei/CRM | Stammdaten, Notizen, Tags, Aufenthalte | Kundenpflege | Art. 6 (1) f | Gast/Portal | Vermieterin | – | 3 J.-Stufe vorgeschlagen ⚖ | Policy-Rollen, 2FA für Admin | Berechtigtes Interesse; Frist | ✅ |
| 13 | CSV-Export Gäste | Stammdaten | Verwaltung/Mailing | Art. 6 (1) f | Admin | Lokaler Rechner der/des Admins | – | Verantwortung Nutzer | Rollenschutz, Audit-Log 🗓 | Auditpflicht | ✅ |
| 14 | Portal-Kalenderabgleich (iCal) | nur Zeiträume; ggf. Portal-SUMMARY | Doppelbuchung vermeiden | Art. 6 (1) b/f | Portal | Portale (nur „Belegt“) | Portalbetreiber ❓ (z. B. Vrbo/Expedia → ⚖ Drittland) | Sperren bis Zeitraumende + Frist | Token-URL, Throttle | Inhalt SUMMARY | ✅ |
| 15 | Portal-Buchungsmails | Absender, Betreff, Auszug (500 Z.), Zeitraum, Referenz; Gästedaten *nur wenn in Mail* | Sofortige Sperre, Verwaltung | Art. 6 (1) b/f | Portal (E-Mail) | STRATO (Postfach), Vermieterin | Portalbetreiber ❓ | Auszug kurz; Referenz/Zeitraum bis Steuerfrist ⚖ | IMAP/SSL, Parser „nie raten“ | Art. 14-Information | ✅ Code / 🗓 Produktiv |
| 16 | Portalbuchungen als Gast (geplant) | Gastdaten laut Portal, Preise, Gebühren | zentrale Verwaltung, Steuer | Art. 6 (1) b, c, f | Portal (E-Mail/API) | wie oben | ❓ | wie 7/12 | s. DATENMODELL-KONZEPT | Art. 14, AVV mit Channel-Manager | 🗓 |
| 17 | Gästemeldung / Kurabgabe | Meldedaten je Person, Aufenthalt, Befreiung | gesetzliche Meldung, Abgabe | Art. 6 (1) c (BMG), Art. 6 (1) e/c (Kurabgabesatzung) ⚖ | Gast | Gemeinde/Tourist-Info, feratel ❓ | ❓ | gesetzliche Frist ⚖ | getrennte Speicherung (Soll) | Bund/Kommune trennen; Rolle feratel | 🗓 |
| 18 | Admin-Zugang | Name, E-Mail, Rolle, 2FA | Verwaltung | Art. 6 (1) f | Admins | – | – | bis Ausscheiden | Passwort-Hash, TOTP-2FA, Rollen | – | ✅ |
| 19 | Monitoring/Automation (n8n, Webhook) | Betriebsstatus, Aufgaben | Überwachung, Portalsperre | Art. 6 (1) f | Anwendung | Privater Server ❓ | ❓ | ❓ | HMAC, Tokens (Query ⚠) | Auftragsverarbeitung, Standort | 📄 |
| 20 | KI-Agent | – | – | – | – | – | – | – | – | Anbieter, EU/EWR, Training, Art. 22 | 🗓 nicht implementiert |
| 21 | Backups | gesamter Datenbestand | Verfügbarkeit | Art. 6 (1) f, Art. 32 | – | STRATO/Eigenbetrieb ❓ | ❓ | rollierend (Vorschlag 30 T.) | ❓ | Retention vs. Löschung | ❓ |
## Empfänger-/Dienstleisterliste (für DSE)
STRATO AG (Hosting, DB, E-Mail) – AVV ❓ · OpenStreetMap Foundation (nur bei Klick) · Portalbetreiber (FeWo-direkt/Vrbo/Expedia u. a.) als eigene Verantwortliche – ❓ · Steuerberater ❓ · Gemeinde/Tourist-Information/feratel (nur bei Meldepflicht) ❓ · n8n-Betreiber ❓ · KI-Anbieter 🗓.
## Rechte und Pflichttexte (⚖ ausformulieren)
Auskunft (Art. 15), Berichtigung, Löschung, Einschränkung, Übertragbarkeit, Widerspruch (Art. 21), Widerruf Einwilligung, Beschwerde bei Aufsichtsbehörde, Pflichtangaben vs. freiwillige Angaben, automatisierte Entscheidungen (derzeit keine ✅).
## Querschnitts-Fragen für Rechtsberatung / Datenschutzbeauftragte
1. DSB-Pflicht, Verarbeitungsverzeichnis (Art. 30), AVVs (Strato, n8n-Betreiber, ggf. Channel-Manager/KI).
2. TDDDG/Cookie-Einordnung der technisch notwendigen Cookies.
3. Art. 14-Information für Portalgäste und Ausnahmen.
4. Rechtsgrundlage und Fristen für Anfragen, Bewertungen, Marketing-Nachweis.
5. Drittlandbezug der Portalbetreiber und der KI-Anbieter.
6. Beweis-/Annahmeprotokoll beim Vertragsschluss (Datenumfang).
*Vor externer Verwendung (Veröffentlichung/Weitergabe) bitte durch fachkundige Stelle prüfen.*
+54
View File
@@ -0,0 +1,54 @@
# GAP-DELTA – Ergänzungen zum Datenschutz-Audit
> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu).
Stand: 22.10.2026 · Ergänzt [DATENSCHUTZ-AUDIT.md](DATENSCHUTZ-AUDIT.md) um die verbindlichen Produktentscheidungen (Folgeauftrag). **Reine Analyse – keine Codeänderung, keine Migration, kein Deployment.** Rechtliche Punkte sind Prüfannahmen und mit ⚖ „rechtlich zu prüfen“ markiert.
Legende: ✅ implementiert und im Code belegt · 📄 nur konfiguriert/dokumentiert · 🗓 geplant · ❓ unbekannt · ⚖ juristische Prüfung nötig
## 1. Verbindliche Entscheidungen und ihr Umsetzungsstand
| # | Entscheidung | Ist-Stand | Status |
|---|---|---|---|
| E1 | Laravel-System führend für alle Buchungen und Gäste | Direktbuchungen ✅ (`bookings`, `guests`). **Portalbuchungen sind keine `Booking`-Datensätze**, sondern `BlockedPeriod` (Sperre, ohne Gast, ohne Preis) bzw. `PortalEmail` (Auszug). Damit ist das System nur für die *Belegung* führend, nicht für Portalgäste und -umsätze | ⚠ Lücke |
| E2 | Portalbuchungen zentral verwalten | Nur Kalenderblock + Hinweis-Mail; keine Gäste-, Preis-, Gebühren-, Zahlungsdaten | ⚠ Lücke |
| E3 | Buchungs-/Zahlungsnachweise steuerlich verfügbar | Direkt: `payments`, `bookings.quote` (JSON), Vertrags-PDF ✅. Keine Rechnung/Beleg-Dokumente, keine Portalabrechnungen, keine Unveränderbarkeit/Revisionssicherheit | ⚠ Teilweise |
| E4 | Kein Gästekonto | ✅ (signierte Links für Bewertung/Newsletter). Für Annahme/Storno fehlt ein Äquivalent | ⚠ Lücke |
| E5 | Anfrage → Vorreservierung → Angebot → Annahme → Buchung | Status: `Reserved` (Anfrage+Vorreservierung vermischt) → `Confirmed` durch Vermieterin. **Kein Angebot, keine Gast-Annahme** | ⚠ Lücke |
| E6 | KI später | Kein KI-Code (✅ belegt: keine KI-Pakete/Aufrufe) | 🗓 |
| E7 | Privacy by Design / Datenminimierung | Teilweise (Honeypot, Rate-Limit, Anonymisierung, signierte Links); Lücken in Löschung, Logs, Sessions | ⚠ Teilweise |
## 2. Neue/präzisierte Befunde (Delta zum Audit)
| ID | Prio | Befund | Beleg | Folge |
|---|---|---|---|---|
| D1 | **K** | Portalgäste existieren im System nicht (nur Zeitraum). Entscheidung E1/E2 erfordert Erweiterung des Datenmodells | `app/Models/BlockedPeriod.php`, `ProcessPortalMail`, `SyncChannel` | → DATENMODELL-KONZEPT.md |
| D2 | **K** | Kein Angebot-/Annahme-Mechanismus, keine Dokumentation des Vertragsschlusses (Zeitpunkt, Inhalt, IP/Nachweis) | `BookingStatus`, `ConfirmBooking` | → BUCHUNGSPROZESS.md |
| D3 | **H** | Stornierung = reiner Statuswechsel im Admin (`ViewBooking`), ohne Stornokosten-Berechnung, Gast-Benachrichtigung, Rückerstattungsbuchung, Beleg | `ViewBooking.php` Z. ~112; `RecordPayment` erlaubt negative Beträge als Erstattung (nur Hinweis im Docblock) | → BUCHUNGSPROZESS.md |
| D4 | **H** | Stornobedingungen nur als optionaler Freitext (`stay.cancellation`, Default `null`), nicht maschinenlesbar | `config/content.php` | Staffel als Daten modellieren |
| D5 | **H** | iCal-`SUMMARY` wird in `blocked_periods.reason` übernommen („Portalname: Summary“). Falls ein Portal Namen im SUMMARY liefert, würden Gästenamen ungeplant gespeichert; keine Löschung | `app/Actions/SyncChannel.php` Z. ~67, `ICalParser` | Prüfen, was FeWo-direkt tatsächlich liefert (❓); ggf. SUMMARY nicht speichern |
| D6 | **H** | `portal_emails.excerpt` (500 Zeichen) kann Namen/Kontaktdaten enthalten; keine Frist, keine Anonymisierung | `ProcessPortalMail` | Löschfrist (z. B. kurz nach Verarbeitung) oder Felder gezielt extrahieren |
| D7 | **H** | Dublettenprüfung nur exakt über E-Mail (`firstOrNew` auf `email`, kleingeschrieben). Keine Zusammenführung, keine Mehrfach-Identitäten, keine Quelle/Importzeitpunkt am Gast | `CreateReservation` Z. ~52, `Guest` | → DATENMODELL-KONZEPT.md |
| D8 | **H** | Bei Anfrage über E-Mail-Adresse eines bestehenden Gastes werden dessen Stammdaten per `fill()` **überschrieben** (Adresse/Telefon) – fremde Person könnte mit bekannter E-Mail Daten verändern | `CreateReservation` | Stammdaten versionieren/Bestätigung vor Überschreiben |
| D9 | **M** | Kurtaxe/Kurabgabe nur als Textinfo; keine Daten (Personen, Alter, Befreiung), keine Meldung, keine Abführung | `PricesSection`, Mail-Views; `docs/PORTALE.md` | → BUCHUNGSPROZESS.md §Kurabgabe |
| D10 | **M** | feratel-Meldeschein-Anbindung nur als Plan (Schnittstelle für Software-Partner, Konditionen offen) | `docs/PORTALE.md` | Klärung mit Tourist-Information; ⚖ |
| D11 | **M** | Portalgebühren/Provisionen: nicht modelliert | – | Felder in Buchung/Finanzposten |
| D12 | **M** | Nachrichtenhistorie (ein-/ausgehend) wird nicht gespeichert; versendete System-Mails nur im Mail-Log/Postfach | `app/Mail/*` | Nachrichtenprotokoll ohne Volltext oder mit Frist |
| D13 | **M** | Quelle: `bookings.source` (string, z. B. `website`); `referral_source` ist Marketing-Herkunft. Keine externe Buchungsreferenz an `Booking`; `BlockedPeriod.external_uid` und `PortalEmail.reference` existieren | Migrationen | Bestehende Felder wiederverwenden |
| D14 | **M** | Art. 14 DSGVO (Portalgäste): Informationspflicht gegenüber Gästen, deren Daten aus Portalen kommen, ist nicht umgesetzt | – | Information im Erstkontakt/Vertragsmail; ⚖ Ausnahme Art. 14 (5) prüfen |
| D15 | **M** | Staging-Mailer `log`: Gästemails (Vertrag, Preis, Namen) im Logfile; Log-Level `debug` per Default | `docs/BETRIEB.md` | Nur Testdaten verwenden; Produktiv-Logging härten |
## 3. Was bereits wiederverwendbar ist
- `Guest` (Stammdaten, Anonymisierung, Marketing-Consent), `Booking` (Status, `quote`, Beträge, Zahlungstermine, `contract_path`), `Payment` (negative Beträge möglich), `PortalEmail` (Typ, Status, Referenz, Zeitraum), `Channel`/`ChannelTask`/`ChannelSyncLog`, Actions-Muster in `app/Actions`, Observer-Mechanik, signierte URLs, Rate-Limiter, Rollen-Policies, Pflicht-2FA für Admins.
- `PriceQuote`/`bookings.quote`: Preisaufschlüsselung als JSON → Basis für Angebots- und Rechnungsdarstellung.
## 4. Quellenlage Portaldaten (nichts raten)
| Quelle | Verfügbare Daten | Gästedaten | Status |
|---|---|---|---|
| iCal | Zeitraum, UID, SUMMARY (portalabhängig) | keine zugesichert | ✅ implementiert |
| Portal-E-Mail | Typ, Zeitraum, Referenz (heuristisch geparst); Mailtext enthält ggf. Gast-/Preisdaten | Nur nachweislich im Text vorhandene Daten; Parser extrahiert aktuell **nur** Typ/Zeitraum/Referenz | ✅ Code, ❓ reale Mails |
| Autorisierte API (Channel-Manager/Partner) | Gast, Preis, Gebühren, Nachrichten (je Anbieter) | ja (vertragsabhängig) | 🗓 nicht implementiert |
Regel: Felder ohne belegte Quelle bleiben leer (`NULL`) mit Kennzeichnung `unbekannt`; keine Ableitung aus Nachnamen, Telefonnummern o. Ä.
+58
View File
@@ -0,0 +1,58 @@
# GO-LIVE-CHECKLISTE – priorisierte Maßnahmen
> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu).
Stand: 22.10.2026 · Priorität: **P0** Blocker (ohne diese nicht produktiv) · **P1** unmittelbar nach Go-Live bzw. vor Portalintegration · **P2** Ausbau. Die Checkliste ist eine *Maßnahmenplanung*; Konformität ist **nicht** nachgewiesen. Umsetzung nur nach Freigabe. Verweise: [GAP-DELTA.md](GAP-DELTA.md), [DATENSCHUTZ-AUDIT.md](DATENSCHUTZ-AUDIT.md).
## P0 – Blocker
| ☐ | Maßnahme | Bezug | Wer |
|---|---|---|---|
| ☐ | Impressum und Datenschutzerklärung erstellen, juristisch prüfen, im Footer + Buchungsformular verlinken | G1, G2 | Rechtsberatung/Betreiberin |
| ☐ | AVV mit STRATO prüfen/abschließen; Verarbeitungsverzeichnis anlegen; DSB-Pflicht prüfen | Faktenbasis | Betreiberin/DSB |
| ☐ | Produktiv-`.env` härten: `APP_ENV=production`, `APP_DEBUG=false`, `MAIL_MAILER=smtp` (TLS), `LOG_CHANNEL=daily`, `LOG_LEVEL` ≥ warning, `SESSION_SECURE_COOKIE=true` | G8 | Technik |
| ☐ | Browser-Verifikation Staging: Netzwerk/Cookies/Storage; Ergebnis in DSE | G9 | Technik |
| ☐ | Backup-Verfahren festlegen, Restore testen, Aufbewahrung dokumentieren | G5 | Technik |
| ☐ | Fristen des Löschkonzepts bestätigen lassen (Steuerberatung/Recht) | LOESCHKONZEPT | Steuerberatung/Recht |
| ☐ | Stornobedingungen, AGB, Widerrufs-/Verbraucherhinweise rechtlich klären (§§ 312g, 312i, 312j, 312k BGB) | BUCHUNGSPROZESS §7 | Recht |
| ☐ | Entscheidung: Direktbuchung vorerst als „Anfrage → Bestätigung“ betreiben (ohne Angebot/Annahme-Funktion) **oder** Go-Live erst nach Umsetzung des Angebot-/Annahmeprozesses | D2 | Betreiberin |
| ☐ | Staging mit Testdaten betreiben (kein Echtdaten-Import); Mail-Log nur Testadressen | D15 | Technik |
## P1 – Kurzfristig (Go-Live / vor Portal-Echtbetrieb)
| ☐ | Maßnahme | Bezug |
|---|---|---|
| ☐ | Löschjobs: Anfragen ohne Vertrag, `portal_emails.excerpt`, UTM, privates Review-Feedback; `anonymize()` um `internal_notes`, Review-Anzeigename erweitern | G3, G4, D6 |
| ☐ | Tokens aus Query-Parametern in Header verlegen (`/health/sync`, `/automation/scheduler`) | G6 |
| ☐ | Security-Header (HSTS, CSP, X-Frame-Options, Referrer-Policy, Permissions-Policy) | G11 |
| ☐ | Pflicht-2FA auch für Rolle `rentals`; Audit-Log für Export/Anonymisierung/Statuswechsel | G14, G15 |
| ☐ | Throttle für Bewertungs-/Annahme-/Storno-Routen | G12 |
| ☐ | iCal-`SUMMARY` prüfen (Portal liefert Namen?) und ggf. nicht speichern | D5 |
| ☐ | Gästestammdaten bei bekannter E-Mail nicht stillschweigend überschreiben | D8 |
| ☐ | Prozess Betroffenenrechte (Auskunft/Löschung) dokumentieren, Frist 1 Monat | G13 |
| ☐ | Art. 14-Information für Portalgäste (erste Mail + DSE-Abschnitt) | D14 |
| ☐ | n8n/Privatserver: Standort, Betreiber, Datenumfang dokumentieren; keine Gästedaten in Webhooks | G7 |
| ☐ | Cron/Scheduler produktiv einrichten und überwachen | `docs/BETRIEB.md` |
## P2 – Ausbau (Entscheidungen E1–E5)
| ☐ | Maßnahme | Bezug |
|---|---|---|
| ☐ | Datenmodell: `documents`, `messages`, Gebühren/Kurtaxe, Quelle/Importzeitpunkt (additiv, ohne Migrationsausführung vor Freigabe) | DATENMODELL-KONZEPT |
| ☐ | Portalbuchungen als `Booking` führen (Importpfad Portal-Mail); Merge-Kandidaten + manuelle Zusammenführung | DATENMODELL §5 |
| ☐ | Angebot + Annahme (signierter Link), Annahmenachweis, Empfangsbestätigung | BUCHUNGSPROZESS §3 |
| ☐ | Stornoformular ohne Konto, Stornokosten-Policy als Daten, Erstattungs-Action | BUCHUNGSPROZESS §5 |
| ☐ | Kurabgabe/Gästemeldung: Klärung mit Tourist-Information/feratel; getrennte Tabellen mit eigener Löschfrist | BUCHUNGSPROZESS §6 |
| ☐ | Steuerliche Nachweise: Rechnungen/Belege, Hash, `retain_until`, Export für Steuerberater | LOESCHKONZEPT |
| ☐ | Channel-Manager/API-Connector (nur nach AVV-/Anbieterprüfung) | PORTALE.md |
| ☐ | KI-Agent: Anbieter/Region/Training-Opt-out, Pseudonymisierung, Freigabe bei Preis/Angebot/Absage, Audit-Log, DSFA-Prüfung | Audit §5 |
## Entscheidungsbedarf (offen)
1. Portalbuchungen als `Booking` (empfohlener Entwurf) – bestätigen?
2. Angebot/Annahme **vor** oder **nach** Go-Live?
3. Gästedaten-Frist: 3 Jahre + Beleg (Vorschlag) – bestätigen nach Rechtsprüfung.
4. Bestehende `Confirmed`-Buchungen: als „angenommen“ migrieren?
5. Soll Annahmenachweis IP/User-Agent speichern (⚖) oder nur Zeitpunkt + Versionshash?
6. Kurabgabe/Gästemeldung: selbst erfassen oder über feratel/Tourist-Information?
7. Freigabe zur Umsetzung der Punkte P0/P1 (Code, Migrationen, Deployments erst auf Zuruf).
+17
View File
@@ -112,6 +112,23 @@ ## 6. Workflows
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.
- **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:
+69
View File
@@ -0,0 +1,69 @@
# LOESCHKONZEPT – Datenkategorien und Fristen
> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu).
Stand: 22.10.2026 · **Entwurf.** Alle Fristen sind **Vorschläge bzw. Prüfannahmen und rechtlich zu bestätigen** (Steuerberatung, Rechtsberatung, ggf. Datenschutzbeauftragte/r), sofern nicht „im Code belegt“. Kein Code geändert.
## 1. Prinzipien
1. **Trennung** operativer personenbezogener Daten (Gäste-Kommunikation, Marketing, Anfragen) von **archivierungspflichtigen Nachweisen** (Buchungs-/Zahlungsbelege, Verträge/Rechnungen).
2. Nach Ablauf des operativen Zwecks: Löschung bzw. Anonymisierung; Nachweise bleiben, werden aber auf das Nötige reduziert und nur noch zugriffsbeschränkt (Einschränkung der Verarbeitung, Art. 18 / Art. 17 (3) b).
3. Steuerliche Aufbewahrung geht der Löschung vor (Art. 17 (3) b DSGVO); Löschung erfolgt unverzüglich nach Fristende.
4. Jede Frist ist maschinell konfigurierbar (`config/fewo.php`) und im Verfahrensverzeichnis dokumentiert.
## 2. Frist-Übersicht
Fristbeginn, wo nicht anders genannt: Ende des Kalenderjahres, in dem das Ereignis eintrat (⚖ je Rechtsnorm bestätigen). Steuerliche Fristen laut AO (§ 147: Buchungsbelege und Handels-/Geschäftsbriefe mit unterschiedlicher Dauer; Änderungen durch das Bürokratieentlastungsgesetz IV ⚖ aktuell prüfen).
| Datenkategorie | Tabelle/Ort | Typ | Vorschlag Frist | Mechanismus Ist | Mechanismus Soll | Status |
|---|---|---|---|---|---|---|
| Unverbindliche Anfrage ohne Folgebuchung | `guests`, `bookings` (Status `reserved`) | operativ | z. B. 3–6 Monate nach Ablauf/Ablehnung ⚖ (Zweck: Rückfragen, Abwehr Ansprüche) | Keine; erst 10-Jahre-Anonymisierung | Job `inquiries:purge` löscht Anfrage + ggf. verwaisten Gast | ❌ Lücke |
| Abgelaufene/abgelehnte Vorreservierung | `bookings` (`expired`/`declined`) | operativ | wie oben ⚖ | Statusjob (`bookings:expire-holds`), keine Löschung | wie oben | ❌ Lücke |
| Verbindliche Buchung – Stammdaten Gast | `guests`, `bookings` | operativ + Nachweis | Gastdaten operativ bis Ende der Gewährleistungs-/Verjährungsfrist (3 Jahre, ⚖ BGB § 195); danach Anonymisierung des Gastes, Buchung bleibt als Beleg | Anonymisierung nach `guest_retention_years` = 10 J. (im Code belegt, ✅ `AnonymizeGuests`) | Zweistufig: Gast nach 3 J. anonymisieren, Beleg bis Steuerfrist | ⚠ zu lang/gebündelt |
| Vertrags-/Rechnungsdokumente | `storage/app/private/contracts` | Nachweis | Steuerliche Aufbewahrung (Prüfannahme 6–10 Jahre, ⚖) | Nicht gelöscht, **nicht** anonymisiert | `documents.retain_until`, Job löscht Datei nach Fristende; Zugriff auf Rolle begrenzen | ❌ Lücke |
| Zahlungen und Belege | `payments` | Nachweis | steuerliche Frist ⚖ | Bleiben (keine Löschung) ✅ gewollt | `retain_until`; `note`/`recorded_by` minimieren | ⚠ |
| Portalnachrichten (E-Mail-Auszug) | `portal_emails.excerpt` | operativ | kurz, z. B. 30–90 Tage nach Verarbeitung ⚖; Referenz/Zeitraum bleiben | Keine | Job leert `excerpt`; Mail im IMAP-Postfach löschen | ❌ Lücke |
| Portal-E-Mails im Postfach | IMAP bei STRATO | operativ/Beleg | Mails mit Buchungsbeleg-Charakter ggf. Geschäftsbrief-Frist ⚖ | Mails werden nur gelesen (`leaveUnread`) | Ablage-/Löschregel im Postfach | ❓ |
| Iterative iCal-Sperren | `blocked_periods.reason` | operativ | Sperren bis Zeitraumende + Frist; `reason` ohne Personenbezug | Behalten | `reason` nicht speichern, wenn Namen enthalten (D5) | ❓ |
| Bewertungen | `reviews` | operativ/Veröffentlichung | Veröffentlichte Bewertung bis Widerruf der Einwilligung; privates Feedback kurz (z. B. 12 Monate) ⚖ | Nicht von `anonymize` erfasst | Bei Gast-Anonymisierung `display_name` neutralisieren, `private_feedback` löschen | ❌ Lücke |
| Marketing-Einwilligungen | `guests.marketing_consent_at` | Nachweis Einwilligung | Bis Widerruf, **Nachweis** der Einwilligung ggf. 3 J. über Widerruf hinaus ⚖ | Widerruf per Link setzt `NULL` (✅); Nachweis geht verloren | Nachweis-Log (Zeitpunkt, DOI-Bestätigung, ohne IP) separat | ⚠ |
| Gästekartei (Notizen, Tags) | `guests.notes/tags` | operativ | mit Gast-Anonymisierung | ✅ bei `anonymize()` | – | ✅ |
| `bookings.message` (Gastnachricht) | `bookings` | operativ | mit Gast-Anonymisierung | ✅ | früher möglich | ✅ |
| `bookings.internal_notes` | `bookings` | operativ | mit Gast-Anonymisierung | ❌ nicht erfasst | in `anonymize()` aufnehmen | ❌ Lücke |
| Herkunft/UTM | `bookings.utm_*`, `referral_source` | operativ (Statistik) | kurz (z. B. 12–24 Monate) oder aggregieren ⚖ | Behalten | Job nullt UTM nach Frist | ❌ Lücke |
| Kurabgabe-/Meldedaten | s. BUCHUNGSPROZESS.md §Kühlungsborn | gesetzlich | Meldeschein: kurz (⚖ BMG § 30: ca. 1 Jahr, danach Vernichtung); Kurabgabe-Nachweise nach Satzung/Steuerrecht ⚖ | nicht implementiert | getrennte Tabelle mit eigener Frist | 🗓 |
| Admin-Konten | `users` | operativ | bis Ausscheiden | manuell | Offboarding-Prozess | ⚠ |
| Sessions | `sessions` (IP, UA) | technisch | Lifetime 120 Min.; Tabellenbereinigung | Laravel-Lotterie-GC (✅ Standard) | täglicher Job + nur bei Bedarf Session starten | ⚠ |
| Rate-Limit-Schlüssel | `cache` (IP-Hash im Key) | technisch | 1 Stunde (✅ im Code `RateLimiter::hit(…, 3600)`) | Laufzeit | – | ✅ |
| Anwendungs-Logs | `storage/logs` | technisch | z. B. 14 Tage (`LOG_DAILY_DAYS` Default) | Default `single` ohne Rotation ❌ | `LOG_CHANNEL=daily` | ❌ Lücke |
| Webserver-Logs STRATO | Hosting | technisch | Anbieterabhängig | ❓ | Strato-Info/AVV | ❓ |
| Audit-Log (neu) | `audit_events` | Nachweis Sicherheit | z. B. 12 Monate ⚖ | existiert nicht | einführen | 🗓 |
| Fehlgeschlagene Jobs | `failed_jobs` | technisch | 30 Tage | Standard behalten | Job `queue:prune-failed` | ⚠ |
| Datenbank-Backups | Strato/eigen | technisch | z. B. 30 Tage rollierend ⚖ | ❓ nicht belegt | dokumentieren; Restore-Test; Löschung aus Backups via Frist | ❓ |
## 3. Löschmechanik (Soll)
- **Zeitgesteuerte Jobs** (Laravel-Scheduler, bereits genutzt: `guests:anonymize` monatlich) je Kategorie, mit Zähler-Log (ohne personenbezogene Inhalte).
- **Zwei Stufen** für Gäste: (1) operative Daten entfernen, (2) Beleg-Datensatz anonymisieren; Buchungsnummer, Beträge, Zeitraum, Steuerdaten bleiben.
- **Dokumente:** Datei und Datensatz am `retain_until` löschen; vorher Dokumentenhash prüfen/protokollieren.
- **Betroffenenrechte:** manuelle Aktion „Gast löschen/anonymisieren“ prüft steuerliche Sperre (offene Fristen) und führt Teil-Löschung durch; Rückmeldung innerhalb eines Monats (⚖ Art. 12).
- **Backups:** Löschung wirkt über Rotation; keine Wiederherstellung gelöschter Daten ohne erneute Löschung (Verfahrensvorgabe).
## 4. Informationspflichten bei Datenherkunft (Art. 13/14)
| Fall | Pflicht | Umsetzungsvorschlag | Status |
|---|---|---|---|
| Direkt erhoben (Formular) | Art. 13: Identität, Zwecke, Rechtsgrundlage, Empfänger, Dauer, Rechte, Beschwerde | Datenschutzerklärung verlinkt am Formular; Kurzinfo in Bestätigungsmail | ❌ DSE leer |
| Aus Portal übernommen (E-Mail/API) | Art. 14: Herkunft, Kategorien; Information binnen 1 Monat, spätestens beim ersten Kontakt | Hinweis in erster Gästemail + DSE-Abschnitt „Portalbuchungen“; ⚖ Ausnahme Art. 14 (5) a (Gast ist bereits durch Portal informiert) prüfen | ❌ offen |
| iCal ohne Gästedaten | keine Gästedaten → keine Pflicht | – | ✅ |
| Marketing (DOI) | Art. 13 + § 7 UWG | Hinweis im Opt-in; Widerruf in jeder Mail | ✅ teilweise |
## 5. Offene Rechtsfragen (Löschkonzept)
1. Konkrete steuerliche Fristen je Dokumentart und Fristbeginn (Steuerberatung).
2. Zulässige Dauer der Speicherung von Anfragen ohne Vertragsschluss.
3. Verjährungs-/Beweiszweck als Grundlage für 3-Jahres-Speicherung von Gästedaten.
4. Nachweis der Einwilligung nach Widerruf (Dauer).
5. Meldeschein-/Kurabgabe-Fristen (Satzung Ostseebad Kühlungsborn; BMG).
6. Ob Portal-E-Mails im Postfach als Handelsbriefe aufbewahrungspflichtig sind.
7. Backup-Retention-Dauer als zulässiges Maß.