From 0bba50bd7bb28969b4eafeb1e594c11a083bf8fc Mon Sep 17 00:00:00 2001 From: Lars Date: Thu, 29 Oct 2026 14:57:38 +0100 Subject: [PATCH] Fachliche Architektur und Vermietungskonzept versionieren [skip ci] --- docs/architecture/README.md | 45 +++++++ docs/architecture/betreiberfunktionen.md | 62 +++++++++ docs/architecture/fachmodell-und-rollen.md | 63 +++++++++ docs/architecture/gaeste-und-kommunikation.md | 74 +++++++++++ .../konzept-vermietung/Konzept_README.md | 100 ++++++++++++++ .../Konzept_automatisierung.md | 87 +++++++++++++ .../Konzept_entscheidungen-und-arbeitsplan.md | 85 ++++++++++++ .../Konzept_kunden-und-kommunikation.md | 83 ++++++++++++ .../Konzept_loyalty-programm.md | 101 +++++++++++++++ .../konzept-vermietung/Konzept_marketing.md | 86 ++++++++++++ .../Konzept_portale-und-vertrieb.md | 95 ++++++++++++++ .../konzept-vermietung/Konzept_quellen.md | 56 ++++++++ .../konzept-vermietung/Konzept_szenarien.md | 74 +++++++++++ .../konzept-vermietung/Konzept_vorpruefung.md | 71 ++++++++++ .../konzept-vermietung/Konzept_workflows.md | 122 ++++++++++++++++++ .../architecture/planung-und-offene-punkte.md | 93 +++++++++++++ docs/architecture/portale-und-belegung.md | 77 +++++++++++ docs/architecture/preise-und-angebote.md | 81 ++++++++++++ docs/architecture/system-und-datenschutz.md | 94 ++++++++++++++ docs/architecture/vermieter-verwaltung.md | 70 ++++++++++ docs/architecture/vermietung.md | 91 +++++++++++++ docs/architecture/webseite.md | 85 ++++++++++++ 22 files changed, 1795 insertions(+) create mode 100644 docs/architecture/README.md create mode 100644 docs/architecture/betreiberfunktionen.md create mode 100644 docs/architecture/fachmodell-und-rollen.md create mode 100644 docs/architecture/gaeste-und-kommunikation.md create mode 100644 docs/architecture/konzept-vermietung/Konzept_README.md create mode 100644 docs/architecture/konzept-vermietung/Konzept_automatisierung.md create mode 100644 docs/architecture/konzept-vermietung/Konzept_entscheidungen-und-arbeitsplan.md create mode 100644 docs/architecture/konzept-vermietung/Konzept_kunden-und-kommunikation.md create mode 100644 docs/architecture/konzept-vermietung/Konzept_loyalty-programm.md create mode 100644 docs/architecture/konzept-vermietung/Konzept_marketing.md create mode 100644 docs/architecture/konzept-vermietung/Konzept_portale-und-vertrieb.md create mode 100644 docs/architecture/konzept-vermietung/Konzept_quellen.md create mode 100644 docs/architecture/konzept-vermietung/Konzept_szenarien.md create mode 100644 docs/architecture/konzept-vermietung/Konzept_vorpruefung.md create mode 100644 docs/architecture/konzept-vermietung/Konzept_workflows.md create mode 100644 docs/architecture/planung-und-offene-punkte.md create mode 100644 docs/architecture/portale-und-belegung.md create mode 100644 docs/architecture/preise-und-angebote.md create mode 100644 docs/architecture/system-und-datenschutz.md create mode 100644 docs/architecture/vermieter-verwaltung.md create mode 100644 docs/architecture/vermietung.md create mode 100644 docs/architecture/webseite.md diff --git a/docs/architecture/README.md b/docs/architecture/README.md new file mode 100644 index 0000000..1701aef --- /dev/null +++ b/docs/architecture/README.md @@ -0,0 +1,45 @@ +# Fachliche Architektur und Funktionsumfang + +Fachlicher Ausgangsstand: 26.10.2026 · Einordnung fortgeschrieben am 29.10.2026 + +Diese Dokumentation beschreibt, was fewo-stommer.de für Gäste, Vermieter und den Systembetreiber leistet und welche Erweiterungen vorgesehen sind. Im Mittelpunkt stehen Aufgaben, Abläufe und fachliche Regeln. Technische Umsetzung, Serverzugänge und Installationsanleitungen stehen in den bestehenden Projektdokumenten. + +**Fortschreibung:** Die Bereichsdateien dokumentieren den jeweils angegebenen Ausgangsstand. Seit dem 27.10. sind zusätzlich der zentrale Belegungsplan, die gemeinsame Buchungsübersicht, die manuelle Gastzuordnung bei Portalbelegungen sowie Zweck und Privat-Kennzeichnung von Sperrzeiten bereitgestellt. Der automatische Kalenderabruf ist inzwischen eingerichtet. Diese Ergänzungen stehen unter [zentrale Belegungsverwaltung](ical-kanalkonfiguration.md#zentrale-belegungsverwaltung); der aktuelle Betriebsstand steht in [STATUS.md](../STATUS.md). Die Konzeptphase bleibt ein Arbeitsentwurf und keine Freigabe sämtlicher vorgeschlagener Funktionen. + +**Weiterführende Konzeptphase:** [Konzept Vermietung](konzept-vermietung/Konzept_README.md) entwickelt darauf aufbauend Workflows, Portalvertrieb, Vorprüfung, individuelle Kommunikation, Loyalty und Marketing. Die dortigen neuen Vorschläge sind von den vorhandenen Funktionen und bereits beschlossenen Regeln getrennt. + +## Orientierung + +| Datei | Inhalt | +|---|---| +| [Fachmodell und Rollen](fachmodell-und-rollen.md) | Begriffe, Verantwortlichkeiten, Zusammenhang von Mandant, Website und Wohnung | +| [Betreiberfunktionen](betreiberfunktionen.md) | Mandanten betreuen, Domains zuordnen, Dienste freischalten, systemweite Vorgaben | +| [Vermieter-Verwaltung](vermieter-verwaltung.md) | Arbeitsoberfläche, Benutzer, Rollen, Wohnungspflege und Betriebsdaten | +| [Webseite](webseite.md) | Öffentlicher Auftritt, Inhalte, Gestaltung und Anfrageformular | +| [Vermietung](vermietung.md) | Anfrage, Vormerkung, Angebot, Annahme, Vertrag, Zahlung und Stornierung | +| [Preise und Angebote](preise-und-angebote.md) | Saisons, Preisbestandteile, Mindestaufenthalt, Sonderangebote und Bewerbung | +| [Gäste und Kommunikation](gaeste-und-kommunikation.md) | Gästekartei, E-Mails, Einwilligungen und Bewertungen | +| [Portale und Belegung](portale-und-belegung.md) | Verfügbarkeit, Kalendersynchronisation, Portal-Mails und Sperraufgaben | +| [Generische iCal-Kanalkonfiguration](ical-kanalkonfiguration.md) | Bereitgestellte Kalenderanbindung und Belegungsverwaltung: Betriebsmodi, Herkunft, Gastzuordnung, Sperrzweck und Betriebsnachweise | +| [System und Datenschutz](system-und-datenschutz.md) | Automatische Aufgaben, Schutz, Aufbewahrung, Sicherungen und Betriebsbereitschaft | +| [Planung und offene Punkte](planung-und-offene-punkte.md) | Bereichsübergreifender Überblick der noch fehlenden Funktionen und Entscheidungen | + +## Status der Funktionen + +- **Umgesetzt:** im Anwendungscode vorhanden; das bedeutet nicht automatisch, dass die Funktion auf dem Test- oder Produktivsystem eingerichtet und aktiv ist. +- **Teilweise umgesetzt:** ein nutzbarer Teil ist vorhanden; die fehlenden Teile sind ausdrücklich benannt. +- **Geplant:** als Erweiterung vorgesehen, aber noch nicht gebaut. +- **Option:** diskutierte spätere Möglichkeit ohne beschlossenen Umsetzungsumfang. +- **Offen:** Entscheidung, Inhalt, Freigabe oder Einrichtung fehlt; dafür muss nicht zwingend neue Software entstehen. + +Die Bereichsdateien trennen vorhandene Funktionen von Erweiterungen und offenen Punkten. Eine vorhandene Datengrundlage oder eine Anzeige „Noch nicht gebaut“ gilt nicht als fertige Funktion. + +## Grundlage und Gültigkeit + +Grundlage sind der lokale Anwendungsstand sowie [Projektstand](../STATUS.md), [Konzept](../KONZEPT.md), [Mandantenplan](../MANDANTEN-PLAN.md), [Mandantenanforderungen](../MANDANTEN-ANFORDERUNGEN.md), [Theme-Beschreibung](../THEMES.md), [Designkonzept](../DESIGN-KONZEPT.md) und [Portal-Analyse](../PORTALE.md). Quellen zur Vertiefung stehen zusätzlich in den Bereichsdateien. + +Ältere Dokumente beschreiben teilweise überholte Zwischenstände. Insbesondere Angebot und Annahme durch den Gast, mandantenbezogene Hintergrundabläufe sowie Export und Löschung eines Mandanten sind inzwischen umgesetzt. Die Dokumente [Buchungsprozess](../BUCHUNGSPROZESS.md), [Datenmodell-Konzept](../DATENMODELL-KONZEPT.md) und [Gap-Analyse](../GAP-DELTA.md) enthalten ausdrücklich gekennzeichnete Analysevorschläge; diese werden hier nicht als beschlossene Anforderungen behandelt. + +Beim ersten Erstellen lagen noch nicht eingecheckte Änderungen zur Marke je Website, zu E-Mail-Vorlagen und zum Mandantenexport vor. Laut inzwischen fortgeschriebenem [Projektstand](../STATUS.md) ist dieser Mandantenabschluss am 26.10.2026 mit Commit `06df80e` auf das Testsystem ausgeliefert. Die Dokumentationsarbeit selbst hat keine Anwendung geändert oder ausgeliefert. + +Die Anwendung läuft auf dem Testsystem. Der zunächst noch offene Hintergrundbetrieb wurde am 27.10. über n8n eingerichtet; ein erneuter erfolgreicher automatischer Kalenderimport ist am 28.10. dokumentiert. Tatsächlicher E-Mail-Versand und Produktionsstart bleiben gesondert zu prüfen. Der jeweils aktuelle Betriebsstand wird weiterhin in [STATUS.md](../STATUS.md) gepflegt. diff --git a/docs/architecture/betreiberfunktionen.md b/docs/architecture/betreiberfunktionen.md new file mode 100644 index 0000000..5f3d906 --- /dev/null +++ b/docs/architecture/betreiberfunktionen.md @@ -0,0 +1,62 @@ +# Betreiberfunktionen + +Stand: 26.10.2026 · [Übersicht](README.md) + +Der Betreiber verwaltet die gemeinsame Anwendung für eigenständige Vermieter. Seine Aufgaben sind von der täglichen Vermietung und Inhaltspflege eines einzelnen Mandanten getrennt. + +## Umgesetzte Funktionen + +### Mandanten einrichten und betreuen + +- Mandanten mit Name und Kurzname anlegen und bearbeiten. +- Websites eines Mandanten mit den zugehörigen Adressen einrichten. Beim Anlegen wird eine leere Startseite vorbereitet; Inhalte und Wohnung müssen anschließend gepflegt werden. +- Den Zugang eines Mandanten freischalten oder vorübergehend sperren. Bei Sperre sehen Besucher eine Hinweisseite mit einem anpassbaren Text. Der Betreiber behält seinen Zugang. +- Einen Mandanten zur Unterstützung in seiner Verwaltung öffnen. Dieser Supporteinstieg wird mit Benutzer und Zeitpunkt protokolliert. +- Den ersten Administrator und weitere Konten administrativ einrichten. Die Ersteinrichtung eines Kontos erfolgt derzeit über ein Betriebswerkzeug; der Mandant verwaltet seine Benutzer anschließend selbst. + +### Adressen zuordnen + +Jede Website erhält eine Hauptadresse und gegebenenfalls weitere Schreibweisen oder Nebenadressen. Links an Gäste verwenden die Hauptadresse. Eine Adresse darf nicht gleichzeitig verschiedenen Websites gehören. Die Einrichtung der Domain und ihrer sicheren Erreichbarkeit beim Hostinganbieter bleibt eine zusätzliche Betriebsaufgabe. + +Die Zuordnung der Adressen liegt beim Betreiber; im Mandantenbereich sind sie zur Information sichtbar. Sobald mehrere Mandanten vorhanden sind, müssen die verwendeten Adressen vollständig zugeordnet sein, damit Besucher beim richtigen Vermieter landen. + +### Dienste freischalten + +| Dienst | Stand | Wirkung | +|---|---|---| +| Portal-Abgleich | Umgesetzt | Belegungen importieren und einen eigenen Kalender zum Abruf bereitstellen | +| Portal-Postfach | Umgesetzt | Portal-Buchungsmails auswerten und erkannte Aufenthalte frühzeitig sperren | +| KI-Angebotsentwürfe | Geplant | Angebote vorbereiten, anschließend menschlich prüfen und freigeben | +| KI-Vermarktungsassistent | Geplant | Vermarktungsinhalte und saisonale Anpassungen unterstützen | +| KI-Gästekommunikation | Geplant | Kommunikation mit Gästen, perspektivisch mehrsprachig, unterstützen | + +Nur die beiden vorhandenen Portaldienste sind tatsächlich schaltbar. Ein gesperrter Dienst wird auch durch eine weitreichende Benutzerrolle nicht nutzbar. Die drei KI-Dienste sind bisher als Vorhaben kenntlich gemacht. + +### Systemweite Vorgaben verwalten + +Der Betreiber pflegt gemeinsame Einstellungen für Aufbewahrung, Schutz der Anfrageformulare, übergreifende Anfragegrenzen, Sicherungen, Portalüberwachung und den E-Mail-Versand. Dazu gehören auch Versandzugänge, eine systemweite Mail-Umleitung und die Zugänge für externe Automatisierungen. + +Mandanten können bestimmte Regeln innerhalb dieser Vorgaben anpassen. Beispielsweise dürfen sie Daten kürzer aufbewahren und den Bot-Schutz verschärfen. Die gemeinsamen Schutzgrenzen können sie nicht eigenständig lockern. + +Die Systemübersicht zeigt die Mandanten, Dienstfreigaben, geltenden Vorgaben und jüngsten Supportzugriffe. Eine vollständige laufende Überwachung aller Betriebszustände ist damit noch nicht abgedeckt; insbesondere wird ein externer unabhängiger Wächter bisher nur als Option beschrieben. + +### Daten bei Beendigung bereitstellen und entfernen + +Für einen Mandanten lassen sich Daten und zugehörige Dateien gemeinsam exportieren. Dabei werden Benutzerzugehörigkeiten berücksichtigt, ohne Passwörter oder Geheimnisse der Zwei-Faktor-Anmeldung herauszugeben. + +Auch die vollständige Löschung eines Mandanten ist als Betriebsfunktion vorhanden. Standardmäßig wird zuvor exportiert. Benutzer, die noch anderen Mandanten angehören, und der Betreiber bleiben erhalten. Export und Löschung sind derzeit administrative Betriebswerkzeuge; es gibt dafür keine Löschschaltfläche im Betreiberbereich. + +## Geplant, optional oder noch offen + +| Vorhaben | Stand | Noch fehlend | +|---|---|---| +| Dienstverbrauch messen | Teilweise umgesetzt | Datengrundlage vorhanden, aber keine aktive Verbrauchszählung und keine Auswertung | +| Eigene Schlüssel für KI-Dienste | Teilweise umgesetzt | Grundlage vorgesehen; keine fertige Einrichtung und Nutzung durch den Mandanten | +| Tarife und Abonnements | Option | Leistungsbuchung, Vertragsverwaltung und Tarifwechsel sind nicht vorhanden | +| Abrechnung mit Mandanten | Option | Rechnungen, Verbrauchsabrechnung und Zahlungseinzug sind nicht vorhanden | +| Weitere Vermieter produktiv aufnehmen | Offen | Vertragsunterlagen, Auftragsverarbeitung, Domain- und Zertifikatsfragen sowie betriebliche Erprobung | +| Umzug bei größerem Betrieb | Option | Wechsel der Hostingumgebung bei Wachstum; kein eigener Server pro Mandant vorgesehen | + +Die Dienstfreigabe ist somit bereits vorhanden, eine kommerzielle Abonnementverwaltung bisher nicht. + +Quellen: [Mandantenplan](../MANDANTEN-PLAN.md), [Mandantenanforderungen](../MANDANTEN-ANFORDERUNGEN.md), [Projektstand](../STATUS.md). Funktionsabgleich: Betreiberbereich, Dienstkatalog sowie Mandantenexport und -löschung der Anwendung. diff --git a/docs/architecture/fachmodell-und-rollen.md b/docs/architecture/fachmodell-und-rollen.md new file mode 100644 index 0000000..847a1be --- /dev/null +++ b/docs/architecture/fachmodell-und-rollen.md @@ -0,0 +1,63 @@ +# Fachmodell und Rollen + +Stand: 26.10.2026 · [Übersicht](README.md) + +## Zweck des Systems + +fewo-stommer.de verbindet den individuellen Internetauftritt einer Ferienwohnung mit der Verwaltung ihrer Vermietung. Gäste informieren sich, lassen einen Aufenthalt berechnen und fragen ihn an. Die Vermieterin bearbeitet die Anfrage bis zum Vertrag und begleitet Zahlung, Aufenthalt und Bewertung. Der Betreiber stellt diese Funktionen auch für weitere eigenständige Vermieter bereit. + +## Fachliche Ebenen + +| Ebene | Aufgabe | Abgrenzung | +|---|---|---| +| System | Gemeinsamer Betrieb, Schutz, Sicherungen und übergreifende Vorgaben | Wird vom Betreiber verantwortet | +| Mandant | Eigenständiger Vermieter mit eigenen Gästen, Buchungen, Benutzern und Einstellungen | Daten und Zuständigkeiten bleiben von anderen Vermietern getrennt | +| Website | Öffentlicher Auftritt eines Mandanten mit eigenen Adressen, Seiten und Gestaltung | Gehört genau einem Mandanten; ein Mandant kann mehrere Websites haben | +| Wohnung | Vermietbare Einheit mit Kapazität, Preisen, Belegung und Angeboten | Gehört genau einem Mandanten und derzeit genau einer seiner Websites | +| Aufenthalt | Konkreter Zeitraum mit Personen, Leistungen und Preis | Wird als Anfrage, Angebot und später gegebenenfalls Buchung bearbeitet | + +Mehrere Wohnungen auf einer Website sind grundsätzlich unterstützt. Seitenbausteine können jeweils eine aktive Wohnung dieser Website darstellen. Ohne ausdrückliche Auswahl gilt die Hauptwohnung. Eine gemeinsame Wohnungssuche und ein eigener Übersichtsbaustein sind noch geplant. + +## Zentrale Begriffe + +| Begriff | Fachliche Bedeutung | +|---|---| +| Anfrage | Unverbindlicher Wunsch eines Gastes für einen Aufenthalt; löst derzeit zugleich eine befristete Vormerkung aus | +| Vormerkung | Vorübergehende Freihaltung eines Zeitraums bis zu einer angegebenen Frist | +| Angebot | Von der Vermieterin versendete, befristete Fassung von Termin, Leistungen, Preis und Bedingungen | +| Buchung | Verbindlich gewordener Aufenthalt durch Gastannahme oder Erfassung einer anderweitig getroffenen Vereinbarung | +| Sperrzeit | Nicht buchbarer Zeitraum, beispielsweise Eigennutzung, Renovierung oder bekannte Portalbelegung | +| Kanal/Portal | Externer Vertriebsweg mit eigener Kalenderanbindung und gegebenenfalls zusätzlichen Sperraufgaben | +| Gast | Kontakt in der Kartei eines Mandanten; kann mehrere Anfragen und Aufenthalte haben | +| Saison | Datumsbereich mit Übernachtungspreis und Mindestaufenthalt | +| Sonderangebot | Preisvorteil mit Gültigkeit und Bedingungen; zu unterscheiden vom individuellen Angebot an einen Gast | +| Erscheinungsbild | Zeitlich oder saisonal gewählte Variante von Bildern, Texten und Farben einer Website | +| Theme | Grundgestaltung und Darstellung der Webseitenbausteine | +| Bildwelt | Zur Umgebung passende Dekoration, etwa Ostsee-Motive; unabhängig von der Grundgestaltung | +| Dienst | Zusatzfunktion, die der Betreiber für einen Mandanten freischaltet | + +## Akteure und Verantwortung + +- **Gast:** übermittelt die Anfrage, entscheidet über das Angebot, bezahlt und kann nach dem Aufenthalt eine Bewertung abgeben. Für diese Abläufe ist kein Gästekonto erforderlich. +- **Vermietung:** bearbeitet Anfragen und Buchungen, Preise, Gäste, Zahlungen, Belegung und Portalaufgaben. +- **Inhaltsredaktion:** pflegt Bilder, Texte, Ausstattungsangaben, Fragen und Antworten, Hinweise und Bewertungen. +- **Mandanten-Administrator:** verantwortet die gesamte Verwaltung seines Mandanten einschließlich Benutzer und Betriebseinstellungen. +- **Betreiber:** verwaltet Mandanten, Adressen, Dienstfreigaben und die gemeinsame Systemumgebung. Supportzugriffe werden protokolliert. +- **Externer Ferienservice:** übernimmt vereinbarte Aufgaben vor Ort. Für Stommer ist die Kurabgabe dem Ferienservice Balu zugeordnet; die Übernahme des Meldescheins ist noch zu klären. + +## Übergreifende Regeln + +1. Belegung wird in Nächten gerechnet. Anreise gehört zum Aufenthalt, die Nacht des Abreisetags nicht. Abreise und neue Anreise am selben Tag sind möglich. +2. Eine abgelaufene Vormerkung blockiert keine Nächte mehr, auch wenn ihr angezeigter Status noch nicht automatisch aktualisiert wurde. +3. Gesamtpreise enthalten Pflichtkosten; freiwillige Extras werden nach Auswahl ergänzt. Kurabgabe wird derzeit als gesonderter Hinweis behandelt. +4. Ein Mandant sieht und bearbeitet seine eigenen Daten. Derselbe Gast kann bei zwei Vermietern getrennte Karteieinträge haben. +5. Rollenrechte und freigeschaltete Dienste bestimmen die Nutzung. Die einfache Ansicht verändert nur den Umfang des Menüs. +6. Das System führt derzeit die zentrale Belegung. Vollständige Gäste- und Finanzverwaltung für Portalbuchungen ist eine spätere Erweiterung. + +## Geplante Erweiterungen und Grenzen + +Geplant sind weitere Unterstützungsdienste, insbesondere KI-Entwürfe, sowie zusätzliche Darstellungen für mehrere Wohnungen. Weitere Rollen, beispielsweise für Reinigung oder Steuerberatung, sind als Option vorgesehen. Sie sind bisher nicht als fertige Benutzerrollen verfügbar. + +Ein gemeinsamer Marktplatz über verschiedene Vermieter, ein Provisionsmodell und die Selbstregistrierung von Mandanten gehören nicht zum festgelegten Produktumfang. Ein Gästebereich ist eine spätere Option; die vorhandenen Abläufe arbeiten mit geschützten Links. + +Quellen: [Konzept](../KONZEPT.md), [Mandantenplan](../MANDANTEN-PLAN.md), [Mandantenanforderungen](../MANDANTEN-ANFORDERUNGEN.md). diff --git a/docs/architecture/gaeste-und-kommunikation.md b/docs/architecture/gaeste-und-kommunikation.md new file mode 100644 index 0000000..a5273a9 --- /dev/null +++ b/docs/architecture/gaeste-und-kommunikation.md @@ -0,0 +1,74 @@ +# Gäste und Kommunikation + +Stand: 26.10.2026 · [Übersicht](README.md) + +Die Gästekartei und die aufenthaltsbezogenen Nachrichten unterstützen den persönlichen Kontakt von der Anfrage bis zur Bewertung. Werbekontakt wird getrennt von der Abwicklung eines Aufenthalts behandelt. + +## Umgesetzte Funktionen + +### Gästekartei + +Je Mandant werden Name, E-Mail, Telefon, Anschrift, Notizen und Markierungen gepflegt. Zugehörige Buchungen sowie Aufenthalts- und Umsatzangaben sind einsehbar. Suche und Filter helfen beim Auffinden von Gästen, Stammgästen, Markierungen und Werbeeinwilligungen. + +Neue Anfragen werden anhand der E-Mail einem bestehenden Kontakt desselben Mandanten zugeordnet. Bereits gefüllte Stammdaten werden dabei nicht ungeprüft überschrieben. Fehlende Angaben können ergänzt werden; abweichende Angaben erscheinen als Hinweis bei der Anfrage. Die Vermieterin kann sie bei der Bearbeitung prüfen. + +Die Kartei lässt sich als für Tabellenprogramme geeignete CSV-Datei exportieren, wahlweise nur mit Gästen, die Angebote erhalten möchten. Anonymisierte Kontakte sind aus dem regulären Export ausgeschlossen. + +Die Kartei ist noch keine vollständige portalübergreifende Kundendatenbank: Portalbelegungen erzeugen bisher nicht automatisch vollständige Gast- und Buchungsakten. + +**Ergänzung seit 27.10.2026:** Importierte Portalreservierungen können persönlich einem bestehenden Gast zugeordnet werden. Ein neuer Gast lässt sich dabei mit Kontakt, vollständiger Adresse, Notizen und Markierungen im selben Dialog anlegen; die Aufenthaltshistorie umfasst anschließend eigene und zugeordnete Portalaufenthalte. Namensfragmente erzeugen weiterhin keine automatischen Gastakten. Die Preis- und Vertragsdaten eines vollständigen Buchungsvorgangs werden aus iCal nicht abgeleitet. [Bedienung und Grenzen](ical-kanalkonfiguration.md#zentrale-belegungsverwaltung). + +### Nachrichten zum Aufenthalt + +| Anlass | Empfänger und Zweck | +|---|---| +| Neue Anfrage | Gast erhält Eingangsbestätigung und berechnete Aufenthaltsdaten; Vermieterin erhält einen Hinweis | +| Angebot | Gast erhält Nachricht, Vertragsentwurf und Link zur Entscheidung | +| Annahme oder Ablehnung | Vermieterin wird über die Gastentscheidung informiert | +| Bestätigung | Gast erhält Buchungsbestätigung, Vertrag und Zahlungsinformationen | +| Ablehnung durch Vermieterin | Gast kann eine Absage erhalten | +| Ablauf einer Vormerkung | Vermieterin wird über die Freigabe informiert | +| Zahlung | Gast erhält je nach Zahlungsstand Aufforderung oder Erinnerung; interne Empfänger erhalten die vorgesehenen Informationen | +| Anreise | Gast erhält Hinweise für den bevorstehenden Aufenthalt | +| Bewertung | Gast erhält Einladung; eine neue Bewertung wird intern gemeldet | +| Portalbetrieb | Interne Hinweise zu Portal-Mails, Konflikten, Störungen und offenen Sperraufgaben | + +Wiederkehrende Texte und Inhalte für Website, Vertrag und Kommunikation werden über die vorgesehenen Textfelder gepflegt. Daraus entsteht derzeit keine frei gestaltbare Vorlagenverwaltung oder vollständige gemeinsame Ablage aller ein- und ausgehenden E-Mails. Antworten der Gäste gehen an die eingestellte Antwortadresse und werden nicht automatisch als vollständige Nachrichtenhistorie in der Buchung geführt. + +Absender, Antwortadresse und interne Empfänger gehören zum jeweiligen Mandanten. Nach einem Hintergrundlauf dürfen diese Angaben nicht für den nächsten Mandanten übernommen werden. Die Kommunikationsvorlagen nutzen die Marke der Website; laut [Projektstand](../STATUS.md) ist dieser Abschluss am 26.10.2026 auf das Testsystem ausgeliefert. + +### Werbeeinwilligung + +Für spätere Angebote kann eine gesonderte Einwilligung angefragt werden. Die Bestätigung erfolgt über einen E-Mail-Link im Double-Opt-in-Verfahren. Eine Abmeldung ist ebenfalls per Link möglich. Zeitpunkt und bestehende Einwilligung werden am Gast geführt. + +Diese Funktionen ermöglichen Einwilligungsverwaltung und gezielten Export. Ein vollständiger Newsletterversand mit Kampagnenplanung, Segmentierung und Erfolgsauswertung ist noch nicht vorhanden. + +### Bewertungen + +Nach einem tatsächlichen Aufenthalt kann einmalig eine Einladung verschickt werden; die bisherige Vorgabe liegt bei zwei Tagen nach Abreise. Es werden nur passende, noch nicht bewertete Aufenthalte berücksichtigt. Der Gast benötigt kein Konto. + +Die Bewertung umfasst eine Gesamtbewertung, optionale Einzelbewertungen für Sauberkeit, Ausstattung, Lage und Gastgeber, Überschrift, Text, Anzeigename und privates Feedback. Der Gast entscheidet über die Veröffentlichung. Privates Feedback wird nicht öffentlich angezeigt. + +Neue Websitebewertungen warten auf Freigabe in der Verwaltung. Dort können sie geprüft, freigegeben oder zurückgehalten und öffentlich beantwortet werden. Die Website veröffentlicht nur dafür geeignete Bewertungen und enthält einen Hinweis, wie deren Herkunft geprüft wird. Eine vollständige unabhängige Echtheitsprüfung fremder Portalbewertungen ist damit nicht verbunden. + +Bereits vorhandene Bewertungen können manuell mit ihrer Quelle übernommen werden. Eigene Websitebewertungen sind über den Bewertungslink einem konkreten Aufenthalt zugeordnet; übernommene Bewertungen haben eine gesonderte Quellenangabe. + +### Datenschutz im Gästekontakt + +Administratoren können Gäste manuell anonymisieren. Automatische Fristen unterscheiden länger aufzubewahrende Aufenthalte von Anfragen, die nie zu einer verbindlichen Buchung führten. Kontaktangaben, interne Notizen und persönliche Nachrichten werden dabei bereinigt; fachliche Buchungs- und Betragsdaten bleiben für die weitere Nachweisführung erhalten. + +Dies ist kein vollständiger Löschlauf über jedes möglicherweise personenbezogene Dokument. Insbesondere separate Vertragsdateien und bereits veröffentlichte Freitexte müssen im Löschkonzept gesondert betrachtet werden. Weitere Regeln stehen in [System und Datenschutz](system-und-datenschutz.md). + +## Geplant und optional + +| Erweiterung | Stand | +|---|---| +| Vollständige Gastakten aus Portalbuchungen | Teilweise umgesetzt: persönliche Zuordnung und manuelle vollständige Gastanlage vorhanden; automatische Übernahme zusätzlicher Portalstammdaten bleibt offen | +| Dublettenvorschläge und kontrollierte Zusammenführung | Option aus dem Datenmodell-Entwurf; noch nicht vorhanden | +| Zentrale Nachrichtenhistorie je Gast und Buchung | Option aus dem Datenmodell-Entwurf; die bisherige Kommunikation bildet das noch nicht vollständig ab | +| KI-Gästekommunikation | Geplant; kein aktiver KI-Dienst | +| KI-Marketing und Social Media | Geplant; kein fertiger Kampagnen- oder Veröffentlichungsablauf | +| Mehrsprachige Gästekommunikation | Offen/Option; zusammen mit Website, Angebot und Vertrag zu planen | +| Gästebereich ohne wiederholte Rückfragen | Spätere Option; derzeit geschützte Links für einzelne Vorgänge | + +Quellen: [Konzept](../KONZEPT.md), [Projektstand](../STATUS.md), [Datenmodell-Entwurf](../DATENMODELL-KONZEPT.md). Funktionsabgleich: Gästekartei, Einwilligungen, Bewertungsablauf und vorhandene Nachrichtentypen. diff --git a/docs/architecture/konzept-vermietung/Konzept_README.md b/docs/architecture/konzept-vermietung/Konzept_README.md new file mode 100644 index 0000000..0ce4e81 --- /dev/null +++ b/docs/architecture/konzept-vermietung/Konzept_README.md @@ -0,0 +1,100 @@ +# Konzeptphase Vermietung + +Stand: 26.10.2026 · Arbeitsentwurf 0.1 · [Fachliche Bestandsdokumentation](../README.md) + +**Bestandsfortschreibung vom 29.10.2026:** Seit dem Ausgangsentwurf wurden die zentrale Belegungsübersicht, persönliche Gastzuordnung bei Portalreservierungen und die Zweckangabe für Sperrzeiten bereitgestellt. Diese Funktionen sind als vorhandene Grundlage zu berücksichtigen; vollständige Preis-, Zahlungs- und Vertragsdaten entstehen weiterhin nicht allein aus iCal. [Aktueller Umfang](../ical-kanalkonfiguration.md#zentrale-belegungsverwaltung). Neue Loyalty-, Marketing- und Automatisierungsregeln in diesem Konzept bleiben Vorschläge. + +## Auftrag und Ziel + +Die Vermietung soll als zusammenhängender Betrieb konzipiert werden: unterschiedliche Buchungswege und Portale, Vorprüfung von Anfragen, persönliche Kommunikation mit neuen und wiederkehrenden Gästen, automatische Kundenbindung durch ein Loyalty-Programm sowie Marketing von der ersten Aufmerksamkeit bis zum nächsten Aufenthalt. + +Ziel ist eine verlässliche, persönlich wirkende Vermietung mit nachvollziehbaren Regeln und möglichst wenig wiederholter Handarbeit. Die Konzeptphase soll dafür konkrete Abläufe, Zuständigkeiten, Ausnahmen und Entscheidungskriterien liefern. Die technische Ausgestaltung folgt nach der fachlichen Entscheidung. + +## Gültigkeit dieses Entwurfs + +| Kennzeichnung | Bedeutung | +|---|---| +| Bestehend | In der verlinkten Bestandsdokumentation beschriebene Funktion | +| Gesetzter Rahmen | Bereits dokumentierte Projektentscheidung oder ausdrücklicher aktueller Auftrag | +| Vorschlag | Arbeitsgrundlage für die Konzeptphase, noch keine beschlossene Geschäftsregel | +| Offen | Mit Vermietung und Betreiber zu entscheidende Frage | +| Extern zu prüfen | Abhängig vom konkreten Portalvertrag, Dienst oder fachlicher Freigabe | + +**Alle hier neu beschriebenen Regeln sind Vorschläge, soweit sie nicht ausdrücklich als bestehend oder gesetzt bezeichnet werden.** Die Aufnahme ins Konzept bedeutet weder Umsetzung noch Freigabe eines Versands, einer Kundenentscheidung oder einer Portal-Anbindung. Beispielwerte werden nicht zu Voreinstellungen der Anwendung. + +„Vorprüfung“ wird zunächst als fachliche Prüfung eines Vorgangs verstanden: Sind Aufenthalt, Preis, Verfügbarkeit, Angaben und besondere Wünsche ausreichend geklärt? Eine Bonitätsprüfung oder Recherche über Personen ist damit nicht beauftragt. + +Die gewünschte Automatisierungstiefe und die tatsächlich genutzten Portale werden mit dem Nutzer konkretisiert. Bis dahin dient persönlich betreute Vermietung mit automatischer Vorbereitung und Nachbetreuung als Vorschlag. Ein stärker automatisierter Betrieb wird als alternative Ausbaustufe mitgedacht. + +## Konzeptbausteine + +| Dokument | Ergebnis für die Konzeptphase | +|---|---| +| [Workflows](Konzept_workflows.md) | Buchungswege, Kundenreise, Änderungen, Ausnahmen und Ende eines Aufenthalts | +| [Portale und Vertrieb](Konzept_portale-und-vertrieb.md) | Rollen der Kanäle, Fähigkeiten, Führung der Daten und Portalsteckbrief | +| [Vorprüfung](Konzept_vorpruefung.md) | Prüfkriterien, Rückfragen, Entscheidungen und erneute Prüfung bei Änderungen | +| [Kunden und Kommunikation](Konzept_kunden-und-kommunikation.md) | Kundenbild, persönliche Ansprache, Gesprächsführung und Kontaktregeln | +| [Loyalty-Programm](Konzept_loyalty-programm.md) | Wiederkehrer erkennen, Vorteile erwerben, anbieten, einlösen und berichtigen | +| [Marketing](Konzept_marketing.md) | Zielgruppen, Kampagnen, Anlässe, Kontaktbegrenzung und Erfolgsmessung | +| [Automatisierung](Konzept_automatisierung.md) | Was automatisch vorbereitet, entschieden oder versendet werden darf | +| [Entscheidungen und Arbeitsplan](Konzept_entscheidungen-und-arbeitsplan.md) | Offene Entscheidungen, Arbeitspakete und Übergang zur Umsetzung | +| [Szenarien](Konzept_szenarien.md) | Durchgängige Fälle für Diskussion und spätere fachliche Abnahme | +| [Quellen](Konzept_quellen.md) | Ausgangsdokumente und punktuell geprüfte externe Rahmenbedingungen | + +## Gesetzter Rahmen aus dem bisherigen Projekt + +- Vermieter bleiben eigenständige Mandanten mit getrennten Kundendaten, Regeln und Verantwortlichkeiten. Ein gemeinsamer Marktplatz ist nicht vorgesehen. +- Eigene Website, Telefon und Portale können unterschiedliche Buchungsabläufe haben. Eine Portalbestätigung ist nicht automatisch eine neue direkte Anfrage. +- Der derzeitige eigene Buchungsweg ist Anfrage → Vormerkung → Angebot → Gastannahme → Bestätigung. Verbindliche Website-Direktbuchung bleibt vom verlässlichen Belegungsabgleich abhängig. +- Das System führt bisher die Belegung. Für die vollständige Verwaltung von Portalbuchungen sind zusätzliche belegte Daten nötig. +- Belegung und Saisonpreise werden in Nächten betrachtet. Abreise und neue Anreise am selben Tag sind möglich. +- KI-Angebote sollen zunächst als Entwurf mit menschlicher Freigabe entstehen. +- Für Stommer wird die Kurabgabe vor Ort durch Balu erledigt. Die Meldeschein-Zuständigkeit ist offen. +- Die jetzige Anfrage-, Angebots-, Vertrags-, Zahlungs- und Bewertungsfunktion wird als Grundlage weiterverwendet. + +## Fachliches Zielbild + +```mermaid +flowchart LR + A[Website, Telefon, Portale] --> B[Eingang zuordnen] + B --> C[Vorprüfung und Rückfragen] + C --> D[Angebot oder Portalentscheidung] + D --> E[Verbindlicher Aufenthalt] + E --> F[Zahlung und Vorbereitung] + F --> G[Aufenthalt und Service] + G --> H[Abschluss und Nachbetreuung] + H --> I[Wiederkehrer und Gastvorteile] + I --> J[Passende Ansprache bei zulässigem Kontakt] + J --> B + B --> K[Persönliche Betreuung bei Ausnahmen] + C --> K + G --> K +``` + +Nicht jeder Eingang durchläuft alle Stationen: Eine bereits verbindliche Portalbuchung springt nach ihrer Zuordnung in die Vorbereitung. Ein reiner Kalenderblock benötigt keine erfundene Kundenakte. Ein Gast ohne Werbekontakt erhält weiterhin die erforderlichen Informationen zu seinem Aufenthalt. + +## Unabhängige fachliche Zustände + +| Gegenstand | Beispiele | Warum getrennt? | +|---|---|---| +| Anfrage und Angebot | offen, Rückfrage, angeboten, angenommen, abgelehnt | Noch kein Nachweis über Zahlung oder tatsächlichen Aufenthalt | +| Belegung | frei, befristet gehalten, verbindlich belegt, gesperrt | Eine Portalnachricht kann die Belegung betreffen, ohne vollständige Buchungsdaten zu liefern | +| Zahlung | offen, teilweise eingegangen, bezahlt, Erstattung offen | „Bezahlt“ bedeutet nicht „abgereist“ | +| Aufenthalt | bevorstehend, angereist, abgereist, nicht angetreten | Tatsächliche Leistung ist Grundlage der Nachbetreuung | +| Kommunikation | Antwort nötig, wartet auf Gast, erledigt, Versand unklar | Ein verschickter Text ist noch keine zugestellte Nachricht | +| Servicefall | offen, in Klärung, gelöst | Offene Probleme sollen passende persönliche Betreuung auslösen | +| Kundenbeziehung | Erstkontakt, Erstgast, Wiederkehrer, länger inaktiv | Beschreibt Beziehung, keine automatische Werbeerlaubnis | +| Loyalty | berechtigt, Vorteil vorgemerkt, verfügbar, eingelöst, berichtigt | Ein versprochener Vorteil darf nicht doppelt vergeben werden | +| Kontaktberechtigung | Zweck, Kanal, Umfang, Nachweis, Widerspruch | Darf weder aus Stammkundenstatus noch aus einer Portaladresse abgeleitet werden | + +Diese Trennung ist ein fachlicher Entwurf. Sie schreibt noch keine neuen Datenfelder, Oberflächen oder technischen Zustandsmodelle vor. + +## Leitlinien zur Beurteilung von Varianten + +1. Gäste verstehen jederzeit, ob sie anfragen, ein Angebot erhalten oder bereits gebucht haben. +2. Ein Aufenthalt wird kanalübergreifend nur einmal belegt, berechnet und für Vorteile gezählt. +3. Persönliche Zusagen beruhen auf bestätigten Informationen und verfügbaren Leistungen. +4. Automatisierung hat eine sichtbare Zuständigkeit, begrenzte Befugnis und einen Weg zur persönlichen Bearbeitung. +5. Kundenbindung ist wirtschaftlich tragbar und unabhängig von einer positiven Bewertung. +6. Kommunikation passt zu Anlass, Kanal, Portalregel und Kundenwunsch. +7. Erfolg bedeutet passende belegte Nächte, zufriedene Wiederkehrer und vertretbaren Aufwand; Auslastung und Rabatthöhe allein reichen nicht. diff --git a/docs/architecture/konzept-vermietung/Konzept_automatisierung.md b/docs/architecture/konzept-vermietung/Konzept_automatisierung.md new file mode 100644 index 0000000..465d77c --- /dev/null +++ b/docs/architecture/konzept-vermietung/Konzept_automatisierung.md @@ -0,0 +1,87 @@ +# Automatisierung und Zuständigkeiten + +Stand: 26.10.2026 · Vorschlag · [Konzeptübersicht](Konzept_README.md) + +## Betriebsmodelle + +| Modell | Fachliche Arbeitsweise | +|---|---| +| Persönlich betreut | System sammelt, prüft und entwirft; Vermietung entscheidet über individuelle Zusagen und Ausnahmen | +| Nach Regeln automatisiert | Freigegebene Standardfälle laufen innerhalb klarer Grenzen; Ausnahmen und Unsicherheit gehen an Menschen | +| Weitgehend automatisch | Mehr Standardentscheidungen und Kontakte werden ausgelöst; Voraussetzung sind stabile Daten, getestete Regeln und erreichbare Ausnahmebearbeitung | + +Das gewünschte Startmodell ist offen. Die bestehende Festlegung für KI-Angebote bleibt als Ausgangspunkt erhalten: zunächst Entwurf mit menschlicher Freigabe. Ein höheres Modell ist keine pauschale Erlaubnis für jede Entscheidung. + +## Befugnisse je Handlung + +Vier Stufen sollen unterscheidbar sein: anzeigen, vorbereiten, nach persönlicher Freigabe ausführen und innerhalb ausdrücklich freigegebener Regeln automatisch ausführen. Sie gelten je Mandant, Workflow, Kanal und Anlass. Die Freigabe eines Betreiberdienstes ersetzt diese fachlichen Befugnisse nicht. + +| Handlung | Vorgeschlagener Einstieg | Voraussetzung für weitergehende Automatik | +|---|---|---| +| Eingang zuordnen und harte Regeln prüfen | Automatisch, bei unklarer Zuordnung Aufgabe | Belegte Referenzen und sichere Datenherkunft | +| Bekannten Gast vorschlagen | Automatisch vorbereiten | Bestätigte Identität vor Offenlegung oder Vorteilseinlösung | +| Fachliche Vorprüfung zusammenfassen | Automatisch vorbereiten | Bestätigte Wohnungsinformationen und sichtbare offene Punkte | +| Rückfrage zu fehlender Angabe | Vorlage oder Entwurf, anfangs freigeben | Eindeutiger Anlass, freigegebener Kanal und keine überholte Frage | +| Individuelles Angebot | Berechnen und entwerfen, persönlich freigeben | Später klar begrenzte Standardfälle und aktuelle Verfügbarkeit | +| Bestehende Buchung ändern oder absagen | Persönliche Entscheidung | Je Kanal bestätigter Änderungs- oder Stornoweg | +| Freigegebene Transaktionsnachricht | Automatisch bei passendem Geschäftsvorfall | Richtiger Inhalt, Empfänger, Vertragsstand und Ereignis | +| Zahlungserinnerung | Automatisch nur bei belegtem offenen Anspruch | Zahlungszuständigkeit, aktueller Zahlungseingang und Behandlung strittiger Fälle | +| Loyalty-Qualifikation | Nach freigegebener Regel automatisch prüfen | Tatsächlicher Aufenthalt, eindeutige Zählung und geregelte Korrektur | +| Monetärer Vorteil | Nach freigegebener Programmregel berechnen | Kosten- und Kombinationsgrenzen, keine doppelte Einlösung | +| Marketingkampagne | Zielgruppe und Inhalt vorbereiten, persönlich freigeben | Später festgelegter Anlass, Kontaktgrenzen, Budget und laufende Stopprüfung | +| Öffentlicher Beitrag | Entwurf und Vorschau freigeben | Bestätigte Fakten und Nutzungsrechte | +| Reklamation, Konflikt und Sonderkulanz | Persönlich bearbeiten, automatisch priorisieren | Kein pauschaler Übergang in unbeaufsichtigte Entscheidung | +| Erstattung | Betrag und Begründung vorbereiten | Ausführung und Beleg des Geldflusses separat bestätigen | + +## Fachliche Regelbeschreibung + +Jede automatische Regel soll ohne technische Kenntnisse beantwortbar machen: + +- **Anlass:** Welches belegte Ereignis oder welcher Zeitpunkt löst sie aus? +- **Geltung:** Für welchen Mandanten, welche Wohnung, welchen Kanal und welchen Zweck gilt sie? +- **Voraussetzungen:** Welche Informationen und Freigaben müssen aktuell vorliegen? +- **Handlung:** Welche konkrete Entscheidung oder Nachricht darf entstehen? +- **Grenzen:** Welche Frist, Kosten, Menge, Preisabweichung und Kontaktbegrenzung gelten? +- **Stopp:** Welche Antwort, Änderung, Unsicherheit oder Störung verhindert die Ausführung? +- **Verantwortung:** Wer erhält den Fall, wenn die Regel nicht eindeutig greift? +- **Nachweis:** Welche Regel- und Inhaltsfassung wurde aus welchem Grund angewandt? + +Eine freigegebene Handlung wird vor Ausführung erneut geprüft, wenn sich Grundlage oder Kontext geändert haben. Beispiel: Eine Kampagne war gestern freigegeben, aber heute ist die beworbene Woche belegt. Ihr Versand darf nicht unverändert weiterlaufen. + +## Lauf eines automatischen Vorgangs + +Vorgeschlagene Bearbeitungsschritte sind „fällig“, „Voraussetzungen geprüft“, „Entwurf“, „freigegeben“, „ausgeführt“ oder „zur persönlichen Bearbeitung“. Für Nachrichten kommen bestätigter Versand, bekannte Zustellung oder unbekannter Ausgang hinzu. + +Eine unbekannte Zustellung ist kein sicherer Fehlschlag. Vor erneutem Versand ist zu prüfen, ob die erste Nachricht bereits übergeben wurde. Eine spätere identische Meldung darf nicht erneut einen Vertrag, einen Rabatt, eine Bewertungseinladung oder eine Loyalty-Gutschrift auslösen. + +Kommt eine Kundenantwort während der Vorbereitung, wird der geplante nächste Kontakt neu bewertet. Kommen Storno und Terminänderung zeitlich versetzt, entscheidet der belegte gültige Stand, nicht allein die zuletzt eingetroffene Nachricht. + +## Umgang mit Fehlern und Unterbrechungen + +| Situation | Vorgeschlagenes Verhalten | +|---|---| +| Portalstand veraltet | Betroffene automatische Zusagen stoppen und verantwortliche Person informieren | +| Kein passender Kontaktweg | Aufgabe erzeugen; keine ungeprüfte Nutzung einer anderen Adresse | +| E-Mail nicht zustellbar | Kontaktstatus beachten und sinnvollen zulässigen Ersatzweg persönlich klären | +| KI-Antwort unklar oder widersprüchlich | Entwurf zurückhalten, offene Tatsachen benennen | +| Preis oder Vorteil geändert | Bestehende Freigabe prüfen; gegebenenfalls neue Angebotsfassung | +| Dienst nicht verfügbar | Bestehende Vorgänge erhalten und zur manuellen Bearbeitung sichtbar machen | +| Bearbeiter abwesend | Vereinbarte Vertretung und echte Frist berücksichtigen | +| Mehrere Regeln passen | Festgelegte Vorrangregel anwenden oder Entscheidung vorlegen | +| Auftraggeber pausiert Automatik | Künftige Ausführung stoppen; bestehende Verpflichtungen und offene Aufgaben sichtbar lassen | + +Für den späteren Betrieb braucht es eine verständliche Pausenfunktion pro Bereich und eine Übersicht aller zurückgehaltenen oder fehlgeschlagenen Vorgänge. Die Anwendung darf nicht nur „grün“ aussehen, während niemand auf einen Gast wartet. + +## Rollen und Verantwortung + +Die Vermietung verantwortet Gastbeziehung, Angebote, Kulanz und Service. Der Mandanten-Administrator gibt die betrieblichen Regeln und Zuständigkeiten seines Vermieters frei. Der Betreiber stellt Dienste, gemeinsame Grenzen und Betriebsfähigkeit bereit. Inhaltsverantwortliche prüfen öffentliche Texte und Medien im erlaubten Umfang. + +Bei Portalbuchungen und externem Ferienservice muss zusätzlich klar sein, wer eine Leistung oder Änderung tatsächlich bestätigen kann. Das System kann den Ferienservice um Prüfung bitten, ohne dessen Zustimmung zu erfinden. + +## Erprobung vor echter Ausführung + +Vorgeschlagen ist zunächst eine Vorschau mit echten, angemessen aufbereiteten Beispielfällen: Das System zeigt, was es getan hätte und warum. Erst fachlich bewertete Fälle führen in einen begrenzten Pilotbetrieb. Aufzeichnungen sollen Gründe und Ergebnisse prüfbar machen, ohne unnötig komplette Kundengespräche in allgemeine Auswertungen zu kopieren. + +Das ist ein künftiger fachlicher Einführungsablauf. Der bestehende Testmail-Modus ist eine vorhandene Grundlage, aber noch keine vollständige Simulation sämtlicher neuer Regeln. + +Zugehörige Entscheidungen: D01, D02, D05, D11, D12 und D15 im [Arbeitsplan](Konzept_entscheidungen-und-arbeitsplan.md). diff --git a/docs/architecture/konzept-vermietung/Konzept_entscheidungen-und-arbeitsplan.md b/docs/architecture/konzept-vermietung/Konzept_entscheidungen-und-arbeitsplan.md new file mode 100644 index 0000000..d75b825 --- /dev/null +++ b/docs/architecture/konzept-vermietung/Konzept_entscheidungen-und-arbeitsplan.md @@ -0,0 +1,85 @@ +# Entscheidungen und Arbeitsplan der Konzeptphase + +Stand: 26.10.2026 · Arbeitsentwurf · [Konzeptübersicht](Konzept_README.md) + +## Entscheidungsliste + +Alle nachfolgenden Punkte sind offen. Empfehlungen sind Vorschläge dieses Entwurfs und werden erst durch ausdrückliche Entscheidung zu Geschäftsregeln. Antworten werden mit Datum, Geltungsbereich, Begründung und betroffenen Dokumenten festgehalten. + +| ID | Frage | Ausgangspunkt für die Diskussion | Ergebnis, das wir brauchen | +|---|---|---|---| +| D01 | Wie weit soll die Vermietung automatisch arbeiten? | Persönliche Betreuung mit automatischer Vorbereitung; stärkerer Modus als Ausbau | Befugnisse pro Handlung und Kanal | +| D02 | Welche Varianten des Buchungswegs werden benötigt? | Bestehender Angebotsweg bleibt; Direktbuchung unter Synchronisationsvorbehalt | Freigegebene Workflows, Verbindlichkeit und Halteregeln | +| D03 | Welche Portale sind aktiv, verbindlich nötig oder nur denkbar? | Arbeitsliste aus dem bisherigen Projekt, noch nicht bestätigt | Priorisierte Kanalliste mit tatsächlichen Konten und Inseraten | +| D04 | Was bedeutet Vorprüfung im konkreten Betrieb? | Fachliche Vollständigkeit, Eignung und Verfügbarkeit; keine Personenrecherche | Prüfkatalog und Ergebnisfolgen je Workflow | +| D05 | Welches System führt welche Daten und Entscheidungen? | Zentrale Belegung bisher bei uns, Portalverträge im jeweiligen Portal | Führung für Vertrag, Belegung, Preis, Geld und Nachrichten | +| D06 | Wie werden Gäste sicher wiedererkannt? | Bestätigte Kontakt- und Kanalzuordnung; keine automatische Haushaltsgleichsetzung | Identitäts-, Dubletten- und Zusammenführungsregeln | +| D07 | Welche Kontaktwege und Kontaktwünsche werden angeboten? | E-Mail, Telefon und vorhandene Portalwege | Zweck- und Kanalregeln, Präferenzen und Abmeldung | +| D08 | Welches Loyalty-Modell passt? | Wenige klare Gastvorteile als erste Variante, Punkte als Vergleich | Teilnahme, Anspruchsträger, Erwerb und Nutzen | +| D09 | Wie werden Portalgäste betreut und gebunden? | Keine pauschale Umleitung zum Direktvertrieb | Kanalbezogene Kommunikation, Bewertungen und zulässige Vorteile | +| D10 | Welche Aufenthalte zählen für das Programm? | Tatsächlich abgeschlossen, bezahlt, eindeutig zugeordnet | Regeln für Historie, Gruppen, Portal, Storno und Nichtanreise | +| D11 | Welche finanziellen und betrieblichen Grenzen gelten? | Kosten und Leistungskapazität begrenzen Rabatte und Extras | Vorteilshöhen, Kombination, Laufzeit, Budget und Kulanzbefugnis | +| D12 | Was darf KI vorbereiten oder ausführen? | Faktenbasierter Entwurf mit menschlicher Freigabe | Aufgaben, Datenumfang, Qualitätsmaßstab und Eskalation | +| D13 | Welche Kundenbindungs- und Marketinganlässe starten zuerst? | Wiederbuchung oder konkrete Nebensaisonlücke als begrenzter Einstieg | Zwei priorisierte Anwendungsfälle mit Kontaktgrenzen | +| D14 | Woran bewerten wir den Erfolg? | Belegte Nächte, Wiederkehrer, Aufwand und vergleichbare Kosten | Definitionen, Ausgangswert und angestrebte Verbesserung | +| D15 | Wer bearbeitet Ausnahmen und vertritt wen? | Keine Automatik ohne zuständigen Menschen | Betriebszeiten, Vertretung und Eskalationsfristen | +| D16 | Welche Texte und Bedingungen müssen freigegeben werden? | Vertrag, Annahme, Portal, Programm, Kontakt und Aufbewahrung gemeinsam betrachten | Freigegebener Umfang und konkrete noch offene Texte | +| D17 | Wie weit gilt eine Regel innerhalb eines Mandanten? | Gemeinsame Grundregeln mit begründeten Wohnungs- und Kanalabweichungen | Geltungsbereich je Website, Wohnung, Programm und Kanal | +| D18 | Was gehört zum ersten fachlichen Pilot? | Ein vollständiger Weg vom Eingang bis zur Nachbetreuung | Begrenzter Umfang mit Abnahmefällen und Rückfall auf persönliche Bearbeitung | + +## Arbeitsphase A – Ziele und echte Fälle + +**Ergebnis:** bestätigtes Zielbild und priorisierte Kanäle. Dazu gehören gewünschter Umfang, vorhandene Betreuungszeit und zwei oder drei konkrete Probleme der heutigen Vermietung. + +Als Material werden anonymisierte Beispiele benötigt: eine typische Direktanfrage, eine individuelle Rückfrage, eine Wiederkehrerbuchung sowie je aktivem Portal eine Buchung und eine Änderung oder Stornierung. Sie werden erst in geeigneter Form bereitgestellt; für diesen Entwurf wurden keine Kundennachrichten importiert. + +Schwerpunkte: D01 bis D04, D13 bis D15. Abschluss, wenn die wichtigsten Erfolgsziele und Fälle fachlich bestätigt sind. + +## Arbeitsphase B – Workflows und Portalsteckbriefe + +**Ergebnis:** jeder benötigte Workflow ist mit Vertragsschritt, Belegung, Verantwortung, Fristen und Gastkommunikation beschrieben. Für aktive Portale ist der [Steckbrief](Konzept_portale-und-vertrieb.md) ausgefüllt. + +Schwerpunkte: D02, D03, D05, D09 und D15. Mindestens Direktanfrage, Telefonvereinbarung, Portal-Anfrage und bestätigte Portalbuchung werden getrennt geprüft. Änderung, Storno und unklarer Datenstand gehören jeweils dazu. + +Abschluss, wenn eine zuständige Person anhand eines konkreten Falls sagen kann, was als Nächstes passiert und in welchem System die Entscheidung gilt. + +## Arbeitsphase C – Kundenbild und individuelle Betreuung + +**Ergebnis:** Identitätsregeln, Gesprächsführung, erlaubte Kontaktwege und Nutzen der gespeicherten Präferenzen stehen fest. Die Vermietung erkennt offene Antworten und bereits getroffene Zusagen. + +Schwerpunkte: D04, D06, D07, D12 und D17. Die Szenarien „bekannte E-Mail mit abweichenden Daten“, „Portalgast mit eigener Direktanfrage“ und „offene Reklamation plus geplante Kampagne“ müssen eindeutig gelöst sein. + +## Arbeitsphase D – Loyalty und Marketing + +**Ergebnis:** eine ausgewählte Programmvariante mit Erwerb, Einlösung, Rückabwicklung und wirtschaftlichen Grenzen sowie zwei vollständig beschriebene Marketinganlässe. + +Schwerpunkte: D08 bis D11, D13, D14 und D16. Schwellen und Werte werden gemeinsam festgelegt. Varianten werden anhand realer Aufenthalte und Kosten verglichen, nicht nur an der Attraktivität des Rabatts. + +Abschluss, wenn Erwerb und Einlösung eines Vorteils einschließlich Storno erklärt werden können und feststeht, wer zu welchem Anlass wie kontaktiert werden darf. + +## Arbeitsphase E – Automatisierung und fachliche Abnahme + +**Ergebnis:** Freigabematrix, konkrete Regeln, Ausnahmebehandlung, Pilotumfang und prüfbare Szenarien. + +Schwerpunkte: D01, D11, D12, D15 und D18. Für jede automatisierte Handlung werden Begründung, aktuelle Voraussetzungen, Stoppregel und verantwortliche Person festgelegt. Veränderte Termine, doppelte Portalereignisse und Kundenantworten während einer Versandplanung gehören zur Abnahme. + +## Arbeitsphase F – Umsetzungsaufträge ableiten + +Erst aus den entschiedenen Regeln werden fachliche Umsetzungspakete abgeleitet. Jedes Paket nennt Ziel, betroffene Workflows, vorhandene Grundlage, neue Funktion, Grenzen, benötigte Inhalte, Prüfszenarien und Betriebszuständigkeit. + +Die Reihenfolge soll sich an Abhängigkeiten orientieren: + +1. Korrekte Portalzuordnung und klare Verbindlichkeit. +2. Verlässliches Kundenbild, offene Gespräche und Vorprüfung. +3. Durchgängige Buchungs-, Änderungs- und Abschlussabläufe. +4. Nachvollziehbarer Erwerb und Einsatz von Gastvorteilen. +5. Passende regelbasierte Ansprache mit Stopps und Messung. +6. Schrittweise Erweiterung der Automatisierung anhand des Pilots. + +Diese Reihenfolge ist ein Vorschlag, kein Bauauftrag. Unabhängige kleine Verbesserungen können vorgezogen werden, sofern sie die fachlichen Regeln nicht vorwegnehmen. + +## Fortschreibung + +Ein beschlossener Punkt ersetzt seine vorherige Empfehlung ausdrücklich. Änderungen nennen die betroffenen Workflows und bestehenden Ansprüche. Bereits erworbene Vorteile, versandte Angebote und gültige Portalvereinbarungen werden nicht durch bloßes Umformulieren des Konzepts rückwirkend verändert. + +Die [Bestandsdokumentation](../README.md) bleibt weiterhin die Beschreibung des vorhandenen Systems. Erst tatsächlich umgesetzte und geprüfte Änderungen werden dort als umgesetzt nachgeführt. diff --git a/docs/architecture/konzept-vermietung/Konzept_kunden-und-kommunikation.md b/docs/architecture/konzept-vermietung/Konzept_kunden-und-kommunikation.md new file mode 100644 index 0000000..3f9a087 --- /dev/null +++ b/docs/architecture/konzept-vermietung/Konzept_kunden-und-kommunikation.md @@ -0,0 +1,83 @@ +# Kundenbild und individuelle Kommunikation + +Stand: 26.10.2026 · Vorschlag · [Konzeptübersicht](Konzept_README.md) + +## Ein zusammenhängendes Kundenbild + +Die Vermietung soll sehen, wer anfragt, was bereits vereinbart wurde, welche Wünsche bestätigt sind und wer zuletzt geantwortet hat. Stammgäste sollen erkennbar sein, ohne dass unklare Kontakttreffer zu fremden Daten oder Vorteilen führen. + +| Information | Bedeutung | +|---|---| +| Person und Kontakt | Bestätigte Kontaktdaten mit Herkunft und bevorzugter Ansprache | +| Rolle im Aufenthalt | Buchende Person, Mitreisender, Rechnungsempfänger oder organisatorischer Kontakt | +| Identitäten je Kanal | Bestätigte direkte Adresse, Portalkennung oder Alias; keine automatische Gleichsetzung | +| Aufenthalte | Tatsächliche Buchungen, Änderungen und Abschluss; eindeutig gezählt | +| Wünsche | Vom Gast genannte Präferenzen und konkrete Wünsche, mit Gültigkeit und Bestätigung | +| Kommunikation | Zugeordnete Gespräche, letzte Antwort, offener nächster Schritt und Zuständigkeit | +| Service | Noch ungeklärte Anliegen und getroffene Vereinbarungen | +| Vorteile | Teilnahme, Erwerb, verfügbare und vorgemerkte Leistungen | +| Kontaktwünsche | Zweck, Kanal, Nachweis, Abmeldung und gegebenenfalls begrenzter Suchauftrag | + +Ein gemeinsames Postfach oder eine Portal-Weiterleitungsadresse beweist nicht, dass es dieselbe Person ist. Haushalte und Reisegruppen sind nicht automatisch eine gemeinsame Kundenidentität. Die Nutzung mehrerer Websites desselben Mandanten muss transparent abgegrenzt werden; zwischen Mandanten werden Kundenprofile nicht geteilt. + +## Gesprächsführung + +Ein Gespräch hat Anlass, Bezug zum Aufenthalt oder Suchwunsch, erlaubten Kanal, Verantwortlichen und Bearbeitungsstand. Vorgeschlagene Zustände sind „Antwort nötig“, „Entwurf“, „wartet auf Gast“, „wartet auf interne Klärung“ und „erledigt“. + +Eingehende Antworten müssen vor weiteren automatischen Nachfragen berücksichtigt werden. Antwortet der Gast telefonisch, muss die Vermietung auch diese Klärung festhalten können. Eine spätere Portalnachricht soll keinen bereits beantworteten Fall erneut eröffnen, sofern sie inhaltlich nichts ändert. + +Bei mehreren parallelen Gesprächen werden die zugehörigen Aufenthalte sichtbar gehalten. Ein Gast kann zugleich ein aktuelles Reiseproblem und eine Anfrage für das Folgejahr haben; die Automatik darf daraus keine widersprüchliche Ansprache erzeugen. + +## Persönliche Ansprache + +Texte berücksichtigen bestätigte Anrede, Sprache, Erst- oder Wiederbesuch, aktuelle Frage, gebuchte Leistungen und bekannte eigene Zusagen. Die persönliche Ergänzung soll konkret helfen, etwa einen schon geklärten Wunsch aufgreifen oder unnötige Rückfragen vermeiden. + +Ein KI-Entwurf verwendet ausschließlich freigegebene Wohnungsinformationen und die für den Vorgang erforderlichen Kundendaten. Behauptete persönliche Erinnerungen, erfundene Gespräche und ungeprüfte Garantien sind keine zulässige Personalisierung im vorgeschlagenen Modell. + +Beispiel für den fachlichen Unterschied: „Wir haben Ihren Wunsch nach einem frühen Zugang notiert und prüfen ihn vor Anreise“ ist eine offene Serviceaussage. „Sie können wie immer schon um 10 Uhr einziehen“ wäre eine verbindliche Zusage und braucht einen bestätigten Sachstand. + +## Kontakt entlang der Reise + +| Zeitpunkt oder Anlass | Ziel | Bedingungen und Personalisierung | +|---|---|---| +| Eingang einer Anfrage | Sicherheit über Eingang und nächste Schritte | Verbindlichkeit und Haltefrist korrekt benennen | +| Fachliche Rückfrage | Eine konkrete Entscheidung ermöglichen | Nur tatsächlich fehlende Angaben erfragen | +| Angebot | Passenden Aufenthalt verständlich anbieten | Termin, Leistungen, Vorteil, Gültigkeit und Bedingungen ausweisen | +| Offenes Angebot | Bei Bedarf Entscheidung erleichtern | Nur bei gültigem Vorgang, ohne bereits eingegangene Antwort oder Ablehnung; rechtliche Einordnung der Nachricht klären | +| Bestätigung | Vereinbarung und nächste Aufgaben erklären | Portalvertrag und eigene Direktbuchung unterscheiden | +| Zahlung | Tatsächlich offenen Betrag klären | Keine eigene Mahnung für noch nicht ausgezahltes Portalinkasso | +| Vor Anreise | Praktische Fragen reduzieren | Bestätigte Zugangsinformationen, gebuchte Extras und Ansprechpartner | +| Während des Aufenthalts | Hilfe erreichbar machen | Dringende Fälle persönlich, Nachrichtenhäufigkeit passend halten | +| Nach Abreise | Abschluss und gegebenenfalls Feedback | Offene Probleme und erlaubten Bewertungsweg berücksichtigen | +| Vorteil erworben | Programmstand verständlich machen | Nachrichtenzweck, Berechtigung und zulässigen Kanal prüfen | +| Wiederbuchungszeitpunkt | Passende neue Reise anregen | Zulässiger Werbekontakt, Interesse und echte Verfügbarkeit | +| Suchwunsch wird erfüllt | Über angefragte Möglichkeit informieren | Nur im vereinbarten Umfang und Zeitraum des Suchwunschs | + +Für jeden Anlass braucht es außerdem einen Stoppgrund: neue Antwort, Buchung, Ablehnung, Storno, Widerspruch, Kanalverbot, unklare Zustellung oder persönlicher Servicefall. Eine neue Nachricht wird nicht allein deshalb versendet, weil ein Zeitintervall vergangen ist. + +## Service, Programm und Werbung unterscheiden + +Aufenthaltsabwicklung, Verwaltung eines vereinbarten Programms und Werbung erhalten getrennte Regeln. Das Etikett eines Textes entscheidet nicht über seinen tatsächlichen Zweck. Ein Dank mit Rabattaktion kann Werbecharakter haben; ein Programmhinweis darf nicht beiläufig jede Marketingkampagne einschließen. + +**Vorschlag für den Start:** Werbliche E-Mails nur auf Grundlage eines nachgewiesenen passenden Opt-ins versenden. Die gesetzliche Bestandskundenausnahme ist keine automatische Eigenschaft jeder Buchung und wird zunächst nicht als Standard vorausgesetzt. Sie wäre gesondert zu prüfen. [§ 7 UWG](https://www.gesetze-im-internet.de/uwg_2004/__7.html). + +Auch eine Einladung zur Erteilung einer Werbeeinwilligung wird nicht ungeprüft an alle vorhandenen oder aus Portalen übernommenen Adressen geschickt. Geeignete Erhebungspunkte, Text und Kanal müssen festgelegt werden. Die bestehende Einwilligungsfunktion allein schafft noch keine Erlaubnis für jeden Kontakt. + +Werbewidersprüche beenden die betroffene Ansprache. Notwendige Informationen zu einer laufenden Buchung sollen weiterhin den passenden Empfänger erreichen. Ein Widerspruch darf nicht zum Verlust bereits zugesagter Gastvorteile führen. Die Trennung ist Teil des vorgeschlagenen Produkts; die konkrete rechtliche Ausgestaltung wird anhand der endgültigen Texte geprüft. [DSGVO, insbesondere Art. 21](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32016R0679). + +## Besonderheiten der Portal-Kommunikation + +Der bevorzugte persönliche Kanal kann durch Portalregeln begrenzt sein. Ein unzulässiger externer Link wird nicht automatisch durch eine SMS oder private E-Mail umgangen. Wenn Antworten nur im Portal erlaubt oder erreichbar sind, muss die Vermietung dort arbeiten oder eine dafür zulässige angebundene Funktion nutzen. + +Bewertungs- und Wiederbuchungsfolgen werden je Kanal freigegeben. Airbnb hat hierfür konkrete Regeln und einen angekündigten Geltungswechsel; sie sind im [Quellenblatt](Konzept_quellen.md) dokumentiert. Die vorhandene eigene Bewertungsmail darf deshalb nicht automatisch für jeden importierten Portalaufenthalt übernommen werden. + +## Offene Entscheidungen + +- Gemeinsamer Posteingang in der Anwendung oder zunächst eine geführte Arbeitsliste mit externer Bearbeitung? +- Welche Kanäle werden tatsächlich betreut: E-Mail, Portalnachrichten, Telefon und gegebenenfalls weitere? +- Wer vertritt wen, zu welchen Zeiten und bei welcher Dringlichkeit? +- Welche Präferenzen sind nützlich, welche Inhalte werden nach Abschluss nicht weiter benötigt? +- Welche Nachfragen werden automatisch vorbereitet und welche nach Freigabe automatisch versandt? +- Welche Sprachkombinationen müssen Website, Vertrag und Betreuung gemeinsam leisten? + +Zugehörige Entscheidungen: D01, D06, D07, D09, D12 und D13 im [Arbeitsplan](Konzept_entscheidungen-und-arbeitsplan.md). diff --git a/docs/architecture/konzept-vermietung/Konzept_loyalty-programm.md b/docs/architecture/konzept-vermietung/Konzept_loyalty-programm.md new file mode 100644 index 0000000..6405ccc --- /dev/null +++ b/docs/architecture/konzept-vermietung/Konzept_loyalty-programm.md @@ -0,0 +1,101 @@ +# Loyalty-Programm und automatische Kundenbindung + +Stand: 26.10.2026 · Vorschlag · [Konzeptübersicht](Konzept_README.md) + +## Ziel und bisherige Grundlage + +Gäste sollen sich wiedererkannt fühlen und einen nachvollziehbaren Grund für einen weiteren passenden Aufenthalt erhalten. Automatisierung übernimmt Erkennung, Anspruchsprüfung, Erinnerung im zulässigen Umfang und korrekte Berücksichtigung im nächsten Angebot. + +Bereits vorhanden sind Gästekartei, Aufenthaltszuordnung, Markierungen, Sonderangebote, Codes und Werbeeinwilligungen. Ein eigenes Loyalty-Programm mit Erwerb, Vormerkung, Einlösung, Berichtigung und Regeln ist noch nicht gebaut. + +## Drei Dinge getrennt führen + +1. **Wiederkehrer-Erkennung:** Aus bestätigten abgeschlossenen Aufenthalten erkennen, dass ein Gast erneut kommt. Die Zählweise ist noch festzulegen. +2. **Gastvorteile:** Ein beschriebenes, gegebenenfalls freiwillig angenommenes Programm mit verständlichen Bedingungen und nachvollziehbaren Ansprüchen. +3. **Werbekontakt:** Erlaubnis für bestimmte Ansprache. Weder ein früherer Aufenthalt noch ein Programmanspruch ersetzt diese Prüfung. + +Für die Erkennung ist kein verpflichtendes öffentliches Gästekonto nötig. Vorteile können über einen verifizierten Kontakt und geschützte Ansichten erklärt werden. Ein Konto wäre eine gesonderte Produktentscheidung. + +## Programmvarianten zur Entscheidung + +| Variante | Nutzen | Aufwand und offene Fragen | +|---|---|---| +| Persönlicher Wiederkehrervorteil | Einfache, gut erklärbare Wiederbuchungsvorteile | Wann entsteht Anspruch, wie oft nutzbar, welche Saisons und Kanäle? | +| Stufen nach qualifizierenden Aufenthalten | Sichtbare Anerkennung längerer Beziehung | Schwellen, Zeitraum, Statusverlust und Umgang mit Gruppen | +| Punkte oder Guthaben | Fein abstufbare Belohnung und Einlösung | Wert, Verfall, Abrechnung, Rückabwicklung und Kommunikation deutlich aufwendiger | +| Empfehlungsprogramm | Zufriedene Gäste empfehlen den Aufenthalt weiter | Zuordnung, Selbstempfehlung, Zeitpunkt und zulässige Ansprache neuer Gäste | + +**Vorschlag für die erste Konzeptvariante:** ein einfaches Programm mit wenigen klaren Gastvorteilen. Ein umfassendes Punktesystem bleibt Vergleichsvariante. Damit lässt sich automatische Kundenbindung durchdenken, ohne schon einen bestimmten Geldwert oder eine Stufenzahl festzulegen. + +Mögliche Vorteile sind ein fester Wiederkehrernachlass, ein Extra, ein besonderes saisonales Angebot oder eine frühe Information über neue buchbare Zeiträume. Frühe Anreise oder späte Abreise können nur vorbehaltlich betrieblicher Verfügbarkeit gewährt werden. Ein Vorteil darf nicht mehr versprechen, als die Wohnung und der Ferienservice leisten können. + +## Qualifizierender Aufenthalt + +Vorgeschlagene Voraussetzung ist ein tatsächlich beendeter, ausreichend bezahlter und eindeutig zugeordneter Aufenthalt. Zeitpunkt und Umfang der Qualifikation sind als Programmregel festzulegen. + +| Fall | Vorgeschlagene Behandlung | +|---|---| +| Mehrfach gemeldeter Aufenthalt | Einmal zählen, unabhängig von Mail, Kalender und späterem Datenimport | +| Mehrere Wohnungen derselben Reise | Zählweise vorab festlegen; keine zufällige Mehrfachbelohnung | +| Portalaufenthalt | Nur bei belegtem Aufenthalt, bestätigter Identität und geklärter Kanalregel berücksichtigen | +| Mitreisende | Nicht automatisch alle als anspruchsberechtigte Mitglieder anlegen | +| Gemeinsam genutzte E-Mail | Person beziehungsweise Programminhaber bestätigen | +| Storno vor Aufenthalt | Kein regulärer abgeschlossener Aufenthalt; vorgemerkte Vorteile nach Regel freigeben | +| Nichtanreise | Nicht automatisch qualifizieren, auch wenn ein Betrag einbehalten wurde | +| Teilstorno oder verkürzter Aufenthalt | Tatsächliche Leistung und Programmregel anwenden | +| Nachträgliche Erstattung | Anspruch neu bewerten, ohne ungeprüfte Geldforderung auszulösen | +| Historische Aufenthalte | Nur belegte, freigegebene Übernahme; Stichtag und Umfang entscheiden | +| Reklamation | Kein automatischer Entzug; Anspruch und Servicebearbeitung getrennt halten | + +Die Vermeidung mehrfacher Vorteile beruht auf Vorgang und bestätigter Identität. Heimliches Geräte- oder Personenprofiling ist dafür nicht als Bestandteil des Programms vorgesehen. + +## Lebenslauf eines Vorteils + +| Phase | Bedeutung | +|---|---| +| Erwartet | Ein künftiger Aufenthalt könnte einen Vorteil auslösen; noch kein verfügbarer Anspruch | +| Erworben und verfügbar | Qualifikation geprüft, Bedingungen und gegebenenfalls Laufzeit bekannt | +| Für ein Angebot vorgemerkt | Vorteil für eine konkrete Angebotsfassung reserviert | +| Eingelöst | Verbindlicher Buchung oder bestätigter Zusatzleistung zugeordnet | +| Wieder freigegeben | Angebot abgelehnt oder abgelaufen, beziehungsweise Einlösung nach Regel aufgehoben | +| Berichtigt | Fehler, Storno oder Erstattung mit Grund nachvollziehbar korrigiert | +| Abgelaufen | Nur sofern eine vorher festgelegte und mitgeteilte Laufzeit gilt | + +Das erneute Versenden desselben Angebots darf keine zweite Einlösung erzeugen. Bei mehreren offenen Angeboten muss sichtbar sein, welchem Angebot der Vorteil zugeordnet ist. Wird eine Regel später geändert, muss feststehen, welche Fassung für bereits erworbene Ansprüche gilt. + +## Verbindung mit Preis und anderen Angeboten + +Der Gesamtpreis bleibt dieselbe fachliche Preisentscheidung für Website, Verwaltung und Gastangebot. Es wird festgelegt, ob ein Vorteil mit Saisonaktionen, Rabattcodes und Kulanz kombinierbar ist. Ein Gast soll erkennen, ob ein bestehendes Sonderangebot günstiger ist und ob sein Vorteil dann erhalten bleibt. + +**Vorschlag:** Ein begrenzter Vorteil wird nur verbraucht, wenn er tatsächlich angewendet wurde. Ein günstigeres öffentliches Angebot verbraucht ihn nicht stillschweigend. Absolute Buchungsgrenzen und Pflichtkosten werden durch das Programm nicht automatisch aufgehoben. + +## Automatische Kundenbindung + +| Anlass | Automatische Vorbereitung | Vor Ausführung prüfen | +|---|---|---| +| Aufenthalt beendet | Qualifikation und möglichen Vorteil ermitteln | Tatsächlicher Abschluss, Zahlung, Identität und frühere Zählung | +| Vorteil verfügbar | Verständliche Statusinformation vorbereiten | Nachrichtenzweck, Kontaktweg und Portalregel | +| Neuer Suchwunsch | Passende Vorteile in der Prüfung zeigen | Eignung, Verfügbarkeit und Kombinationsregel | +| Üblicher Wiederbuchungszeitpunkt | Passende Reiseidee vorbereiten | Bestätigtes Interesse, zulässige Ansprache und Kontaktbegrenzung | +| Geeignete Lücke | Relevante Gästegruppe vorschlagen | Freie Nächte, echter Vorteil, Kontakteignung und wirtschaftliche Grenze | +| Längere Inaktivität | Einmalige passende Reaktivierung vorschlagen | Erlaubter Kontakt, keine offene Beschwerde und keine laufende Buchung für denselben Anlass | + +Die Automatik soll auch sichtbar „nichts tun“, wenn Voraussetzungen fehlen. Teilnahme, Vorteil und Nachricht sind getrennte Entscheidungen. + +## Wirtschaftliche Grenzen + +Vor einer Regel werden tatsächliche Kosten des Vorteils, erwartete zusätzliche Übernachtungen, mögliche Verdrängung regulärer Buchungen und Bearbeitungsaufwand betrachtet. Ein ausgelasteter Hochsaisontermin braucht gegebenenfalls einen anderen Vorteil als eine schwer vermietbare Lücke. + +Festzulegen sind insbesondere Höchstkosten je Einlösung, verfügbare Zeiträume, Kombinierbarkeit, Übertragbarkeit, Laufzeit und Kulanzbefugnisse. Sämtliche Eurobeträge, Prozentsätze und Schwellen sind noch offen. + +## Fairness und verständliche Teilnahme + +Vorteile sind nicht von einer positiven Bewertung abhängig. Abmeldung von Werbung beendet nicht automatisch das Programm oder bestehende Ansprüche. Teilnahmebedingungen sollen vor Erwerb und Einlösung verständlich sein; ein späterer Nachteil wird nicht durch unbemerkte Regeländerung eingeführt. + +Bei Empfehlungen wird vorgeschlagen, einen freiwillig teilbaren Hinweis zu verwenden, statt fremde Kontaktadressen durch den Empfehlenden einsammeln und ungefragt anschreiben zu lassen. Eine Belohnung würde erst nach einem eindeutig qualifizierenden neuen Aufenthalt entstehen. + +## Offene Entscheidungen + +Programmvariante, Teilnahmeform, Träger des Anspruchs, qualifizierende Aufenthalte, Schwellen, Vorteile, zeitliche Gültigkeit, Kanalregeln, Rabattkombination und Rückabwicklung sind zu entscheiden. Eine mandantenübergreifende gemeinsame Punktewelt ist nicht Bestandteil des bisherigen Produktziels. + +Zugehörige Entscheidungen: D08, D09, D10 und D11 im [Arbeitsplan](Konzept_entscheidungen-und-arbeitsplan.md). Portalgrenzen: [Portale und Vertrieb](Konzept_portale-und-vertrieb.md). diff --git a/docs/architecture/konzept-vermietung/Konzept_marketing.md b/docs/architecture/konzept-vermietung/Konzept_marketing.md new file mode 100644 index 0000000..7876444 --- /dev/null +++ b/docs/architecture/konzept-vermietung/Konzept_marketing.md @@ -0,0 +1,86 @@ +# Marketing und Wiederbuchung + +Stand: 26.10.2026 · Vorschlag · [Konzeptübersicht](Konzept_README.md) + +## Ziele und Verbindung zur Vermietung + +Marketing soll passende neue Gäste gewinnen, schwächer nachgefragte Zeiträume sinnvoll belegen und die Beziehung zu zufriedenen Gästen erhalten. Verfügbarkeit, Preise, persönliche Betreuung und tatsächliche Wirtschaftlichkeit bilden den Rahmen. + +Die Konzeptphase unterscheidet öffentliche Vermarktung, direkte Ansprache bekannter Kontakte und auf einen konkreten Suchwunsch bezogene Hinweise. Bestehende Webseitenangebote und Herkunftsangaben sind Grundlage. Ein vollständiges Kampagnensystem ist bisher nicht gebaut. + +## Zielgruppen nach Reiseanlass + +Vorgeschlagen werden Gruppen nach ausdrücklich bekannten Interessen und Suchverhalten innerhalb eigener Vorgänge: bestimmte Reisezeit, Reisedauer, flexible Anreise, Wunschwohnung, Nebensaison, ruhiger Aufenthalt oder bereits erlebte Reiseform. Eine Vermutung über Alter, Gesundheit oder finanzielle Verhältnisse ist keine Grundlage für automatische Ansprache. + +Bekannte Interessen werden als zeitlich überprüfbare Angaben geführt. Ein einmaliger Wunsch für eine konkrete Reise ist nicht automatisch eine dauerhafte Präferenz. Ein Haushalt wird nicht ohne Bestätigung als gemeinsamer Werbekontakt behandelt. + +## Kampagnen und Anlässe + +| Kampagne | Auslöser | Geeignete Ansprache | Ende oder Ausschluss | +|---|---|---|---| +| Saisonstart | Neue buchbare Saison und bestätigte Preise | Website, erlaubter Newsletter oder passende Bestandskontakte | Preise fehlen oder Terminangebot nicht verfügbar | +| Lückenfüller | Konkrete freie Nächte | Öffentlicher Angebotsbereich und geeignete Interessenten | Lücke belegt oder Regel nicht mehr erfüllt | +| Wiederkehrerangebot | Qualifizierender Gast und passende Reisezeit | Persönlich formulierter Vorschlag mit zulässigem Vorteil | Bereits gebucht, Kontakt nicht erlaubt oder Angebot ungeeignet | +| Suchwunsch erfüllt | Gast bat um Nachricht zu bestimmten Terminen | Auf diesen Suchauftrag begrenzter Hinweis | Auftrag abgelaufen, widerrufen oder erfüllt | +| Neue Saison für Stammgäste | Neue Termine passend zur bestätigten Reisepräferenz | Frühe Information, falls als Programmleistung vorgesehen und Kontakt zulässig | Kein passender Zeitraum oder bereits erledigter Anlass | +| Reaktivierung | Länger kein Aufenthalt und weiter zulässiger Kontakt | Zurückhaltende Einladung mit konkretem Nutzen | Widerspruch, offene Servicefrage oder fehlender relevanter Anlass | +| Empfehlung | Gast möchte Unterkunft empfehlen | Teilbarer Hinweis, optional späterer Programmvorteil | Kein qualifizierender neuer Aufenthalt oder unklare Zuordnung | +| Öffentliche Inhalte | Passende Bilder, Gastgebertipps und echte Neuigkeiten | Website, redaktionelle Beiträge und ausgewählte soziale Kanäle | Nicht freigegebene Inhalte, Rechte oder abgelaufene Aktion | + +Eine Terminanfrage löst nicht automatisch einen allgemeinen Newsletter aus. Ein Suchauftrag soll nicht ohne neue Grundlage zu einem unbefristeten Marketingprofil werden. + +## Ablauf einer Kampagne + +1. Ziel benennen: beispielsweise bestimmte freie Nächte vermieten oder einen Wiederkehrerzeitraum früh anbieten. +2. Tatsächliche Verfügbarkeit, Preis und gegebenenfalls Gastvorteil prüfen. +3. Zielgruppe und erlaubten Kanal bestimmen; ausgeschlossene Kontakte nachvollziehbar entfernen. +4. Inhalt, Empfängervorschau, Gesamtkosten und gewünschte Reaktion vorbereiten. +5. Nach der vorgesehenen Befugnis freigeben und zeitlich planen. +6. Unmittelbar vor Ausführung Verfügbarkeit, Kontaktberechtigung und neu eingegangene Antworten erneut prüfen. +7. Antworten als Vermietungsvorgänge übernehmen. Bei belegtem Termin entsprechende geplante Hinweise stoppen. +8. Ergebnis anhand echter Anfragen, Buchungen, Aufenthalte und Kosten bewerten. + +Für zeitkritische Einzeltermine ist festzulegen, ob erst eine kleine Gruppe oder mehrere Interessenten zugleich informiert werden. Der Versand vermittelt keinen garantierten Vorrang, sofern dieser nicht ausdrücklich Teil des Verfahrens ist. + +## Kontaktbegrenzung und Vorrang + +Die endgültigen Werte sind offen. Das System soll je Kontakt und Anlass berücksichtigen, was bereits über welche Kanäle gesendet wurde und ob eine Rückmeldung aussteht. Verschiedene Kampagnen dürfen die Begrenzung nicht durch getrennte Listen umgehen. + +Vorgeschlagene Rangfolge bei Kollisionen: dringende persönliche Betreuung, notwendige Buchungsinformation, konkret gewünschte Antwort, Verwaltung zugesagter Vorteile und erst danach Werbung. Diese Rangfolge erlaubt nicht automatisch den Versand; jeder Zweck braucht zusätzlich einen geeigneten Kanal und eine gültige Grundlage. + +Kampagnen pausieren bei offener Reklamation, Zustellproblemen, neuer relevanter Kundenantwort oder einer anderen laufenden Bearbeitung. Eine Abmeldung wird vor Versand berücksichtigt und nicht durch einen späteren Datenimport rückgängig gemacht. + +**Vorgeschlagene Startregel:** Direkte werbliche E-Mails setzen ein nachweisbares passendes Opt-in voraus. Abweichende Bestandskundenfälle werden nicht pauschal freigeschaltet. [§ 7 UWG](https://www.gesetze-im-internet.de/uwg_2004/__7.html). Widerspruch gegen Direktwerbung muss auch zugehörige werbliche Profilbildung beenden. [DSGVO, Art. 21](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32016R0679). + +## Inhalte und Freigaben + +Ein Kampagneninhalt besteht aus belegtem Nutzen, konkretem Angebot beziehungsweise redaktionellem Anlass, Gesamtpreisbezug, Gültigkeit und einem verständlichen nächsten Schritt. Bestand, Laufzeit und Vorteile dürfen nicht erfunden werden. Restplätze werden nur genannt, wenn eine entsprechende tatsächliche Verfügbarkeit besteht. + +KI kann aus freigegebenen Informationen Entwürfe und Varianten erstellen. Persönliche Kundenangaben gehören nicht automatisch in öffentliche Beiträge. Fotos, Bewertungen und Kundenzitate benötigen einen für die konkrete Nutzung geklärten Umfang. + +Die Freigabe einer Vorlage ersetzt nicht die Freigabe jedes beliebigen Preises oder Empfängerkreises. Veröffentlichungen auf Website und sozialen Kanälen sind getrennt vom direkten Nachrichtenversand zu steuern. + +## Erfolg messen + +| Kennzahl | Vorgeschlagene Bedeutung | +|---|---| +| Qualifizierte Anfragen | Anfragen, die zum angebotenen Aufenthalt passen; Spam und Dubletten ausnehmen | +| Angebotsannahme | Angenommene Angebote im Verhältnis zu gültig versendeten Angeboten, getrennt nach Quelle | +| Belegte Nächte | Tatsächliche belegte beziehungsweise abgeschlossene Nächte im betrachteten Zeitraum; Status benennen | +| Wiederkehreranteil | Eindeutig zugeordnete Gäste mit vorherigem qualifizierendem Aufenthalt; Zählweise festlegen | +| Buchungen nach Kampagne | Nach einer vorher festgelegten Zuordnungsregel nachvollziehbare Buchungen | +| Direkter Vertriebsanteil | Direkte Buchungen beziehungsweise Nächte, getrennt von ursprünglicher Kundenherkunft | +| Kosten der Kundenbindung | Tatsächliche Kosten gewährter Vorteile und zugehöriger Ansprache | +| Vergleichbarer Beitrag | Zurechenbare Erlöse abzüglich berücksichtigter Vertriebs-, Kampagnen- und variabler Leistungskosten; Berechnungsumfang ausdrücklich benennen | +| Bearbeitungsaufwand | Benötigte persönliche Schritte und Zeit bis zur nächsten Entscheidung | +| Unpassende Ansprache | Widersprüche, Beschwerden, Fehlversand und korrigierte Automatiken | + +Kundenherkunft, Buchungsweg und Kampagnenanlass sind unterschiedliche Angaben. Eine spätere direkte Buchung ändert die ursprüngliche Erstgewinnung über ein Portal nicht nachträglich. Derselbe Aufenthalt zählt in Gesamtzahlen einmal, auch wenn mehrere Kontakte oder Kampagnen beteiligt waren. + +Die Zuordnung nach einem letzten Link oder Code beweist keine zusätzliche Wirkung der Kampagne. Für kleine Fallzahlen sollen Ergebnisse entsprechend vorsichtig beurteilt und nicht als sicherer Effekt ausgegeben werden. Öffnungs- und Klickverfolgung werden nicht als selbstverständlich vorausgesetzt; Notwendigkeit und zulässige Ausgestaltung sind gesondert zu entscheiden. + +## Offene Entscheidungen + +Vorrangige Ziele, aktive Kanäle, redaktioneller Umfang, Kontaktfrequenzen, Budgets, Gültigkeit von Suchwünschen und Regeln zur Erfolgszuordnung sind festzulegen. Vorgeschlagener Einstieg ist ein konkret nachvollziehbarer Anwendungsfall wie Wiederbuchung oder Nebensaisonlücke, bevor mehrere Kampagnen parallel laufen. + +Zugehörige Entscheidungen: D07, D09, D11, D13 und D14 im [Arbeitsplan](Konzept_entscheidungen-und-arbeitsplan.md). diff --git a/docs/architecture/konzept-vermietung/Konzept_portale-und-vertrieb.md b/docs/architecture/konzept-vermietung/Konzept_portale-und-vertrieb.md new file mode 100644 index 0000000..eaffc0f --- /dev/null +++ b/docs/architecture/konzept-vermietung/Konzept_portale-und-vertrieb.md @@ -0,0 +1,95 @@ +# Portale und Vertrieb + +Stand: 26.10.2026 · Vorschlag · [Konzeptübersicht](Konzept_README.md) + +## Aufgabe eines Kanals + +Ein Kanal kann Aufmerksamkeit erzeugen, eine Anfrage vermitteln, einen Vertrag zustande bringen, Geld einziehen oder Kommunikation führen. Diese Aufgaben sind je Portal und gebuchtem Leistungsumfang gesondert zu beschreiben. Ein vorhandener Kalenderlink beantwortet sie nicht. + +Vorgeschlagene Kanaltypen sind eigener Direktvertrieb, vermittelndes Inserat, Portal mit Anfrageentscheidung und Portal mit verbindlicher Buchung. Ein tatsächliches Konto kann abhängig von seinen Einstellungen mehrere Abläufe unterstützen. + +## Arbeitsliste für die Konzeptphase + +Die Liste stammt aus dem bisherigen Projekt und ist noch keine Bestätigung der aktiv genutzten Kanäle. Auswahl, Konten und Prioritäten sind offen. + +| Kanal | Rolle im Konzept | Konkret zu erheben | +|---|---|---| +| Eigene Website | Eigene Anfrage mit Angebot; später möglicherweise Direktbuchung | Vormerkung, Freigabe, Direktbuchungsbedingungen und Kontaktregeln | +| Telefon und persönliche E-Mail | Persönlich betreute Anfrage oder Dokumentation einer Vereinbarung | Erfassung, Quelle, schriftliche Bestätigung und Vertretung | +| FeWo-direkt / Vrbo | Portal mit eigenem Buchungs- und Kommunikationsablauf | Tatsächlicher Buchungsmodus, Kalender, Zahlungszuständigkeit und manuelle Sperren | +| ferienundwohnen.de | Kandidat aus dem bisherigen Vertriebskonzept | Aktuelles Inseratspaket, Anfragerouting und verfügbare Kalenderwege | +| Ostseeklar | Regionaler Vertriebskandidat | Aktuelles Leistungsmodell, Anfrageweg, Import und Export | +| Traum-Ferienwohnungen | Zusätzlicher Vertriebskandidat | Tatsächlicher Vertrags-, Buchungs- und Kommunikationsweg | +| Tourist-Information Kühlungsborn | Verzeichnis oder Buchungskanal gesondert entscheiden | Reiner Verweis auf eigene Website oder eigenständige Buchungsabwicklung | +| Booking.com | Mögliche spätere Erweiterung | Freigeschalteter Buchungsmodus, Verfügbarkeit, Zahlung, Änderungen und Nachrichten | +| Airbnb | Mögliche spätere Erweiterung | Konkrete Konto- und Inseratsregeln, Kommunikation, Datennutzung und Wiederbuchung | + +Reichweite, Gebühren und technische Zusagen werden nicht aus älteren Recherchen als aktuelle Eigenschaften übernommen. Für jeden ausgewählten Kanal braucht die Konzeptphase den tatsächlichen vertraglichen Leistungsumfang. + +## Portalsteckbrief + +Für jeden relevanten Kanal soll ein eigener ausgefüllter Steckbrief entstehen. Die folgende Struktur ist eine Arbeitsvorlage innerhalb dieses Konzepts. + +| Feld | Fachlich zu klärende Frage | +|---|---| +| Ziel und Zielgruppe | Warum nutzen wir den Kanal, welche Aufenthalte soll er bringen? | +| Zugeordnete Wohnungen | Welche Inserate stehen für welche eigene Wohnung? | +| Buchungsmodus | Anfrage, Buchungsanfrage mit Frist oder bereits verbindliche Buchung? | +| Vertrag und Bedingungen | Wer bestätigt verbindlich, welche Bedingungen gelten in welcher Fassung? | +| Belegungswirkung | Ab welchem Ereignis hält oder belegt der Kanal Nächte? | +| Fristen | Welche Reaktion muss bis wann in welchem System erfolgen? | +| Verfügbarkeit | Welche Richtung wird synchronisiert, wie aktuell ist der letzte bestätigte Stand? | +| Buchungsdaten | Welche Gäste-, Preis-, Leistungs- und Referenzdaten liegen tatsächlich vor? | +| Geldfluss | Wer zieht ein, wer erstattet, wann zahlt das Portal aus und welche Gebühren fallen an? | +| Nachrichten | Wo müssen wir antworten, welche Nachrichten werden übernommen und wie erkennen wir die Antwort des Gastes? | +| Kontaktnutzung | Welche Daten dürfen für Aufenthalt, spätere Ansprache und Loyalty verwendet werden? | +| Änderungen und Storno | Welches System entscheidet, welche Rückmeldung ist maßgeblich? | +| Bewertungen | Welcher Bewertungsweg ist erlaubt und vorgesehen? | +| Wiederbuchung | Welche Vorteile und Hinweise sind für Wiederkehrer zulässig? | +| Störung und Vertretung | Wer übernimmt, wenn Daten oder Antworten ausbleiben? | +| Wirtschaftlichkeit | Welche Erlöse und direkten Kosten können wir diesem Kanal belegt zuordnen? | +| Nachweise | Vertragsgrundlage, geprüfte Einstellungen, Quelle, Prüfdatum und zuständige Person | + +## Fähigkeiten getrennt bewerten + +Die Freigabe eines Kanals soll nicht nur „angebunden“ oder „nicht angebunden“ lauten. Gesondert zu prüfen sind Belegung empfangen, Belegung übermitteln, Buchungen erkennen, Details übernehmen, Änderungen empfangen, Preise pflegen, Zahlungen zuordnen sowie Nachrichten lesen und beantworten. + +Je Fähigkeit werden **vorhanden und erprobt**, **nur manuell**, **nicht verfügbar** oder **ungeklärt** festgehalten. Nur erprobte Fähigkeiten dürfen einen automatischen Folgeprozess auslösen. Ein erfolgreicher Import eigener Nächte beweist beispielsweise nicht, dass das Portal eine neue direkte Buchung bereits gesperrt hat. + +## Führung der fachlichen Daten + +| Gegenstand | Vorgeschlagene Regel | +|---|---| +| Eigene Anfragen und Angebote | Eigene Vermietung führt Preis, Angebot und Entscheidung | +| Verbindliche Portalvereinbarung | Portalereignis und gültige Portalbedingungen sind maßgeblich; lokale Akte bildet sie ab | +| Zusammengeführte Belegung | Der bisherige zentrale Belegungsstand bleibt Grundlage; Verzögerungen externer Systeme bleiben sichtbar | +| Gastdaten | Nur nachgewiesene Angaben übernehmen, Quelle kenntlich halten und Identitäten kontrolliert zuordnen | +| Zahlung | Verpflichtung des Gastes, Portalinkasso und tatsächliche Vermieterauszahlung unterscheiden | +| Kundenbindung | Eigener Mandant führt seine bestätigten Vorteile, soweit der Kanal deren Nutzung erlaubt | +| Kanalwechsel | Bestehenden Vertrag nicht stillschweigend durch einen neuen direkten Vertrag ersetzen | + +Soll später ein Channel-Manager die Führung der Verfügbarkeit übernehmen, braucht das eine ausdrückliche neue Entscheidung. Zwei gleichzeitig konkurrierende Führungen sind kein Zielmodell. + +## Störungen und Konflikte + +Veraltete Kalenderdaten, ausgefallenes Postfach, unklare Stornomeldung oder widersprüchliche Termine führen zu einer sichtbaren Aufgabe. Eine fehlende Nachricht ist kein Nachweis für eine freie Wohnung. Eine fehlende Bestätigung ist kein Nachweis, dass eine externe Sperre wirksam wurde. + +Bei unsicherem Belegungsstand wird die automatische verbindliche Zusage für betroffene Wohnungen ausgesetzt. Eine bereits bestätigte Portalbuchung wird als Konflikt behandelt und nicht automatisch abgelehnt. Wiederholte Meldungen desselben Vorgangs dürfen weder neue Buchungen noch zusätzliche Loyalty-Gutschriften erzeugen. + +## Punktuell geprüfte externe Rahmenbedingungen + +- **Vrbo:** Die Kalenderhilfe beschreibt iCal und unterscheidet die Verwaltung im eigenen Vermieterbereich von einer Fremdsoftware-Anbindung. Eine konkrete Kalenderkonfiguration muss deshalb im tatsächlich gewählten Betriebsmodell geprüft werden. [Vrbo-Kalenderhilfe](https://help.vrbo.com/articles/How-do-I-import-my-iCal-or-Google-calendar). +- **Booking.com:** Die Dokumentation beschreibt neben Sofortbuchung auch „Request to Book“ für berechtigte Unterkünfte. „Booking.com“ darf daher nicht pauschal als ein einziger Buchungsworkflow modelliert werden. Eine Dokumentation verfügbarer Schnittstellen belegt noch keinen Zugang unseres Betriebs. [Request to Book](https://developers.booking.com/connectivity/docs/request-to-book/overview). +- **Nachrichten:** Buchungs- und Änderungsentscheidungen sind nicht immer durch eine einfache Textantwort erledigt. Booking.com nennt beispielsweise strukturierte Änderungsfälle mit Bearbeitung im Extranet. [Booking.com-Kommunikation](https://developers.booking.com/connectivity/docs/messaging-api/understanding-the-messaging-api). +- **Direktansprache:** Expedia/Vrbo beschränkt die Verlagerung laufender Portalvorgänge und Zahlungen außerhalb der Plattform; die Richtlinie unterscheidet davon ausdrücklich vereinbartes allgemeines Marketing. Airbnb enthält eigene Beschränkungen für externe Zahlung, Wiederbuchung und Kontaktverwendung. Daraus folgt für dieses Konzept: kein pauschaler automatischer Wechsel von Portal zu Direktvertrieb. [Expedia-Regel](https://www.expediagroup.com/en-us/marketplace-policies/offline-booking-policy), [Airbnb-Preise und Zahlungen](https://www.airbnb.com/help/article/2799). + +Das sind Rahmenbefunde vom 26.10.2026, keine vollständige Prüfung der Konto- und Vertragsbedingungen. Weitere Details und der bereits angekündigte Airbnb-Regelwechsel stehen in [Quellen](Konzept_quellen.md). + +## Entscheidungen für die nächste Vertiefung + +1. Aktive, zwingend nötige und nur denkbare Kanäle bestätigen. +2. Je aktivem Kanal mindestens Anfrage, bestätigte Buchung, Änderung, Storno und Kundenantwort als echte anonymisierte Beispiele untersuchen. +3. Führung von Vertrag, Belegung, Zahlung und Nachrichten ausdrücklich festhalten. +4. Erst danach Automatisierung und Einsatz eines ergänzenden Dienstleisters bewerten. + +Zugehörige Entscheidungen: D03, D04, D05 und D09 in [Arbeitsplan](Konzept_entscheidungen-und-arbeitsplan.md). diff --git a/docs/architecture/konzept-vermietung/Konzept_quellen.md b/docs/architecture/konzept-vermietung/Konzept_quellen.md new file mode 100644 index 0000000..c0b5ea6 --- /dev/null +++ b/docs/architecture/konzept-vermietung/Konzept_quellen.md @@ -0,0 +1,56 @@ +# Quellen und Gültigkeit + +Stand der Sichtung: 26.10.2026 · [Konzeptübersicht](Konzept_README.md) + +## Interne Grundlage + +| Quelle | Verwendung | +|---|---| +| [Fachlicher Bestand](../README.md) | Vorhandene Funktionen und bekannte Lücken | +| [Vermietung](../vermietung.md) | Gegenwärtiger Anfrage-, Angebots-, Vertrags- und Zahlungsweg | +| [Gäste und Kommunikation](../gaeste-und-kommunikation.md) | Kartei, Einwilligung, Bewertungen und Grenzen der Nachrichtenablage | +| [Preise und Angebote](../preise-und-angebote.md) | Preisregeln, Mindestaufenthalt, Sonderangebote und bekannte Abweichung | +| [Portale und Belegung](../portale-und-belegung.md) | Kalender, Portal-Mail, Sperraufgaben und fehlende vollständige Portalbuchungen | +| [Konzept](../../KONZEPT.md) | Bisherige Produktentscheidungen, insbesondere Buchungswege und Kurabgabe | +| [Projektstand](../../STATUS.md) | Umsetzungs- und Betriebsstand | +| [Mandantenplan](../../MANDANTEN-PLAN.md) | Trennung der Vermieter, Dienste und Verantwortung | +| [Designkonzept](../../DESIGN-KONZEPT.md) | Geplante Inhalte und saisonale Vermarktung | +| [Portal-Analyse](../../PORTALE.md) | Historische Recherche und bisher diskutierte Vertriebswege; keine ungeprüfte Übernahme älterer Leistungs- und Preisangaben | +| [Datenmodell-Entwurf](../../DATENMODELL-KONZEPT.md) | Diskussionsgrundlage für vollständige Portalbuchungen und Kommunikation; keine pauschale Freigabe seiner Vorschläge | + +## Punktuelle externe Prüfung + +Es wurden offizielle Quellen zu besonders relevanten Grenzen gesichtet. Diese Prüfung ersetzt keinen Portalsteckbrief des tatsächlichen Kontos. Sie legt weder eine Anbieterwahl noch einen Schnittstellenzugang oder eine rechtliche Freigabe fest. + +### Kalender und Buchungsmodus + +Vrbo beschreibt Kalenderimport und -export über iCal sowie Unterschiede nach Verwaltungsmodell. Für das Konzept ist deshalb zwischen verfügbarer Kalenderfunktion und tatsächlicher eigener Anbindung zu unterscheiden. [Offizielle Vrbo-Kalenderhilfe](https://help.vrbo.com/articles/How-do-I-import-my-iCal-or-Google-calendar). + +Booking.com dokumentiert „Request to Book“ für berechtigte Unterkünfte neben dem Modell der Sofortbuchung. Zu erheben ist der tatsächlich freigeschaltete Modus mit seinen konkreten Fristen und Haltewirkungen. [Booking.com: Request to Book](https://developers.booking.com/connectivity/docs/request-to-book/overview). + +Die offizielle Messaging-Dokumentation behandelt Nachrichten und strukturierte Wünsche. Nicht jede Vertragsänderung kann durch eine freie Antwort erledigt werden; die beschriebenen Einschränkungen sind im Kanalworkflow zu berücksichtigen. [Booking.com: Messaging](https://developers.booking.com/connectivity/docs/messaging-api/understanding-the-messaging-api). + +### Portal-Kommunikation und Kundenbindung + +Expedia Group unterscheidet unerlaubte Verlagerung eines Portalvorgangs von ausdrücklich vereinbartem allgemeinem Marketing. Ob eine konkrete Loyalty- oder Wiederbuchungsnachricht passt, ist deshalb nach Inhalt und Vorgang zu prüfen. [Expedia Group: Off-Platform Booking Policy](https://www.expediagroup.com/en-us/marketplace-policies/offline-booking-policy). + +Airbnb regelt externe Kommunikation, Zahlungen und Hinweise auf andere Buchungswege einschließlich Wiederbuchungen. Eine direkte Wiederbuchungskampagne darf daher nicht pauschal auf importierte Airbnb-Kontakte angewendet werden. [Airbnb: Pricing and payment transparency](https://www.airbnb.com/help/article/2799). + +**Angekündigter Geltungswechsel:** Die am 26.10.2026 gelesene Airbnb-Seite zeigt oben Regeln für Buchungen ab **20.11.2026** und darunter die bisherige Richtlinie für davor gebuchte Aufenthalte. Sie behandelt unter anderem zusätzliche Verträge, Kontaktdaten und externe Bewertungswege. Vor einer Einführung ist die für den jeweiligen Buchungszeitpunkt geltende Fassung heranzuziehen. [Airbnb: Limiting host-imposed contracts and other requirements](https://www.airbnb.com/help/article/4169). + +### Werbekontakt und automatische Entscheidungen + +§ 7 UWG enthält Anforderungen an elektronische Werbung und die bedingte Bestandskundenausnahme. Die Startempfehlung des Konzepts verwendet ein nachgewiesenes Opt-in; eine Ausnahme wird nicht pauschal aus „Stammkunde“ abgeleitet. [§ 7 UWG](https://www.gesetze-im-internet.de/uwg_2004/__7.html). + +Die DSGVO behandelt unter anderem Widerspruch gegen Direktwerbung und bestimmte ausschließlich automatisierte Entscheidungen. Das Konzept trennt daher Kundenbindung, Kontaktwunsch und fachliche Vorprüfung. Die endgültigen Texte, Zwecke und Befugnisse müssen anhand des beschlossenen Modells beurteilt werden. [DSGVO, insbesondere Art. 21 und 22](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32016R0679). + +## Noch zu belegende Annahmen + +- Welche Portale und Konten tatsächlich genutzt werden und welche Buchungsmodelle dort eingestellt sind. +- Welche vertraglichen Portalregeln im konkreten Konto und Markt gelten. +- Welche Gast-, Zahlungs- und Nachrichtendaten tatsächlich eintreffen. +- Wie sich echte Gästeanfragen und Stammkundenkontakte im heutigen Betrieb verteilen. +- Welche Vorteile Gäste schätzen und welche Kosten beziehungsweise Kapazitäten dafür entstehen. +- Welche Betreuungszeiten, Vertretung und Automatisierungstiefe gewünscht sind. + +Ungeklärte Angaben bleiben offen. In diesem Konzept wurden keine echten Kundennachrichten, Kontaktdaten oder Portalzugänge verarbeitet und keine externen Nachrichten versendet. diff --git a/docs/architecture/konzept-vermietung/Konzept_szenarien.md b/docs/architecture/konzept-vermietung/Konzept_szenarien.md new file mode 100644 index 0000000..839afb4 --- /dev/null +++ b/docs/architecture/konzept-vermietung/Konzept_szenarien.md @@ -0,0 +1,74 @@ +# Szenarien für Konzept und fachliche Abnahme + +Stand: 26.10.2026 · Vorschlag · [Konzeptübersicht](Konzept_README.md) + +Die Fälle dienen zunächst der gemeinsamen Diskussion. Nach Entscheidung der Regeln werden daraus fachliche Abnahmekriterien. Sie sind keine bereits ausgeführten Anwendungstests und bestätigen keine vorhandene Umsetzung. + +## Anfrage, Angebot und Vorprüfung + +| ID | Situation | Erwartetes fachliches Ergebnis im Zielkonzept | +|---|---|---| +| S01 | Neuer Gast fragt einen freien, vollständig bepreisten Aufenthalt an | Unverbindlichkeit, Vormerkung, Frist und nächster Schritt sind klar; Angebot wird nach passender Prüfung vorbereitet | +| S02 | Gewünschter Termin ist belegt | Keine Zusage; mögliche Alternativen nur mit eigener aktueller Prüfung und Zustimmung zum anderen Aufenthalt | +| S03 | Gast fragt nach einem barrierefreien Zugang, Angaben sind nicht ausreichend bestätigt | Konkrete bauliche Prüfung und persönliche Antwort; keine erfundene Zusage oder vermutete Bewertung der Person | +| S04 | Vormerkung läuft ab, während eine Rückfrage offen ist | Zeitraum wird nach gültiger Regel frei; Rückfrage verlängert nicht stillschweigend und späteres Angebot prüft erneut | +| S05 | Gast ändert den Termin eines noch offenen Angebots | Neue Preis- und Verfügbarkeitsprüfung; eindeutige Angebotsfassung; alte Annahme darf keine zweite Vereinbarung auslösen | +| S06 | Telefonnummer und Name unterscheiden sich bei bekannter E-Mail | Keine ungeprüfte Überschreibung und keine Offenlegung früherer Aufenthalte; Identität klären | +| S07 | Eine Buchung wurde telefonisch bereits vereinbart | Vereinbarung dokumentieren, Verfügbarkeit klären und passende Bestätigung; keinen unnötigen neuen Annahmeprozess erfinden | + +## Portal und Belegung + +| ID | Situation | Erwartetes fachliches Ergebnis im Zielkonzept | +|---|---|---| +| S08 | Portal sendet bereits bestätigte Buchung | Belegung sichern und Vertragssituation abbilden; keine erneute Aufforderung zur direkten Vertragsannahme | +| S09 | Dieselbe Buchung kommt per E-Mail, Kalender und später mit vollständigen Details | Ein Aufenthalt, eine Belegung, keine doppelte Gäste- oder Loyalty-Zählung | +| S10 | Nur der Kalenderblock ist bekannt | Nächte sperren; fehlende Gast-, Preis- und Zahlungsdaten als unbekannt führen | +| S11 | Portal meldet Buchungsanfrage mit eigener Antwortfrist | Richtigen Portalworkflow und Haltewirkung anwenden; lokale Nachricht allein erfüllt nicht automatisch die externe Frist | +| S12 | Portalinkasso ist erfolgt, Auszahlung an Vermietung steht aus | Keine unberechtigte direkte Mahnung an den Gast; Auszahlung getrennt nachhalten | +| S13 | Portalabgleich ist veraltet, neue verbindliche Zusage wäre möglich | Betroffene automatische Zusage zurückhalten und persönliche Prüfung auslösen | +| S14 | Neue bestätigte Portalbuchung überschneidet sich mit eigener Buchung | Konflikt priorisieren; keine bestehende Vereinbarung still überschreiben oder automatisch aufheben | +| S15 | Storno und Änderung treffen in falscher Reihenfolge ein | Nachweisbar gültigen Vorgang herstellen; keine Freigabe allein wegen der Reihenfolge des Eingangs | +| S16 | Portal erlaubt den geplanten externen Kontakt oder Bewertungsweg nicht | Nachricht dort nicht ausführen; zulässige persönliche Bearbeitung oder freigegebenen Portalweg verwenden | + +## Aufenthalt und Kommunikation + +| ID | Situation | Erwartetes fachliches Ergebnis im Zielkonzept | +|---|---|---| +| S17 | Gast antwortet kurz vor einer geplanten automatischen Rückfrage | Antwort berücksichtigen und überholte Rückfrage stoppen | +| S18 | Vermietung hat eine individuelle Zusage gemacht, Standardtext widerspricht | Bestätigte Vereinbarung berücksichtigen; Entwurf zur Klärung zurückhalten | +| S19 | Offene Reklamation fällt mit Werbung und Bewertungsanfrage zusammen | Persönliche Betreuung hat Vorrang; unpassende Folgen pausieren, notwendige Buchungsinformationen bleiben möglich | +| S20 | Frühere Anreise wird gewünscht, Ferienservice hat noch nicht bestätigt | Wunsch ist offen; keine automatische Leistungsgarantie | +| S21 | Versand wurde angestoßen, Ergebnis ist unklar | Vorgang sichtbar halten; vor Wiederholung auf mögliche bereits erfolgte Übergabe prüfen | +| S22 | Gast widerspricht Werbung bei laufender Buchung | Werbliche Ansprache stoppen; notwendige Aufenthaltskommunikation korrekt fortsetzen | + +## Loyalty und Wiederbuchung + +| ID | Situation | Erwartetes fachliches Ergebnis im Zielkonzept | +|---|---|---| +| S23 | Qualifizierender Aufenthalt wird abgeschlossen | Vorteil gemäß freigegebener Regel einmalig erwerben; keine automatische Werbeeinwilligung unterstellen | +| S24 | Zwei offene Angebote sollen denselben einmaligen Vorteil nutzen | Vorteil eindeutig vormerken; keine doppelte verbindliche Einlösung | +| S25 | Öffentliches Angebot ist günstiger als Loyalty-Nachlass | Gast erhält nachvollziehbaren Vergleich; ungenutzter Vorteil wird nicht stillschweigend verbraucht | +| S26 | Gast lehnt das Angebot mit vorgemerkt enthaltenem Vorteil ab | Vorteil nach Regel wieder freigeben; Ablehnung beendet den Angebotsanlass | +| S27 | Aufenthalt wird storniert oder nachträglich teilweise erstattet | Anspruch und Einlösung gemäß festgelegten Regeln berichtigen; keine automatische ungerechtfertigte Geldforderung | +| S28 | Zwei Personen nutzen dieselbe Adresse und haben unterschiedliche Ansprüche | Richtigen Programminhaber klären; Ansprüche nicht versehentlich zusammenlegen | +| S29 | Stammgast meldet sich vom Newsletter ab | Werbekontakt endet; bestehende Vorteile bleiben nach Programmregel nutzbar | +| S30 | Gast hinterlässt kritische Bewertung | Reguläre Vorteile nicht wegen der Bewertung entziehen; Serviceanliegen gesondert bearbeiten | +| S31 | Historischer Portalgast fragt später direkt an | Identität und Kanalbedingungen prüfen; belegte Historie nutzen, Herkunft erhalten, keine ungeprüfte Gleichsetzung | + +## Marketing und Mandanten + +| ID | Situation | Erwartetes fachliches Ergebnis im Zielkonzept | +|---|---|---| +| S32 | Beworbene Lücke wird vor geplantem Versand gebucht | Konkreten Versand stoppen oder nach neuer Prüfung ändern; keinen nicht verfügbaren Termin versprechen | +| S33 | Suchauftrag ist abgelaufen, spätere passende Lücke entsteht | Nicht auf den abgelaufenen Auftrag gestützt anschreiben | +| S34 | Zwei Kampagnen wollen denselben Kontakt im selben Zeitraum erreichen | Anlassübergreifende Begrenzung und Vorrangregel anwenden | +| S35 | Kunde bucht nach mehreren Kampagnenkontakten | Aufenthalt einmal zählen; verwendete Zuordnungsregel kenntlich machen, keine sichere Zusatzwirkung behaupten | +| S36 | Dieselbe Person ist Kunde zweier Mandanten | Getrennte Kundenbeziehungen und Ansprüche; kein Austausch von Kontaktdaten oder Vorteilen ohne eigenes Konzept | +| S37 | Ein Empfehlender nennt ungefragt die E-Mail einer anderen Person | Keine automatische Werbung an den Dritten; freiwilligen passenden Empfehlungsweg verwenden | +| S38 | Ein Dienst wird pausiert, während Vorgänge offen sind | Neue automatische Ausführung stoppen; Verpflichtungen und persönliche Aufgaben bleiben sichtbar | + +## Beispiel für die gemeinsame Durcharbeitung + +Für einen ausgewählten Fall wird festgehalten: Ausgangsdaten, Wissen und Unsicherheiten, gewünschtes Gastresultat, verbindliche Entscheidung, Belegungswirkung, Preis und Vorteil, Nachrichten, zuständige Person und Nachweis des Ergebnisses. + +Erst nach dieser fachlichen Bewertung wird entschieden, welche Teile als Regel automatisierbar sind. Eine positive Standardfallbeschreibung ersetzt nicht die Bewertung der zugehörigen Ausnahmen. diff --git a/docs/architecture/konzept-vermietung/Konzept_vorpruefung.md b/docs/architecture/konzept-vermietung/Konzept_vorpruefung.md new file mode 100644 index 0000000..275cd45 --- /dev/null +++ b/docs/architecture/konzept-vermietung/Konzept_vorpruefung.md @@ -0,0 +1,71 @@ +# Vorprüfung von Anfragen und Aufenthalten + +Stand: 26.10.2026 · Vorschlag · [Konzeptübersicht](Konzept_README.md) + +## Zweck und Umfang + +Die Vorprüfung macht aus einem Eingang einen bearbeitbaren Vorgang. Sie klärt, ob die angebotene Wohnung und der gewünschte Aufenthalt zusammenpassen, ob die Angaben ausreichen und wo vor einer Zusage eine Rückfrage nötig ist. + +Sie unterscheidet drei Situationen: eine noch unverbindliche Anfrage, einen Angebotsentwurf und eine bereits verbindliche Buchung. Derselbe Befund kann unterschiedliche Folgen haben: Ein unklarer Sonderwunsch hält gegebenenfalls ein neues Angebot zurück; bei einer bestätigten Portalbuchung entsteht daraus eine Klärungsaufgabe. + +## Prüfbereiche + +| Bereich | Prüfung | Mögliches Ergebnis | +|---|---|---| +| Eingang und Quelle | Welche Art Nachricht, welches Portal, welches Inserat, welche Referenz? | Neu anlegen, vorhandenem Vorgang zuordnen oder persönlich klären | +| Vertraglicher Stand | Frage, Anfrage, Angebot, angenommene Buchung, Änderung oder Storno? | Passenden Workflow wählen; keinen zweiten Vertrag auslösen | +| Identität und Kontakt | Ausreichende Kontaktangaben? Sichere Zuordnung zu vorhandenem Gast? | Kontakt nutzen, Zuordnung bestätigen oder getrennt lassen | +| Zeitraum | Gültige Daten, Nächte, Vorlauf und gewünschte Flexibilität? | Weiterbearbeiten oder konkret nachfragen | +| Verfügbarkeit | Eigene Belegung, Sperren, Haltefristen und Aktualität externer Daten? | Frei, unsicher oder nicht verfügbar | +| Personen und Leistung | Passt die Personenzahl zur Wohnung? Welche Extras und bestätigten Wünsche gehören dazu? | Kalkulierbare Leistung oder sachliche Klärung | +| Wohnungseignung | Passen ausdrücklich genannte Anforderungen zu bestätigten Wohnungsmerkmalen? | Verlässliche Auskunft oder Prüfung vor Zusage | +| Preis | Alle Nächte bepreist, Pflichtkosten enthalten, Ausnahmen und Vorteile gültig? | Freigabefähige Berechnung oder Klärung | +| Zahlung | Wer zieht Geld ein, welche Beträge und Fristen sind belegt? | Korrekten Zahlungsablauf wählen | +| Wiederkehrer und Loyalty | Identität bestätigt, qualifizierende Historie, einlösbarer Vorteil? | Vorschlag mit Begründung oder keine Anwendung | +| Portalbedingungen | Welche Antwort-, Kontakt-, Vertrags- und Änderungswege sind zulässig? | Richtiger Kanal und passende Aktion | +| Offene Vorgänge | Bereits laufendes Gespräch, Servicefall, ähnliche Anfrage oder Umbuchung? | Zusammen bearbeiten oder bewusst trennen | + +Barrierefreiheit wird anhand konkreter baulicher Angaben und der Wünsche des Gastes geklärt. Das System soll etwa Stufen oder Duschzugang verlässlich beschreiben, nicht aus Vermutungen über Personen die Eignung entscheiden. + +## Ergebnis statt pauschaler Kundenbewertung + +| Prüfergebnis | Bedeutung | Nächster Schritt | +|---|---|---| +| Vollständig und passend | Alle entscheidungsrelevanten Angaben liegen vor | Angebot oder nächste erlaubte Bearbeitung vorbereiten | +| Rückfrage nötig | Gast kann eine klar benannte Lücke schließen | Konkrete Frage mit Zuständigkeit und Frist | +| Fachliche Entscheidung nötig | Kulanz, Sonderleistung, Konflikt oder Ausnahme liegt vor | Vermietung entscheidet mit sichtbaren Gründen | +| Derzeit nicht erfüllbar | Zum Beispiel Termin belegt oder Kapazität überschritten | Sachlich erklären und gegebenenfalls Alternative prüfen | +| Eingang unklar | Nachricht ist nicht sicher einem Vorgang zuzuordnen | Prüfen; keine Bindung oder Aufhebung erfinden | + +Die Ergebnisse sind Vorschläge für Bearbeitungszustände, keine neuen bestehenden Buchungsstatus. Es wird keine allgemeine verborgene „Qualitätspunktzahl“ für Gäste vorgeschlagen. + +## Erneute Prüfung + +Bei Änderung von Termin, Wohnung, Personen, Leistungen, Preis, Vorteilen oder Vertragsfassung sind die betroffenen Ergebnisse erneut zu prüfen. Auch ein veralteter Portalabgleich kann die Freigabe einer Zusage verhindern. Vor Annahme beziehungsweise verbindlicher Bestätigung muss die Belegung aktuell beurteilt werden. + +Eine Vorprüfung hat deshalb Gegenstand, Zeitpunkt und Grundlage. Sie ist keine zeitlich unbegrenzte Zusage. Wird ein Angebot verändert, gilt eine vorherige Freigabe nur weiter, soweit die freigegebenen Inhalte unverändert bleiben. + +## Menschliche Bearbeitung und KI + +KI kann fehlende Angaben benennen, eine Nachricht zusammenfassen, bestätigte Fakten gegenüberstellen und eine Rückfrage entwerfen. Sie soll einen Unsicherheitsgrund nennen und zur zuständigen Person weiterleiten können. + +Vorgeschlagene Grenzen: keine erfundene Ausstattung, keine selbstständige verbindliche Preisabweichung, keine Bonitäts- oder Hintergrundrecherche und keine automatische personenbezogene Ablehnung aus freien Texten. Sachliche Buchungsregeln wie maximale Belegung bleiben nachvollziehbar und getrennt von Mutmaßungen über den Gast. + +Eine Erweiterung um personenbezogene automatische Entscheidungen wäre ein eigener fachlich und rechtlich zu prüfender Auftrag. Die DSGVO enthält besondere Regeln zu bestimmten ausschließlich automatisierten Entscheidungen; aus diesem Entwurf folgt keine Freigabe dafür. [DSGVO, insbesondere Art. 22](https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A32016R0679). + +## Sichtbare Prüfübersicht für die Vermietung + +Vorgeschlagen wird eine kurze Zusammenfassung: Quelle und Verbindlichkeit, gewünschter Aufenthalt, bestätigte Daten, offene Fragen, passender Preis, vorhandener Vorteil, Warnungen zur Belegung und empfohlener nächster Schritt. Zu jedem entscheidenden Befund gehören sachlicher Grund und Herkunft der Information. + +Die Übersicht soll auf einen Blick zeigen, was bereits geprüft wurde und was noch Entscheidung braucht. Eine technische Detailanzeige oder ein umfangreiches Risikoprofil ist dafür nicht nötig. + +## Offene Entscheidungen + +- Welche Angaben werden vor der ersten Preisantwort wirklich benötigt, welche erst vor Vertrag oder Anreise? +- Welche sachlichen Ausnahmen darf die Vermietung freigeben, und welche Regeln sind verbindliche Grenzen? +- Wann entstehen Vormerkungen bei Telefon- und Portalanfragen, und wie werden sie verlängert? +- Welche Aussagen zur Wohnung und zu Zusatzleistungen gelten als freigegebene Wissensgrundlage? +- Ab wann ist die Datenlage eines Kanals zu alt für eine automatische Zusage? +- Welche Ergebnisse erlauben später eine automatische Bearbeitung, und welche bleiben persönlich? + +Zugehörige Entscheidungspunkte: D02, D04, D06 und D12 in [Entscheidungen und Arbeitsplan](Konzept_entscheidungen-und-arbeitsplan.md). diff --git a/docs/architecture/konzept-vermietung/Konzept_workflows.md b/docs/architecture/konzept-vermietung/Konzept_workflows.md new file mode 100644 index 0000000..90b58fb --- /dev/null +++ b/docs/architecture/konzept-vermietung/Konzept_workflows.md @@ -0,0 +1,122 @@ +# Workflows der Vermietung + +Stand: 26.10.2026 · Vorschlag · [Konzeptübersicht](Konzept_README.md) + +Jeder Workflow beschreibt Eingang, Entscheidung, Belegungswirkung, Kommunikation und Ausnahmebehandlung. Die vorhandenen Abläufe stehen in [Vermietung – Bestand](../vermietung.md). Neue Abläufe sind hier Zielkonzept. + +## F1 – Anfrage über die eigene Website + +1. Gast wählt Aufenthalt und Leistungen, sieht den Gesamtpreis und fragt unverbindlich an. +2. Das System prüft die bestehenden harten Buchungsregeln und legt bei Erfolg wie bisher eine Vormerkung an. +3. Der Eingang wird bestätigt; die fachliche Vorprüfung ergänzt offene Wünsche, Kontaktzuordnung und Vertriebsbedingungen. +4. Bei fehlenden entscheidungsrelevanten Angaben entsteht eine konkrete Rückfrage. Ihr Versand verlängert die Vormerkung nicht stillschweigend. +5. Ein passendes Angebot wird vorbereitet, gemäß Automatisierungsregel geprüft und versandt. Es enthält Frist, Leistungen, Preis und Bedingungen. +6. Gastannahme führt nach erneuter Verfügbarkeitsprüfung zur Buchung. Ablehnung oder Ablauf gibt den Zeitraum frei. +7. Nachbetreuung richtet sich anschließend nach dem tatsächlichen Buchungs- und Zahlungsstand. + +**Ausnahmen:** Termin nicht mehr frei, widersprüchliche Angaben, Wunsch außerhalb der zugesagten Ausstattung, Zustellung gescheitert oder Frist während der Bearbeitung abgelaufen. Ergebnis ist eine Bearbeitungsaufgabe mit verständlicher Gastinformation; kein stilles Ersetzen des Termins. + +**Offen:** Soll die automatische Vormerkung langfristig weiter für jede zulässige Websiteanfrage gelten, oder erst nach einer bestimmten Vorprüfung? Die Konzeptphase ändert den heutigen Ablauf nicht. + +## F2 – Telefon, persönliche E-Mail oder Empfehlung + +1. Vermietung nimmt Wunsch und Kontaktdaten auf und kennzeichnet die tatsächliche Quelle. +2. Sie unterscheidet eine neue Anfrage von einer bereits wirksam getroffenen Vereinbarung. +3. Bei Anfrage gelten Preisprüfung, Verfügbarkeit und Angebot wie in F1. Bei bestehender Vereinbarung wird diese nach Prüfung direkt dokumentiert und bestätigt. +4. Telefonisch genannte Wünsche, Preisabweichungen und Zusagen werden ausdrücklich festgehalten. +5. Der Gast erhält die passenden schriftlichen Unterlagen über den vereinbarten Kanal. + +Eine Empfehlung durch einen Stammgast macht die neue Person weder zum identischen Kunden noch zum Teilnehmer des Loyalty-Programms. Werbewünsche und Vorteile werden separat geklärt. + +## F3 – Portal vermittelt eine Anfrage + +1. Eingang dem Portal, Inserat, Vorgang und möglichen Gast zuordnen. +2. Prüfen, ob das Portal eine unverbindliche Frage, eine fristgebundene Buchungsanfrage oder bereits eine verbindliche Buchung meldet. +3. Portalfrist und dort geltende Haltewirkung feststellen. Eine lokale Vormerkung ersetzt keine notwendige Portalentscheidung. +4. Fachliche Vorprüfung durchführen und innerhalb des zulässigen Portalkanals antworten. +5. Angebot, Annahme oder Ablehnung in dem System ausführen, das dafür zuständig ist. Die lokale Akte dokumentiert die Rückmeldung. +6. Die tatsächliche Bestätigung in einen Aufenthalt überführen und genau einmal belegen. + +Ein Portalprozess wird nicht ungeprüft durch das eigene Angebotsformular ersetzt. Weitere Vertragsunterlagen müssen zum bestehenden Vertrag passen und für den Kanal zulässig sein. + +## F4 – Bereits bestätigte Portalbuchung + +1. Belegung so früh wie möglich sichern; noch unvollständige Gast- oder Preisdaten blockieren diese Schutzmaßnahme nicht. +2. Wiederholte E-Mail, Kalendereintrag und spätere Buchungsdaten demselben externen Vorgang zuordnen. +3. Bestätigten Termin, Vertragsquelle, Personenzahl, Leistungen und Zahlungszuständigkeit übernehmen, soweit belegt. +4. Fehlendes zur Aufenthaltsvorbereitung gezielt klären. Bereits bekannte Portalzahlung nicht als offene direkte Überweisung anmahnen. +5. Nur die für dieses Portal freigegebene Begrüßung und Aufenthaltskommunikation auslösen. +6. Änderungen und Stornierung über die zuständige Stelle abgleichen. + +Die Vorprüfung einer bereits verbindlichen Buchung ist eine Prüfung der Abwicklung und offener Sachfragen. Sie macht die Buchung nicht nachträglich zu einer frei ablehnbaren Anfrage. + +**Ausnahme:** Widerspruch zur bestehenden Belegung führt zur sofortigen persönlichen Konfliktbearbeitung. Keine automatische Absage einer bereits verbindlichen Buchung und kein Überschreiben der anderen Belegung. + +## F5 – Wiederkehrer fragt erneut an + +1. Identität ausreichend zuordnen; bei unsicherem Treffer keine früheren Aufenthalte oder Vorteile offenlegen. +2. Bestätigte Präferenzen und offene Servicefälle berücksichtigen. +3. Geeigneten Aufenthalt regulär auf Verfügbarkeit und Preis prüfen. +4. Bereits erworbene und für diesen Buchungsweg zulässige Vorteile anzeigen; Alternative mit regulärem Sonderangebot vergleichen. +5. Vorteil nachvollziehbar vormerken und im Angebot ausweisen. Eine Vormerkung verhindert doppelte Einlösung desselben Vorteils. +6. Bei Annahme verbindlich zuordnen; bei Ablauf, Ablehnung oder Storno gemäß Programmregel freigeben beziehungsweise berichtigen. + +Stammkundenstatus gibt keine Befugnis, andere Buchungen zu verdrängen oder verbindliche Mindestregeln zu umgehen. Eine individuelle Kulanz ist eine begründete Entscheidung innerhalb festgelegter Grenzen. + +## F6 – Termin ist nicht verfügbar: Alternative oder Warteliste + +1. Den nicht erfüllbaren Wunsch sachlich erklären. +2. Auf Wunsch andere Zeiträume oder eigene geeignete Wohnungen prüfen. Andere Mandanten erhalten dabei keine Kundendaten. +3. Alternativen mit eigenem Gesamtpreis und klarer Gültigkeit darstellen. +4. Optional einen Suchwunsch mit Zeitraum, Flexibilität und Kontaktwunsch für frei werdende Termine führen. +5. Bei passender Lücke Kontaktberechtigung und aktuelle Verfügbarkeit erneut prüfen; ein Hinweis ist noch keine feste Buchungszusage. +6. Suchwunsch bei Ablauf, Widerruf oder erfolgreicher Buchung beenden. + +**Offen:** Dürfen mehrere Interessenten gleichzeitig informiert werden, und nach welchem nachvollziehbaren Verfahren wird vergeben? Eine Priorität für Loyalty-Mitglieder muss vorher transparent festgelegt sein. + +## F7 – Änderung einer Anfrage oder Buchung + +Vor Vertragsschluss entsteht bei wesentlicher Änderung eine neue Angebotsfassung. Termin, Preis und Vorteil werden erneut geprüft; die alte Fassung wird nicht nebenher weiter zur Annahme angeboten. + +Nach Vertragsschluss ist die Änderung zunächst ein Wunsch. Die ursprüngliche Vereinbarung gilt weiter, bis eine neue Vereinbarung beziehungsweise Portaländerung bestätigt ist. Neue Nächte können befristet gehalten werden; alte Nächte werden erst bei geklärter Übernahme freigegeben. Preisunterschied, Zahlung, Leistungen und Loyalty-Auswirkung werden transparent gemacht. + +Bei Fehler oder ausbleibender Zustimmung darf keine unbeabsichtigte Lücke und keine doppelte verbindliche Belegung entstehen. Umbuchungen zwischen Wohnungen brauchen zusätzlich die Bestätigung der betroffenen Leistung und der betrieblichen Verfügbarkeit. + +## F8 – Zahlung, Anreise und Aufenthalt + +1. Zahlungszuständigkeit bestimmen: eigene Überweisung, Portalinkasso oder andere bestätigte Abwicklung. +2. Fällige Aufgaben nur für tatsächlich offene Beträge und den richtigen Empfänger auslösen. +3. Vor Anreise fehlende praktische Angaben und Sonderwünsche klären. +4. Bestätigte Anreiseinformationen zum richtigen Zeitpunkt versenden. Zugangsdaten nur an geeignete Empfänger weitergeben. +5. Während des Aufenthalts Fragen und Probleme einem zuständigen Menschen zuordnen. Dringlichkeit und Erreichbarkeit unterscheiden. +6. Gewünschte Zusatzleistungen oder Kulanz nur innerhalb bestätigter Preise und Verfügbarkeit zusagen. + +Eine Reklamation pausiert unpassende Werbe- und Bewertungsfolgen. Notwendige Vertrags- und Servicekommunikation bleibt möglich; bestehende Loyalty-Ansprüche werden dadurch nicht automatisch entzogen. + +## F9 – Storno, Nichtanreise, Erstattung und Wiedervermietung + +1. Eingang und Zuständigkeit feststellen; bei Portalbuchung maßgeblichen Portalstatus prüfen. +2. Prüfen, was bereits verbindlich aufgehoben wurde und was lediglich ein Erstattungs- oder Änderungswunsch ist. +3. Freigabe der Nächte nach dem wirksamen Stand veranlassen und an die Kanäle weitergeben. +4. Finanzielle Folgen anhand der vereinbarten Regeln feststellen; strittige Fälle persönlich bearbeiten. +5. Zahlungseingänge, Erstattungsentscheidung und tatsächlich ausgeführte Erstattung getrennt nachhalten. +6. Vorgemerkte oder erworbene Vorteile nach der freigegebenen Loyalty-Regel berichtigen. +7. Wieder freie Termine bei geeigneten Interessenten oder Kampagnen berücksichtigen. + +Eine Nichtanreise ist kein automatisch erfüllter Aufenthalt. Auch bei einbehaltenem Betrag ist eigens festzulegen, ob ein Loyalty-Anspruch entsteht. Eine Erstattung wird nicht allein durch einen Textentwurf als ausgeführt markiert. + +## F10 – Nachbetreuung, Kundenbindung und nächste Reise + +1. Tatsächlichen Abschluss und offenen Klärungsbedarf feststellen. +2. Passenden Dank beziehungsweise Servicekontakt vorsehen; anlassbezogene Werbeanteile gesondert beurteilen. +3. Nur den für den Kanal zulässigen Bewertungsweg anbieten. Eine Bewertung und ihr Ergebnis sind keine Voraussetzung für einen regulären Loyalty-Vorteil. +4. Qualifizierenden Aufenthalt genau einmal für das Programm berücksichtigen. +5. Zulässige persönliche Präferenzen aktualisieren; keine Vorlieben aus unbestätigten Annahmen erzeugen. +6. Einen späteren Wiederbuchungsanlass nur bei passendem Kontaktwunsch, Kanal und aktueller Verfügbarkeit vorbereiten. +7. Bei Antwort oder neuer Buchung geplante Nachfassaktionen neu bewerten und gegebenenfalls beenden. + +## Gemeinsame Bearbeitungsregeln + +Jeder Vorgang hat einen Verantwortlichen, einen nächsten Schritt und gegebenenfalls eine echte Frist mit Eskalation. Reaktionsziele müssen zu den betreuten Zeiten passen. Portalfristen haben Vorrang vor frei geplanten Erinnerungsintervallen. + +Für alle Workflows ist festzulegen: Welche Information gilt als belegt, welche Entscheidung ist bindend, wer darf sie treffen und welche Nachricht folgt daraus? Die konkrete Automatisierungstiefe steht in [Automatisierung](Konzept_automatisierung.md); durchgängige Prüffälle in [Szenarien](Konzept_szenarien.md). diff --git a/docs/architecture/planung-und-offene-punkte.md b/docs/architecture/planung-und-offene-punkte.md new file mode 100644 index 0000000..88859ff --- /dev/null +++ b/docs/architecture/planung-und-offene-punkte.md @@ -0,0 +1,93 @@ +# Planung und offene Punkte + +Stand: 26.10.2026 · [Übersicht](README.md) + +Diese Übersicht führt fehlende fachliche Funktionen, Ausbauoptionen und Voraussetzungen für den echten Betrieb zusammen. Sie enthält keine neuen Termin- oder Umsetzungszusagen. Details und vorhandene Teilfunktionen stehen in den verlinkten Bereichsdateien. + +## Vorhandene Funktionen in Betrieb nehmen + +Hier fehlt überwiegend Einrichtung, Erprobung oder Inhalt; die Punkte sind keine pauschal noch ungebauten Anwendungsfunktionen. + +| Punkt | Was fehlt | Bereich | +|---|---|---| +| Hintergrundbetrieb | Seit 27.10. über n8n aktiv; Kalenderimport praktisch nachgewiesen. Fristen, Erinnerungen und Sicherungen weiterhin je Ablauf praktisch prüfen | [System](system-und-datenschutz.md) | +| E-Mail-Zustellung | Tatsächlichen Versandweg einrichten und im Testbetrieb prüfen | [System](system-und-datenschutz.md) | +| Vermieter-Arbeitsplatz | Vorgesehenes Verwaltungskonto einrichten und Anfrage → Angebot → Annahme praktisch erproben | [Verwaltung](vermieter-verwaltung.md) | +| Betriebsdaten | Bankverbindung, gewünschte Kontaktadressen und Benachrichtigungsempfänger vervollständigen | [Verwaltung](vermieter-verwaltung.md) | +| Vermietungsregeln | Preise der Folgejahre, typischen Anreisetag und Mindestaufenthaltsausnahmen bestätigen | [Preise](preise-und-angebote.md) | +| Rechtliche Inhalte | Impressum, Datenschutz, Mietbedingungen, Stornoregeln und Texte der Gastannahme freigeben und einpflegen | [Vermietung](vermietung.md) | +| Portal-Erkennung | Echte Buchungs- und Stornomails der tatsächlich genutzten Portale erproben | [Portale](portale-und-belegung.md) | +| Öffentlicher Start | Produktionsumgebung, sichere Adressen, Umleitungen alter WordPress-Adressen und echte Testbuchungen vorbereiten | [System](system-und-datenschutz.md) | +| Weitere Mandanten | Adressen vollständig zuordnen, Ersteinrichtung und Sperre unter eigener Domain erproben, Vertragsgrundlagen klären | [Betreiber](betreiberfunktionen.md) | + +## Geplante fachliche Erweiterungen + +| Funktion | Ziel | Abhängigkeit und heutige Grenze | +|---|---|---| +| Verbindliche Direktbuchung | Aufenthalt auf der Website sofort verbindlich buchen | Bisher Anfrage und Angebot; verlässliche Synchronisation ist Voraussetzung | +| Stornoformular für Gäste | Stornierung über einen geschützten Gastweg ermöglichen | Bisher nur Stornierung durch die Verwaltung, ohne automatische Gastnachricht | +| Vollständige Portalbuchungen | Gäste, Preise, Zahlungen und Herkunft auch für Portalgäste zentral führen | Zentrale Belegungsübersicht und persönliche Gastzuordnung seit 27.10. vorhanden; belastbare Preis-, Zahlungs- und Vertragsdaten werden aus iCal weiterhin nicht abgeleitet | +| KI-Angebotsentwürfe | Individuelle Angebote vorbereiten | Kein aktiver KI-Aufruf; zunächst menschliche Prüfung und Freigabe vorgesehen | +| KI-Vermarktungsassistent | Saisonale Inhalte, Aktionen und Marketing unterstützen | Bisher nur als künftiger Dienst vorgesehen | +| KI-Gästekommunikation | Gastnachrichten unterstützen, perspektivisch mehrsprachig | Bisher nur als künftiger Dienst vorgesehen | +| Tipps der Gastgeberin | Persönliche lokale Empfehlungen strukturiert pflegen und saisonal zeigen | Neuer Inhaltsbereich und Baustein fehlen | +| Gut zu wissen | Wohnungsregeln und praktische Informationen wiederverwendbar pflegen | Bisher keine vollständige strukturierte Erfassung samt eigenem Baustein | +| Belegungs- und Preiskalender | Freie Nächte und Preise als Monatsansicht ansehen | Belegungs- und Preislogik vorhanden, Darstellung fehlt | +| Wohnungsübersicht und Suche | Mehrere Wohnungen derselben Website gemeinsam anbieten | Auswahl pro Baustein vorhanden; neue Übersicht und gemeinsame Suche sind separater Ausbau | +| Theme-Optionen | Vordefinierte Gestaltungsentscheidungen im Admin auswählen | Bisher kein allgemeiner Optionskatalog für solche Schalter | +| Bausteinvarianten | Unterschiedliche Darstellungen desselben Inhalts auswählen | Bisher kein allgemeiner Variantenkatalog je Theme | +| Bildmenüs | Seiten mit eigenem Menübild und Kurztext präsentieren | Datenpflege und geplante Darstellung fehlen | + +Bereichsdetails: [Vermietung](vermietung.md), [Portale](portale-und-belegung.md), [Webseite](webseite.md), [Gäste und Kommunikation](gaeste-und-kommunikation.md). + +## Teilweise vorbereitet oder noch abzugleichen + +| Thema | Vorhanden | Noch fehlend | +|---|---|---| +| Dienstverbrauch | Datengrundlage für Zuordnung zu Mandant und Dienst | Tatsächliche Messung, Auswertung und gegebenenfalls Abrechnung | +| Eigene KI-Zugänge | Vorgesehene Grundlage | Fertige Einrichtung, aktive Nutzung und zugehöriger KI-Dienst | +| Absolute Mindestnächtezahl | Kalenderbezogene Ausnahmen prüfen die Untergrenze | Sonderangebote umgehen sie im aktuellen Ablauf; fachliche Vorgabe und Verhalten angleichen | +| Datenlöschung | Kontaktanonymisierung, Bereinigung von Nachrichten, Portal-Auszügen und Herkunftsangaben | Vollständiger Umgang mit Dokumenten, Freitexten und weiteren Nachweisen sowie bestätigte Fristen | +| Suchmaschinenangaben für weitere Orte | Grundlegende Wohnungsdaten und Seitenmetadaten | Vollständige Verallgemeinerung bislang festgelegter Ortsangaben | +| Kommunikation dokumentieren | Geschäftsvorgänge, Versandzeitpunkte, Vertragsdateien und Portal-Mailhinweise | Keine lückenlose gemeinsame Ablage sämtlicher Gastnachrichten | + +## Spätere Optionen und Analysevorschläge + +Diese Punkte sind in den Unterlagen diskutiert, aber nicht als vollständig beauftragter Ausbau festgelegt. + +| Option | Fachliche Bedeutung | +|---|---| +| Stornokosten und Erstattungen | Regeln berechnen, Entscheidung bestätigen und Erstattung mit Beleg bearbeiten | +| Dokumentenarchiv, Rechnungen und Belege | Unterlagen zu Buchungen einschließlich Portalabrechnungen geordnet und mit Fristen führen | +| Umfassende Änderungsnachweise | Fachliche Änderungen und sensible Bearbeitungen nachvollziehen | +| Gästedubletten zusammenführen | Mehrere Kontakte nach menschlicher Prüfung kontrolliert verbinden | +| Zentrale Nachrichtenablage | Ein- und ausgehende Kommunikation einem Gast und Aufenthalt zuordnen | +| Bankimport | Zahlungseingänge anhand von Bankdateien zuordnen | +| Online-Zahlung | Zahlungsanbieter für unmittelbare Zahlung integrieren | +| Gästebereich | Buchung und Anreiseinformationen selbst einsehen | +| Channel-Manager oder autorisierte Portal-Anbindung | Belegung und gegebenenfalls Buchungsdetails zeitnäher austauschen | +| Externe Portalautomatisierung | Sperraufgaben außerhalb des Systems ausführen und Erledigung zurückmelden | +| Unabhängige Betriebsüberwachung | Ausfälle auch dann melden, wenn die Anwendung ihre eigenen Prüfungen nicht mehr ausführt | +| Newsletter und Social Media | Kampagnen erstellen, versenden beziehungsweise veröffentlichen und ihren Erfolg auswerten | +| Erweiterte Auswertungen | Umsätze, Quellen und Wirtschaftlichkeit über die vorhandenen Verwaltungszahlen hinaus vergleichen | +| Weitere Benutzerrollen | Reinigung, Hausmeister oder Steuerberatung gezielt einbinden | +| Tarife und Abonnements | Leistungen für Mandanten buchen, ändern und abrechnen | +| Weitere Sprachen | Website, Angebot, Vertrag und Kommunikation durchgängig übersetzen | +| Erzählstrecke, Video, Wetter | Zusätzliche Erlebnis- und Informationsbausteine der Website | +| Wachstum der Betriebsumgebung | Bei Bedarf auf eine leistungsfähigere Hostingumgebung wechseln | + +Einzelne frühere Analysevorschläge, etwa neue Stornozustände, eine umfassende Belegverwaltung oder eine automatisierte Gästemeldung, sind noch keine verbindlichen Produktentscheidungen. + +## Fachliche Entscheidungen und Freigaben + +- **Kurabgabe und Meldeschein:** Die Kurabgabe liegt für Stommer beim Ferienservice Balu vor Ort. Ob dieser auch den Meldeschein übernimmt, ist offen. Eine frühere feratel-Empfehlung ist keine beschlossene Systemerweiterung. +- **Rechtstexte und Aufbewahrung:** Muster und Vorschlagsfristen brauchen fachliche Freigabe. Das gilt auch für Vertrags- und Annahmetexte. +- **Weitere Vermieter:** Nutzungsbedingungen, Auftragsverarbeitung und Unterauftragnehmer klären; Domain- und Zertifikatsbetrieb praktisch absichern. +- **KI-Dienste:** Leistungsumfang, Datenverwendung, Zugänge, Verbrauchsgrenzen und Freigabe der erzeugten Inhalte vor Einführung festlegen. +- **Synchronisation:** Vor Direktbuchung oder einer neuen Portal-Anbindung festlegen, welches System die Belegung führt und welche Verzögerungen akzeptabel sind. + +## Bereits gebaut und nicht erneut als fehlend einzuplanen + +Der aktuelle Bestand umfasst ausdrücklich den Angebotsversand mit Gastannahme, den interaktiven Grundriss, die getrennte Verarbeitung aktiver Mandanten, eigene Portal-Postfächer, Mandantenexport und -löschung sowie die Wohnungswahl pro Webseitenbaustein. Auch die Verwendung der Website-Marke und der Bildwelten in beiden Themes und den Kommunikationsvorlagen ist laut [Projektstand](../STATUS.md) inzwischen auf dem Testsystem ausgeliefert. Ältere Zwischenstände in den Ausgangsdokumenten dürfen diese Funktionen nicht wieder auf „ungeplant“ oder „noch nicht gebaut“ zurücksetzen. + +Quellen: [Projektstand](../STATUS.md), [Konzept](../KONZEPT.md), [Mandantenplan](../MANDANTEN-PLAN.md), [Designkonzept](../DESIGN-KONZEPT.md), [Zusammenarbeit](../ZUSAMMENARBEIT.md). Analysevorschläge: [Buchungsprozess](../BUCHUNGSPROZESS.md) und [Datenmodell-Konzept](../DATENMODELL-KONZEPT.md). diff --git a/docs/architecture/portale-und-belegung.md b/docs/architecture/portale-und-belegung.md new file mode 100644 index 0000000..2fe07e0 --- /dev/null +++ b/docs/architecture/portale-und-belegung.md @@ -0,0 +1,77 @@ +# Portale und Belegung + +Stand: 26.10.2026 · [Übersicht](README.md) + +**Fortschreibung vom 29.10.2026:** Die [generische iCal-Kanalkonfiguration](ical-kanalkonfiguration.md) wurde am 27.10. bereitgestellt und erweitert den hier beschriebenen Ausgangsstand um getrennte Richtungen, Test-/Regulärmodus, sichere Pause und strengere Bestandsprüfung. Ebenfalls bereitgestellt sind die zentrale Belegungsverwaltung, persönliche Gastzuordnung sowie Zweck und Privat-Kennzeichnung für Sperrzeiten. Für das geänderte Verhalten gilt die dortige Beschreibung; insbesondere werden Mail- und Kalender-Sperren nur bei gemeinsamer Kennung zusammengeführt und fehlende Ereignisse nicht sofort gelöscht. + +Das System führt die zentrale Belegung aus eigenen Aufenthalten, Vormerkungen, manuellen Sperren und importierten Portalbelegungen zusammen. Ziel ist, denselben Zeitraum nicht mehrfach zu vergeben und nötige Nacharbeiten sichtbar zu machen. + +## Umgesetzte Funktionen + +### Verfügbarkeit und Sperrzeiten + +Eine Nacht ist nicht verfügbar, wenn sie durch eine gültige Vormerkung, eine bestätigte Buchung oder eine Sperrzeit belegt ist. Sperrzeiten können etwa Eigennutzung, Wartung oder externe Belegung abbilden. An- und Abreise am selben Tag sind möglich, da der Abreisetag keine weitere Aufenthaltsnacht belegt. + +Verfügbarkeit wird bei Anfrage, Angebot und Bestätigung geprüft. Abgelaufene Vormerkungen blockieren unabhängig vom Zeitpunkt des nächsten automatischen Laufs nicht mehr. Freie Lücken zwischen Belegungen können für Mindestaufenthaltsausnahmen und Lückenfüller-Angebote ausgewertet werden. + +Seit dem 27.10. steht zusätzlich ein grafischer Belegungsplan in der Verwaltung bereit, mit freien Nächten, Wechseln und Details zu Buchungen, Sperrzeiten und ungeklärten Belegungen. Öffentliche Verfügbarkeitsanzeigen und dieser interne Plan haben unterschiedliche Aufgaben; Umfang und Bedienung stehen in der [zentralen Belegungsverwaltung](ical-kanalkonfiguration.md#zentrale-belegungsverwaltung). + +### Portale je Wohnung einrichten + +Die Verwaltung kann Portale mit passender Anbindung, Kalenderadresse, Aktivität, bekannten Mailabsendern und gegebenenfalls einem Link zum externen Vermieterkalender pflegen. Das Anbindungsmodell ist erweiterbar: Portale werden über austauschbare Anbindungen integriert. + +Vorhanden ist der allgemeine iCal-Kalenderabgleich. Ein weiterer Kalenderkanal kann damit über die Verwaltung eingerichtet werden, sofern das Portal diesen Weg unterstützt. Eine portalspezifische Übertragung von Preisen, Nachrichten oder vollständigen Buchungsdaten ist damit noch nicht verbunden. + +### Kalender einlesen und bereitstellen + +| Richtung | Funktion | +|---|---| +| Portal zum System | Externe Belegungen als zugeordnete Sperrzeiten übernehmen und beim weiteren Abgleich aktualisieren | +| System zum Portal | Eigenen Kalender je Kanal zum Abruf bereitstellen | +| Vermeidung von Rückkopplungen | Im Kalender für ein Portal dessen eigene importierte Sperren auslassen | + +Abgleiche lassen sich manuell anstoßen und werden protokolliert. Der automatische Abruf ist alle fünf Minuten vorgesehen und im Aufgabenplan hinterlegt. Die tatsächliche Aktivität hängt von der Einrichtung des Hintergrundbetriebs ab. + +iCal überträgt Belegungen mit Verzögerung. Die Zeit bis zur Übernahme in einem anderen Portal hängt auch davon ab, wann dieses den eigenen Kalender abholt. Das System bietet daher keine garantierte Echtzeitsperrung in allen Portalen. + +### Portal-E-Mails als schneller Weg + +Das eigene Portal-Postfach eines Mandanten kann Buchungs-, Storno- und Anfragemails einlesen. Bekannte Absender werden dem Kanal zugeordnet; erkannte Termine und Referenzen helfen bei der Verarbeitung. Der automatische Postfachabruf ist minütlich vorgesehen. Alternativ können berechtigte externe Automatisierungen Portal-Mails übergeben. + +Sicher erkannte Buchungen erzeugen sofort eine Sperrzeit aus der E-Mail. Der spätere Kalenderabgleich kann diese bestätigen oder ersetzen. Eine reine Mail-Sperre wird nicht allein deshalb entfernt, weil sie im Kalenderabruf noch fehlt. Erkannte Stornierungen können zugehörige Mail-Sperren wieder freigeben. + +Unsicher erkannte Nachrichten erscheinen als „Bitte prüfen“ und lösen einen internen Hinweis aus. Die Verwaltung kann daraus manuell eine Sperre anlegen. Die Erkennung ist vorhanden, muss aber noch mit echten Nachrichten der genutzten Portale weiter erprobt werden. + +### Aufgaben für manuelle Portalpflege + +Für Portale, die zusätzlich von Hand gepflegt werden sollen, entstehen Aufgaben zum Sperren oder Freigeben von Zeiträumen. Auslöser sind unter anderem bestätigte oder stornierte Buchungen, Sperrzeiten und Belegungen anderer Kanäle. + +Die Aufgabe enthält den Zeitraum und den hinterlegten Einstieg in den Portalkalender. Nach der Bearbeitung wird sie als erledigt markiert. E-Mail-Hinweise und Erinnerungen unterstützen die Nachverfolgung. Eine vorbereitete Übergabe an externe Automatisierung mit Erledigungsrückmeldung ist ebenfalls vorhanden; ein tatsächlich angebundener Portal-Bot gehört nicht zum nachgewiesenen Funktionsumfang. + +### Konflikte und Störungen erkennen + +Neue externe Belegungen werden auf Überschneidungen geprüft. Konflikte lösen Warnungen aus. Fehlgeschlagene oder zu lange ausstehende Abgleiche und Postfachstörungen werden gemeldet. Offene Aufgaben und Kanäle mit Problemen erscheinen in der Verwaltung. + +Ein geschützter Zustandsabruf ermöglicht die Einbindung einer externen Überwachung. Die externe Überwachung selbst ist noch eine Option. Auch die eingebauten Prüfungen benötigen den eingerichteten regelmäßigen Hintergrundlauf. + +## Grenzen des vorhandenen Portalmodells + +Portalbuchungen sind derzeit im Wesentlichen Sperrzeiten und zugehörige Mailhinweise. Das System führt daraus noch keine vollständige eigene Buchung mit Gast, Preis, Gebühren, Portalabrechnung und Zahlung. iCal liefert diese Daten nicht zuverlässig mit. + +Eine unbekannte Angabe darf nicht als vorhandene Gast- oder Zahlungsinformation behandelt werden. Die spätere Übernahme vollständiger Buchungen muss nachweisbare Datenquellen verwenden. + +## Geplante Erweiterungen und Optionen + +| Erweiterung | Stand | Abhängigkeit | +|---|---|---| +| Portalbuchungen als vollständige Buchungen | Geplant | Daten aus belastbaren Mails oder autorisierten Schnittstellen; fachlicher Umfang noch zu bestätigen | +| Verbindung zu einem Channel-Manager | Option | Passende Portalabdeckung, tatsächliche Synchronisationsleistung und klare Führung der Belegung | +| Direkte Portal-Schnittstellen | Option | Verfügbare autorisierte Anbindung; bisher kein fertiger spezifischer Anschluss | +| Verbindliche Website-Direktbuchung | Geplant | Ausreichend verlässliche zeitnahe Synchronisation vorausgesetzt | +| Unabhängiger Betriebswächter | Option | Externen Zustandsabruf regelmäßig prüfen und unabhängig alarmieren | +| Automatisierte Bearbeitung externer Portalkalender | Option | Zulässigkeit und Zuverlässigkeit je Portal klären; derzeit nur Übergabemöglichkeit vorhanden | +| Gästemeldung oder feratel-Anbindung | Offene Option | Im älteren Portalpapier vorgeschlagen; spätere Projektentscheidung sieht Kurabgabe bei Balu vor, Meldeschein-Zuständigkeit ist offen | + +Die aktuelle Dokumentation trifft keine neue Anbieterwahl und übernimmt keine früher recherchierten Preise oder Leistungszusagen als heutige Zusicherung. + +Quellen: [Konzept](../KONZEPT.md), [Portal-Analyse](../PORTALE.md), [Projektstand](../STATUS.md), [Datenmodell-Entwurf](../DATENMODELL-KONZEPT.md). Funktionsabgleich: Belegungsprüfung, Kanalabgleich, Portal-Mails und Portal-Aufgaben. diff --git a/docs/architecture/preise-und-angebote.md b/docs/architecture/preise-und-angebote.md new file mode 100644 index 0000000..6f54ebf --- /dev/null +++ b/docs/architecture/preise-und-angebote.md @@ -0,0 +1,81 @@ +# Preise und Angebote + +Stand: 26.10.2026 · [Übersicht](README.md) + +Die Preisberechnung bildet den vollständigen Aufenthalt ab. Sie wird bei der Anfrage und bei der Erstellung eines individuellen Angebots genutzt. Sonderangebote und individuell versendete Angebote an Gäste sind zwei verschiedene fachliche Dinge. + +## Umgesetzte Funktionen + +### Saisonpreise und Jahrespflege + +Je Wohnung werden Saisons mit Beginn, Ende, Übernachtungspreis und Mindestnächten gepflegt. Der Beginn gehört zur Saison, der Endtag zur folgenden Saison. Ein Aufenthalt über einen Saisonwechsel wird nach den tatsächlich in jeder Saison liegenden Nächten berechnet. + +Fehlt für eine Nacht ein Preis, wird kein scheinbar vollständiger Gesamtpreis angeboten. Unzulässige Zeiträume und Personenzahlen werden ebenfalls zurückgewiesen. Saisonüberschneidungen werden bei der Pflege geprüft. + +Saisons lassen sich in ein Folgejahr kopieren. Optional kann der Saisonbeginn an einem Wochentag ausgerichtet werden, damit beispielsweise Ferienwochen wieder samstags beginnen und aneinandergrenzende Zeiträume zusammenpassen. + +### Preisbestandteile + +| Bestandteil | Regel | +|---|---| +| Übernachtung | Summe der Nachtpreise aus den betroffenen Saisons | +| Sonderangebotsrabatt | Abzug auf den Übernachtungspreis | +| Zusätzliche Personen | Zuschlag je zusätzlicher Person und Nacht oberhalb der enthaltenen Personenzahl | +| Endreinigung und Service | Einmaliger Pflichtbetrag je Aufenthalt, soweit hinterlegt | +| Freiwillige Extras | Gewählte Menge, je Aufenthalt oder je Nacht berechnet | +| Individuelle Preisanpassung | Bezeichneter Zu- oder Abschlag bei der Angebotserstellung | + +Typische Extras sind Bettwäsche und Handtücher. Pflichtkosten werden im Gesamtpreis berücksichtigt. Die Darstellung kann die erste Nacht einschließlich Endreinigung hervorheben oder die Kosten getrennt ausweisen; die zugrunde liegende Berechnung bleibt gleich. + +Anzahlung, Restbetrag und Restzahlungsdatum werden mitberechnet. Die Anzahlung ist ein Anteil der Miete einschließlich Zusatzpersonenkosten und etwaiger Mietnachlässe; Endreinigung und freiwillige Extras gehören nicht zur Anzahlungsbasis. Geldbeträge werden centgenau geführt. + +Die Kurabgabe wird derzeit nicht berechnet oder eingezogen. Bei Stommer übernimmt sie nach der Projektentscheidung der Ferienservice Balu vor Ort; die Website und Vertragsinformationen können darauf hinweisen. + +### Mindestaufenthalt und Ausnahmen + +Maßgeblich ist zunächst die Mindestnächtezahl der Saison am Anreisetag. Je Wohnung können kürzere Aufenthalte für bestimmte Fälle zugelassen werden: + +- Der Aufenthalt füllt eine freie Kalenderlücke vollständig. +- Die Abreise liegt am eingestellten typischen Anreisetag, sodass der Anschlusszeitraum vermietbar bleibt. +- Ein passendes Sonderangebot hebt den saisonalen Mindestaufenthalt auf. + +Für die beiden kalenderbezogenen Ausnahmen wird die absolute Untergrenze der Wohnung berücksichtigt. **Offene Abweichung:** Die fachliche Projektvorgabe verlangt diese Untergrenze für alle Ausnahmen. Im aktuellen Rechenablauf kann ein Sonderangebot den Mindestaufenthalt jedoch bereits vor dieser Prüfung aufheben. Die durchgängige Einhaltung der absoluten Untergrenze ist deshalb noch zu klären beziehungsweise zu korrigieren; diese Dokumentation ändert die Berechnung nicht. + +### Sonderangebote verwalten + +| Angebotsart | Zweck | +|---|---| +| Rabattaktion | Regelbasierter Vorteil, etwa Last Minute, Frühbucher oder Stammgastcode | +| Fester Termin | Genau festgelegte An- und Abreise, auch mit Pauschalpreis für die Nächte | +| Lückenfüller | Automatisch erkannte freie Lücke bis zu einer festgelegten Länge vermarkten | + +Mögliche Vorteile sind prozentualer Rabatt, fester Rabatt pro Aufenthalt, Sonderpreis pro Nacht und kostenlose günstigste Nächte, beispielsweise „7 Nächte bleiben, 6 bezahlen“. + +Die Gültigkeit lässt sich unter anderem nach Saison der Anreise, Vorlauf bis zur Anreise, Aufenthaltsdauer, Anreise-Wochentag, Aufenthaltszeitraum, Buchungszeitraum und Aktionscode begrenzen. Angebote können aktiv oder inaktiv, öffentlich oder nur mit Code nutzbar, priorisiert und hervorgehoben sein. Verwaltungsvorlagen erleichtern typische Aktionen. + +Passen mehrere Angebote, erhält der Gast die günstigere berechnete Variante: das beste nicht kombinierbare Einzelangebot oder die Summe der kombinierbaren Angebote. Automatische Rabatte reduzieren die Übernachtungskosten, nicht Endreinigung oder Extras. Der rabattierte Übernachtungsbetrag wird nicht negativ. + +### Angebote auf der Webseite bewerben + +Die öffentliche Bewerbung erfolgt unabhängig vom saisonalen Erscheinungsbild: + +- Angezeigt werden aktive öffentliche Angebote ohne benötigten Aktionscode innerhalb ihres Buchungszeitraums. +- Feste Termine werden nur beworben, solange sie frei sind. +- Lückenfüller zeigen bis zu drei konkrete freie Lücken. +- Konkrete Termine werden mit derselben Preisberechnung kalkuliert wie die spätere Anfrage. +- Hervorhebung, Priorität und Termin bestimmen die Reihenfolge. +- Angebote lassen sich nebeneinander, als Liste oder wechselnd zeigen. Ein hervorgehobenes Angebot kann zusätzlich im Titelbereich erscheinen. +- Der Einstieg in die Anfrage übernimmt die passenden Termindaten. + +Der Preis eines konkreten beworbenen Aufenthalts bezieht sich auf die dabei angesetzten Personen und Leistungen. Änderungen an der Anfrage können zu einem anderen Gesamtpreis führen. + +## Geplant und noch offen + +- **Offen:** Preise für kommende Jahre vollständig pflegen und fachlich bestätigen. +- **Offen:** typischen Anreisetag und gewünschte Ausnahmen je Wohnung festlegen. +- **Offen:** die oben beschriebene Abweichung bei der absoluten Untergrenze von Sonderangeboten auflösen. +- **Geplant:** ein öffentlich sichtbarer Belegungs- und Preiskalender. Der Rechner und die Preisansicht sind vorhanden; eine entsprechende Monatsansicht ist noch nicht gebaut. +- **Option:** zusätzliche feste An- oder Abreisetagsregeln aus dem ursprünglichen Konzept. Der vorhandene typische Anreisetag dient bisher insbesondere der Mindestaufenthaltsausnahme. +- **Option:** Preise an externe Portale übertragen. Der vorhandene Kalenderabgleich übermittelt bisher keine Preise. + +Quellen: [Konzept](../KONZEPT.md), [Projektstand](../STATUS.md). Funktionsabgleich: aktuelle Preisberechnung, Preisaufschlüsselung, Sonderangebote und Angebotsbewerbung der Anwendung. diff --git a/docs/architecture/system-und-datenschutz.md b/docs/architecture/system-und-datenschutz.md new file mode 100644 index 0000000..6fa61be --- /dev/null +++ b/docs/architecture/system-und-datenschutz.md @@ -0,0 +1,94 @@ +# System und Datenschutz + +Stand: 26.10.2026 · [Übersicht](README.md) + +Diese Ebene sichert den gemeinsamen Betrieb der Websites und Vermietungsabläufe. Sie beschreibt fachliche Betriebsleistungen und Schutzfunktionen; Zugänge und technische Einrichtung bleiben Gegenstand der Betriebsdokumentation. + +## Umgesetzte Funktionen + +### Mandanten getrennt betreiben + +Websites, Wohnungen, Gäste, Buchungen, Zahlungen, Inhalte und Portaldaten werden dem jeweiligen Vermieter zugeordnet. Öffentliche Seiten und geschützte Gastlinks arbeiten mit der passenden Website. Die Adresse bestimmt, welcher öffentliche Auftritt und welcher Mandant gemeint sind. + +Hintergrundaufgaben laufen getrennt für aktive Mandanten und verwenden deren Einstellungen und Absender. Der Fehler eines Mandanten soll die Bearbeitung der anderen nicht verhindern. Die Datensicherung betrifft dagegen die gemeinsame Datenbank als Ganzes. + +Ein Benutzer darf nur die Mandanten bearbeiten, zu denen er gehört; der Betreiber besitzt gesonderte übergreifende Verwaltungsrechte. Sperrt der Betreiber einen Mandanten, wird dessen öffentlicher Auftritt vorübergehend durch einen Hinweis ersetzt. + +### Regelmäßige Aufgaben + +| Aufgabe | Vorgesehener Takt | Fachliches Ergebnis | +|---|---|---| +| Vormerkungen und Angebote prüfen | Alle fünf Minuten | Abgelaufene Vorgänge kennzeichnen und intern melden | +| Portalkalender abgleichen | Alle fünf Minuten | Externe Belegungen aktualisieren | +| Portal-Postfach lesen | Jede Minute | Buchungen möglichst früh erkennen | +| Portalzustand überwachen | Alle 15 Minuten | Fehlende oder überalterte Abgleiche melden | +| Portalaufgaben nachverfolgen | Alle 15 Minuten prüfen | Bei entsprechend überfälligen Aufgaben erinnern | +| Zahlungen und Aufenthalte begleiten | Täglich | Zahlungshinweise, Anreiseinformationen und Abschluss bezahlter Aufenthalte | +| Bewertungen anfragen | Täglich | Nach passenden abgeschlossenen Aufenthalten einladen | +| Datenfristen anwenden | Täglich | Gäste anonymisieren und entbehrliche Zusatzdaten bereinigen | +| Datenbank sichern | Täglich | Wiederherstellungsgrundlage erzeugen | + +Diese Funktionen und ihre Zeitpläne sind vorhanden. Zum Ausgangsstand vom 26.10. war der regelmäßige Aufruf noch nicht eingerichtet. **Seit dem 27.10. ist der externe n8n-Scheduler veröffentlicht und ruft die Aufgabensteuerung minütlich auf.** Automatische Kalenderimporte im Fünf-Minuten-Takt sind praktisch nachgewiesen, erneut nach der Wiederherstellung am 28.10. Die Ausführung und Wirkung jeder anderen Aufgabe ist gesondert zu bewerten; insbesondere ist damit keine echte E-Mail-Zustellung belegt. [Aktueller Betriebsnachweis](../BETRIEB.md#automatische-zeitsteuerung-n8n). + +Für die Kalenderfreigabe abgelaufener Vormerkungen ist diese Einschränkung abgefangen: Die Verfügbarkeitsprüfung berücksichtigt den Fristablauf unmittelbar und wartet nicht auf die nachträgliche Statuspflege. + +### Testbetrieb und echter Versand + +Jeder Mandant besitzt eine eigene Betriebsart. Im Testbetrieb werden sämtliche E-Mails an eine festgelegte Testadresse umgeleitet. Im echten Betrieb gelten die regulären Gast- und internen Empfänger. Ein sichtbarer Verwaltungshinweis macht den Testbetrieb kenntlich. + +Zusätzlich kann der Betreiber eine systemweite Mail-Umleitung setzen, die auch bei freigeschaltetem Versand Vorrang hat. Der tatsächliche Versandweg wird gemeinsam betrieben; eine Testnachricht ermöglicht die Prüfung. + +**Aktuelle Betriebsgrenze laut Projektstand:** Der Versandweg des Testsystems protokolliert Nachrichten bisher nur, statt sie zuzustellen. Ein vorhandener Buchungs- oder Erinnerungsablauf ist damit noch kein Nachweis für tatsächliche Zustellung. Der echte Versand muss eingerichtet und geprüft werden. + +### Missbrauch und unberechtigten Zugriff begrenzen + +- Verpflichtende Zwei-Faktor-Anmeldung für alle Verwaltungskonten. +- Rollen und Mandantenzugehörigkeiten zur Begrenzung der Bearbeitung. +- Geschützte, teilweise befristete Links für Angebot, Bewertung und Einwilligung; Gastannahmen gelten nur für die passende Angebotsfassung. +- Bot-Schutz des Anfrageformulars mit Köderfeld, Mindestbearbeitungszeit, Begrenzungen nach Herkunft und E-Mail sowie einer gemeinsamen Flutgrenze. +- Begrenzung gleichzeitig offener Vormerkungen je E-Mail und von Links in der Nachricht. +- Geschützte Zugänge und geprüfte Rückmeldungen bei externer Automatisierung. +- Sicherheitsvorgaben für die Auslieferung von Webseiten und verschlüsselte Speicherung dafür vorgesehener Zugangsdaten. + +Der Bot-Schutz kommt ohne externen Captcha-Dienst aus. Schriften werden selbst gehostet; Fotos werden von GPS- und Kamerametadaten bereinigt. Diese Maßnahmen belegen keine pauschale Datenschutz- oder Sicherheitsfreigabe des Gesamtprodukts. + +### Aufbewahrung und Anonymisierung + +| Datenbereich | Vorhandene Behandlung | +|---|---| +| Gästekontakte nach längerer Inaktivität | Automatische Anonymisierung nach eingestellter Frist | +| Kontakte mit ausschließlich unverbindlichen Anfragen | Kürzere Frist als für verbindliche Aufenthalte | +| Gast auf ausdrücklichen Wunsch | Manuelle Anonymisierung durch berechtigte Administratoren | +| Persönliche Buchungsnachrichten und interne Notizen | Bereinigung bei der Gastanonymisierung | +| Portal-Mail-Auszüge | Entfernen des Auszugs nach eigener Frist | +| Herkunfts- und Kampagnenangaben | Entfernen nach eigener Frist | +| Buchungs- und Betragsdaten | Bleiben grundsätzlich zur Nachweisführung erhalten | +| Einzelner Mandant | Export und vollständige Entfernung als administrative Betriebsfunktion | + +Mandanten können Aufbewahrungsfristen innerhalb der Systemvorgaben verkürzen. Die Vorgabewerte sind Vorschläge des Projekts und müssen fachlich bestätigt werden. + +Die vorhandene Anonymisierung ist keine vollständige Löschung aller personenbezogenen Inhalte aus Vertragsdateien, Sicherungen oder Freitexten. Ein umfassendes Dokumenten- und Nachweiskonzept einschließlich zugehöriger Fristen ist noch nicht fertig. Ebenso besteht bisher kein vollständiges Protokoll aller fachlichen Änderungen; das Supportzugriffsprotokoll des Betreibers deckt nur einen Teil ab. + +### Sicherungen und Änderungen ausliefern + +Eine Datenbanksicherung sowie ein vorhandener Weg zur zusätzlichen Sicherung von Dateien und Daten außerhalb des Webservers bilden die Wiederherstellungsgrundlage. Die regelmäßige Ausführung und Kontrolle müssen betrieblich eingerichtet sein. Der Mandantenexport ergänzt diese Sicherungen für die gezielte Datenherausgabe; er ersetzt keine vollständige Systemsicherung. + +Änderungen können nach automatischen Prüfungen auf dem Testsystem bereitgestellt werden. Der Auslieferungsablauf sichert vorher den Datenbestand, prüft die Erreichbarkeit und sieht bei Fehlern eine Rückkehr zur vorherigen Fassung vor. Test- und Produktionsbetrieb sind getrennte Ziele. Die Produktionsauslieferung ist beim dokumentierten Stand noch gesperrt. + +## Geplant, optional oder noch offen + +| Thema | Stand | +|---|---| +| Automatische Aufgaben auf dem Testsystem aktivieren | Offen; Einrichtung fehlt, Anwendungsfunktionen sind vorhanden | +| Echten E-Mail-Versand einrichten und prüfen | Offen | +| Öffentliche Produktion und WordPress-Umzug | Offen; einschließlich alter Seitenadressen und praktischer Buchungstests | +| Sicherungen regelmäßig kontrollieren und Wiederherstellung erproben | Betriebliche Aufgabe; kein alleiniger Nachweis durch vorhandene Sicherungsfunktion | +| Rechtstexte, Miet- und Stornobedingungen | Offen; gepflegte und freigegebene Inhalte nötig | +| Aufbewahrungsfristen und Dokumentenlöschung | Teilweise umgesetzt; vollständige Regeln und Freigaben fehlen | +| Verträge zur Auftragsverarbeitung | Offen; Hosting und Nutzung durch weitere Vermieter berücksichtigen | +| Umfassendes Dokumentenarchiv und Änderungsnachweise | Option aus den Analyseentwürfen; keine fertige Rechnungs- oder revisionssichere Archivfunktion | +| Unabhängige Überwachung von Kalender und Hintergrundbetrieb | Option; geschützter Zustandsabruf ist vorhanden | +| Zusätzlicher Schutz gegen unerwünschte eingebundene Inhalte | Offen; die geplante Content-Security-Policy benötigt noch Umsetzung und Prüfung | +| Externe Domains weiterer Mandanten | Offen; Hosting- und Zertifikatsfragen praktisch klären | + +Quellen: [Projektstand](../STATUS.md), [Löschkonzept](../LOESCHKONZEPT.md), [Datenschutz-Audit](../DATENSCHUTZ-AUDIT.md), [Betrieb](../BETRIEB.md), [Deployment](../DEPLOYMENT.md). Ältere Datenschutzanalysen sind Prüfgrundlagen, keine Bestätigung, dass alle dort vorgeschlagenen Maßnahmen bereits umgesetzt sind. Funktionsabgleich: aktuelle Zeitpläne, Mandantenverarbeitung und Datenbereinigung. diff --git a/docs/architecture/vermieter-verwaltung.md b/docs/architecture/vermieter-verwaltung.md new file mode 100644 index 0000000..ee1e50c --- /dev/null +++ b/docs/architecture/vermieter-verwaltung.md @@ -0,0 +1,70 @@ +# Vermieter-Verwaltung + +Stand: 26.10.2026 · [Übersicht](README.md) + +Die Verwaltung bündelt die tägliche Arbeit eines Vermieters und die Pflege seines öffentlichen Auftritts. Alle Funktionen gelten für den jeweils ausgewählten Mandanten. + +## Umgesetzte Funktionen + +### Einstieg und täglicher Überblick + +Die Startübersicht zeigt offene Anfragen, bevorstehende Anreisen, offene und überfällige Zahlungen, die Jahresauslastung sowie offene Portalthemen. Eine Aufenthaltsliste unterstützt die Vorbereitung der nächsten An- und Abreisen. + +Die Auslastung berücksichtigt bestätigte eigene Aufenthalte und bekannte Portalbelegungen. Eigene Sperrzeiten zählen dabei nicht als vermietete Nächte. Ein vollständiges Jahresumsatz- oder betriebswirtschaftliches Berichtswesen ist daraus noch nicht abzuleiten; beispielsweise fehlen Portalumsätze. + +Benutzer wählen zwischen zwei Ansichten: + +| Ansicht | Umfang | +|---|---| +| Einfache Ansicht | Anfragen und Buchungen einschließlich Verträgen, Sperrzeiten, Preise und Angebote, Gäste, Portal-Aufgaben, Bewertungen und Fotos | +| Expertenansicht | Zusätzlich sämtliche für die Rolle verfügbaren Einstellungen und Bereiche | + +Die Auswahl ist eine persönliche Benutzereinstellung. Sie verändert keine Berechtigung. + +### Benutzer und Zuständigkeiten + +| Rolle | Zuständigkeit | +|---|---| +| Mandanten-Administrator | Gesamte Verwaltung des eigenen Mandanten einschließlich Benutzer und Betriebseinstellungen | +| Vermietung | Wohnungen, Buchungen, Gäste, Preise, Angebote, Zahlungen, Portale und Bewertungen | +| Inhalte | Webseite, Bilder, Texte, Ausstattung, Fragen und Antworten, Hinweise und Bewertungen | + +Der Administrator legt Benutzer an, vergibt Rollen und kann den Zugang zu seinem Mandanten sperren. Ein Konto kann mehreren Mandanten angehören und dort unterschiedliche Rollen besitzen. Ein Wechsel zu weiteren zugeordneten Mandanten ist über das Benutzermenü möglich. + +Für jedes Konto ist die Anmeldung mit einem zweiten Faktor verpflichtend. Passwort und zweiter Faktor gehören zum Konto. Ein Mandanten-Administrator darf diese nur zurücksetzen, wenn das Konto ausschließlich zu seinem Mandanten gehört. Bei gemeinsam genutzten Konten liegt diese Aufgabe beim Betreiber. + +### Wohnungen und Vermietungsgrundlagen pflegen + +Zur Wohnung werden Stammdaten, Kapazität und Preisregeln gepflegt. Dazu gehören insbesondere enthaltene und maximal mögliche Personen, Zusatzpersonenkosten, Endreinigung, Anzahlung, Restzahlungsfrist, Vormerkungsdauer und Regeln zum Mindestaufenthalt. + +An die Wohnung schließen Saisons, Extras, Sonderangebote, Sperrzeiten und Portalkanäle an. Die fachlichen Regeln dazu stehen in [Preise und Angebote](preise-und-angebote.md) und [Portale und Belegung](portale-und-belegung.md). + +Mehrere Wohnungen können innerhalb eines Mandanten verwaltet werden. Jede Wohnung gehört derzeit zu genau einer Website. Die Auswahl einer Wohnung in einzelnen Webseitenbausteinen ist vorhanden; eine übergreifende öffentliche Suche ist noch geplant. + +### Betrieb des eigenen Mandanten einstellen + +Unter den Betriebseinstellungen pflegt der Mandanten-Administrator: + +- Testbetrieb oder echten Versand sowie die Testempfängeradresse; +- Empfänger interner Benachrichtigungen, Kontakt- und Antwortadresse sowie Absenderangaben innerhalb des gemeinsamen Versandwegs; +- Name, Anschrift und Telefon des Vermieters; +- Bankverbindung und Steuerhinweis für Verträge und Zahlungsinformationen; +- das eigene Portal-Postfach, soweit der entsprechende Dienst freigeschaltet ist; +- Fristen und Schutzregeln innerhalb der Vorgaben des Betreibers. + +Die betriebliche Betriebsart und die Benutzeransicht sind unabhängig: Auch eine einfache Ansicht kann im Testbetrieb genutzt werden. + +### Inhalte und Geschäftsvorgänge bearbeiten + +Die Verwaltung stellt Bearbeitungsbereiche für Anfragen, Angebote, Buchungen, Zahlungen, Gäste, Bewertungen und Portalaufgaben bereit. Interne Notizen bleiben von Gastnachrichten getrennt. Webseiteninhalte, Seiten, Bilder, Grundrisse, Erscheinungsbilder und Markenangaben werden ebenfalls hier gepflegt. + +Die genauen Geschäftsabläufe beschreiben [Vermietung](vermietung.md), [Gäste und Kommunikation](gaeste-und-kommunikation.md) und [Webseite](webseite.md). + +## Geplante Erweiterungen und offene Punkte + +- **Option:** zusätzliche Rollen mit eingeschränkten Aufgaben, beispielsweise Reinigung, Hausmeister oder Steuerberatung. Diese Rollen sind noch nicht eingerichtet. +- **Geplant:** weitere fachliche Eingabemöglichkeiten für strukturierte Wohnungsinformationen und lokale Gastgebertipps. +- **Option:** umfassendere Auswertungen zu Umsatz, Vertriebswegen und Wirtschaftlichkeit. Herkunftsangaben werden bereits erfasst; ein vollständiges Auswertungssystem fehlt. +- **Offen:** produktive Vermieter- und Bankdaten, freigegebene Rechtstexte, kommende Jahrespreise und die praktische Erprobung mit dem vorgesehenen Verwaltungskonto. + +Quellen: [Projektstand](../STATUS.md), [Konzept](../KONZEPT.md), [Mandantenplan](../MANDANTEN-PLAN.md). Funktionsabgleich: Rollen, Benutzeransichten, Verwaltungsübersicht und Betriebseinstellungen der Anwendung. diff --git a/docs/architecture/vermietung.md b/docs/architecture/vermietung.md new file mode 100644 index 0000000..1e12fa8 --- /dev/null +++ b/docs/architecture/vermietung.md @@ -0,0 +1,91 @@ +# Vermietung + +Stand: 26.10.2026 · [Übersicht](README.md) + +Der derzeitige Buchungsweg beginnt mit einer unverbindlichen Anfrage und führt über ein ausdrückliches Angebot zur Annahme durch den Gast. Eine verbindliche Sofortbuchung im öffentlichen Anfrageformular ist noch nicht gebaut. + +## Umgesetzter Ablauf + +### 1. Aufenthalt anfragen und vormerken + +Der Gast wählt Wohnung, Anreise, Abreise, Personenzahl und gewünschte Extras. Ein Aktionscode kann berücksichtigt werden. Er erhält eine Preisaufschlüsselung und übermittelt Kontaktdaten sowie optional eine Nachricht. + +Vor der Aufnahme prüft das System Verfügbarkeit und Preisregeln. Ist die Anfrage zulässig, entsteht eine befristete Vormerkung. Die Haltedauer ist je Wohnung einstellbar; die bisherige Vorgabe beträgt 48 Stunden. Der Gast erhält eine Eingangsbestätigung, die Vermieterin eine Benachrichtigung. Die Anfrage selbst ist noch keine verbindliche Buchung. + +Telefonische oder anderweitig eingegangene Anfragen lassen sich manuell erfassen. Auch dabei wird der Preis berechnet. + +### 2. Angebot vorbereiten und versenden + +Die Vermieterin prüft die Anfrage und kann im Angebot Termin, Personenzahl, Aktionscode, Gültigkeit, persönliche Nachricht und bestimmte Gastdaten anpassen. Ein individueller Nachlass oder Zuschlag wird als eigener Preisbestandteil ausgewiesen. Verfügbarkeit und Preis werden erneut geprüft. + +Das Angebot geht per E-Mail mit einem Vertragsentwurf und einem geschützten, befristeten Link an den Gast. Bis zum Ablauf der Angebotsfrist bleibt der Zeitraum vorgemerkt. + +Ein Angebot kann geändert und neu versendet werden. Die neue Fassung ersetzt die vorherige; Links zu früheren Fassungen sind nicht mehr für eine Annahme gültig. Die Verwaltung kann den aktuellen Angebotslink und das Angebots-PDF aufrufen. + +### 3. Gast nimmt an oder lehnt ab + +Auf der Angebotsseite sieht der Gast Preis, Aufenthalt und Bedingungen. Er kann das gültige Angebot annehmen oder ablehnen, ohne ein Konto anzulegen. + +Bei Annahme werden Zeitpunkt und angenommene Angebotsfassung einschließlich eines Nachweises zu Preis und Bedingungen festgehalten. Eine IP-Adresse wird dafür nicht gespeichert. Vor der Bestätigung wird die Verfügbarkeit nochmals geprüft. Anschließend erhält der Gast Buchungsbestätigung und Mietvertrag; die Vermieterin wird über die Antwort informiert. + +Bei Ablehnung wird der Zeitraum freigegeben. Eine abgelaufene Angebotsfassung kann nicht mehr angenommen werden. + +### 4. Alternative: bereits vereinbarte Buchung bestätigen + +Die Vermieterin kann direkt bestätigen, wenn der Aufenthalt bereits auf anderem Weg verbindlich vereinbart wurde, beispielsweise telefonisch. Das ist eine Verwaltungsaktion für eine bestehende Vereinbarung, kein öffentlicher Sofortbuchungsweg. + +Auch eine abgelaufene Anfrage kann wieder aufgegriffen werden, sofern der Zeitraum noch frei ist. Neue Angebote und Bestätigungen prüfen die Verfügbarkeit erneut. + +### 5. Vertrag und Zahlung begleiten + +Mit der Bestätigung entsteht der Mietvertrag als PDF. Die Verwaltung kann ihn herunterladen und bei Bedarf mit den aktuellen Texten neu erzeugen. Eine solche Neuerzeugung versendet ihn nicht automatisch erneut an den Gast. + +Anzahlung und Restzahlung werden mit Fälligkeiten geführt. Bankverbindung, Steuerhinweis und vertragliche Texte kommen aus den gepflegten Vermieterdaten. Für kurzfristige Aufenthalte wird eine sofortige vollständige Zahlung berücksichtigt. + +Zahlungseingänge werden manuell mit Betrag, Datum, Zahlungsweg und optionaler Notiz erfasst. Unterstützt sind unter anderem Überweisung und Barzahlung. Der erfasste Zahlungsstand aktualisiert die Buchung auf „Anzahlung erhalten“ oder „Bezahlt“. Offene Beträge bleiben sichtbar. Eine Erstattung kann als negativer Zahlungseintrag dokumentiert werden; die Überweisung selbst erfolgt außerhalb des Systems. + +Automatische Aufgaben erinnern an überfällige Anzahlungen, fordern die Restzahlung an und erinnern an überfällige Restbeträge. Die Restzahlungsaufforderung setzt im normalen geteilten Zahlungsablauf eine erfasste Anzahlung voraus. Die zugehörigen Nachrichten werden je Anlass einmalig geführt. + +### 6. Aufenthalt vorbereiten und abschließen + +Vor der Anreise erhält der Gast Anreiseinformationen, derzeit innerhalb der letzten sieben Tage. Nach der Abreise werden vollständig bezahlte Aufenthalte automatisch als abgeschlossen markiert. Unbezahlte Aufenthalte werden dadurch nicht stillschweigend abgeschlossen. Anschließend kann die Bewertungsanfrage folgen. + +Diese automatischen Schritte sind gebaut, benötigen aber einen eingerichteten regelmäßigen Hintergrundlauf und funktionierenden Mailversand. + +## Zustände eines Vorgangs + +| Zustand | Fachliche Bedeutung | Wirkung auf die Belegung | +|---|---|---| +| Anfrage, vorgemerkt | Anfrage wartet auf Bearbeitung | Belegt bis zum Ende der Vormerkung | +| Angebot gesendet | Gast kann die aktuelle Fassung annehmen | Belegt bis zum Ende der Angebotsfrist | +| Bestätigt | Buchung ist verbindlich | Belegt den Aufenthalt | +| Anzahlung erhalten | Erfasste Zahlung deckt die Anzahlung | Belegt den Aufenthalt | +| Bezahlt | Gesamtbetrag ist erfasst | Belegt den Aufenthalt | +| Abgeschlossen | Bezahlter Aufenthalt liegt in der Vergangenheit | Bleibt als historischer Aufenthalt erhalten | +| Abgelehnt | Anfrage oder Angebot wurde abgelehnt | Gibt den Zeitraum frei | +| Abgelaufen | Vormerkungs- oder Angebotsfrist verstrichen | Gibt den Zeitraum frei | +| Storniert | Bestätigte Buchung wurde in der Verwaltung aufgehoben | Gibt den Zeitraum frei | + +Die Verwaltung kann die Vormerkung verlängern oder eine Anfrage ablehnen. Abgelaufene Haltefristen wirken für die Verfügbarkeit sofort; der automatische Lauf aktualisiert anschließend den Status und benachrichtigt die Vermieterin. + +## Stornierung: vorhandener Umfang + +Bestätigte Buchungen können in der Verwaltung storniert werden. Dadurch wird der Zeitraum wieder frei und die Portalbearbeitung entsprechend angestoßen. Der Gast wird dabei derzeit nicht automatisch benachrichtigt. + +Eine automatische Berechnung von Stornokosten, ein vollständiger Erstattungsablauf und ein Selbstbedienungsformular für Gäste fehlen. Die vorhandene Möglichkeit eines negativen Zahlungseintrags ersetzt diese Abläufe nicht. + +## Geplant und noch zu entscheiden + +| Erweiterung | Stand | Voraussetzung oder Grenze | +|---|---|---| +| Verbindliche Direktbuchung | Geplant | Erst bei ausreichend verlässlichem Abgleich mit den anderen Buchungssystemen | +| Stornoformular für Gäste | Geplant | Sichere Zuordnung, Bestätigung und fachlich freigegebene Bedingungen nötig | +| Stornokosten und Erstattungsbearbeitung | Option/Entwurf | Regeln und genauer Ablauf noch freizugeben | +| KI-Angebotsentwürfe | Geplant | Entwurf durch KI, zunächst menschliche Prüfung und Freigabe | +| Automatischer Bankabgleich | Option | Beispielsweise Import einer Bankdatei; noch nicht vorhanden | +| Online-Zahlung | Option | Im Konzept als Erweiterung möglich; derzeit keine Zahlungsanbieter-Anbindung | +| Gästebereich | Option | Buchung und Anreiseinfos selbst einsehen; noch nicht vorhanden | + +Mietbedingungen, Stornoregeln, Annahmetexte und Beschriftung der Annahmeaktion sind inhaltlich noch freizugeben. Diese Dokumentation beschreibt den Funktionsstand und bestätigt keine rechtliche Prüfung der Mustertexte. + +Quellen: [Konzept, insbesondere Buchungswege](../KONZEPT.md), [Projektstand](../STATUS.md). Ergänzende, noch nicht vollständig beschlossene Entwürfe: [Buchungsprozess](../BUCHUNGSPROZESS.md). Funktionsabgleich: vorhandene Buchungsaktionen, Buchungszustände und Zahlungsabläufe. diff --git a/docs/architecture/webseite.md b/docs/architecture/webseite.md new file mode 100644 index 0000000..388712c --- /dev/null +++ b/docs/architecture/webseite.md @@ -0,0 +1,85 @@ +# Webseite + +Stand: 26.10.2026 · [Übersicht](README.md) + +Die öffentliche Website stellt Wohnung, Gastgeber und Umgebung vor und führt Gäste zu einer unverbindlichen Anfrage. Die Verwaltung pflegt Inhalte und saisonale Varianten innerhalb eines vorgegebenen Seitenbaukastens. + +## Umgesetzte Funktionen + +### Seiten und Inhalte + +Seiten bestehen aus ausgewählten Bausteinen. Reihenfolge und Inhalte sind bearbeitbar; Seiten können veröffentlicht und im Haupt- oder Fußmenü eingeordnet werden. Seitentitel, Adresse, Menübezeichnung und Suchmaschinenbeschreibung sind pflegbar. + +Der aktuelle Katalog enthält 16 Bausteine: + +| Baustein | Fachlicher Inhalt | +|---|---| +| Titelbereich | Großer Einstieg mit Bild, Text und gegebenenfalls hervorgehobenem Angebot | +| Kernfakten | Wichtigste Wohnungsmerkmale auf einen Blick | +| Text mit Bild | Wohnungs-, Umgebungs- oder persönliche Inhalte | +| Galerie | Fotos des Aufenthaltsorts und der Wohnung | +| Ausstattung | Strukturierte Ausstattungsmerkmale | +| Grundriss | Wohnung und einzelne Räume erkunden | +| Lage | Lagebeschreibung und Orientierung | +| Preise | Saisonpreise und Preisinformationen | +| Sonderangebote | Aktuell beworbene Aktionen und konkrete freie Termine | +| Buchungsanfrage | Zeitraum, Personen, Extras und Kontaktdaten erfassen | +| Bewertungen | Freigegebene Gästebewertungen | +| Gastgeber | Persönliche Vorstellung | +| Fragen und Antworten | Wiederkehrende Gästefragen beantworten | +| Handlungsaufruf | Besucher zum nächsten Schritt führen | +| Kontakt | Kontaktmöglichkeiten darstellen | +| Freitext | Weitere redaktionelle und rechtliche Inhalte | + +Eine einzelne Seite kann Bausteine für unterschiedliche aktive Wohnungen derselben Website enthalten. Ohne Auswahl verwendet der Baustein die Hauptwohnung. Fremde oder nicht mehr gültige Wohnungszuordnungen sollen keine andere Wohnung ersatzweise darstellen. + +### Fotos und Grundriss + +Fotos lassen sich hochladen, bearbeiten, kategorisieren, einer Wohnung zuordnen, veröffentlichen und sortieren. Bildbeschreibung und optionale Bildunterschrift werden gepflegt. Webgeeignete Bildgrößen entstehen automatisch; GPS- und Kamerametadaten werden entfernt. Die Galerie ermöglicht eine vergrößerte Bildansicht. + +Der interaktive Grundriss verbindet Bereiche des Wohnungsbilds mit Raumnamen, Beschreibung, Hinweisen, Fotos und Ausstattung. Die Verwaltung legt die Raumflächen fest. Gäste können Räume über die Flächen oder Raumtasten auswählen; ohne die interaktive Darstellung stehen die Informationen als Liste zur Verfügung. + +### Gestaltung, Marke und Saisons + +Eine Website wählt ein installiertes Theme. Vorhanden sind „Ostsee-Licht“ und „Seebad“. Der Vermieter kann das Theme auswählen, aber keine ausführbaren Gestaltungspakete hochladen. Vorschau-Links ermöglichen die Sichtung einer Gestaltung vor der Aktivierung. + +Erscheinungsbilder ändern saisonal Fotos, Bilder je Baustein, Texte, Farben und Banner. Der Seitenaufbau bleibt davon grundsätzlich unabhängig. Einzelne Bausteine können auf bestimmte Erscheinungsbilder begrenzt werden. Zeiträume können jährlich wiederkehren; Prioritäten und ein Standard regeln die Auswahl. Vorbereitet sind unter anderem Sommer, Winter, Weihnachten und Silvester. + +Zur Website gehören Logo, Favicon und eine eigene Grafik für E-Mails beziehungsweise Vertragsunterlagen. Eine Bildwelt liefert passende Dekoration unabhängig vom Theme; eine Wohnung kann eine andere Bildwelt als ihre Website wählen. Damit können etwa eine Ostsee- und eine Bergwohnung unter derselben Grundgestaltung erscheinen. + +**Stand der Markenübernahme:** Die Pflege von Marke und Bildwelt sowie deren vollständige Nutzung in beiden Themes und den Kommunikationsvorlagen sind umgesetzt. Laut [Projektstand](../STATUS.md) ist der Abschluss am 26.10.2026 auf das Testsystem ausgeliefert; die vorhandene Stommer-Marke wurde der Website zugeordnet. + +### Anfrage und geschützte Gastseiten + +Das Anfrageformular zeigt die Berechnung des gewählten Aufenthalts und erfasst die für die Bearbeitung nötigen Daten. Es prüft Zeitraum, Personenzahl, Preisregeln und Belegung. Angaben zur Herkunft der Anfrage sowie Kampagnenkennungen können übernommen werden. + +Zum öffentlichen Auftritt gehören außerdem Angebotsseite, Annahme beziehungsweise Ablehnung sowie Bewertungsformular. Diese Seiten werden über geschützte Links ohne Gästekonto erreicht. Der vollständige Ablauf steht in [Vermietung](vermietung.md). + +### Auffindbarkeit und verständliche Nutzung + +Suchmaschinentitel, Seitenbeschreibungen, Vorschaudaten beim Teilen, eine Seitenübersicht für Suchmaschinen und strukturierte Wohnungsdaten sind vorhanden. Testumgebungen werden gegen Indexierung gekennzeichnet. Die vorhandenen strukturierten Daten sind noch nicht in allen Ortsangaben vollständig verallgemeinert; daraus folgt keine fertige Suchmaschinenlösung für beliebige weitere Standorte. + +Die Darstellung berücksichtigt mobile Geräte und Bildbeschreibungen. Schriften werden selbst gehostet. Gute Lesbarkeit und Barrierefreiheit sind Gestaltungsziele; eine vollständige Prüfung aller Anforderungen an Barrierefreiheit oder Leistungskennzahlen ist damit nicht behauptet. + +## Geplante Erweiterungen + +| Funktion | Stand | Nutzen | +|---|---|---| +| Tipps der Gastgeberin | Geplant | Orte nach Kategorie mit Foto, Text, Weg beziehungsweise Gehzeit, Kartenlink und Saison | +| Gut zu wissen | Geplant | Zugang, Barrieren, Dusche, Haustiere, Rauchen, Parken und An-/Abreise strukturiert darstellen und auch in Nachrichten nutzen | +| Belegungs- und Preiskalender | Geplant | Verfügbare Nächte und Preise als öffentliche Monatsansicht ansehen | +| Wohnungsübersicht und Suche | Geplant, separater Ausbau | Mehrere Wohnungen einer Website gemeinsam vorstellen und nach passendem Aufenthalt suchen | +| Theme-Optionen | Geplant | Vorgegebene Schalter für Titelbereich, Rahmen, Bewegung oder ähnliche Gestaltungsentscheidungen | +| Darstellungsvarianten je Baustein | Geplant | Beispielsweise unterschiedliche Galerie- und Text-Bild-Anordnungen auswählen | +| Menüs mit Bild und Kurztext | Geplant | Seiten über redaktionelle Bildtafeln vorstellen | +| Ein Tag an der Ostsee | Spätere Option | Eine Folge von Texten und Bildern als erzählenden Tagesablauf präsentieren | +| Eigene Videos | Spätere Option | Video mit Vorschaubild und Rücksicht auf Datensparen einbinden | +| Wetter und Wassertemperatur | Spätere Option | Aktuelle Umgebungsinformationen nach Klärung von Datenquelle und Nutzungsrechten zeigen | +| Mehrsprachigkeit | Offen/Option | Inhalte, Anfrage, Angebot, Vertrag und Nachrichten zusammenhängend in weiteren Sprachen anbieten | +| Gästebereich | Spätere Option | Buchung und Aufenthaltsinformationen selbst einsehen | + +## Noch nötige Inhalte und Freigaben + +Impressum, Datenschutz, Mietbedingungen und Stornotexte benötigen freigegebene Inhalte. Die Entscheidung über weitere Sprachen und einzelne Gestaltungsdetails ist offen. Der Umzug der bisherigen WordPress-Seite einschließlich alter Seitenadressen und öffentlichem Produktionsstart steht ebenfalls noch aus. + +Quellen: [Theme-System](../THEMES.md), [Designkonzept](../DESIGN-KONZEPT.md), [Projektstand](../STATUS.md), [Zusammenarbeit](../ZUSAMMENARBEIT.md). Funktionsabgleich: aktueller Bausteinkatalog und Seiten-, Foto- sowie Grundrissverwaltung.