Compare commits

..
Author SHA1 Message Date
LarsandClaude Opus 5.5 33f8f899d6 Prozessarchitektur 0.10
Deploy FeWo mit PipelineManager / deploy (push) Successful in 3m57s
Neue hierarchische Struktur der fachlichen Sollbeschreibung (README, Prozesslandkarte,
Buchungsarchetypen, Abwicklungsprofile, Entscheidungen, Offene Fragen, Querschnitt,
Szenarien, V01/V02, Referenzen); die Fassung 0.9 bleibt in der Git-Historie.
Obsidian-Fensterzustand (workspace.json) wird nicht mehr versioniert.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 21:11:54 +01:00
LarsandClaude Opus 5.5 0c10880e4f Testbetrieb: eine Schranke fuer jede ausgehende E-Mail
Deploy FeWo mit PipelineManager / deploy (push) Failing after 3m10s
EnforceMailTestMode prueft jede Mail unmittelbar vor dem Versand (MessageSending,
jeder Mailer): im Testbetrieb gehen An/Cc/Bcc nur an die Testadresse, ohne
Testadresse wird nichts versendet; der Modus wird je Mail frisch gelesen.
Ersetzt alwaysTo am Standard-Mailer. Tests inkl. Pruefung, dass kein Code am
Mailer vorbei versendet.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 21:03:24 +01:00
LarsandClaude Opus 5.5 ac9d20b812 Ein Eingang fuer alle Kanaele (Paket 4, Prozessarchitektur v0.10)
Portalbuchungen und -anfragen aus Kalender und Mail werden ueber PortalIntake
zum Vorgang (nur bei sicherer Erkennung), Dubletten ueber Buchungsnummer,
gleiches Portal mit gleichen Naechten und Spiegelung; Unsicheres wird geklaert.
Portalstorno und -aenderung als Aufgabe am Vorgang ohne stille Stornierung.
Schalter je Kanal (Aus als Standard, Beobachten, Anlegen, Anlegen + weiter),
Eingangsprotokoll, Bestandsuebernahme mit Vorschau/Bericht/Ruecknahme,
Sperrnachweis in drei Stufen.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-01 20:53:35 +01:00
98 changed files with 3015 additions and 5682 deletions

No files matched your search

+3
View File
@@ -34,3 +34,6 @@ Thumbs.db
/scripts/deploy.*.env
!/scripts/deploy.example.env
storage/app/private/exports/
# Obsidian: persönlicher Fensterzustand des Editors
docs/Prozessarchitektur/.obsidian/workspace.json
+1 -1
View File
@@ -17,7 +17,7 @@ # Ferienwohnung Stommer
- Website = theme system (`docs/THEMES.md`): themes live in `resources/themes/<key>` (theme.json, theme.css, theme.js, views); views resolve via the `theme::` namespace (theme → parent → base `ostsee-licht`). Pages are lists of sections (`app/Themes/Sections`, catalogue in `config/themes.php`); seasonal `Appearance`s override tokens/texts/hero photo/photos per section (stable `data.id` per placed section) and sections can be limited to appearances. Theme views use only token colour classes (`bg-accent`, `text-muted`, …). New designs are **additional** themes: `php artisan themes:make <key>`, `themes:check`, `themes:preview` – never edit `ostsee-licht` for a new design; authoring rules in `docs/THEME-ERSTELLUNG.md`. Resolve `Theme` lazily (`app(Theme::class)`), never in constructors – middleware `ResolveTheme` replaces it per request.
- Operations (environments, Strato access, server .env, admin accounts, 2FA, known pitfalls): `docs/BETRIEB.md` – read it before touching a server. Admin accounts: `php artisan users:create`; 2FA (Filament app authentication) is mandatory for every account. Admin modes (`App\Enums\AdminMode`: simple/expert per user, user menu switch) only shape the menu via the `FollowsAdminMode` trait on every resource/page (simple menu = `AdminMode::SIMPLE_NAVIGATION`); permissions stay with roles/policies. New admin resources must use `FollowsAdminMode`.
- Deployment: `scripts/deploy.sh <env> setup|deploy [ref]|rollback|releases|artisan` (atomic releases on Strato, docs/DEPLOYMENT.md; the server keeps only the active release because of Strato's file quota – history = Git tags `deploy/<env>/<timestamp>`); CI `.gitea/workflows/deploy.yml`. Production has no dev packages (no factories/Faker) – production seeding via `ProductionSeeder`.
- Strato specifics: `public/index.php` strips the internal `/releases/<v>/public` prefix from `REQUEST_URI` (signed URLs); `URL::forceRootUrl(APP_URL)` outside local/testing; mail routing: `App\Support\Settings` (admin page System › Betrieb, stored on the tenant) – test mode (default) sends every mail to the test recipient only, live delivers normally; `FEWO_MAIL_REDIRECT_TO` is a hard override. Landlord data, bank, addresses and periods are columns of `tenants`: `App\Tenancy\TenantConfig` lays them over `config('fewo.*')` and `mail.from` whenever the tenant context changes, so views and mails keep reading the config keys. Send notifications to `Settings::notificationRecipients()` (never `config('fewo.notification_email')` directly). Findings detected repeatedly (e.g. by the 5-minute sync) go through `AppSupportInbox` (admin Postfach, fingerprint per tenant, repeated only per the tenant's `reminder_interval_days`), never straight to mail; daily/weekly summaries: `SendDigests` + `DigestReport` (sections `DigestSection`). Retention periods and bot-protection counters can only be tightened against the `.env` baseline. The booking form is protected against bots (`config('fewo.spam')`: honeypot, time trap, rate limits, max open holds per e-mail) – tests that submit it instantly set `fewo.spam.min_seconds` to 0.
- Strato specifics: `public/index.php` strips the internal `/releases/<v>/public` prefix from `REQUEST_URI` (signed URLs); `URL::forceRootUrl(APP_URL)` outside local/testing; mail routing: `App\Support\Settings` (admin page System › Betrieb, stored on the tenant) – test mode (default) sends every mail to the test recipient only, live delivers normally; `FEWO_MAIL_REDIRECT_TO` is a hard override. The one gate is `App\Listeners\EnforceMailTestMode` (MessageSending, every mailer; no test address in test mode = nothing is sent) – never send mail around Laravel's mailer (no direct transports, `mail()`, own SMTP; `MailTestModeGateTest` checks this). Landlord data, bank, addresses and periods are columns of `tenants`: `App\Tenancy\TenantConfig` lays them over `config('fewo.*')` and `mail.from` whenever the tenant context changes, so views and mails keep reading the config keys. Send notifications to `Settings::notificationRecipients()` (never `config('fewo.notification_email')` directly). Findings detected repeatedly (e.g. by the 5-minute sync) go through `AppSupportInbox` (admin Postfach, fingerprint per tenant, repeated only per the tenant's `reminder_interval_days`), never straight to mail; daily/weekly summaries: `SendDigests` + `DigestReport` (sections `DigestSection`). Retention periods and bot-protection counters can only be tightened against the `.env` baseline. The booking form is protected against bots (`config('fewo.spam')`: honeypot, time trap, rate limits, max open holds per e-mail) – tests that submit it instantly set `fewo.spam.min_seconds` to 0.
- Vite fonts plugin is removed on purpose (corporate proxy breaks remote font downloads, and fonts must be self-hosted for GDPR).
- PHP/Composer on this machine: winget package dir `%LOCALAPPDATA%\Microsoft\WinGet\Packages\PHP.PHP.8.4_*` (Composer as `composer\composer.phar` there).
- Git remote: Gitea `https://gitea.stommer.de/Lars/fewo-stommer.git`, branch `main`.
+21
View File
@@ -3,6 +3,7 @@
namespace App\Actions;
use App\Channels\ConflictDetector;
use App\Channels\Intake\PortalIntake;
use App\Channels\Mail\ParsedPortalMail;
use App\Channels\Mail\PortalMail;
use App\Channels\Mail\PortalMailParser;
@@ -12,6 +13,7 @@
use App\Mail\PortalMailNotification;
use App\Models\BlockedPeriod;
use App\Models\Channel;
use App\Models\IntakeObservation;
use App\Models\PortalEmail;
use App\Support\Settings;
use App\Tenancy\TenantFeatures;
@@ -75,6 +77,9 @@ public function handle(PortalMail $mail): ?PortalEmail
]);
});
// One intake for all channels (package 4): bookings, requests and cancellations reach their case.
rescue(fn () => $this->intake($channel, $parsed, $record));
if (in_array($record->status, [PortalEmailStatus::Blocked, PortalEmailStatus::Released, PortalEmailStatus::NeedsReview], true)) {
rescue(fn () => Mail::to(Settings::notificationRecipients())->send(new PortalMailNotification($record)));
}
@@ -86,6 +91,17 @@ public function handle(PortalMail $mail): ?PortalEmail
return $record;
}
private function intake(Channel $channel, ParsedPortalMail $parsed, PortalEmail $record): void
{
$intake = app(PortalIntake::class);
match ($parsed->type) {
PortalEmailType::Booking => $record->blocked_period_id !== null ? $intake->process(BlockedPeriod::query()->findOrFail($record->blocked_period_id), IntakeObservation::SOURCE_MAIL) : null,
PortalEmailType::Cancellation => $intake->cancellationMail($channel, $parsed, $record),
PortalEmailType::Inquiry => $intake->inquiryMail($channel, $parsed, $record),
PortalEmailType::Unknown => null,
};
}
/**
* Channels list the sender addresses or domains of their notification e-mails in settings.email_senders.
*/
@@ -177,6 +193,11 @@ private function release(Channel $channel, ParsedPortalMail $parsed): array
default => null,
};
// A block that belongs to a case is never released by a mail: the case leads, the landlord decides (E-019).
if ($block && $block->linked_booking_id !== null) {
return [PortalEmailStatus::NeedsReview, $block, 'Stornierung zu einem gebuchten Vorgang gemeldet – nichts automatisch freigegeben; Aufgabe am Vorgang prüfen.'];
}
if ($block) {
$block->delete();
+3
View File
@@ -5,6 +5,7 @@
use App\Channels\ChannelSyncException;
use App\Channels\ConflictDetector;
use App\Channels\ExternalPeriod;
use App\Channels\Intake\PortalIntake;
use App\Enums\ChannelEchoBehavior;
use App\Models\BlockedPeriod;
use App\Models\Booking;
@@ -135,6 +136,8 @@ public function handle(Channel $channel): ChannelSyncLog
'alerted_at' => null, 'last_import_events' => count($periods), 'sync_warnings' => $warnings])->save();
});
app(ReportChannelConflicts::class)->handle($channel, $conflicts);
// One intake for all channels (package 4); a failure there never fails the sync itself.
rescue(fn () => app(PortalIntake::class)->afterSync($channel->fresh()));
return $channel->syncLogs()->create(['successful' => true, 'events' => count($periods), ...$counts,
'conflicts' => count($conflicts), 'warnings' => $warnings,
+3 -1
View File
@@ -5,6 +5,7 @@
use App\Enums\BookingStatus;
use App\Enums\IntakeKind;
use App\Enums\OccupationKind;
use App\Enums\ProcessingMode;
use App\Exceptions\ReservationException;
use App\Models\BlockedPeriod;
use App\Models\Booking;
@@ -31,7 +32,7 @@ class TakeOverExternalBooking
public function __construct(private ConfirmBooking $confirm, private PortalPrice $price) {}
/**
* @param array{guest?: ?array<string, ?string>, guests?: ?int, portal_reference?: ?string, portal_total?: ?int, notes?: ?string, guest_confirmed?: bool} $facts
* @param array{guest?: ?array<string, ?string>, guests?: ?int, portal_reference?: ?string, portal_total?: ?int, notes?: ?string, guest_confirmed?: bool, processing_mode?: ?ProcessingMode} $facts
*
* @throws ReservationException
*/
@@ -73,6 +74,7 @@ public function handle(Property $property, Channel $channel, CarbonImmutable $ar
'hold_expires_at' => null,
'guest_confirmed_at' => ($facts['guest_confirmed'] ?? false) ? now() : null,
'internal_notes' => filled($facts['notes'] ?? null) ? trim((string) $facts['notes']) : null,
'processing_mode' => $facts['processing_mode'] ?? null,
...$this->price->columns($property, $arrival, $departure, $guests, $portalTotal, $channel->name),
]);
+63
View File
@@ -0,0 +1,63 @@
<?php
namespace App\Actions;
use App\Availability\AvailabilityChecker;
use App\Enums\BookingStatus;
use App\Enums\IntakeKind;
use App\Enums\ProcessingMode;
use App\Exceptions\ReservationException;
use App\Models\Booking;
use App\Models\Channel;
use App\Process\CaseAutomation;
use App\Process\ProcessSettings;
use Carbon\CarbonImmutable;
use Illuminate\Support\Facades\DB;
/**
* A non-binding request through a portal (case type A2) as it arrives: dates and the portal's reference, nothing
* invented. Guest, number of guests and price stay unknown until the landlord enters them; the case then asks for
* exactly that and continues like a request of the own website. Whether the dates are reserved follows the channel's
* settings for requests.
*/
class TakeOverPortalInquiry
{
public function __construct(private AvailabilityChecker $availability, private ProcessSettings $settings) {}
/**
* @throws ReservationException
*/
public function handle(Channel $channel, CarbonImmutable $arrival, CarbonImmutable $departure, ?string $reference = null, ?string $notes = null, ?ProcessingMode $processingMode = null): Booking
{
$property = $channel->property;
if ($departure->lessThanOrEqualTo($arrival)) {
throw new ReservationException('Die Abreise muss nach der Anreise liegen.');
}
$booking = DB::transaction(function () use ($property, $channel, $arrival, $departure, $reference, $notes, $processingMode): Booking {
$property->newQuery()->whereKey($property->id)->lockForUpdate()->firstOrFail();
if (! $this->availability->isAvailable($property, $arrival, $departure)) {
throw ReservationException::notAvailable();
}
$profile = $this->settings->resolve($property, $channel, IntakeKind::Inquiry);
return $property->bookings()->create([
'status' => BookingStatus::Reserved,
'source' => 'portal',
'intake' => IntakeKind::Inquiry,
'origin_channel_id' => $channel->id,
'portal_reference' => $reference,
'arrival' => $arrival->toDateString(),
'departure' => $departure->toDateString(),
'hold_expires_at' => $profile->preReservation() ? now()->addHours($profile->holdHours()) : null,
'processing_mode' => $processingMode,
'internal_notes' => $notes,
]);
});
app(CaseAutomation::class)->advance($booking);
return $booking->refresh();
}
}
+39
View File
@@ -0,0 +1,39 @@
<?php
namespace App\Channels\Intake;
use App\Enums\CaseType;
use App\Enums\IntakeOutcome;
use App\Models\Booking;
/**
* What the intake recognised in one incoming portal event, with its reasons in plain words.
*/
final class IntakeDecision
{
/**
* @param list<string> $reasons why the intake decided so
* @param list<string> $missing what the new case will not know yet
*/
public function __construct(
public readonly IntakeOutcome $outcome,
public readonly array $reasons = [],
public readonly ?Booking $booking = null,
public readonly ?CaseType $caseType = null,
public readonly array $missing = [],
public readonly ?string $reference = null,
) {}
public function withBooking(Booking $booking): self
{
return new self($this->outcome, $this->reasons, $booking, $this->caseType ?? $booking->case_type, $this->missing, $this->reference);
}
/**
* @param list<string> $reasons
*/
public function as(IntakeOutcome $outcome, array $reasons): self
{
return new self($outcome, $reasons, $this->booking, $this->caseType, $this->missing, $this->reference);
}
}
+489
View File
@@ -0,0 +1,489 @@
<?php
namespace App\Channels\Intake;
use App\Actions\ReconcileChannelRepresentations;
use App\Actions\TakeOverExternalBooking;
use App\Actions\TakeOverPortalInquiry;
use App\Channels\Mail\ParsedPortalMail;
use App\Enums\BookingStatus;
use App\Enums\BookingTaskKind;
use App\Enums\BookingTaskStatus;
use App\Enums\CaseIntakeMode;
use App\Enums\ChannelBookingModel;
use App\Enums\IntakeKind;
use App\Enums\IntakeOutcome;
use App\Enums\OccupationKind;
use App\Enums\ProcessingMode;
use App\Exceptions\ReservationException;
use App\Models\BlockedPeriod;
use App\Models\Booking;
use App\Models\BookingTask;
use App\Models\Channel;
use App\Models\IntakeObservation;
use App\Models\PortalEmail;
use App\Pricing\QuoteException;
use App\Process\CaseLog;
use App\Process\ProcessSettings;
use Carbon\CarbonImmutable;
use Illuminate\Support\Collection;
use Throwable;
/**
* The one intake for bookings and requests from portals (UMSETZUNGSPLAN_v0.10 §5.5, package 4). Every incoming event –
* an entry of a portal calendar, a booking, request or cancellation e-mail – is judged the same way:
*
* - **Same case first** (no duplicates): an entry already linked to a case; the portal's booking reference; the same
* portal with exactly the same nights; the calendar mirror of an entry that belongs to a case. Different references
* or overlapping but different dates are never merged – they are clarified.
* - **New case only when certain**: a booking e-mail of the portal with dates and reference, or a calendar entry that
* the channel's rules recognise as a reservation booked at this portal (or that the landlord classified so). Blocks,
* mirrors of other portals, own use and unrecognised entries never become cases by themselves.
* - **Reports about known cases** (cancellation e-mail, entry gone from the calendar, other dates) become a task on the
* case and an entry in its history – the case itself is never cancelled, released or changed here (E-019).
*
* What happens then depends on the channel ({@see CaseIntakeMode}): nothing (off), only a record (observe), or the
* cases and tasks are created (create; continue additionally lets the new cases follow the automatic handling).
* Creating a case never sends anything the landlord did not release (package 3).
*/
class PortalIntake
{
public const LINK_NOTE = 'Automatisch dem Vorgang zugeordnet; der Vorgang führt diese Belegung.';
public function __construct(
private TakeOverExternalBooking $takeOver,
private TakeOverPortalInquiry $inquiry,
private ProcessSettings $settings,
) {}
/**
* Judges one portal calendar entry or e-mail block without changing anything.
*/
public function evaluate(BlockedPeriod $block): IntakeDecision
{
$block->loadMissing(['channel', 'property', 'canonicalBlock', 'linkedBooking']);
$channel = $block->channel;
$reference = self::reference($block);
if ($channel === null || ! in_array($block->source, ['channel', 'email'], true)) {
return new IntakeDecision(IntakeOutcome::Ignore, ['Kein importierter Portaleintrag.'], reference: $reference);
}
if ($block->trashed()) {
return new IntakeDecision(IntakeOutcome::Ignore, ['Nicht mehr im Kalender des Portals.'], reference: $reference);
}
if ($block->linked_booking_id !== null && $block->linkedBooking !== null) {
return new IntakeDecision(IntakeOutcome::Link, ['Bereits dem Vorgang zugeordnet.'], $block->linkedBooking, reference: $reference);
}
if ($block->is_representation) {
$leaderCase = $block->canonicalBlock?->linkedBooking;
return $leaderCase !== null
? new IntakeDecision(IntakeOutcome::Link, ['Spiegelung einer Belegung, die zu diesem Vorgang gehört.'], $leaderCase, reference: $reference)
: new IntakeDecision(IntakeOutcome::Ignore, ['Spiegelung einer anderen Belegung, keine eigene Buchung.'], reference: $reference);
}
if ($reference !== null && ($case = $this->caseByReference($channel, $reference)) !== null) {
return new IntakeDecision(IntakeOutcome::Link, ['Gleiche Buchungsnummer '.$reference.' wie der Vorgang.'], $case, reference: $reference);
}
if ($block->ends_on->lessThanOrEqualTo(CarbonImmutable::today())) {
return new IntakeDecision(IntakeOutcome::Ignore, ['Liegt in der Vergangenheit.'], reference: $reference);
}
if ($block->occupationKind() === OccupationKind::Block) {
return new IntakeDecision(IntakeOutcome::Ignore, ['Als Sperrzeit eingeordnet (z. B. Spiegelung, eigene Nutzung oder Wartung).'], reference: $reference);
}
if ($block->is_private) {
return new IntakeDecision(IntakeOutcome::Ignore, ['Als private Belegung eingeordnet.'], reference: $reference);
}
$origin = $block->origin_channel_id;
if ($origin !== null && $origin !== $channel->id) {
$case = $this->caseWithSameNights($block, $origin);
return $case !== null
? new IntakeDecision(IntakeOutcome::Link, ['Laut Kalender über ein anderes Portal gebucht; dort gibt es den Vorgang mit genau diesen Nächten.'], $case, reference: $reference)
: new IntakeDecision(IntakeOutcome::Clarify, ['Laut Kalender über ein anderes Portal gebucht – der Vorgang entsteht dort, nicht hier.'], reference: $reference);
}
$case = $this->caseWithSameNights($block, $channel->id);
if ($case !== null) {
return filled($case->portal_reference) && $reference !== null && $case->portal_reference !== $reference
? new IntakeDecision(IntakeOutcome::Clarify, ['Gleiche Nächte wie Vorgang '.$case->reference.', aber andere Buchungsnummer ('.$reference.' / '.$case->portal_reference.').'], reference: $reference)
: new IntakeDecision(IntakeOutcome::Link, ['Dasselbe Portal mit genau denselben Nächten wie Vorgang '.$case->reference.'.'], $case, reference: $reference);
}
$overlap = Booking::query()->occupying()->where('property_id', $block->property_id)->overlapping($block->starts_on, $block->ends_on)->first();
if ($overlap !== null) {
return new IntakeDecision(IntakeOutcome::Clarify, ['Überschneidet sich mit Vorgang '.$overlap->reference.' ('.$overlap->arrival->format('d.m.').'–'.$overlap->departure->format('d.m.Y').'), ohne dieselbe Buchung zu sein.'], reference: $reference);
}
$sameChannelOverlap = $channel->blockedPeriods()->occupying()->whereKeyNot($block->id)->overlapping($block->starts_on, $block->ends_on)->exists();
if ($sameChannelOverlap) {
return new IntakeDecision(IntakeOutcome::Clarify, ['Weitere Einträge desselben Portals überschneiden sich – keine Zusammenführung nach Terminen.'], reference: $reference);
}
$certainty = $this->certainty($block, $reference);
if ($certainty !== null) {
return new IntakeDecision(IntakeOutcome::Clarify, [$certainty], reference: $reference);
}
if ($channel->booking_model === ChannelBookingModel::Inquiry) {
return new IntakeDecision(IntakeOutcome::Clarify, ['Über dieses Portal kommen laut Einstellung nur Anfragen – eine feste Buchung bitte bestätigen.'], reference: $reference);
}
$profile = $this->settings->resolve($block->property, $channel, IntakeKind::Booking);
$fields = (array) ($block->ical_interpretation['fields'] ?? []);
return new IntakeDecision(
IntakeOutcome::Create,
[$block->source === 'email' ? 'Buchungsmail von '.$channel->name.' mit Zeitraum und Buchungsnummer.' : 'Kalendereintrag nach Regel „'.($block->ical_interpretation['rule'] ?? 'persönlich eingeordnet').'“ als Buchung bei '.$channel->name.' erkannt.'],
caseType: $profile->caseType,
missing: array_values(array_filter([
blank($fields['guest_full_name'] ?? null) ? 'Name des Gastes' : 'Name des Gastes (nur als Hinweis aus dem Kalender)',
'E-Mail-Adresse des Gastes',
'Personenzahl',
'Gesamtpreis laut Portal',
$reference === null ? 'Buchungsnummer' : null,
])),
reference: $reference,
);
}
/**
* Judges an entry and acts as the channel allows: records what was recognised and – only when the channel creates
* cases – creates the case, links the entry to its case or marks it for clarification.
*/
public function process(BlockedPeriod $block, string $source): IntakeDecision
{
$channel = $block->channel;
$mode = $channel?->case_intake ?? CaseIntakeMode::Off;
if (! $mode->records()) {
return new IntakeDecision(IntakeOutcome::Ignore, ['Automatische Übernahme ist für dieses Portal aus.']);
}
$decision = $this->evaluate($block);
$applied = false;
if ($mode->creates()) {
[$decision, $applied] = match ($decision->outcome) {
IntakeOutcome::Create => $this->create($block, $decision, $mode, $source),
IntakeOutcome::Link => [$decision, $this->link($block, $decision->booking, $decision->reasons[0] ?? '')],
IntakeOutcome::Clarify => [$decision, $this->flag($block, $decision->reasons[0] ?? '')],
default => [$decision, false],
};
}
$this->record($channel, $mode, $source, $decision, $applied, $block, null, $block->starts_on, $block->ends_on);
return $decision;
}
/**
* Takes over an existing portal entry by an explicit run of the landlord or operator (stock adoption), whatever the
* channel's switch says: certain bookings become cases (released by hand, never automatic), entries of known cases
* are linked, everything else is only reported.
*/
public function adopt(BlockedPeriod $block): IntakeDecision
{
$decision = $this->evaluate($block);
$applied = false;
if ($decision->outcome === IntakeOutcome::Create) {
[$decision, $applied] = $this->create($block, $decision, CaseIntakeMode::Create, IntakeObservation::SOURCE_ADOPTION);
} elseif ($decision->outcome === IntakeOutcome::Link) {
$applied = $this->link($block, $decision->booking, $decision->reasons[0] ?? '');
}
$this->record($block->channel, CaseIntakeMode::Create, IntakeObservation::SOURCE_ADOPTION, $decision, $applied, $block, null, $block->starts_on, $block->ends_on);
return $decision;
}
/**
* After a calendar sync: new or changed entries of the channel go through the intake; entries of known cases that
* disappeared or show other nights become reports on the case.
*/
public function afterSync(Channel $channel): void
{
$mode = $channel->case_intake ?? CaseIntakeMode::Off;
if (! $mode->records()) {
return;
}
$open = $channel->blockedPeriods()->whereIn('source', ['channel', 'email'])->whereNull('linked_booking_id')
->where('is_representation', false)->whereDate('ends_on', '>', CarbonImmutable::today())->orderBy('starts_on')->get();
foreach ($open as $block) {
$this->process($block, IntakeObservation::SOURCE_CALENDAR);
}
$linked = $channel->blockedPeriods()->withTrashed()->with('linkedBooking')->where('source', 'channel')->whereNotNull('linked_booking_id')
->whereHas('linkedBooking', fn ($query) => $query->whereIn('status', BookingStatus::occupying())->whereDate('departure', '>', CarbonImmutable::today()))->get();
foreach ($linked as $block) {
$case = $block->linkedBooking;
if ($block->trashed()) {
$this->report($channel, $mode, $case, IntakeOutcome::CancellationSignal, 'Der Eintrag '.$block->starts_on->format('d.m.').'–'.$block->ends_on->format('d.m.Y').' ist aus dem Kalender von '.$channel->name.' verschwunden. Das kann eine Stornierung sein, ist aber kein Nachweis – bitte im Portal prüfen.', 'gone:'.$block->id, IntakeObservation::SOURCE_CALENDAR, $block);
} elseif (! $block->starts_on->equalTo($case->arrival) || ! $block->ends_on->equalTo($case->departure)) {
$this->report($channel, $mode, $case, IntakeOutcome::ChangeSignal, 'Der Kalender von '.$channel->name.' meldet '.$block->starts_on->format('d.m.').'–'.$block->ends_on->format('d.m.Y').', der Vorgang hat '.$case->arrival->format('d.m.').'–'.$case->departure->format('d.m.Y').'. Bitte prüfen, ob die Buchung im Portal geändert wurde.', 'dates:'.$block->id.':'.$block->starts_on->toDateString().':'.$block->ends_on->toDateString(), IntakeObservation::SOURCE_CALENDAR, $block);
}
}
}
/**
* A portal e-mail reporting a cancellation: the case learns about it as a task; nothing is cancelled.
*
* @return Booking|null the case the report belongs to
*/
public function cancellationMail(Channel $channel, ParsedPortalMail $parsed, PortalEmail $mail): ?Booking
{
$case = $parsed->reference !== null ? $this->caseByReference($channel, $parsed->reference) : null;
$mode = $channel->case_intake ?? CaseIntakeMode::Off;
if ($case === null || ! $case->isBinding()) {
$this->record($channel, $mode, IntakeObservation::SOURCE_MAIL, new IntakeDecision(IntakeOutcome::Clarify, [$parsed->reference === null ? 'Stornierungsmail ohne Buchungsnummer – keinem Vorgang sicher zuzuordnen.' : 'Kein gebuchter Vorgang mit der Buchungsnummer '.$parsed->reference.'.'], reference: $parsed->reference), false, null, $mail, $parsed->startsOn, $parsed->endsOn);
return null;
}
$this->report($channel, $mode, $case, IntakeOutcome::CancellationSignal, $channel->name.' meldet eine Stornierung (E-Mail „'.$mail->subject.'“). Bitte prüfen Sie die Buchung und die nächsten Schritte.', 'mail:'.$mail->message_id, IntakeObservation::SOURCE_MAIL, null, $mail);
return $case;
}
/**
* A request e-mail of a portal: a request case with the dates and the reference (A2), when the channel creates
* cases; otherwise only recorded.
*/
public function inquiryMail(Channel $channel, ParsedPortalMail $parsed, PortalEmail $mail): IntakeDecision
{
$mode = $channel->case_intake ?? CaseIntakeMode::Off;
if (! $mode->records()) {
return new IntakeDecision(IntakeOutcome::Ignore, ['Automatische Übernahme ist für dieses Portal aus.']);
}
$profile = $this->settings->resolve($channel->property, $channel, IntakeKind::Inquiry);
$decision = match (true) {
! $parsed->hasPeriod() => new IntakeDecision(IntakeOutcome::Clarify, ['Anfrage erkannt, aber An- und Abreise nicht sicher lesbar.'], reference: $parsed->reference),
$parsed->reference !== null && ($case = $this->caseByReference($channel, $parsed->reference)) !== null => new IntakeDecision(IntakeOutcome::Link, ['Gleiche Anfragenummer '.$parsed->reference.' wie der Vorgang.'], $case, reference: $parsed->reference),
$parsed->endsOn->lessThanOrEqualTo(CarbonImmutable::today()) => new IntakeDecision(IntakeOutcome::Ignore, ['Liegt in der Vergangenheit.'], reference: $parsed->reference),
default => new IntakeDecision(IntakeOutcome::Inquiry, ['Anfrage-Mail von '.$channel->name.' mit Zeitraum.'], caseType: $profile->caseType, missing: ['Name und E-Mail-Adresse des Gastes', 'Personenzahl'], reference: $parsed->reference),
};
$applied = false;
if ($mode->creates() && $decision->outcome === IntakeOutcome::Inquiry) {
try {
$case = $this->inquiry->handle($channel, $parsed->startsOn, $parsed->endsOn, $parsed->reference, 'Automatisch aus der Anfrage-Mail von '.$channel->name.' übernommen („'.$mail->subject.'“).', $mode === CaseIntakeMode::Create ? ProcessingMode::Manual : null);
CaseLog::record($case, 'intake', 'Automatisch aus der Anfrage-Mail von '.$channel->name.' angelegt', actor: CaseLog::SYSTEM, data: ['source' => IntakeObservation::SOURCE_MAIL, 'message_id' => $mail->message_id]);
$decision = $decision->withBooking($case);
$applied = true;
} catch (ReservationException|QuoteException $exception) {
$decision = $decision->as(IntakeOutcome::Clarify, ['Anfrage nicht automatisch übernommen: '.$exception->getMessage()]);
}
}
$this->record($channel, $mode, IntakeObservation::SOURCE_MAIL, $decision, $applied, null, $mail, $parsed->startsOn, $parsed->endsOn);
return $decision;
}
/**
* The portal's booking reference of an entry: extracted by the calendar rules, or the one of a booking e-mail.
*/
public static function reference(BlockedPeriod $block): ?string
{
$fromRules = $block->ical_interpretation['fields']['booking_reference'] ?? null;
if (filled($fromRules)) {
return trim((string) $fromRules);
}
if ($block->source === 'email' && str_starts_with((string) $block->external_uid, 'email:')) {
$reference = substr((string) $block->external_uid, 6);
// Mails without a reference got a random identifier, which is no booking reference.
return preg_match('/^[0-9a-f]{32}$/', $reference) === 1 ? null : $reference;
}
return null;
}
/**
* The case of a portal booking with this reference: on the case itself or on an entry that belongs to a case.
*/
public function caseByReference(Channel $channel, string $reference): ?Booking
{
$case = Booking::query()->where('portal_reference', $reference)
->where(fn ($query) => $query->where('origin_channel_id', $channel->id)->orWhere('import_channel_id', $channel->id))
->orderBy('id')->first();
if ($case !== null) {
return $case;
}
$linked = $channel->blockedPeriods()->withTrashed()->whereNotNull('linked_booking_id')
->whereIn('external_uid', [$reference, 'email:'.$reference])->value('linked_booking_id');
return $linked !== null ? Booking::query()->find($linked) : null;
}
/**
* The one occupying case of this portal with exactly these nights (more than one: none – that is for a person).
*/
private function caseWithSameNights(BlockedPeriod $block, int $channelId): ?Booking
{
/** @var Collection<int, Booking> $cases */
$cases = Booking::query()->occupying()->where('property_id', $block->property_id)
->whereDate('arrival', $block->starts_on)->whereDate('departure', $block->ends_on)
->where(fn ($query) => $query->where('origin_channel_id', $channelId)->orWhere('import_channel_id', $channelId))
->get();
return $cases->count() === 1 ? $cases->first() : null;
}
/**
* Null when the entry is certainly a booking of its portal, otherwise why not.
*/
private function certainty(BlockedPeriod $block, ?string $reference): ?string
{
if ($block->needs_review && ! in_array($block->review_note, [ReconcileChannelRepresentations::OVERLAP_NOTE], true)) {
return 'Prüfhinweis am Eintrag: '.($block->review_note ?? 'bitte prüfen').'.';
}
if ($block->source === 'email') {
return $reference === null ? 'Buchungsmail ohne Buchungsnummer – ohne Nummer lässt sich ein späterer Kalendereintrag nicht sicher zuordnen.' : null;
}
// Classified by the landlord as a reservation booked at this portal.
if ($block->occupation_kind === OccupationKind::Reservation && $block->reviewed_at !== null && $block->origin_channel_id === $block->channel_id) {
return null;
}
$interpretation = (array) ($block->ical_interpretation ?? []);
if (! ($interpretation['matched'] ?? false)) {
return 'Kein Kalendermerkmal erkannt – eine reine Belegt-Meldung ist kein Nachweis einer Buchung.';
}
if (($interpretation['event_type'] ?? null) !== 'portal_reservation') {
return 'Die Regel „'.($interpretation['rule'] ?? '').'“ ordnet den Eintrag nicht als Buchung ein.';
}
if (($interpretation['representation'] ?? null) !== 'leading_candidate' || $block->origin_channel_id !== $block->channel_id) {
return 'Die Regel erkennt eine Reservierung, aber nicht sicher als Buchung bei diesem Portal.';
}
return null;
}
/**
* @return array{IntakeDecision, bool}
*/
private function create(BlockedPeriod $block, IntakeDecision $decision, CaseIntakeMode $mode, string $source): array
{
$channel = $block->channel;
$fields = (array) ($block->ical_interpretation['fields'] ?? []);
$name = trim((string) ($fields['guest_full_name'] ?? $fields['guest_first_name'] ?? ''));
$origin = match ($source) {
IntakeObservation::SOURCE_MAIL => 'der Buchungsmail',
IntakeObservation::SOURCE_ADOPTION => 'dem Bestand der Portalbelegungen',
default => 'dem Kalender',
};
try {
$case = $this->takeOver->handle($block->property, $channel, CarbonImmutable::parse($block->starts_on), CarbonImmutable::parse($block->ends_on), [
'portal_reference' => $decision->reference,
'notes' => 'Automatisch aus '.$origin.' von '.$channel->name.' übernommen.'.($name !== '' ? ' Name laut Portal: '.$name.'.' : ''),
'processing_mode' => $mode === CaseIntakeMode::Create ? ProcessingMode::Manual : null,
], $block);
} catch (ReservationException $exception) {
$this->flag($block, 'Nicht automatisch übernommen: '.$exception->getMessage());
return [$decision->as(IntakeOutcome::Clarify, ['Nicht automatisch übernommen: '.$exception->getMessage()]), false];
}
CaseLog::record($case, 'intake', 'Automatisch aus '.$origin.' von '.$channel->name.' angelegt', actor: CaseLog::SYSTEM, data: ['source' => $source, 'blocked_period_id' => $block->id, 'reference' => $decision->reference]);
return [$decision->withBooking($case), true];
}
/**
* Makes the entry a mirror of its case (the case leads availability and export).
*/
private function link(BlockedPeriod $block, ?Booking $case, string $reason): bool
{
if ($case === null || $block->linked_booking_id === $case->id || $block->is_representation) {
return false;
}
$block->forceFill([
'is_representation' => true, 'representation_automatic' => false, 'canonical_block_id' => null,
'linked_booking_id' => $case->id, 'export_approved' => false, 'needs_review' => false, 'reviewed_at' => now(),
'occupation_kind' => OccupationKind::Reservation, 'review_note' => self::LINK_NOTE,
])->save();
app(ReconcileChannelRepresentations::class)->handle($block->property);
CaseLog::record($case, 'intake', 'Weitere Quelle zugeordnet: '.($block->source === 'email' ? 'E-Mail' : 'Kalender').' von '.$block->channel?->name.' ('.$block->starts_on->format('d.m.').'–'.$block->ends_on->format('d.m.Y').')', $reason, actor: CaseLog::SYSTEM, data: ['blocked_period_id' => $block->id]);
return true;
}
/**
* Puts an uncertain entry in front of the landlord ("Zu erledigen") with the reason.
*/
private function flag(BlockedPeriod $block, string $reason): bool
{
if ($block->needs_review || $block->reviewed_at !== null) {
return false;
}
$block->forceFill(['needs_review' => true, 'review_note' => mb_substr($reason, 0, 250)])->saveQuietly();
return true;
}
/**
* A report of the portal about a known case: a task and an entry in the history – once per report.
*/
private function report(Channel $channel, CaseIntakeMode $mode, Booking $case, IntakeOutcome $outcome, string $message, string $key, string $source, ?BlockedPeriod $block = null, ?PortalEmail $mail = null): void
{
$fingerprint = hash('sha256', $channel->id.'|signal|'.$key);
$known = $case->events()->where('type', 'portal_signal')->get()->contains(fn ($event): bool => ($event->data['fingerprint'] ?? null) === $fingerprint);
$applied = false;
if ($mode->creates() && ! $known) {
$kind = $outcome === IntakeOutcome::CancellationSignal ? BookingTaskKind::PortalCancellationReported : BookingTaskKind::PortalChangeReported;
$task = BookingTask::query()->firstOrNew(['booking_id' => $case->id, 'kind' => $kind]);
$task->forceFill(['tenant_id' => $case->tenant_id, 'status' => BookingTaskStatus::Open, 'due_on' => today(), 'note' => mb_substr($message, 0, 1000), 'completed_by' => null, 'completed_at' => null])->save();
CaseLog::record($case, 'portal_signal', $message, actor: $channel->name, data: ['fingerprint' => $fingerprint, 'source' => $source]);
$applied = true;
}
$this->record($channel, $mode, $source, new IntakeDecision($outcome, [$message], $case, $case->case_type), $applied, $block, $mail, $block?->starts_on ?? $case->arrival, $block?->ends_on ?? $case->departure, $key);
}
/**
* Records the decision once per event and result (repeated syncs and mails add nothing).
*/
private function record(?Channel $channel, CaseIntakeMode $mode, string $source, IntakeDecision $decision, bool $applied, ?BlockedPeriod $block, ?PortalEmail $mail, mixed $startsOn, mixed $endsOn, ?string $key = null): void
{
if ($channel === null || ! $mode->records()) {
return;
}
$fingerprint = hash('sha256', implode('|', [
$channel->id, $mode->value, $decision->outcome->value, $key ?? '',
$block?->id ?? '', $mail?->message_id ?? '', $decision->booking?->id ?? '',
$startsOn instanceof \DateTimeInterface ? $startsOn->format('Y-m-d') : (string) $startsOn,
$endsOn instanceof \DateTimeInterface ? $endsOn->format('Y-m-d') : (string) $endsOn,
]));
try {
$observation = IntakeObservation::query()->firstOrNew(['fingerprint' => $fingerprint]);
if ($observation->exists) {
return;
}
$observation->fill([
'channel_id' => $channel->id, 'blocked_period_id' => $block?->id, 'portal_email_id' => $mail?->id,
'booking_id' => $decision->booking?->id, 'source' => $source, 'mode' => $mode, 'outcome' => $decision->outcome,
'applied' => $applied, 'case_type' => $decision->caseType?->value, 'reference' => $decision->reference,
'starts_on' => $startsOn, 'ends_on' => $endsOn, 'reasons' => $decision->reasons, 'missing' => $decision->missing,
'occurred_at' => now(),
]);
$observation->tenant_id = $channel->tenant_id;
$observation->save();
} catch (Throwable $exception) {
// The record must never stop the intake itself.
report($exception);
}
}
}
@@ -0,0 +1,123 @@
<?php
namespace App\Console\Commands;
use App\Channels\Intake\PortalIntake;
use App\Enums\ChannelTaskStatus;
use App\Enums\IntakeOutcome;
use App\Models\BlockedPeriod;
use App\Models\Booking;
use App\Models\Channel;
use App\Models\ChannelTask;
use App\Models\Tenant;
use App\Tenancy\TenantRunner;
use Illuminate\Console\Attributes\Description;
use Illuminate\Console\Attributes\Signature;
use Illuminate\Console\Command;
use Illuminate\Support\Facades\Storage;
#[Signature('channels:adopt-occupations
{--channel=* : Nur diese Kanal-IDs}
{--apply : Wirklich übernehmen (ohne: nur Vorschau)}
{--revert= : Eine frühere Übernahme anhand ihres Berichts zurücknehmen}')]
#[Description('Bestehende Portalbelegungen ohne Vorgang prüfen und – nur mit --apply – als Vorgang übernehmen bzw. dem vorhandenen Vorgang zuordnen (Bericht, wiederholbar, rücknehmbar)')]
class AdoptPortalOccupations extends Command
{
private const DIRECTORY = 'intake-adoptions';
/** Attributes of an entry that an adoption changes and a revert restores. */
private const RESTORED = ['is_representation', 'representation_automatic', 'canonical_block_id', 'linked_booking_id', 'export_approved', 'needs_review', 'reviewed_at', 'occupation_kind', 'guest_id', 'review_note'];
public function handle(TenantRunner $runner, PortalIntake $intake): int
{
if (filled($this->option('revert'))) {
return $this->revert((string) $this->option('revert'));
}
$apply = (bool) $this->option('apply');
$report = ['run' => now()->format('Ymd-His'), 'apply' => $apply, 'entries' => [], 'channel_task_ids' => []];
$firstTask = (int) ChannelTask::query()->withoutGlobalScopes()->max('id');
$runner->each(function (Tenant $tenant) use ($intake, $apply, &$report): void {
$channels = Channel::query()->when($this->option('channel'), fn ($query, $ids) => $query->whereKey($ids))->orderBy('id')->get();
foreach ($channels as $channel) {
$entries = $channel->blockedPeriods()->whereIn('source', ['channel', 'email'])->whereNull('linked_booking_id')
->where('is_representation', false)->whereDate('ends_on', '>', today())->orderBy('starts_on')->get();
foreach ($entries as $entry) {
$before = collect(self::RESTORED)->mapWithKeys(fn (string $field): array => [$field => $entry->getRawOriginal($field)])->all();
$decision = $apply ? $intake->adopt($entry) : $intake->evaluate($entry);
$created = $apply && $decision->outcome === IntakeOutcome::Create && $decision->booking !== null;
$report['entries'][] = [
'tenant' => $tenant->id, 'channel' => $channel->name, 'blocked_period_id' => $entry->id,
'period' => $entry->starts_on->format('d.m.Y').'–'.$entry->ends_on->format('d.m.Y'),
'outcome' => $decision->outcome->value, 'case_type' => $decision->caseType?->value, 'reference' => $decision->reference,
'booking_id' => $decision->booking?->id, 'created' => $created, 'reasons' => $decision->reasons, 'before' => $before,
];
}
}
});
if ($apply) {
$report['channel_task_ids'] = ChannelTask::query()->withoutGlobalScopes()->where('id', '>', $firstTask)->pluck('id')->all();
}
$this->table(['Kanal', 'Zeitraum', 'Ergebnis', 'Art', 'Nr.', 'Vorgang', 'Begründung'], array_map(fn (array $entry): array => [
$entry['channel'], $entry['period'], IntakeOutcome::from($entry['outcome'])->getLabel(), strtoupper((string) $entry['case_type']), $entry['reference'] ?? '–',
$entry['booking_id'] ? '#'.$entry['booking_id'].($entry['created'] ? ' (neu)' : '') : '–', implode(' ', $entry['reasons']),
], $report['entries']));
$path = self::DIRECTORY.'/'.$report['run'].($apply ? '' : '-vorschau').'.json';
for ($number = 2; Storage::disk('local')->exists($path); $number++) {
$path = self::DIRECTORY.'/'.$report['run'].($apply ? '' : '-vorschau').'-'.$number.'.json';
}
Storage::disk('local')->put($path, json_encode($report, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE));
$counts = collect($report['entries'])->countBy('outcome');
$this->info(($apply ? 'Übernommen' : 'Vorschau – nichts geändert').': '.$counts->map(fn (int $count, string $outcome): string => IntakeOutcome::from($outcome)->getLabel().' '.$count)->implode(', '));
$this->line('Bericht: storage/app/private/'.$path.($apply ? ' (Rücknahme: --revert='.$path.')' : ''));
return self::SUCCESS;
}
/**
* Takes an adoption back: cases created by it are removed again as long as nothing has happened with them (no
* document, no payment), and every entry gets its former state. Cases with activity are reported, not touched.
*/
private function revert(string $path): int
{
if (! Storage::disk('local')->exists($path)) {
$this->error('Bericht nicht gefunden: '.$path);
return self::FAILURE;
}
$report = json_decode((string) Storage::disk('local')->get($path), true);
if (! ($report['apply'] ?? false)) {
$this->info('Das war eine Vorschau – es gibt nichts zurückzunehmen.');
return self::SUCCESS;
}
$kept = [];
foreach ((array) $report['entries'] as $entry) {
$block = BlockedPeriod::query()->withoutGlobalScopes()->withTrashed()->find($entry['blocked_period_id']);
$case = ($entry['created'] ?? false) ? Booking::query()->withoutGlobalScopes()->find($entry['booking_id']) : null;
if ($case !== null && ($case->contract_path !== null || $case->confirmation_sent_at !== null || $case->payments()->withoutGlobalScopes()->exists())) {
$kept[] = $case->reference;
continue;
}
// The entry first gets its former state (it may point to the case), then the case created by the run goes.
if ($block !== null && in_array($entry['outcome'], [IntakeOutcome::Create->value, IntakeOutcome::Link->value], true)) {
$block->forceFill((array) $entry['before'])->saveQuietly();
}
$case?->delete();
}
ChannelTask::query()->withoutGlobalScopes()->whereKey((array) ($report['channel_task_ids'] ?? []))->where('status', ChannelTaskStatus::Open)
->update(['status' => ChannelTaskStatus::Dismissed, 'automation_error' => 'Bestandsübernahme zurückgenommen.']);
$this->info('Zurückgenommen.'.($kept === [] ? '' : ' Nicht entfernt, weil schon bearbeitet: '.implode(', ', $kept)));
return self::SUCCESS;
}
}
+41
View File
@@ -0,0 +1,41 @@
<?php
namespace App\Console\Commands;
use App\Enums\IntakeOutcome;
use App\Models\IntakeObservation;
use App\Models\Tenant;
use App\Tenancy\TenantRunner;
use Illuminate\Console\Attributes\Description;
use Illuminate\Console\Attributes\Signature;
use Illuminate\Console\Command;
#[Signature('channels:intake-report {--days=14 : Zeitraum in Tagen}')]
#[Description('Bericht des Eingangsprotokolls: was über die Portale hereinkam und welche Vorgänge entstanden sind oder entstanden wären')]
class IntakeReport extends Command
{
public function handle(TenantRunner $runner): int
{
$runner->each(function (Tenant $tenant): void {
$observations = IntakeObservation::query()->with(['channel', 'booking'])
->where('occurred_at', '>=', now()->subDays((int) $this->option('days')))->orderBy('occurred_at')->get();
$this->line("<options=bold>{$tenant->name}</>: ".$observations->count().' Einträge');
$this->table(['Wann', 'Portal', 'Quelle', 'Zeitraum', 'Ergebnis', 'Ausgeführt', 'Vorgang', 'Begründung'], $observations->map(fn (IntakeObservation $observation): array => [
$observation->occurred_at->format('d.m. H:i'),
$observation->channel?->name,
$observation->sourceLabel(),
$observation->starts_on ? $observation->starts_on->format('d.m.').'–'.$observation->ends_on?->format('d.m.Y') : '–',
$observation->outcome->getLabel(),
$observation->applied ? 'ja' : 'nur protokolliert',
$observation->booking?->reference ?? '–',
implode(' ', (array) $observation->reasons),
])->all());
$wouldCreate = $observations->filter(fn (IntakeObservation $observation): bool => ! $observation->applied && in_array($observation->outcome, [IntakeOutcome::Create, IntakeOutcome::Inquiry], true))->count();
$this->info("Wären entstanden (Beobachten): {$wouldCreate}");
});
return self::SUCCESS;
}
}
+2
View File
@@ -25,6 +25,8 @@ public function handle(): int
$this->line("Versandweg: {$mailer}".($mailer === 'smtp' ? ' ('.config('mail.mailers.smtp.host').':'.config('mail.mailers.smtp.port').')' : '').' · Absender: '.config('mail.from.address'));
if (filled($redirect)) {
$this->line("Umleitung aktiv: die Mail geht an {$redirect} statt an {$to}.");
} elseif (! Settings::isLive()) {
$this->warn('Testbetrieb ohne Testadresse: Es wird keine E-Mail versendet. Testempfänger unter System › Betrieb eintragen.');
}
if ($mailer === 'log') {
$this->warn('Versandweg "log": es wird nichts zugestellt. Zum echten Versand MAIL_MAILER=smtp und MAIL_PASSWORD setzen (docs/BETRIEB.md §5a).');
+6 -2
View File
@@ -17,6 +17,8 @@ enum BookingTaskKind: string implements HasLabel
case CancellationRequest = 'cancellation_request';
case CancellationFee = 'cancellation_fee';
case PortalCancellation = 'portal_cancellation';
case PortalCancellationReported = 'portal_cancel_reported';
case PortalChangeReported = 'portal_change_reported';
public function getLabel(): string
{
@@ -27,12 +29,14 @@ public function getLabel(): string
self::CancellationRequest => 'Stornierungswunsch des Gastes',
self::CancellationFee => 'Stornokosten prüfen und abrechnen',
self::PortalCancellation => 'Stornierung im Portal veranlassen bzw. prüfen',
self::PortalCancellationReported => 'Das Portal meldet eine Stornierung – bitte prüfen',
self::PortalChangeReported => 'Das Portal meldet eine Änderung – bitte prüfen',
};
}
public function isPayment(): bool
{
return ! in_array($this, [self::CancellationRequest, self::CancellationFee, self::PortalCancellation], true);
return ! in_array($this, [self::CancellationRequest, self::CancellationFee, self::PortalCancellation, self::PortalCancellationReported, self::PortalChangeReported], true);
}
/**
@@ -46,7 +50,7 @@ public function reminder(): ?array
self::DepositReminder => [PaymentReminder::DEPOSIT_OVERDUE, 'deposit_reminded_at'],
self::BalanceRequest => [PaymentReminder::BALANCE_REQUEST, 'balance_requested_at'],
self::BalanceReminder => [PaymentReminder::BALANCE_OVERDUE, 'balance_reminded_at'],
self::CancellationRequest, self::CancellationFee, self::PortalCancellation => null,
self::CancellationRequest, self::CancellationFee, self::PortalCancellation, self::PortalCancellationReported, self::PortalChangeReported => null,
};
}
}
+50
View File
@@ -0,0 +1,50 @@
<?php
namespace App\Enums;
use Filament\Support\Contracts\HasDescription;
use Filament\Support\Contracts\HasLabel;
/**
* Whether bookings and requests recognised on a channel become cases by themselves (UMSETZUNGSPLAN_v0.10 §5.5). Every
* channel starts switched off; observing only records what would happen. Creating cases never sends anything that the
* landlord has not released (documents need their release, package 3); only the last mode lets the new cases follow
* the automatic handling of the settings.
*/
enum CaseIntakeMode: string implements HasDescription, HasLabel
{
case Off = 'off';
case Observe = 'observe';
case Create = 'create';
case Continue = 'continue';
public function getLabel(): string
{
return match ($this) {
self::Off => 'Aus – Sie übernehmen Buchungen selbst',
self::Observe => 'Beobachten – nur protokollieren, was entstehen würde',
self::Create => 'Vorgänge anlegen – die nächsten Schritte geben Sie frei',
self::Continue => 'Vorgänge anlegen und nach Ihren Einstellungen weiterbearbeiten',
};
}
public function getDescription(): string
{
return match ($this) {
self::Off => 'Erkannte Buchungen erscheinen als Klärungsfall; nichts entsteht automatisch.',
self::Observe => 'Es entsteht nichts. Das Eingangsprotokoll zeigt, welche Vorgänge entstanden wären und warum.',
self::Create => 'Sicher erkannte Buchungen werden zum Vorgang; Sie geben jeden weiteren Schritt frei.',
self::Continue => 'Wie „anlegen“; danach laufen die Vorgänge automatisch oder mit Freigabe – wie unter „So arbeite ich“ eingestellt.',
};
}
public function records(): bool
{
return $this !== self::Off;
}
public function creates(): bool
{
return in_array($this, [self::Create, self::Continue], true);
}
}
+54
View File
@@ -0,0 +1,54 @@
<?php
namespace App\Enums;
use Filament\Support\Contracts\HasColor;
use Filament\Support\Contracts\HasLabel;
/**
* How far a block (or release) on a portal is proven (E-018). The three steps are different statements: entering the
* block does not show that the portal took it over, and a calendar feed we provide proves nothing about the portal.
*/
enum ChannelTaskProof: string implements HasColor, HasLabel
{
/** The change was made or started (by hand or by an automation). */
case Initiated = 'initiated';
/** The block was seen in the portal's own calendar. */
case Observed = 'observed';
/** The portal confirmed it (e.g. its own confirmation or a test booking was refused). */
case Confirmed = 'confirmed';
public function getLabel(): string
{
return match ($this) {
self::Initiated => 'veranlasst',
self::Observed => 'im Portal gesehen',
self::Confirmed => 'Wirksamkeit bestätigt',
};
}
public function getColor(): string
{
return match ($this) {
self::Initiated => 'warning',
self::Observed => 'info',
self::Confirmed => 'success',
};
}
/**
* The choice the landlord reads when completing a task.
*/
public function question(bool $block = true): string
{
$what = $block ? 'gesperrt' : 'freigegeben';
return match ($this) {
self::Initiated => "Ich habe den Zeitraum im Portal {$what}.",
self::Observed => "… und im Kalender des Portals gesehen, dass er {$what} ist.",
self::Confirmed => 'Das Portal hat es bestätigt (z. B. Bestätigung oder Testanfrage abgelehnt).',
};
}
}
+56
View File
@@ -0,0 +1,56 @@
<?php
namespace App\Enums;
use Filament\Support\Contracts\HasColor;
use Filament\Support\Contracts\HasLabel;
/**
* What the intake made of one incoming event (portal calendar entry or portal e-mail).
*/
enum IntakeOutcome: string implements HasColor, HasLabel
{
/** A booking binding on the portal, recognised with confidence: a new case (A3–A5). */
case Create = 'create';
/** A non-binding request through the portal: a new request case (A2). */
case Inquiry = 'inquiry';
/** The same booking as an existing case (reference, same portal and dates, or its calendar mirror). */
case Link = 'link';
/** Not certain enough: the landlord clarifies. */
case Clarify = 'clarify';
/** No booking of this portal (block, mirror of another portal, own use, already clarified). */
case Ignore = 'ignore';
/** The portal reports a cancellation of a known case. */
case CancellationSignal = 'cancellation';
/** The portal reports other dates for a known case, or its calendar entry disappeared. */
case ChangeSignal = 'change';
public function getLabel(): string
{
return match ($this) {
self::Create => 'Neuer Vorgang (Buchung)',
self::Inquiry => 'Neuer Vorgang (Anfrage)',
self::Link => 'Gehört zu vorhandenem Vorgang',
self::Clarify => 'Klärung nötig',
self::Ignore => 'Keine Buchung',
self::CancellationSignal => 'Portal meldet Stornierung',
self::ChangeSignal => 'Portal meldet Änderung',
};
}
public function getColor(): string
{
return match ($this) {
self::Create, self::Inquiry => 'success',
self::Link, self::Ignore => 'gray',
self::Clarify => 'warning',
self::CancellationSignal, self::ChangeSignal => 'danger',
};
}
}
@@ -9,7 +9,9 @@
use App\Enums\ProcessingMode;
use App\Enums\ProcessSetting;
use App\Enums\Responsibility;
use App\Models\BlockedPeriod;
use App\Models\Booking;
use App\Models\IntakeObservation;
use App\Models\User;
use App\Process\CaseActivities;
use App\Process\CaseAutomation;
@@ -123,6 +125,7 @@ public static function configure(Schema $schema): Schema
TextEntry::make('status')->label('Status')->badge(),
TextEntry::make('case_type')->label('Vorgangsart')->state(fn (Booking $record): string => strtoupper($record->caseType()->value).' – '.$record->caseType()->getLabel()),
TextEntry::make('intake')->label('Eingangsart')->state(fn (Booking $record): string => $record->intake?->getLabel() ?? '–'),
TextEntry::make('sources')->label('Quellen und Kalenderdarstellungen')->state(fn (Booking $record): HtmlString => self::sources($record))->html()->columnSpanFull(),
TextEntry::make('profile')->label('Abwicklungsprofil (eingefroren)')->state(fn (Booking $record): HtmlString => self::profile($record))->html()->columnSpanFull(),
TextEntry::make('hold_expires_at')->label('Reserviert bis')->dateTime('d.m.Y, H:i')->placeholder('–'),
TextEntry::make('offer_hash')->label('Angebot (Prüfsumme)')->state(fn (Booking $record): ?string => $record->offer_version > 0 ? 'Version '.$record->offer_version.' · '.substr((string) $record->offer_hash, 0, 16) : null)->placeholder('–'),
@@ -161,6 +164,22 @@ private static function nextStep(Booking $booking): HtmlString
.'<div style="margin-top:.5rem;color:#6b7280;font-size:.9rem">'.$mode.'</div>');
}
/**
* Every portal entry (calendar or e-mail) that belongs to the case, and what the intake recorded about it.
*/
private static function sources(Booking $booking): HtmlString
{
$lines = BlockedPeriod::query()->withTrashed()->with('channel')->where('linked_booking_id', $booking->id)->orderBy('id')->get()
->map(fn (BlockedPeriod $entry): string => e(($entry->source === 'email' ? 'E-Mail' : 'Kalender').' von '.($entry->channel?->name ?? '–').': '.$entry->starts_on->format('d.m.').'–'.$entry->ends_on->format('d.m.Y')
.($entry->trashed() ? ' · nicht mehr im Kalender' : '').($entry->starts_on->equalTo($booking->arrival) && $entry->ends_on->equalTo($booking->departure) ? '' : ' · abweichende Termine').' · Kennung '.$entry->external_uid));
$observations = IntakeObservation::query()->with('channel')->where('booking_id', $booking->id)->orderBy('occurred_at')->get()
->map(fn (IntakeObservation $observation): string => e($observation->occurred_at->format('d.m.Y H:i').' · '.$observation->sourceLabel().' '.$observation->channel?->name.' · '.$observation->outcome->getLabel().($observation->applied ? '' : ' (nur protokolliert)')));
$html = $lines->isEmpty() ? 'Keine Portaleinträge zugeordnet.' : $lines->implode('<br>');
return new HtmlString($observations->isEmpty() ? $html : $html.'<br><span style="color:#6b7280">Eingang: '.$observations->implode('<br>').'</span>');
}
/**
* The documents made for the case, as recorded when they were created (kind, template, date).
*/
@@ -2,9 +2,13 @@
namespace App\Filament\Resources\ChannelTasks\Tables;
use App\Enums\ChannelTaskAction;
use App\Enums\ChannelTaskProof;
use App\Enums\ChannelTaskStatus;
use App\Models\ChannelTask;
use Filament\Actions\Action;
use Filament\Forms\Components\Radio;
use Filament\Forms\Components\Textarea;
use Filament\Support\Icons\Heroicon;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Filters\SelectFilter;
@@ -24,6 +28,8 @@ public static function configure(Table $table): Table
TextColumn::make('reason')->label('Anlass')->wrap(),
TextColumn::make('status')->label('Status')->badge()
->description(fn (ChannelTask $record): ?string => $record->completed_by ? "{$record->completed_by}, {$record->completed_at?->format('d.m. H:i')}" : null),
TextColumn::make('proof')->label('Nachweis')->state(fn (ChannelTask $record): string => $record->proofLabel())
->description(fn (ChannelTask $record): ?string => $record->proof_by ? "{$record->proof_by}, {$record->proof_at?->format('d.m. H:i')}" : null)->wrap(),
TextColumn::make('created_at')->label('Seit')->since(),
TextColumn::make('automation_error')->label('Automatisierung')->placeholder('–')->limit(40)->toggleable(isToggledHiddenByDefault: true),
])
@@ -45,7 +51,26 @@ public static function configure(Table $table): Table
->icon(Heroicon::OutlinedCheck)
->color('success')
->visible(fn (ChannelTask $record): bool => $record->status === ChannelTaskStatus::Open)
->action(fn (ChannelTask $record) => $record->complete(auth()->user()->name)),
->modalHeading(fn (ChannelTask $record): string => ($record->action === ChannelTaskAction::Block ? 'Sperre in ' : 'Freigabe in ').$record->channel->name.' erledigt')
->modalDescription('Was können Sie sagen? Ein bereitgestellter Kalender beweist nicht, dass das Portal ihn schon übernommen hat.')
->fillForm(['proof' => ChannelTaskProof::Initiated->value])
->schema(fn (ChannelTask $record): array => [
Radio::make('proof')->hiddenLabel()->required()
->options(collect(ChannelTaskProof::cases())->mapWithKeys(fn (ChannelTaskProof $proof): array => [$proof->value => $proof->question($record->action === ChannelTaskAction::Block)])->all()),
Textarea::make('note')->label('Notiz (optional)')->placeholder('z. B. „im Vermieterkalender rot markiert“')->rows(2),
])
->action(fn (ChannelTask $record, array $data) => $record->complete(auth()->user()->name, ChannelTaskProof::from($data['proof']), $data['note'] ?? null)),
Action::make('prove')
->label('Nachweis ergänzen')
->icon(Heroicon::OutlinedShieldCheck)
->color('gray')
->visible(fn (ChannelTask $record): bool => $record->status === ChannelTaskStatus::Done && $record->proof !== ChannelTaskProof::Confirmed)
->schema(fn (ChannelTask $record): array => [
Radio::make('proof')->hiddenLabel()->required()
->options(collect([ChannelTaskProof::Observed, ChannelTaskProof::Confirmed])->mapWithKeys(fn (ChannelTaskProof $proof): array => [$proof->value => $proof->question($record->action === ChannelTaskAction::Block)])->all()),
Textarea::make('note')->label('Notiz (optional)')->rows(2),
])
->action(fn (ChannelTask $record, array $data) => $record->prove(ChannelTaskProof::from($data['proof']), auth()->user()->name, $data['note'] ?? null)),
Action::make('dismiss')
->label('Verwerfen')
->icon(Heroicon::OutlinedXMark)
@@ -3,6 +3,7 @@
namespace App\Filament\Resources\Channels\Schemas;
use App\Channels\ChannelRegistry;
use App\Enums\CaseIntakeMode;
use App\Enums\ChannelBookingModel;
use App\Enums\ChannelEchoBehavior;
use App\Enums\ChannelExportMode;
@@ -55,6 +56,13 @@ public static function configure(Schema $schema, bool $selectProperty = false):
Select::make('status')->label('Kanalstatus')->options(ChannelStatus::class)->default(ChannelStatus::Setup)->required(),
Select::make('booking_model')->label('Was kommt über dieses Portal?')->options(ChannelBookingModel::class)->default(ChannelBookingModel::Mixed)->required()
->helperText('„Portalbuchung“ und „Gemischt“ gelten als Sofortbuchung: automatische Angebote für diese Wohnung warten, bis das Portal unseren Kalender abgerufen hat. „Vermittlung / Anfrage“: keine Sofortbuchung.'),
Select::make('case_intake')
->label('Erkannte Buchungen automatisch als Vorgang übernehmen?')
->options(CaseIntakeMode::class)
->default(CaseIntakeMode::Off)
->required()
->helperText('Zuerst „Beobachten“: Dann entsteht nichts, aber das Eingangsprotokoll (Expertenansicht) zeigt, welche Vorgänge entstanden wären. Unklare Belegungen und Meldungen zu gebuchten Vorgängen erscheinen unter „Zu erledigen“. Unterlagen gehen nie ohne Ihre Freigabe hinaus.')
->columnSpanFull(),
...self::processSections(),
Select::make('connector')
->label('Kalenderanbindung')
@@ -0,0 +1,83 @@
<?php
namespace App\Filament\Resources\IntakeObservations;
use App\Enums\CaseIntakeMode;
use App\Enums\IntakeOutcome;
use App\Filament\Concerns\FollowsAdminMode;
use App\Filament\Resources\Bookings\BookingResource;
use App\Filament\Resources\IntakeObservations\Pages\ListIntakeObservations;
use App\Models\Channel;
use App\Models\IntakeObservation;
use BackedEnum;
use Filament\Resources\Resource;
use Filament\Support\Icons\Heroicon;
use Filament\Tables\Columns\IconColumn;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Filters\SelectFilter;
use Filament\Tables\Table;
use UnitEnum;
/**
* The intake record (expert view): what came in over each portal, what the intake recognised, whether it acted or only
* observed, and why. Read only – the work itself happens under "Zu erledigen" and on the case page.
*/
class IntakeObservationResource extends Resource
{
use FollowsAdminMode;
protected static ?string $model = IntakeObservation::class;
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedInboxArrowDown;
protected static string|UnitEnum|null $navigationGroup = 'System';
protected static ?string $navigationLabel = 'Eingangsprotokoll';
protected static ?string $modelLabel = 'Eingang';
protected static ?string $pluralModelLabel = 'Eingangsprotokoll';
protected static ?int $navigationSort = 20;
public static function canCreate(): bool
{
return false;
}
public static function table(Table $table): Table
{
return $table
->description('Was über die Portale hereinkam und was daraus wurde. „Nur protokolliert“ heißt: Das Portal steht auf „Beobachten“ (oder es war nichts zu tun) – es ist nichts entstanden.')
->defaultSort('occurred_at', 'desc')
->modifyQueryUsing(fn ($query) => $query->with(['channel', 'booking']))
->columns([
TextColumn::make('occurred_at')->label('Wann')->dateTime('d.m.Y H:i')->sortable(),
TextColumn::make('channel.name')->label('Portal')->description(fn (IntakeObservation $record): string => $record->sourceLabel()),
TextColumn::make('period')->label('Zeitraum')->state(fn (IntakeObservation $record): ?string => $record->starts_on ? $record->starts_on->format('d.m.').'–'.$record->ends_on?->format('d.m.Y') : null)->placeholder('–'),
TextColumn::make('outcome')->label('Ergebnis')->badge()->description(fn (IntakeObservation $record): string => implode(' ', (array) $record->reasons))->wrap(),
TextColumn::make('case_type')->label('Art')->formatStateUsing(fn (?string $state): string => strtoupper((string) $state))->placeholder('–'),
IconColumn::make('applied')->label('Ausgeführt')->boolean()->tooltip('Ja: Vorgang angelegt, zugeordnet, Aufgabe erstellt oder zur Klärung vorgelegt. Nein: nur protokolliert.'),
TextColumn::make('mode')->label('Einstellung')->formatStateUsing(fn (CaseIntakeMode $state): string => match ($state) {
CaseIntakeMode::Observe => 'Beobachten',
CaseIntakeMode::Create => 'Anlegen',
CaseIntakeMode::Continue => 'Anlegen + weiter',
CaseIntakeMode::Off => 'Aus',
})->toggleable(),
TextColumn::make('reference')->label('Buchungsnr.')->placeholder('–')->toggleable(),
TextColumn::make('booking.reference')->label('Vorgang')->placeholder('–')
->url(fn (IntakeObservation $record): ?string => $record->booking ? BookingResource::getUrl('view', ['record' => $record->booking]) : null),
TextColumn::make('missing')->label('Fehlt noch')->state(fn (IntakeObservation $record): string => implode(', ', (array) $record->missing))->placeholder('–')->wrap()->toggleable(isToggledHiddenByDefault: true),
])
->filters([
SelectFilter::make('channel_id')->label('Portal')->options(fn (): array => Channel::query()->orderBy('name')->pluck('name', 'id')->all()),
SelectFilter::make('outcome')->label('Ergebnis')->options(IntakeOutcome::class),
SelectFilter::make('applied')->label('Ausgeführt')->options(['1' => 'ja', '0' => 'nur protokolliert']),
]);
}
public static function getPages(): array
{
return ['index' => ListIntakeObservations::route('/')];
}
}
@@ -0,0 +1,11 @@
<?php
namespace App\Filament\Resources\IntakeObservations\Pages;
use App\Filament\Resources\IntakeObservations\IntakeObservationResource;
use Filament\Resources\Pages\ListRecords;
class ListIntakeObservations extends ListRecords
{
protected static string $resource = IntakeObservationResource::class;
}
@@ -3,7 +3,9 @@
namespace App\Filament\Resources\PortalOccupations\Pages;
use App\Filament\Resources\PortalOccupations\PortalOccupationResource;
use Filament\Actions\ActionGroup;
use Filament\Resources\Pages\ViewRecord;
use Filament\Support\Icons\Heroicon;
class ViewPortalOccupation extends ViewRecord
{
@@ -16,6 +18,9 @@ public function getTitle(): string
protected function getHeaderActions(): array
{
return PortalOccupationResource::occupationActions();
$actions = PortalOccupationResource::occupationActions();
[$primary, $more] = [array_slice($actions, 0, 3), array_slice($actions, 3)];
return [...$primary, ActionGroup::make($more)->label('Weitere Möglichkeiten')->icon(Heroicon::OutlinedEllipsisHorizontal)->button()->color('gray')];
}
}
@@ -4,6 +4,7 @@
use App\Actions\ClassifyPortalOccupation;
use App\Actions\OpenPortalFile;
use App\Actions\ResolveChannelOccupation;
use App\Enums\OccupationKind;
use App\Exceptions\ReservationException;
use App\Filament\Actions\AssignGuestAction;
@@ -15,11 +16,13 @@
use App\Filament\Resources\PortalOccupations\Pages\ManagePortalOccupations;
use App\Filament\Resources\PortalOccupations\Pages\ViewPortalOccupation;
use App\Models\BlockedPeriod;
use App\Models\Booking;
use App\Models\Channel;
use BackedEnum;
use Filament\Actions\Action;
use Filament\Actions\ActionGroup;
use Filament\Actions\ViewAction;
use Filament\Forms\Components\Radio;
use Filament\Forms\Components\Select;
use Filament\Infolists\Components\TextEntry;
use Filament\Notifications\Notification;
@@ -80,19 +83,85 @@ public static function table(Table $table): Table
TextColumn::make('channel.name')->label('Importkanal'),
TextColumn::make('property.name')->label('Wohnung')->toggleable(),
TextColumn::make('needs_review')->label('Prüffall')->formatStateUsing(fn (bool $state): string => $state ? 'Bitte prüfen' : '–')->description(fn (BlockedPeriod $record): ?string => $record->review_note),
])->recordActions([Action::make('fileLink')->label('Als Buchung übernehmen')->icon(Heroicon::OutlinedFolderPlus)->button()->color('primary')->visible(fn (BlockedPeriod $record): bool => static::canOpenFile($record))->url(fn (BlockedPeriod $record): string => static::getUrl('view', ['record' => $record])), static::showFileAction()->button(), ViewAction::make(), ActionGroup::make(static::occupationActions(withFile: false))->label('Weitere Aktionen')]);
])->recordActions([Action::make('clarifyLink')->label('Klären')->icon(Heroicon::OutlinedQuestionMarkCircle)->button()->color('warning')->visible(fn (BlockedPeriod $record): bool => static::isUnclear($record))->url(fn (BlockedPeriod $record): string => static::getUrl('view', ['record' => $record])), Action::make('fileLink')->label('Als Buchung übernehmen')->icon(Heroicon::OutlinedFolderPlus)->button()->color('primary')->visible(fn (BlockedPeriod $record): bool => static::canOpenFile($record))->url(fn (BlockedPeriod $record): string => static::getUrl('view', ['record' => $record])), static::showFileAction()->button(), ViewAction::make(), ActionGroup::make(static::occupationActions(withFile: false))->label('Weitere Aktionen')]);
}
public static function occupationActions(bool $withFile = true): array
{
return [
...($withFile ? [static::openFileAction(), static::showFileAction()] : []),
...($withFile ? [static::clarifyAction(), static::openFileAction(), static::showFileAction()] : []),
AssignGuestAction::make(),
static::classificationAction(),
...BlockedPeriodResource::portalActions(),
];
}
/**
* Whether the entry still waits for the landlord's answer (it is listed under "Zu erledigen").
*/
public static function isUnclear(BlockedPeriod $record): bool
{
return ! $record->trashed() && BlockedPeriod::query()->unclear()->whereKey($record->id)->exists();
}
/**
* The one question for an unclear portal entry, in plain words: is it a booking (then it becomes a case), does it
* belong to a case that already exists, or is it no booking at all? The detailed tools stay under "Weitere".
*/
public static function clarifyAction(): Action
{
return Action::make('clarify')->label('Klären: Was ist das?')->icon(Heroicon::OutlinedQuestionMarkCircle)->color('primary')
->visible(fn (BlockedPeriod $record): bool => static::isUnclear($record) && ! $record->is_representation)
->authorize(fn (BlockedPeriod $record): bool => auth()->user()?->can('update', $record) ?? false)
->modalHeading(fn (BlockedPeriod $record): string => 'Belegung von '.($record->channel?->name ?? 'einem Portal').' am '.$record->starts_on->format('d.m.').'–'.$record->ends_on->format('d.m.Y'))
->modalDescription(fn (BlockedPeriod $record): string => 'Für diesen Zeitraum wurde eine Belegung gemeldet. Bitte wählen Sie, was es ist.'.($record->review_note ? ' Hinweis: '.$record->review_note : ''))
->modalSubmitActionLabel('Übernehmen')
->schema(fn (BlockedPeriod $record): array => [
Radio::make('answer')->hiddenLabel()->required()->live()->options(array_filter([
'booking' => static::canOpenFile($record) ? 'Eine Buchung über '.($record->channel?->name ?? 'das Portal').' – als Vorgang übernehmen' : null,
'case' => static::sameNightCases($record) !== [] ? 'Gehört zu einem Vorgang, der schon da ist' : null,
'block' => 'Keine Buchung: Sperre, eigene Nutzung oder Spiegelung eines anderen Portals',
])),
Select::make('booking_id')->label('Vorgang')->options(fn (): array => static::sameNightCases($record))
->visible(fn (Get $get): bool => $get('answer') === 'case')->required(fn (Get $get): bool => $get('answer') === 'case'),
])
->action(function (BlockedPeriod $record, array $data, OpenPortalFile $open, ResolveChannelOccupation $resolve, ClassifyPortalOccupation $classify) {
try {
if ($data['answer'] === 'booking') {
$booking = $open->handle($record);
Notification::make()->title('Als Buchung übernommen')->success()->send();
return redirect(BookingResource::getUrl('view', ['record' => $booking]));
}
if ($data['answer'] === 'case') {
$resolve->handle($record, 'booking', (int) $data['booking_id']);
Notification::make()->title('Dem Vorgang zugeordnet')->success()->send();
return null;
}
$classify->handle($record, OccupationKind::Block);
$record->refresh()->forceFill(['needs_review' => false, 'reviewed_at' => now(), 'review_note' => 'Persönlich als Sperre eingeordnet.'])->save();
Notification::make()->title('Als Sperre eingeordnet')->success()->send();
} catch (ReservationException $exception) {
Notification::make()->title('Nicht möglich')->body($exception->getMessage())->danger()->send();
}
return null;
});
}
/**
* Cases of the same property with exactly these nights (the only ones the entry may belong to).
*
* @return array<int, string>
*/
public static function sameNightCases(BlockedPeriod $record): array
{
return Booking::query()->occupying()->with('guest')->where('property_id', $record->property_id)
->whereDate('arrival', $record->starts_on)->whereDate('departure', $record->ends_on)->get()
->mapWithKeys(fn (Booking $booking): array => [$booking->id => $booking->reference.' · '.$booking->guestName().' · '.$booking->bookingChannelLabel()])->all();
}
/**
* Takes a reservation from a portal calendar over as a case (no second, manual "file").
*/
+67
View File
@@ -0,0 +1,67 @@
<?php
namespace App\Listeners;
use App\Models\Tenant;
use App\Support\Settings;
use Illuminate\Mail\Events\MessageSending;
use Illuminate\Support\Facades\Log;
use Symfony\Component\Mime\Address;
use Symfony\Component\Mime\Email;
/**
* The one gate every outgoing e-mail passes – whichever mailer, mailable or notification sent it (Laravel fires
* MessageSending for every message right before the transport). In test operation it replaces every recipient (To, Cc,
* Bcc) by the test recipient; when no test recipient can be determined, the mail is not sent at all. Only a landlord
* switched live (and no server override) lets mails reach their real recipients.
*
* The operating mode is read fresh from the database for every mail, so a switch in the admin applies at once, also in
* long-running processes. Without any landlord the installation counts as being in test operation.
*/
class EnforceMailTestMode
{
public const ORIGINAL_RECIPIENTS_HEADER = 'X-Fewo-Testbetrieb-Original';
/**
* @return false|null false stops the mail; null lets it go on
*/
public function handle(MessageSending $event): ?bool
{
$message = $event->message;
$tenant = Settings::tenant();
$tenant = $tenant instanceof Tenant ? ($tenant->fresh() ?? $tenant) : null;
$override = config('fewo.mail_redirect_to');
if (blank($override) && $tenant?->isLive()) {
return null;
}
$redirect = Settings::mailRedirectFor($tenant);
if (blank($redirect) || filter_var($redirect, FILTER_VALIDATE_EMAIL) === false) {
// Test operation without anybody to redirect to: never fall through to the real recipients.
Log::warning('E-Mail im Testbetrieb nicht versendet: keine Testadresse eingerichtet.', ['subject' => $message instanceof Email ? $message->getSubject() : null, 'tenant' => $tenant?->id]);
return false;
}
if (! $message instanceof Email) {
Log::warning('E-Mail im Testbetrieb nicht versendet: unbekannter Nachrichtentyp.', ['type' => $message::class]);
return false;
}
$original = collect([...$message->getTo(), ...$message->getCc(), ...$message->getBcc()])
->map(fn (Address $address): string => $address->getAddress())->unique()->implode(', ');
$headers = $message->getHeaders();
$headers->remove('Cc');
$headers->remove('Bcc');
$headers->remove(self::ORIGINAL_RECIPIENTS_HEADER);
$message->to($redirect);
if ($original !== '') {
$headers->addTextHeader(self::ORIGINAL_RECIPIENTS_HEADER, mb_substr($original, 0, 900));
}
return null;
}
}
+4 -2
View File
@@ -4,6 +4,7 @@
use App\Channels\ChannelRegistry;
use App\Channels\Contracts\ChannelConnector;
use App\Enums\CaseIntakeMode;
use App\Enums\ChannelBookingModel;
use App\Enums\ChannelEchoBehavior;
use App\Enums\ChannelExportMode;
@@ -26,7 +27,7 @@
* A sales channel (portal) of a property. Our system leads: occupations are imported from the
* channel and every channel gets its own export feed without its own occupations.
*/
#[Fillable(['property_id', 'name', 'connector', 'settings', 'is_active', 'requires_manual_blocking', 'manage_url', 'status', 'booking_model', 'import_enabled', 'export_enabled', 'export_mode', 'external_poll_minutes', 'echo_behavior', 'echo_notes', 'operating_notes', 'portal_verified_at', 'payment_tasks_inquiry', 'payment_tasks_reservation', 'contract_template_id', 'contract_template_reservation_id', 'process_overrides'])]
#[Fillable(['property_id', 'name', 'connector', 'settings', 'is_active', 'requires_manual_blocking', 'manage_url', 'status', 'booking_model', 'import_enabled', 'export_enabled', 'export_mode', 'external_poll_minutes', 'echo_behavior', 'echo_notes', 'operating_notes', 'portal_verified_at', 'payment_tasks_inquiry', 'payment_tasks_reservation', 'contract_template_id', 'contract_template_reservation_id', 'process_overrides', 'case_intake'])]
#[Hidden(['export_token', 'previous_export_token', 'export_snapshot', 'settings', 'ical_analysis'])]
class Channel extends Model
{
@@ -36,7 +37,7 @@ class Channel extends Model
protected $attributes = [
'status' => 'setup', 'booking_model' => 'mixed', 'import_enabled' => false,
'export_enabled' => false, 'export_mode' => 'test',
'echo_behavior' => 'unverified',
'echo_behavior' => 'unverified', 'case_intake' => 'off',
];
protected static function booted(): void
@@ -63,6 +64,7 @@ protected function casts(): array
return [
'settings' => 'array',
'process_overrides' => 'array',
'case_intake' => CaseIntakeMode::class,
'ical_analysis' => 'encrypted:array',
'ical_analyzed_at' => 'immutable_datetime',
'ical_rules' => 'array',
+37 -2
View File
@@ -4,6 +4,7 @@
use App\Availability\AvailabilityChecker;
use App\Enums\ChannelTaskAction;
use App\Enums\ChannelTaskProof;
use App\Enums\ChannelTaskStatus;
use App\Models\Concerns\BelongsToTenant;
use Database\Factories\ChannelTaskFactory;
@@ -18,7 +19,7 @@
* A change that has to be made by hand (or by an external automation) on a portal that
* cannot be kept in sync fast enough by calendar feeds, e.g. because of instant booking.
*/
#[Fillable(['channel_id', 'action', 'starts_on', 'ends_on', 'reason', 'status', 'completed_by', 'completed_at', 'reminded_at', 'automation_sent_at', 'automation_error'])]
#[Fillable(['channel_id', 'action', 'starts_on', 'ends_on', 'reason', 'status', 'completed_by', 'completed_at', 'reminded_at', 'automation_sent_at', 'automation_error', 'proof', 'proof_note', 'proof_at', 'proof_by'])]
class ChannelTask extends Model
{
/** @use HasFactory<ChannelTaskFactory> */
@@ -39,6 +40,8 @@ protected function casts(): array
'completed_at' => 'immutable_datetime',
'reminded_at' => 'immutable_datetime',
'automation_sent_at' => 'immutable_datetime',
'proof' => ChannelTaskProof::class,
'proof_at' => 'immutable_datetime',
];
}
@@ -60,7 +63,10 @@ protected function open(Builder $query): Builder
return $query->where('status', ChannelTaskStatus::Open);
}
public function complete(string $completedBy): void
/**
* Completes the task with the proof the person can give (at least: the change was made or started).
*/
public function complete(string $completedBy, ChannelTaskProof $proof = ChannelTaskProof::Initiated, ?string $note = null): void
{
if ($this->status !== ChannelTaskStatus::Open) {
return;
@@ -74,9 +80,38 @@ public function complete(string $completedBy): void
'status' => ChannelTaskStatus::Done,
'completed_by' => $completedBy,
'completed_at' => now(),
'proof' => $proof,
'proof_note' => filled($note) ? trim($note) : null,
'proof_at' => now(),
'proof_by' => $completedBy,
]);
}
/**
* Raises the proof of a completed task (e.g. the block was later seen in the portal); never lowers it.
*/
public function prove(ChannelTaskProof $proof, string $by, ?string $note = null): void
{
$order = array_flip(array_map(fn (ChannelTaskProof $case): string => $case->value, ChannelTaskProof::cases()));
if ($this->status !== ChannelTaskStatus::Done || ($this->proof !== null && $order[$proof->value] <= $order[$this->proof->value])) {
return;
}
$this->update(['proof' => $proof, 'proof_note' => filled($note) ? trim($note) : $this->proof_note, 'proof_at' => now(), 'proof_by' => $by]);
}
/**
* The state of the task in plain words, including how far it is proven.
*/
public function proofLabel(): string
{
return match ($this->status) {
ChannelTaskStatus::Open => 'noch offen',
ChannelTaskStatus::Dismissed => 'verworfen',
ChannelTaskStatus::Done => ($this->proof ?? ChannelTaskProof::Initiated)->getLabel().($this->proof_note ? ' ('.$this->proof_note.')' : ''),
};
}
/**
* Human readable period, e.g. "14.06.2027 – 21.06.2027".
*/
+72
View File
@@ -0,0 +1,72 @@
<?php
namespace App\Models;
use App\Enums\CaseIntakeMode;
use App\Enums\IntakeOutcome;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
/**
* One entry of the intake record: an incoming portal event, what the intake recognised and whether it acted. The same
* event with the same result is recorded once (fingerprint), however often the calendar is read or the mail arrives.
*/
#[Fillable(['channel_id', 'blocked_period_id', 'portal_email_id', 'booking_id', 'fingerprint', 'source', 'mode', 'outcome', 'applied', 'case_type', 'starts_on', 'ends_on', 'reference', 'reasons', 'missing', 'occurred_at'])]
class IntakeObservation extends Model
{
use BelongsToTenant;
public const SOURCE_CALENDAR = 'calendar';
public const SOURCE_MAIL = 'mail';
public const SOURCE_ADOPTION = 'adoption';
/**
* Get the attributes that should be cast.
*
* @return array<string, string>
*/
protected function casts(): array
{
return [
'mode' => CaseIntakeMode::class,
'outcome' => IntakeOutcome::class,
'applied' => 'boolean',
'starts_on' => 'immutable_date',
'ends_on' => 'immutable_date',
'reasons' => 'array',
'missing' => 'array',
'occurred_at' => 'immutable_datetime',
];
}
/** @return BelongsTo<Channel, $this> */
public function channel(): BelongsTo
{
return $this->belongsTo(Channel::class);
}
/** @return BelongsTo<Booking, $this> */
public function booking(): BelongsTo
{
return $this->belongsTo(Booking::class);
}
/** @return BelongsTo<BlockedPeriod, $this> */
public function blockedPeriod(): BelongsTo
{
return $this->belongsTo(BlockedPeriod::class)->withTrashed();
}
public function sourceLabel(): string
{
return match ($this->source) {
self::SOURCE_MAIL => 'Portal-E-Mail',
self::SOURCE_ADOPTION => 'Bestandsübernahme',
default => 'Portalkalender',
};
}
}
+9 -2
View File
@@ -27,6 +27,9 @@ class CaseActivities
/** Activities that are listed on their own in the work list (they are not "the" next step of a case). */
private const LISTED_SEPARATELY = ['channel_block'];
/** Activities that are the next step whatever else is open. */
private const URGENT = ['task_portal_cancel_reported', 'task_portal_change_reported'];
/**
* @return list<Activity>
*/
@@ -110,7 +113,7 @@ public static function for(Booking $booking): array
}
foreach (self::channelTasks($booking) as $task) {
$activities[] = new Activity('channel_block', ($task->action->value === 'block' ? 'In ' : 'Freigeben in ').$task->channel?->name.($task->action->value === 'block' ? ' sperren' : ''), $task->status === ChannelTaskStatus::Open ? ActivityState::Open : ActivityState::Done, $task->period(), url: ChannelTaskResource::getUrl());
$activities[] = new Activity('channel_block', ($task->action->value === 'block' ? 'In ' : 'Freigeben in ').$task->channel?->name.($task->action->value === 'block' ? ' sperren' : ''), $task->status === ChannelTaskStatus::Open ? ActivityState::Open : ActivityState::Done, $task->period().' · '.$task->proofLabel(), url: ChannelTaskResource::getUrl());
}
if ($profile->payments() === Responsibility::Portal) {
@@ -157,7 +160,11 @@ public static function for(Booking $booking): array
*/
public static function next(Booking $booking): ?Activity
{
foreach (self::for($booking) as $activity) {
$activities = self::for($booking);
// A report of the portal (cancellation, other dates) comes before everything else on the case.
usort($activities, fn (Activity $a, Activity $b): int => (int) in_array($b->key, self::URGENT, true) <=> (int) in_array($a->key, self::URGENT, true));
foreach ($activities as $activity) {
if ($activity->state->needsAction() && ! in_array($activity->key, self::LISTED_SEPARATELY, true)) {
return $activity;
}
+2 -2
View File
@@ -62,8 +62,8 @@ public static function items(): array
foreach (BlockedPeriod::query()->unclear()->with(['channel', 'property'])->whereDate('ends_on', '>=', today())->orderBy('starts_on')->get() as $occupation) {
$items[] = [
'title' => 'Unbekannte Belegung von '.($occupation->channel?->name ?? 'einem Portal').' – was ist das?',
'detail' => $occupation->starts_on->format('d.m.').'–'.$occupation->ends_on->format('d.m.Y').' · '.$occupation->property?->name,
'title' => 'Belegung von '.($occupation->channel?->name ?? 'einem Portal').' klären',
'detail' => 'Für den Zeitraum '.$occupation->starts_on->format('d.m.').'–'.$occupation->ends_on->format('d.m.Y').' wurde eine Belegung von '.($occupation->channel?->name ?? 'einem Portal').' gemeldet. Bitte klären Sie, um welche Art von Belegung es sich handelt. · '.$occupation->property?->name,
'url' => PortalOccupationResource::getUrl('view', ['record' => $occupation]),
'button' => 'Klären',
'tone' => 'warning',
+3 -7
View File
@@ -2,8 +2,8 @@
namespace App\Tenancy;
use App\Listeners\EnforceMailTestMode;
use App\Models\Tenant;
use App\Support\Settings;
use Illuminate\Mail\MailManager;
use Illuminate\Support\Facades\Mail;
use Throwable;
@@ -146,7 +146,8 @@ public function apply(?Tenant $tenant): void
}
/**
* The mailer sends everything to one address while the landlord is in test mode.
* Rebuilds the mailers so that they use the sender of the current landlord. Where mails go in test operation is
* decided for every single mail by the one gate {@see EnforceMailTestMode}, not here.
*/
public function applyMailRouting(?Tenant $tenant): void
{
@@ -157,11 +158,6 @@ public function applyMailRouting(?Tenant $tenant): void
}
$manager->purge();
$redirect = Settings::mailRedirectFor($tenant);
if (filled($redirect)) {
$manager->alwaysTo($redirect);
}
}
/**
@@ -0,0 +1,62 @@
<?php
use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;
/**
* Package 4 of UMSETZUNGSPLAN_v0.10 (one intake for all channels): every channel says whether recognised portal
* bookings become cases by themselves – off (default for every existing and new channel), observe, or create –, what
* the intake recognised is recorded, and portal tasks record how far a block on the portal is proven. Purely additive.
*/
return new class extends Migration
{
public function up(): void
{
Schema::table('channels', function (Blueprint $table): void {
$table->string('case_intake', 12)->default('off');
});
Schema::create('intake_observations', function (Blueprint $table): void {
$table->id();
$table->foreignId('tenant_id')->nullable()->constrained()->cascadeOnDelete();
$table->foreignId('channel_id')->constrained()->cascadeOnDelete();
$table->foreignId('blocked_period_id')->nullable()->constrained()->nullOnDelete();
$table->foreignId('portal_email_id')->nullable()->constrained()->nullOnDelete();
$table->foreignId('booking_id')->nullable()->constrained()->nullOnDelete();
$table->string('fingerprint', 64);
$table->string('source', 12);
$table->string('mode', 12);
$table->string('outcome', 20);
$table->boolean('applied')->default(false);
$table->string('case_type', 4)->nullable();
$table->date('starts_on')->nullable();
$table->date('ends_on')->nullable();
$table->string('reference', 100)->nullable();
$table->json('reasons')->nullable();
$table->json('missing')->nullable();
$table->timestamp('occurred_at');
$table->timestamps();
$table->unique(['tenant_id', 'fingerprint']);
$table->index(['channel_id', 'occurred_at']);
});
Schema::table('channel_tasks', function (Blueprint $table): void {
$table->string('proof', 12)->nullable();
$table->text('proof_note')->nullable();
$table->timestamp('proof_at')->nullable();
$table->string('proof_by')->nullable();
});
}
public function down(): void
{
Schema::table('channel_tasks', function (Blueprint $table): void {
$table->dropColumn(['proof', 'proof_note', 'proof_at', 'proof_by']);
});
Schema::dropIfExists('intake_observations');
Schema::table('channels', function (Blueprint $table): void {
$table->dropColumn('case_intake');
});
}
};
+1 -1
View File
@@ -74,7 +74,7 @@ ## 5. Konfiguration auf dem Server (`shared/.env`)
## 5a. E-Mail: Testbetrieb und scharf schalten
- **Betriebsart** in der Verwaltung: **System › Betrieb** (nur Administratoren). Jede Installation beginnt im **Testbetrieb**: alle E-Mails (an Gäste, Vermieterin, Benachrichtigungen) gehen ausschließlich an die dort eingetragene **Testadresse** (ohne Eintrag: `FEWO_NOTIFICATION_EMAIL`), egal was auf der Webseite eingetragen wurde. Ein gelber Hinweis oben in der Verwaltung zeigt das an. Erst „Scharf geschaltet“ liefert an die echten Empfänger.
- **Betriebsart** in der Verwaltung: **System › Betrieb** (nur Administratoren). Jede Installation beginnt im **Testbetrieb**: alle E-Mails (an Gäste, Vermieterin, Benachrichtigungen) gehen ausschließlich an die dort eingetragene **Testadresse** (ohne Eintrag: `FEWO_NOTIFICATION_EMAIL`), egal was auf der Webseite eingetragen wurde. Ein gelber Hinweis oben in der Verwaltung zeigt das an. Erst „Scharf geschaltet“ liefert an die echten Empfänger. Technisch prüft **eine einzige Schranke** jede ausgehende Mail unmittelbar vor dem Versand (`App\Listeners\EnforceMailTestMode`, Ereignis `MessageSending`, für jeden Mailer): Im Testbetrieb ersetzt sie An/Cc/Bcc durch die Testadresse (Original im Kopf `X-Fewo-Testbetrieb-Original`); **ohne jede Testadresse wird gar nichts versendet** (Warnung im Log). Der Modus wird für jede Mail frisch aus der Datenbank gelesen.
- **Adressen der internen Kommunikation** ebenfalls unter System › Betrieb: *Benachrichtigungen an* (mehrere Adressen: neue Anfragen, Angebotsantworten, Fristabläufe, Bewertungen, Portal-Mails/-Aufgaben, Kopie der Zahlungserinnerungen), *Kontakt- und Antwortadresse* (Webseite, Mietvertrag, Antwortadresse der Gäste-Mails), *Absendername/-adresse* (muss zum SMTP-Postfach `MAIL_USERNAME` passen – das Formular warnt). Ohne Eintrag gelten `FEWO_NOTIFICATION_EMAIL`, `FEWO_OWNER_EMAIL`, `MAIL_FROM_*` aus `shared/.env`.
- `FEWO_MAIL_REDIRECT_TO` in `shared/.env` ist eine **harte Überschreibung** für Testserver (gilt auch bei „scharf“); normalerweise leer lassen.
- **Versandweg:** Standard `MAIL_MAILER=log` – dann wird gar nichts zugestellt (auch nicht im Protokoll gespeichert). Für echten Versand in `shared/.env` `MAIL_MAILER=smtp` und `MAIL_PASSWORD=<Passwort des Postfachs info@fewo-stommer.de>` (nur selbst eintragen; Absender und SMTP-Anmeldung: `info@fewo-stommer.de`, Antwortadresse und Benachrichtigungen weiter `FEWO_OWNER_EMAIL`/`FEWO_NOTIFICATION_EMAIL` = fewo@stommer.de), dann `bash scripts/deploy.sh staging artisan optimize`.
-200
View File
@@ -1,200 +0,0 @@
{
"main": {
"id": "e551ceee940ecb6c",
"type": "split",
"children": [
{
"id": "45ad11e6bd426ed7",
"type": "tabs",
"children": [
{
"id": "6f2679f564edc126",
"type": "leaf",
"state": {
"type": "markdown",
"state": {
"file": "00_Prozesslandkarte.md",
"mode": "source",
"source": false
},
"icon": "lucide-file",
"title": "00_Prozesslandkarte"
}
}
]
}
],
"direction": "vertical"
},
"left": {
"id": "677ae3e7a3c51888",
"type": "split",
"children": [
{
"id": "d98321f663785e14",
"type": "tabs",
"children": [
{
"id": "cd2450a4f1ac56b2",
"type": "leaf",
"state": {
"type": "file-explorer",
"state": {
"sortOrder": "alphabetical",
"autoReveal": false,
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-folder-closed",
"title": "Dateiexplorer"
}
},
{
"id": "5ac14d1839d3ff95",
"type": "leaf",
"state": {
"type": "search",
"state": {
"query": "",
"matchingCase": false,
"explainSearch": false,
"collapseAll": false,
"extraContext": false,
"sortOrder": "alphabetical"
},
"icon": "lucide-search",
"title": "Suchen"
}
},
{
"id": "faa5cd42d8f20e2b",
"type": "leaf",
"state": {
"type": "bookmarks",
"state": {
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-bookmark",
"title": "Lesezeichen"
}
}
]
}
],
"direction": "horizontal",
"width": 300
},
"right": {
"id": "d7407959975136f3",
"type": "split",
"children": [
{
"id": "5595addba8cae338",
"type": "tabs",
"children": [
{
"id": "7aa1456df3c0e543",
"type": "leaf",
"state": {
"type": "backlink",
"state": {
"file": "00_Prozesslandkarte.md",
"collapseAll": false,
"extraContext": false,
"sortOrder": "alphabetical",
"showSearch": false,
"searchQuery": "",
"backlinkCollapsed": false,
"unlinkedCollapsed": true
},
"icon": "links-coming-in",
"title": "Rückverweise"
}
},
{
"id": "71826ebd06babd87",
"type": "leaf",
"state": {
"type": "outgoing-link",
"state": {
"file": "00_Prozesslandkarte.md",
"linksCollapsed": false,
"unlinkedCollapsed": true
},
"icon": "links-going-out",
"title": "Ausgehende Links"
}
},
{
"id": "94047f11d8cf598a",
"type": "leaf",
"state": {
"type": "tag",
"state": {
"sortOrder": "frequency",
"useHierarchy": true,
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-tags",
"title": "Tags"
}
},
{
"id": "ca2a154a0256f6d4",
"type": "leaf",
"state": {
"type": "all-properties",
"state": {
"sortOrder": "frequency",
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-archive",
"title": "Alle Eigenschaften"
}
},
{
"id": "154170f0a686e7f0",
"type": "leaf",
"state": {
"type": "outline",
"state": {
"file": "00_Prozesslandkarte.md",
"followCursor": false,
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-list",
"title": "Gliederung"
}
}
]
}
],
"direction": "horizontal",
"width": 300,
"collapsed": true
},
"left-ribbon": {
"hiddenItems": {
"switcher:Schnellauswahl öffnen": false,
"graph:Graph-Ansicht öffnen": false,
"canvas:Neuen Canvas erstellen": false,
"daily-notes:Heutige Notiz öffnen": false,
"templates:Vorlage einfügen": false,
"command-palette:Befehlspalette öffnen": false,
"bases:Neue Base erstellen": false
}
},
"active": "6f2679f564edc126",
"lastOpenFiles": [
"00_Prozesslandkarte.md",
"00_Buchungsarchetypen.md",
"00_Portalprofile_und_Vertragsvorlagen.md",
"Buchsungsprozesse/Willkommen.md",
"README.md",
"QUELLENMANIFEST.md"
]
}
@@ -1,168 +0,0 @@
---
id: A00
typ: archetypenkatalog
titel: FewoPortal – Buchungsarchetypen und Verantwortungsübergaben
status: diskussionsentwurf
version: "0.9"
stand: 2026-11-01
prozess: V01
bezugsstand_prozessarchitektur: "0.7"
---
# A00 – Buchungsarchetypen und Verantwortungsübergaben
> **Arbeitsstand für das Fachinterview, nicht abschließend freigegeben.** Grundlage: Betreiberbeschreibung vom 31.10.2026; Übergaben `UEBERGABE-BUCHUNGSPROZESS.md` (30.10.2026) und `crystalline-floating-glacier.md` (31.10.2026); Prozessarchitektur v0.7 und Szenarien R01/R08. **Bestätigte Geschäftsregeln, aktueller Praxisablauf, Annahmen und offene Fragen werden getrennt ausgewiesen.**
## 1. Gemeinsamer Grundsatz
FewoPortal ist das **führende interne Buchungsverwaltungssystem** für mehrere kleine Vermieter mit typischerweise 1–3 Wohnungen je Vermieter. Es gibt **einen generischen Wertschöpfungsprozess V01** mit den Phasen:
1. **P01** Buchungseingang & Verfügbarkeitssicherung
2. **P02** Konditionen & Buchungsverbindlichkeit
3. **P03** Buchungsverwaltung & kaufmännische Abwicklung
4. **P04** Leistungsvorbereitung & Aufenthalt
5. **P05** Abschluss & Nachbereitung
**Archetypen sind Geschäftskonstellationen, keine getrennt zu implementierenden Workflows.** Sie bestimmen die bei Eintritt bekannten Tatsachen, Zuständigkeiten, notwendigen Aktivitäten, Kommunikationswege und Nachweise. Derselbe **Vorgang** und dieselben Fachfunktionen werden verwendet. Die früher diskutierte zusätzlich anzulegende „Buchungsakte“ entfällt als eigenständige fachliche Einheit. Ein Portal kann einzelne Tätigkeiten durchführen; FewoPortal behält den konsolidierten Vorgangsüberblick, ohne fremde Primärnachweise vorzutäuschen.
## 2. Katalog der sechs Archetypen
| ID | Geschäftskonstellation | Zustand beim Eingang | Vertragsunterlagen | Zahlung / Storno | Informationsbedarf |
|---|---|---|---|---|---|
| **A1** | Kompletter Vorgang über eigene Website / FewoPortal | Unverbindliche Anfrage | Verbindliches eigenes Angebot, fristgerechte Annahme, anschließend Vertragsdokumentation | Wir | Eigene Anfrage- und Gastdaten, ggf. ergänzen |
| **A2** | Unverbindliche Anfrage eines Vermittlungsportals, Eingang z. B. über Portalnachricht, E-Mail, Telefon oder erkennbare iCal-Information | Noch keine Buchungsverbindlichkeit | Angebot/Annahme/Vertrag bei uns | Typischerweise wir, profilabhängig | Häufig unvollständig; gezielte Nachforderung |
| **A3** | Externe Direktbuchung mit anschließender vollständiger Abwicklung durch uns | Bereits verbindliche Portalbuchung | Wir versenden Dokumentation der bestehenden Vereinbarung, **keine zweite Annahme** | Wir | Buchung, Portalpreis und Gastdaten übernehmen / ergänzen |
| **A4** | Externe Direktbuchung mit **geteilter Abwicklung** (heutiger FeWo-direkt-Fall) | Bereits verbindliche Portalbuchung | Vertragsdokumentation durch uns ohne zweite Annahme | Zahlung über Portal; tatsächliche Storno-/Mahnverantwortung noch prüfen | Gastdaten, rechtsrelevante Konditionen, Portalstatus, lokale Abgaben |
| **A5** | Externe Direktbuchung mit weitgehend vollständiger Portalabwicklung | Bereits verbindliche Portalbuchung | Durch Portal, soweit tatsächlich vereinbart | Durch Portal, soweit tatsächlich vereinbart | Für Vor-Ort-Betreuung und rechtliche Pflichten benötigte Daten und Status |
| **A6** | Eigenbelegung, private Überlassung (z. B. Familie/Freunde) und sonstige Verfügbarkeitssperre | Interner Belegungsanlass | Je nach Fall Buchungs-/Aufenthaltsbestätigung, interne Reservierungsbestätigung oder kein Dokument | Gegebenenfalls Kurabgabe, Wäsche und andere Zusatzleistungen; bei reiner Sperre keine Gastzahlung | Gäste, Personen und Leistungen **optional**, Sperrgrund immer dokumentieren |
**Historische Einordnung E-012, fortgeschrieben durch E-022:** Der **frühere A6 „Hub-/Partnervermittlung“** wurde abgeschafft und bleibt abgeschafft. Die Kennung **A6 wird neu für interne Belegungs- und Sperrvorgänge** verwendet. Die Weitervermittlungsherkunft ist nur ein optionales kaufmännisches Merkmal. „Manuell/telefonisch“ ist weiterhin ein Eingangskanal und kein eigener Archetyp.
## 3. Gegenüberstellung entlang des generischen Prozesses
| Phase | A1 | A2 | A3 | A4 | A5 | A6 |
|---|---|---|---|---|---|---|
| **P01 Eingang** | Gastanfrage, Verfügbarkeit, ggf. zeitlicher Hold | Portalinformation prüfen, Anfrage qualifizieren, fehlende Daten nachfordern, ggf. Hold | Extern verbindliche Buchung übernehmen, Belegung sichern | Wie A3; Nachricht ggf. nur mit wenigen Gastdaten | Wie A3; lokale Datenversorgung sicherstellen | Internen Anlass erfassen, Zeitraum sichern, Sperrgrund protokollieren |
| **P02 Konditionen / Bindung** | Eigener Preis, bindendes Angebot, fristgerechte Annahme | Nach Ergänzung der Daten grundsätzlich wie A1 | **Verbindlichen Portalpreis übernehmen**; externen Abschluss nachweisen | Gleiches Prinzip; zusätzliche Prüfung der tatsächlich vereinbarten Portalbedingungen | Externen Abschluss/Konditionsstand dokumentieren, kein eigenes Angebot | Optional Gast-/Belegungsbestätigung; kein Mietvertrag für reine Sperre |
| **P03 Abwicklung** | Vertrag, Kalender, Fristen und eigene Zahlungsüberwachung | Grundsätzlich wie A1, Kommunikation ggf. im Portal | Vertragsdokumentation und gesamte weitere Abwicklung durch uns | Vertrag durch uns; Zahlung über Portal; Storno/Mahnung noch abgrenzen | Externe Abwicklung überwachen, soweit für unsere Aufgaben/Haftung erforderlich | Ggf. Gastdaten, Kurabgabe und gebuchte Zusatzleistungen/Zahlungen; reine Sperre ohne Gastabrechnung |
| **P04 Leistung** | Anreise, lokale Pflichten, Aufenthalt, Abreise | Wie A1 | Wie A1 | Wie A1, zuvor Gastinformationen nachfordern | Wie A1, soweit wir vor Ort verantwortlich sind | Private Nutzung oder Wartung; nur notwendige Aktivitäten |
| **P05 Abschluss** | Aufenthalt, Feedback, offene Fälle übergeben | Wie A1 | Wie A1 | Wie A1, ggf. offener Portal-Auszahlungs-/Stornofall | Lokale Erfüllung abschließen, relevante Portal-Ergebnisse erfassen | Nutzung/Arbeit beenden, Belegung freigeben, Folgen nachhalten |
Die Partnerherkunft begründet **keinen zusätzlichen Archetyp**; sie wird nur bei relevantem Einfluss auf die Vermittlerprovision oder notwendige Auswertung erfasst. Phasen können sich zeitlich überlappen; eine bereits extern verbindliche Buchung darf nicht durch offene Stammdaten künstlich unverbindlich werden.
## 4. Gemeinsame Informations- und Übergabegates
| Gate | Einheitlich benötigte Information / Nachweis | Vorgehen bei Lücke |
|---|---|---|
| **G1 – Eingang qualifiziert** | Objekt, Zeitraum, Eingangskanal, Buchungs-/Anfrageart, ggf. externe Referenz; Herkunft, soweit ermittelbar | Unklare Belegung als Klärungsfall; keine ungeprüfte verbindliche Buchung behaupten |
| **G2 – Bindung geklärt** | Entweder **eigenes** fristgerecht angenommenes Angebot oder **externer** Nachweis der Buchungsverbindlichkeit; maßgebliche Konditionen und Preis | Nachweis nachfordern / manuell prüfen; keine zweite Annahme der bereits verbindlichen Portalbuchung |
| **G3 – Abwicklung zugeordnet** | Zuständig für Vertrag, Zahlungsaufforderung, Zahlung, Mahnung, Storno, Rückerstattung, Kommunikation; relevante Fristen und Statusquellen | Zuständigkeit als offen markieren, Klärungsaufgabe erzeugen |
| **G4 – Leistung vorbereitet** | Erforderliche Gästedaten, Kontaktmöglichkeit, Anreise-/Leistungsinformationen, lokale gesetzliche Meldedaten soweit einschlägig | Datenbeschaffung über Portal, Gast oder manuell; Aufenthaltsvorbereitung gezielt verfolgen |
| **G5 – Leistung abgeschlossen** | Aufenthalt/Leistung beendet, Feedbackprozess angestoßen bzw. bearbeitet, offene Nachläufer einer zuständigen Bearbeitung übergeben | Fehlende Übergaben und lokale Folgeaufgaben sichtbar halten |
Pro Gate sind die Zustände **intern erfüllt / extern erfüllt (mit Quelle) / nicht anwendbar / offen** zu unterscheiden. Die **fachliche Bindung** und die **Vollständigkeit der Gastdaten** sind getrennte Dimensionen. Für einzelne Tätigkeiten kann es zusätzliche Feld- oder Fristvoraussetzungen geben.
## 5. A4 – FeWo-direkt als realer Referenzfall (Betreiberangaben)
**Bekannter bzw. beschriebener Ablauf:**
1. Gast bucht unmittelbar über FeWo-direkt; eine verbindliche Buchung entsteht laut Betreiber bereits dort.
2. FeWo-direkt bestätigt die Buchung und fordert Zahlungen (Anzahlung, Restbetrag) über seinen Zahlungsweg an.
3. FewoPortal erhält die Buchungsinformation; der Informationsumfang ist geringer als für die eigene Vertrags- und Aufenthaltsabwicklung erforderlich. Nach jüngster Betreiberangabe sind Name und E-Mail bekannt, die Anschrift fehlt; **tatsächlich übermittelte Felder müssen anhand eines Beispiels verifiziert werden**.
4. FewoPortal ordnet Buchung, Belegung, Portalkonditionen und Referenz zu. **Der vom Gast gebuchte Portalpreis wird nicht durch unsere Kalkulation ersetzt.**
5. Fehlende Gäste-/Vertrags- und ggf. örtliche Meldedaten werden über den verfügbaren Kontaktweg nachgefordert; manueller Fallback bleibt möglich.
6. Wir erstellen und versenden unsere Vertragsdokumentation **ohne erneute formale Annahme**; die Vereinbarung darf dabei nicht stillschweigend um andere Konditionen erweitert werden.
7. FewoPortal steuert Anreise, lokale Betreuung, Aufenthalt, Abreise und Abschluss. Externe Zahlungen/Statusmeldungen werden, soweit verfügbar und erforderlich, referenziert.
**Noch nicht bestätigt / zu prüfen:**
- Welche Vertragsinhalte und Zusatzbedingungen sieht der Gast **vor seiner bindenden Buchung** tatsächlich? Deckt sich das mit dem späteren von uns versandten Vertrag?
- Welche Partei / welcher Zahlungsdienstleister wickelt **Mahnung, Stornierung, Rückerstattung, Nichtzahlung und Schäden** in welcher Konstellation konkret ab?
- Welche Angaben umfasst der **verbindlich vereinbarte Gastpreis**? Werden Plattform-Servicegebühr für Reisende, Vermieterprovision, Steuer/Kurabgabe und Auszahlungsbetrag getrennt ausgewiesen? **Vermieterprovision nicht ohne Grundlage dem Gast zusätzlich berechnen.**
- Wie erhalten wir belastbare Statusinformationen über erfolgte Zahlungen, Stornos und Erstattungen? Wenn das Portal diese nicht maschinenlesbar liefert, ist der manuelle Nachweisweg zu definieren.
- Welche Daten sind für Kurabgabe/Meldepflichten tatsächlich erforderlich, und wann müssen diese vorliegen?
- Welches Ereignis wird beim Eingang einer Portalstornierung/Änderung ausgelöst; wie wird die Belegung aktualisiert und der Betreiber informiert?
**Rechtlicher Prüfvermerk, keine abschließende Bewertung:** Die offiziellen FeWo-direkt-Gastgeberbedingungen beschreiben die Vertragsbeziehung grundsätzlich zwischen Gast und Vermieter sowie Vorgaben zu offenzulegenden Bedingungen und Gebühren. Daraus lässt sich **nicht allein** ableiten, dass der konkrete nachträgliche Versand unseres Vertragsdokuments rechtswidrig oder rechtssicher ist. Zu prüfen sind tatsächlich angezeigte Vertragsbedingungen und konkreter Buchungsablauf. Quellen: [FeWo-direkt Gastgeberbedingungen](https://www.fewo-direkt.de/lp/b/partner-terms-of-use), [FeWo-direkt Gastbedingungen](https://www.fewo-direkt.de/lp/b/terms-of-service).
## 6. Übergreifende Regeln und bewusste Grenzen
- **Einheitliche Akte, einheitliche Konditions- und Vertragszusammenstellung**, keine getrennten Formulare je Kanal.
- Bei **A1/A2** ist unser befristetes Angebot für uns bindend; rechtzeitige Annahme macht die Buchung verbindlich. Bei Fristablauf ohne Annahme endet der Vorgang ohne Buchung, eigene Belegungssperre wird nach Konfliktprüfung freigegeben. **Hold- und Angebotsfrist müssen zusammenpassen** (konkrete Regel noch offen).
- Bei **A3–A5** wird die bestehende externe Verbindlichkeit **nicht** durch eigenen Angebotsversand oder einen erneuten Annahmeklick ersetzt.
- Portalpreise und zugesagte Konditionen sind als **externe Vereinbarung mit Quelle** abzulegen; unsere Vergleichskalkulation darf höchstens erklärend sein.
- Ein iCal-Belegungsereignis **allein** beweist nicht zwingend den Buchungsvertrag. Sichere Klassifikation kann zur automatischen Akte führen; unklare Ereignisse werden nicht still als Buchung interpretiert.
- Fehlende oder widersprüchliche Daten bleiben als **fehlt / unbestätigt / bekannt**, jeweils mit Quelle, sichtbar. Keine erfundenen Werte, keine vermeidbaren Dubletten-Gäste.
- Die Software für kleine Vermieter benötigt **keinen frei skriptbaren Workflow-Designer**; wenige nachvollziehbare Abwicklungsprofile und konfigurierbare Auslöser/Aktivitäten genügen zunächst.
- Automatisierte Entscheidungen sind nachzuvollziehen und bei Fehlzuordnung korrigierbar. Geschäftlich oder rechtlich wirksame Vorgänge sind nicht durch bloßes Löschen „rückgängig“ zu machen.
- Der V01-Prozess kann **regulär abgeschlossen**, **ohne Buchung beendet** oder **storniert** enden. Offene Folgefälle werden kontrolliert übergeben; nicht still verworfen.
## 7. Portalunabhängige Konditions- und Vertragsprofile (Ergänzung 31.10.2026)
**Bestätigte fachliche Regel:** Ein Buchungsportal kann eigene Preise, Rabatte, Stornoregeln und Buchungsbedingungen verwalten. Bei extern verbindlichen Buchungen sind die **tatsächlich vereinbarten Portalkonditionen** maßgeblich. Bei unverbindlichen externen Anfragen kann die anschließende Angebotsgestaltung vollständig bei uns liegen. Der konkrete Datenumfang und die Verfügbarkeit von Nachweisen sind je Portal verschieden.
**Vertragsvorlagen dürfen sich je Vermieter, Wohnung, Portal, Buchungstyp und ggf. tatsächlicher Partnerherkunft unterscheiden.** Die Auswahl erfolgt über das zutreffende Buchungs-/Abwicklungsprofil, **nicht nur über den allgemeinen Portaltyp**; der Vermieter kann sie bei Bedarf in der gemeinsamen Konditionszusammenstellung bewusst ändern. Die gewählte Vorlagenversion, Anlagen und der zugrunde liegende Konditionsstand werden pro Buchung unveränderlich dokumentiert.
Unterscheidung der Dokumentfunktion: **A1/A2** verwenden bindendes eigenes Angebot mit Annahme; **A3/A4** dokumentieren und versenden ggf. die bereits extern verbindliche Vereinbarung **ohne zweite Annahme**; **A5** verlangt eigene Vertragsdokumente nur, soweit dies fachlich/rechtlich tatsächlich erforderlich ist. Nicht belegte oder abweichende Konditionen sind Klärungsfälle, keine automatisch ergänzten Vertragspflichten.
**Zu konfigurierende Kanalmerkmale:** Herkunft verbindlicher Preise/Rabatte/Stornobedingungen, Erkennbarkeit und Nachweise, Zuständigkeiten, erlaubte Dokumente, automatische oder manuelle Datenerfassung und Vertragsversand. Kein hardcodiertes FeWo-direkt-Verhalten.
Siehe [[00_Portalprofile_und_Vertragsvorlagen|00 – Portalprofile und Vertragsvorlagen]] für das schlanke Referenzmodell.
## 8. Bezug zu vorhandenen Dokumenten
- [[00_Prozesslandkarte|Prozesslandkarte]] – V01/V02, fünf Phasen und übergreifende Leitregeln.
- [[G00_Gates_und_Uebergaben|Gates und Übergaben]] – konzeptionelle Gate-Logik.
- [[E00_Entscheidungsprotokoll|Entscheidungsprotokoll]] – bereits bestätigte Entscheidungen.
- [[X00_Sonderprozesse|Sonderprozesse]] – derzeit bekannte Ausnahmefamilien.
- [[R00_Szenarien/R01_Eigene_Webseite|Referenzfall eigene Webseite]] – gesonderter Arbeitsentwurf (sofern dieser bereits ins Repository übernommen wurde).
## 9. Ergänzende A4-Vertragsanalyse (Stand 31.10.2026)
Die vom Betreiber bereitgestellte vierseitige FeWo-direkt-Vertragsvorlage wurde unter [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 – Vertragsvorlage und Prozessanalyse]] gesondert bewertet. Besonders prüfbedürftig sind: Verbindlichkeit vor dem nachträglichen Vertragsversand (§ 5), zuvor einbezogene Konditionen, Preis-/Gebührentrennung (§ 4), Portalstorno gegenüber eigener Stornoklausel (§ 13), Datenbedarf sowie sichere Trennung von Vertragsdokument und Zugangs-/Anreiseinformationen. **Keine Änderung der Betreibervertragsklauseln ohne gesonderte rechtliche und fachliche Freigabe.**
**Status dieses Dokuments:** Fünf Archetypen (A1–A5) nach E-012; Portalprofile und rechtliche Detailfragen bleiben offen. Neben FeWo-direkt (A4) ist Destination Solutions (A3) dokumentierter Praxisfall.
## 10. A4-Praxisnachweis aus FeWo-direkt-Ansichten (31.10.2026)
Für eine konkrete zukünftige Buchung sind **aggregierte Übernachtungsrate, Rabatt, Gebühren/Steuern, Gesamtzahlung des Gastes, Abzug an FeWo-direkt, Auszahlungsvorschau sowie zwei Zahlungsraten und deren Fälligkeits-/Zahlungsstatus** im Vermieterbereich sichtbar. Auch angezeigte Stornobedingungen und der vorgesehene 72-Stunden-Anreiseinformationsversand sind erkennbar. **Nicht nachgewiesen** sind die vollständigen Tagespreis- und Gebührenbestandteile, ein belastbarer allgemeiner Zahlungsexport, die tatsächliche Auszahlung, der vollständige Vertragsinhalt der Gastbestätigung und die vollständigen Gaststammdaten. Zwei Ansichten weisen zudem **unterschiedliche voraussichtliche Vermieterauszahlungen (900,20 € / 894,69 €)** aus, Ursache offen. Details im [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse#7. Nachtrag aus belegten Bildschirmansichten (31.10.2026) – Ist-Zustand, nicht allgemeines Portalverhalten|A4-Vertrags- und Prozessdokument]].
**Portalinvariante:** Verantwortlichkeit für Zahlung oder Kommunikation, Portalstatus und tatsächlicher Erfüllungsnachweis sind getrennt zu verwalten.
## 11. Änderungs- und Stornoereignisse (portalunabhängig)
Ein Storno bzw. eine Buchungsänderung ist ein **Teilprozess auf demselben Vorgang**, kein zusätzlicher Archetyp. Die fachliche Ursache (Gastwunsch, Unmöglichkeit beim Vermieter, Doppelbuchung, Regelverstoß, technischer Fehler), der Initiator, der ausführende Beteiligte und die Abwicklungsverantwortung sind voneinander zu unterscheiden. Anfrage, Bestätigung und tatsächliche Wirksamkeit sind getrennte Ereigniszustände. Kalender, Konditionen, Vertrag und Zahlungen werden erst nach ausreichend belegter Wirksamkeit angepasst. Eine durch den Vermieter verursachte Stornierung darf nicht durch Aufforderung an den Gast als Gaststorno umetikettiert werden. **FeWo-direkt** ist dafür ein dokumentiertes Portalbeispiel (siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 Abschnitt 8]]); andere Portale können abweichende Wege, Daten und Zuständigkeiten haben.
## 12. Destination Solutions als Praxisreferenz A3 (E-012/E-016/E-017/E-018)
- **Verbindlicher Buchungseingang**, vollständige weitere Vertrags-, Gäste-, Zahlungs- und Aufenthaltsabwicklung beim Vermieter; keine zweite Angebotsannahme. Der Vermieter erhält laut Betreiber eine vollständige Buchungsmeldung für seine Abwicklung, **nicht zwingend eine vollständige Einzelpreis- oder Gebührenzerlegung**.
- **Keine im genutzten Zugang funktionierende automatische Kalendersynchronisation**; manuelles Blockieren anderer Portale. Ein Portalbeleg über den Zeitpunkt oder die wirksame Verteilung an Partnerkanäle steht nach Betreibererfahrung nicht zur Verfügung.
- **Vermittlerprovisionen** können nach Vertriebskanal variieren. Sie sind nicht nachträglich vom Gast zu fordern. Ob zusätzlich ein direkter Gast-Aufschlag/Serviceentgelt oder Partner-Endpreisaufschlag existiert, muss beim Anbieter und anhand einer Gastbestätigung geprüft werden.
- **Stornostaffel** vom Betreiber angegeben: ≥60 Tage 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, ≤11 Tage 100 % vom „Mietpreis“; **vorvertragliche Einbeziehung, Berechnungsbasis und rechtliche Wirksamkeit offen**.
Siehe [[R00_Szenarien/R08_Destination_Solutions|R08 Destination Solutions]] und [[O00_Offene_Portalprueffaelle|O00 Offene Portalprüffälle]].
## 13. Portaldaten können unterschiedlich detailliert und zusammengesetzt sein (E-014/E-015)
Bei A2–A5 sind **automatische, manuelle und hybride** Informationen und Tätigkeiten gleichwertig zu modellieren. Pro Buchung sind vollständig aufgeschlüsselte Positionen, **kombinierte Service-/Gebührenpositionen**, bloße Gesamtbeträge sowie nur teilweise verfügbare Zahlungsauszüge möglich. Keine fiktive Zerlegung des Gesamtpreises; unbekannte Gebührenarten, Zahlende/Empfänger und Provisionsanteile bleiben offen. Nachträgliche Zuordnung oder Aufteilung erhält den originalen Portalbetrag und verhindert doppelte Summierung. Fehlende rein interne Kostenanalyse blockiert nicht ohne Weiteres den vertraglichen Aufenthalt. Siehe [[K01_Preisstruktur_und_Abrechnung|K01]].
## 14. Erweiterung v0.9 – A6, einheitlicher Vorgang und pragmatischer Angebotsweg
**Beschluss E-022 bis E-027 (01.11.2026):** A6 umfasst **Eigenbelegung, unentgeltliche oder private Überlassung und sonstige Sperren**, mit konfigurierbarem Grund (z. B. Eigennutzung, Familienbesuch, Reparatur, Reinigung, organisatorische Sperre). Der Vorgang entsteht bei Erfassung des internen Anlasses genauso wie bei A1–A5; eine gesonderte „Buchungsakte anlegen“-Entscheidung entfällt. Die vorhandene Zuordnung extern eingehender Buchungen zum Auslöserportal/Owner wird **als bereits implementiert** vorausgesetzt, nicht neu beauftragt.
- **Optional statt ausnahmslos entgeltfrei:** Familienmitglieder oder Freunde können als Gäste mit Teilnehmerdaten erfasst werden; Kurabgabe, Wäschepakete und andere Zusatzleistungen können anfallen. Eine Mietzahlung ist keine Voraussetzung für diese Funktionen.
- **Gemeinsamer Prozesskern:** Belegung, Kontakte, Aktivitäten, Dokumente, Zahlungen, Ereignishistorie und Storno-/Änderungsfunktion werden soweit benötigt wiederverwendet. Bei einer Wartungssperre dürfen Gäste, Rechnungen und Vertragsdokumente vollständig entfallen. Keine künstliche Durchführung aller P01–P05-Teilschritte.
- **Dokument nach Profil:** Reservierungs-, Buchungs- oder Aufenthaltsbestätigung abhängig von Vermieter, Objekt, Anlass und Vorgangs-/Buchungstyp; reine Sperre kann ohne Versand bleiben. Ein Bestätigungsdokument darf keine nicht vereinbarten Pflichten erzeugen.
- **Abgrenzung zum Hold:** Eine zeitlich begrenzte Reservierung im Rahmen einer A1/A2-Anfrage ist **Teil desselben Vermietungsvorgangs**, kein separater A6.
- **Storno/Änderung:** Verkürzung, Verlängerung, Verschiebung oder Aufhebung einer A6-Belegung nutzt den gleichen technischen Mechanismus, jedoch ohne pauschal mietvertragliche Stornofolgen zu unterstellen.
**A1/A2-Angebotsvereinfachung (E-025/E-026):** Die konfigurierbare **Haltefrist** steuert die eigene Vorreservierung (beispielsweise 0, 24, 48 oder 72 Stunden). Bei Haltefrist größer null kann ein verbindliches, fristgebundenes Angebot mit passender Vorlage erstellt werden, sofern die eigene Sicherung zum Angebot passt. Bei **0** entsteht **keine Reservierung**; versendet wird eine passende Preis-/Verfügbarkeitsauskunft **ohne uneingeschränkt annehmbares Buchungsangebot**. Vor verbindlicher Buchung wird die Verfügbarkeit erneut geprüft und der Abschluss bestätigt. Eine **separate Preisbindefrist** wird **nicht** als MVP-Standard benötigt: Preise werden typischerweise jahresweise gepflegt, Dynamik-/Yield-Management ist nicht vorgesehen. Es bleibt der jeweils vereinbarte, historisierte Buchungspreis maßgeblich.
**Verhältnismäßigkeit (E-027):** Das verbleibende Doppelbuchungsrisiko wird nicht weggemodelliert; Betreiberangabe: zwei Doppelbuchungen in rund zwanzig Jahren. Externe Live-Prüfung wäre vorteilhaft, steht aber nicht überall zur Verfügung. Ein einfacher nachweisbarer Konflikt-/Sperrablauf reicht für den MVP, kein komplexes Risikomodul.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]] · [[R00_Szenarien/R01_Eigene_Webseite|A1 – Eigene Webseite]] · [[R00_Szenarien/R08_Destination_Solutions|A3 – Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A4 – FeWo-direkt]] · [[00_Portalprofile_und_Vertragsvorlagen|Vertragsprofile]] · [[G00_Gates_und_Uebergaben|Gates]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
@@ -1,125 +0,0 @@
---
id: K00
typ: fachliches-konzept
titel: Portalprofile, Konditionsquellen und Vertragsvorlagen
status: diskussionsentwurf
version: "0.9"
stand: 2026-11-01
prozess: V01
bezugsstand_archetypen: "0.6"
---
# K00 – Portalprofile und Vertragsvorlagen
## 1. Fachliche Leitentscheidung
FewoPortal ist das führende **interne** Verwaltungs- und Dokumentationssystem für die Buchung. **Jeder externe Kanal kann abweichende eigene Regeln und Fähigkeiten haben**: Preis- und Rabattpflege, Stornobedingungen, Vertragsabschluss, Zahlungsabwicklung, Kommunikation sowie Datenlieferung und -nachweis. Das Verhalten eines konkreten Portals (z. B. FeWo-direkt) wird **nicht** als generelle Logik fest in die Software eingebaut.
**Bestätigt:** Für unterschiedliche Portale und Buchungstypen müssen **unterschiedliche, versionierte Vertragsvorlagen/-entwürfe und Anlagen** auswählbar sein. Auch verschiedene Buchungsarten desselben Portals können abweichende Dokumente benötigen.
## 2. Minimaler Portal-/Buchungskontext (fachlich, keine technische Datenmodellvorgabe)
| Eigenschaft | Bedeutung |
|---|---|
| Vermieter und Wohnung | Wer vermietet welches Objekt? |
| Eingangskanal | Eigene Website, Portalnachricht, E-Mail, iCal, Telefon/manuelle Erfassung usw. |
| Portal und ggf. Partnerherkunft | Über welchen Anbieter kam die Buchung, ggf. von welchem Unter-/Partnerportal? |
| Art des Eingangs | Unverbindliche Anfrage oder bereits extern verbindliche Direktbuchung? |
| Verantwortlichkeiten | Wer erstellt/übermittelt den Vertrag, steuert Zahlung, Mahnungen, Storno, Erstattungen, Gastkommunikation? |
| Konditionsquelle | Wo wurden Gastpreis, Rabatte, Zusatzleistungen und Stornoregeln maßgeblich vereinbart? |
| Informationsquelle/-status | Welche Werte/Nachweise sind bekannt, unbestätigt oder fehlen? Wann wurden sie erfasst? |
| Dokumentenprofil | Welche Vorlage, Bedingungen, Anlagen und Versandschritte gelten für diesen Buchungstyp? |
**Zuordnung:** Standard des Vermieters/Objekts → spezifischeres Portalprofil → spezifischer Buchungstyp → ggf. tatsächliche Partnerherkunft. Eine **bewusste Einzelfallauswahl** der Vorlage bleibt möglich und wird dokumentiert. Bei unklarer Zuordnung **kein stillschweigender Vertragssende-Automatismus**.
## 3. Fachliche Dokumentenarten und Auswahl
| Buchungskonstellation | Dokument und Prozess |
|---|---|
| A1 / A2, eigener Angebotsabschluss | Eigenes **bindendes Angebot** mit ausgewählten Vertragsbedingungen/Anlagen. Wirksam angenommene Version wird unverändert nachgewiesen; anschließend Vertragsdokument bzw. Bestätigung aus diesem Stand. |
| A3 / A4, extern bereits verbindlich, Vertragstext/Unterlagen durch uns | **Kanal- und buchungstypspezifische Vertragsdokumentation** der bereits vereinbarten Bedingungen; **keine zweite obligatorische Annahme**. Widersprechende/neue Klauseln nicht still ergänzen. |
| A5, Vertrag/Abwicklung extern | Externen Vertrags- und Konditionsnachweis referenzieren/ablegen, eigene Dokumente nur, wenn erforderlich. Keine doppelte Vertragsbegründung. |
| Optional: Partnerherkunft | **Keine eigenständige Hub-/Vermittlungsvariante.** Nur bei kaufmännischer Relevanz (z. B. unterschiedliche Vermittlerprovision) Herkunft erfassen. **A6 bezeichnet inzwischen interne Belegung und Sperren**, nicht Vermittlung. |
Eine **gemeinsame Konditions-/Vertragszusammenstellung** soll vor dem Versand anzeigen: maßgeblicher Preis, enthaltene/optionale Leistungen, Rabatte, Stornoregel, Gastdaten, gewählte **Vorlage mit Version**, passende **Anlagen**, nachweisbarer Konditionsstand und Dokumentenvorschau. Der Vermieter kann die Auswahl im Rahmen der rechtlich/fachlich zulässigen Regeln korrigieren; keine separaten Portalfomulare.
## 4. Preis- und Konditionsherkunft
- **Eigener Angebotsprozess (A1, typischerweise A2):** FewoPortal berechnet das verbindliche Angebot nach den eigenen für den Vorgang geltenden Regeln.
- **Extern bereits verbindlich (A3–A5):** Der vom Gast beim Abschluss akzeptierte **Portalpreis und Konditionsstand** muss zugrunde gelegt werden. Eigene Berechnung höchstens als Vergleich, niemals als stiller Ersatz.
- Preis, Rabatt, Leistungen, Steuern/Abgaben, Stornoregeln, etwaige Gast-Servicegebühren, Vermieterprovision und Nettoauszahlung **nach tatsächlicher Vertrags- und Gebührenstruktur** unterscheiden; fehlende Angaben als unbekannt markieren.
- Konditionen je Portal können aus API, E-Mail, Portalansicht, Dokumenten oder manueller Erfassung stammen. **Herkunft, Erfassungszeitpunkt und ggf. Nachweis** mitführen.
- Der zum Abschluss gehörende **Konditions-Snapshot** und die tatsächlich generierten Vertragsdokumente bleiben mit Versionsstand/Prüfsumme unverändert nachvollziehbar.
- **Wenn verbindliche Portalbedingungen nicht nachgewiesen werden können, gilt nicht „eigene Standardbedingungen einsetzen“.** Stattdessen Klärungsfall und Prüfung vor Generierung/Versand möglicherweise widersprüchlicher Dokumente.
## 5. Übergabegates, die daraus folgen
- **G2 Verbindlichkeit:** Nachweis *wie* die Buchung verbindlich wurde und welche Konditionen zugrunde liegen; Dokumentenversand ist **nicht** gleich Vertragsschluss.
- **G3 Abwicklung:** Vertragserstellung und -versand, Zahlung, Storno, Mahnung, Rückerstattung und Kommunikationskanal je Buchung einem Akteur zuordnen. Dokumententwurf und Anlagen müssen zum konkreten Profil passen.
- Fehlende Anschrift oder Reisendendaten blockieren nicht rückwirkend die bereits verbindliche Portalbuchung, können aber **eigene Dokumentenerstellung oder lokale Vorbereitung** bis zur Klärung aufhalten.
## 6. Praxisreferenz FeWo-direkt (A4), keine universelle Regel
- Der Vermieter pflegt nach eigener Angabe **Mietpreise im Portal-Belegungskalender** sowie **Rabatte und Stornobedingungen** im Portal.
- Der vierseitige **eigene Mietvertrag ist im FeWo-direkt-Inserat derzeit nicht hinterlegt** und wird später von uns gesendet.
- Der Vermieter kann aktuell nicht verifizieren, welche vollständigen Buchungs-/Vertragsunterlagen der Gast bei Portalabschluss sieht oder erhält. **Unbekannt und rechtlich/operativ zu klären; nicht als nachgewiesene Zustimmung darstellen.**
- Zahlung nach aktuellem Ablauf über FeWo-direkt. Vertragsdokumentation und lokale Gästebetreuung bei uns; Storno-/Mahnverantwortung ist noch genauer zu prüfen.
- Die heutige FeWo-direkt-Vertragsvorlage ist **ein spezielles Dokumentenprofil**, kein globaler Vertragsstandard.
Siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 – Analyse der bisherigen FeWo-direkt-Vertragsvorlage]].
## 7. Bewusste Grenzen / offene Punkte
1. **Keine juristische Freigabe:** Vorlagen und Stornobedingungen werden nicht durch die Software neu formuliert. Prüfung der tatsächlichen Einbeziehung und Wirksamkeit bleibt erforderlich ([§ 305 BGB](https://www.gesetze-im-internet.de/bgb/__305.html)).
2. **Keine Konfigurationshölle:** Es braucht wenige nachvollziehbare Schalter/Zuordnungen und eine manuelle Übersteuerung mit Nachweis, keinen freien Workflow-Designer.
3. **Kein vollständiger Portalpreis-Sync als implizite Voraussetzung:** Daten dürfen je Portal auch kontrolliert manuell übernommen werden, solange Quelle und Status nachvollziehbar sind.
4. **Noch offen:** Welche konkreten Dokumententypen und Anlagen sollen über Vermieter/Objekt/Portal hinweg wiederverwendbar sein, und welche müssen zwingend getrennt bleiben?
**Status:** Portalübergreifende Fachregeln aus dem Interview festgehalten; Auswahlregeln sind ein fachlicher Vorschlag zur späteren Validierung, **keine freigegebene technische Implementierung**.
## 8. Erweiterung v0.2 – Flexible Portal- und Preisfunktionen
**Konfiguration nach tatsächlicher Fähigkeit statt Portalname fest in Programmcode:**
| Merkmal | Konfigurierbare Ausprägungen / Konsequenz |
|---|---|
| Eingang/Belegung | iCal/API/E-Mail/Portalansicht/manuell; zeitverzögert, nicht verfügbar oder unbekannt; manuelle Sperraufgabe zulässig |
| Gast-/Vertragsdaten | vollständig, teilweise, nicht geliefert; ggf. manuell über Gast oder Portal abrufen |
| Vertrag und Preisquelle | eigene verbindliche Angebotsdaten oder extern bestätigter Gastpreis; Gesamtbetrag auch ohne Einzelpreise zulässig |
| Preisdetailtiefe | Einzelpositionen, Sammelpositionen, reiner Gesamtpreis; Gebührentyp oder Empfänger kann ungeklärt bleiben |
| Preisaufschlag/Provision | Vermieterprovision, zusätzliche Gast-Servicegebühr, partnerkanalabhängiger Endpreisaufschlag – getrennt, sofern belegbar; auch kombinierte/unbekannte Position zulassen |
| Zahlungszuständigkeit | Eigener Einzug oder Portal/Paymentanbieter; Ratenstatus, Auszahlungsvorschau und Bankeingang getrennt |
| Stornobedingungen | Portalkonfiguration, beim Vertragsschluss nachweislich vereinbarter Stand, später übermitteltes eigenes Dokument trennen |
| Bearbeitungsmodus | automatisch / manuell / gemischt, nach einzelner Aktivität bzw. verfügbarem Feld; offene Klärungsaufgabe statt erfundene Daten |
| Nachweise | Zeitpunkt der Erfassung, ggf. Screenshot/Buchungsbestätigung, Zeitpunkt und Wirksamkeit einer Kalendersperre soweit nachgewiesen |
**Keine freie Regel-Engine für MVP erforderlich.** Wenige Profilparameter sowie manuelle, nachvollziehbare Bearbeitungsschritte reichen zunächst. Die tatsächliche Informationstiefe kann **von Buchung zu Buchung** variieren, nicht nur pro Portal.
### Konkrete Kanalprofile als gesonderte Referenzfälle
- **FeWo-direkt (A4):** Eigene Miet-/Rabatt-/Stornokonfiguration im Portal; im Vermieterposteingang sind bei einer Buchung einzelne Summen, Zahlungsraten und erwartete Auszahlung ersichtlich, nicht notwendigerweise die Einzelpreiszerlegung. Eigener statischer Mietvertrag bislang nicht im Inserat hinterlegt. Angeblich/öffentlich angebotene Funktionen sind nicht automatisch im konkreten Betreiberkonto vorhanden.
- **Destination Solutions (A3):** Extern bereits verbindliche Buchung; danach vollständige Abwicklung beim Vermieter. **In aktuellem Betreiberzugang keine Kalendersynchronisation**; manuelle Portalsperrung mit begrenzter Nachweisbarkeit. Provision kann nach Vertriebskanal differieren; Gast-Serviceaufschlag, Preisaufschläge und vorvertragliche Anzeige der Stornobedingungen sind noch ungeklärt.
Details: [[K01_Preisstruktur_und_Abrechnung|K01 Preise & Abrechnung]]; [[R00_Szenarien/R08_Destination_Solutions|R08 Destination Solutions]]; [[O00_Offene_Portalprueffaelle|O00 offene Fragen]].
## 9. Erweiterung v0.9 – Vorgangs- und Angebotsabhängige Vorlagen
**Dokumentprofil = Vermieter/Objekt + Kanal/Owner + Vorgangstyp/Archetyp + Angebots-/Verbindlichkeitsart**, gegebenenfalls mit bewusster manueller Auswahl. Das Profil bestimmt nicht allein das Dokument, sondern auch die notwendigen Aufgaben und Versandbedingungen. Die bereits vorhandene automatische Zuordnung externer Buchungen zum **Owner-Portal** wird dabei **genutzt**, nicht neu eingeführt.
| Fall | Geeignete Vorlage | Folgeschritte |
|---|---|---|
| A1/A2, Hold > 0 | **Verbindliches Angebot** mit passender Annahmefrist, AGB/Anlagen und Annahmelink | Reservierung/externen Sperrabgleich, Annahme prüfen, verbindliche Buchung, Bestätigung |
| A1/A2, Hold = 0 | **Preis-/Verfügbarkeitsauskunft unter Vorbehalt**, keine unbedingte Annahmemöglichkeit | Keine Reservierung; bei Buchungswunsch erneut Verfügbarkeit prüfen und explizit bestätigen |
| A3/A4/A5 | **Dokumentation/Bestätigung einer bereits extern verbindlichen Buchung**, soweit eigene Unterlagen benötigt werden | Externen Konditionsstand übernehmen; keine zweite Vertragsannahme |
| A6 privat/Familie/Freunde | **Buchungs-/Aufenthalts- oder Reservierungsbestätigung** mit konkreten Zusatzleistungen und Kosten, falls vereinbart | Gastdaten optional erfassen, Abgaben/Zusatzleistungen prüfen, ggf. Zahlung steuern |
| A6 Wartung/sonstige Sperre | **Interne Bestätigung** oder **kein Dokument** | Kalender sperren, Grund/Aufgaben dokumentieren, bei Ende freigeben |
**Keine eigenständige Preisbindefrist im MVP.** Normalfall ist jahresbezogene Tarifpflege; die Haltefrist ist ein Konfigurationswert für die Belegungssicherung, nicht eine zusätzliche Preisregel. Eine verbindliche Preiszusage ohne verfügbarkeitsgesicherte Annahme muss in der rechtlich geprüften Vorlage klar vom Vertragsschluss unterschieden werden. **Bereits vereinbarte** individuelle Gast-/Portalpreise bleiben als Snapshot unverändert.
**Keine unnötige Konfigurationskomplexität:** Wenige feste Dokumenttypen und transparente Zuordnungen, keine freie Workflow-Engine; Vorlagen und ihre Versionen müssen im Einzelfall überprüfbar sein.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Buchungsarchetypen|Archetypen]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02 Vertragsverbindlichkeit]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Vertragsabwicklung]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[O00_Offene_Portalprueffaelle|Offene Fragen]]
+29 -120
View File
@@ -2,142 +2,51 @@
id: MAP-00
typ: prozesslandkarte
titel: FewoPortal – Prozesslandkarte
status: arbeitsstand
version: "0.9"
status: fachlicher-arbeitsstand
version: "0.10"
---
# 00 – Prozesslandkarte FewoPortal v0.9
# Prozesslandkarte FewoPortal
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
**Stand:** 01.11.2026
## Produkt und Wertschöpfung
## A. Führungsprinzip
FewoPortal ist eine mandantenfähige Plattform für kleine Ferienwohnungsvermieter (typisch **eine bis drei Wohnungen pro Vermieter**). Es unterstützt die eigene Website und externe Buchungskanäle; es ist **kein Ferienwohnungsmarktplatz** und vorerst kein umfangreiches Hotel-, Agentur-, Personal- oder Objektmanagementsystem. Ziel sind Gästegewinnung und eine möglichst einfache, verlässliche und weitgehend automatisierte Buchungs- und Aufenthaltsabwicklung.
FewoPortal ist das **führende Verwaltungssystem für den gesamten Buchungsvorgang**: einheitlicher Vorgang, Prozesszustände, Fristen, Aufgaben, Dokumente, Kontakte, Kalender und Ereignisse. Ein angebundenes Portal kann fachliche Schritte übernehmen. FewoPortal hält **Ergebnis, Herkunft/Nachweis, Zuständigkeit und erforderliche Folgeaktivitäten** fest. Für externe Tatsachen (z. B. Portalzahlungen) bleibt das Portal die primäre Informationsquelle.
| Wertschöpfungsprozess | Zweck |
|---|---|
| **V01 – Buchung und Aufenthalt** | Geschäftsfall vom ersten relevanten Anlass bis zum fachlichen Abschluss steuern; **ein gemeinsamer Vorgang** mit bedarfsgerechtem Ablauf |
| **V02 – Vermarktung, Gästegewinnung und Gästebindung** | Website, Portale, Social Media, Print, Interessenten, Wiederbuchung, CRM/Loyalty; kann V01 auslösen und nach V01 fortgeführt werden; derzeit nur als fachlicher Rahmen |
Es gibt **einen generischen Buchungsprozess**; je Portal, Eingangsart und ggf. Herkunft sind Auslöser, Aktivitäten, Verantwortlichkeiten, Datenbeschaffung und Ausgänge konfigurierbar. **Keine parallelen Buchungsprozesse und Verwaltungsoberflächen.**
## V01 – Hauptwertschöpfungsprozess
Ein extern ausgeführter Schritt bedeutet nicht automatisch „übersprungen“; zu unterscheiden sind **intern erledigt / extern erfüllt / fachlich nicht anwendbar / offen bzw. Klärungsbedarf**.
| Phase | Kernergebnis |
|---|---|
| **P01 – Eingang und Verfügbarkeit** | Anlass, Art, Quelle, Unterkunft und Zeitraum erkannt; Belegung/Hold/Sperren und Klärungen bearbeitet |
| **P02 – Konditionen und Verbindlichkeit** | Eigene Verbindlichkeit begründet oder externe Verbindlichkeit übernommen; ggf. geeignete Bestätigung; Konditionsstand bekannt bzw. Lücken gekennzeichnet |
| **P03 – Verwaltung und kaufmännische Abwicklung** | Dokumente, Gäste, Leistungen, Zahlungen, Provisionen, Fristen und Zuständigkeiten sachgerecht bearbeitet |
| **P04 – Vorbereitung und Aufenthalt** | Lokale Leistungen, notwendige Daten, Anreise und Aufenthalt bzw. interne Nutzung/Arbeiten unterstützt |
| **P05 – Abschluss und Nachbereitung** | Erfüllung oder alternative Beendigung dokumentiert; offene Folgeangelegenheiten zugewiesen |
## A1. Produktmandat und bewusste Abgrenzung (Betreiberentscheidungen E-007 bis E-009)
**Diese Phasen sind eine fachliche Hierarchie, keine fünf starren Bildschirmseiten oder zwingenden Wartezustände.** Schritte können entfallen, parallel oder zu einem späteren Zeitpunkt ausgeführt werden; nicht anwendbare Aktivitäten werden nicht künstlich erzwungen.
- **Heute:** Eigene Internetpräsenz als einheitlicher Einstiegspunkt für die Ferienwohnungen eines Vermieters; mehrere getrennte Vermieter/Mandanten möglich. Typischer Zielkunde vermietet **eine bis maximal etwa drei Wohnungen**.
- **Geschäftsziel:** Über eigene Website und externe Kanäle Gäste gewinnen, Buchungen abschließen und deren Abwicklung mit möglichst wenig Betreiberaufwand zentralisieren und automatisieren. **Kein eigener Marktplatz.**
- **Produktschwerpunkt:** V01 Buchung/Aufenthalt und V02 Vermarktung, Gästegewinnung und Gästebindung. Dazu zählen auch Social Media, Print, externe Portale, Stammkundenmanagement und Loyalty als fachlich vorgesehene Ausbaubereiche.
- **Keine Überdehnung:** Buchungsbezogene Reinigung, Schlüsselübergabe und lokale Leistungen werden möglichst einfach **innerhalb desselben Vorgangs** angestoßen und nachvollzogen. Umfangreiche Objektverwaltung, Personal-/Tourenplanung und Agentur-/Zimmervermittlungsfunktionen sind **nicht Teil der aktuellen Schwerpunktsetzung**.
- **Erweiterbarkeit ohne Vorabkomplexität:** Eine spätere SaaS-Erweiterung für größere Vermittler bleibt möglich, bestimmt aber **nicht** heutige Masken, Prozessvarianten oder Modulzuschnitte. Fachliche Prozessfamilien sind **keine automatische Vorgabe** für eigenständige Softwaremodule.
- **Bedienprinzip:** Der Vermieter sieht wenige, konkrete Aufgaben im Buchungskontext statt die interne Prozessarchitektur. Fachliche Vollständigkeit im Hintergrund darf nicht zu einer komplexen Bedienoberfläche führen.
## Einheitlicher Vorgang
## B. Wertschöpfungsprozesse
Jeder qualifizierte geschäftliche Anlass führt zu einem **Vorgang**, ohne separate Entscheidung „Buchungsakte anlegen“: eigene bzw. vermittelte Anfrage, bereits verbindliche externe Buchung oder interne Eigenbelegung/private Überlassung/Sperre. Ein unklarer technischer Import ist bis zur Klärung noch **kein nachgewiesener Vertrag**. Doppelte Portalmeldungen und Spiegelungen desselben Sachverhalts dürfen nicht zu zusätzlichen unabhängigen Vorgängen führen. Eine „Buchungsakte“ ist allenfalls eine Ansicht, keine zusätzlich zu eröffnende fachliche Einheit.
| ID | Wertschöpfungsprozess | Phasen / Zweck |
|---|---|---|
| **V01** | **Buchung und Aufenthalt** | P01–P05, einschließlich Feedback |
| **V02** | **Vermarktung, Gästegewinnung und Gästebindung** | Eigenständiger, V01 vor- und nachgelagerter Wertschöpfungsprozess: Multichannel-Marketing, Interessentengewinnung, CRM, Wiederbuchung, Loyalty (E-001, E-008) |
**Vorgang ≠ Belegung.** Ein Vorgang dokumentiert Anlass, Beteiligte, Zustand, Aufgaben, Leistungen, Konditionen, Dokumente, Zahlungen und Ereignisse. Eine Belegung/Hold/Sperre beschreibt die zeitliche Verfügbarkeit des Objekts. Ein Vorgang kann Belegungswirkungen auslösen; importierte Spiegelungen sind keine eigenen Vertragsvorgänge.
### V01 – Generischer Hauptwertschöpfungsprozess
Die bestehende **Owner-/Ursprungskanal-Zuordnung** ist eine vorhandene Funktion. Der technische Eingang (z. B. E-Mail/iCal), Ursprungskanal und ggf. provisionsrelevante Partnerherkunft sind begrifflich zu unterscheiden. Herkunftsketten sind **kein eigener Archetyp**.
| Phase | Arbeitsbezeichnung | Fachliches Kernergebnis |
|---|---|---|
| **P01** | Buchungseingang & Verfügbarkeitssicherung | Anfrage oder verbindliche externe Buchung erkannt; Belegung/Hold korrekt vermerkt; fehlende Eingangsdaten als Aufgaben sichtbar |
| **P02** | Konditionen & Buchungsverbindlichkeit | Verbindlichkeit durch fristgerechte Annahme des **von uns bindenden Angebots** oder Nachweis einer schon verbindlichen Portalbuchung; gültige Konditionen revisionsfähig festgehalten |
| **P03** | Buchungsverwaltung & kaufmännische Abwicklung | Vertragsdokumente, Zahlungszuständigkeit, Fristen und Verwaltungsaufgaben gesteuert, auch bei extern verantworteten Aktivitäten |
| **P04** | Leistungsvorbereitung & Aufenthalt | Informationen und lokale Leistungen bereitgestellt; Anreise, Aufenthalt, Abreise betreut |
| **P05** | Abschluss & Nachbereitung | Buchungs- und Leistungserbringung fachlich abgeschlossen; offene, danach eigenständig zu bearbeitende Fälle kontrolliert an Folgeprozesse übergeben; Feedback und objektbezogene Folgeaufgaben; zulässige Übergabe an V02 |
## Führungs- und Verantwortungsprinzip
### V02 – Vermarktung, Gästegewinnung und Gästebindung (fachlich vorgesehen, Details später)
FewoPortal ist das führende **interne** Verwaltungs- und Arbeitsinstrument. Ein externes Portal kann den Vertrag abschließen, Geld einziehen, Nachrichten oder Stornierungen bearbeiten. Im Vorgang werden deshalb **tatsächlicher Sachverhalt, Quelle, fachliche Zuständigkeit, Nachweis und erforderliche eigene Folgehandlung** festgehalten. Externe Verantwortung bedeutet nicht, dass eine Leistung nachweislich bereits erbracht wurde.
- **Vor der Buchung:** Reichweite und Interessenten über eigene Website, Social Media, Print und externe Portale gewinnen; Herkunft einer Anfrage/Buchung möglichst nachvollziehbar halten. Externe Portale können dabei **Marketing- und Buchungskanal** zugleich sein.
- **Nach der Buchung:** Bestehende Gäste für Wiederbuchung und Loyalty berücksichtigen; zulässige CRM-/Marketingaktivitäten und passende Angebote ermöglichen. Loyalty-Merkmale können als Eingabe für die Konditionsbildung in P02 dienen.
- **Schnittstelle:** V02 kann Nachfrage/Anfragen an V01 übergeben; P05 bleibt für **Dank, Feedback und Bewertungsabwicklung** zuständig und kann bei zulässiger Grundlage Ereignisse an V02 melden.
- **Priorisierung:** Fachlich vorsehen, aber jetzt nicht die detaillierte Kampagnenverwaltung oder einen eigenständigen Marketing-Funktionskomplex implementieren.
Unvollständige oder nicht automatisch abrufbare Daten sind normale Fälle: gezielte manuelle Beschaffung, Klärung und späterer Abgleich sind zulässig. **Unbekannt ist nicht null**. Eine fehlende Provisionsaufschlüsselung darf beispielsweise nicht die Anreise blockieren, wenn sie dafür nicht benötigt wird.
**Die Phasen sind logische Gruppierungen, keine zwingend exklusiven Zeitfenster.** Zahlungen/Fristen laufen u. U. über P03 hinaus, Datenbeschaffung kann nach der verbindlichen Buchung weiterlaufen. Kern-Gates beschreiben nachweisbare Zustände; Detail-Gates beschreiben Voraussetzungen für konkrete Tätigkeiten.
## Prozessausgänge und Grenzen
## C. Eingangspfade und Verbindlichkeit (fachlich vom Betreiber präzisiert)
V01 endet – abhängig vom Fall – **regulär nach Aufenthalt/Nutzung**, **ohne verbindliche Buchung** (z. B. Angebotsablauf), **durch wirksame Stornierung** oder bei A6 durch planmäßige bzw. vorzeitige Beendigung einer Sperre. Offene Forderungen, Schäden oder Differenzen können danach als zugewiesene Folgeangelegenheiten weiterlaufen; sie werden nicht still gelöscht. Die genaue Pflichtprüfliste für den Abschluss ist fachlich noch zu konkretisieren.
| Pfad | Entstehung der Verbindlichkeit | Preis/Konditionen | Vertrag und Verwaltung |
|---|---|---|---|
| Eigene Website / manuell / unverbindliche Portalanfrage | Wir geben **ein für uns verbindliches, befristetes Angebot** ab; die rechtzeitige Annahme durch den Gast führt zum Vertrag | Eigene Preisermittlung mit Sonderleistungen, Saison/Rabatten/Loyalty; versionierter Konditionsstand | FewoPortal erstellt Angebot, Annahmenachweis und Vertragsunterlagen; danach eigene Verwaltung |
| Verbindliche Portal-Direktbuchung, Vertrag durch uns | **Bereits beim Portal verbindlich**; **keine zweite Annahme** bei uns | **Im Portal vereinbarter Preis zwingend als Buchungspreis übernehmen**; unsere Berechnung darf ihn nicht still ersetzen | Wir erzeugen/übermitteln das Dokument zur bestehenden Buchung; etwaige Zusatzpflichten nicht nachträglich einseitig hinzufügen; Zahlungszuständigkeit nach Profil |
| Verbindliche Portal-Direktbuchung, vollständige Abwicklung durch Portal | **Bereits beim Portal verbindlich** | Externe Konditionen als maßgeblich kennzeichnen, soweit für lokale Ausführung nötig | Portal verantwortet z. B. Vertrag, Zahlung, Mahnung, Storno; FewoPortal verwaltet notwendige Gästeinfos, lokale Betreuung, Abgaben und relevante externe Status/Ereignisse |
Support- und Sonderprozessfamilien sind **fachliche Fähigkeiten**, keine Verpflichtung, eigenständige Softwaremodule zu bauen. Buchungsbezogene Objektaufgaben bleiben möglichst im Vorgang integriert; die Bedienoberfläche soll wenige klare Aufgaben zeigen.
Bei **eigenem Angebot**: Konfigurierbare Annahmefrist; wir bleiben im beschriebenen Zeitraum gebunden. Rechtzeitige Annahme beendet das Angebot mit dem Ergebnis „verbindlich gebucht“; ohne rechtzeitige Annahme erlischt das Angebot und die **eigene** Vorreservierung wird nur nach Konfliktprüfung freigegeben. Ein extern bereits bestätigter Aufenthalt wird dadurch nicht gelöscht. Angebote und Nachweise bleiben historisch erhalten.
Vertraglicher Nachweis und ggf. PDF-Übermittlung dürfen rechtliche Verbindlichkeit **nicht neu definieren**: Eine bereits verbindliche Portalbuchung bleibt verbindlich; ihr Preis und ihre maßgeblichen Bedingungen müssen gewahrt bleiben. Die rechtlichen Anforderungen der jeweiligen Konstellation sind separat zu prüfen.
## D. Wiederverwendbare Supportprozessfamilien (vorläufig)
Diese Familien dienen der **fachlichen Vollständigkeit**. Sie werden in der aktuellen kleinen Vermieterplattform in erster Linie als **integrierte Funktionen und Aktivitäten** von V01/V02 realisiert. Eine eigenständige Verwaltungsoberfläche ist weder aus dem Namen noch aus der Dokumentation abzuleiten. Buchungsunabhängige Objekt- und Agenturverwaltung sind nachrangige mögliche Erweiterungen.
- S01: Portal-, Kanal- und Integrationsmanagement
- S02: Verfügbarkeit, Belegung, Kalenderabgleich und Synchronisationskontrolle
- S03: Gast-, Objekt- und weitere Stammdaten
- S04: Preis-, Leistungs-, Rabatt- und Konditionsmanagement
- S05: Dokumenten-, Vorlagen- und Nachweismanagement
- S06: Kommunikation, Aufgaben, Fristen und Eskalation
- S07: Zahlungen, Forderungen und Portalstatus-Abgleich
- S08: Buchungsbezogene Objekt- und Dienstleisterleistungen (Schlüssel, Reinigung, Vorbereitung, Reparatur) **integriert in P04/P05**; umfangreiches eigenständiges Objektmanagement derzeit **nicht priorisiert**
- S09: Mandanten, Berechtigungen, Compliance und Sicherheit
## E. Wiederverwendbare Sonderprozessfamilien (vorläufig)
- X01: Angebotsänderung und Neuangebot
- X02: Vertragsänderung, Umbuchung und Zusatzleistungen nach Vertragsschluss
- X03: Ablehnung, Angebotsablauf, Holdablauf und Freigabe
- X04: Stornierung/Rücktritt durch Gast, Portal oder Vermieter
- X05: Zahlungsverzug, Mahnung, Erstattung, Streitfall
- X06: Widersprüchliche/unvollständige Daten und Dubletten
- X07: Doppelbuchung, Kalenderkonflikt, Portal-/Importfehler
- X08: No-show, vorzeitige Abreise, Verlängerung
- X09: Reklamation, Schaden, Kaution und Nachforderung
Ein Sonderprozess kann mehrere Phasen betreffen und verwendet denselben Vorgang und dieselbe Ereignishistorie. **Nach abgeschlossenem Buchungs- und Leistungsprozess** können noch offene Ansprüche oder Konflikte als eigenständig zu bearbeitende Folgeprozesse weitergeführt werden; die Referenz auf die ursprüngliche Buchung und der Übergabenachweis bleiben erhalten (E-010).
**Alternative fachliche Endergebnisse V01 (E-011):** Ein regulär erfüllter Aufenthalt, eine ohne Buchung beendete Anbahnung (z. B. Angebotsablauf oder Ablehnung) und die Stornierung nach entstandener Verbindlichkeit sind unterschiedliche Ergebnisse **desselben** generischen Prozesses. Eine reguläre Leistungserbringung durchläuft typischerweise P05; ein früher Abbruch muss nicht künstlich P03–P05 durchlaufen. Auslösende Ereignisse, Nachweise, ggf. Belegungsfreigabe und verbleibende Folgepflichten werden nachvollziehbar dokumentiert. Weitere Endergebnisse sowie exakte Übergangsbedingungen sind offen.
## F. Zentrale Gate-Philosophie
**P05-Abschluss-/Übergabegate (E-010):** Abschluss der Buchungs- und Leistungserbringung ist vom Ende nachlaufender Forderungs-, Schadens- oder Streitfälle zu unterscheiden. Offene Fälle werden mit Kontext, Verantwortlichkeit und Referenz zur Buchung an den jeweils zuständigen Folgeprozess übergeben. Die endgültigen Pflichtkriterien und Zustände werden in P05 spezifiziert.
Gates dokumentieren **Trigger, erwartetes Ergebnis, erforderliche Daten, Herkunft/Nachweis, zuständige Stelle, Ergebnisstatus, Folgeschritt**. Pflichtinformationen sind **aktivitätsbezogen**, nicht für alle Portale pauschal identisch. Fehlende Adressdaten dürfen eine durch Portalnachweis verbindliche Buchung nicht entwerten; sie blockieren nur Tätigkeiten, für die sie wirklich erforderlich sind.
## G. Noch zu entscheiden
1. **Detailkriterien für den fachlichen Abschluss von V01:** Welche Leistungen, Informationen und Übergaben müssen konkret abgeschlossen sein? Die Grundentscheidung ist getroffen: Nachlaufende Forderungen/Schäden blockieren nicht allein den Abschluss der Buchungs- und Leistungserbringung, wenn sie nachvollziehbar an einen verantwortlichen Folgeprozess übergeben wurden (E-010).
2. Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; **keine Entscheidung für ein eigenständiges Objektmanagement-Modul**.
3. Genauer Status- und Gate-Katalog, **einschließlich alternativer Prozessausgänge nach E-011**, Synchronisationssicherheit und externer Stornoereignisse.
4. Abgrenzung P03/P04; Relevanz und Nachweisbarkeit der lokalen Prozesse.
5. Pro Kanal tatsächlicher Verbindlichkeitsnachweis, Datenlage und Portalbestimmungen.
Die detaillierte Umsetzung erfolgt erst nach Abstimmung der Prozesslandkarte.
## H. Konkretisierung v0.7: Portalneutralität, Informationslücken und Verantwortlichkeit
**A1–A5 (E-012, historischer Stand):** Buchungs- und Abwicklungsverantwortung klassifizieren die Vermietungsarchetypen. Der **damalige A6 für Partnervermittlung** entfiel; Herkunft/Partnervertrieb bleibt lediglich eine kaufmännische Metainformation. **Aktuelle Fortschreibung E-022:** Zusätzlich gilt **A6 = Eigenbelegung, private Überlassung und sonstige Sperren**, im gemeinsamen Vorgang mit bedarfsabhängig verkürzten Aktivitäten. Referenzfälle: **FeWo-direkt A4**, **Destination Solutions A3**. Der identische V01-Prozess durchläuft dieselben fachlichen Phasen/Gates, Aktivitäten können je Profil extern/intern oder manuell/automatisch erfolgen.
**Fünf unabhängige Dimensionen je Buchung:** (1) rechtlicher Bindungs-/Konditionsnachweis, (2) operative Zuständigkeit, (3) technische Datenquelle/Übermittlungsweg und Verfügbarkeit, (4) preisliche Detailtiefe bzw. Zuordnungsgrad, (5) tatsächliche Nachweisqualität. Aus „Portal zuständig“ folgt weder „erledigt“ noch „nachgewiesen“.
**Kaufmännischer Grundsatz (E-014/E-015):** Das Portal kann Einzelposten, Teilaggregationen, Gesamtpreise, unbekannte Gebührenmischungen oder widersprüchliche Auszahlungsansichten liefern. FewoPortal darf den verbindlichen Gastpreis bei externer Buchung nicht durch Eigenkalkulation ersetzen, keine unbekannten Einzelposten erfinden und keine Vermittlerprovision ohne Vereinbarung dem Gast nachberechnen. Eine manuelle Klärung kann ergänzen; ursprüngliche Rohdaten bleiben erhalten.
**Verfügbarkeit (E-018):** Keine generelle Aussage, dass alle Vertriebskanäle synchron oder endgültig gesperrt sind. Manuell oder zeitversetzt übertragenes Blockieren ist kein Nachweis partnernetzweiter Wirksamkeit. Sofort bestätigte externe Doppelbuchungen bleiben wirksame **Konfliktfälle**, nicht automatisch ablehnbare Anfragen. Eine vorgeschlagene Livefreigabe/10-Minuten-Karenz ist derzeit nur **optionales Zukunfts-/Integrationskonzept**, kein Ist-Ablauf.
**Nachträgliche Ereignisse (E-019):** Änderungsanfrage, bestätigte Änderung, Stornierungswunsch und wirksame Stornierung unterscheiden. Ursache, Durchführender, vertragliche Folgen, Belegung und Geldflüsse getrennt dokumentieren.
**Zu vertiefen:** [[K01_Preisstruktur_und_Abrechnung|K01 Preis- und Abrechnungsmodell]], [[X01_Belegungskonflikte_und_Sperrnachweise|X01 Belegungskonflikt- und Sperrnachweise]], [[O00_Offene_Portalprueffaelle|O00 offene Portalfragen]].
## I. Fachliche Konsolidierung 01.11.2026: Vorgang und A6 (E-022–E-028)
**V01** ist der gemeinsame fachliche Wertschöpfungs-/Bearbeitungsrahmen für **A1–A6**. **Vorgang** bedeutet die durchgehende Bearbeitung ab qualifiziertem Anlass – Anfrage, bindende externe Buchung oder interner Belegungs-/Sperrwunsch – bis zum passenden Ende. Ein zusätzlicher Schritt „Buchungsakte anlegen“ entfällt. Die bereits implementierte Owner-Zuordnung bei externen Buchungen bleibt bestehen. **Belegung** (Objekt, Zeitraum, Sperr-/Reservierungswirkung) ist mit dem Vorgang verknüpft, aber nicht gleichbedeutend mit dem ganzen Vorgang.
**A6** bündelt Eigenbelegung, Familien-/Freundesaufenthalt und Wartungs-/sonstige Sperren. Es nutzt je nach konkretem Anlass die allgemeinen Aktivitäten von P01–P05; nicht benötigte Vertrags-, Gästekommunikations-, Zahlungs- oder Aufenthaltsaktivitäten sind **nicht anwendbar**. Private Überlassung kann dagegen Gastdaten, Kurabgabe, Wäschepakete, Zahlung und eine passende Bestätigung benötigen. Ein Hold für ein A1/A2-Angebot bleibt **Teil dieses Vermietungsvorgangs**, kein zweiter A6.
**Angebot (A1/A2):** Haltefrist pro Anfragekanal konfigurierbar. Hold > 0 ermöglicht bei passender Sicherung und Frist ein bindendes Angebot; Hold = 0 führt zu einer Preis-/Verfügbarkeitsauskunft ohne reservierte Wohnung, mit erneuter Prüfung vor verbindlicher Bestätigung. Die Auswahl von **Dokumentenvorlage, Versand und Folgeaktivitäten erfolgt automatisch nach Kanal und Vorgangstyp**; eine separate Preisbindefrist/Yield-Management ist kein MVP-Standard. Jährliche Tarifpflege und tatsächlicher vertraglicher Buchungspreis bleiben voneinander getrennt.
**Implementierungsgrenze:** Die derzeitige Konzeption ist keine vollständige Coding-Freigabe; zuerst Bestands-/Gap-Analyse gegen die vorhandene Anwendung, anschließend begrenzte Arbeitsaufträge.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01 Buchungseingang]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02 Konditionen und Bindung]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Verwaltung und Abwicklung]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04 Aufenthalt]] · [[P05/P05_Abschluss_und_Nachbereitung|P05 Abschluss]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Supportprozesse]] · [[X00_Sonderprozesse|Sonderprozesse]] · [[00_Buchungsarchetypen|Archetypen]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
**Vertiefung:** [A1–A6](01_Buchungsarchetypen.md) · [P01](V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md) · [Sonderprozesse](Querschnitt/Sonder_und_Supportprozesse.md).
@@ -0,0 +1,38 @@
---
id: A00
typ: archetypenkatalog
titel: Buchungsarchetypen A1–A6
status: fachlicher-arbeitsstand
version: "0.10"
---
# Buchungsarchetypen A1–A6
**Archetyp = Geschäftskonstellation**, kein eigenes System und kein separater Workflow. Maßgeblich sind die **tatsächliche Eingangsart und Abwicklungsverantwortung**, nicht nur der Name des Kanals. Ein Kanal kann sowohl unverbindliche Anfragen als auch verbindliche Buchungen liefern. Die Abwicklung richtet sich nach dem für den Vorgang gültigen Profil.
| Typ | Geschäftsfall | Vertragsverbindlichkeit bei Eingang | Typische weitere Abwicklung |
|---|---|---|---|
| **A1** | Eigene Website / eigener vollständiger Buchungsweg | Zunächst Anfrage | Eigene Auskunft bzw. bindendes Angebot, Annahme, Vertrag, Zahlung, Aufenthalt |
| **A2** | Unverbindliche Anfrage eines externen Vermittlers | Noch nicht verbindlich | Fehlende Daten ergänzen; eigener Angebots- und Buchungsweg ähnlich A1 |
| **A3** | Verbindliche externe Direktbuchung; vollständige weitere Abwicklung bei uns | Bereits extern verbindlich | Vereinbarten Portalpreis übernehmen; eigene Dokumentation, Gastkontakt, Zahlungsmanagement und Aufenthalt |
| **A4** | Verbindliche externe Buchung mit **geteilter** Abwicklung | Bereits extern verbindlich | Beispielsweise eigenes Vertragsdokument und lokale Leistung, Portalzahlung; andere Verantwortungen je Profil |
| **A5** | Extern weitgehend vollständig abgewickelte Direktbuchung | Bereits extern verbindlich | Keine zweite Annahme/unnötige eigene Mahnung; nur erforderliche eigene lokale Aufgaben und Nachweise |
| **A6** | Eigenbelegung, private Überlassung, Wartung und sonstige Sperren | Interner Belegungsanlass, nicht automatisch Mietvertrag | Einheitlicher Vorgang mit Sperrgrund, Belegung und je nach Fall Gäste, Bestätigung, Zusatzleistungen und Zahlung |
**Partner-/Hub-Vertrieb ist kein A6.** Unterschiedliche Provisionen je Partner sind eine kaufmännische Eigenschaft des Ursprungskanals bzw. der Buchung; eine separate Partnerprozessklasse wird nicht benötigt. Telefon/manuell/iCal/E-Mail/API beschreiben Informations- oder Erfassungskanäle, keine eigenen Archetypen.
## Verhalten im gemeinsamen Prozess
- **A1/A2:** Mit Hold > 0 kann nach geeigneter Belegungssicherung ein bindendes zeitlich befristetes Angebot verschickt werden. **Hold = 0:** reine Preis-/Verfügbarkeitsauskunft unter Vorbehalt; bei Buchungswunsch erneute Prüfung und Bestätigung entsprechend dem automatisch/manuell konfigurierten Modus. Die verbindliche Annahme eines gültigen eigenen Angebots erfordert **keine zweite Freigabe**.
- **A3–A5:** Der Vertrag entstand bereits extern. Der bestätigte Gastpreis und die nachweislich vereinbarten Bedingungen werden übernommen, **nicht durch eigene Preise oder eine zweite Annahme ersetzt**. Es ist zulässig, dass die Gastadresse, Tagespreise oder Zahlungsdetails erst später verfügbar werden.
- **A6:** Jeder eigenständige interne Sperr-/Nutzungsanlass ist ein Vorgang. Private Aufenthalte können Teilnehmer, Kurabgabe, Wäschepakete, Gebühren und Zahlungen haben, auch bei Mietpreis 0. Eine reine Wartungssperre benötigt weder Gast noch Mietvertrag. Der Hold einer A1/A2-Anfrage ist dagegen **keine eigene A6-Buchung**.
- **Alle:** Änderung, Storno/Aufhebung, Belegung, Nachweise, Fristen und Folgeaktivitäten benutzen gemeinsame fachliche Mechanismen. Die rechtliche Wirkung bleibt abhängig vom Vorgangstyp.
## Validierung durch reale Fälle
- [R01 – eigene Website](Szenarien/R01_Eigene_Webseite.md): A1, ggf. A2 nach Datenergänzung.
- [R08 – Destination Solutions](Szenarien/R08_Destination_Solutions.md): **A3** mit vollständig eigener weiterer Abwicklung, manuellen Portalsperren und partnerabhängiger Vermieterprovision.
- [R09 – FeWo-direkt](Szenarien/R09_FeWoDirekt.md): **A4** mit teilweise externer Zahlung/Kommunikation.
- [R07 – interne Belegung/Sperre](Szenarien/R07_Eigenbelegung_und_Sperren.md): **A6**, mit und ohne Gäste.
**Nicht als Fakten unterstellen:** Identische Portal-Datentiefe, allgemeingültige Portal-Stornozuständigkeit, gesicherte Kalenderpropagation oder automatische Erkennbarkeit jedes iCal-Eintrags.
@@ -0,0 +1,51 @@
---
id: K00
typ: fachkonzept
titel: Abwicklungsprofile, Einstellungen und Dokumente
status: fachlicher-arbeitsstand
version: "0.10"
---
# Abwicklungsprofile, Einstellungen und Dokumente
## Konfiguration: Vermieterstandard und Kanalabweichung
**Mandantenregel:** Jeder Vermieter legt seine eigenen **globalen Standardeinstellungen** fest. Für einen Kanal kann er einzelne Werte ausdrücklich überschreiben. Ein **nicht gesetzter Kanalwert** erbt den globalen Vermieterwert. Das gilt auch für `0`, `nein` und `manuell`: Diese bewusst eingestellten Werte sind **keine leeren Werte**. Objekt- und Vorgangskontext beeinflussen weiterhin Preis, Belegung und Vorlagenauswahl, soweit fachlich erforderlich; eine weitergehende Hierarchie wird nicht ohne Entscheidung eingeführt.
Je nach Kanal **und tatsächlicher Eingangsart** werden relevante Regeln angewandt. Es gibt kein automatisches „alle FeWo-direkt-Buchungen sind gleich“. Die Konfiguration ist bewusst schlank: keine frei programmierbare Workflow-Engine erforderlich.
| Konfigurationsbereich | Zweck |
|---|---|
| Automatisch/manuell | Anfrage, Buchungswunsch und zulässige Folgeaktionen nach wirksamem Vermieterstandard oder Kanalabweichung bearbeiten; individuelle manuelle Übernahme möglich |
| Haltefrist | Für eigene/unverbindliche Anfragen: `0` = kein Hold; `>0` = befristete Reservierung mit passend befristetem bindendem Angebot (z. B. 24/48/72 Stunden) |
| Datenbeschaffung | Automatisch, manuell oder kombiniert; vorhandene, unvollständige und unbekannte Portalwerte unterscheiden |
| Verantwortung | Vertrags-/Dokumentenversand, Gastkommunikation, Zahlung, Mahnung, Storno/Erstattung, lokale Leistungen, Kalender-/Sperrpflege |
| Dokumentenprofil | Vorlagen und Anlagen abhängig von Vermieter, Objekt, Kanal, Eingangsart/Vorgangstyp und konkretem Vorgang |
| Konditionsquelle | Eigene Jahres-/Saisonpreise bei eigenem Angebot oder verbindlich akzeptierter Portalpreis bei extern abgeschlossenem Vertrag |
| Kanal-Fähigkeit | iCal/API/E-Mail/Portaloberfläche/manuell; Nachweis, Verzögerung, Vollständigkeit und erforderliche manuelle Schritte |
Bei **Hold = 0** ist die ursprüngliche Mitteilung **kein uneingeschränkt annehmbares Vertragsangebot**. Nach dem erneuten Verfügbarkeitscheck wird der Buchungswunsch gemäß wirksamem Modus automatisch bestätigt oder zur Vermieterentscheidung vorgelegt. Bei einem bereits verbindlich angenommenen Angebot oder extern geschlossenen Vertrag darf diese Wahl die entstandene Verbindlichkeit nicht nachträglich aufheben.
## Dokumentarten und Auswahl
| Sachverhalt | Geeignetes Dokument | Fachliche Wirkung |
|---|---|---|
| Eigene Anfrage mit Hold > 0 | Bindendes befristetes Angebot mit Vertragstext/Anlagen und nachweisbarer Annahmemöglichkeit | Wirksame rechtzeitige Annahme führt zum Vertrag |
| Anfrage mit Hold = 0 | Preis-/Verfügbarkeitsauskunft unter Vorbehalt | Kein Vertrag durch bloße Annahme der Auskunft; Buchungswunsch erfordert neue Prüfung und Bestätigung |
| Externe bindende Direktbuchung A3/A4 | Passende Buchungs-/Vertragsdokumentation der bereits vereinbarten Bedingungen | **Dokumentiert**, begründet nicht durch zweite Annahme einen neuen Vertrag |
| A5 | Ggf. Ergänzung zur externen Bestätigung, Anreise- oder lokale Informationen | Nur soweit eigene Tätigkeit dies erfordert |
| A6 mit privaten Gästen | Aufenthalts-, Buchungs- oder Reservierungsbestätigung, ggf. Zusatzleistungen | Wirkung entsprechend dem tatsächlichen privaten Überlassungsverhältnis |
| A6 ohne Gäste | Interne Bestätigung oder kein Dokument | Kein künstlicher Mietvertrag |
Vor Versand soll der Vermieter bei Bedarf die **gemeinsame Konditions-/Dokumentenzusammenstellung** sehen: Gast/Teilnehmer, Zeitraum, verbindlicher Preis bzw. nachgewiesene Teilbeträge, Leistungen, Stornoregel, gewählte Vorlage/Version und Anlagen. Die zugrunde liegenden Vereinbarungen bleiben mit Quelle und verwendetem Dokumentenstand nachvollziehbar. Für extern verbindliche Buchungen dürfen **keine neuen, nicht akzeptierten Pflichten** stillschweigend eingeführt werden. Bei fehlendem Konditionsnachweis wird die **betroffene Handlung** geklärt; eine bereits gültige Buchung wird nicht rückwirkend als unverbindlich behandelt.
Die Software wählt passende Vorlagen und Folgeaktivitäten automatisch anhand des fachlichen Profils; bei zulässigem Bedarf ist eine **begründete manuelle Korrektur** möglich. Vorlagenwahl darf nicht allein vom Kanal abhängen. Ein Portalkonto kann gemischte Eingangstypen besitzen.
## Preis- und Informationsregeln
- Für eigene Angebote gelten gepflegte **Jahres-/Saisonpreise**, ggf. Rabatte und zusätzliche Leistungen; keine Yield- oder Buchungsklassenlogik im MVP.
- Bei **extern bereits verbindlicher Buchung** ist der vom Gast akzeptierte **Portalpreis** maßgeblich. Die eigene Tarifrechnung darf ihn höchstens vergleichen, nicht unbemerkt ersetzen.
- Portale liefern Einzelpreise, Sammelposten oder lediglich den Gesamtpreis. Alle Formen sind zulässig. Unbekannte Positionen bleiben offen; fehlende Daten dürfen bei Bedarf manuell ergänzt werden.
- Eventuelle Gast-Servicegebühr, Vermittler-/Vermieterprovision, Vertriebspreisaufschlag und Vermieterauszahlung sind verschiedene Sachverhalte, auch wenn ein Portal Beträge kombiniert.
**Vertiefung:** [Preis- und Zahlungslogik](Querschnitt/Preise_und_Zahlungen.md) · [Gates](Querschnitt/Gates_und_Nachweise.md).
@@ -1,174 +0,0 @@
---
id: A04-DOK-01
typ: prozessanalyse
titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess
status: diskussionsentwurf
version: "0.6"
stand: 2026-10-31
prozess: V01
archetyp: A4
quellen:
- "Vorlage MV für fewo-direkt.pdf (4 Seiten, Betreiber)"
- "Betreiberbeschreibung: manueller A4-Istprozess, 31.10.2026"
---
# A4 – Vertragsvorlage und Prozessanalyse
> **Arbeitsdokument, keine Freigabe zur Änderung rechtlicher Klauseln.** Die Vertragsvorlage ist ein Beispiel für den aktuellen Ablauf, kein Nachweis der beim Buchungsabschluss über FeWo-direkt tatsächlich akzeptierten Konditionen. **Zugangscodes, Passwörter, persönliche Kontaktdaten und Namen von Gästen werden hier bewusst nicht reproduziert.**
## 1. Einordnung in den dokumentierten Istprozess
1. FeWo-direkt bestätigt extern eine verbindliche Buchung und sendet eine E-Mail mit Gastname und Zeitraum.
2. Der Vermieter sperrt andere Belegungskalender manuell.
3. Im FeWo-direkt-Vermieterbereich werden verfügbare Gastkontakte und Buchungs-/Preisdaten ermittelt.
4. Fehlende Angaben aller tatsächlich erforderlichen Reisenden werden per Gastkontakt angefordert.
5. Der Vermieter erstellt einen individuellen Mietvertrag anhand der vierseitigen Vorlage und versendet ihn mit der Internetvereinbarung.
6. FeWo-direkt fordert Anzahlung und Restzahlung an und verarbeitet diese. **Korrektur durch Screenshots vom 31.10.2026:** In der einzelnen Buchungs-Kommunikation ist ein Zahlungsplan mit Raten, Fälligkeiten und Zahlungsmarkierung sichtbar; die vollständige Zahlungs-, Gebühren- und Auszahlungstransparenz bleibt unbewiesen.
7. FeWo-direkt versendet ca. 72 Stunden vor Check-in eine Gastinformation (Betreiberangabe).
8. Vermieter informiert lokale Dienstleister (Schlüssel, Reinigung, Gästebetreuung).
9. Stornierungen werden nach aktueller Praxis über FeWo-direkt abgewickelt; konkrete Verantwortlichkeiten und Statusübermittlung sind noch zu prüfen.
### Nachtrag: vom Betreiber bestätigte Portalpraxis (31.10.2026)
- **Der eigene vierseitige Mietvertrag ist nicht im FeWo-direkt-Inserat hinterlegt.** Gäste erhalten ihn erst im nachgelagerten eigenen Versand, soweit der derzeitige Ablauf beschrieben ist.
- Der Betreiber **kann derzeit nicht einsehen**, welche Buchungs-/Vertragsunterlagen FeWo-direkt dem Gast im konkreten Abschluss zusendet. Deshalb ist **nicht nachgewiesen**, welche Klauseln der Gast wann erhält und akzeptiert.
- **Mietpreise müssen nach bisheriger Praxis im FeWo-direkt-Kalender gepflegt werden**; Rabatte und Stornobedingungen werden ebenfalls im Portal verwaltet. Der bei Buchung vereinbarte Portalkonditionsstand ist für diese Buchung maßgeblich und darf nicht durch unsere eigene Kalkulation ersetzt werden.
- Dies ist ein **konkretes Kanalprofil A4**, **keine allgemeine Regel** für andere Portale. Andere Kanäle können Preise, Konditionen, Vertrag und Abwicklung anders verteilen.
- **Die Vertragsvorlage wird passend zu Portal, tatsächlichem Buchungstyp und ggf. Herkunft ausgewählt**. Andere Portale können eigene Vorlagen und Anlagen erfordern; bestehende Vertragsdokumente werden versioniert.
## 2. Was die vierseitige Vorlage derzeit enthält
| Textabschnitt | Inhalt | Prozesszuordnung |
|---|---|---|
| Präambel, § 1–2 | Vertragsparteien, konkrete Ferienwohnung, Zeitraum, An-/Abreisezeiten | P02/P04 |
| § 2–3 | Schlüsselübergabe durch lokalen Dienstleister, Kurabgabe/Anmeldung | P04 |
| § 4 | Mietsumme einschließlich verschiedener Kosten; Portal-Servicegebühr; Anzahlung/Restzahlung | P02/P03 |
| § 5 | 'Annahme' des Vertrages durch Anzahlung; Sorgfalt/Schäden | P02 / Sonderfall |
| § 6–9 | Wäsche, Sauna, Schlüssel, Hausordnung | P04 |
| § 10–12 | Sorgfalt, Beanstandungen, Rauchverbot, Internet und Internetvereinbarung | P02/P04 |
| § 13 | Rücktritt: 60+ Tage 0 %, 59–30 Tage 50 %, ab 29 Tage 100 % des Mietpreises; Ersatzmieterregelung | Sonderprozess Stornierung |
| § 14 | Abreise- und Reinigungsanforderungen | P04/P05 |
| § 15–18 | Gerichtsstand, Form, Datenschutz, salvatorische Klausel | Recht/Compliance |
| Anlage Seite 4 | Internetnutzung, WLAN-Zugang, Gerätehinweise | Gästeinformation/Sicherheitsdaten |
## 3. Wesentliche Befunde und Prüfaufträge
**F-01 – Verbindlichkeit (§ 5), hohe Priorität.** Die Klausel setzt 'Annahme des Vertrages' mit einer bereits gezahlten Anzahlung in Zusammenhang. Nach der fachlich angenommenen A4-Logik besteht die bindende Portalbuchung aber **vor** unserem späteren Dokumentenversand. Es ist zu prüfen, was vor Vertragsschluss auf FeWo-direkt bereitgestellt wurde. Ein nachgeschicktes PDF darf neue Bedingungen nicht stillschweigend zur bisherigen Buchung hinzufügen. **Fachliches Soll:** Trennung zwischen Nachweis der externen Buchung und nachgelagerter Übermittlung bestehender Bedingungen.
**F-02 – Vollständige Konditionen vor Buchung, hohe Priorität.** Der bisherige Ablauf lässt offen, ob Hausordnung, Internetanlage, Stornoregel, Zusatzleistungen und weitere Bedingungen vor dem FeWo-direkt-Klick einsehbar waren. Die offiziellen Vermieter-AGB verlangen die Offenlegung der jeweiligen Konditionen und erlauben Zusatzvereinbarungen nur im Einklang mit den zuvor veröffentlichten Informationen. **Bestätigter Ist-Zustand:** Die PDF-Vorlage ist nicht im Inserat hinterlegt. **Offen:** Welche Vertragsbedingungen und Unterlagen FeWo-direkt im konkreten Abschluss anzeigt oder übersendet, kann der Betreiber derzeit nicht nachvollziehen. Ob eine Hinterlegung sinnvoll ist, bleibt eine optionale Maßnahme, keine allgemeine Systemvorgabe. Die konkret angezeigten Bedingungen sind gesondert zu ermitteln.
**F-03 – Preisstruktur (§ 4), hohe Priorität.** Das Dokument nennt Gesamtbetrag, Endreinigung, Betreuung, Servicegebühr des Portals, Anzahlung und Restzahlung in einem Text. Erforderlich sind fachlich getrennte Werte: vom Gast verbindlich vereinbarte Gesamtkonditionen, darin enthaltene Unterkunfts-/Leistungsentgelte, ggf. separate Reisenden-Servicegebühr des Portals, Vermieterprovision, Auszahlungsbetrag und Zahlungsstatus. **Keine zusätzlichen Beträge durch FewoPortal erheben, die nicht Bestandteil der Vereinbarung sind.** Konkrete Gebührenstruktur im Vermieter-/Gastbeleg gegenprüfen.
**F-04 – Storno (§ 13), hohe Priorität.** Die Vorlage enthält die oben genannten Staffeln. Nicht belegt ist, ob exakt diese Staffel für die konkrete FeWo-direkt-Buchung vor Abschluss angezeigt und vereinbart wurde. Der Gast kann laut FeWo-direkt über sein Konto stornieren; Erstattungen richten sich nach der anwendbaren Richtlinie. Der Vermieter darf daher aus der nachträglich versandten Vorlage keine abweichenden Gebühren ableiten. Vermieterseitige Stornierungen sind zusätzlich durch FeWo-direkt-Sanktionsregeln besonders riskant.
**F-05 – Gast- und Meldedaten (§ 3), mittlere Priorität.** Der Vertrag sieht die örtliche Anmeldung durch einen Dienstleister und die Kurabgabe vor. Welche Felder für wen und zu welchem Zeitpunkt rechtlich erforderlich sind, muss anhand der kommunalen Vorgaben gesondert definiert werden. Die im Vertrag genannten Tarife und Altersgrenzen stimmen mit der derzeit öffentlich ausgewiesenen Kühlungsborner Information überein, sollten aber nicht dauerhaft als fixe Vertragskonstanten im Produkt behandelt werden.
**F-06 – Rechtlich prüfbedürftige Vertragsklauseln, hohe Priorität.** Besonders § 10–11 (pauschale Einschränkungen von Mietminderung/Beanstandungen), § 15 (vorgegebener Gerichtsstand Dortmund für private Gäste), § 16 (Schriftform/E-Mail), § 17 (Datenverwendung/Übermittlung an Dienstleister) und die Formulierung zur maschinellen Unterschrift sind juristisch zu prüfen. Die Wirksamkeit ist nicht allein aus dieser Analyse abschließend zu beurteilen.
**F-07 – Zugangsdaten und Anlagen, hohe Priorität.** Seite 2 und 4 enthalten feste Zutritts-/WLAN-Daten. Diese sollten nicht dauerhaft Bestandteil der allgemeinen, archivierten Vertragsvorlage sein. Empfehlung: separate, gezielt zur Anreise freigegebene Gästeinformation. Bereits offengelegte Zugangsdaten kontrollieren/ggf. wechseln. Eine separate Internet-Nutzungsvereinbarung ist fachlich eine versionierte Anlage, muss aber in ihrem rechtlichen Status geklärt sein.
**F-08 – Unterschiedliche Dokumentzwecke, mittlere Priorität.** Vertrags-/Konditionsnachweis, ortsbezogene Aufenthaltshinweise und sensible Zugriffsinformationen nicht zwingend in einem vierseitigen 'Mietvertrag' bündeln. Ziel: **ein gemeinsames, einfaches FewoPortal-Dokumentenmanagement** mit richtigem Zeitpunkt der Bereitstellung, kein neues eigenständiges Buchungsformular.
**F-09 – Datenqualität, mittlere Priorität.** Die konkrete Vorlage enthält variable, noch unbesetzte Felder (z. B. Reisende, Daten, Preis, Nächte). Beim Dokumenterstellen müssen Vollständigkeit, Übereinstimmung mit der Portalbuchung und Version der gültigen Anlagen geprüft werden; bei einem Konflikt wird der Versand gesperrt bzw. eine Klärung ausgelöst.
## 4. Soll-Funktionsbild für A4 (noch nicht beschlossen)
**Bindungsnachweis aus FeWo-direkt** → **Portalpreis und bei Buchung vereinbarte Konditionen übernehmen** → **Gastdaten gezielt nachfordern** → **Dokumente aus verifiziertem Konditionsstand erstellen und ohne zweite Annahme übermitteln** → **Portalzahlungen/Storno extern verfolgen, ohne Zahlungen zu erfinden** → **separate Anreiseinformationen und Dienstleisteraufgaben auslösen**.
Bei einer Abweichung zwischen dem vom Gast akzeptierten Konditionsstand und dem späteren Dokument **nicht automatisch ein abweichendes Vertragsdokument verschicken**, sondern in FewoPortal einen Klärungsfall eröffnen.
## 5. Noch offene fachliche Klärung
**Welche Konditionen sieht und bestätigt der Gast bei einer konkreten FeWo-direkt-Direktbuchung und welche Dokumente erhält er anschließend tatsächlich vom Portal?**
Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile und Vertragsvorlagen]].
## 6. Öffentliche Quellen für die juristisch-technischen Prüfpunkte
- [FeWo-direkt – AGB für Vermieter (29.10.2026), insb. Nr. 2.2–2.3](https://www.fewo-direkt.de/lp/b/partner-terms-of-use)
- [FeWo-direkt – Hochladen Ihres Mietvertrags](https://hilfe.fewo-direkt.de/articles/Wie-kann-ich-meinen-Mietvertrag-hochladen)
- [FeWo-direkt – Stornierungen durch Gäste](https://hilfe.fewo-direkt.de/articles/Kann-ein-Urlauber-eine-Reservierung-stornieren)
- [FeWo-direkt – Richtlinie für Gastgeberstornierungen](https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy)
- [§ 305 BGB – Einbeziehung von AGB](https://www.gesetze-im-internet.de/bgb/__305.html)
- [§ 307 BGB – Inhaltskontrolle](https://www.gesetze-im-internet.de/bgb/__307.html)
- [§ 309 Nr. 5 BGB – Pauschalierter Schadensersatz](https://www.gesetze-im-internet.de/bgb/__309.html)
- [§ 536 BGB – Mietminderung](https://www.gesetze-im-internet.de/bgb/__536.html)
- [§ 38 ZPO – Gerichtsstandsvereinbarung](https://www.gesetze-im-internet.de/zpo/__38.html)
- [§ 126 BGB – Schriftform](https://www.gesetze-im-internet.de/bgb/__126.html), [§ 127 BGB – Vereinbarte Form](https://www.gesetze-im-internet.de/bgb/__127.html)
- [Kühlungsborn – Kurabgabe](https://www.kuehlungsborn.de/kurabgabe/)
**Abgrenzung:** Dies ist eine fachliche Prozess- und Risikoprüfung, keine rechtliche Freigabe und keine eigenmächtige Überarbeitung der Betreiber-Vertragstexte.
## 7. Nachtrag aus belegten Bildschirmansichten (31.10.2026) – Ist-Zustand, nicht allgemeines Portalverhalten
**Quelle:** Vier Screenshots aus dem FeWo-direkt-Vermieterbereich zu einer konkreten, erst im Juli 2027 stattfindenden Buchung. Gastname, Buchungsreferenz und Unterkunfts-ID werden aus Datenschutzgründen hier nicht reproduziert. Die Screenshots belegen die Anzeige in dieser Buchung, nicht automatisch die generelle Exportierbarkeit oder die vertragsrechtliche Richtigkeit.
### 7.1 Nachgewiesene Buchungs- und Zahlungsinformationen
| Datenpunkt | In der konkreten Buchung sichtbar | Bedeutung / Grenze |
|---|---|---|
| Zeitraum und Gäste | 10.–17.07.2027, sieben Nächte, zwei Erwachsene | Belegungssachverhalt, keine vollständigen Gaststammdaten |
| Übernachtungspreis | 840,00 € über sieben Nächte | Aggregierter Betrag, keine einzelnen Tagespreise |
| Rabatt | −42,00 € | Rabattbetrag bekannt, Berechnungs-/Aktionsregel nicht belegt |
| Gebühren und Steuern | 181,51 € | Als Summe ausgewiesen, Einzelbestandteile nicht nachgewiesen |
| Gesamtzahlung des Gastes | 979,51 € | Rechnerisch 840 − 42 + 181,51; kann gastseitige Gebühren enthalten |
| An FeWo-direkt gezahlt | −84,82 € | So beschriftet; genaue Gebührenart/Zuordnung nicht belegt |
| Ausgewiesene Gesamtauszahlung | 894,69 € | Rechnerisch 979,51 − 84,82 |
| Andere Buchungsübersicht | **900,20 € voraussichtliche Auszahlung** | **Abweichung von 5,51 €** zur Zahlungsübersicht; ungeklärt, nicht als korrekt/fehlerhaft einstufen |
| Rate 1 von 2 | 390,61 €, als bezahlt am 01.10.2026 markiert | Nachweis eines Portal-Zahlungsstatus, **kein Bank-Auszahlungsnachweis** |
| Rate 2 von 2 | 588,90 €, fällig am 12.06.2027 | In Screenshot nicht als bezahlt ausgewiesen; beide Raten zusammen ergeben 979,51 € |
| Voraussichtliche Vermieterauszahlung | 11.07.2027 angekündigt | Geplantes Ereignis, nicht als tatsächlich ausgeführt nachgewiesen |
| Stornoübersicht | 100 % Erstattung bei mehr als 60 Tagen; 50 % bei mehr als 30 Tagen; keine Erstattung bei weniger als 30 Tagen | Angezeigte Portalbedingungen; Grenzfall bei exakt 60/30 Tagen und rechtliche Einbeziehung separat prüfen |
| Zugangsinformationen | Portal kündigt Gäste-E-Mail 72 Stunden vor Check-in an, zeigt Schlüsselabholart und Vorschautext | Angekündigter Portalversand, **kein Versand-/Empfangsnachweis** |
**Korrektur früherer Aussage:** Nicht „keine Zahlungsinformationen zugänglich“, sondern **teilweise buchungsbezogene Zahlungsinformationen in der Kommunikationsansicht zugänglich**. Der Betreiber berichtete weiterhin über fehlenden brauchbaren allgemeinen Export/Zahlungsverlauf und fehlende vollständige Einzelpreis-/Gebührenaufschlüsselung. Dies bleibt als Beobachtung bestehen, sofern nicht durch andere Ansichten widerlegt.
### 7.2 Auswirkungen auf den generischen Prozess
- **P02/G2 – Konditionen:** Gesamtpreis, Rabatt, angezeigte Gebühren, Stornoregel und Quelle getrennt mit Nachweis speichern; unbekannte Einzelpreise oder Gebührenarten **nicht rekonstruieren oder schätzen**.
- **P03/G3 – Zahlungen:** Separate Zustände für *Rate fällig*, *Rate laut Portal bezahlt*, *Vermieterauszahlung erwartet* und *Vermieterauszahlung tatsächlich eingegangen*. Die Markierung „bezahlt“ ist **kein Nachweis der Auszahlung an den Vermieter**.
- **P03 – Abrechnungskonflikt:** Unterschied 900,20 € vs. 894,69 € als konkreter Klärungsfall; nicht automatisch einen der beiden Beträge überschreiben.
- **P04 – Anreise:** Geplante E-Mail 72 Stunden vor Check-in als externe Kommunikationsaktivität berücksichtigen; dokumentieren, ob tatsächliche Versendung oder nur Ankündigung bekannt ist.
- **Portabilität:** Der Screenshotsatz ist eine **Portalreferenz A4**, kein festverdrahtetes Datenmodell für alle externen Kanäle.
### 7.3 Unverändert offene Prüfpunkte
1. Ergebnis von **„Vollständige Zahlungsdetails ansehen“**: Gibt es eine tiefere Aufschlüsselung der 181,51 € und der 84,82 €?
2. Ursache der **5,51-€-Differenz** zwischen zwei angezeigten Auszahlungsbeträgen.
3. Nachweis tatsächlicher Auszahlungen und belastbarer Status-/Exportmöglichkeit für abgeschlossene Buchungen.
4. Welche Bedingungen und Bestätigungsunterlagen erhält der Gast beim verbindlichen Portalabschluss?
5. Umfang der benötigten und tatsächlich bereitgestellten Gäste- und Meldedaten.
**Bewertungsregel:** Beobachtete Portaloberfläche, fachliche Interpretation und noch nicht geprüfte Annahmen konsequent getrennt führen.
## 8. Buchungsänderung und Storno – geprüfter Erkenntnisstand (31.10.2026)
**Ist-Praxis (Betreiber):** Bislang wurden weder eine Vermieterstornierung noch eine Buchungsänderung selbst durchgeführt. Bei Konflikten oder Doppelbuchungen wurde versucht, den Gast zur Stornierung zu bewegen. Das ist keine freigegebene Soll-Regel.
**Offiziell von FeWo-direkt beschrieben:** Gäste können selbst stornieren oder eine Stornierungsanfrage stellen. Gäste können Änderungsanfragen für Daten, Gästezahl oder Check-in stellen; Vermieter können solche Anfragen bearbeiten, ggf. mit neuer Preis-/Steuerberechnung. Gastgeber können über ihr Vermieterkonto stornieren, müssen mit Gebühren/Sanktionen rechnen und können in bestimmten begründeten Fällen einen Stornierungsverzicht beantragen. Doppelbuchungen des Gastgebers gelten grundsätzlich als gastgeberveranlasster Stornogrund. Die Richtlinie untersagt es ausdrücklich, Gäste zur Stornierung zu bewegen, um Sanktionen für den Gastgeber zu umgehen. Der bloße persönliche Konflikt mit einem Gast ist keine gesicherte Ausnahme; mögliche Hausregelverstöße müssen konkret geprüft werden.
**Generische Prozessanforderung:** Für jeden Änderungs-/Stornofall Ursache, tatsächlichen Initiator, technisch ausführenden Beteiligten, Verantwortlichen für Entscheidung/Erstattung, Ausführungs- und Nachweisstatus sowie Folgen für Konditionen, Vertrag, Belegung und Zahlung getrennt führen. Eine Storno-/Änderungsanfrage verändert nicht automatisch eine verbindliche Buchung. Datenquellen können je Portal unterschiedlich sein (Portal, API, E-Mail, iCal, manuell).
**Weiter ungeklärt:** Tatsächliche Benachrichtigungs- und Statusübermittlung an FewoPortal; Ablauf/Fristen und Nachweise im konkreten Konto; Verfahren anderer Portale.
**Offizielle Quellen:**
- https://hilfe.fewo-direkt.de/articles/Kann-ein-Urlauber-eine-Reservierung-stornieren
- https://hilfe.fewo-direkt.de/articles/Accept-or-decline-a-guest-s-change-request
- https://hilfe.fewo-direkt.de/articles/Die-Reservierung-eines-Gastes-stornieren
- https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy
## 9. Einordnung nach Gesamt-Konsolidierung v0.7
1. **A4 bleibt realer Praxisfall**, nicht Muster für alle Portale. FeWo-direkt zeigt in einer Buchung im Posteingang Zahlungsplan, einige aggregierte Preisbestandteile, Gäste-Gesamtzahlung, Abzug und erwartete Auszahlung; eine lückenlose Einzelpreis-/Gebührentransparenz und eine konsistente Auszahlungsübersicht sind weiter **nicht nachgewiesen**. Das frühere pauschale Urteil „keinerlei Zahlungsdaten“ ist überholt; konkrete Screenshots in Abschnitt 7 sind maßgeblich.
2. **Ical-Verzögerung:** Direkte Buchung kann vor Verarbeitung einer anderswo veranlassten Blockierung verbindlich werden. FewoPortal darf eigene erfolgreiche Exporte nicht als Portal- oder Partnernetzbestätigung behandeln. Die Idee eines 10-Minuten-Freigabefensters ist **kein aktuell verfügbarer A4-Prozess**.
3. **Vertragsdokumente:** Der eigene vierseitige Vertrag wird bisher nach der Portalbuchung versandt und ist nicht als statisches PDF in FeWo-direkt hinterlegt; Inhalt der dem Gast vor/bei Buchung gezeigten Bedingungen bleibt zu verifizieren. Statische allgemeine Bedingungen von individuellen Preis-/Zahlungsdetails trennen; keine still nachgeschobenen Verpflichtungen.
4. **Sonderprozesse:** Bisher keine konkret selbst durchlaufene FeWo-direkt-Buchungsänderung und keine eigene Vermieterstornierung. Kein nicht erprobtes Verfahren als gelebte Praxis behaupten. Differenzierung **tatsächliche Stornoursache, Antragsteller, ausführender Beteiligter** beachten.
5. **Abrechnung:** Unbekannte Gast-Servicegebühren, Portalabzüge, Vermieterprovisionen oder kombinierte Sammelpositionen müssen nicht künstlich zerlegt werden. Portalinformationen und manuelle Ergänzungen mit Quelle sichern; bei abweichenden Summen Klärungsaufgabe.
Fachliche Konkretisierung: [[K01_Preisstruktur_und_Abrechnung|K01]], [[X01_Belegungskonflikte_und_Sperrnachweise|X01]] und [[O00_Offene_Portalprueffaelle|O00]]. Keine Aktualisierung oder juristische Freigabe des ursprünglichen PDF-Vertrags durch diese Analyse.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Buchungsarchetypen|Archetypen]] · [[00_Portalprofile_und_Vertragsvorlagen|Vertragsprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]] · [[P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch|Frühere Fassung im P03-Archiv]]
@@ -1,184 +0,0 @@
--- a/00_Prozesslandkarte.md
+++ b/00_Prozesslandkarte.md
@@ -1,4 +1,5 @@
-# 00 – Prozesslandkarte FewoPortal
+
+# 00 – Prozesslandkarte FewoPortal v0.5
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
**Stand:** 31.10.2026
@@ -35,7 +36,7 @@
| **P02** | Konditionen & Buchungsverbindlichkeit | Verbindlichkeit durch fristgerechte Annahme des **von uns bindenden Angebots** oder Nachweis einer schon verbindlichen Portalbuchung; gültige Konditionen revisionsfähig festgehalten |
| **P03** | Buchungsverwaltung & kaufmännische Abwicklung | Vertragsdokumente, Zahlungszuständigkeit, Fristen und Verwaltungsaufgaben gesteuert, auch bei extern verantworteten Aktivitäten |
| **P04** | Leistungsvorbereitung & Aufenthalt | Informationen und lokale Leistungen bereitgestellt; Anreise, Aufenthalt, Abreise betreut |
-| **P05** | Abschluss & Nachbereitung | Offene Vorgänge transparent; Abschluss, Feedback und objektbezogene Folgeaufgaben; zulässige Übergabe an V02 |
+| **P05** | Abschluss & Nachbereitung | Buchungs- und Leistungserbringung fachlich abgeschlossen; offene, danach eigenständig zu bearbeitende Fälle kontrolliert an Folgeprozesse übergeben; Feedback und objektbezogene Folgeaufgaben; zulässige Übergabe an V02 |
### V02 – Vermarktung, Gästegewinnung und Gästebindung (fachlich vorgesehen, Details später)
@@ -84,15 +85,17 @@
- X08: No-show, vorzeitige Abreise, Verlängerung
- X09: Reklamation, Schaden, Kaution und Nachforderung
-Ein Sonderprozess kann mehrere Phasen betreffen und verwendet dieselbe Buchungsakte und Ereignishistorie.
+Ein Sonderprozess kann mehrere Phasen betreffen und verwendet dieselbe Buchungsakte und Ereignishistorie. **Nach abgeschlossenem Buchungs- und Leistungsprozess** können noch offene Ansprüche oder Konflikte als eigenständig zu bearbeitende Folgeprozesse weitergeführt werden; die Referenz auf die ursprüngliche Buchung und der Übergabenachweis bleiben erhalten (E-010).
## F. Zentrale Gate-Philosophie
+
+**P05-Abschluss-/Übergabegate (E-010):** Abschluss der Buchungs- und Leistungserbringung ist vom Ende nachlaufender Forderungs-, Schadens- oder Streitfälle zu unterscheiden. Offene Fälle werden mit Kontext, Verantwortlichkeit und Referenz zur Buchung an den jeweils zuständigen Folgeprozess übergeben. Die endgültigen Pflichtkriterien und Zustände werden in P05 spezifiziert.
Gates dokumentieren **Trigger, erwartetes Ergebnis, erforderliche Daten, Herkunft/Nachweis, zuständige Stelle, Ergebnisstatus, Folgeschritt**. Pflichtinformationen sind **aktivitätsbezogen**, nicht für alle Portale pauschal identisch. Fehlende Adressdaten dürfen eine durch Portalnachweis verbindliche Buchung nicht entwerten; sie blockieren nur Tätigkeiten, für die sie wirklich erforderlich sind.
## G. Noch zu entscheiden
-1. Fachlicher Abschluss von V01 bei offenen Rechnungen, Schäden oder Portalrückmeldungen.
+1. **Detailkriterien für den fachlichen Abschluss von V01:** Welche Leistungen, Informationen und Übergaben müssen konkret abgeschlossen sein? Die Grundentscheidung ist getroffen: Nachlaufende Forderungen/Schäden blockieren nicht allein den Abschluss der Buchungs- und Leistungserbringung, wenn sie nachvollziehbar an einen verantwortlichen Folgeprozess übergeben wurden (E-010).
2. Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; **keine Entscheidung für ein eigenständiges Objektmanagement-Modul**.
3. Genauer Status- und Gate-Katalog, insbesondere Synchronisationssicherheit und externe Stornoereignisse.
4. Abgrenzung P03/P04; Relevanz und Nachweisbarkeit der lokalen Prozesse.
--- a/E00_Entscheidungsprotokoll.md
+++ b/E00_Entscheidungsprotokoll.md
@@ -1,3 +1,4 @@
+
# E00 – Entscheidungsprotokoll
**Stand:** 31.10.2026. Entscheidungen sind fachliche Betreiberfestlegungen, keine bestätigte Rechtsprüfung oder Implementierungsfreigabe.
@@ -13,9 +14,10 @@
| **E-007** | Beschlossen / Betreiberpräzisierung | Produktfokus: Eigene Website als zentraler Einstieg für einen Vermieter mit typischerweise **1–3 Ferienwohnungen**; mehrere Mandanten möglich; **kein Marktplatz**. Primär Gästegewinnung, Buchung und weitgehend automatisierte Abwicklung, nicht umfangreiche Haus-/Objektverwaltung. |
| **E-008** | Beschlossen / Betreiberpräzisierung | V02 umfasst **Multichannel-Marketing und Gästegewinnung** (eigene Website, Social Media, Print, externe Portale) **sowie CRM, Stammkundenmanagement und Loyalty**. Damit ist V02 nicht nur Folgeprozess, sondern auch vorgelagert. Feedback/Bewertungen bleiben in V01. Detaillierung von V02 folgt später. |
| **E-009** | Beschlossen / Betreiberpräzisierung | Buchungsbezogene Objektaufgaben (Reinigung, Schlüsselübergabe, lokale Leistungen) im Hauptprozess **einfach und integriert** behandeln. Die fachliche Existenz von Supportprozessen bedeutet **keine Pflicht zu eigenen Verwaltungsmodulen**. Erweiterte Objektverwaltung, Dienstleister-/Personalplanung und Vermittlungsagentur-Funktionen derzeit nicht priorisieren; Erweiterbarkeit offenhalten. |
+| **E-010** | Grundsatz bestätigt / Details offen | Der Hauptwertschöpfungsprozess V01 endet fachlich mit Abschluss der Buchungs- und Leistungserbringung. Danach weiterlaufende Forderungs-, Schaden- oder Streitfälle sind **an zuständige Folgeprozesse zu übergeben**, anstatt den gesamten Buchungsprozess künstlich offen zu halten. Zusammenhang zur Buchung, Zuständigkeit und Übergabe müssen nachvollziehbar bleiben. Das genaue Abschluss-Gate ist noch zu spezifizieren. |
## Offene Grundsatzentscheidungen
-- Fachliche Abschlusskriterien von V01 bei nachlaufenden Forderungen/Schäden/Portalstatus.
+- Konkrete Mindestkriterien für P05-Abschluss, Übergabenachweis und Zuständigkeit der Folgeprozesse; Umgang mit abgebrochenen oder stornierten Vorgängen.
- Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; Umfang späterer buchungsunabhängiger Funktionen.
- Exakter Mindest-Nachweis und Datenumfang je externem Portalprofil.
@@ -29,4 +31,4 @@
## Dokumentationsregel (Arbeitsvereinbarung)
-Die bestehende Gitea-Dokumentation ist die führende Ablage. Es gibt **eine aktuelle Markdown-Datei je Thema**, P01–P05 dürfen jeweils mehrere Unterdokumente enthalten. Bei **neuen Markdown-Dateien** einen knappen YAML-Header (`id`, `typ`, `titel`, `status`) verwenden. Bestehende Abschnitte bei Fortschreibungen nicht still kürzen oder löschen; fachliche Entscheidungen mit ID verknüpfen und Änderungen per Git-Diff kontrollieren. **Keine implizite Freigabe von Implementierung oder Go-live.**
+Die bestehende Gitea-Dokumentation ist die führende Ablage. Es gibt **eine aktuelle Markdown-Datei je Thema**, P01–P05 dürfen jeweils mehrere Unterdokumente enthalten. Bei **neuen und fachlich aktualisierten Markdown-Dateien** einen knappen YAML-Header (`id`, `typ`, `titel`, `status`, `version`) verwenden. Bestehende Abschnitte bei Fortschreibungen nicht still kürzen oder löschen; fachliche Entscheidungen mit ID verknüpfen und Änderungen per Git-Diff kontrollieren. **Keine implizite Freigabe von Implementierung oder Go-live.**
--- a/G00_Gates_und_Uebergaben.md
+++ b/G00_Gates_und_Uebergaben.md
@@ -1,3 +1,4 @@
+
# G00 – Gate- und Übergabemodell (Arbeitsstand)
## Grundregel
@@ -23,5 +24,10 @@
- **GD:** Erforderliche Gästedaten für lokale Abwicklung liegen vor; darf auch nach GC offen sein.
- **GE:** Externer Portalprozess vollständig verantwortet: für lokale Abwicklung notwendige Informationen vorhanden, extern zuständige Vorgänge ausgewiesen.
+## P05 – Abschluss- und Folgeprozess-Übergabe (Grundsatz E-010)
+- **Abschluss V01:** Fachliche Buchungs- und Leistungserbringung ist beendet; ein ausstehender Anspruch allein blockiert den Prozessabschluss nicht, wenn dessen Bearbeitung wirksam an einen verantwortlichen Folgeprozess übergeben wurde.
+- **Übergabe:** Benötigt mindestens Referenz zur ursprünglichen Buchung, Beschreibung des offenen Sachverhalts, verantwortliche Stelle und nachweisbaren Übergabestatus. Detailumfang und Automatismus bleiben offen.
+- **Status:** Buchungsprozess abgeschlossen und Folgeprozess offen sind gleichzeitig möglich. Die technische Ausgestaltung der Akte ist noch nicht beschlossen.
+
## Noch offen
-Konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
+Detailkriterien für das P05-Abschlussgate und die Behandlung von Storno-/Abbruch-Ausgängen; konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
--- a/S00_Supportprozesse.md
+++ b/S00_Supportprozesse.md
@@ -1,3 +1,4 @@
+
# S00 – Supportprozesse (vorläufiger Katalog)
Diese Prozesse unterstützen V01 und V02. **Produktmandat E-007 bis E-009:** FewoPortal richtet sich zunächst an Vermieter mit typischerweise 1–3 Ferienwohnungen, mehreren möglichen Mandanten, aber **ohne Marktplatz-/Agentur-Schwerpunkt**. Ein fachlicher Supportprozess rechtfertigt **kein eigenständiges Softwaremodul**. Buchungsbezogene Aufgaben sind möglichst in der Buchungsakte integriert und automatisiert; weitergehende Objektverwaltung bleibt Zukunftsoption.
--- a/X00_Sonderprozesse.md
+++ b/X00_Sonderprozesse.md
@@ -1,3 +1,4 @@
+
# X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog)
Sonderprozesse können aus unterschiedlichen Phasen starten. Sie nutzen dieselbe Vorgangsakte; keine parallelen Buchungsformulare/-workflows.
@@ -14,4 +15,6 @@
| X08 | Aufenthaltsabweichung | No-show, Verlängerung, vorzeitige Abreise |
| X09 | Schäden/Reklamation | Mangel, Schaden, Kaution/Nachforderung |
+**Prozessübergabe nach V01 (E-010):** Nach Abschluss der Buchungs- und Leistungserbringung noch offene Fälle (z. B. Schadenersatzforderung, Erstattung, Streitfall) werden an einen zuständigen Folgeprozess übergeben. Sie bleiben mit der ursprünglichen Buchung verbunden. Ob dafür ein separater Vorgang oder eine verknüpfte Aktivität angelegt wird, ist noch nicht entschieden.
+
**Rechtsfragen separat:** Für externe Vollabwicklung liegt die Vertrags-/Mahn-/Storno-Verantwortung beim Portal gemäß vertraglicher Vereinbarung; FewoPortal braucht einen nachvollziehbaren Übergabestatus und mindestens die für eigene Pflichten nötigen Informationen.
--- a/README.md
+++ b/README.md
@@ -1,18 +1,19 @@
-# FewoPortal – Prozessarchitektur v0.4
+
+# FewoPortal – Prozessarchitektur v0.5
**Status:** Fachlicher Arbeitsstand / Interview, keine Implementierungsfreigabe
**Stand:** 31.10.2026
-Diese Version konsolidiert die Betreiberangaben vom 31.10.2026, die v0.3 und die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert.
+Diese Version konsolidiert die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die danach bestätigten Entscheidungen E-007 bis E-010 und die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
## Dateien
- `00_Prozesslandkarte.md` – Generischer Gesamtprozess, Prozessfamilien und Zuordnung
-- `P01_Buchungseingang_und_Verfuegbarkeit.md` bis `P05_Abschluss_und_Nachbereitung.md` – getrennte Phasengerüste
+- `P01/` bis `P05/` – je ein eigener Unterordner mit dem bisherigen Phasengerüst; weitere Detaildokumente können dort ergänzt werden
- `G00_Gates_und_Uebergaben.md` – übergreifende Gates
- `S00_Supportprozesse.md` und `X00_Sonderprozesse.md` – vorläufige Kataloge
- `E00_Entscheidungsprotokoll.md` – beschlossene Punkte und offene Fragen
**Quellen:** `crystalline-floating-glacier.md`, `UEBERGABE-BUCHUNGSPROZESS.md`, Gesamtprozess v0.3 und die Betreiberpräzisierung vom 31.10.2026. Weitere Fach- und Rechtsprüfung erforderlich.
-**Arbeitsregel:** Nur ausdrücklich beschlossene Punkte als Entscheidung kennzeichnen; Vorschläge als solche markieren. Keine automatischen Änderungen am produktiven System.
+**Arbeitsregel:** Nur ausdrücklich beschlossene Punkte als Entscheidung kennzeichnen; Vorschläge als solche markieren. Jede Datei trägt einen YAML-Header mit `id`, `typ`, `titel`, `status`, `version`. Die Version v0.5 bezeichnet den konsolidierten **Dokumentationsstand**, nicht eine Implementierungsversion. Bestehende Inhalte werden nicht stillschweigend gekürzt. Änderungen an Gitea erfolgen erst nach Abgleich mit dem dortigen Stand. Keine automatischen Änderungen am produktiven System.
--- a/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
+++ b/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
@@ -1,3 +1,4 @@
+
# P01 – Buchungseingang und Verfügbarkeitssicherung
**Status:** Phasengerüst – Detailinterview steht aus.
--- a/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
+++ b/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
@@ -1,3 +1,4 @@
+
# P02 – Konditionen und Buchungsverbindlichkeit
**Status:** wesentliche Geschäftsregeln im Betreiberinterview bestätigt; Detail- und Rechtsprüfung offen.
--- a/P03/P03_Buchungsverwaltung_und_Abwicklung.md
+++ b/P03/P03_Buchungsverwaltung_und_Abwicklung.md
@@ -1,3 +1,4 @@
+
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
**Status:** Phasengerüst; Detailinterview steht aus.
--- a/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
+++ b/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
@@ -1,3 +1,4 @@
+
# P04 – Leistungsvorbereitung und Aufenthalt
**Status:** Phasengerüst; Detailinterview steht aus.
--- a/P05/P05_Abschluss_und_Nachbereitung.md
+++ b/P05/P05_Abschluss_und_Nachbereitung.md
@@ -1,19 +1,20 @@
+
# P05 – Abschluss und Nachbereitung
**Status:** Phasengerüst; Detailinterview steht aus.
## Zweck
-Aufenthalt und Buchung nachvollziehbar abschließen, Feedback einholen und offene Folgeaufgaben kontrolliert weiterführen.
+Buchungs- und Leistungserbringung nachvollziehbar abschließen, Feedback einholen und offene nachlaufende Fälle **kontrolliert an zuständige Folgeprozesse übergeben**, ohne den V01-Hauptprozess deshalb künstlich offen zu halten (E-010).
## Aktivitäten (vorläufig)
- Abreise und Leistungsabschluss dokumentieren.
-- Ausstehende Abrechnung, Erstattungen, Schäden oder Nachforderungen erkennen und behandeln.
+- Ausstehende Abrechnung, Erstattungen, Schäden oder Nachforderungen erkennen, soweit Teil der unmittelbaren Buchungsabwicklung behandeln und sonst mit nachvollziehbarer Zuständigkeit und Buchungsreferenz an einen Folgeprozess übergeben.
- Reinigung/Reparatur/Objektbereitstellung für nächsten Aufenthalt initiieren und Status verfolgen.
- Dankesnachricht, Feedback und Bewertung im **Buchungsprozess V01** abwickeln.
- Zulässige Informationen an den **eigenständigen Wertschöpfungsprozess V02 – Gästebindung/Marketing** übergeben; ggf. Loyalty-Ereignis auslösen.
## Gates
-Fachlicher, finanzieller und objektbezogener Abschluss können unterschiedliche Zustände haben. Das exakte Schließkriterium ist noch zu entscheiden.
+Fachlicher, finanzieller und objektbezogener Abschluss können unterschiedliche Zustände haben. **Grundsatz (E-010):** V01 kann nach erfolgter Buchungs- und Leistungserbringung fachlich abgeschlossen werden, auch wenn übergebene Ansprüche oder Konflikte noch zu bearbeiten sind. Übergaben müssen zugeordnet, nachvollziehbar und mit der Buchung verknüpft bleiben. **Welche Pflichtaktivitäten den V01-Abschluss konkret freigeben, ist noch offen.**
## Noch offen
-Wann Akte abgeschlossen sein darf; Weiterverfolgung offener Forderungen; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt.
+Genaue Abschlusskriterien und erforderliche Nachweise; Zuständigkeit und Verknüpfung nachlaufender Folgeprozesse; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt; alternativer Ausgang bei Stornierung oder abgebrochenem Vorgang. **Ob die technische Buchungsakte geschlossen wird oder nur der V01-Prozessstatus wechselt, ist nicht entschieden.**
@@ -1,193 +0,0 @@
--- v0.5/00_Prozesslandkarte.md
+++ v0.6/00_Prozesslandkarte.md
@@ -3,10 +3,10 @@
typ: prozesslandkarte
titel: FewoPortal – Prozesslandkarte
status: arbeitsstand
-version: '0.5'
+version: '0.6'
---
-# 00 – Prozesslandkarte FewoPortal v0.5
+# 00 – Prozesslandkarte FewoPortal v0.6
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
**Stand:** 31.10.2026
@@ -94,6 +94,8 @@
Ein Sonderprozess kann mehrere Phasen betreffen und verwendet dieselbe Buchungsakte und Ereignishistorie. **Nach abgeschlossenem Buchungs- und Leistungsprozess** können noch offene Ansprüche oder Konflikte als eigenständig zu bearbeitende Folgeprozesse weitergeführt werden; die Referenz auf die ursprüngliche Buchung und der Übergabenachweis bleiben erhalten (E-010).
+**Alternative fachliche Endergebnisse V01 (E-011):** Ein regulär erfüllter Aufenthalt, eine ohne Buchung beendete Anbahnung (z. B. Angebotsablauf oder Ablehnung) und die Stornierung nach entstandener Verbindlichkeit sind unterschiedliche Ergebnisse **desselben** generischen Prozesses. Eine reguläre Leistungserbringung durchläuft typischerweise P05; ein früher Abbruch muss nicht künstlich P03–P05 durchlaufen. Auslösende Ereignisse, Nachweise, ggf. Belegungsfreigabe und verbleibende Folgepflichten werden nachvollziehbar dokumentiert. Weitere Endergebnisse sowie exakte Übergangsbedingungen sind offen.
+
## F. Zentrale Gate-Philosophie
**P05-Abschluss-/Übergabegate (E-010):** Abschluss der Buchungs- und Leistungserbringung ist vom Ende nachlaufender Forderungs-, Schadens- oder Streitfälle zu unterscheiden. Offene Fälle werden mit Kontext, Verantwortlichkeit und Referenz zur Buchung an den jeweils zuständigen Folgeprozess übergeben. Die endgültigen Pflichtkriterien und Zustände werden in P05 spezifiziert.
@@ -104,7 +106,7 @@
1. **Detailkriterien für den fachlichen Abschluss von V01:** Welche Leistungen, Informationen und Übergaben müssen konkret abgeschlossen sein? Die Grundentscheidung ist getroffen: Nachlaufende Forderungen/Schäden blockieren nicht allein den Abschluss der Buchungs- und Leistungserbringung, wenn sie nachvollziehbar an einen verantwortlichen Folgeprozess übergeben wurden (E-010).
2. Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; **keine Entscheidung für ein eigenständiges Objektmanagement-Modul**.
-3. Genauer Status- und Gate-Katalog, insbesondere Synchronisationssicherheit und externe Stornoereignisse.
+3. Genauer Status- und Gate-Katalog, **einschließlich alternativer Prozessausgänge nach E-011**, Synchronisationssicherheit und externer Stornoereignisse.
4. Abgrenzung P03/P04; Relevanz und Nachweisbarkeit der lokalen Prozesse.
5. Pro Kanal tatsächlicher Verbindlichkeitsnachweis, Datenlage und Portalbestimmungen.
--- v0.5/E00_Entscheidungsprotokoll.md
+++ v0.6/E00_Entscheidungsprotokoll.md
@@ -3,7 +3,7 @@
typ: entscheidungsprotokoll
titel: Entscheidungsprotokoll
status: arbeitsstand
-version: '0.5'
+version: '0.6'
---
# E00 – Entscheidungsprotokoll
@@ -22,9 +22,10 @@
| **E-008** | Beschlossen / Betreiberpräzisierung | V02 umfasst **Multichannel-Marketing und Gästegewinnung** (eigene Website, Social Media, Print, externe Portale) **sowie CRM, Stammkundenmanagement und Loyalty**. Damit ist V02 nicht nur Folgeprozess, sondern auch vorgelagert. Feedback/Bewertungen bleiben in V01. Detaillierung von V02 folgt später. |
| **E-009** | Beschlossen / Betreiberpräzisierung | Buchungsbezogene Objektaufgaben (Reinigung, Schlüsselübergabe, lokale Leistungen) im Hauptprozess **einfach und integriert** behandeln. Die fachliche Existenz von Supportprozessen bedeutet **keine Pflicht zu eigenen Verwaltungsmodulen**. Erweiterte Objektverwaltung, Dienstleister-/Personalplanung und Vermittlungsagentur-Funktionen derzeit nicht priorisieren; Erweiterbarkeit offenhalten. |
| **E-010** | Grundsatz bestätigt / Details offen | Der Hauptwertschöpfungsprozess V01 endet fachlich mit Abschluss der Buchungs- und Leistungserbringung. Danach weiterlaufende Forderungs-, Schaden- oder Streitfälle sind **an zuständige Folgeprozesse zu übergeben**, anstatt den gesamten Buchungsprozess künstlich offen zu halten. Zusammenhang zur Buchung, Zuständigkeit und Übergabe müssen nachvollziehbar bleiben. Das genaue Abschluss-Gate ist noch zu spezifizieren. |
+| **E-011** | Beschlossen / Detailkriterien offen | V01 kann mit **unterschiedlichen fachlichen Endergebnissen** enden: regulär abgeschlossen (erbrachte Leistung), ohne Buchung beendet (z. B. abgelehnte/abgelaufene Anfrage bzw. nicht angenommenes Angebot) oder storniert (nach entstandener Verbindlichkeit, soweit zutreffend). Diese Ergebnisse sind **alternative Ausgänge eines einzigen generischen Prozesses**, keine zusätzlichen Buchungsworkflows. Nachweise, Historie und erforderliche Folgeaktivitäten/Übergaben bleiben erhalten. Die vollständige Taxonomie und konkrete Zustandsübergänge sind noch zu spezifizieren. |
## Offene Grundsatzentscheidungen
-- Konkrete Mindestkriterien für P05-Abschluss, Übergabenachweis und Zuständigkeit der Folgeprozesse; Umgang mit abgebrochenen oder stornierten Vorgängen.
+- Konkrete Mindestkriterien für P05-Abschluss, Übergabenachweis und Zuständigkeit der Folgeprozesse; **Detailkriterien** und die vollständige Taxonomie der alternativen Prozessausgänge (E-011).
- Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; Umfang späterer buchungsunabhängiger Funktionen.
- Exakter Mindest-Nachweis und Datenumfang je externem Portalprofil.
--- v0.5/G00_Gates_und_Uebergaben.md
+++ v0.6/G00_Gates_und_Uebergaben.md
@@ -3,7 +3,7 @@
typ: gate-modell
titel: Gate- und Übergabemodell
status: arbeitsstand
-version: '0.5'
+version: '0.6'
---
# G00 – Gate- und Übergabemodell (Arbeitsstand)
@@ -36,5 +36,8 @@
- **Übergabe:** Benötigt mindestens Referenz zur ursprünglichen Buchung, Beschreibung des offenen Sachverhalts, verantwortliche Stelle und nachweisbaren Übergabestatus. Detailumfang und Automatismus bleiben offen.
- **Status:** Buchungsprozess abgeschlossen und Folgeprozess offen sind gleichzeitig möglich. Die technische Ausgestaltung der Akte ist noch nicht beschlossen.
+## Alternative End-Gates V01 (E-011)
+Je nach tatsächlichem Verlauf weist V01 ein eigenes fachliches Endergebnis aus: **regulär abgeschlossen**, **ohne Buchung beendet** oder **storniert** (nach Verbindlichkeit). End-Gates sichern die jeweils zutreffenden Nachweise und gegebenenfalls erforderliche Folgeübergaben; nicht erforderliche Zwischenphasen werden nicht künstlich ausgeführt. Vollständiger Ergebnis- und Nachweiskatalog bleibt offen.
+
## Noch offen
-Detailkriterien für das P05-Abschlussgate und die Behandlung von Storno-/Abbruch-Ausgängen; konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
+Detailkriterien für das P05-Abschlussgate und die Detailbedingungen der Storno-/Abbruch-Ausgänge; konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
--- v0.5/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
+++ v0.6/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Buchungseingang und Verfügbarkeitssicherung
status: entwurf
-version: '0.5'
+version: '0.6'
---
# P01 – Buchungseingang und Verfügbarkeitssicherung
--- v0.5/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
+++ v0.6/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Konditionen und Buchungsverbindlichkeit
status: entwurf
-version: '0.5'
+version: '0.6'
---
# P02 – Konditionen und Buchungsverbindlichkeit
--- v0.5/P03/P03_Buchungsverwaltung_und_Abwicklung.md
+++ v0.6/P03/P03_Buchungsverwaltung_und_Abwicklung.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Buchungsverwaltung und kaufmännische Abwicklung
status: entwurf
-version: '0.5'
+version: '0.6'
---
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
--- v0.5/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
+++ v0.6/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Leistungsvorbereitung und Aufenthalt
status: entwurf
-version: '0.5'
+version: '0.6'
---
# P04 – Leistungsvorbereitung und Aufenthalt
--- v0.5/P05/P05_Abschluss_und_Nachbereitung.md
+++ v0.6/P05/P05_Abschluss_und_Nachbereitung.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Abschluss und Nachbereitung
status: entwurf
-version: '0.5'
+version: '0.6'
---
# P05 – Abschluss und Nachbereitung
@@ -23,5 +23,8 @@
## Gates
Fachlicher, finanzieller und objektbezogener Abschluss können unterschiedliche Zustände haben. **Grundsatz (E-010):** V01 kann nach erfolgter Buchungs- und Leistungserbringung fachlich abgeschlossen werden, auch wenn übergebene Ansprüche oder Konflikte noch zu bearbeiten sind. Übergaben müssen zugeordnet, nachvollziehbar und mit der Buchung verknüpft bleiben. **Welche Pflichtaktivitäten den V01-Abschluss konkret freigeben, ist noch offen.**
+## Abgrenzung zu alternativen Prozessausgängen (E-011)
+P05 beschreibt den regulären Abschluss nach Buchungs- und Leistungserbringung. **Ohne Buchung beendete** Vorgänge (z. B. Angebotsablauf) und **stornierte** verbindliche Buchungen können V01 über andere End-Gates beenden, ohne die regulären P05-Aktivitäten künstlich zu durchlaufen. Offene Folgepflichten und Belege bleiben mit dem ursprünglichen Vorgang verknüpft. Die konkreten Gate- und Nachweiskriterien sind noch offen.
+
## Noch offen
Genaue Abschlusskriterien und erforderliche Nachweise; Zuständigkeit und Verknüpfung nachlaufender Folgeprozesse; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt; alternativer Ausgang bei Stornierung oder abgebrochenem Vorgang. **Ob die technische Buchungsakte geschlossen wird oder nur der V01-Prozessstatus wechselt, ist nicht entschieden.**
--- v0.5/README.md
+++ v0.6/README.md
@@ -3,15 +3,15 @@
typ: projektindex
titel: FewoPortal Prozessarchitektur
status: arbeitsstand
-version: '0.5'
+version: '0.6'
---
-# FewoPortal – Prozessarchitektur v0.5
+# FewoPortal – Prozessarchitektur v0.6
**Status:** Fachlicher Arbeitsstand / Interview, keine Implementierungsfreigabe
**Stand:** 31.10.2026
-Diese Version konsolidiert die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die danach bestätigten Entscheidungen E-007 bis E-010 und die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
+Diese Version führt den konsolidierten Stand v0.5 mit **E-011 (alternative fachliche Prozessausgänge)** fort und bewahrt die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die Entscheidungen E-001 bis E-010 sowie die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
## Dateien
--- v0.5/S00_Supportprozesse.md
+++ v0.6/S00_Supportprozesse.md
@@ -3,7 +3,7 @@
typ: prozesskatalog
titel: Supportprozesse
status: arbeitsstand
-version: '0.5'
+version: '0.6'
---
# S00 – Supportprozesse (vorläufiger Katalog)
--- v0.5/X00_Sonderprozesse.md
+++ v0.6/X00_Sonderprozesse.md
@@ -3,7 +3,7 @@
typ: prozesskatalog
titel: Sonder- und Ausnahmeprozesse
status: arbeitsstand
-version: '0.5'
+version: '0.6'
---
# X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog)
@@ -22,6 +22,8 @@
| X08 | Aufenthaltsabweichung | No-show, Verlängerung, vorzeitige Abreise |
| X09 | Schäden/Reklamation | Mangel, Schaden, Kaution/Nachforderung |
+**Alternative Prozessausgänge (E-011):** X03 kann zu **ohne Buchung beendet** führen; X04 kann eine bereits verbindliche Buchung zu **storniert** führen. Dies sind Endergebnisse von V01, keine eigenständigen parallelen Buchungsworkflows. Vorreservierung, Kalender, Dokumentation und offene Pflichten müssen je Fall nachweisbar behandelt werden. Einzelregeln noch offen.
+
**Prozessübergabe nach V01 (E-010):** Nach Abschluss der Buchungs- und Leistungserbringung noch offene Fälle (z. B. Schadenersatzforderung, Erstattung, Streitfall) werden an einen zuständigen Folgeprozess übergeben. Sie bleiben mit der ursprünglichen Buchung verbunden. Ob dafür ein separater Vorgang oder eine verknüpfte Aktivität angelegt wird, ist noch nicht entschieden.
**Rechtsfragen separat:** Für externe Vollabwicklung liegt die Vertrags-/Mahn-/Storno-Verantwortung beim Portal gemäß vertraglicher Vereinbarung; FewoPortal braucht einen nachvollziehbaren Übergabestatus und mindestens die für eigene Pflichten nötigen Informationen.
@@ -1,783 +0,0 @@
--- basis/X00_Sonderprozesse.md
+++ v0.7/X00_Sonderprozesse.md
@@ -3,7 +3,7 @@
typ: prozesskatalog
titel: Sonder- und Ausnahmeprozesse
status: arbeitsstand
-version: '0.6'
+version: '0.7'
---
# X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog)
@@ -27,3 +27,10 @@
**Prozessübergabe nach V01 (E-010):** Nach Abschluss der Buchungs- und Leistungserbringung noch offene Fälle (z. B. Schadenersatzforderung, Erstattung, Streitfall) werden an einen zuständigen Folgeprozess übergeben. Sie bleiben mit der ursprünglichen Buchung verbunden. Ob dafür ein separater Vorgang oder eine verknüpfte Aktivität angelegt wird, ist noch nicht entschieden.
**Rechtsfragen separat:** Für externe Vollabwicklung liegt die Vertrags-/Mahn-/Storno-Verantwortung beim Portal gemäß vertraglicher Vereinbarung; FewoPortal braucht einen nachvollziehbaren Übergabestatus und mindestens die für eigene Pflichten nötigen Informationen.
+
+
+## Präzisierung v0.7: Änderungs-/Stornovorgang und Konfliktnachweise
+
+- **X02/X04:** Zwischen *Anfrage*, *Annahme/Bestätigung*, *wirksamer Vertragsänderung/Stornierung* und *tatsächlichen Finanz-/Belegungsfolgen* unterscheiden. Ursache, Initiator, Ausführender und Verantwortlicher sind keine austauschbaren Felder. Tatsächlicher Vermieterstornogrund bleibt Vermieterstornogrund, selbst wenn ein Gast auf der Portaloberfläche die Aktion ausführt; Portalregeln und rechtliche Wirkungen gesondert prüfen. Der Betreiber hat beim FeWo-direkt-Konto bislang keine solche Änderung oder Vermieterstornierung selbst durchgeführt; unbekannte Prozesse nicht als erprobte Ist-Abläufe ausgeben.
+- **X05/X06:** Fehlende Preisdetails, zusammengefasste Service-/Provisionsanteile oder abweichende Auszahlungssummen sind normale Klärungsfälle; manuelle Zuordnung und erneuter Abgleich, ohne Buchungspreis zu überschreiben.
+- **X07:** Bei Destination Solutions manuelle Kalendersperre ohne serverseitig/partnernetzweit bestätigten Sperrnachweis; bei FeWo-direkt verzögerter iCal-Import. Technische Ursache und mögliche Rechts-/Haftungsfolgen getrennt bewerten. [Ausführlicher Fachfall X07](X01_Belegungskonflikte_und_Sperrnachweise.md).
--- basis/AENDERUNGSUEBERSICHT.md
+++ v0.7/AENDERUNGSUEBERSICHT.md
@@ -6,3 +6,14 @@
- Offene Detailkriterien und Zustandsübergänge ausdrücklich **nicht** als entschieden dargestellt.
- Keine Löschung bestehender Inhalte, keine Änderung des Anwendungscodes. Gitea selbst wurde nicht verändert.
- `AENDERUNGEN_ZU_V0.6.diff` dokumentiert die tatsächlichen Textänderungen.
+
+
+# Änderung v0.7 gegenüber v0.6 (Konsolidierung 31.10.2026)
+
+- E-012–E-021 aus dem fachlichen Interview nachgeführt; fünf Archetypen, kein A6.
+- Destination Solutions (A3) als realer Referenzfall samt Stornostaffel, manueller Sperre ohne Übernahmenachweis, provisionsabhängigen Partnerkanälen und ungeklärtem Gast-Aufschlag dokumentiert.
+- FeWo-direkt (A4) um differenzierte Zahlungsdaten, iCal-Risiko, noch offene Rechts-/Gast- und Gebühreninformationen ergänzt.
+- Flexible Preispositionen und Sammelbeträge, manuelle/hybride Klärung und kontrollierbare Nachweiskette in P01–P05, K00/K01, G00, X00 aufgenommen.
+- Neues Portalfragenregister und verbindliche Dokumentationsarbeitsregel: aktuelle Originaldokumente künftig **vor jedem Edit erneut anfordern**.
+- R01-Referenzentwurf inhaltlich unverändert übernommen, R08 neu ergänzt.
+- Ausgangsdokumente unverändert gelassen; Diff und Prüfliste im Paket. Keine Gitea-Änderung/Implementierungsfreigabe.
--- basis/00_Portalprofile_und_Vertragsvorlagen.md
+++ v0.7/00_Portalprofile_und_Vertragsvorlagen.md
@@ -3,10 +3,10 @@
typ: fachliches-konzept
titel: Portalprofile, Konditionsquellen und Vertragsvorlagen
status: diskussionsentwurf
-version: "0.1"
+version: "0.2"
stand: 2026-10-31
prozess: V01
-bezugsstand_archetypen: "0.3"
+bezugsstand_archetypen: "0.6"
---
# K00 – Portalprofile und Vertragsvorlagen
@@ -39,7 +39,7 @@
| A1 / A2, eigener Angebotsabschluss | Eigenes **bindendes Angebot** mit ausgewählten Vertragsbedingungen/Anlagen. Wirksam angenommene Version wird unverändert nachgewiesen; anschließend Vertragsdokument bzw. Bestätigung aus diesem Stand. |
| A3 / A4, extern bereits verbindlich, Vertragstext/Unterlagen durch uns | **Kanal- und buchungstypspezifische Vertragsdokumentation** der bereits vereinbarten Bedingungen; **keine zweite obligatorische Annahme**. Widersprechende/neue Klauseln nicht still ergänzen. |
| A5, Vertrag/Abwicklung extern | Externen Vertrags- und Konditionsnachweis referenzieren/ablegen, eigene Dokumente nur, wenn erforderlich. Keine doppelte Vertragsbegründung. |
-| A6, Hub/Partnervermittlung | Aus Herkunft und tatsächlicher Zuständigkeit das passende A2–A5-Profil und damit Dokumentenprofil bestimmen. |
+| Optional: Partnerherkunft | **Kein eigener Archetyp A6.** Nur bei kaufmännischer Relevanz (z. B. unterschiedliche Vermittlerprovision) Herkunft erfassen; Buchung bleibt A1–A5. |
Eine **gemeinsame Konditions-/Vertragszusammenstellung** soll vor dem Versand anzeigen: maßgeblicher Preis, enthaltene/optionale Leistungen, Rabatte, Stornoregel, Gastdaten, gewählte **Vorlage mit Version**, passende **Anlagen**, nachweisbarer Konditionsstand und Dokumentenvorschau. Der Vermieter kann die Auswahl im Rahmen der rechtlich/fachlich zulässigen Regeln korrigieren; keine separaten Portalfomulare.
@@ -76,3 +76,29 @@
4. **Noch offen:** Welche konkreten Dokumententypen und Anlagen sollen über Vermieter/Objekt/Portal hinweg wiederverwendbar sein, und welche müssen zwingend getrennt bleiben?
**Status:** Portalübergreifende Fachregeln aus dem Interview festgehalten; Auswahlregeln sind ein fachlicher Vorschlag zur späteren Validierung, **keine freigegebene technische Implementierung**.
+
+
+## 8. Erweiterung v0.2 – Flexible Portal- und Preisfunktionen
+
+**Konfiguration nach tatsächlicher Fähigkeit statt Portalname fest in Programmcode:**
+
+| Merkmal | Konfigurierbare Ausprägungen / Konsequenz |
+|---|---|
+| Eingang/Belegung | iCal/API/E-Mail/Portalansicht/manuell; zeitverzögert, nicht verfügbar oder unbekannt; manuelle Sperraufgabe zulässig |
+| Gast-/Vertragsdaten | vollständig, teilweise, nicht geliefert; ggf. manuell über Gast oder Portal abrufen |
+| Vertrag und Preisquelle | eigene verbindliche Angebotsdaten oder extern bestätigter Gastpreis; Gesamtbetrag auch ohne Einzelpreise zulässig |
+| Preisdetailtiefe | Einzelpositionen, Sammelpositionen, reiner Gesamtpreis; Gebührentyp oder Empfänger kann ungeklärt bleiben |
+| Preisaufschlag/Provision | Vermieterprovision, zusätzliche Gast-Servicegebühr, partnerkanalabhängiger Endpreisaufschlag – getrennt, sofern belegbar; auch kombinierte/unbekannte Position zulassen |
+| Zahlungszuständigkeit | Eigener Einzug oder Portal/Paymentanbieter; Ratenstatus, Auszahlungsvorschau und Bankeingang getrennt |
+| Stornobedingungen | Portalkonfiguration, beim Vertragsschluss nachweislich vereinbarter Stand, später übermitteltes eigenes Dokument trennen |
+| Bearbeitungsmodus | automatisch / manuell / gemischt, nach einzelner Aktivität bzw. verfügbarem Feld; offene Klärungsaufgabe statt erfundene Daten |
+| Nachweise | Zeitpunkt der Erfassung, ggf. Screenshot/Buchungsbestätigung, Zeitpunkt und Wirksamkeit einer Kalendersperre soweit nachgewiesen |
+
+**Keine freie Regel-Engine für MVP erforderlich.** Wenige Profilparameter sowie manuelle, nachvollziehbare Bearbeitungsschritte reichen zunächst. Die tatsächliche Informationstiefe kann **von Buchung zu Buchung** variieren, nicht nur pro Portal.
+
+### Konkrete Kanalprofile als gesonderte Referenzfälle
+
+- **FeWo-direkt (A4):** Eigene Miet-/Rabatt-/Stornokonfiguration im Portal; im Vermieterposteingang sind bei einer Buchung einzelne Summen, Zahlungsraten und erwartete Auszahlung ersichtlich, nicht notwendigerweise die Einzelpreiszerlegung. Eigener statischer Mietvertrag bislang nicht im Inserat hinterlegt. Angeblich/öffentlich angebotene Funktionen sind nicht automatisch im konkreten Betreiberkonto vorhanden.
+- **Destination Solutions (A3):** Extern bereits verbindliche Buchung; danach vollständige Abwicklung beim Vermieter. **In aktuellem Betreiberzugang keine Kalendersynchronisation**; manuelle Portalsperrung mit begrenzter Nachweisbarkeit. Provision kann nach Vertriebskanal differieren; Gast-Serviceaufschlag, Preisaufschläge und vorvertragliche Anzeige der Stornobedingungen sind noch ungeklärt.
+
+Details: [K01 Preise & Abrechnung](K01_Preisstruktur_und_Abrechnung.md); [R08 Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md); [O00 offene Fragen](O00_Offene_Portalprueffaelle.md).
--- basis/S00_Supportprozesse.md
+++ v0.7/S00_Supportprozesse.md
@@ -3,7 +3,7 @@
typ: prozesskatalog
titel: Supportprozesse
status: arbeitsstand
-version: '0.6'
+version: '0.7'
---
# S00 – Supportprozesse (vorläufiger Katalog)
@@ -25,3 +25,11 @@
**Einordnung für den heutigen Produktumfang:** S01–S07 und S09 soweit für Buchungsabwicklung nötig; S08 schlank in P04/P05. V02-Marketing und Loyalty sind **Wertschöpfung** und nicht bloß allgemeine administrative Supportprozesse. Marketingfunktionen werden fachlich vorgesehen, aber nach dem Kernbuchungsprozess detailliert.
Einzelheiten folgen nach Freigabe der Gesamtprozesslandkarte. Keine zusätzlichen Organisations-/Oberflächenmodule aus dieser Tabelle ableiten.
+
+
+## Präzisierung v0.7 (E-012 bis E-020)
+
+- **S01:** Portalprofil umfasst tatsächliche Datenschnittstelle (oder manuelle Schritte), Ausführungsverantwortung, Quellennachweis, Preis-/Storno-Verfügbarkeit und den Status nachgelagerter Vertriebskanäle, soweit relevant. Partnerherkunft ist **kein A6-Prozess**; nur kaufmännisches Merkmal bei Bedarf.
+- **S02:** Kalenderverzögerung, manuelle Sperrung und fehlender Bestätigungsbeleg als reale Normalfälle. „Exportiert“ oder „im Portal eingetragen“ ist nicht gleich „partnernetzweit wirksam“.
+- **S04/S07:** Kaufmännische **Einzel-, Sammel- und Gesamtbeträge** unterstützen; Gast-Servicegebühr, Vermieterprovision, Preisaufschlag, Rabatte, Zahlung und Auszahlung getrennt, soweit feststellbar. Unbekannte Zusammenhänge bleiben ungeklärt; manueller Abgleich möglich.
+- **S05/S06:** unterschiedliche Vertragsvorlagen/Anlagen und Versionen je Buchungsprofil; manuelle Daten-/Dokumentenbeschaffung und Klärungsaufgaben ohne separate Portalsoftware-Workflows.
--- basis/G00_Gates_und_Uebergaben.md
+++ v0.7/G00_Gates_und_Uebergaben.md
@@ -3,7 +3,7 @@
typ: gate-modell
titel: Gate- und Übergabemodell
status: arbeitsstand
-version: '0.6'
+version: '0.7'
---
# G00 – Gate- und Übergabemodell (Arbeitsstand)
@@ -41,3 +41,14 @@
## Noch offen
Detailkriterien für das P05-Abschlussgate und die Detailbedingungen der Storno-/Abbruch-Ausgänge; konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
+
+
+## Ergänzende Gates / Informationsbewertung v0.7 (E-013 bis E-020)
+
+- **G1/P01 – Externe Belegung:** Zeitpunkt und Quelle von Kalenderexport, manueller Sperre oder Meldung dokumentieren. **Veranlasst**, **im Zielportal beobachtet** und **in nachgelagerten Kanälen nachgewiesen** sind verschiedene Zustände; letzterer kann unbekannt bleiben.
+- **G2/P02 – Konditionsstand:** Extern verbindlicher **Gastgesamt-/Mietpreis** kann hinreichend belegt sein, auch wenn Tages-/Einzelpreise fehlen. Portalkonfiguration, Buchungssnapshot, gastseitig tatsächlich vereinbarter Konditionsstand und nachträglich versandte Unterlagen getrennt. Fehlt ein für Vertragsdokumentation erforderlicher Beleg, nur die konkrete Tätigkeit zur Klärung vorsehen; bereits bindende Buchung nicht rückwirkend entwerten.
+- **G3/P03 – Kaufmännische Teilinformationen:** Einzelposition, Sammelposten und Gesamtbetrag zulässig; Quelle, Betrag, Währung, zugeordneter Zahler/Empfänger (oder **ungeklärt**), Status und mögliche Doppelzählung prüfen. Gast-Mietforderung ≠ Gast-Portalservicegebühr ≠ Vermieterprovision ≠ Auszahlung. Aufklärung je Tätigkeit; fehlende Provisionsdetails blockieren beispielsweise nicht automatisch die Anreisevorbereitung.
+- **G3/P03 – Zahlung:** **Fällig laut Zahlungsplan**, **laut Portal bezahlt**, **Auszahlung angekündigt** und **tatsächlicher Bankeingang** sind unabhängige Status. Widersprüchliche Portalwerte bleiben offen, nicht automatisch überschrieben.
+- **X02/X04/X07:** Storno-/Änderungsantrag ist **kein** wirksames Ergebnis. Bei Belegungskonflikt Ursache, zeitliche Abfolge, Bindung beider Buchungen, belegte extern wirksame Sperren und verbleibende Handlungsmöglichkeiten erfassen; Verantwortlichkeit wird nicht aus einem einzigen Button abgeleitet.
+
+**Evidenzstatus je Datenpunkt:** `übermittelt / durch externe Quelle behauptet / anhand Beleg geprüft / intern erfasst / manuell ergänzt / nicht geliefert / widersprüchlich / nicht anwendbar`; als **fachliche Beispiele**, nicht als freigegebene technische Enum. `unbekannt` ist **nicht** `0` oder `nicht vorhanden`.
--- basis/E00_Entscheidungsprotokoll.md
+++ v0.7/E00_Entscheidungsprotokoll.md
@@ -3,7 +3,7 @@
typ: entscheidungsprotokoll
titel: Entscheidungsprotokoll
status: arbeitsstand
-version: '0.6'
+version: '0.7'
---
# E00 – Entscheidungsprotokoll
@@ -40,3 +40,25 @@
## Dokumentationsregel (Arbeitsvereinbarung)
Die bestehende Gitea-Dokumentation ist die führende Ablage. Es gibt **eine aktuelle Markdown-Datei je Thema**, P01–P05 dürfen jeweils mehrere Unterdokumente enthalten. Bei **neuen und fachlich aktualisierten Markdown-Dateien** einen knappen YAML-Header (`id`, `typ`, `titel`, `status`, `version`) verwenden. Bestehende Abschnitte bei Fortschreibungen nicht still kürzen oder löschen; fachliche Entscheidungen mit ID verknüpfen und Änderungen per Git-Diff kontrollieren. **Keine implizite Freigabe von Implementierung oder Go-live.**
+
+
+## Ergänzende Beschlüsse und Prüfstände vom 31.10.2026 – Konsolidierung v0.7
+
+Die folgenden IDs ergänzen **E-001–E-011**. Betreiberangaben und die daraus fachlich bestätigten Regeln sind von ausstehenden Portal- und Rechtsprüfungen zu unterscheiden.
+
+| ID | Status | Festlegung |
+|---|---|---|
+| **E-012** | **Beschlossen** | **Genau fünf Buchungsarchetypen A1–A5**. Der zuvor verwendete A6-Eintrag („Hub/Partnervermittlung“) entfällt als Archetyp. Partnerherkunft ist nur als optionales kaufmännisches Merkmal zu erfassen, soweit sie etwa Provisionssatz oder Auswertungen beeinflusst; keine eigenständige Vermittlungskettenlogik. |
+| **E-013** | **Beschlossen** | **Vertrags-/Dokumentenprofil je Vermieter/Objekt/Portal/Buchungsart**, inklusive unterschiedlicher Vorlagen und Anlagen, Versionierung und unverändertem Buchungs-/Konditionsstand. Nach externer Direktbuchung **keine zweite Annahme und keine einseitigen neuen Gastpflichten**. Die tatsächliche vorvertragliche Einbeziehung bleibt Prüffall. |
+| **E-014** | **Beschlossen** | Die Informationsbeschaffung kann je Portal und Feld **automatisch, manuell oder gemischt** erfolgen. Fehlen Einzelbeträge, dürfen Buchungen mit **Gesamtpreis oder Sammelpositionen** bearbeitet werden; fehlende Daten sind ausdrücklich unbekannt, nicht null und nicht geschätzt. |
+| **E-015** | **Beschlossen** | **Gast-Mietforderung, ggf. gesonderte Gast-Servicegebühr, Vermieterprovision/-gebühr, Zahlungsraten, Auszahlung und Rabatte** sind fachlich getrennte Sachverhalte, auch wenn ein Portal Beträge zusammenfasst. Flexible kaufmännische Positionen, spätere manuelle Zuordnung/Aufteilung, Nachweis und Differenzabgleich sind erforderlich; ursprüngliche Portalwerte bleiben erhalten. **Keine doppelte Zählung** zusammengefasster Teil- und Gesamtbeträge. |
+| **E-016** | **Beschlossen / Referenzbetrieb** | **Destination Solutions = A3**, keine Ergänzung „A6“: bereits extern verbindliche Buchung, nachfolgende Vertrags-/Zahlungs-/Aufenthaltsabwicklung durch Vermieter. Partnerherkunft kann unterschiedliche **Vermittlerprovisionen zu Lasten des Vermieters** bewirken, aber **keine nachträgliche Belastung des Gastes**. Ob das Portal selbst eine zusätzliche Gastgebühr erhebt oder den Endpreis erhöht, bleibt ungeklärt. |
+| **E-017** | **Bestätigte Betreiberangabe, Wirksamkeit ungeklärt** | Bei Destination Solutions ist folgende **sechsstufige Stornostaffel** genannt: mindestens 60 Tage vorher 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, 11 Tage oder weniger 100 % jeweils vom „Mietpreis“. **Nicht nachgewiesen** ist, ob diese Staffel im Portal bereits vor Buchung transparent gemacht und wirksam einbezogen wird; die Preisbasis („Mietpreis“) ist zu klären. |
+| **E-018** | **Beschlossen / Risiko festgehalten** | **Externe Verfügbarkeit ist nicht allein durch korrekte Pflege des FewoPortal-Kalenders sicher**: FeWo-direkt importiert iCal nur zeitverzögert; beim verwendeten Destination-Solutions-Zugang erfolgt **manuelle Sperrung ohne bestätigtes Partnernetz-Sync und ohne verwertbaren Sperrbeleg**. Vorgang „Sperre veranlasst / Zielportal erkennbar / partnernetzweit wirksam“ getrennt; letzteren Zustand niemals ohne Nachweis behaupten. |
+| **E-019** | **Beschlossen** | Buchungsänderung, Storno und Doppelbuchung sind **Teil-/Sonderprozesse derselben Akte**. Auslösende Ursache, Initiator, ausführender Akteur, Zuständigkeit, verbindliche Wirksamkeit sowie Kalender-/Vertrags-/Finanzfolgen getrennt führen. Technische Stornierung durch den Gast ersetzt nicht die wahrheitsgemäße Einordnung einer Vermieterursache; Fremdportalregelungen und Rechtslage fallbezogen prüfen. |
+| **E-020** | **Beobachteter A4-Iststand** | In einer FeWo-direkt-Buchung sind **aggregierter Übernachtungspreis, Rabatt, Sammelgebühren, Gastgesamtbetrag, portalbezogener Abzug, Auszahlungsvorschau und Ratenstatus** einsehbar. **Nicht belegt** sind Einzelpreise, Gebührenzusammensetzung, durchgängige Exporte und alle tatsächlich vom Gast akzeptierten Unterlagen. Widersprüchliche Auszahlungsangaben bleiben offener Prüffall. |
+| **E-021** | **Verbindliche Dokumentationsarbeitsregel** | **Vor jeder künftigen Dokumentänderung/Erweiterung die aktuell gültigen Originaldateien erneut explizit beim Betreiber anfordern**. Gitea bleibt führende Ablage; ältere lokale Chat-/ZIP-Kopien allein reichen für spätere Änderungen nicht. Änderungen ausschließlich auf bestätigter Basis, mit Versionsfortschreibung, Bestandsbewahrung, Diff und Quellvermerk. |
+
+**Nicht beschlossen:** Dass technische Portalprobleme automatisch rechtlich fehlendes Verschulden beweisen; dass eine 10-Minuten-Freigabe heute bei den genannten Portalen möglich ist; dass alle Portale gleiche Preis-/Gast-/Zahlungsdaten bereitstellen; dass nachträglich versandte Stornobedingungen wirksam werden. Solche Aussagen bleiben Prüffälle.
+
+**Weitere Fachkonzepte:** [Archetypen A1–A5](00_Buchungsarchetypen.md), [Portal-/Vertragsprofile](00_Portalprofile_und_Vertragsvorlagen.md), [Flexible kaufmännische Positionen](K01_Preisstruktur_und_Abrechnung.md), [Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md), [offene Portalprüffälle](O00_Offene_Portalprueffaelle.md).
--- basis/00_Buchungsarchetypen.md
+++ v0.7/00_Buchungsarchetypen.md
@@ -3,15 +3,15 @@
typ: archetypenkatalog
titel: FewoPortal – Buchungsarchetypen und Verantwortungsübergaben
status: diskussionsentwurf
-version: "0.5"
+version: "0.6"
stand: 2026-10-31
prozess: V01
-bezugsstand_prozessarchitektur: "0.6"
+bezugsstand_prozessarchitektur: "0.7"
---
# A00 – Buchungsarchetypen und Verantwortungsübergaben
-> **Arbeitsstand für das Fachinterview, nicht abschließend freigegeben.** Grundlage: Betreiberbeschreibung vom 31.10.2026; Übergaben `UEBERGABE-BUCHUNGSPROZESS.md` (30.10.2026) und `crystalline-floating-glacier.md` (31.10.2026); Prozessarchitektur v0.6 und Szenario R01. **Bestätigte Geschäftsregeln, aktueller Praxisablauf, Annahmen und offene Fragen werden getrennt ausgewiesen.**
+> **Arbeitsstand für das Fachinterview, nicht abschließend freigegeben.** Grundlage: Betreiberbeschreibung vom 31.10.2026; Übergaben `UEBERGABE-BUCHUNGSPROZESS.md` (30.10.2026) und `crystalline-floating-glacier.md` (31.10.2026); Prozessarchitektur v0.7 und Szenarien R01/R08. **Bestätigte Geschäftsregeln, aktueller Praxisablauf, Annahmen und offene Fragen werden getrennt ausgewiesen.**
## 1. Gemeinsamer Grundsatz
@@ -25,7 +25,7 @@
**Archetypen sind Geschäftskonstellationen, keine getrennt zu implementierenden Workflows.** Sie bestimmen die bei Eintritt bekannten Tatsachen, Zuständigkeiten, notwendigen Aktivitäten, Kommunikationswege und Nachweise. Dieselbe Buchungsakte und dieselben Fachfunktionen werden verwendet. Ein Portal kann einzelne Tätigkeiten durchführen; FewoPortal behält den konsolidierten Vorgangsüberblick, ohne fremde Primärnachweise vorzutäuschen.
-## 2. Katalog der sechs Archetypen
+## 2. Katalog der fünf Archetypen
| ID | Geschäftskonstellation | Zustand beim Eingang | Vertragsunterlagen | Zahlung / Storno | Informationsbedarf |
|---|---|---|---|---|---|
@@ -34,9 +34,8 @@
| **A3** | Externe Direktbuchung mit anschließender vollständiger Abwicklung durch uns | Bereits verbindliche Portalbuchung | Wir versenden Dokumentation der bestehenden Vereinbarung, **keine zweite Annahme** | Wir | Buchung, Portalpreis und Gastdaten übernehmen / ergänzen |
| **A4** | Externe Direktbuchung mit **geteilter Abwicklung** (heutiger FeWo-direkt-Fall) | Bereits verbindliche Portalbuchung | Vertragsdokumentation durch uns ohne zweite Annahme | Zahlung über Portal; tatsächliche Storno-/Mahnverantwortung noch prüfen | Gastdaten, rechtsrelevante Konditionen, Portalstatus, lokale Abgaben |
| **A5** | Externe Direktbuchung mit weitgehend vollständiger Portalabwicklung | Bereits verbindliche Portalbuchung | Durch Portal, soweit tatsächlich vereinbart | Durch Portal, soweit tatsächlich vereinbart | Für Vor-Ort-Betreuung und rechtliche Pflichten benötigte Daten und Status |
-| **A6** | Portal / Buchungshub vermittelt über weitere Partnerportale | Abhängig vom zugrunde liegenden A2–A5 | Abhängig von Herkunft und Abwicklungsmodell | Abhängig von Herkunft und Abwicklungsmodell | **Eingangskanal**, **tatsächliche Herkunft** und **Abwicklungsverantwortung** getrennt erfassen |
-**Modellierungshinweis:** A6 ist ein **zusätzliches Herkunfts- und Vermittlungsmerkmal**, kein eigener alternativer Lebenszyklus. „Manuell/telefonisch“ ist ein **Eingangskanal** und kann insbesondere bei A1/A2 verwendet werden. Eine reine Eigenbelegung/Sperrzeit ist ein angrenzender Belegungsfall, **kein siebter Buchungsarchetyp**.
+**Modellierungshinweis (E-012):** Die ehemalige Kennung **A6 wurde ausdrücklich gestrichen**; Partnervertrieb ist allenfalls ein optionales kaufmännisches Herkunftsmerkmal. „Manuell/telefonisch“ ist ein **Eingangskanal** und kann insbesondere bei A1/A2 verwendet werden. Eine reine Eigenbelegung/Sperrzeit ist ein angrenzender Belegungsfall, **kein weiterer Buchungsarchetyp**.
## 3. Gegenüberstellung entlang des generischen Prozesses
@@ -48,7 +47,7 @@
| **P04 Leistung** | Anreise, lokale Pflichten, Aufenthalt, Abreise | Wie A1 | Wie A1 | Wie A1, zuvor Gastinformationen nachfordern | Wie A1, soweit wir vor Ort verantwortlich sind |
| **P05 Abschluss** | Aufenthalt, Feedback, offene Fälle übergeben | Wie A1 | Wie A1 | Wie A1, ggf. offener Portal-Auszahlungs-/Stornofall | Lokale Erfüllung abschließen, relevante Portal-Ergebnisse erfassen |
-**A6** wird auf die zutreffende Spalte gelegt; die Herkunft kann Konditionen, Pflichten und Kommunikationswege beeinflussen. Phasen können sich zeitlich überlappen; eine bereits extern verbindliche Buchung darf nicht durch offene Stammdaten künstlich unverbindlich werden.
+Die Partnerherkunft begründet **keinen sechsten Archetyp**; sie wird nur bei relevantem Einfluss auf die Vermittlerprovision oder notwendige Auswertung erfasst. Phasen können sich zeitlich überlappen; eine bereits extern verbindliche Buchung darf nicht durch offene Stammdaten künstlich unverbindlich werden.
## 4. Gemeinsame Informations- und Übergabegates
@@ -121,7 +120,7 @@
Die vom Betreiber bereitgestellte vierseitige FeWo-direkt-Vertragsvorlage wurde unter [A04 – Vertragsvorlage und Prozessanalyse](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md) gesondert bewertet. Besonders prüfbedürftig sind: Verbindlichkeit vor dem nachträglichen Vertragsversand (§ 5), zuvor einbezogene Konditionen, Preis-/Gebührentrennung (§ 4), Portalstorno gegenüber eigener Stornoklausel (§ 13), Datenbedarf sowie sichere Trennung von Vertragsdokument und Zugangs-/Anreiseinformationen. **Keine Änderung der Betreibervertragsklauseln ohne gesonderte rechtliche und fachliche Freigabe.**
-**Status dieses Dokuments:** Sechs Betreiber-Archetypen strukturiert, aber nicht als vollständige oder rechtlich validierte Portalprofile freigegeben. Nächster Fachschritt: **A4 als vollständigen Ist-/Soll-Ablauf durchspielen**, einschließlich Vertrag, Zahlung, Gastdaten und Storno; anschließend A3 und A5 dagegenlegen.
+**Status dieses Dokuments:** Fünf Archetypen (A1–A5) nach E-012; Portalprofile und rechtliche Detailfragen bleiben offen. Neben FeWo-direkt (A4) ist Destination Solutions (A3) dokumentierter Praxisfall.
## 10. A4-Praxisnachweis aus FeWo-direkt-Ansichten (31.10.2026)
@@ -130,6 +129,20 @@
**Portalinvariante:** Verantwortlichkeit für Zahlung oder Kommunikation, Portalstatus und tatsächlicher Erfüllungsnachweis sind getrennt zu verwalten.
-## 9. Änderungs- und Stornoereignisse (portalunabhängig)
+## 11. Änderungs- und Stornoereignisse (portalunabhängig)
Ein Storno bzw. eine Buchungsänderung ist ein **Teilprozess auf derselben Buchungsakte**, kein zusätzlicher Archetyp. Die fachliche Ursache (Gastwunsch, Unmöglichkeit beim Vermieter, Doppelbuchung, Regelverstoß, technischer Fehler), der Initiator, der ausführende Beteiligte und die Abwicklungsverantwortung sind voneinander zu unterscheiden. Anfrage, Bestätigung und tatsächliche Wirksamkeit sind getrennte Ereigniszustände. Kalender, Konditionen, Vertrag und Zahlungen werden erst nach ausreichend belegter Wirksamkeit angepasst. Eine durch den Vermieter verursachte Stornierung darf nicht durch Aufforderung an den Gast als Gaststorno umetikettiert werden. **FeWo-direkt** ist dafür ein dokumentiertes Portalbeispiel (siehe [A04 Abschnitt 8](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md)); andere Portale können abweichende Wege, Daten und Zuständigkeiten haben.
+
+
+## 12. Destination Solutions als Praxisreferenz A3 (E-012/E-016/E-017/E-018)
+
+- **Verbindlicher Buchungseingang**, vollständige weitere Vertrags-, Gäste-, Zahlungs- und Aufenthaltsabwicklung beim Vermieter; keine zweite Angebotsannahme. Der Vermieter erhält laut Betreiber eine vollständige Buchungsmeldung für seine Abwicklung, **nicht zwingend eine vollständige Einzelpreis- oder Gebührenzerlegung**.
+- **Keine im genutzten Zugang funktionierende automatische Kalendersynchronisation**; manuelles Blockieren anderer Portale. Ein Portalbeleg über den Zeitpunkt oder die wirksame Verteilung an Partnerkanäle steht nach Betreibererfahrung nicht zur Verfügung.
+- **Vermittlerprovisionen** können nach Vertriebskanal variieren. Sie sind nicht nachträglich vom Gast zu fordern. Ob zusätzlich ein direkter Gast-Aufschlag/Serviceentgelt oder Partner-Endpreisaufschlag existiert, muss beim Anbieter und anhand einer Gastbestätigung geprüft werden.
+- **Stornostaffel** vom Betreiber angegeben: ≥60 Tage 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, ≤11 Tage 100 % vom „Mietpreis“; **vorvertragliche Einbeziehung, Berechnungsbasis und rechtliche Wirksamkeit offen**.
+
+Siehe [R08 Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md) und [O00 Offene Portalprüffälle](O00_Offene_Portalprueffaelle.md).
+
+## 13. Portaldaten können unterschiedlich detailliert und zusammengesetzt sein (E-014/E-015)
+
+Bei A2–A5 sind **automatische, manuelle und hybride** Informationen und Tätigkeiten gleichwertig zu modellieren. Pro Buchung sind vollständig aufgeschlüsselte Positionen, **kombinierte Service-/Gebührenpositionen**, bloße Gesamtbeträge sowie nur teilweise verfügbare Zahlungsauszüge möglich. Keine fiktive Zerlegung des Gesamtpreises; unbekannte Gebührenarten, Zahlende/Empfänger und Provisionsanteile bleiben offen. Nachträgliche Zuordnung oder Aufteilung erhält den originalen Portalbetrag und verhindert doppelte Summierung. Fehlende rein interne Kostenanalyse blockiert nicht ohne Weiteres den vertraglichen Aufenthalt. Siehe [K01](K01_Preisstruktur_und_Abrechnung.md).
--- basis/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md
+++ v0.7/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md
@@ -3,7 +3,7 @@
typ: prozessanalyse
titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess
status: diskussionsentwurf
-version: "0.4"
+version: "0.5"
stand: 2026-10-31
prozess: V01
archetyp: A4
@@ -157,3 +157,14 @@
- https://hilfe.fewo-direkt.de/articles/Accept-or-decline-a-guest-s-change-request
- https://hilfe.fewo-direkt.de/articles/Die-Reservierung-eines-Gastes-stornieren
- https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy
+
+
+## 9. Einordnung nach Gesamt-Konsolidierung v0.7
+
+1. **A4 bleibt realer Praxisfall**, nicht Muster für alle Portale. FeWo-direkt zeigt in einer Buchung im Posteingang Zahlungsplan, einige aggregierte Preisbestandteile, Gäste-Gesamtzahlung, Abzug und erwartete Auszahlung; eine lückenlose Einzelpreis-/Gebührentransparenz und eine konsistente Auszahlungsübersicht sind weiter **nicht nachgewiesen**. Das frühere pauschale Urteil „keinerlei Zahlungsdaten“ ist überholt; konkrete Screenshots in Abschnitt 7 sind maßgeblich.
+2. **Ical-Verzögerung:** Direkte Buchung kann vor Verarbeitung einer anderswo veranlassten Blockierung verbindlich werden. FewoPortal darf eigene erfolgreiche Exporte nicht als Portal- oder Partnernetzbestätigung behandeln. Die Idee eines 10-Minuten-Freigabefensters ist **kein aktuell verfügbarer A4-Prozess**.
+3. **Vertragsdokumente:** Der eigene vierseitige Vertrag wird bisher nach der Portalbuchung versandt und ist nicht als statisches PDF in FeWo-direkt hinterlegt; Inhalt der dem Gast vor/bei Buchung gezeigten Bedingungen bleibt zu verifizieren. Statische allgemeine Bedingungen von individuellen Preis-/Zahlungsdetails trennen; keine still nachgeschobenen Verpflichtungen.
+4. **Sonderprozesse:** Bisher keine konkret selbst durchlaufene FeWo-direkt-Buchungsänderung und keine eigene Vermieterstornierung. Kein nicht erprobtes Verfahren als gelebte Praxis behaupten. Differenzierung **tatsächliche Stornoursache, Antragsteller, ausführender Beteiligter** beachten.
+5. **Abrechnung:** Unbekannte Gast-Servicegebühren, Portalabzüge, Vermieterprovisionen oder kombinierte Sammelpositionen müssen nicht künstlich zerlegt werden. Portalinformationen und manuelle Ergänzungen mit Quelle sichern; bei abweichenden Summen Klärungsaufgabe.
+
+Fachliche Konkretisierung: [K01](K01_Preisstruktur_und_Abrechnung.md), [X01](X01_Belegungskonflikte_und_Sperrnachweise.md) und [O00](O00_Offene_Portalprueffaelle.md). Keine Aktualisierung oder juristische Freigabe des ursprünglichen PDF-Vertrags durch diese Analyse.
--- basis/README.md
+++ v0.7/README.md
@@ -3,15 +3,15 @@
typ: projektindex
titel: FewoPortal Prozessarchitektur
status: arbeitsstand
-version: '0.6'
+version: '0.7'
---
-# FewoPortal – Prozessarchitektur v0.6
+# FewoPortal – Prozessarchitektur v0.7
**Status:** Fachlicher Arbeitsstand / Interview, keine Implementierungsfreigabe
**Stand:** 31.10.2026
-Diese Version führt den konsolidierten Stand v0.5 mit **E-011 (alternative fachliche Prozessausgänge)** fort und bewahrt die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die Entscheidungen E-001 bis E-010 sowie die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
+Diese Konsolidierung führt die Version v0.6 mit **E-011 (alternative fachliche Prozessausgänge)** fort und bewahrt die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die Entscheidungen E-001 bis E-010 sowie die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
## Dateien
@@ -24,3 +24,25 @@
**Quellen:** `crystalline-floating-glacier.md`, `UEBERGABE-BUCHUNGSPROZESS.md`, Gesamtprozess v0.3 und die Betreiberpräzisierung vom 31.10.2026. Weitere Fach- und Rechtsprüfung erforderlich.
**Arbeitsregel:** Nur ausdrücklich beschlossene Punkte als Entscheidung kennzeichnen; Vorschläge als solche markieren. Jede Datei trägt einen YAML-Header mit `id`, `typ`, `titel`, `status`, `version`. Die Version v0.5 bezeichnet den konsolidierten **Dokumentationsstand**, nicht eine Implementierungsversion. Bestehende Inhalte werden nicht stillschweigend gekürzt. Änderungen an Gitea erfolgen erst nach Abgleich mit dem dortigen Stand. Keine automatischen Änderungen am produktiven System.
+
+
+## Konsolidierung v0.7 (31.10.2026)
+
+**Wichtige Entscheidung E-012:** Fünf Buchungsarchetypen **A1–A5**, **A6 gestrichen**. Referenzportale: Destination Solutions = **A3**, FeWo-direkt = **A4**. Ein generischer V01-Buchungsprozess mit variabler Aktivitäts- und Informationslage; keine separaten Portalworkflows.
+
+**Neue Anforderungen:** Portal-/Dokumentenprofile, versionierter Vertrags-/Konditionsnachweis, manuelle/automatische/gemischte Datenbeschaffung, flexible Einzel- und Sammelpreise, unbekannte Gastgebühr/Provision ohne Scheingenauigkeit, Abstimmung Zahlungsplan vs. tatsächliche Auszahlung, unsichere Kalender-/Sperrnachweise und Änderungs-/Stornoteilprozesse. Externe Direktbuchungen werden nicht durch neues Eigenangebot ersetzt. Rechtlich ungeklärte Portal- und Stornokonditionen bleiben offene Prüffälle.
+
+**Neue bzw. fortgeschriebene Dateien:**
+
+- [`00_Buchungsarchetypen.md`](00_Buchungsarchetypen.md) – A1–A5 und reale Referenzfälle
+- [`00_Portalprofile_und_Vertragsvorlagen.md`](00_Portalprofile_und_Vertragsvorlagen.md) – Profile und Vertragstypen
+- [`K01_Preisstruktur_und_Abrechnung.md`](K01_Preisstruktur_und_Abrechnung.md) – Einzel-/Sammel-/Gesamtbeträge, Provisionen, Zahlungsfluss
+- [`A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md`](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md) – konkrete A4-Beobachtungen und rechtliche Prüffragen
+- [`R00_Szenarien/R01_Eigene_Webseite.md`](R00_Szenarien/R01_Eigene_Webseite.md) – früherer Referenzentwurf, **inhaltlich unverändert**
+- [`R00_Szenarien/R08_Destination_Solutions.md`](R00_Szenarien/R08_Destination_Solutions.md) – A3 Referenzfall
+- [`X01_Belegungskonflikte_und_Sperrnachweise.md`](X01_Belegungskonflikte_und_Sperrnachweise.md) – X07-Vertiefung
+- [`O00_Offene_Portalprueffaelle.md`](O00_Offene_Portalprueffaelle.md) – spätere Konfigurations- und Nachweispunkte
+- [`D00_Dokumentationsregel_und_Uebergabe.md`](D00_Dokumentationsregel_und_Uebergabe.md) – **Pflicht zur erneuten Dokumentenanforderung vor jedem zukünftigen Edit**
+- [`E00_Entscheidungsprotokoll.md`](E00_Entscheidungsprotokoll.md) – Beschlüsse E-012–E-021
+
+**Quellenintegrität:** v0.6 aus dem originalen ZIP extrahiert, da die entpackte v0.6-Verzeichnisansicht P01–P05 nicht enthielt; ergänzende Dokumente aus ihrem jeweils neuesten im Chat verfügbaren Bearbeitungsstand. **Kein direkter Schreibzugriff auf Gitea; keine Repository-Aktualisierung behauptet.** Vor jeder künftigen Änderung aktuelle Quelldokumente erneut vom Betreiber anfordern.
--- basis/00_Prozesslandkarte.md
+++ v0.7/00_Prozesslandkarte.md
@@ -3,10 +3,10 @@
typ: prozesslandkarte
titel: FewoPortal – Prozesslandkarte
status: arbeitsstand
-version: '0.6'
+version: '0.7'
---
-# 00 – Prozesslandkarte FewoPortal v0.6
+# 00 – Prozesslandkarte FewoPortal v0.7
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
**Stand:** 31.10.2026
@@ -111,3 +111,18 @@
5. Pro Kanal tatsächlicher Verbindlichkeitsnachweis, Datenlage und Portalbestimmungen.
Die detaillierte Umsetzung erfolgt erst nach Abstimmung der Prozesslandkarte.
+
+
+## H. Konkretisierung v0.7: Portalneutralität, Informationslücken und Verantwortlichkeit
+
+**A1–A5 (E-012):** Nur die tatsächliche Buchungs- und Abwicklungsverantwortung klassifiziert den Archetyp. Der bisherige A6-Eintrag entfällt; Herkunft/Partnervertrieb ist bei Bedarf eine separate **kaufmännische Metainformation**, keine eigene Prozessvariante. Referenzfälle: **FeWo-direkt A4**, **Destination Solutions A3**. Der identische V01-Prozess durchläuft dieselben fachlichen Phasen/Gates, Aktivitäten können je Profil extern/intern oder manuell/automatisch erfolgen.
+
+**Fünf unabhängige Dimensionen je Buchung:** (1) rechtlicher Bindungs-/Konditionsnachweis, (2) operative Zuständigkeit, (3) technische Datenquelle/Übermittlungsweg und Verfügbarkeit, (4) preisliche Detailtiefe bzw. Zuordnungsgrad, (5) tatsächliche Nachweisqualität. Aus „Portal zuständig“ folgt weder „erledigt“ noch „nachgewiesen“.
+
+**Kaufmännischer Grundsatz (E-014/E-015):** Das Portal kann Einzelposten, Teilaggregationen, Gesamtpreise, unbekannte Gebührenmischungen oder widersprüchliche Auszahlungsansichten liefern. FewoPortal darf den verbindlichen Gastpreis bei externer Buchung nicht durch Eigenkalkulation ersetzen, keine unbekannten Einzelposten erfinden und keine Vermittlerprovision ohne Vereinbarung dem Gast nachberechnen. Eine manuelle Klärung kann ergänzen; ursprüngliche Rohdaten bleiben erhalten.
+
+**Verfügbarkeit (E-018):** Keine generelle Aussage, dass alle Vertriebskanäle synchron oder endgültig gesperrt sind. Manuell oder zeitversetzt übertragenes Blockieren ist kein Nachweis partnernetzweiter Wirksamkeit. Sofort bestätigte externe Doppelbuchungen bleiben wirksame **Konfliktfälle**, nicht automatisch ablehnbare Anfragen. Eine vorgeschlagene Livefreigabe/10-Minuten-Karenz ist derzeit nur **optionales Zukunfts-/Integrationskonzept**, kein Ist-Ablauf.
+
+**Nachträgliche Ereignisse (E-019):** Änderungsanfrage, bestätigte Änderung, Stornierungswunsch und wirksame Stornierung unterscheiden. Ursache, Durchführender, vertragliche Folgen, Belegung und Geldflüsse getrennt dokumentieren.
+
+**Zu vertiefen:** [K01 Preis- und Abrechnungsmodell](K01_Preisstruktur_und_Abrechnung.md), [X01 Belegungskonflikt- und Sperrnachweise](X01_Belegungskonflikte_und_Sperrnachweise.md), [O00 offene Portalfragen](O00_Offene_Portalprueffaelle.md).
--- basis/P05/P05_Abschluss_und_Nachbereitung.md
+++ v0.7/P05/P05_Abschluss_und_Nachbereitung.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Abschluss und Nachbereitung
status: entwurf
-version: '0.6'
+version: '0.7'
---
# P05 – Abschluss und Nachbereitung
@@ -28,3 +28,8 @@
## Noch offen
Genaue Abschlusskriterien und erforderliche Nachweise; Zuständigkeit und Verknüpfung nachlaufender Folgeprozesse; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt; alternativer Ausgang bei Stornierung oder abgebrochenem Vorgang. **Ob die technische Buchungsakte geschlossen wird oder nur der V01-Prozessstatus wechselt, ist nicht entschieden.**
+
+
+## Ergänzung v0.7: Abrechnung und Nachweislücken
+
+Eine Buchung darf nach erbrachter Leistung fachlich regulär enden, selbst wenn **Provisionsaufschlüsselung, ausstehende Auszahlung oder ungeklärte Sammelgebühren** in einem gesondert zugewiesenen Folgefall weiterbearbeitet werden. Gastbezogene offene Forderungen, Storno- oder Auszahlungsdifferenzen müssen mit Quelle, Verantwortlichem und Buchungsreferenz nachvollziehbar übergeben werden. Fehlende detaillierte Preisaufteilung ist nicht automatisch eine unvollständige Gastleistung.
--- basis/P03/P03_Buchungsverwaltung_und_Abwicklung.md
+++ v0.7/P03/P03_Buchungsverwaltung_und_Abwicklung.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Buchungsverwaltung und kaufmännische Abwicklung
status: entwurf
-version: '0.6'
+version: '0.7'
---
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
@@ -26,3 +26,16 @@
## Noch offen
Mindestdaten je Portalprofil, eigene versus externe Zahlungsstände, Reconciliation, Übergänge zum Abschluss.
+
+
+## Flexible Preis- und Zahlungsbearbeitung v0.7
+
+1. Übernommene Positionen **unverändert mit Quelle** speichern: Einzelpositionen, Misch-/Sammelbeträge oder nur verbindlichen Gesamtbetrag. Fehlende Details nicht als 0 interpretieren.
+2. **Preis-/Kostenbeziehungen** unterscheiden: Gast ↔ Vermieter (Mietforderung und enthaltene Leistungen); Gast ↔ Portal (mögliche eigene Servicegebühr); Vermieter ↔ Portal (Provision/Servicekosten); Zahlungen, Rückerstattungen und spätere Auszahlungen jeweils separat.
+3. **Manuelle Ergänzung und Aufteilung** ermöglichen (auch ohne Portal-API): originalen Sammelbetrag erhalten, abgeleitete Teilpositionen zuordnen, Summen abstimmen, doppelte Zählung verhindern. Nicht bekannte Debitoren/Kreditoren, Rabattbezüge und Gebührenarten als **ungeklärt** führen.
+4. **Zahlungsstände** trennen: Gast-Fälligkeit, portalbestätigte Gastzahlung, Auszahlungsvorschau, tatsächlicher Geldeingang, Abweichung/Erstattung. Widersprüche als Klärung auf derselben Buchungsakte, nicht heimlich mit Eigenkalkulation ausgleichen.
+5. **Pflicht nur je Tätigkeit:** Fehlt für eine von uns zu stellende Rechnung die rechtlich nötige Aufschlüsselung, Klärungsaktivität einplanen. Fehlende reine Vermieter-Kostenanalytik darf Anreise oder andere unabhängige Schritte nicht grundsätzlich sperren.
+6. **Destination Solutions A3:** Vermieter führt Vertrag, Zahlungsanforderung, Zahlungskontrolle und ggf. Stornobearbeitung; Höhe der Vermittlerprovision je Herkunft unterschiedlich möglich. Keine zusätzliche Provisionsrechnung an den Gast ohne vorbestehende Vereinbarung.
+7. **FeWo-direkt A4:** Sichtbarer Gastzahlungsplan und erwartete Auszahlung ersetzen weder den Beleg über Bankeingang noch vollständige Gebührenaufschlüsselung; siehe konkrete A4-Screenshots und offenen 5,51-€-Differenzfall.
+
+[Vertiefung: K01](../K01_Preisstruktur_und_Abrechnung.md).
--- basis/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
+++ v0.7/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Buchungseingang und Verfügbarkeitssicherung
status: entwurf
-version: '0.6'
+version: '0.7'
---
# P01 – Buchungseingang und Verfügbarkeitssicherung
@@ -29,3 +29,13 @@
## Noch offen
Mindestfelder nach Eingangstyp, Übergaberegeln für unklare iCal-Ereignisse, Konfliktverhalten, genaue Hold- und Kalenderregeln.
+
+
+## Praxisfälle und Aktivitätsvarianten v0.7
+
+- **FeWo-direkt (A4):** Sofortbuchung kann während verzögertem iCal-Abgleich entstehen. Portal-Verfügbarkeitsstatus darf nicht als Echtzeitgarantie dargestellt werden; eigenes Sync-Ereignis, Zeitpunkt des Abrufs und bekannte Konflikte festhalten.
+- **Destination Solutions (A3):** Im konkret genutzten Zugang **keine aktive Kalender-Synchronisation** laut Betreiber; externe neue Buchung kommt bereits verbindlich an. Andere Vertriebskanäle müssen im Portal **manuell blockiert** werden; nachgelagerter Partnervertrieb kann weitere Verzögerungen verursachen. Eigene protokollierte Aufgabe mit Zeitpunkt, Bearbeiter, Portalanzeige/Screenshot (wenn möglich) – keine Behauptung, der Portalserver habe eine rechtzeitige Übernahme quittiert.
+- **Portalunabhängig:** Art des Belegungs-Inputs (iCal, API, E-Mail, manuell), Ausführungspfad (automatisch/manuell/hybrid), Verzögerung/Unsicherheit und Kontrollmöglichkeiten im Portalprofil hinterlegen. Neue, extern **bereits verbindliche** Kollisionsbuchung als Konflikt behandeln; keine stillschweigende Ablehnung oder Löschung.
+- **Drei Sperrzustände:** `Sperrung veranlasst`, `im Zielportal sichtbar`, `nachweislich im relevanten Vertrieb wirksam`. Fehlender Nachweis bleibt **unbekannt**. Für eigene Holds eigene atomare Freihaltung und Sicherung des bindenden Angebots prüfen, ohne fremde Echtzeitwirkung zu versprechen.
+
+Siehe [X01 – Konfliktmanagement und Nachweise](../X01_Belegungskonflikte_und_Sperrnachweise.md).
--- basis/R00_Szenarien/00_Szenariomatrix.md
+++ v0.7/R00_Szenarien/00_Szenariomatrix.md
@@ -4,7 +4,7 @@
titel: Buchungsszenarien und Vergleichsfälle
autor: FewoPortal Fachinterview
status: diskussionsentwurf
-version: '0.1'
+version: '0.2'
---
# R00 – Buchungsszenarien und Vergleichsfälle
@@ -18,7 +18,12 @@
| R03 | Unverbindliche Portalanfrage | Portal-Anfrage → eigenes Angebot → Annahme | Fehlende Gastdaten, Portal-Kommunikation | Vorgemerkt |
| R04 | Verbindliche Portalbuchung, Vertrag durch uns | Bereits extern verbindlich | Externer bindender Preis, nachträgliche Vertragsdokumentation ohne erneute Annahme, Zahlung je Portal | Vorgemerkt |
| R05 | Portal wickelt verbindliche Buchung vollständig ab | Bereits extern verbindlich | Lokale Leistung und notwendige Informationen, Portal für Vertrag/Zahlung/Mahnung/Storno zuständig | Vorgemerkt |
-| R06 | Hub/Partnerportal | Je Herkunft Anfragen oder Direktbuchungen | Herkunftserkennung bestimmt Profil | Vorgemerkt |
+| R06 | (Historisch) Hub-/Partnervermittlung | Kein eigener Buchungsprozess; A1–A5 richten sich nach Bindung/Abwicklungszuständigkeit | Herkunft allenfalls für Provision/Auswertung relevant | Als separates Szenario nicht weiterführen (E-012) |
| R07 | Eigenbelegung/Sperre | Keine Gastbuchung | Belegungsmanagement ohne Gästeakte | Angrenzender Fall, kein vollständiger V01-Buchungsweg |
**Quellen:** Ausgangsdokumente vom 30./31.10.2026 und Entscheidungsstand der Prozessarchitektur v0.6. Die Bearbeitungsstände beziehen sich auf das Fachinterview, nicht auf die Implementierung.
+
+
+## Ergänzung v0.2: Externe Direktbuchung
+
+**R08 – Destination Solutions (A3):** Bereits verbindliche Buchung, danach Vertrags-/Zahlungs-/Gastabwicklung durch Vermieter; manuelle Sperre externer Kalender, kein belegter Partner-Sync; unterschiedliche Vermittlerprovisionen je Kanal, zusätzliche Gastgebühren und einzelne Preispositionen derzeit unklar. **A6 entfällt** als Archetyp. [R08 Referenzfall](R08_Destination_Solutions.md).
--- basis/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
+++ v0.7/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Leistungsvorbereitung und Aufenthalt
status: entwurf
-version: '0.6'
+version: '0.7'
---
# P04 – Leistungsvorbereitung und Aufenthalt
@@ -25,3 +25,8 @@
## Noch offen
Ob die Organisation des Objektbetriebs vollständig als Supportprozess geführt wird; örtliche Anforderungen; Übergabe- und Eskalationsstandards.
+
+
+## Ergänzung v0.7: externe Kommunikationszuständigkeit
+
+Bei Portal-Direktbuchungen unterscheiden: Portal kündigt Gastnachricht an, Portalversand ist tatsächlich bestätigt oder Vermieter versendet eigene Informationen. FeWo-direkt kündigt in der gezeigten Buchung eine E-Mail etwa 72 Stunden vor Anreise an; dies ist **noch kein Nachweis**, dass sie dem Gast zugegangen ist. Falls erforderliche Gäste-/Meldedaten fehlen, manuell nachfordern. Bei Destination Solutions führt Vermieter die Gast- und Dienstleisterkommunikation im Rahmen der eigenen Abwicklung.
--- basis/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
+++ v0.7/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Konditionen und Buchungsverbindlichkeit
status: entwurf
-version: '0.6'
+version: '0.7'
---
# P02 – Konditionen und Buchungsverbindlichkeit
@@ -49,3 +49,13 @@
- [§ 148 BGB – Bestimmung einer Annahmefrist](https://www.gesetze-im-internet.de/bgb/__148.html)
- [§ 150 BGB – verspätete und abändernde Annahme](https://www.gesetze-im-internet.de/bgb/__150.html)
- [§ 312j BGB – Besonderheiten im elektronischen Geschäftsverkehr](https://www.gesetze-im-internet.de/bgb/__312j.html)
+
+
+## Konditions- und Vertragsprofile v0.7
+
+- **Kanalabhängige Vorlagen:** Für A1/A2 bindendes Angebot einschließlich wirksam zur Kenntnis gegebener Bedingungen; für A3/A4 Dokumentation bereits extern abgeschlossener Buchung; für A5 nur die zur eigenen Tätigkeit nötigen Unterlagen. Vorlagen/Anlagen je Vermieter, Objekt, Portal und Buchungstyp unterscheiden, Version + verwendeten Konditionsstand aufbewahren.
+- **Extern verbindliche Preisgrundlage:** Der bestätigte Gastpreis kann lediglich **als Gesamtbetrag** vorliegen. Dies ist kein Grund, Tagespreise oder einzelne Gebühren zu erfinden. Vom Portal selbst erhobene Gast-Servicegebühren und Vermieterprovisionen können davon abweichen und separat oder nur aggregiert bekannt sein.
+- **Vorvertragliche Einbeziehung:** Ob dem Gast vor Abschluss Stornostaffeln, Pflichtgebühren und sonstige Bedingungen angezeigt wurden, ist je Portal zu prüfen; ein nachträgliches Dokument erzeugt nicht automatisch neue Vertragspflichten.
+- **Destination Solutions:** Genannte Stornostaffel (vom Betreiber berichtet): mindestens 60 Tage vorher 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, 11 Tage oder weniger 100 % des „Mietpreises“. **Ungeklärt:** Nachweis im Buchungsprozess, Durchsetzbarkeit, genaue Kostenbasis. Nicht als globalen A3-Standard verwenden.
+
+Siehe [K00](../00_Portalprofile_und_Vertragsvorlagen.md), [K01](../K01_Preisstruktur_und_Abrechnung.md) und [R08 Destination Solutions](../R00_Szenarien/R08_Destination_Solutions.md).
--- /dev/null
+++ v0.7/D00_Dokumentationsregel_und_Uebergabe.md
@@ -0,0 +1,34 @@
+---
+id: D00
+typ: arbeitsregel
+titel: Dokumentationsregeln, Quellenbasis und Übergabe
+status: diskussionsentwurf
+version: "0.1"
+stand: 2026-10-31
+---
+
+# D00 – Dokumentationspflege und Kontextübergabe
+
+**Verbindliche Arbeitsvereinbarung des Betreibers vom 31.10.2026:**
+
+> **Vor jeder zukünftigen Änderung oder Erweiterung der Fachdokumentation muss ChatGPT den Betreiber ausdrücklich bitten, die aktuell gültigen Originaldokumente erneut bereitzustellen.** Nicht aus Erinnerung oder einem alten Chat-ZIP heraus eine bestehende Datei überschreiben. Maßgebliche Ablage bleibt **Gitea**. Dieser Stand v0.7 ist eine **lokale konsolidierte Bearbeitungsfassung**, kein nachgewiesener Gitea-Stand.
+
+## Vorgehen bei der nächsten Dokumentationsänderung
+
+1. **Vor dem Editieren** aktuelle Gitea-Originaldateien bzw. aktuellen Export/Snapshot **explizit beim Betreiber anfordern** (auch wenn eine ältere Version in /mnt/data oder der Chat-Historie vorhanden ist).
+2. Vergleich mit diesem Stand / bisherigen Entscheidungen, YAML-Metadaten, Dokumenten-IDs und Verlinkungen; Unterschiede und mögliche Konflikte aufzeigen.
+3. Nur auf dem bestätigten Stand weiterarbeiten; bestehende Inhalte nicht still kürzen, vereinbarte Regeln nicht als unbelegte Produktfunktionen ausgeben.
+4. Versionsnummern je geändertem Dokument erhöhen, Entscheidungshistorie und Prüffälle aktualisieren; Änderungen via **Diff/Manifest** nachvollziehbar machen.
+5. Dateipaket zur **kontrollierten Übernahme nach Gitea** bereitstellen; keine Behauptung, Dateien seien bereits im Repository gespeichert. Unklare Rechts-/Portalfragen offen kennzeichnen.
+
+## Quellen und Sicherungsstand der jetzigen Konsolidierung
+
+- Ausgangsbasis Hauptdokumentation: `FewoPortal_Dokumentation_v0.6.zip` **einschließlich P01–P05, die im separaten entpackten Ordner fehlten**.
+- Zusätzliche Ausgangsbasis: `FewoPortal_Portalprofile_Update/{00_Buchungsarchetypen.md v0.5, 00_Portalprofile_und_Vertragsvorlagen.md v0.1, A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md v0.4}`.
+- Weiteres Referenzmaterial: `FewoPortal_R01_Arbeitsentwurf/R00_Szenarien/{00_Szenariomatrix.md, R01_Eigene_Webseite.md}`.
+- Nachzutragende Betreiberangaben: Gespräch vom 31.10.2026 zu FeWo-direkt-Screenshots, Destination Solutions, fünf Archetypen, Storno, unsicheren Kalendern und flexibler Preis-/Gebührenbearbeitung.
+- **Nicht verifiziert:** Ob in Gitea neuere Fassungen dieser Dateien existieren. Vor künftigen Änderungen deshalb erneute Anforderung.
+
+## Kompakter Kontext für den nächsten Chat
+
+FewoPortal ist eine **kleine, mandantenfähige Vermieterwebsite-/Buchungsanwendung für typischerweise 1–3 Ferienwohnungen je Vermieter, kein Marktplatz**. Ein gemeinsamer Hauptprozess V01 P01–P05, dazu V02 Vermarktung/Gästegewinnung/Gästebindung. Fünf Archetypen: A1 eigene Webseite, A2 externe unverbindliche Anfrage, A3 externe verbindliche Buchung mit weiterer eigener Gesamtabwicklung (**Destination Solutions**), A4 externe verbindliche Buchung mit geteilter Abwicklung (**FeWo-direkt**), A5 überwiegend externe Vollabwicklung. **A6 gestrichen**; Partnerherkunft nur bei Provisionsrelevanz. Ein Vorgang/eine Akte. Externer Preis und beim Vertragsschluss vereinbarte Bedingungen bleiben maßgeblich, spätere Dokumente keine stillen neuen Pflichten. Unterschiedliche/versionierte Vorlagen pro Kanal/Buchungstyp. Portale liefern unterschiedlich vollständige Daten; **manuelle Bearbeitung und Sammel-/Gesamtpreise** sind konstitutive Fachfunktionen. Gast-Mietforderung, externe Gastgebühr, Vermieterprovision, Auszahlung und Zahlung getrennt. Kein Erfinden unbekannter Gebührenanteile. Verfügbarkeit extern nicht garantiert: FeWo-direkt verzögerter iCal-Import, Destination Solutions manuelles Sperren ohne verlässlichen Portal-/Partnernachweis; Doppelbuchungen möglich, deshalb Ausnahmeprozess und Belegkette. Nicht bekannte Vertrags- und Portalfragen im O00-Prüffallregister. **Vor der nächsten Dokumentbearbeitung aktuelle Gitea-Fassung explizit erfragen.**
--- /dev/null
+++ v0.7/K01_Preisstruktur_und_Abrechnung.md
@@ -0,0 +1,73 @@
+---
+id: K01
+typ: fachliches-konzept
+titel: Preis-, Gebühren- und Abrechnungsinformationen
+status: diskussionsentwurf
+version: "0.1"
+stand: 2026-10-31
+---
+
+# K01 – Flexible Preis-, Gebühren- und Abrechnungsinformationen
+
+**Fachstatus:** Betreiberentscheidungen E-014/E-015 sind bestätigt; konkrete Feldliste/Technik, Steuern und portalbezogene Berechnungsregeln bleiben zu validieren. Zielgruppe: kleine Vermieter (typischerweise 1–3 Wohnungen), keine komplexe Vollbuchhaltung.
+
+## 1. Zentrales Prinzip
+
+Portale können vollständige Einzelposten, **nur Teilaufschlüsselungen**, **kombinierte Sammelgebühren** oder ausschließlich einen **Gesamtpreis** bereitstellen. FewoPortal muss all diese Informationsstände aufnehmen und später ergänzen können. **Die Gesamtpreisangabe ist ein gültiger Ausgangswert; sie berechtigt nicht zur Erfindung unbekannter Einzelpreise.** Extern bestätigter Gastpreis bleibt Grundlage der bestehenden Buchung.
+
+## 2. Unbedingt zu unterscheidende wirtschaftliche Sachverhalte
+
+| Dimension | Beispiel | Fachliche Bedeutung / Grenze |
+|---|---|---|
+| **Gast ↔ Vermieter** | Vereinbarte Unterkunftsmiete, ggf. vertragliche Zusatzleistungen und Rabatte | Eigene Mietforderung gegenüber Gast; tatsächlich vereinbarter Gastpreis maßgeblich |
+| **Gast ↔ externes Portal** | Eventuelle Vermittlungs-/Servicegebühr des Portals | Fremde Forderung, nicht automatisch unsere Miete oder unser Umsatz |
+| **Vermieter ↔ Vermittler/Portal** | Provision, Transaktionskosten, sonstige vertragliche Dienstleistung | Eigene Kosten des Vermieters; nicht nachträglich dem Gast belasten |
+| **Gastzahlungen** | Anzahlung/Restzahlung, Erstattung, Kaution | Zahlungsplan und Zahlungsstatus unabhängig von der Mietforderung |
+| **Auszahlung an Vermieter** | Nettoauszahlung nach Portalabzügen | Ist-Zahlungsfluss; nicht mit Gastpreis oder vereinbartem Mietbetrag gleichsetzen |
+| **Ungeklärte Mischposition** | Eine „Servicepauschale“ mit unbekanntem Anteil an Reinigung, Portalgebühr oder Provision | **Nicht ohne Nachweis in Einzelpositionen umwandeln**; Zahler/Empfänger ggf. offen |
+| **Preisdifferenz/Vertriebsaufschlag** | Höherer Endpreis auf Partnerkanal möglich | Nur bei Nachweis; unterscheiden von gesonderter Gastgebühr und Vermieterprovision |
+
+**Begriffe:** „Brutto“, „Netto“, „Provision“ und „Servicegebühr“ können auf Portalen unterschiedlich verwendet werden. Keine umsatzsteuerliche Zuordnung ohne überprüfte Angaben. Für die Rechnungsstellung sind tatsächlich geschuldete Leistungen/Steuerregeln separat rechtlich/kaufmännisch zu prüfen.
+
+## 3. Fachliche Positionsstruktur – Vorschlag, noch keine technische Datenmodellfreigabe
+
+Je Position oder Aggregateintrag mindestens soweit bekannt: Bezeichnung, Betrag, Währung, positive/negative Wirkung, **Art der Position** (Einzelpreis, Teilaggregat, Gesamtbetrag, Rabatt, Zahlung, Aufwand, Auszahlung, unbekannt), **wer schuldet wem**, Preis-/Leistungsbezug, Quelle und Erfassungszeitpunkt, zugehörige Buchung und Konditionsstand, Status/Nachweis. Optional: Zeitraum, Menge, Steuerregel, ursprüngliche Portalzeile, externe Referenz, Verknüpfung zu Teilpositionen.
+
+**Qualitäts- und Nachweisstatus:** vom Portal behauptet / im Portal sichtbar / durch Beleg belegt / manuell übernommen / abgeleitet mit Rechenweg / unbekannt / widersprüchlich / nicht anwendbar. Das sind fachliche Kategorien, kein verbindlich vorgeschriebenes Enum.
+
+### Regeln zur Zerlegung und zum Summenabgleich
+
+1. **Original erhalten:** Jede Portal-Sammelposition bleibt mit Ursprung und Betrag historisch erhalten, auch nach Aufteilung.
+2. **Zerlegung mit Rechenweg:** Teilpositionen nur bei ausreichender Quelle oder ausdrücklicher dokumentierter manueller Zuordnung. Rest bleibt als „ungeklärter Anteil“.
+3. **Doppelzählung vermeiden:** Ein Gesamtaggregat und seine Unterpositionen dürfen in Summen **nicht additiv** gezählt werden. Die Aggregationshierarchie bleibt nachvollziehbar.
+4. **Keine Scheingenauigkeit:** Nur Gesamtpreis bekannt → keine Tagespreise aus Durchschnittswert als tatsächliche Portalpreise deklarieren. Interne Vergleichskalkulation ausdrücklich von Vertragsfakten trennen.
+5. **Widersprüche erhalten:** Zwei verschiedene Portal-Auszahlungswerte bleiben beide mit Herkunft stehen, bis sie belegt geklärt werden.
+6. **Keine Umdeutung der Vertragspflicht:** Aufteilung, interne Provision oder Auszahlung ändern den verbindlichen Gastpreis nicht rückwirkend.
+7. **Korrekturen historisieren:** Neue Information ergänzt oder korrigiert die interne Zuordnung nachvollziehbar; die ursprünglichen Portalwerte bleiben referenzierbar.
+
+## 4. Beschaffung und manuelle Bearbeitung
+
+- **Automatisch:** Datenimport per vorhandener Schnittstelle, Parser oder anderem verlässlichen Kanal, soweit die Daten tatsächlich verfügbar sind.
+- **Manuell:** Vermieter ruft Portalbestätigung, Posteingang oder Abrechnungsseite auf, erfasst Werte und kann Belege/Screenshot hinterlegen.
+- **Hybrid:** Automatisch importierter Gesamtpreis, manuell nacherfasste Provision oder einzelne Gebühren.
+- **Klärungsaufgabe:** Wenn tatsächlich für die **nächste Fachhandlung** erforderlich, z. B. noch fehlender Betrag zur korrekten Gastrechnung oder Zahlungseinforderung.
+- **Kein unnötiger Prozessstopp:** Rein interne Provisionszerlegung oder fehlende Tagespreise blockieren nicht automatisch bereits verbindliche Buchung, Kalender- oder Anreisevorbereitung.
+
+## 5. Getrennte Finanzzustände (kein unzulässiger Statusschluss)
+
+`Gastbetrag vereinbart` → `Rate fällig` → `Rate laut Portal bezahlt` → `Auszahlung angekündigt` → `Auszahlung auf Bankkonto belegt`. Diese Ereignisse sind **nicht zwangsläufig linear** und nicht in allen Portalen sichtbar. Eine sichtbare „bezahlt“-Markierung ist noch kein eigener Zahlungseingang beim Vermieter; Kaution, Mietzahlung, Gebühr und Erstattung gesondert betrachten.
+
+## 6. Reale Prüfbeispiele
+
+**FeWo-direkt A4 – beobachteter Screenshot, Buchung 10.–17.07.2027:** 840,00 € Übernachtungen, −42,00 € Rabatt, +181,51 € „Gebühren und Steuern“, 979,51 € Gastgesamtbetrag, −84,82 € „An FeWo-direkt gezahlt“, 894,69 € ausgewiesene Gesamtauszahlung. In anderer Ansicht 900,20 € erwartete Auszahlung (5,51 € Differenz). Sichtbarer Zahlungsplan 390,61 € bezahlt und 588,90 € später fällig. **Keine belegte Zerlegung** von 181,51 €/84,82 € oder der 5,51-€-Differenz; einzelne Tagespreise fehlen. Siehe [A04 Abschnitt 7](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md).
+
+**Destination Solutions A3 – Betreiberangaben:** Extern bestätigter Buchungspreis ist zu übernehmen und Zahlung durch Vermieter abzuwickeln. Provisionssatz kann nach vermittelndem Partner variieren. Ob Partnerportal den Endpreis erhöht oder eine separate Gast-Servicegebühr erhebt, ist derzeit nicht bestätigt; auch dort darf nur ein übermittelter Gesamtpreis zulässig sein. Keine nachträgliche Provisionsbelastung des Gastes.
+
+## 7. Noch zu entscheiden
+
+- Für welche Dokumente/Rechnungen ist eine echte Einzelpositionsauflösung zwingend? Gesetzliche Buchführungs-/Umsatzsteuerpflichten jeweils gesondert prüfen.
+- Wie sollen Rundungsdifferenzen, Fremdwährungen, Kaution, Kurabgabe, Auszahlungstermine und Teilrückerstattungen technisch dargestellt werden?
+- Welche Vereinbarungen gelten für Stornokostenbasis („Mietpreis“ vs. Gesamtbetrag; inkludierte/ausgeschlossene Leistungen), wenn nur eine Gesamtsumme vorliegt?
+- Welche individuellen Portalberichte, tatsächlichen Zahlungsnachweise und Importformate stehen zur Verfügung?
+
+**Fachliche Herkunft:** Betreiberinterview vom 31.10.2026, FeWo-direkt-Screenshots, [E00 E-014–E-020](E00_Entscheidungsprotokoll.md). Rechtliche Gestaltung separat prüfen.
--- /dev/null
+++ v0.7/O00_Offene_Portalprueffaelle.md
@@ -0,0 +1,49 @@
+---
+id: O00
+typ: prueffallregister
+titel: Portalbezogene Prüf- und Klärungsfälle
+status: diskussionsentwurf
+version: "0.1"
+stand: 2026-10-31
+---
+
+# O00 – Offene Portalprüffälle / spätere Konfiguration
+
+**Status:** Keine offenen Fragen als beantwortet ausgeben, solange konkrete Portalansichten, Verträge, Anbieterantworten oder Gastbuchungen fehlen. Unterschiedliche Vermieter-/Portalverträge können unterschiedlich sein. Die untenstehenden Prüfpunkte sind **keine Vorbedingungen für alle Prozessschritte**.
+
+## A. Destination Solutions / Kühlungsborn (A3)
+
+| ID | Prüffall | Bekannter Stand | Erforderlicher Nachweis / spätere Konfiguration |
+|---|---|---|---|
+| DS-01 | Erhält Gast Stornobedingungen **vor** verbindlicher Buchung? | Staffel laut Betreiber separat im späteren Vertrag; Betreiber vermutet ggf. Portal-Einstellungen / Hinweis | Gast-Buchungsstrecke, Gast-Bestätigung, Portal-AGB/Smart-Account-Einstellungen, ggf. Betreibervereinbarung |
+| DS-02 | Welche Basis ist „Mietpreis“ für Storno? | Unklar, ob Übernachtung allein oder zusätzliche Leistungen | Vertrag/Preisaufschlüsselung und rechtliche Prüfung |
+| DS-03 | Gibt es eigene Gast-Servicegebühr oder Partner-Aufschläge? | **Unbekannt**; nur unterschiedliche **Vermieterprovisionen** je Vermittlungskanal sind berichtet | Gastansicht/Gastbestätigung plus Provisionsrechnung des konkreten Kanals |
+| DS-04 | Vollständiger Preisnachweis | Buchung kommt mit Gesamtinformationen; Einzelposten nicht gesichert | Beispieldokumente/Muster einer echten Buchung; Fähigkeit „nur Gesamtpreis“ zulassen |
+| DS-05 | Kalender-/Sperrprotokoll | Nach Betreibererfahrung **manuelle Sperre, kein formaler Sperrnachweis** | Anbieterantwort zum Serverzeitstempel, Änderungslog und Partnerweitergabe |
+| DS-06 | Verfahren und Zuständigkeit für Storno/Umbuchung | Noch kein durchlaufener Prozess beschrieben | Portalvertrag, Beispielbuchung, konkrete Änderung/Storno aus Praxistest wenn möglich |
+
+## B. FeWo-direkt (A4)
+
+| ID | Prüffall | Bekannter Stand | Benötigter Nachweis |
+|---|---|---|---|
+| FW-01 | Welche Dokumente/Bedingungen werden vor verbindlicher Buchung gezeigt? | Eigene vierseitige Vertragsvorlage **nicht** im Portal hochgeladen; exakte Gastansicht unbekannt | Gastansicht, Buchungsbestätigung, Portal-AGB und tatsächlich bei Buchung vereinbarte Konditionen |
+| FW-02 | Sind Gast-Servicegebühr, Portalabzug, Vermieterprovision und Steuerbestandteile trennbar? | Im Screenshot Gesamt- und Teilaggregationen; 181,51 € „Gebühren und Steuern“, 84,82 € „An FeWo-direkt gezahlt“ nicht weiter zerlegt | Vollständige Detailansicht/Provisionsabrechnung, ggf. vertraglicher Abgleich |
+| FW-03 | Wieso zwei Auszahlungsbeträge? | 894,69 € und 900,20 € (Differenz 5,51 €) | Ursachenprüfung anhand derselben Buchung und Zahlungskonto |
+| FW-04 | Welche Zahlungsdaten sind wirklich exportierbar? | Posteingang pro Buchung mit Raten, jedoch allgemeiner Zahlungsverlauf/Export vom Betreiber als unzureichend beschrieben | Exporttest, Auszahlungsbeleg und tatsächlicher Bankeingang |
+| FW-05 | Änderungs- und Stornoprozess / Sanktionen | Betreiber hat bisher selbst weder Vermieterstorno noch Änderung ausgeführt | Portalregeln, Betreiberkonto, konkrete Verfahrensnachweise; tatsächliche Ursache korrekt klassifizieren |
+| FW-06 | Gastdaten und örtliche Meldepflichten | Vollständige Gastanschrift nicht immer verfügbar | Tatsächlich vom Portal lieferbare Felder und konkret erforderliche lokale Pflichtdaten prüfen |
+| FW-07 | iCal-Übernahme und Nachweis | Verzögerter Fremdkalenderabgleich, reale Doppelbuchungsgefahr | Zeit- und Änderungsnachweise soweit technisch verfügbar; keine Echtzeitgarantie |
+
+## C. Portalübergreifende Rechts-/Funktionsfragen
+
+- **Rechtswirksame Einbeziehung** von AGB, Storno- und Pflichtkosten vor Vertragsschluss bei externen Direktbuchungen; **späterer Dokumentversand ≠ neue automatische Einbeziehung**. Einzelprüfung anhand konkreter Verträge und Buchungsscreens.
+- **Stornokosten**: Wirksamkeit der Pauschalierung und mögliche Abzüge ersparter Aufwendungen / alternative Vermietung; gesetzliche Regeln und Portal-AGB beachten, kein automatisches Rechtsurteil in FewoPortal.
+- **Vollständigkeit**: Unbekannte Posten und aggregierte Beträge sind im Fachmodell ausdrücklich zulässig; der nächste notwendige Schritt kann dennoch manuelle Klärung verlangen.
+- **Verfügbarkeit**: Manuelle Sperre, Zielportal-Sichtbarkeit und partnernetzweite Wirksamkeit unterscheiden. Nicht nachgewiesene Serverbestätigung nicht fingieren.
+- **Datensparsamkeit**: Nur tatsächlich erforderliche Gast- und Mitreisendendaten für Vertrag und anwendbare örtliche Vorschriften erheben.
+
+## D. Was sich vor späterer Konfiguration beschaffen lässt
+
+Pro Portal idealerweise **ein vollständig anonymisierter realer Buchungsfall**, Gast-Buchungsbestätigung soweit vorhanden, Betreiber-Provisionsabrechnung, Preis-/Stornokonfiguration und ein Beispiel für Änderung/Stornierung. **Nicht alle Nachweise müssen jetzt vorliegen**; Fehlen führt zu manuellen Aufgaben oder offenen Informationsfeldern, nicht zum Erfinden von Regeln.
+
+**Referenzen:** [Portalprofil K00](00_Portalprofile_und_Vertragsvorlagen.md), [Preisstruktur K01](K01_Preisstruktur_und_Abrechnung.md), [FeWo-direkt A04](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md), [Destination Solutions R02](R00_Szenarien/R08_Destination_Solutions.md).
--- /dev/null
+++ v0.7/R00_Szenarien/R08_Destination_Solutions.md
@@ -0,0 +1,61 @@
+---
+id: R08
+typ: geschaeftsszenario
+titel: Verbindliche Direktbuchung – Destination Solutions
+status: diskussionsentwurf
+version: "0.1"
+stand: 2026-10-31
+---
+
+# R08 – Destination Solutions: Verbindliche Direktbuchung mit Abwicklung durch Vermieter
+
+**Zuordnung:** A3; Partnerherkunft **kein A6**. Dies ist ein reales, vom Betreiber beschriebenes Referenzszenario, keine Implementierungsfreigabe. Anbieter: [Destination Solutions](https://www.ds-destinationsolutions.com/). Die Angaben beschreiben den **konkret verwendeten Betreiberzugang**, nicht zwangsläufig alle Kunden und Softwareprodukte des Unternehmens.
+
+## 1. Dokumentierter Ist-Sachverhalt (Betreiberangaben)
+
+- Der Anbieter bzw. sein Partnernetz vermittelt und bestätigt Buchungen **verbindlich**, bevor der Vermieter sie erhält.
+- Die Buchung wird dem Vermieter mit den für die weitere Abwicklung vorgesehenen Daten übermittelt; die Abwicklung von **Vertragsunterlagen, Gastkommunikation, Zahlungsforderung/-kontrolle, Aufenthalt und Folgevorgängen** liegt danach beim Vermieter. Einzelne Preis-/Gebührenpositionen können trotzdem fehlen; vollständige kaufmännische Aufschlüsselung ist nicht bestätigt.
+- Für diesen Betreiberzugang gibt es **keinen automatischen Abgleich mit den Vermieterkalendern**. Andere Portale müssen nach Eingang einer Buchung **unverzüglich manuell gesperrt** werden. Für den Zeitpunkt der Portalübernahme/Weitergabe der Sperrung gibt es nach Betreiberangabe **keinen belastbaren Bestätigungsbeleg**.
+- Destination Solutions nutzt zusätzlich Partnervertrieb. Der Vermieter erhält je nach Vertriebspartner **unterschiedliche Provisionen**. Eine unbekannte Gastgebühr oder ein Endpreisaufschlag ist **nicht nachgewiesen** und darf nicht als Tatsache modelliert werden.
+- Beim Buchungsabschluss ist der Preis bereits vereinbart. Unsere Provision an den Vermittler darf daher **nicht nachträglich als Zusatzforderung gegenüber dem Gast** erhoben werden.
+
+## 2. Generischer Sollablauf P01–P05 mit manuellen Aufgaben
+
+| Phase | Tätigkeiten / Abweichung | Gate / Nachweis |
+|---|---|---|
+| **P01 Eingang & Belegung** | Eingehende **bereits verbindliche** Buchung übernehmen, Objekt/Zeitraum/Referenz und Gastdaten zuordnen. Eigene Kalender sofort aktualisieren, für nicht angebundene Portale **manuelle Sperraufgabe** erzeugen, mit Bearbeiter und Zeitpunkt quittieren. Bei Kollision X07. | Buchung verbindlich extern; Sperraufgabe erledigt ≠ nachweislich partnernetzweit wirksam |
+| **P02 Konditionen/Vertrag** | Ursprünglich vereinbarten Gastpreis und bekannte Konditionen übernehmen, nicht selbst nachkalkulieren. Zugehöriges Vertragsprofil/Anlagen auswählen; Gast bereits gebunden – **keine zweite Annahme**. Storno-/Pflichtbedingungen auf vorvertragliche Einbeziehung prüfen. | Quelle für Gastpreis, vertragsrelevante Bedingungen und ggf. offene Rechts-/Datenlücke |
+| **P03 Kaufmännisch** | Eigene Buchungsdokumentation versenden; Zahlungsplan/Anzahlung/Restzahlung festlegen bzw. gemäß Vereinbarung übernehmen, Zahlungen überwachen, Mahn-/Stornofälle selbst führen. Vermittlerrechnung/Provision ggf. nach Kanal zuordnen, Gastservicegebühren nur soweit nachgewiesen. | Eigener Zahlungsstand und offene Finanz-/Konditionsprüfungen erkennbar |
+| **P04 Aufenthalt** | Gastkontakt, lokale Ansprechpartner, Anreise, Schlüssel, Reinigung, Kurabgabe/Meldedaten soweit nötig, Aufenthalt/Abreise. | Erforderliche Leistungsinformationen vorhanden; manuelle Schritte möglich |
+| **P05 Abschluss** | Aufenthalt abschließen, Feedback, finanzielle Rest-/Provisionsprüfung ggf. Folgefall. | V01 regulär beendet oder offener Nachläufer verantwortlich übergeben |
+
+## 3. Betreiberangabe zu Stornobedingungen
+
+| Zeit vor Mietbeginn | Stornopauschale vom „Mietpreis“ |
+|---|---:|
+| 60 Tage oder mehr | 0 % |
+| 59–45 Tage | 35 % |
+| 44–33 Tage | 50 % |
+| 32–22 Tage | 70 % |
+| 21–12 Tage | 90 % |
+| 11 Tage oder weniger | 100 % |
+
+**Wichtige Einschränkung:** Der Betreiber ist nicht sicher, ob diese Bedingungen **bereits vor der Buchung** im Portal angezeigt und wirksam einbezogen wurden oder erst mit dem eigenen, nachträglich übersandten Vertrag vereinbart werden sollen. Ein späteres Dokument kann nicht ohne Weiteres einseitig neue Pflichten begründen. Auch ob „Mietpreis“ nur Übernachtungen oder Zusatzleistungen enthält und wie 90–100 % als Pauschalierung rechtlich einzuordnen sind, muss geprüft werden. Siehe [§ 305 BGB](https://www.gesetze-im-internet.de/bgb/__305.html), [§ 309 Nr. 5 BGB](https://www.gesetze-im-internet.de/bgb/__309.html) und [§ 537 BGB](https://www.gesetze-im-internet.de/bgb/__537.html) als Prüfquellen, **nicht als abschließendes Rechtsgutachten**.
+
+## 4. Finanzielle Unklarheiten / Konfigurationsfragen
+
+1. Wird die vereinbarte Gastmiete vom Portal oder einem Partnerportal **durch eigene Gast-Servicegebühr** ergänzt?
+2. Werden je Vermittlungskanal unterschiedliche **Gäste-Endpreise/Vertriebsaufschläge** berechnet?
+3. Wie werden Provisionskosten und die (eventuell andere) **vertragliche Mietforderung** beim Vermieter nachgewiesen?
+4. Welche Beträge/Positionen sieht der Gast vor dem Abschluss und in der Gast-Buchungsbestätigung?
+5. Wie ist die **Stornokostenbasis** bei unbekannten Einzelpreisen definiert; was passiert bei optionalen Leistungen und Neuvermietung?
+
+## 5. Risiko: Nachweislose Sperrung trotz Sofortbuchung
+
+Das System muss die **eigene Ausführung** dokumentieren (Sperraufgabe, Zeitstempel, Screenshot sofern verfügbar) und gleichzeitig ehrlich kennzeichnen, dass kein Nachweis über den Servereingang bzw. die Partnernetz-Verteilung vorliegt. Buchungsüberschneidungen können auch dann auftreten, wenn der Vermieter schnell handelt. **Technisch verursachte Verzögerung beweist für sich genommen keine rechtliche Entlastung.** Livefreigabe durch Vermieter oder Karenzfrist sind hier **nicht vorhandene Ist-Funktionen** und bleiben lediglich hypothetische Integrationsoptionen.
+
+## 6. Quellen- und Verifizierungsstatus
+
+- **Bestätigt aus dem Betreiberinterview:** verbindliche Buchungsübermittlung, komplette weitere Vermieterabwicklung, manuelle Sperre ohne Bestätigungsbeleg, unterschiedliche Vermittlerprovisionen je Partner, Stornostaffel als genannte Vertragsbedingung.
+- **Nicht verifiziert:** konkrete Ansicht/Bestätigung des Gastes, Vertragseinbeziehung der Stornoregeln, zusätzliche Gastgebühren oder Aufschläge, Preisaufschlüsselung, verwendete Destination-Solutions-Vertragsvariante, technische Verteilung/Protokollierung.
+- Weitere Nachweise erforderlich: [O00](../O00_Offene_Portalprueffaelle.md).
--- /dev/null
+++ v0.7/X01_Belegungskonflikte_und_Sperrnachweise.md
@@ -0,0 +1,41 @@
+---
+id: X07-DOK
+typ: sonderprozess
+titel: Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen
+status: diskussionsentwurf
+version: "0.1"
+stand: 2026-10-31
+---
+
+# X07 – Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen
+
+**Geltungsbereich:** Alle Buchungsarchetypen und Vertriebskanäle. Das Dokument ist eine Vertiefung von X07 aus [X00](X00_Sonderprozesse.md), kein zusätzlicher Buchungsarchetyp.
+
+## 1. Reale Ursachen und Grenzen
+
+- **FeWo-direkt:** Verzögertes iCal-Importintervall kann dazu führen, dass nach einer eigenen verbindlichen Buchung dort noch buchbare Zeiten angezeigt werden. Dass ein eigener Export korrekt aktualisiert wurde, beweist keine rechtzeitige Portalübernahme.
+- **Destination Solutions:** Beim konkreten Vermieteraccount fehlt ein automatischer Kalenderabgleich; manuelle Sperrung im Zielportal. Anschließende Weitergabe an Partnerportale und wirksamer Zeitpunkt sind **nicht verifizierbar**; eine protokollierte Sichtkontrolle des Vermieters ist kein Portalserver-Zeitstempel.
+- **Generische Grenze:** Bei heute sofort wirksam werdenden externen Direktbuchungen verhindert FewoPortal **nicht jede Doppelbuchung**. Vom Betreiber vorgeschlagene 10-Minuten-Bestätigung oder Livefreigabe sind sinnvolle technische Zukunftsoptionen, werden **nicht als bestehende Funktionen** vorausgesetzt.
+
+## 2. Minimale Nachweiskette, ohne Überbürokratisierung
+
+1. **Auslösende Buchung:** Portal/Quelle, externe Referenz, Ankunft der Nachricht, soweit ermittelbarer tatsächlicher Buchungs-/Bestätigungszeitpunkt.
+2. **Eigene Belegungsänderung:** Zeitstempel, interne Buchungs-ID, Zeitraum, Nutzer/Systemaktion, Stand eigener Kalender.
+3. **Propagation:** Ausgeführter Export oder angelegte manuelle Sperraufgabe; Zeitpunkt und verantwortliche Person.
+4. **Zielportal:** Soweit möglich manuelle Sichtkontrolle und optionaler Screenshot. Status nur **„angezeigt“**, wenn dadurch belegt.
+5. **Partnernetz:** Nur als **„wirksam nachgewiesen“** markieren, falls geeignete Rückmeldung/Protokoll vorhanden; sonst **„unbekannt“**.
+6. **Fehler:** Doppelbuchung → Meldungszeitpunkte, beide Verbindlichkeitsnachweise, mögliche Ursache, Kommunikation und Entscheidung gesondert festhalten.
+
+**Rechtliche Vorsicht:** Ein technisch nicht vermeidbarer Sync-Verzug belegt nicht automatisch fehlendes Verschulden nach Miet- und Portalvertrag. Verantwortlichkeit erst nach Vertrags- und Sachverhaltsprüfung beurteilen. FeWo-direkt-Richtlinien zu Gastgeberstornierungen gesondert beachten; die tatsächliche Ursache nicht durch Gast-Button umdeklarieren.
+
+## 3. Generischer Konflikt-Teilprozess
+
+Konflikt entdecken → unverändert dokumentieren → **bereits verbindliche Buchungen** und Zeitachse prüfen → Ursache/Zuständigkeiten ermitteln → realistische Lösung mit Gästen/Portalen abstimmen → **rechtlich tatsächlich wirksame** Umbuchung/Stornierung oder Alternativleistung dokumentieren → Kalender/Finanzen/Vertragsdokumente aktualisieren → Folgefälle übergeben.
+
+Keine bereits verbindliche externe Buchung nur aufgrund widersprüchlicher Kalenderdaten löschen; keine bloße Stornoanfrage als wirksam verbuchen. Mit dem Gast wird transparent kommuniziert, ohne durch Druck eine abweichende Ursache zu konstruieren.
+
+## 4. Zielarchitektur, nicht Ist-Funktionen
+
+Mögliche spätere technische Fähigkeiten: Live-API-Verfügbarkeitsabfrage, atomare Reservierung, Portalbestätigung vor Vertragsschluss, Webhooks/Audit-Logs, automatische Konfliktfrüherkennung. **Aktuell nicht als verfügbar oder implementiert voraussetzen.** Für den MVP zunächst: gut sichtbare Sperraufgaben und revisionsfähige Eigenprotokolle.
+
+Siehe [P01](P01/P01_Buchungseingang_und_Verfuegbarkeit.md), [E00](E00_Entscheidungsprotokoll.md), [Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md).
@@ -1,689 +0,0 @@
--- v0.7/00_Buchungsarchetypen.md
+++ v0.8/00_Buchungsarchetypen.md
@@ -3,7 +3,7 @@
typ: archetypenkatalog
titel: FewoPortal – Buchungsarchetypen und Verantwortungsübergaben
status: diskussionsentwurf
-version: "0.6"
+version: "0.7"
stand: 2026-10-31
prozess: V01
bezugsstand_prozessarchitektur: "0.7"
@@ -106,32 +106,32 @@
**Zu konfigurierende Kanalmerkmale:** Herkunft verbindlicher Preise/Rabatte/Stornobedingungen, Erkennbarkeit und Nachweise, Zuständigkeiten, erlaubte Dokumente, automatische oder manuelle Datenerfassung und Vertragsversand. Kein hardcodiertes FeWo-direkt-Verhalten.
-Siehe [00 – Portalprofile und Vertragsvorlagen](00_Portalprofile_und_Vertragsvorlagen.md) für das schlanke Referenzmodell.
+Siehe [[00_Portalprofile_und_Vertragsvorlagen|00 – Portalprofile und Vertragsvorlagen]] für das schlanke Referenzmodell.
## 8. Bezug zu vorhandenen Dokumenten
-- [Prozesslandkarte](00_Prozesslandkarte.md) – V01/V02, fünf Phasen und übergreifende Leitregeln.
-- [Gates und Übergaben](G00_Gates_und_Uebergaben.md) – konzeptionelle Gate-Logik.
-- [Entscheidungsprotokoll](E00_Entscheidungsprotokoll.md) – bereits bestätigte Entscheidungen.
-- [Sonderprozesse](X00_Sonderprozesse.md) – derzeit bekannte Ausnahmefamilien.
-- [Referenzfall eigene Webseite](R00_Szenarien/R01_Eigene_Webseite.md) – gesonderter Arbeitsentwurf (sofern dieser bereits ins Repository übernommen wurde).
+- [[00_Prozesslandkarte|Prozesslandkarte]] – V01/V02, fünf Phasen und übergreifende Leitregeln.
+- [[G00_Gates_und_Uebergaben|Gates und Übergaben]] – konzeptionelle Gate-Logik.
+- [[E00_Entscheidungsprotokoll|Entscheidungsprotokoll]] – bereits bestätigte Entscheidungen.
+- [[X00_Sonderprozesse|Sonderprozesse]] – derzeit bekannte Ausnahmefamilien.
+- [[R00_Szenarien/R01_Eigene_Webseite|Referenzfall eigene Webseite]] – gesonderter Arbeitsentwurf (sofern dieser bereits ins Repository übernommen wurde).
## 9. Ergänzende A4-Vertragsanalyse (Stand 31.10.2026)
-Die vom Betreiber bereitgestellte vierseitige FeWo-direkt-Vertragsvorlage wurde unter [A04 – Vertragsvorlage und Prozessanalyse](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md) gesondert bewertet. Besonders prüfbedürftig sind: Verbindlichkeit vor dem nachträglichen Vertragsversand (§ 5), zuvor einbezogene Konditionen, Preis-/Gebührentrennung (§ 4), Portalstorno gegenüber eigener Stornoklausel (§ 13), Datenbedarf sowie sichere Trennung von Vertragsdokument und Zugangs-/Anreiseinformationen. **Keine Änderung der Betreibervertragsklauseln ohne gesonderte rechtliche und fachliche Freigabe.**
+Die vom Betreiber bereitgestellte vierseitige FeWo-direkt-Vertragsvorlage wurde unter [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 – Vertragsvorlage und Prozessanalyse]] gesondert bewertet. Besonders prüfbedürftig sind: Verbindlichkeit vor dem nachträglichen Vertragsversand (§ 5), zuvor einbezogene Konditionen, Preis-/Gebührentrennung (§ 4), Portalstorno gegenüber eigener Stornoklausel (§ 13), Datenbedarf sowie sichere Trennung von Vertragsdokument und Zugangs-/Anreiseinformationen. **Keine Änderung der Betreibervertragsklauseln ohne gesonderte rechtliche und fachliche Freigabe.**
**Status dieses Dokuments:** Fünf Archetypen (A1–A5) nach E-012; Portalprofile und rechtliche Detailfragen bleiben offen. Neben FeWo-direkt (A4) ist Destination Solutions (A3) dokumentierter Praxisfall.
## 10. A4-Praxisnachweis aus FeWo-direkt-Ansichten (31.10.2026)
-Für eine konkrete zukünftige Buchung sind **aggregierte Übernachtungsrate, Rabatt, Gebühren/Steuern, Gesamtzahlung des Gastes, Abzug an FeWo-direkt, Auszahlungsvorschau sowie zwei Zahlungsraten und deren Fälligkeits-/Zahlungsstatus** im Vermieterbereich sichtbar. Auch angezeigte Stornobedingungen und der vorgesehene 72-Stunden-Anreiseinformationsversand sind erkennbar. **Nicht nachgewiesen** sind die vollständigen Tagespreis- und Gebührenbestandteile, ein belastbarer allgemeiner Zahlungsexport, die tatsächliche Auszahlung, der vollständige Vertragsinhalt der Gastbestätigung und die vollständigen Gaststammdaten. Zwei Ansichten weisen zudem **unterschiedliche voraussichtliche Vermieterauszahlungen (900,20 € / 894,69 €)** aus, Ursache offen. Details im [A4-Vertrags- und Prozessdokument](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md#7-nachtrag-aus-belegten-bildschirmansichten-31102026--ist-zustand-nicht-allgemeines-portalverhalten).
+Für eine konkrete zukünftige Buchung sind **aggregierte Übernachtungsrate, Rabatt, Gebühren/Steuern, Gesamtzahlung des Gastes, Abzug an FeWo-direkt, Auszahlungsvorschau sowie zwei Zahlungsraten und deren Fälligkeits-/Zahlungsstatus** im Vermieterbereich sichtbar. Auch angezeigte Stornobedingungen und der vorgesehene 72-Stunden-Anreiseinformationsversand sind erkennbar. **Nicht nachgewiesen** sind die vollständigen Tagespreis- und Gebührenbestandteile, ein belastbarer allgemeiner Zahlungsexport, die tatsächliche Auszahlung, der vollständige Vertragsinhalt der Gastbestätigung und die vollständigen Gaststammdaten. Zwei Ansichten weisen zudem **unterschiedliche voraussichtliche Vermieterauszahlungen (900,20 € / 894,69 €)** aus, Ursache offen. Details im [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse#7. Nachtrag aus belegten Bildschirmansichten (31.10.2026) – Ist-Zustand, nicht allgemeines Portalverhalten|A4-Vertrags- und Prozessdokument]].
**Portalinvariante:** Verantwortlichkeit für Zahlung oder Kommunikation, Portalstatus und tatsächlicher Erfüllungsnachweis sind getrennt zu verwalten.
## 11. Änderungs- und Stornoereignisse (portalunabhängig)
-Ein Storno bzw. eine Buchungsänderung ist ein **Teilprozess auf derselben Buchungsakte**, kein zusätzlicher Archetyp. Die fachliche Ursache (Gastwunsch, Unmöglichkeit beim Vermieter, Doppelbuchung, Regelverstoß, technischer Fehler), der Initiator, der ausführende Beteiligte und die Abwicklungsverantwortung sind voneinander zu unterscheiden. Anfrage, Bestätigung und tatsächliche Wirksamkeit sind getrennte Ereigniszustände. Kalender, Konditionen, Vertrag und Zahlungen werden erst nach ausreichend belegter Wirksamkeit angepasst. Eine durch den Vermieter verursachte Stornierung darf nicht durch Aufforderung an den Gast als Gaststorno umetikettiert werden. **FeWo-direkt** ist dafür ein dokumentiertes Portalbeispiel (siehe [A04 Abschnitt 8](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md)); andere Portale können abweichende Wege, Daten und Zuständigkeiten haben.
+Ein Storno bzw. eine Buchungsänderung ist ein **Teilprozess auf derselben Buchungsakte**, kein zusätzlicher Archetyp. Die fachliche Ursache (Gastwunsch, Unmöglichkeit beim Vermieter, Doppelbuchung, Regelverstoß, technischer Fehler), der Initiator, der ausführende Beteiligte und die Abwicklungsverantwortung sind voneinander zu unterscheiden. Anfrage, Bestätigung und tatsächliche Wirksamkeit sind getrennte Ereigniszustände. Kalender, Konditionen, Vertrag und Zahlungen werden erst nach ausreichend belegter Wirksamkeit angepasst. Eine durch den Vermieter verursachte Stornierung darf nicht durch Aufforderung an den Gast als Gaststorno umetikettiert werden. **FeWo-direkt** ist dafür ein dokumentiertes Portalbeispiel (siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 Abschnitt 8]]); andere Portale können abweichende Wege, Daten und Zuständigkeiten haben.
## 12. Destination Solutions als Praxisreferenz A3 (E-012/E-016/E-017/E-018)
@@ -141,8 +141,12 @@
- **Vermittlerprovisionen** können nach Vertriebskanal variieren. Sie sind nicht nachträglich vom Gast zu fordern. Ob zusätzlich ein direkter Gast-Aufschlag/Serviceentgelt oder Partner-Endpreisaufschlag existiert, muss beim Anbieter und anhand einer Gastbestätigung geprüft werden.
- **Stornostaffel** vom Betreiber angegeben: ≥60 Tage 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, ≤11 Tage 100 % vom „Mietpreis“; **vorvertragliche Einbeziehung, Berechnungsbasis und rechtliche Wirksamkeit offen**.
-Siehe [R08 Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md) und [O00 Offene Portalprüffälle](O00_Offene_Portalprueffaelle.md).
+Siehe [[R00_Szenarien/R08_Destination_Solutions|R08 Destination Solutions]] und [[O00_Offene_Portalprueffaelle|O00 Offene Portalprüffälle]].
## 13. Portaldaten können unterschiedlich detailliert und zusammengesetzt sein (E-014/E-015)
-Bei A2–A5 sind **automatische, manuelle und hybride** Informationen und Tätigkeiten gleichwertig zu modellieren. Pro Buchung sind vollständig aufgeschlüsselte Positionen, **kombinierte Service-/Gebührenpositionen**, bloße Gesamtbeträge sowie nur teilweise verfügbare Zahlungsauszüge möglich. Keine fiktive Zerlegung des Gesamtpreises; unbekannte Gebührenarten, Zahlende/Empfänger und Provisionsanteile bleiben offen. Nachträgliche Zuordnung oder Aufteilung erhält den originalen Portalbetrag und verhindert doppelte Summierung. Fehlende rein interne Kostenanalyse blockiert nicht ohne Weiteres den vertraglichen Aufenthalt. Siehe [K01](K01_Preisstruktur_und_Abrechnung.md).
+Bei A2–A5 sind **automatische, manuelle und hybride** Informationen und Tätigkeiten gleichwertig zu modellieren. Pro Buchung sind vollständig aufgeschlüsselte Positionen, **kombinierte Service-/Gebührenpositionen**, bloße Gesamtbeträge sowie nur teilweise verfügbare Zahlungsauszüge möglich. Keine fiktive Zerlegung des Gesamtpreises; unbekannte Gebührenarten, Zahlende/Empfänger und Provisionsanteile bleiben offen. Nachträgliche Zuordnung oder Aufteilung erhält den originalen Portalbetrag und verhindert doppelte Summierung. Fehlende rein interne Kostenanalyse blockiert nicht ohne Weiteres den vertraglichen Aufenthalt. Siehe [[K01_Preisstruktur_und_Abrechnung|K01]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]] · [[R00_Szenarien/R01_Eigene_Webseite|A1 – Eigene Webseite]] · [[R00_Szenarien/R08_Destination_Solutions|A3 – Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A4 – FeWo-direkt]] · [[00_Portalprofile_und_Vertragsvorlagen|Vertragsprofile]] · [[G00_Gates_und_Uebergaben|Gates]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
--- v0.7/00_Portalprofile_und_Vertragsvorlagen.md
+++ v0.8/00_Portalprofile_und_Vertragsvorlagen.md
@@ -3,7 +3,7 @@
typ: fachliches-konzept
titel: Portalprofile, Konditionsquellen und Vertragsvorlagen
status: diskussionsentwurf
-version: "0.2"
+version: "0.3"
stand: 2026-10-31
prozess: V01
bezugsstand_archetypen: "0.6"
@@ -66,7 +66,7 @@
- Zahlung nach aktuellem Ablauf über FeWo-direkt. Vertragsdokumentation und lokale Gästebetreuung bei uns; Storno-/Mahnverantwortung ist noch genauer zu prüfen.
- Die heutige FeWo-direkt-Vertragsvorlage ist **ein spezielles Dokumentenprofil**, kein globaler Vertragsstandard.
-Siehe [A04 – Analyse der bisherigen FeWo-direkt-Vertragsvorlage](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md).
+Siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 – Analyse der bisherigen FeWo-direkt-Vertragsvorlage]].
## 7. Bewusste Grenzen / offene Punkte
@@ -101,4 +101,8 @@
- **FeWo-direkt (A4):** Eigene Miet-/Rabatt-/Stornokonfiguration im Portal; im Vermieterposteingang sind bei einer Buchung einzelne Summen, Zahlungsraten und erwartete Auszahlung ersichtlich, nicht notwendigerweise die Einzelpreiszerlegung. Eigener statischer Mietvertrag bislang nicht im Inserat hinterlegt. Angeblich/öffentlich angebotene Funktionen sind nicht automatisch im konkreten Betreiberkonto vorhanden.
- **Destination Solutions (A3):** Extern bereits verbindliche Buchung; danach vollständige Abwicklung beim Vermieter. **In aktuellem Betreiberzugang keine Kalendersynchronisation**; manuelle Portalsperrung mit begrenzter Nachweisbarkeit. Provision kann nach Vertriebskanal differieren; Gast-Serviceaufschlag, Preisaufschläge und vorvertragliche Anzeige der Stornobedingungen sind noch ungeklärt.
-Details: [K01 Preise & Abrechnung](K01_Preisstruktur_und_Abrechnung.md); [R08 Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md); [O00 offene Fragen](O00_Offene_Portalprueffaelle.md).
+Details: [[K01_Preisstruktur_und_Abrechnung|K01 Preise & Abrechnung]]; [[R00_Szenarien/R08_Destination_Solutions|R08 Destination Solutions]]; [[O00_Offene_Portalprueffaelle|O00 offene Fragen]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Buchungsarchetypen|Archetypen]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02 Vertragsverbindlichkeit]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Vertragsabwicklung]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[O00_Offene_Portalprueffaelle|Offene Fragen]]
--- v0.7/00_Prozesslandkarte.md
+++ v0.8/00_Prozesslandkarte.md
@@ -3,10 +3,10 @@
typ: prozesslandkarte
titel: FewoPortal – Prozesslandkarte
status: arbeitsstand
-version: '0.7'
+version: "0.8"
---
-# 00 – Prozesslandkarte FewoPortal v0.7
+# 00 – Prozesslandkarte FewoPortal v0.8
**Status:** gemeinsamer Arbeitsstand; übergreifendes Modell, nicht vollständig freigegeben.
**Stand:** 31.10.2026
@@ -125,4 +125,8 @@
**Nachträgliche Ereignisse (E-019):** Änderungsanfrage, bestätigte Änderung, Stornierungswunsch und wirksame Stornierung unterscheiden. Ursache, Durchführender, vertragliche Folgen, Belegung und Geldflüsse getrennt dokumentieren.
-**Zu vertiefen:** [K01 Preis- und Abrechnungsmodell](K01_Preisstruktur_und_Abrechnung.md), [X01 Belegungskonflikt- und Sperrnachweise](X01_Belegungskonflikte_und_Sperrnachweise.md), [O00 offene Portalfragen](O00_Offene_Portalprueffaelle.md).
+**Zu vertiefen:** [[K01_Preisstruktur_und_Abrechnung|K01 Preis- und Abrechnungsmodell]], [[X01_Belegungskonflikte_und_Sperrnachweise|X01 Belegungskonflikt- und Sperrnachweise]], [[O00_Offene_Portalprueffaelle|O00 offene Portalfragen]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01 Buchungseingang]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02 Konditionen und Bindung]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Verwaltung und Abwicklung]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04 Aufenthalt]] · [[P05/P05_Abschluss_und_Nachbereitung|P05 Abschluss]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Supportprozesse]] · [[X00_Sonderprozesse|Sonderprozesse]] · [[00_Buchungsarchetypen|Archetypen]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
--- v0.7/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md
+++ v0.8/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md
@@ -3,7 +3,7 @@
typ: prozessanalyse
titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess
status: diskussionsentwurf
-version: "0.5"
+version: "0.6"
stand: 2026-10-31
prozess: V01
archetyp: A4
@@ -81,7 +81,7 @@
**Welche Konditionen sieht und bestätigt der Gast bei einer konkreten FeWo-direkt-Direktbuchung und welche Dokumente erhält er anschließend tatsächlich vom Portal?**
-Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [Portalprofile und Vertragsvorlagen](00_Portalprofile_und_Vertragsvorlagen.md).
+Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile und Vertragsvorlagen]].
## 6. Öffentliche Quellen für die juristisch-technischen Prüfpunkte
@@ -167,4 +167,8 @@
4. **Sonderprozesse:** Bisher keine konkret selbst durchlaufene FeWo-direkt-Buchungsänderung und keine eigene Vermieterstornierung. Kein nicht erprobtes Verfahren als gelebte Praxis behaupten. Differenzierung **tatsächliche Stornoursache, Antragsteller, ausführender Beteiligter** beachten.
5. **Abrechnung:** Unbekannte Gast-Servicegebühren, Portalabzüge, Vermieterprovisionen oder kombinierte Sammelpositionen müssen nicht künstlich zerlegt werden. Portalinformationen und manuelle Ergänzungen mit Quelle sichern; bei abweichenden Summen Klärungsaufgabe.
-Fachliche Konkretisierung: [K01](K01_Preisstruktur_und_Abrechnung.md), [X01](X01_Belegungskonflikte_und_Sperrnachweise.md) und [O00](O00_Offene_Portalprueffaelle.md). Keine Aktualisierung oder juristische Freigabe des ursprünglichen PDF-Vertrags durch diese Analyse.
+Fachliche Konkretisierung: [[K01_Preisstruktur_und_Abrechnung|K01]], [[X01_Belegungskonflikte_und_Sperrnachweise|X01]] und [[O00_Offene_Portalprueffaelle|O00]]. Keine Aktualisierung oder juristische Freigabe des ursprünglichen PDF-Vertrags durch diese Analyse.
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Buchungsarchetypen|Archetypen]] · [[00_Portalprofile_und_Vertragsvorlagen|Vertragsprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]] · [[P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch|Frühere Fassung im P03-Archiv]]
--- v0.7/AENDERUNGSNOTIZ.md
+++ v0.8/AENDERUNGSNOTIZ.md
@@ -1,3 +1,11 @@
+---
+id: CHANGE-NOTE
+typ: dokumentationshilfe
+titel: "Änderungsnotiz"
+status: arbeitsstand
+version: "0.1"
+---
+
# Änderungsnotiz – Portalprofile und Vertragsvorlagen (31.10.2026)
- `00_Buchungsarchetypen.md`: v0.2 → v0.3, **Abschnitt 7 neu**, frühere Abschnitte 7/8 nur umnummeriert; bestehende Archetypen/Gates unverändert.
@@ -5,3 +13,7 @@
- `00_Portalprofile_und_Vertragsvorlagen.md`: **neu** v0.1, portable Portal-/Buchungstyp-/Herkunftsprofile, zugehörige Vertragsvorlagen/Anlagen, Konditionsquellen, Snapshot/Gates.
**Keine Produktivänderungen, kein Code.** Dateien für manuelle Übernahme in bestehende Gitea-Dokumentation; Repository-Stand konnte nicht gegen Gitea selbst verglichen werden. Änderungen vor Übernahme gegen aktuelle Git-Dateien prüfen.
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[AENDERUNGSUEBERSICHT|Änderungsübersicht]]
--- v0.7/AENDERUNGSUEBERSICHT.md
+++ v0.8/AENDERUNGSUEBERSICHT.md
@@ -1,3 +1,11 @@
+---
+id: CHANGELOG
+typ: dokumentationshilfe
+titel: "Änderungshistorie"
+status: arbeitsstand
+version: "0.1"
+---
+
# Änderung v0.6 gegenüber v0.5
- **E-011 bestätigt:** Alternative fachliche Endergebnisse von V01: regulär abgeschlossen, ohne Buchung beendet, storniert (nach Verbindlichkeit). Keine zusätzlichen Buchungsworkflows.
@@ -17,3 +25,17 @@
- Neues Portalfragenregister und verbindliche Dokumentationsarbeitsregel: aktuelle Originaldokumente künftig **vor jedem Edit erneut anfordern**.
- R01-Referenzentwurf inhaltlich unverändert übernommen, R08 neu ergänzt.
- Ausgangsdokumente unverändert gelassen; Diff und Prüfliste im Paket. Keine Gitea-Änderung/Implementierungsfreigabe.
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]] · [[QUELLENMANIFEST|Quellenmanifest]]
+
+# Änderung v0.8 gegenüber v0.7 – Obsidian-Verknüpfungen (31.10.2026)
+
+- Ausgangspunkt: vom Betreiber erneut hochgeladene vollständige ZIP-Fassung „v0.7 komplett.zip“. Keine Übernahme einer unbestätigten Gitea-Version behauptet.
+- Interne relative Markdown-Links in eindeutige Obsidian-Wikilinks mit Vault-relativen Pfaden umgewandelt; externe Quellen-URLs unverändert.
+- Verknüpfungsnavigation für sämtliche vorhandenen Markdown-Dokumente ergänzt, mit README als Startseite und P01–P05 als zusammenhängendem Phasenpfad.
+- Ein bestehender Verweis auf Abschnitt 7 der FeWo-direkt-Analyse in einen Obsidian-Überschriftenlink umgewandelt.
+- Zwei Dateien mit gleichem Namen und gleicher Dokumenten-ID „A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md“ identifiziert: P03-Unterordnerdatei als historische Fassung eindeutig umbenannt und historischer Identifikator abgesetzt. Die aktuelle kanonische Datei im Root bleibt am ursprünglichen Pfad.
+- **Keine inhaltliche Änderung an den Buchungs-/Vertrags-/Zahlungsentscheidungen**. Die ursprünglichen Änderungs-Diffs zu v0.5–v0.7 bleiben unverändert, ein eigener Diff v0.8 wird ergänzt.
+- Alle Wikilinks und Überschriftenziele programmatisch auf vorhandene Dateien/Abschnitte geprüft.
--- v0.7/D00_Dokumentationsregel_und_Uebergabe.md
+++ v0.8/D00_Dokumentationsregel_und_Uebergabe.md
@@ -3,7 +3,7 @@
typ: arbeitsregel
titel: Dokumentationsregeln, Quellenbasis und Übergabe
status: diskussionsentwurf
-version: "0.1"
+version: "0.2"
stand: 2026-10-31
---
@@ -32,3 +32,13 @@
## Kompakter Kontext für den nächsten Chat
FewoPortal ist eine **kleine, mandantenfähige Vermieterwebsite-/Buchungsanwendung für typischerweise 1–3 Ferienwohnungen je Vermieter, kein Marktplatz**. Ein gemeinsamer Hauptprozess V01 P01–P05, dazu V02 Vermarktung/Gästegewinnung/Gästebindung. Fünf Archetypen: A1 eigene Webseite, A2 externe unverbindliche Anfrage, A3 externe verbindliche Buchung mit weiterer eigener Gesamtabwicklung (**Destination Solutions**), A4 externe verbindliche Buchung mit geteilter Abwicklung (**FeWo-direkt**), A5 überwiegend externe Vollabwicklung. **A6 gestrichen**; Partnerherkunft nur bei Provisionsrelevanz. Ein Vorgang/eine Akte. Externer Preis und beim Vertragsschluss vereinbarte Bedingungen bleiben maßgeblich, spätere Dokumente keine stillen neuen Pflichten. Unterschiedliche/versionierte Vorlagen pro Kanal/Buchungstyp. Portale liefern unterschiedlich vollständige Daten; **manuelle Bearbeitung und Sammel-/Gesamtpreise** sind konstitutive Fachfunktionen. Gast-Mietforderung, externe Gastgebühr, Vermieterprovision, Auszahlung und Zahlung getrennt. Kein Erfinden unbekannter Gebührenanteile. Verfügbarkeit extern nicht garantiert: FeWo-direkt verzögerter iCal-Import, Destination Solutions manuelles Sperren ohne verlässlichen Portal-/Partnernachweis; Doppelbuchungen möglich, deshalb Ausnahmeprozess und Belegkette. Nicht bekannte Vertrags- und Portalfragen im O00-Prüffallregister. **Vor der nächsten Dokumentbearbeitung aktuelle Gitea-Fassung explizit erfragen.**
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[E00_Entscheidungsprotokoll|Entscheidungen]] · [[QUELLENMANIFEST|Quellenmanifest]] · [[AENDERUNGSUEBERSICHT|Änderungshistorie]]
+
+## Technische Dokumentationsregel v0.8 – Obsidian
+
+- Die Dokumentationsbasis wird als Obsidian-Vault genutzt; Querverweise zwischen Markdown-Dateien bevorzugt als eindeutige Wikilinks mit Pfad und Anzeigename erstellen.
+- Nach jeder Dateiänderung interne Links, Überschriftenverweise und vorhandene Zielnotizen prüfen; keine Phantom-Links oder versehentliche Duplikate erzeugen.
+- **Unverändert bindend:** Vor der nächsten Dokumentänderung die dann aktuelle Gitea-Originalfassung beim Betreiber ausdrücklich erneut anfordern.
--- v0.7/E00_Entscheidungsprotokoll.md
+++ v0.8/E00_Entscheidungsprotokoll.md
@@ -3,7 +3,7 @@
typ: entscheidungsprotokoll
titel: Entscheidungsprotokoll
status: arbeitsstand
-version: '0.7'
+version: "0.8"
---
# E00 – Entscheidungsprotokoll
@@ -61,4 +61,8 @@
**Nicht beschlossen:** Dass technische Portalprobleme automatisch rechtlich fehlendes Verschulden beweisen; dass eine 10-Minuten-Freigabe heute bei den genannten Portalen möglich ist; dass alle Portale gleiche Preis-/Gast-/Zahlungsdaten bereitstellen; dass nachträglich versandte Stornobedingungen wirksam werden. Solche Aussagen bleiben Prüffälle.
-**Weitere Fachkonzepte:** [Archetypen A1–A5](00_Buchungsarchetypen.md), [Portal-/Vertragsprofile](00_Portalprofile_und_Vertragsvorlagen.md), [Flexible kaufmännische Positionen](K01_Preisstruktur_und_Abrechnung.md), [Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md), [offene Portalprüffälle](O00_Offene_Portalprueffaelle.md).
+**Weitere Fachkonzepte:** [[00_Buchungsarchetypen|Archetypen A1–A5]], [[00_Portalprofile_und_Vertragsvorlagen|Portal-/Vertragsprofile]], [[K01_Preisstruktur_und_Abrechnung|Flexible kaufmännische Positionen]], [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]], [[O00_Offene_Portalprueffaelle|offene Portalprüffälle]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen]] · [[G00_Gates_und_Uebergaben|Gates]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]]
--- v0.7/G00_Gates_und_Uebergaben.md
+++ v0.8/G00_Gates_und_Uebergaben.md
@@ -3,7 +3,7 @@
typ: gate-modell
titel: Gate- und Übergabemodell
status: arbeitsstand
-version: '0.7'
+version: "0.8"
---
# G00 – Gate- und Übergabemodell (Arbeitsstand)
@@ -52,3 +52,7 @@
- **X02/X04/X07:** Storno-/Änderungsantrag ist **kein** wirksames Ergebnis. Bei Belegungskonflikt Ursache, zeitliche Abfolge, Bindung beider Buchungen, belegte extern wirksame Sperren und verbleibende Handlungsmöglichkeiten erfassen; Verantwortlichkeit wird nicht aus einem einzigen Button abgeleitet.
**Evidenzstatus je Datenpunkt:** `übermittelt / durch externe Quelle behauptet / anhand Beleg geprüft / intern erfasst / manuell ergänzt / nicht geliefert / widersprüchlich / nicht anwendbar`; als **fachliche Beispiele**, nicht als freigegebene technische Enum. `unbekannt` ist **nicht** `0` oder `nicht vorhanden`.
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04]] · [[P05/P05_Abschluss_und_Nachbereitung|P05]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
--- v0.7/K01_Preisstruktur_und_Abrechnung.md
+++ v0.8/K01_Preisstruktur_und_Abrechnung.md
@@ -3,7 +3,7 @@
typ: fachliches-konzept
titel: Preis-, Gebühren- und Abrechnungsinformationen
status: diskussionsentwurf
-version: "0.1"
+version: "0.2"
stand: 2026-10-31
---
@@ -59,7 +59,7 @@
## 6. Reale Prüfbeispiele
-**FeWo-direkt A4 – beobachteter Screenshot, Buchung 10.–17.07.2027:** 840,00 € Übernachtungen, −42,00 € Rabatt, +181,51 € „Gebühren und Steuern“, 979,51 € Gastgesamtbetrag, −84,82 € „An FeWo-direkt gezahlt“, 894,69 € ausgewiesene Gesamtauszahlung. In anderer Ansicht 900,20 € erwartete Auszahlung (5,51 € Differenz). Sichtbarer Zahlungsplan 390,61 € bezahlt und 588,90 € später fällig. **Keine belegte Zerlegung** von 181,51 €/84,82 € oder der 5,51-€-Differenz; einzelne Tagespreise fehlen. Siehe [A04 Abschnitt 7](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md).
+**FeWo-direkt A4 – beobachteter Screenshot, Buchung 10.–17.07.2027:** 840,00 € Übernachtungen, −42,00 € Rabatt, +181,51 € „Gebühren und Steuern“, 979,51 € Gastgesamtbetrag, −84,82 € „An FeWo-direkt gezahlt“, 894,69 € ausgewiesene Gesamtauszahlung. In anderer Ansicht 900,20 € erwartete Auszahlung (5,51 € Differenz). Sichtbarer Zahlungsplan 390,61 € bezahlt und 588,90 € später fällig. **Keine belegte Zerlegung** von 181,51 €/84,82 € oder der 5,51-€-Differenz; einzelne Tagespreise fehlen. Siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 Abschnitt 7]].
**Destination Solutions A3 – Betreiberangaben:** Extern bestätigter Buchungspreis ist zu übernehmen und Zahlung durch Vermieter abzuwickeln. Provisionssatz kann nach vermittelndem Partner variieren. Ob Partnerportal den Endpreis erhöht oder eine separate Gast-Servicegebühr erhebt, ist derzeit nicht bestätigt; auch dort darf nur ein übermittelter Gesamtpreis zulässig sein. Keine nachträgliche Provisionsbelastung des Gastes.
@@ -70,4 +70,8 @@
- Welche Vereinbarungen gelten für Stornokostenbasis („Mietpreis“ vs. Gesamtbetrag; inkludierte/ausgeschlossene Leistungen), wenn nur eine Gesamtsumme vorliegt?
- Welche individuellen Portalberichte, tatsächlichen Zahlungsnachweise und Importformate stehen zur Verfügung?
-**Fachliche Herkunft:** Betreiberinterview vom 31.10.2026, FeWo-direkt-Screenshots, [E00 E-014–E-020](E00_Entscheidungsprotokoll.md). Rechtliche Gestaltung separat prüfen.
+**Fachliche Herkunft:** Betreiberinterview vom 31.10.2026, FeWo-direkt-Screenshots, [[E00_Entscheidungsprotokoll|E00 E-014–E-020]]. Rechtliche Gestaltung separat prüfen.
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]]
--- v0.7/O00_Offene_Portalprueffaelle.md
+++ v0.8/O00_Offene_Portalprueffaelle.md
@@ -3,7 +3,7 @@
typ: prueffallregister
titel: Portalbezogene Prüf- und Klärungsfälle
status: diskussionsentwurf
-version: "0.1"
+version: "0.2"
stand: 2026-10-31
---
@@ -46,4 +46,8 @@
Pro Portal idealerweise **ein vollständig anonymisierter realer Buchungsfall**, Gast-Buchungsbestätigung soweit vorhanden, Betreiber-Provisionsabrechnung, Preis-/Stornokonfiguration und ein Beispiel für Änderung/Stornierung. **Nicht alle Nachweise müssen jetzt vorliegen**; Fehlen führt zu manuellen Aufgaben oder offenen Informationsfeldern, nicht zum Erfinden von Regeln.
-**Referenzen:** [Portalprofil K00](00_Portalprofile_und_Vertragsvorlagen.md), [Preisstruktur K01](K01_Preisstruktur_und_Abrechnung.md), [FeWo-direkt A04](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md), [Destination Solutions R02](R00_Szenarien/R08_Destination_Solutions.md).
+**Referenzen:** [[00_Portalprofile_und_Vertragsvorlagen|Portalprofil K00]], [[K01_Preisstruktur_und_Abrechnung|Preisstruktur K01]], [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt A04]], [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions R02]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
--- v0.7/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
+++ v0.8/P01/P01_Buchungseingang_und_Verfuegbarkeit.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Buchungseingang und Verfügbarkeitssicherung
status: entwurf
-version: '0.7'
+version: "0.8"
---
# P01 – Buchungseingang und Verfügbarkeitssicherung
@@ -38,4 +38,8 @@
- **Portalunabhängig:** Art des Belegungs-Inputs (iCal, API, E-Mail, manuell), Ausführungspfad (automatisch/manuell/hybrid), Verzögerung/Unsicherheit und Kontrollmöglichkeiten im Portalprofil hinterlegen. Neue, extern **bereits verbindliche** Kollisionsbuchung als Konflikt behandeln; keine stillschweigende Ablehnung oder Löschung.
- **Drei Sperrzustände:** `Sperrung veranlasst`, `im Zielportal sichtbar`, `nachweislich im relevanten Vertrieb wirksam`. Fehlender Nachweis bleibt **unbekannt**. Für eigene Holds eigene atomare Freihaltung und Sicherung des bindenden Angebots prüfen, ohne fremde Echtzeitwirkung zu versprechen.
-Siehe [X01 – Konfliktmanagement und Nachweise](../X01_Belegungskonflikte_und_Sperrnachweise.md).
+Siehe [[X01_Belegungskonflikte_und_Sperrnachweise|X01 – Konfliktmanagement und Nachweise]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|Weiter zu P02]] · [[G00_Gates_und_Uebergaben|Gates]] · [[X01_Belegungskonflikte_und_Sperrnachweise|X07 Belegungskonflikte]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]]
--- v0.7/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
+++ v0.8/P02/P02_Konditionen_und_Buchungsverbindlichkeit.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Konditionen und Buchungsverbindlichkeit
status: entwurf
-version: '0.7'
+version: "0.8"
---
# P02 – Konditionen und Buchungsverbindlichkeit
@@ -58,4 +58,8 @@
- **Vorvertragliche Einbeziehung:** Ob dem Gast vor Abschluss Stornostaffeln, Pflichtgebühren und sonstige Bedingungen angezeigt wurden, ist je Portal zu prüfen; ein nachträgliches Dokument erzeugt nicht automatisch neue Vertragspflichten.
- **Destination Solutions:** Genannte Stornostaffel (vom Betreiber berichtet): mindestens 60 Tage vorher 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, 11 Tage oder weniger 100 % des „Mietpreises“. **Ungeklärt:** Nachweis im Buchungsprozess, Durchsetzbarkeit, genaue Kostenbasis. Nicht als globalen A3-Standard verwenden.
-Siehe [K00](../00_Portalprofile_und_Vertragsvorlagen.md), [K01](../K01_Preisstruktur_und_Abrechnung.md) und [R08 Destination Solutions](../R00_Szenarien/R08_Destination_Solutions.md).
+Siehe [[00_Portalprofile_und_Vertragsvorlagen|K00]], [[K01_Preisstruktur_und_Abrechnung|K01]] und [[R00_Szenarien/R08_Destination_Solutions|R08 Destination Solutions]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|Zurück zu P01]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|Weiter zu P03]] · [[G00_Gates_und_Uebergaben|Gates]] · [[00_Portalprofile_und_Vertragsvorlagen|Vertragsprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]]
--- v0.7/P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md
+++ v0.8/P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch.md
@@ -1,9 +1,9 @@
---
-id: A04-DOK-01
+id: A04-DOK-ARCHIV
typ: prozessanalyse
titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess
status: diskussionsentwurf
-version: "0.2"
+version: "0.3"
stand: 2026-10-31
prozess: V01
archetyp: A4
@@ -12,7 +12,9 @@
- "Betreiberbeschreibung: manueller A4-Istprozess, 31.10.2026"
---
-# A4 – Vertragsvorlage und Prozessanalyse
+> **Historischer Bearbeitungsstand (ursprünglich v0.2)** – für die aktuelle Analyse siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A4 – aktuelle Hauptfassung]].
+
+# A4 – Vertragsvorlage und Prozessanalyse (historische Fassung)
> **Arbeitsdokument, keine Freigabe zur Änderung rechtlicher Klauseln.** Die Vertragsvorlage ist ein Beispiel für den aktuellen Ablauf, kein Nachweis der beim Buchungsabschluss über FeWo-direkt tatsächlich akzeptierten Konditionen. **Zugangscodes, Passwörter, persönliche Kontaktdaten und Namen von Gästen werden hier bewusst nicht reproduziert.**
@@ -81,7 +83,7 @@
**Welche Konditionen sieht und bestätigt der Gast bei einer konkreten FeWo-direkt-Direktbuchung und welche Dokumente erhält er anschließend tatsächlich vom Portal?**
-Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [Portalprofile und Vertragsvorlagen](00_Portalprofile_und_Vertragsvorlagen.md).
+Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile und Vertragsvorlagen]].
## 6. Öffentliche Quellen für die juristisch-technischen Prüfpunkte
@@ -98,3 +100,7 @@
- [Kühlungsborn – Kurabgabe](https://www.kuehlungsborn.de/kurabgabe/)
**Abgrenzung:** Dies ist eine fachliche Prozess- und Risikoprüfung, keine rechtliche Freigabe und keine eigenmächtige Überarbeitung der Betreiber-Vertragstexte.
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|Aktuelle FeWo-direkt-Analyse]]
--- v0.7/P03/P03_Buchungsverwaltung_und_Abwicklung.md
+++ v0.8/P03/P03_Buchungsverwaltung_und_Abwicklung.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Buchungsverwaltung und kaufmännische Abwicklung
status: entwurf
-version: '0.7'
+version: "0.8"
---
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
@@ -38,4 +38,8 @@
6. **Destination Solutions A3:** Vermieter führt Vertrag, Zahlungsanforderung, Zahlungskontrolle und ggf. Stornobearbeitung; Höhe der Vermittlerprovision je Herkunft unterschiedlich möglich. Keine zusätzliche Provisionsrechnung an den Gast ohne vorbestehende Vereinbarung.
7. **FeWo-direkt A4:** Sichtbarer Gastzahlungsplan und erwartete Auszahlung ersetzen weder den Beleg über Bankeingang noch vollständige Gebührenaufschlüsselung; siehe konkrete A4-Screenshots und offenen 5,51-€-Differenzfall.
-[Vertiefung: K01](../K01_Preisstruktur_und_Abrechnung.md).
+[[K01_Preisstruktur_und_Abrechnung|Vertiefung: K01]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|Zurück zu P02]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|Weiter zu P04]] · [[K01_Preisstruktur_und_Abrechnung|Preis und Abrechnung]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|Aktuelle FeWo-direkt-Analyse]] · [[P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch|Historischer FeWo-direkt-Entwurf]]
--- v0.7/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
+++ v0.8/P04/P04_Leistungsvorbereitung_und_Aufenthalt.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Leistungsvorbereitung und Aufenthalt
status: entwurf
-version: '0.7'
+version: "0.8"
---
# P04 – Leistungsvorbereitung und Aufenthalt
@@ -30,3 +30,7 @@
## Ergänzung v0.7: externe Kommunikationszuständigkeit
Bei Portal-Direktbuchungen unterscheiden: Portal kündigt Gastnachricht an, Portalversand ist tatsächlich bestätigt oder Vermieter versendet eigene Informationen. FeWo-direkt kündigt in der gezeigten Buchung eine E-Mail etwa 72 Stunden vor Anreise an; dies ist **noch kein Nachweis**, dass sie dem Gast zugegangen ist. Falls erforderliche Gäste-/Meldedaten fehlen, manuell nachfordern. Bei Destination Solutions führt Vermieter die Gast- und Dienstleisterkommunikation im Rahmen der eigenen Abwicklung.
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|Zurück zu P03]] · [[P05/P05_Abschluss_und_Nachbereitung|Weiter zu P05]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Supportprozesse]]
--- v0.7/P05/P05_Abschluss_und_Nachbereitung.md
+++ v0.8/P05/P05_Abschluss_und_Nachbereitung.md
@@ -3,7 +3,7 @@
typ: prozessphase
titel: Abschluss und Nachbereitung
status: entwurf
-version: '0.7'
+version: "0.8"
---
# P05 – Abschluss und Nachbereitung
@@ -33,3 +33,7 @@
## Ergänzung v0.7: Abrechnung und Nachweislücken
Eine Buchung darf nach erbrachter Leistung fachlich regulär enden, selbst wenn **Provisionsaufschlüsselung, ausstehende Auszahlung oder ungeklärte Sammelgebühren** in einem gesondert zugewiesenen Folgefall weiterbearbeitet werden. Gastbezogene offene Forderungen, Storno- oder Auszahlungsdifferenzen müssen mit Quelle, Verantwortlichem und Buchungsreferenz nachvollziehbar übergeben werden. Fehlende detaillierte Preisaufteilung ist nicht automatisch eine unvollständige Gastleistung.
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|Zurück zu P04]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Supportprozesse]]
--- v0.7/QUELLENMANIFEST.md
+++ v0.8/QUELLENMANIFEST.md
@@ -1,3 +1,11 @@
+---
+id: SOURCE-MANIFEST
+typ: dokumentationshilfe
+titel: "Quellenmanifest"
+status: arbeitsstand
+version: "0.1"
+---
+
# QUELLENMANIFEST – FewoPortal v0.7
Erstellt: 2026-10-31. 22 Markdown-Dateien im Paket.
@@ -33,3 +41,7 @@
- R01 / R00 Szenarien: `/mnt/data/FewoPortal_R01_Arbeitsentwurf/R00_Szenarien/`.
- Entscheidungen: Nutzerinterview vom 31.10.2026.
- Gitea-Stand unbekannt und nicht verändert. **Vor weiteren Änderungen aktuelle Originale anfordern.**
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
--- v0.7/R00_Szenarien/00_Szenariomatrix.md
+++ v0.8/R00_Szenarien/00_Szenariomatrix.md
@@ -4,7 +4,7 @@
titel: Buchungsszenarien und Vergleichsfälle
autor: FewoPortal Fachinterview
status: diskussionsentwurf
-version: '0.2'
+version: "0.3"
---
# R00 – Buchungsszenarien und Vergleichsfälle
@@ -13,7 +13,7 @@
| ID | Szenario | Eingang und Bindung | Typische Abweichung | Bearbeitungsstand |
|---|---|---|---|---|
-| R01 | Eigene Webseite | Anfrage → eigenes bindendes Angebot → Annahme | Hold/Angebotsfrist, eigene Zahlung, Kalenderabgleich | **In Diskussion:** [R01](R01_Eigene_Webseite.md) |
+| R01 | Eigene Webseite | Anfrage → eigenes bindendes Angebot → Annahme | Hold/Angebotsfrist, eigene Zahlung, Kalenderabgleich | **In Diskussion:** [[R00_Szenarien/R01_Eigene_Webseite|R01]] |
| R02 | Telefonisch/manuell | Manuell erfasste Anfrage → eigenes Angebot | Eingabe durch Betreiber, Kommunikationskanal | Vorgemerkt |
| R03 | Unverbindliche Portalanfrage | Portal-Anfrage → eigenes Angebot → Annahme | Fehlende Gastdaten, Portal-Kommunikation | Vorgemerkt |
| R04 | Verbindliche Portalbuchung, Vertrag durch uns | Bereits extern verbindlich | Externer bindender Preis, nachträgliche Vertragsdokumentation ohne erneute Annahme, Zahlung je Portal | Vorgemerkt |
@@ -26,4 +26,8 @@
## Ergänzung v0.2: Externe Direktbuchung
-**R08 – Destination Solutions (A3):** Bereits verbindliche Buchung, danach Vertrags-/Zahlungs-/Gastabwicklung durch Vermieter; manuelle Sperre externer Kalender, kein belegter Partner-Sync; unterschiedliche Vermittlerprovisionen je Kanal, zusätzliche Gastgebühren und einzelne Preispositionen derzeit unklar. **A6 entfällt** als Archetyp. [R08 Referenzfall](R08_Destination_Solutions.md).
+**R08 – Destination Solutions (A3):** Bereits verbindliche Buchung, danach Vertrags-/Zahlungs-/Gastabwicklung durch Vermieter; manuelle Sperre externer Kalender, kein belegter Partner-Sync; unterschiedliche Vermittlerprovisionen je Kanal, zusätzliche Gastgebühren und einzelne Preispositionen derzeit unklar. **A6 entfällt** als Archetyp. [[R00_Szenarien/R08_Destination_Solutions|R08 Referenzfall]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen]] · [[R00_Szenarien/R01_Eigene_Webseite|R01 – Eigene Webseite]] · [[R00_Szenarien/R08_Destination_Solutions|R08 – Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A4 – FeWo-direkt]]
--- v0.7/R00_Szenarien/R01_Eigene_Webseite.md
+++ v0.8/R00_Szenarien/R01_Eigene_Webseite.md
@@ -3,7 +3,7 @@
typ: geschaeftsszenario
titel: Buchung über eigene Webseite – End-to-End-Referenzfall
status: diskussionsentwurf
-version: '0.1'
+version: "0.2"
---
# R01 – Buchung über die eigene Webseite
@@ -65,3 +65,7 @@
## 6. Noch nicht entschieden
Weder genaue Zeitregeln des Holds noch die Konfliktpriorisierung, die Pflichtfelder je Schritt oder der Automatisierungsgrad sind durch dieses Szenariodokument neu entschieden. Dieses Dokument ist ein **Diskussionsentwurf**, der erst nach Betreiberprüfung in die vorhandenen Phasen- und Gate-Dokumente übernommen werden soll.
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[R00_Szenarien/00_Szenariomatrix|Szenariomatrix]] · [[00_Buchungsarchetypen|Archetypen]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04]] · [[P05/P05_Abschluss_und_Nachbereitung|P05]]
--- v0.7/R00_Szenarien/R08_Destination_Solutions.md
+++ v0.8/R00_Szenarien/R08_Destination_Solutions.md
@@ -3,7 +3,7 @@
typ: geschaeftsszenario
titel: Verbindliche Direktbuchung – Destination Solutions
status: diskussionsentwurf
-version: "0.1"
+version: "0.2"
stand: 2026-10-31
---
@@ -58,4 +58,8 @@
- **Bestätigt aus dem Betreiberinterview:** verbindliche Buchungsübermittlung, komplette weitere Vermieterabwicklung, manuelle Sperre ohne Bestätigungsbeleg, unterschiedliche Vermittlerprovisionen je Partner, Stornostaffel als genannte Vertragsbedingung.
- **Nicht verifiziert:** konkrete Ansicht/Bestätigung des Gastes, Vertragseinbeziehung der Stornoregeln, zusätzliche Gastgebühren oder Aufschläge, Preisaufschlüsselung, verwendete Destination-Solutions-Vertragsvariante, technische Verteilung/Protokollierung.
-- Weitere Nachweise erforderlich: [O00](../O00_Offene_Portalprueffaelle.md).
+- Weitere Nachweise erforderlich: [[O00_Offene_Portalprueffaelle|O00]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[R00_Szenarien/00_Szenariomatrix|Szenariomatrix]] · [[00_Buchungsarchetypen|Archetypen A1–A5]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[X01_Belegungskonflikte_und_Sperrnachweise|Sperrnachweise]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]]
--- v0.7/README.md
+++ v0.8/README.md
@@ -3,15 +3,28 @@
typ: projektindex
titel: FewoPortal Prozessarchitektur
status: arbeitsstand
-version: '0.7'
+version: "0.8"
---
-# FewoPortal – Prozessarchitektur v0.7
+# FewoPortal – Prozessarchitektur v0.8
**Status:** Fachlicher Arbeitsstand / Interview, keine Implementierungsfreigabe
**Stand:** 31.10.2026
Diese Konsolidierung führt die Version v0.6 mit **E-011 (alternative fachliche Prozessausgänge)** fort und bewahrt die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die Entscheidungen E-001 bis E-010 sowie die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
+
+
+## Start in Obsidian – Navigationsübersicht v0.8
+
+Dieses Verzeichnis als **Obsidian-Vault** öffnen. Interne Verweise sind als Obsidian-Wikilinks hinterlegt und verweisen mit Vault-relativen Pfaden auf die vorhandenen Notizen. Die **Prozesslandkarte** dient als fachlicher Ausgangspunkt; Szenarien, Gates und Teilprozesse sind gegenseitig vernetzt.
+
+**Hauptprozess:** [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01 Eingang]] → [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02 Bindung]] → [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Abwicklung]] → [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04 Aufenthalt]] → [[P05/P05_Abschluss_und_Nachbereitung|P05 Abschluss]].
+
+**Fachliche Navigation:** [[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Support]] · [[X00_Sonderprozesse|Sonderfälle]] · [[E00_Entscheidungsprotokoll|Entscheidungen]].
+
+**Vertiefungen:** [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preis- und Abrechnung]] · [[O00_Offene_Portalprueffaelle|Offene Portalfragen]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt (aktuell)]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]].
+
+> **Dateihistorie:** Die ältere FeWo-direkt-Bearbeitungsfassung wurde aus `P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md` in [[P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch|P03 – historischer Stand]] umbenannt. So sind beide Fassungen eindeutig adressierbar; die fachlich aktuelle Hauptfassung steht im Vault-Stammverzeichnis.
## Dateien
@@ -34,15 +47,19 @@
**Neue bzw. fortgeschriebene Dateien:**
-- [`00_Buchungsarchetypen.md`](00_Buchungsarchetypen.md) – A1–A5 und reale Referenzfälle
-- [`00_Portalprofile_und_Vertragsvorlagen.md`](00_Portalprofile_und_Vertragsvorlagen.md) – Profile und Vertragstypen
-- [`K01_Preisstruktur_und_Abrechnung.md`](K01_Preisstruktur_und_Abrechnung.md) – Einzel-/Sammel-/Gesamtbeträge, Provisionen, Zahlungsfluss
-- [`A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md`](A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md) – konkrete A4-Beobachtungen und rechtliche Prüffragen
-- [`R00_Szenarien/R01_Eigene_Webseite.md`](R00_Szenarien/R01_Eigene_Webseite.md) – früherer Referenzentwurf, **inhaltlich unverändert**
-- [`R00_Szenarien/R08_Destination_Solutions.md`](R00_Szenarien/R08_Destination_Solutions.md) – A3 Referenzfall
-- [`X01_Belegungskonflikte_und_Sperrnachweise.md`](X01_Belegungskonflikte_und_Sperrnachweise.md) – X07-Vertiefung
-- [`O00_Offene_Portalprueffaelle.md`](O00_Offene_Portalprueffaelle.md) – spätere Konfigurations- und Nachweispunkte
-- [`D00_Dokumentationsregel_und_Uebergabe.md`](D00_Dokumentationsregel_und_Uebergabe.md) – **Pflicht zur erneuten Dokumentenanforderung vor jedem zukünftigen Edit**
-- [`E00_Entscheidungsprotokoll.md`](E00_Entscheidungsprotokoll.md) – Beschlüsse E-012–E-021
+- [[00_Buchungsarchetypen|`00_Buchungsarchetypen.md`]] – A1–A5 und reale Referenzfälle
+- [[00_Portalprofile_und_Vertragsvorlagen|`00_Portalprofile_und_Vertragsvorlagen.md`]] – Profile und Vertragstypen
+- [[K01_Preisstruktur_und_Abrechnung|`K01_Preisstruktur_und_Abrechnung.md`]] – Einzel-/Sammel-/Gesamtbeträge, Provisionen, Zahlungsfluss
+- [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|`A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md`]] – konkrete A4-Beobachtungen und rechtliche Prüffragen
+- [[R00_Szenarien/R01_Eigene_Webseite|`R00_Szenarien/R01_Eigene_Webseite.md`]] – früherer Referenzentwurf, **inhaltlich unverändert**
+- [[R00_Szenarien/R08_Destination_Solutions|`R00_Szenarien/R08_Destination_Solutions.md`]] – A3 Referenzfall
+- [[X01_Belegungskonflikte_und_Sperrnachweise|`X01_Belegungskonflikte_und_Sperrnachweise.md`]] – X07-Vertiefung
+- [[O00_Offene_Portalprueffaelle|`O00_Offene_Portalprueffaelle.md`]] – spätere Konfigurations- und Nachweispunkte
+- [[D00_Dokumentationsregel_und_Uebergabe|`D00_Dokumentationsregel_und_Uebergabe.md`]] – **Pflicht zur erneuten Dokumentenanforderung vor jedem zukünftigen Edit**
+- [[E00_Entscheidungsprotokoll|`E00_Entscheidungsprotokoll.md`]] – Beschlüsse E-012–E-021
**Quellenintegrität:** v0.6 aus dem originalen ZIP extrahiert, da die entpackte v0.6-Verzeichnisansicht P01–P05 nicht enthielt; ergänzende Dokumente aus ihrem jeweils neuesten im Chat verfügbaren Bearbeitungsstand. **Kein direkter Schreibzugriff auf Gitea; keine Repository-Aktualisierung behauptet.** Vor jeder künftigen Änderung aktuelle Quelldokumente erneut vom Betreiber anfordern.
+
+## Verknüpfungen (Obsidian)
+
+[[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen A1–A5]] · [[R00_Szenarien/00_Szenariomatrix|Szenariomatrix]] · [[G00_Gates_und_Uebergaben|Gates und Übergaben]] · [[00_Portalprofile_und_Vertragsvorlagen|Portal- und Vertragsprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preis und Abrechnung]] · [[E00_Entscheidungsprotokoll|Entscheidungen]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]]
--- v0.7/S00_Supportprozesse.md
+++ v0.8/S00_Supportprozesse.md
@@ -3,7 +3,7 @@
typ: prozesskatalog
titel: Supportprozesse
status: arbeitsstand
-version: '0.7'
+version: "0.8"
---
# S00 – Supportprozesse (vorläufiger Katalog)
@@ -33,3 +33,7 @@
- **S02:** Kalenderverzögerung, manuelle Sperrung und fehlender Bestätigungsbeleg als reale Normalfälle. „Exportiert“ oder „im Portal eingetragen“ ist nicht gleich „partnernetzweit wirksam“.
- **S04/S07:** Kaufmännische **Einzel-, Sammel- und Gesamtbeträge** unterstützen; Gast-Servicegebühr, Vermieterprovision, Preisaufschlag, Rabatte, Zahlung und Auszahlung getrennt, soweit feststellbar. Unbekannte Zusammenhänge bleiben ungeklärt; manueller Abgleich möglich.
- **S05/S06:** unterschiedliche Vertragsvorlagen/Anlagen und Versionen je Buchungsprofil; manuelle Daten-/Dokumentenbeschaffung und Klärungsaufgaben ohne separate Portalsoftware-Workflows.
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Abwicklung]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04 Aufenthalt]] · [[X00_Sonderprozesse|Sonderprozesse]]
--- v0.7/X00_Sonderprozesse.md
+++ v0.8/X00_Sonderprozesse.md
@@ -3,7 +3,7 @@
typ: prozesskatalog
titel: Sonder- und Ausnahmeprozesse
status: arbeitsstand
-version: '0.7'
+version: "0.8"
---
# X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog)
@@ -33,4 +33,8 @@
- **X02/X04:** Zwischen *Anfrage*, *Annahme/Bestätigung*, *wirksamer Vertragsänderung/Stornierung* und *tatsächlichen Finanz-/Belegungsfolgen* unterscheiden. Ursache, Initiator, Ausführender und Verantwortlicher sind keine austauschbaren Felder. Tatsächlicher Vermieterstornogrund bleibt Vermieterstornogrund, selbst wenn ein Gast auf der Portaloberfläche die Aktion ausführt; Portalregeln und rechtliche Wirkungen gesondert prüfen. Der Betreiber hat beim FeWo-direkt-Konto bislang keine solche Änderung oder Vermieterstornierung selbst durchgeführt; unbekannte Prozesse nicht als erprobte Ist-Abläufe ausgeben.
- **X05/X06:** Fehlende Preisdetails, zusammengefasste Service-/Provisionsanteile oder abweichende Auszahlungssummen sind normale Klärungsfälle; manuelle Zuordnung und erneuter Abgleich, ohne Buchungspreis zu überschreiben.
-- **X07:** Bei Destination Solutions manuelle Kalendersperre ohne serverseitig/partnernetzweit bestätigten Sperrnachweis; bei FeWo-direkt verzögerter iCal-Import. Technische Ursache und mögliche Rechts-/Haftungsfolgen getrennt bewerten. [Ausführlicher Fachfall X07](X01_Belegungskonflikte_und_Sperrnachweise.md).
+- **X07:** Bei Destination Solutions manuelle Kalendersperre ohne serverseitig/partnernetzweit bestätigten Sperrnachweis; bei FeWo-direkt verzögerter iCal-Import. Technische Ursache und mögliche Rechts-/Haftungsfolgen getrennt bewerten. [[X01_Belegungskonflikte_und_Sperrnachweise|Ausführlicher Fachfall X07]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[X01_Belegungskonflikte_und_Sperrnachweise|X07 Belegungskonflikte]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]]
--- v0.7/X01_Belegungskonflikte_und_Sperrnachweise.md
+++ v0.8/X01_Belegungskonflikte_und_Sperrnachweise.md
@@ -3,13 +3,13 @@
typ: sonderprozess
titel: Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen
status: diskussionsentwurf
-version: "0.1"
+version: "0.2"
stand: 2026-10-31
---
# X07 – Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen
-**Geltungsbereich:** Alle Buchungsarchetypen und Vertriebskanäle. Das Dokument ist eine Vertiefung von X07 aus [X00](X00_Sonderprozesse.md), kein zusätzlicher Buchungsarchetyp.
+**Geltungsbereich:** Alle Buchungsarchetypen und Vertriebskanäle. Das Dokument ist eine Vertiefung von X07 aus [[X00_Sonderprozesse|X00]], kein zusätzlicher Buchungsarchetyp.
## 1. Reale Ursachen und Grenzen
@@ -38,4 +38,8 @@
Mögliche spätere technische Fähigkeiten: Live-API-Verfügbarkeitsabfrage, atomare Reservierung, Portalbestätigung vor Vertragsschluss, Webhooks/Audit-Logs, automatische Konfliktfrüherkennung. **Aktuell nicht als verfügbar oder implementiert voraussetzen.** Für den MVP zunächst: gut sichtbare Sperraufgaben und revisionsfähige Eigenprotokolle.
-Siehe [P01](P01/P01_Buchungseingang_und_Verfuegbarkeit.md), [E00](E00_Entscheidungsprotokoll.md), [Destination Solutions](R00_Szenarien/R08_Destination_Solutions.md).
+Siehe [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]], [[E00_Entscheidungsprotokoll|E00]], [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]].
+
+## Verknüpfungen (Obsidian)
+
+[[README|Startseite]] · [[X00_Sonderprozesse|Sonderprozesse]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]]
File diff suppressed because it is too large. Load diff
@@ -1,19 +0,0 @@
---
id: CHANGE-NOTE
typ: dokumentationshilfe
titel: "Änderungsnotiz"
status: arbeitsstand
version: "0.1"
---
# Änderungsnotiz – Portalprofile und Vertragsvorlagen (31.10.2026)
- `00_Buchungsarchetypen.md`: v0.2 → v0.3, **Abschnitt 7 neu**, frühere Abschnitte 7/8 nur umnummeriert; bestehende Archetypen/Gates unverändert.
- `A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md`: v0.1 → v0.2, Nachtrag zur **tatsächlichen Nicht-Hinterlegung** des Vertrags im Portal und zur **fehlenden Einsicht in Gastunterlagen**; bisher offene Frage präzisiert, übrige Befunde erhalten.
- `00_Portalprofile_und_Vertragsvorlagen.md`: **neu** v0.1, portable Portal-/Buchungstyp-/Herkunftsprofile, zugehörige Vertragsvorlagen/Anlagen, Konditionsquellen, Snapshot/Gates.
**Keine Produktivänderungen, kein Code.** Dateien für manuelle Übernahme in bestehende Gitea-Dokumentation; Repository-Stand konnte nicht gegen Gitea selbst verglichen werden. Änderungen vor Übernahme gegen aktuelle Git-Dateien prüfen.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[AENDERUNGSUEBERSICHT|Änderungsübersicht]]
@@ -1,59 +0,0 @@
---
id: CHANGELOG
typ: dokumentationshilfe
titel: "Änderungshistorie"
status: arbeitsstand
version: "0.9"
---
# Änderung v0.6 gegenüber v0.5
- **E-011 bestätigt:** Alternative fachliche Endergebnisse von V01: regulär abgeschlossen, ohne Buchung beendet, storniert (nach Verbindlichkeit). Keine zusätzlichen Buchungsworkflows.
- Präzisiert in `00_Prozesslandkarte.md`, `E00_Entscheidungsprotokoll.md`, `G00_Gates_und_Uebergaben.md`, `P05/P05_Abschluss_und_Nachbereitung.md` und `X00_Sonderprozesse.md`.
- `README.md` aktualisiert; YAML-Version aller bestehenden Fachdokumente konsistent auf `0.6` gesetzt.
- Offene Detailkriterien und Zustandsübergänge ausdrücklich **nicht** als entschieden dargestellt.
- Keine Löschung bestehender Inhalte, keine Änderung des Anwendungscodes. Gitea selbst wurde nicht verändert.
- `AENDERUNGEN_ZU_V0.6.diff` dokumentiert die tatsächlichen Textänderungen.
# Änderung v0.7 gegenüber v0.6 (Konsolidierung 31.10.2026)
- E-012–E-021 aus dem fachlichen Interview nachgeführt; fünf Archetypen, kein A6.
- Destination Solutions (A3) als realer Referenzfall samt Stornostaffel, manueller Sperre ohne Übernahmenachweis, provisionsabhängigen Partnerkanälen und ungeklärtem Gast-Aufschlag dokumentiert.
- FeWo-direkt (A4) um differenzierte Zahlungsdaten, iCal-Risiko, noch offene Rechts-/Gast- und Gebühreninformationen ergänzt.
- Flexible Preispositionen und Sammelbeträge, manuelle/hybride Klärung und kontrollierbare Nachweiskette in P01–P05, K00/K01, G00, X00 aufgenommen.
- Neues Portalfragenregister und verbindliche Dokumentationsarbeitsregel: aktuelle Originaldokumente künftig **vor jedem Edit erneut anfordern**.
- R01-Referenzentwurf inhaltlich unverändert übernommen, R08 neu ergänzt.
- Ausgangsdokumente unverändert gelassen; Diff und Prüfliste im Paket. Keine Gitea-Änderung/Implementierungsfreigabe.
## Änderung v0.9 gegenüber dem übergebenen v0.8-Stand (01.11.2026)
**Ausgangsbasis:** vom Betreiber erneut bereitgestelltes `Prozessarchitektur 0.7.zip` (Archiv enthält tatsächlich v0.8-Obsidian-Inhalte). Original-Archiv und sämtliche bisherigen historischen Diff-Dateien unverändert erhalten.
**Neue verbindliche Entscheidungen:** E-022–E-028 im [[E00_Entscheidungsprotokoll|Entscheidungsprotokoll]].
- **A6 neu:** Eigenbelegung, private Überlassung (Familie/Freunde), Wartung und sonstige Sperren als sechster Archetyp im gemeinsamen Vorgang; **früherer Partner-Hub-A6 bleibt gestrichen**.
- **Ein Vorgang:** Keine zusätzliche fachliche „Buchungsakte“, keine manuelle Akten-Anlageentscheidung; vorhandene Owner-/Kanalzuordnung bleibt erhalten.
- **Gäste/Leistungen bei A6:** Optionale Gästedaten, Kurabgabe, Wäschepakete, weitere entgeltliche Zusatzleistungen und Zahlungen; reine Sperren überspringen irrelevante Schritte.
- **Vorlagen/Workflows:** Automatische Profilwahl je Vermieter, Objekt, Kanal und Vorgangstyp; Buchungs-/Aufenthalts-/Reservierungsbestätigung oder ggf. keine Gastnachricht.
- **A1/A2:** Eine kanalabhängige Haltefrist (0 oder >0), zwei verschiedene Angebotstexte und Folgeabläufe, keine eigenständige Preisbindefrist im Standard; Jahres-/Saisonpreise statt dynamischem Yield-Management.
- **Restrisiko:** Doppelbuchungen pragmatisch absichern, keine uneinlösbare Garantie für externe iCal-/Partnerportale.
- **Szenario:** [[R00_Szenarien/R07_Eigenbelegung_und_Sperren|R07]] neu als A6-Referenz ausgearbeitet; [[R00_Szenarien/00_Szenariomatrix|Szenariomatrix]] aktualisiert.
- **Obsidian:** Linkziele und doppelte Dateibasis geprüft; ältere gleichnamige FeWo-direkt-Analyse unter P03 zur Eindeutigkeit umbenannt, Inhalt unverändert; [vollständiger Textdiff](AENDERUNGEN_ZU_V0.9.diff) und [[MANIFEST_v0.9|Dateimanifest]] erstellt.
**Fachliche Abgrenzung:** Die bestehenden Detaildokumente zu FeWo-direkt/Destination Solutions und vorangegangenen Entscheidungsständen bleiben erhalten. Rechtliche bzw. technische Klärungsfälle werden nicht als geprüft ausgegeben.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]] · [[QUELLENMANIFEST|Quellenmanifest]]
# Änderung v0.8 gegenüber v0.7 – Obsidian-Verknüpfungen (31.10.2026)
- Ausgangspunkt: vom Betreiber erneut hochgeladene vollständige ZIP-Fassung „v0.7 komplett.zip“. Keine Übernahme einer unbestätigten Gitea-Version behauptet.
- Interne relative Markdown-Links in eindeutige Obsidian-Wikilinks mit Vault-relativen Pfaden umgewandelt; externe Quellen-URLs unverändert.
- Verknüpfungsnavigation für sämtliche vorhandenen Markdown-Dokumente ergänzt, mit README als Startseite und P01–P05 als zusammenhängendem Phasenpfad.
- Ein bestehender Verweis auf Abschnitt 7 der FeWo-direkt-Analyse in einen Obsidian-Überschriftenlink umgewandelt.
- Zwei Dateien mit gleichem Namen und gleicher Dokumenten-ID „A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md“ identifiziert: P03-Unterordnerdatei als historische Fassung eindeutig umbenannt und historischer Identifikator abgesetzt. Die aktuelle kanonische Datei im Root bleibt am ursprünglichen Pfad.
- **Keine inhaltliche Änderung an den Buchungs-/Vertrags-/Zahlungsentscheidungen**. Die ursprünglichen Änderungs-Diffs zu v0.5–v0.7 bleiben unverändert, ein eigener Diff v0.8 wird ergänzt.
- Alle Wikilinks und Überschriftenziele programmatisch auf vorhandene Dateien/Abschnitte geprüft.
@@ -1 +0,0 @@
{}
@@ -1 +0,0 @@
{}
@@ -1,33 +0,0 @@
{
"file-explorer": true,
"global-search": true,
"switcher": true,
"graph": true,
"backlink": true,
"canvas": true,
"outgoing-link": true,
"tag-pane": true,
"footnotes": false,
"properties": true,
"page-preview": true,
"daily-notes": true,
"templates": true,
"note-composer": true,
"command-palette": true,
"slash-command": false,
"editor-status": true,
"bookmarks": true,
"markdown-importer": false,
"zk-prefixer": false,
"random-note": false,
"outline": true,
"word-count": true,
"slides": false,
"audio-recorder": false,
"workspaces": false,
"file-recovery": true,
"publish": false,
"sync": true,
"bases": true,
"webviewer": false
}
@@ -1,22 +0,0 @@
{
"collapse-filter": true,
"search": "",
"showTags": false,
"showAttachments": false,
"hideUnresolved": false,
"showOrphans": true,
"collapse-color-groups": true,
"colorGroups": [],
"collapse-display": true,
"showArrow": false,
"textFadeMultiplier": 0,
"nodeSizeMultiplier": 1,
"lineSizeMultiplier": 1,
"collapse-forces": true,
"centerStrength": 0.518713248970312,
"repelStrength": 10,
"linkStrength": 1,
"linkDistance": 250,
"scale": 1,
"close": true
}
@@ -1,208 +0,0 @@
{
"main": {
"id": "c774f5e80e5f1aff",
"type": "split",
"children": [
{
"id": "960ebc6ecc395010",
"type": "tabs",
"children": [
{
"id": "6555943309d7d5c8",
"type": "leaf",
"state": {
"type": "markdown",
"state": {
"file": "Willkommen.md",
"mode": "source",
"source": false
},
"icon": "lucide-file",
"title": "Willkommen"
}
}
]
},
{
"id": "4ed35fe710962b95",
"type": "tabs",
"children": [
{
"id": "fbb6fc5863e9c04a",
"type": "leaf",
"state": {
"type": "graph",
"state": {},
"icon": "lucide-git-fork",
"title": "Graph-Ansicht"
}
}
]
}
],
"direction": "vertical"
},
"left": {
"id": "9010d086bacb3fc3",
"type": "split",
"children": [
{
"id": "518df82bf6e16e3f",
"type": "tabs",
"children": [
{
"id": "2830f3dad07ae100",
"type": "leaf",
"state": {
"type": "file-explorer",
"state": {
"sortOrder": "alphabetical",
"autoReveal": false,
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-folder-closed",
"title": "Dateiexplorer"
}
},
{
"id": "8c0dd51cb10fd4d4",
"type": "leaf",
"state": {
"type": "search",
"state": {
"query": "",
"matchingCase": false,
"explainSearch": false,
"collapseAll": false,
"extraContext": false,
"sortOrder": "alphabetical"
},
"icon": "lucide-search",
"title": "Suchen"
}
},
{
"id": "2de788e68d3da048",
"type": "leaf",
"state": {
"type": "bookmarks",
"state": {
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-bookmark",
"title": "Lesezeichen"
}
}
]
}
],
"direction": "horizontal",
"width": 300
},
"right": {
"id": "6cfbb40ea6af3129",
"type": "split",
"children": [
{
"id": "b2c14a590e0d9133",
"type": "tabs",
"children": [
{
"id": "0313f4524384259e",
"type": "leaf",
"state": {
"type": "backlink",
"state": {
"collapseAll": false,
"extraContext": false,
"sortOrder": "alphabetical",
"showSearch": false,
"searchQuery": "",
"backlinkCollapsed": false,
"unlinkedCollapsed": true
},
"icon": "links-coming-in",
"title": "Rückverweise"
}
},
{
"id": "f4d7eb2a9aa22469",
"type": "leaf",
"state": {
"type": "outgoing-link",
"state": {
"linksCollapsed": false,
"unlinkedCollapsed": true
},
"icon": "links-going-out",
"title": "Ausgehende Links"
}
},
{
"id": "43cf722a2a5d4506",
"type": "leaf",
"state": {
"type": "tag",
"state": {
"sortOrder": "frequency",
"useHierarchy": true,
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-tags",
"title": "Tags"
}
},
{
"id": "0cea2e48849fff88",
"type": "leaf",
"state": {
"type": "all-properties",
"state": {
"sortOrder": "frequency",
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-archive",
"title": "Alle Eigenschaften"
}
},
{
"id": "5ca610ba102d1cf0",
"type": "leaf",
"state": {
"type": "outline",
"state": {
"followCursor": false,
"showSearch": false,
"searchQuery": ""
},
"icon": "lucide-list",
"title": "Gliederung"
}
}
]
}
],
"direction": "horizontal",
"width": 300,
"collapsed": true
},
"left-ribbon": {
"hiddenItems": {
"switcher:Schnellauswahl öffnen": false,
"graph:Graph-Ansicht öffnen": false,
"canvas:Neuen Canvas erstellen": false,
"daily-notes:Heutige Notiz öffnen": false,
"templates:Vorlage einfügen": false,
"command-palette:Befehlspalette öffnen": false,
"bases:Neue Base erstellen": false
}
},
"active": "fbb6fc5863e9c04a",
"lastOpenFiles": [
"Willkommen.md"
]
}
@@ -1,5 +0,0 @@
Das ist dein neuer *Vault*.
Notiere dir etwas oder, erstelle eine neue Notiz, oder probiere [die Importer-Erweiterung aus](https://help.obsidian.md/Plugins/Importer)!
Wenn du soweit bist kannst du diese Seite löschen und den Vault ganz nach deinen Wünschen und Vorstellungen gestalten.
@@ -1,55 +0,0 @@
---
id: D00
typ: arbeitsregel
titel: Dokumentationsregeln, Quellenbasis und Übergabe
status: diskussionsentwurf
version: "0.9"
stand: 2026-11-01
---
# D00 – Dokumentationspflege und Kontextübergabe
**Verbindliche Arbeitsvereinbarung des Betreibers vom 31.10.2026:**
> **Vor jeder zukünftigen Änderung oder Erweiterung der Fachdokumentation muss ChatGPT den Betreiber ausdrücklich bitten, die aktuell gültigen Originaldokumente erneut bereitzustellen.** Nicht aus Erinnerung oder einem alten Chat-ZIP heraus eine bestehende Datei überschreiben. Maßgebliche Ablage bleibt **Gitea**. Dieser Stand v0.7 ist eine **lokale konsolidierte Bearbeitungsfassung**, kein nachgewiesener Gitea-Stand.
## Vorgehen bei der nächsten Dokumentationsänderung
1. **Vor dem Editieren** aktuelle Gitea-Originaldateien bzw. aktuellen Export/Snapshot **explizit beim Betreiber anfordern** (auch wenn eine ältere Version in /mnt/data oder der Chat-Historie vorhanden ist).
2. Vergleich mit diesem Stand / bisherigen Entscheidungen, YAML-Metadaten, Dokumenten-IDs und Verlinkungen; Unterschiede und mögliche Konflikte aufzeigen.
3. Nur auf dem bestätigten Stand weiterarbeiten; bestehende Inhalte nicht still kürzen, vereinbarte Regeln nicht als unbelegte Produktfunktionen ausgeben.
4. Versionsnummern je geändertem Dokument erhöhen, Entscheidungshistorie und Prüffälle aktualisieren; Änderungen via **Diff/Manifest** nachvollziehbar machen.
5. Dateipaket zur **kontrollierten Übernahme nach Gitea** bereitstellen; keine Behauptung, Dateien seien bereits im Repository gespeichert. Unklare Rechts-/Portalfragen offen kennzeichnen.
## Quellen und Sicherungsstand der jetzigen Konsolidierung
- Ausgangsbasis Hauptdokumentation: `FewoPortal_Dokumentation_v0.6.zip` **einschließlich P01–P05, die im separaten entpackten Ordner fehlten**.
- Zusätzliche Ausgangsbasis: `FewoPortal_Portalprofile_Update/{00_Buchungsarchetypen.md v0.5, 00_Portalprofile_und_Vertragsvorlagen.md v0.1, A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md v0.4}`.
- Weiteres Referenzmaterial: `FewoPortal_R01_Arbeitsentwurf/R00_Szenarien/{00_Szenariomatrix.md, R01_Eigene_Webseite.md}`.
- Nachzutragende Betreiberangaben: Gespräch vom 31.10.2026 zu FeWo-direkt-Screenshots, Destination Solutions, fünf Archetypen, Storno, unsicheren Kalendern und flexibler Preis-/Gebührenbearbeitung.
- **Nicht verifiziert:** Ob in Gitea neuere Fassungen dieser Dateien existieren. Vor künftigen Änderungen deshalb erneute Anforderung.
## Kompakter Kontext für den nächsten Chat
FewoPortal ist eine **kleine, mandantenfähige Vermieterwebsite-/Buchungsanwendung für typischerweise 1–3 Ferienwohnungen je Vermieter, kein Marktplatz**. Ein gemeinsamer Hauptprozess V01 P01–P05, dazu V02 Vermarktung/Gästegewinnung/Gästebindung. Historischer Stand E-012: fünf Archetypen (durch E-022 um A6 erweitert): A1 eigene Webseite, A2 externe unverbindliche Anfrage, A3 externe verbindliche Buchung mit weiterer eigener Gesamtabwicklung (**Destination Solutions**), A4 externe verbindliche Buchung mit geteilter Abwicklung (**FeWo-direkt**), A5 überwiegend externe Vollabwicklung. **Früherer Partner-A6 gestrichen**; neuer A6 für private Belegung/Sperren durch E-022; Partnerherkunft nur bei Provisionsrelevanz. Ein Vorgang/eine Akte. Externer Preis und beim Vertragsschluss vereinbarte Bedingungen bleiben maßgeblich, spätere Dokumente keine stillen neuen Pflichten. Unterschiedliche/versionierte Vorlagen pro Kanal/Buchungstyp. Portale liefern unterschiedlich vollständige Daten; **manuelle Bearbeitung und Sammel-/Gesamtpreise** sind konstitutive Fachfunktionen. Gast-Mietforderung, externe Gastgebühr, Vermieterprovision, Auszahlung und Zahlung getrennt. Kein Erfinden unbekannter Gebührenanteile. Verfügbarkeit extern nicht garantiert: FeWo-direkt verzögerter iCal-Import, Destination Solutions manuelles Sperren ohne verlässlichen Portal-/Partnernachweis; Doppelbuchungen möglich, deshalb Ausnahmeprozess und Belegkette. Nicht bekannte Vertrags- und Portalfragen im O00-Prüffallregister. **Vor der nächsten Dokumentbearbeitung aktuelle Gitea-Fassung explizit erfragen.**
## Übergabe nach v0.9 – aktualisierter Stand 01.11.2026
**Aktualisierungsbasis 01.11.2026:** Vom Betreiber ausdrücklich erneut übergeben: `Prozessarchitektur 0.7.zip`. Trotz des Dateinamens enthielt das Archiv bereits die fachlichen und Obsidian-Inhalte von **v0.8**, einschließlich bestehender historischer Diff-Dateien und Vault-Einstellungen. **Es wurde nicht angenommen**, dass damit der Live-Gitea-Stand automatisch abgeglichen ist. Das Archiv blieb unverändert, v0.9 ist eine neue Kopie.
**Aktueller Fachstand E-022–E-028:** Sechs Archetypen A1–A6; A6 neu für Eigenbelegung, private Überlassung und sonstige Sperren, **nicht** den gestrichenen Partner-Hub. Gemeinsamer Vorgang statt zusätzlich angelegter Buchungsakte. A6 kann Gäste, Kurabgabe, Wäschepakete und Zahlungen enthalten. Vertrags-/Buchungs-/Reservierungsbestätigung anhand von Kanal und Vorgangsart; bei reinem Block optional ohne Dokument. Ein konfigurierbarer Hold (0 oder >0) bestimmt den eigenen Angebotsweg; keine gesonderte Preisbindefrist im MVP, überwiegend Jahrespreise. Externes Doppelbuchungsrisiko wird pragmatisch behandelt. Vorhandene Owner-Zuordnung ist bereits implementiert; Coding-Agent muss zuerst den Bestand prüfen.
**Weitergeltende Regel:** **Vor jeder neuen Bearbeitung** die aktuell gültigen Originaldateien vom Betreiber erbitten; keine spätere automatisierte Veränderung eines alten ZIP oder Gitea-Repositories vorgeben. Fachliche Fortschreibungen dürfen alte Beschlüsse nicht still tilgen; überholte ältere Aussagen explizit markieren.
**Obsidian:** Wikilinks in jeder aktiven Notiz, eindeutige Dateibasen bzw. qualifizierte Pfade; Links und YAML-Header nach jedem Update validieren. `AENDERUNGSUEBERSICHT.md` dokumentiert Änderungen, unveränderte historische Dokumente bleiben erhalten.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[E00_Entscheidungsprotokoll|Entscheidungen]] · [[QUELLENMANIFEST|Quellenmanifest]] · [[AENDERUNGSUEBERSICHT|Änderungshistorie]]
## Technische Dokumentationsregel v0.8 – Obsidian
- Die Dokumentationsbasis wird als Obsidian-Vault genutzt; Querverweise zwischen Markdown-Dateien bevorzugt als eindeutige Wikilinks mit Pfad und Anzeigename erstellen.
- Nach jeder Dateiänderung interne Links, Überschriftenverweise und vorhandene Zielnotizen prüfen; keine Phantom-Links oder versehentliche Duplikate erzeugen.
- **Unverändert bindend:** Vor der nächsten Dokumentänderung die dann aktuelle Gitea-Originalfassung beim Betreiber ausdrücklich erneut anfordern.
@@ -1,83 +0,0 @@
---
id: E00
typ: entscheidungsprotokoll
titel: Entscheidungsprotokoll
status: arbeitsstand
version: "0.9"
---
# E00 – Entscheidungsprotokoll
**Stand:** 01.11.2026 (E-022–E-028 ergänzt; ältere Beschlüsse historisch erhalten). Entscheidungen sind fachliche Betreiberfestlegungen, keine bestätigte Rechtsprüfung oder Implementierungsfreigabe.
| ID | Status | Entscheidung |
|---|---|---|
| **E-001** | Beschlossen (vorige Interviewrunde) | Gästebindung/Marketing sind ein eigenständiger Wertschöpfungsprozess V02; Feedbackabwicklung verbleibt in V01. **Präzisierung E-008:** V02 wirkt auch vor V01 (Gästegewinnung) und heißt künftig „Vermarktung, Gästegewinnung und Gästebindung“. |
| **E-002** | Beschlossen / durch Betreiber bestätigt | Es gibt **einen generischen Buchungsprozess** mit konfigurierbaren Auslösern und Aktivitäten je Kanal; FewoPortal ist führendes Verwaltungssystem. Bei externer Ausführung braucht es nachvollziehbare Übergaben/Gates. |
| **E-003** | Beschlossen / durch Betreiber bestätigt | **Eigenes Angebot ist für uns bindend** und befristet. Rechtzeitige Annahme führt ohne zweite Betreiberzustimmung zum Vertrag. Ohne rechtzeitige Annahme verfällt das Angebot; die **eigene** Vorreservierung ist nach Sicherheitsprüfung freizugeben. |
| **E-004** | Beschlossen / durch Betreiber bestätigt | Eine **Portal-Direktbuchung ist bereits verbindlich**; ein eigener Vertrag wird ggf. zur bestehenden Buchung erstellt und versandt, aber **nicht erneut offiziell angenommen**. Der Portalpreis ist als vereinbarter Buchungspreis zu übernehmen. |
| **E-005** | Beschlossen / durch Betreiber bestätigt | Bei **vollständiger Portalabwicklung** übernimmt FewoPortal nicht zusätzlich Vertrag, Mahnung oder Storno; es benötigt insbesondere Gästedaten und Informationen für lokale Betreuung und örtliche/gesetzliche Pflichten. |
| **E-006** | Arbeitsmodell – noch nicht abschließend einzeln genehmigt | Fünf Phasen P01–P05 gemäß v0.3/v0.4 (vom Betreiber ursprünglich vorgeschlagen), schärfere Phasennamen und Untergliederungen sind Vorschläge. |
| **E-007** | Beschlossen / Betreiberpräzisierung | Produktfokus: Eigene Website als zentraler Einstieg für einen Vermieter mit typischerweise **1–3 Ferienwohnungen**; mehrere Mandanten möglich; **kein Marktplatz**. Primär Gästegewinnung, Buchung und weitgehend automatisierte Abwicklung, nicht umfangreiche Haus-/Objektverwaltung. |
| **E-008** | Beschlossen / Betreiberpräzisierung | V02 umfasst **Multichannel-Marketing und Gästegewinnung** (eigene Website, Social Media, Print, externe Portale) **sowie CRM, Stammkundenmanagement und Loyalty**. Damit ist V02 nicht nur Folgeprozess, sondern auch vorgelagert. Feedback/Bewertungen bleiben in V01. Detaillierung von V02 folgt später. |
| **E-009** | Beschlossen / Betreiberpräzisierung | Buchungsbezogene Objektaufgaben (Reinigung, Schlüsselübergabe, lokale Leistungen) im Hauptprozess **einfach und integriert** behandeln. Die fachliche Existenz von Supportprozessen bedeutet **keine Pflicht zu eigenen Verwaltungsmodulen**. Erweiterte Objektverwaltung, Dienstleister-/Personalplanung und Vermittlungsagentur-Funktionen derzeit nicht priorisieren; Erweiterbarkeit offenhalten. |
| **E-010** | Grundsatz bestätigt / Details offen | Der Hauptwertschöpfungsprozess V01 endet fachlich mit Abschluss der Buchungs- und Leistungserbringung. Danach weiterlaufende Forderungs-, Schaden- oder Streitfälle sind **an zuständige Folgeprozesse zu übergeben**, anstatt den gesamten Buchungsprozess künstlich offen zu halten. Zusammenhang zur Buchung, Zuständigkeit und Übergabe müssen nachvollziehbar bleiben. Das genaue Abschluss-Gate ist noch zu spezifizieren. |
| **E-011** | Beschlossen / Detailkriterien offen | V01 kann mit **unterschiedlichen fachlichen Endergebnissen** enden: regulär abgeschlossen (erbrachte Leistung), ohne Buchung beendet (z. B. abgelehnte/abgelaufene Anfrage bzw. nicht angenommenes Angebot) oder storniert (nach entstandener Verbindlichkeit, soweit zutreffend). Diese Ergebnisse sind **alternative Ausgänge eines einzigen generischen Prozesses**, keine zusätzlichen Buchungsworkflows. Nachweise, Historie und erforderliche Folgeaktivitäten/Übergaben bleiben erhalten. Die vollständige Taxonomie und konkrete Zustandsübergänge sind noch zu spezifizieren. |
## Offene Grundsatzentscheidungen
- Konkrete Mindestkriterien für P05-Abschluss, Übergabenachweis und Zuständigkeit der Folgeprozesse; **Detailkriterien** und die vollständige Taxonomie der alternativen Prozessausgänge (E-011).
- Detailschnitt der buchungsbezogenen Objektaufgaben zu P04/P05; Umfang späterer buchungsunabhängiger Funktionen.
- Exakter Mindest-Nachweis und Datenumfang je externem Portalprofil.
## Rechts- und technische Prüfpunkte (nicht als Beschluss ausgeben)
- Rechtssicherheit von elektronischem Annahmelink und Button, Kundendokumentation/AGB/Informationspflichten (u. a. § 312j BGB, soweit anwendbar).
- § 150 BGB: Verspätete bzw. veränderte Annahme ist nicht automatisch verbindliche Annahme des alten Angebots; § 149 BGB als möglicher Sonderfall beachten.
- Portalverträge und Übermittlung des eigenen Vertrags dürfen kein stilles Abweichen von extern vereinbarten Preisen und Konditionen bewirken.
- Hold-Ablauf, race conditions, doppelte Belegung, iCal-Verzögerungen und revisionssichere Dokumentation prüfen.
**Normquellen:** [§145](https://www.gesetze-im-internet.de/bgb/__145.html), [§146](https://www.gesetze-im-internet.de/bgb/__146.html), [§148](https://www.gesetze-im-internet.de/bgb/__148.html), [§149](https://www.gesetze-im-internet.de/bgb/__149.html), [§150](https://www.gesetze-im-internet.de/bgb/__150.html), [§312j BGB](https://www.gesetze-im-internet.de/bgb/__312j.html).
## Dokumentationsregel (Arbeitsvereinbarung)
Die bestehende Gitea-Dokumentation ist die führende Ablage. Es gibt **eine aktuelle Markdown-Datei je Thema**, P01–P05 dürfen jeweils mehrere Unterdokumente enthalten. Bei **neuen und fachlich aktualisierten Markdown-Dateien** einen knappen YAML-Header (`id`, `typ`, `titel`, `status`, `version`) verwenden. Bestehende Abschnitte bei Fortschreibungen nicht still kürzen oder löschen; fachliche Entscheidungen mit ID verknüpfen und Änderungen per Git-Diff kontrollieren. **Keine implizite Freigabe von Implementierung oder Go-live.**
## Ergänzende Beschlüsse und Prüfstände vom 31.10.2026 – Konsolidierung v0.7
Die folgenden IDs ergänzen **E-001–E-011**. Betreiberangaben und die daraus fachlich bestätigten Regeln sind von ausstehenden Portal- und Rechtsprüfungen zu unterscheiden.
| ID | Status | Festlegung |
|---|---|---|
| **E-012** | **Historischer Beschluss – Partner-A6 entfällt; vgl. E-022** | **Zum damaligen Stand fünf Buchungsarchetypen A1–A5** (durch E-022 für eine **andere** A6-Bedeutung fortgeschrieben). Der zuvor verwendete A6-Eintrag („Hub/Partnervermittlung“) entfällt als Archetyp. Partnerherkunft ist nur als optionales kaufmännisches Merkmal zu erfassen, soweit sie etwa Provisionssatz oder Auswertungen beeinflusst; keine eigenständige Vermittlungskettenlogik. |
| **E-013** | **Beschlossen** | **Vertrags-/Dokumentenprofil je Vermieter/Objekt/Portal/Buchungsart**, inklusive unterschiedlicher Vorlagen und Anlagen, Versionierung und unverändertem Buchungs-/Konditionsstand. Nach externer Direktbuchung **keine zweite Annahme und keine einseitigen neuen Gastpflichten**. Die tatsächliche vorvertragliche Einbeziehung bleibt Prüffall. |
| **E-014** | **Beschlossen** | Die Informationsbeschaffung kann je Portal und Feld **automatisch, manuell oder gemischt** erfolgen. Fehlen Einzelbeträge, dürfen Buchungen mit **Gesamtpreis oder Sammelpositionen** bearbeitet werden; fehlende Daten sind ausdrücklich unbekannt, nicht null und nicht geschätzt. |
| **E-015** | **Beschlossen** | **Gast-Mietforderung, ggf. gesonderte Gast-Servicegebühr, Vermieterprovision/-gebühr, Zahlungsraten, Auszahlung und Rabatte** sind fachlich getrennte Sachverhalte, auch wenn ein Portal Beträge zusammenfasst. Flexible kaufmännische Positionen, spätere manuelle Zuordnung/Aufteilung, Nachweis und Differenzabgleich sind erforderlich; ursprüngliche Portalwerte bleiben erhalten. **Keine doppelte Zählung** zusammengefasster Teil- und Gesamtbeträge. |
| **E-016** | **Beschlossen / Referenzbetrieb** | **Destination Solutions = A3**, keine Ergänzung „A6“: bereits extern verbindliche Buchung, nachfolgende Vertrags-/Zahlungs-/Aufenthaltsabwicklung durch Vermieter. Partnerherkunft kann unterschiedliche **Vermittlerprovisionen zu Lasten des Vermieters** bewirken, aber **keine nachträgliche Belastung des Gastes**. Ob das Portal selbst eine zusätzliche Gastgebühr erhebt oder den Endpreis erhöht, bleibt ungeklärt. |
| **E-017** | **Bestätigte Betreiberangabe, Wirksamkeit ungeklärt** | Bei Destination Solutions ist folgende **sechsstufige Stornostaffel** genannt: mindestens 60 Tage vorher 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, 11 Tage oder weniger 100 % jeweils vom „Mietpreis“. **Nicht nachgewiesen** ist, ob diese Staffel im Portal bereits vor Buchung transparent gemacht und wirksam einbezogen wird; die Preisbasis („Mietpreis“) ist zu klären. |
| **E-018** | **Beschlossen / Risiko festgehalten** | **Externe Verfügbarkeit ist nicht allein durch korrekte Pflege des FewoPortal-Kalenders sicher**: FeWo-direkt importiert iCal nur zeitverzögert; beim verwendeten Destination-Solutions-Zugang erfolgt **manuelle Sperrung ohne bestätigtes Partnernetz-Sync und ohne verwertbaren Sperrbeleg**. Vorgang „Sperre veranlasst / Zielportal erkennbar / partnernetzweit wirksam“ getrennt; letzteren Zustand niemals ohne Nachweis behaupten. |
| **E-019** | **Beschlossen** | Buchungsänderung, Storno und Doppelbuchung sind **Teil-/Sonderprozesse derselben Akte**. Auslösende Ursache, Initiator, ausführender Akteur, Zuständigkeit, verbindliche Wirksamkeit sowie Kalender-/Vertrags-/Finanzfolgen getrennt führen. Technische Stornierung durch den Gast ersetzt nicht die wahrheitsgemäße Einordnung einer Vermieterursache; Fremdportalregelungen und Rechtslage fallbezogen prüfen. |
| **E-020** | **Beobachteter A4-Iststand** | In einer FeWo-direkt-Buchung sind **aggregierter Übernachtungspreis, Rabatt, Sammelgebühren, Gastgesamtbetrag, portalbezogener Abzug, Auszahlungsvorschau und Ratenstatus** einsehbar. **Nicht belegt** sind Einzelpreise, Gebührenzusammensetzung, durchgängige Exporte und alle tatsächlich vom Gast akzeptierten Unterlagen. Widersprüchliche Auszahlungsangaben bleiben offener Prüffall. |
| **E-021** | **Verbindliche Dokumentationsarbeitsregel** | **Vor jeder künftigen Dokumentänderung/Erweiterung die aktuell gültigen Originaldateien erneut explizit beim Betreiber anfordern**. Gitea bleibt führende Ablage; ältere lokale Chat-/ZIP-Kopien allein reichen für spätere Änderungen nicht. Änderungen ausschließlich auf bestätigter Basis, mit Versionsfortschreibung, Bestandsbewahrung, Diff und Quellvermerk. |
**Nicht beschlossen:** Dass technische Portalprobleme automatisch rechtlich fehlendes Verschulden beweisen; dass eine 10-Minuten-Freigabe heute bei den genannten Portalen möglich ist; dass alle Portale gleiche Preis-/Gast-/Zahlungsdaten bereitstellen; dass nachträglich versandte Stornobedingungen wirksam werden. Solche Aussagen bleiben Prüffälle.
**Weitere Fachkonzepte:** [[00_Buchungsarchetypen|Archetypen A1–A5]], [[00_Portalprofile_und_Vertragsvorlagen|Portal-/Vertragsprofile]], [[K01_Preisstruktur_und_Abrechnung|Flexible kaufmännische Positionen]], [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]], [[O00_Offene_Portalprueffaelle|offene Portalprüffälle]].
## Ergänzende Betreiberentscheidungen vom 01.11.2026 – v0.9
Diese Beschlüsse/Präzisierungen aus dem Fachinterview vom **01.11.2026** gelten zusätzlich zu den älteren Einträgen. Wo sich ältere Zusammenfassungen widersprechen, gehen die späteren Entscheidungen vor; die historischen Einträge bleiben aus Nachvollziehbarkeitsgründen bestehen.
| ID | Status | Festlegung |
|---|---|---|
| **E-022** | **Beschlossen; Fortschreibung E-012** | **Sechs Archetypen A1–A6**. Der früher gestrichene **Partnervermittlungstyp A6 bleibt gestrichen**; die frei gewordene Kennung **A6 bezeichnet nun Eigenbelegung, private Überlassung und sonstige Sperren**. Vermittler-/Partnerherkunft bleibt nur kaufmännisches Merkmal, kein eigenständiger Workflow. |
| **E-023** | **Beschlossen** | **Ein gemeinsamer Vorgang als fachliche Klammer** vom ersten relevanten Eingang bis zum Abschluss. Eine eigens anzulegende „Buchungsakte“ ist **kein zusätzliches fachliches Objekt oder manueller Arbeitsschritt**. Jeder A1–A6-Vorgang hat nur die tatsächlich nötigen Aktivitäten. Belegung/Zeitraum ist fachlich unterscheidbar und mit dem Vorgang verknüpft. |
| **E-024** | **Beschlossen** | **A6 kann Gäste und entgeltliche Zusatzleistungen haben:** Familie/Freunde, optional Teilnehmerdaten, Kurabgabe soweit geschuldet, Wäschepakete, andere Leistungen und Zahlungen. Eine reine Wartungssperre benötigt weder Gast noch Mietvertrag. Grund, Quelle und Änderungen der Sperre dokumentieren; gemeinsame Änderungs-/Stornofunktionen wiederverwenden. |
| **E-025** | **Beschlossen** | **Angebotsart und Dokumentenprofil bestimmen den Ablauf:** je Kanal/Vermieter/Objekt/Vorgangstyp passendes Angebot, ggf. Buchungs-/Aufenthalts-/Reservierungsbestätigung, Anlagen und internen Ablauf auswählen; versioniert und mit geltendem Konditionsstand. Kein separater portalabhängiger Workflow. |
| **E-026** | **Beschlossen – MVP-Vereinfachung** | **Eine konfigurierbare Haltefrist** pro relevantem Anfragekanal (z. B. 0/24/48/72 h; Werte nur Beispiele). Hold > 0: soweit möglich abgestimmte Belegungssicherung + zeitlich passendes verbindliches Buchungsangebot; Hold = 0: ohne Belegungssperre nur Preis-/Verfügbarkeitsauskunft unter Vorbehalt, bei Buchungswunsch erneute Verfügbarkeitsprüfung und Bestätigung. **Keine separate Preisbindefrist als Standard**; Preise überwiegend kalenderjahresbezogen, keine dynamischen Buchungsklassen/Yield-Optimierung. Rechtssichere Vorlagen gesondert prüfen. |
| **E-027** | **Beschlossen – Pragmatismus / Risikoakzeptanz** | Externe iCal-/Portalverzögerungen erzeugen ein Restrisiko. Nach Betreibererfahrung **zwei Doppelbuchungen in rund 20 Jahren**. Deshalb klare, schlanke manuelle/automatische Sperr- und Klärungsaufgaben statt überdimensionierter Risikosteuerung; eine externe Live-Verfügbarkeitsprüfung vor Abschluss wäre ideal, ist aber **nicht als vorhandene Funktion zu unterstellen**. Eigene von FewoPortal kontrollierte Abschlüsse prüfen unmittelbar vor Bestätigung erneut, soweit nötig. |
| **E-028** | **Ist-Funktion bestätigt / Prüfauftrag** | Die **Zuordnung eingehender Buchungen zum auslösenden Portal („Owner“) ist in der bestehenden Anwendung bereits implementiert**. Der Coding-Agent soll vorhandene Vorgangs-, Buchungs-, Kalender-, Dokumenten- und Sperrfunktionen **zunächst analysieren und wiederverwenden**, nicht eine neue Owner-Zuordnung oder parallele Buchungsakten implementieren. Keine pauschale Freigabe für End-to-End-Entwicklung ohne Gap-Analyse. |
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen]] · [[G00_Gates_und_Uebergaben|Gates]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]]
+51
View File
@@ -0,0 +1,51 @@
---
id: E00
typ: entscheidungsregister
titel: Gültige fachliche Entscheidungen
status: fachlicher-arbeitsstand
version: "0.10"
---
# Gültige fachliche Entscheidungen
**Gültige Betreiberfestlegungen**, keine technische Implementierungs- oder juristische Freigabe. Die Kennungen dienen dem Auffinden und sind keine Aufforderung, dieselben Regeln in allen Dokumenten erneut zu erklären. Versions- und Änderungshistorie wird **in Git** geführt.
| ID | Gegenstand | Gültige Regel |
|---|---|---|
| E-001 | Feedback und Gästebindung | Dank, Feedback und Bewertung gehören zu V01/P05; die langfristige Gästebindung zu V02. |
| E-002 | Gemeinsamer Prozess | Ein führender FewoPortal-Vorgang; kanalabhängige Tätigkeiten und Verantwortlichkeiten statt getrennter Portalsoftwareprozesse. |
| E-003 | Eigenes bindendes Angebot | Mit wirksamem Hold befristet bindendes Angebot; rechtzeitige wirksame Annahme führt ohne zweite Entscheidung zum Vertrag. |
| E-004 | Externe Direktbuchung | Bereits verbindlich; Portalpreis/Konditionen übernehmen, keine zweite Annahme und keine stillen nachträglichen Pflichten. |
| E-005 | Weitgehende Portalabwicklung | Nicht zusätzlich Vertrag, Mahnung oder Storno durchführen, wenn tatsächlich extern verantwortet; erforderliche lokale Daten/Aufgaben bleiben. |
| E-006 | V01-Phasen | Gemeinsame Prozesshierarchie P01–P05; Aktivitäten sind abhängig vom Fall und zeitlich nicht zwingend strikt sequenziell. |
| E-007 | Produktfokus | Kleine Vermieter mit meist 1–3 Ferienwohnungen; mandantenfähig, kein Marktplatz, keine umfassende Agenturverwaltung. |
| E-008 | V02 | Eigenständiger Prozess für Multichannel-Vermarktung, Nachfrage, CRM, Wiederbuchung und Loyalty, vor und nach V01. |
| E-009 | Supportfunktionen | Schlüssel, Reinigung, lokale Leistungen im Buchungsvorgang integrieren; daraus folgt kein eigenständiges Modul. |
| E-010 | Folgeangelegenheiten | Nach erfülltem Aufenthalt V01 abschließen dürfen; offene Ansprüche/Konflikte verantwortlich und nachvollziehbar übergeben. |
| E-011 | Prozessausgänge | Regulär erfüllt, ohne Buchung beendet, wirksam storniert; bei A6 auch Aufhebung/Ende interner Sperre. Keine parallelen Endworkflows. |
| E-012 | Partnervertrieb | Partner-/Hub-Herkunft ist kein Buchungsarchetyp, sondern nur bei Bedarf ein kaufmännisches/analytisches Merkmal. |
| E-013 | Vertragsprofile | Vorlagen und Anlagen nach Vermieter, Objekt, Kanal und tatsächlicher Buchungs-/Vorgangsart; Version/Konditionsstand sichern. |
| E-014 | Informationsbeschaffung | Automatisch, manuell oder kombiniert; Gesamtpreis/Sammelposition zulässig; unbekannt ist nicht 0 oder geschätzt. |
| E-015 | Finanztrennung | Gastmiete, Gast-Servicegebühr, Vermieterprovision, Rabatte, Zahlungen und Auszahlung trennen; Originalwerte behalten; keine Doppelzählung. |
| E-016 | Destination Solutions | Für den beschriebenen Vermieterzugang **A3**: bindender Abschluss extern, danach Vermieterabwicklung; Partnerprovision kein Gastaufschlag ohne Vereinbarung. |
| E-017 | Destination-Storno | Vom Betreiber genannte Staffel 0/35/50/70/90/100 % nach Tagen; tatsächliche Einbeziehung, Berechnungsbasis und Wirksamkeit sind offene Prüfungen. |
| E-018 | Belegungssperren | Externer Export, Zielportal-Sichtbarkeit und nachgewiesene Wirksamkeit getrennt betrachten; keine nicht belegte Partnernetz-Bestätigung. |
| E-019 | Änderung/Storno | Ursache, Initiator, Ausführender, Entscheidung, rechtliche Wirksamkeit und Vertrags-/Kalender-/Finanzfolgen unterscheiden. |
| E-020 | FeWo-direkt-Daten | Eine Gastbuchung liefert teilaggregierte Beträge, Raten und Auszahlungsvorschauen; keine unterstellte vollständige Preiszerlegung/Exportfähigkeit. |
| E-021 | Pflege der Spezifikation | Vor künftigen Änderungen aktuelle Originale vom Betreiber anfordern; fachlichen gültigen Stand konsistent halten und Git-Diff nutzen. |
| E-022 | Sechs Archetypen | A1–A5 plus **A6 = Eigenbelegung, private Überlassung und sonstige Sperren**. |
| E-023 | Einheitlicher Vorgang | Jeder qualifizierte Geschäftsfall ein Vorgang, keine separat anzulegende Buchungsakte; Belegungswirkung davon unterscheidbar. |
| E-024 | A6 und Nebenleistungen | Je Anlass Gäste, Wäsche, Kurabgabe und Zahlungen möglich, auch bei Mietpreis 0; reine Sperre ohne Gast/Vertrag. |
| E-025 | Dokumente steuern den Ablauf | Zutreffendes Vorlagen-/Dokumentenprofil (inkl. Bestätigungen) nach tatsächlichem Vorgang und Kanal wählen; konkrete Nachweise versionieren. |
| E-026 | Schlanker Angebotsweg | **Haltefrist als einzige Standardfrist**: >0 bindendes Angebot passend zur Belegung, 0 Auskunft unter Vorbehalt mit erneuter Prüfung vor Bestätigung; keine separate Preisbindefrist. |
| E-027 | Risikopragmatismus | Seltene Doppelbuchungen ernst nehmen, aber keine überdimensionierte Verfügbarkeits-/Risikoengine; reale Portalverzögerungen berücksichtigen. |
| E-028 | Vorhandene Owner-Zuordnung | Bereits implementierte Herkunfts-/Owner-Erkennung wiederverwenden; zunächst Ist-Abgleich statt neuer paralleler Vorgangsstruktur. |
| **E-029** | **Mandantenstandard/Vererbung** | **Globale Einstellungen gelten je Vermieter**; kanalindividuelle Werte überschreiben nur, wenn ausdrücklich gesetzt. Nicht gesetzt ≠ 0/aus/manuell. |
| **E-030** | **Automatisierung je Kanal** | Eigener Abschluss nach Hold = 0 erfolgt nach erneuter Verfügbarkeitsprüfung **automatisch oder manuell nach wirksamer Einstellung**. Bereits bestehende verbindliche Buchungen benötigen keine zweite Freigabe. |
| **E-031** | **Dokumentationsstruktur** | Fachliche Dokumente bilden eine hierarchische Prozesslandschaft und den **einen gültigen Stand** ab; wenige relevante relative Links, keine historischen Ergänzungsschichten; Änderungen in Git. |
## Grenze fachlicher Freigabe
Noch nicht entschieden sind insbesondere die vollständigen Abschluss-/Statuskriterien, rechtliche Einbeziehung konkreter Drittportalbedingungen, exakte örtliche Meldedaten und die tatsächliche Funktion einzelner Portalschnittstellen. Ein Coding-Agent darf technische Lösungen selbständig vorschlagen, **fachlich offene Regeln aber nicht als beschlossen ausgeben**.
[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [Offene Prüfungen](Offene_Fragen.md)
@@ -1,71 +0,0 @@
---
id: G00
typ: gate-modell
titel: Gate- und Übergabemodell
status: arbeitsstand
version: "0.9"
---
# G00 – Gate- und Übergabemodell (Arbeitsstand)
## Grundregel
FewoPortal bleibt das führende Buchungsverwaltungssystem. **Extern ausgeführt** bedeutet nicht **nicht existent**. An Übergaben sind Status, Herkunft, Verantwortung und gegebenenfalls Nachweis festzuhalten. Die notwendigen Daten richten sich nach dem tatsächlichen Folgeprozess.
## Zwei Gate-Arten
1. **Zustands-Gate:** Belegt einen fachlichen Zustand, z. B. `Buchung verbindlich` durch rechtzeitige eigene Angebotsannahme oder nachgewiesene verbindliche Portalbuchung.
2. **Aktivitäts-Gate:** Benötigt Daten/Nachweise für eine konkrete Handlung, z. B. Anschrift für einen von uns zu erstellenden Vertrag oder Anreisekontakt für lokalen Service.
## Standardfelder je Gate (noch nicht technisch festgelegt)
- Trigger / eingehendes Ereignis
- Erwarteter fachlicher Zustand oder Aktivität
- Benötigte Informationen (Pflicht und optional nach Kanal-/Aktivitätstyp)
- Quelle, Portalreferenz, Beleg/Nachweis und Aktualitätsstand
- Verantwortlich: wir / Portal / Gast / Dienstleister
- Ergebnis: intern erfüllt / extern erfüllt / nicht anwendbar / offen oder Konflikt
- Folgeaktivität bei Erfolg, fehlenden Daten oder Widerspruch
## P02 – Beispiel-Gates
- **GA:** Bindendes eigenes Angebot mit fixiertem Konditionsstand und Frist versendet.
- **GB:** Gast hat dieses Angebot fristgerecht angenommen und dies ist nachgewiesen → verbindlich.
- **GC:** Portal hat Verbindlichkeit bereits hergestellt und diese wird nachgewiesen → verbindlich, ohne erneute Annahme.
- **GD:** Erforderliche Gästedaten für lokale Abwicklung liegen vor; darf auch nach GC offen sein.
- **GE:** Externer Portalprozess vollständig verantwortet: für lokale Abwicklung notwendige Informationen vorhanden, extern zuständige Vorgänge ausgewiesen.
## P05 – Abschluss- und Folgeprozess-Übergabe (Grundsatz E-010)
- **Abschluss V01:** Fachliche Buchungs- und Leistungserbringung ist beendet; ein ausstehender Anspruch allein blockiert den Prozessabschluss nicht, wenn dessen Bearbeitung wirksam an einen verantwortlichen Folgeprozess übergeben wurde.
- **Übergabe:** Benötigt mindestens Referenz zur ursprünglichen Buchung, Beschreibung des offenen Sachverhalts, verantwortliche Stelle und nachweisbaren Übergabestatus. Detailumfang und Automatismus bleiben offen.
- **Status:** Buchungsprozess abgeschlossen und Folgeprozess offen sind gleichzeitig möglich. Die technische Ausgestaltung der Akte ist noch nicht beschlossen.
## Alternative End-Gates V01 (E-011)
Je nach tatsächlichem Verlauf weist V01 ein eigenes fachliches Endergebnis aus: **regulär abgeschlossen**, **ohne Buchung beendet** oder **storniert** (nach Verbindlichkeit). End-Gates sichern die jeweils zutreffenden Nachweise und gegebenenfalls erforderliche Folgeübergaben; nicht erforderliche Zwischenphasen werden nicht künstlich ausgeführt. Vollständiger Ergebnis- und Nachweiskatalog bleibt offen.
## Noch offen
Detailkriterien für das P05-Abschlussgate und die Detailbedingungen der Storno-/Abbruch-Ausgänge; konkrete Gatepflichten je Portal; Identität und Nachweisformat; Konflikt- und Synchronisationsfälle; Umfang externer Statusmeldungen; manueller Freigabepunkt.
## Ergänzende Gates / Informationsbewertung v0.7 (E-013 bis E-020)
- **G1/P01 – Externe Belegung:** Zeitpunkt und Quelle von Kalenderexport, manueller Sperre oder Meldung dokumentieren. **Veranlasst**, **im Zielportal beobachtet** und **in nachgelagerten Kanälen nachgewiesen** sind verschiedene Zustände; letzterer kann unbekannt bleiben.
- **G2/P02 – Konditionsstand:** Extern verbindlicher **Gastgesamt-/Mietpreis** kann hinreichend belegt sein, auch wenn Tages-/Einzelpreise fehlen. Portalkonfiguration, Buchungssnapshot, gastseitig tatsächlich vereinbarter Konditionsstand und nachträglich versandte Unterlagen getrennt. Fehlt ein für Vertragsdokumentation erforderlicher Beleg, nur die konkrete Tätigkeit zur Klärung vorsehen; bereits bindende Buchung nicht rückwirkend entwerten.
- **G3/P03 – Kaufmännische Teilinformationen:** Einzelposition, Sammelposten und Gesamtbetrag zulässig; Quelle, Betrag, Währung, zugeordneter Zahler/Empfänger (oder **ungeklärt**), Status und mögliche Doppelzählung prüfen. Gast-Mietforderung ≠ Gast-Portalservicegebühr ≠ Vermieterprovision ≠ Auszahlung. Aufklärung je Tätigkeit; fehlende Provisionsdetails blockieren beispielsweise nicht automatisch die Anreisevorbereitung.
- **G3/P03 – Zahlung:** **Fällig laut Zahlungsplan**, **laut Portal bezahlt**, **Auszahlung angekündigt** und **tatsächlicher Bankeingang** sind unabhängige Status. Widersprüchliche Portalwerte bleiben offen, nicht automatisch überschrieben.
- **X02/X04/X07:** Storno-/Änderungsantrag ist **kein** wirksames Ergebnis. Bei Belegungskonflikt Ursache, zeitliche Abfolge, Bindung beider Buchungen, belegte extern wirksame Sperren und verbleibende Handlungsmöglichkeiten erfassen; Verantwortlichkeit wird nicht aus einem einzigen Button abgeleitet.
**Evidenzstatus je Datenpunkt:** `übermittelt / durch externe Quelle behauptet / anhand Beleg geprüft / intern erfasst / manuell ergänzt / nicht geliefert / widersprüchlich / nicht anwendbar`; als **fachliche Beispiele**, nicht als freigegebene technische Enum. `unbekannt` ist **nicht** `0` oder `nicht vorhanden`.
## Präzisierung v0.9 – bedingte Gates nach Vorgangstyp
**Gemeinsamer Vorgang:** G1–G5 prüfen nur die für den konkreten Vorgang tatsächlich relevanten Sachverhalte. **A6** kann ohne Gast, Vertrag oder Zahlung regulär ablaufen (z. B. Wartungssperre); für eine private Überlassung können Gäste, Zusatzleistungen, Kurabgabe und Zahlungsnachweise erforderlich sein. Die Belegungssicherung bleibt unabhängig vom Vorhandensein eines Mietpreises.
- **G1 Eingang:** Bei A6 interner Anlass, Objekt, Zeitraum und Sperrgrund; bei A1–A5 wie zuvor. Vorgang entsteht ohne separate „Akte-anlegen“-Entscheidung.
- **G2 Verbindlichkeit/Dokument:** Bei A1/A2 Hold > 0 verbindliches Angebot mit Frist; Hold = 0 bloße Preis-/Verfügbarkeitsauskunft und späterer Bestätigungspfad. Bei A6 geeignete Bestätigung oder `nicht anwendbar`, keine künstliche Mietvertragsbindung.
- **G3 Abwicklung:** Bei A6 Zahlung und Gästedaten **nur bei Bedarf**, etwa für Kurtaxe/Wäschepaket; reine Sperre ohne Gast- und Zahlungsprozess.
- **G4 Durchführung:** Bei privatem Aufenthalt wie nötig Gäste-/Anreiseinformationen; bei Wartung stattdessen Arbeits-/Sperraktivitäten.
- **G5 Ende:** Passender fachlicher Vorgangsabschluss und nachweisbare Kalenderänderung/Freigabe; ggf. offene Zusatzkosten an Folgeaufgabe übergeben. Nicht anwendbare Felder bleiben explizit `nicht anwendbar`, nicht `fehlend`.
**Integritätsregel:** Eine bloße Anfrage (auch ohne Hold) ist kein bindender Vertrag; eine intern erzeugte Sperre ist kein Mietvertrag; eine extern bereits bindende Buchung verliert ihre Verbindlichkeit nicht durch fehlende Nebeninformationen.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04]] · [[P05/P05_Abschluss_und_Nachbereitung|P05]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
@@ -1,86 +0,0 @@
---
id: K01
typ: fachliches-konzept
titel: Preis-, Gebühren- und Abrechnungsinformationen
status: diskussionsentwurf
version: "0.9"
stand: 2026-11-01
---
# K01 – Flexible Preis-, Gebühren- und Abrechnungsinformationen
**Fachstatus:** Betreiberentscheidungen E-014/E-015 sind bestätigt; konkrete Feldliste/Technik, Steuern und portalbezogene Berechnungsregeln bleiben zu validieren. Zielgruppe: kleine Vermieter (typischerweise 1–3 Wohnungen), keine komplexe Vollbuchhaltung.
## 1. Zentrales Prinzip
Portale können vollständige Einzelposten, **nur Teilaufschlüsselungen**, **kombinierte Sammelgebühren** oder ausschließlich einen **Gesamtpreis** bereitstellen. FewoPortal muss all diese Informationsstände aufnehmen und später ergänzen können. **Die Gesamtpreisangabe ist ein gültiger Ausgangswert; sie berechtigt nicht zur Erfindung unbekannter Einzelpreise.** Extern bestätigter Gastpreis bleibt Grundlage der bestehenden Buchung.
## 2. Unbedingt zu unterscheidende wirtschaftliche Sachverhalte
| Dimension | Beispiel | Fachliche Bedeutung / Grenze |
|---|---|---|
| **Gast ↔ Vermieter** | Vereinbarte Unterkunftsmiete, ggf. vertragliche Zusatzleistungen und Rabatte | Eigene Mietforderung gegenüber Gast; tatsächlich vereinbarter Gastpreis maßgeblich |
| **Gast ↔ externes Portal** | Eventuelle Vermittlungs-/Servicegebühr des Portals | Fremde Forderung, nicht automatisch unsere Miete oder unser Umsatz |
| **Vermieter ↔ Vermittler/Portal** | Provision, Transaktionskosten, sonstige vertragliche Dienstleistung | Eigene Kosten des Vermieters; nicht nachträglich dem Gast belasten |
| **Gastzahlungen** | Anzahlung/Restzahlung, Erstattung, Kaution | Zahlungsplan und Zahlungsstatus unabhängig von der Mietforderung |
| **Auszahlung an Vermieter** | Nettoauszahlung nach Portalabzügen | Ist-Zahlungsfluss; nicht mit Gastpreis oder vereinbartem Mietbetrag gleichsetzen |
| **Ungeklärte Mischposition** | Eine „Servicepauschale“ mit unbekanntem Anteil an Reinigung, Portalgebühr oder Provision | **Nicht ohne Nachweis in Einzelpositionen umwandeln**; Zahler/Empfänger ggf. offen |
| **Preisdifferenz/Vertriebsaufschlag** | Höherer Endpreis auf Partnerkanal möglich | Nur bei Nachweis; unterscheiden von gesonderter Gastgebühr und Vermieterprovision |
**Begriffe:** „Brutto“, „Netto“, „Provision“ und „Servicegebühr“ können auf Portalen unterschiedlich verwendet werden. Keine umsatzsteuerliche Zuordnung ohne überprüfte Angaben. Für die Rechnungsstellung sind tatsächlich geschuldete Leistungen/Steuerregeln separat rechtlich/kaufmännisch zu prüfen.
## 3. Fachliche Positionsstruktur – Vorschlag, noch keine technische Datenmodellfreigabe
Je Position oder Aggregateintrag mindestens soweit bekannt: Bezeichnung, Betrag, Währung, positive/negative Wirkung, **Art der Position** (Einzelpreis, Teilaggregat, Gesamtbetrag, Rabatt, Zahlung, Aufwand, Auszahlung, unbekannt), **wer schuldet wem**, Preis-/Leistungsbezug, Quelle und Erfassungszeitpunkt, zugehörige Buchung und Konditionsstand, Status/Nachweis. Optional: Zeitraum, Menge, Steuerregel, ursprüngliche Portalzeile, externe Referenz, Verknüpfung zu Teilpositionen.
**Qualitäts- und Nachweisstatus:** vom Portal behauptet / im Portal sichtbar / durch Beleg belegt / manuell übernommen / abgeleitet mit Rechenweg / unbekannt / widersprüchlich / nicht anwendbar. Das sind fachliche Kategorien, kein verbindlich vorgeschriebenes Enum.
### Regeln zur Zerlegung und zum Summenabgleich
1. **Original erhalten:** Jede Portal-Sammelposition bleibt mit Ursprung und Betrag historisch erhalten, auch nach Aufteilung.
2. **Zerlegung mit Rechenweg:** Teilpositionen nur bei ausreichender Quelle oder ausdrücklicher dokumentierter manueller Zuordnung. Rest bleibt als „ungeklärter Anteil“.
3. **Doppelzählung vermeiden:** Ein Gesamtaggregat und seine Unterpositionen dürfen in Summen **nicht additiv** gezählt werden. Die Aggregationshierarchie bleibt nachvollziehbar.
4. **Keine Scheingenauigkeit:** Nur Gesamtpreis bekannt → keine Tagespreise aus Durchschnittswert als tatsächliche Portalpreise deklarieren. Interne Vergleichskalkulation ausdrücklich von Vertragsfakten trennen.
5. **Widersprüche erhalten:** Zwei verschiedene Portal-Auszahlungswerte bleiben beide mit Herkunft stehen, bis sie belegt geklärt werden.
6. **Keine Umdeutung der Vertragspflicht:** Aufteilung, interne Provision oder Auszahlung ändern den verbindlichen Gastpreis nicht rückwirkend.
7. **Korrekturen historisieren:** Neue Information ergänzt oder korrigiert die interne Zuordnung nachvollziehbar; die ursprünglichen Portalwerte bleiben referenzierbar.
## 4. Beschaffung und manuelle Bearbeitung
- **Automatisch:** Datenimport per vorhandener Schnittstelle, Parser oder anderem verlässlichen Kanal, soweit die Daten tatsächlich verfügbar sind.
- **Manuell:** Vermieter ruft Portalbestätigung, Posteingang oder Abrechnungsseite auf, erfasst Werte und kann Belege/Screenshot hinterlegen.
- **Hybrid:** Automatisch importierter Gesamtpreis, manuell nacherfasste Provision oder einzelne Gebühren.
- **Klärungsaufgabe:** Wenn tatsächlich für die **nächste Fachhandlung** erforderlich, z. B. noch fehlender Betrag zur korrekten Gastrechnung oder Zahlungseinforderung.
- **Kein unnötiger Prozessstopp:** Rein interne Provisionszerlegung oder fehlende Tagespreise blockieren nicht automatisch bereits verbindliche Buchung, Kalender- oder Anreisevorbereitung.
## 5. Getrennte Finanzzustände (kein unzulässiger Statusschluss)
`Gastbetrag vereinbart` → `Rate fällig` → `Rate laut Portal bezahlt` → `Auszahlung angekündigt` → `Auszahlung auf Bankkonto belegt`. Diese Ereignisse sind **nicht zwangsläufig linear** und nicht in allen Portalen sichtbar. Eine sichtbare „bezahlt“-Markierung ist noch kein eigener Zahlungseingang beim Vermieter; Kaution, Mietzahlung, Gebühr und Erstattung gesondert betrachten.
## 6. Reale Prüfbeispiele
**FeWo-direkt A4 – beobachteter Screenshot, Buchung 10.–17.07.2027:** 840,00 € Übernachtungen, −42,00 € Rabatt, +181,51 € „Gebühren und Steuern“, 979,51 € Gastgesamtbetrag, −84,82 € „An FeWo-direkt gezahlt“, 894,69 € ausgewiesene Gesamtauszahlung. In anderer Ansicht 900,20 € erwartete Auszahlung (5,51 € Differenz). Sichtbarer Zahlungsplan 390,61 € bezahlt und 588,90 € später fällig. **Keine belegte Zerlegung** von 181,51 €/84,82 € oder der 5,51-€-Differenz; einzelne Tagespreise fehlen. Siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A04 Abschnitt 7]].
**Destination Solutions A3 – Betreiberangaben:** Extern bestätigter Buchungspreis ist zu übernehmen und Zahlung durch Vermieter abzuwickeln. Provisionssatz kann nach vermittelndem Partner variieren. Ob Partnerportal den Endpreis erhöht oder eine separate Gast-Servicegebühr erhebt, ist derzeit nicht bestätigt; auch dort darf nur ein übermittelter Gesamtpreis zulässig sein. Keine nachträgliche Provisionsbelastung des Gastes.
## 7. Noch zu entscheiden
- Für welche Dokumente/Rechnungen ist eine echte Einzelpositionsauflösung zwingend? Gesetzliche Buchführungs-/Umsatzsteuerpflichten jeweils gesondert prüfen.
- Wie sollen Rundungsdifferenzen, Fremdwährungen, Kaution, Kurabgabe, Auszahlungstermine und Teilrückerstattungen technisch dargestellt werden?
- Welche Vereinbarungen gelten für Stornokostenbasis („Mietpreis“ vs. Gesamtbetrag; inkludierte/ausgeschlossene Leistungen), wenn nur eine Gesamtsumme vorliegt?
- Welche individuellen Portalberichte, tatsächlichen Zahlungsnachweise und Importformate stehen zur Verfügung?
**Fachliche Herkunft:** Betreiberinterview vom 31.10.2026, FeWo-direkt-Screenshots, [[E00_Entscheidungsprotokoll|E00 E-014–E-020]]. Rechtliche Gestaltung separat prüfen.
## 8. Erweiterung v0.9 – A6-Zusatzleistungen und jährliche Tarife
**A6 – private Überlassung:** Ein Vorgang kann einen **Mietbetrag von 0 EUR** aufweisen und dennoch **zusätzliche, tatsächlich geschuldete Positionen** enthalten: z. B. Wäschepakete, Kurtaxe/Kurabgabe, sonstige vereinbarte Leistungen. Ob und bei wem die örtliche Kurabgabe entsteht, richtet sich nach den einschlägigen Vorschriften, nicht nach dem Archetyp oder einem kostenlosen Mietpreis. Gebühren, Abgaben und Vermietereinnahmen bleiben fachlich getrennt.
**Reine Sperre/Wartung:** Keine Gastforderung anlegen, nur weil die gemeinsame Preispositionsfunktion existiert. Ggf. interne Objekt-/Wartungskosten nicht als buchungsbezogene Gastzahlung ausweisen.
**Preisgestaltung:** Jährliche Tarife mit saisonalen Abschnitten und Zusatzleistungen genügen als Standard; eine eigenständige Preisbindefrist oder dynamische Erlösoptimierung ist nicht im MVP vorgesehen. Extern verbindliche Portalpreise und individuell vereinbarte Konditionen bleiben maßgeblich, auch wenn der Standardjahrespreis abweicht.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]]
-47
View File
@@ -1,47 +0,0 @@
---
id: MANIFEST-09
typ: dokumentationshilfe
titel: Quellen- und Integritätsmanifest v0.9
status: arbeitsstand
version: "0.9"
stand: 2026-11-01
---
# MANIFEST v0.9 – Prüffähige Dateiliste
**Grundlage:** vom Betreiber übergebenes ZIP `Prozessarchitektur 0.7.zip`, das bereits v0.8-Obsidian-Dateien enthält. Historisches `QUELLENMANIFEST.md` für v0.7 bleibt als Archivnachweis erhalten. Die Hashes beziehen sich auf den generierten Stand v0.9, unveränderte historische Dateien werden nicht zu v0.9 umetikettiert.
| Datei | Bytes | SHA-256 (16 Stellen) | YAML-Version |
|---|---:|---|---|
| `00_Buchungsarchetypen.md` | 24103 | `b78c7e4afd3d2bfe` | 0.9 |
| `00_Portalprofile_und_Vertragsvorlagen.md` | 13137 | `5c1994fd4304633c` | 0.9 |
| `00_Prozesslandkarte.md` | 17439 | `5c82d0a9187c51a6` | 0.9 |
| `A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md` | 21088 | `38ef930be76f61aa` | 0.6 |
| `AENDERUNGSNOTIZ.md` | 1110 | `2642bd93e8d3d145` | 0.1 |
| `AENDERUNGSUEBERSICHT.md` | 5427 | `41f43df13d526ef2` | 0.9 |
| `Buchsungsprozesse/Willkommen.md` | 289 | `4b31251101e250fd` | – |
| `D00_Dokumentationsregel_und_Uebergabe.md` | 6695 | `d8d547c68f6e15b6` | 0.9 |
| `E00_Entscheidungsprotokoll.md` | 15645 | `e3a4082e5714d7ad` | 0.9 |
| `G00_Gates_und_Uebergaben.md` | 7503 | `31172bd16bfa80bf` | 0.9 |
| `K01_Preisstruktur_und_Abrechnung.md` | 9262 | `83990d669a678d81` | 0.9 |
| `O00_Offene_Portalprueffaelle.md` | 6737 | `1ac67236211c405c` | 0.9 |
| `P01/P01_Buchungseingang_und_Verfuegbarkeit.md` | 5569 | `7cb66ee873e5ef81` | 0.9 |
| `P02/P02_Konditionen_und_Buchungsverbindlichkeit.md` | 8281 | `574060e4e10fdfb0` | 0.9 |
| `P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_alt_v02.md` | 11760 | `6c4e2ef368ff95f4` | 0.2 |
| `P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch.md` | 12147 | `85d0a5362a348a41` | 0.3 |
| `P03/P03_Buchungsverwaltung_und_Abwicklung.md` | 4785 | `e2cd99612ccf7126` | 0.9 |
| `P04/P04_Leistungsvorbereitung_und_Aufenthalt.md` | 2905 | `74eb4cebadd30b72` | 0.9 |
| `P05/P05_Abschluss_und_Nachbereitung.md` | 4054 | `59ea356f77a302b1` | 0.9 |
| `QUELLENMANIFEST.md` | 2543 | `a69a1fc46781bf0e` | 0.1 |
| `R00_Szenarien/00_Szenariomatrix.md` | 3854 | `269f17bde9d35a17` | 0.9 |
| `R00_Szenarien/R01_Eigene_Webseite.md` | 11458 | `70d9ad1a1503ce38` | 0.9 |
| `R00_Szenarien/R07_Eigenbelegung_und_Sperren.md` | 3864 | `fa9c3a6d236e62a0` | 0.9 |
| `R00_Szenarien/R08_Destination_Solutions.md` | 7466 | `0953dd827bd33823` | 0.9 |
| `README.md` | 8428 | `a459abc4a249e0d6` | 0.9 |
| `S00_Supportprozesse.md` | 4038 | `b3dde1a8ce89c046` | 0.9 |
| `X00_Sonderprozesse.md` | 4378 | `3c65a9fe7ae2590e` | 0.9 |
| `X01_Belegungskonflikte_und_Sperrnachweise.md` | 4978 | `ea5a24a12f6ae321` | 0.9 |
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[AENDERUNGSUEBERSICHT|Änderungshistorie]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
@@ -1,60 +0,0 @@
---
id: O00
typ: prueffallregister
titel: Portalbezogene Prüf- und Klärungsfälle
status: diskussionsentwurf
version: "0.9"
stand: 2026-11-01
---
# O00 – Offene Portalprüffälle / spätere Konfiguration
**Status:** Keine offenen Fragen als beantwortet ausgeben, solange konkrete Portalansichten, Verträge, Anbieterantworten oder Gastbuchungen fehlen. Unterschiedliche Vermieter-/Portalverträge können unterschiedlich sein. Die untenstehenden Prüfpunkte sind **keine Vorbedingungen für alle Prozessschritte**.
## A. Destination Solutions / Kühlungsborn (A3)
| ID | Prüffall | Bekannter Stand | Erforderlicher Nachweis / spätere Konfiguration |
|---|---|---|---|
| DS-01 | Erhält Gast Stornobedingungen **vor** verbindlicher Buchung? | Staffel laut Betreiber separat im späteren Vertrag; Betreiber vermutet ggf. Portal-Einstellungen / Hinweis | Gast-Buchungsstrecke, Gast-Bestätigung, Portal-AGB/Smart-Account-Einstellungen, ggf. Betreibervereinbarung |
| DS-02 | Welche Basis ist „Mietpreis“ für Storno? | Unklar, ob Übernachtung allein oder zusätzliche Leistungen | Vertrag/Preisaufschlüsselung und rechtliche Prüfung |
| DS-03 | Gibt es eigene Gast-Servicegebühr oder Partner-Aufschläge? | **Unbekannt**; nur unterschiedliche **Vermieterprovisionen** je Vermittlungskanal sind berichtet | Gastansicht/Gastbestätigung plus Provisionsrechnung des konkreten Kanals |
| DS-04 | Vollständiger Preisnachweis | Buchung kommt mit Gesamtinformationen; Einzelposten nicht gesichert | Beispieldokumente/Muster einer echten Buchung; Fähigkeit „nur Gesamtpreis“ zulassen |
| DS-05 | Kalender-/Sperrprotokoll | Nach Betreibererfahrung **manuelle Sperre, kein formaler Sperrnachweis** | Anbieterantwort zum Serverzeitstempel, Änderungslog und Partnerweitergabe |
| DS-06 | Verfahren und Zuständigkeit für Storno/Umbuchung | Noch kein durchlaufener Prozess beschrieben | Portalvertrag, Beispielbuchung, konkrete Änderung/Storno aus Praxistest wenn möglich |
## B. FeWo-direkt (A4)
| ID | Prüffall | Bekannter Stand | Benötigter Nachweis |
|---|---|---|---|
| FW-01 | Welche Dokumente/Bedingungen werden vor verbindlicher Buchung gezeigt? | Eigene vierseitige Vertragsvorlage **nicht** im Portal hochgeladen; exakte Gastansicht unbekannt | Gastansicht, Buchungsbestätigung, Portal-AGB und tatsächlich bei Buchung vereinbarte Konditionen |
| FW-02 | Sind Gast-Servicegebühr, Portalabzug, Vermieterprovision und Steuerbestandteile trennbar? | Im Screenshot Gesamt- und Teilaggregationen; 181,51 € „Gebühren und Steuern“, 84,82 € „An FeWo-direkt gezahlt“ nicht weiter zerlegt | Vollständige Detailansicht/Provisionsabrechnung, ggf. vertraglicher Abgleich |
| FW-03 | Wieso zwei Auszahlungsbeträge? | 894,69 € und 900,20 € (Differenz 5,51 €) | Ursachenprüfung anhand derselben Buchung und Zahlungskonto |
| FW-04 | Welche Zahlungsdaten sind wirklich exportierbar? | Posteingang pro Buchung mit Raten, jedoch allgemeiner Zahlungsverlauf/Export vom Betreiber als unzureichend beschrieben | Exporttest, Auszahlungsbeleg und tatsächlicher Bankeingang |
| FW-05 | Änderungs- und Stornoprozess / Sanktionen | Betreiber hat bisher selbst weder Vermieterstorno noch Änderung ausgeführt | Portalregeln, Betreiberkonto, konkrete Verfahrensnachweise; tatsächliche Ursache korrekt klassifizieren |
| FW-06 | Gastdaten und örtliche Meldepflichten | Vollständige Gastanschrift nicht immer verfügbar | Tatsächlich vom Portal lieferbare Felder und konkret erforderliche lokale Pflichtdaten prüfen |
| FW-07 | iCal-Übernahme und Nachweis | Verzögerter Fremdkalenderabgleich, reale Doppelbuchungsgefahr | Zeit- und Änderungsnachweise soweit technisch verfügbar; keine Echtzeitgarantie |
## C. Portalübergreifende Rechts-/Funktionsfragen
- **Rechtswirksame Einbeziehung** von AGB, Storno- und Pflichtkosten vor Vertragsschluss bei externen Direktbuchungen; **späterer Dokumentversand ≠ neue automatische Einbeziehung**. Einzelprüfung anhand konkreter Verträge und Buchungsscreens.
- **Stornokosten**: Wirksamkeit der Pauschalierung und mögliche Abzüge ersparter Aufwendungen / alternative Vermietung; gesetzliche Regeln und Portal-AGB beachten, kein automatisches Rechtsurteil in FewoPortal.
- **Vollständigkeit**: Unbekannte Posten und aggregierte Beträge sind im Fachmodell ausdrücklich zulässig; der nächste notwendige Schritt kann dennoch manuelle Klärung verlangen.
- **Verfügbarkeit**: Manuelle Sperre, Zielportal-Sichtbarkeit und partnernetzweite Wirksamkeit unterscheiden. Nicht nachgewiesene Serverbestätigung nicht fingieren.
- **Datensparsamkeit**: Nur tatsächlich erforderliche Gast- und Mitreisendendaten für Vertrag und anwendbare örtliche Vorschriften erheben.
## D. Was sich vor späterer Konfiguration beschaffen lässt
Pro Portal idealerweise **ein vollständig anonymisierter realer Buchungsfall**, Gast-Buchungsbestätigung soweit vorhanden, Betreiber-Provisionsabrechnung, Preis-/Stornokonfiguration und ein Beispiel für Änderung/Stornierung. **Nicht alle Nachweise müssen jetzt vorliegen**; Fehlen führt zu manuellen Aufgaben oder offenen Informationsfeldern, nicht zum Erfinden von Regeln.
**Referenzen:** [[00_Portalprofile_und_Vertragsvorlagen|Portalprofil K00]], [[K01_Preisstruktur_und_Abrechnung|Preisstruktur K01]], [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt A04]], [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions R02]].
## Ergänzende offene Validierungen v0.9 – A6 und Implementierungsbestand
Die neue A6-Klassifikation erfordert **keine weitere Portal-Recherche für den grundsätzlichen Buchungsprozess**. Zu klären bleiben für Konfiguration und rechtliche Texte: Kurabgabe-/Meldepflichten bei Familien-/Freundesnutzung, erlaubte Kosten- und Vertragsformulierung der Buchungs-/Aufenthaltsbestätigung sowie reale Sperrmöglichkeiten der jeweiligen externen Portale.
**Technische Prüfaufträge für den Coding-Agenten:** Bestehende automatische Owner-Zuordnung unverändert wiederverwenden; Ist-Datenhaltung und Oberfläche für Vorgänge, Buchungen, Sperren, Gäste, Zusatzleistungen, Dokumente und Zahlungen auf Lücken prüfen. Keine zusätzliche „Buchungsakte“-Funktion erfinden. Bei Hold = 0 darf keine versehentliche automatisierte verbindliche Annahme erfolgen. Keine Preisbindungstimer ohne bestätigten Bedarf implementieren.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
+46
View File
@@ -0,0 +1,46 @@
---
id: O00
typ: prueffallregister
titel: Offene fachliche, rechtliche und Portal-Prüffälle
status: offen
version: "0.10"
---
# Offene Prüfungen
**Offen heißt nicht „nicht implementierbar“.** Wo ein Portal Details nicht liefert, sind **manuelle Klärung**, **Sammelbeträge** oder ein begründeter unbekannter Status erlaubt. Die folgenden Punkte sind **nicht automatisch Freigabesperren für den gesamten Prozess**.
## Portalbezogene Konfiguration
| ID | Offene Prüfung | Benötigte Grundlage |
|---|---|---|
| **DS-01** | Werden Stornobedingungen vor verbindlichem Destination-Solutions-Abschluss wirksam angezeigt? | Gast-Buchungsweg, Bestätigung, Konto-/Vertragseinstellungen |
| **DS-02** | Was umfasst der „Mietpreis“ als Basis der 0/35/50/70/90/100-%-Staffel? | Vertrag, Preisbestandteile, Rechtsprüfung |
| **DS-03** | Zusätzliche Gastgebühren oder Aufschläge in Partnerkanälen? | Gastpreisansicht, Buchungsbestätigung, Provisionsrechnung |
| **DS-04** | Detailtiefe der Preis-/Buchungsinformationen (ggf. nur Gesamtpreis)? | Anonymisiertes konkretes Buchungsbeispiel |
| **DS-05** | Zeitpunkt/Nachweis der manuellen Sperrübernahme und Partnerweitergabe? | Anbieterantwort bzw. Server-/Änderungsprotokoll |
| **DS-06** | Änderung/Storno im konkreten Konto, Verantwortung und Nachweise? | Portalvertrag, Beispielprozess, Testfall soweit möglich |
| **FW-01** | Welche Vertragsbedingungen und Bestätigungen sieht/erhält der Gast **vor/bei bindender** FeWo-direkt-Buchung? | Gastansicht/Bestätigung, Portal-AGB, Inserat |
| **FW-02** | Aufschlüsselung der 181,51 € Gebühren/Steuern und 84,82 € „an FeWo-direkt gezahlt“? | Vollständige Zahlungsdetails, Provisionsabrechnung |
| **FW-03** | Warum 894,69 € versus 900,20 € angekündigte Auszahlung? | Zahlungs-/Provisionsbeleg derselben Buchung |
| **FW-04** | Tatsächliche Zahlungs- und Auszahlungsexporte/Bankabgleich verfügbar? | Konkreter Exporttest und Kontoauszahlung |
| **FW-05** | Buchungsänderung, Vermieterstorno, Erstattung und Sanktionen tatsächlich im konkreten Konto? | Portalverfahren und dokumentierter Beispielvorgang |
| **FW-06** | Welche Gast-/Mitreisendendaten werden geliefert und rechtlich benötigt? | Konkrete Datenfelder und kommunale Vorschriften |
| **FW-07** | Tatsächliche iCal-Übernahmezeit/Wirksamkeit belegbar? | Technische Portalnachweise soweit vorhanden |
## Übergreifende fachliche und rechtliche Prüfpunkte
- **Vertragsrecht:** Wann kommen jeweils welche Verträge zustande, welche AGB, Stornobedingungen und Pflichtkosten sind tatsächlich vor Vertragsschluss einbezogen? Nachträglicher Versand allein erzeugt keine sichere neue Bindung.
- **Storno:** Wirksamkeit der Pauschalen, ersparte Aufwendungen, Weitervermietung, Unterschiede zwischen Gäste- und Vermietergrund; keine automatisch unterstellte Rechtslage.
- **Abgaben/Meldepflichten:** Erforderliche Felder und Besonderheiten bei privaten Gästen, Kurabgabe-Befreiungen, Verantwortung des örtlichen Dienstleisters; **keine Tarife dauerhaft als unveränderliche Produktkonstanten**.
- **P01/P02:** Beginn der Haltefrist, Fristen bei geänderten Angeboten, Vermeidung paralleler bindender Zusagen, rechtssicherer Text der Auskunft unter Vorbehalt und des Buchungsbuttons.
- **P03–P05:** Mindestdaten/Abschlussgates, Pflichtaufgaben, Übergabe von nachlaufenden Forderungen und Schäden; detaillierte Abläufe noch fachlich auszuarbeiten.
- **A6:** Bestätigungsformulierungen und Kostenpflichten privater Überlassung, Verknüpfung alter Sperren mit einheitlichem Vorgang.
## Vor der Implementation technisch am Repository prüfen
Der Coding-Agent hat in seiner Bestandsanalyse **berichtet**, dass bestehende Buchungen, Blockperioden und manuelle Erfassung derzeit teilweise parallel laufen; Gast-Pflichtfelder bei Portalbuchungen Platzhalter auslösen können; `Channel::booking_model` zu grob ist; Hold und Angebot verknüpft und nur wohnungsbezogen gesteuert werden; `PortalPrice` Gesamtsummen künstlich aufteilt; Portalstornos bestehende Vorgänge nicht sichtbar erreichen und A6 nur teilweise abbildbar ist. **Das sind Agentenbefunde, keine unabhängig verifizierten Tatsachen oder technischen Architekturvorgaben.** Die aktuelle Codebasis ist vor Maßnahmen erneut zu prüfen.
**Reihenfolge:** Bereinigte Fachspezifikation → Agent prüft Abweichungen zur aktuellen Implementierung und liefert **gespeicherten Umsetzungsplan im Repo** → fachliche Entscheidungen/Umsetzungsfreigabe → Implementierung. Kein vorschneller Gesamtumbau und keine Erfindung fehlender Geschäftsregeln.
[Zur Prozesslandkarte](00_Prozesslandkarte.md) · [Destination Solutions](Szenarien/R08_Destination_Solutions.md) · [FeWo-direkt](Szenarien/R09_FeWoDirekt.md)
@@ -1,60 +0,0 @@
---
id: P01
typ: prozessphase
titel: Buchungseingang und Verfügbarkeitssicherung
status: entwurf
version: "0.9"
---
# P01 – Buchungseingang und Verfügbarkeitssicherung
**Status:** Phasengerüst – Detailinterview steht aus.
## Zweck
Eingehende Anfrage, interner Belegungs-/Sperranlass, manuelle Meldung oder bereits verbindliche Portalbuchung eindeutig erfassen und die betroffene Belegung korrekt sichern bzw. erkennen.
## Fachliche Aktivitäten (vorläufig)
1. Eingang/Quelle und Herkunft erkennen: Website, telefonisch/manuell, Portal, Hub/Partner.
2. Eingangstyp feststellen: unverbindliche Anfrage, **bereits verbindliche Buchung**, rein blockierter Zeitraum, unklarer Eintrag.
3. Vorliegende Daten mit Quelle und Verlässlichkeit übernehmen; fehlende Informationen über wiederverwendbaren Klärungsprozess nachfordern.
4. Verfügbarkeit für Anfrage prüfen; bei Bedarf konfigurierbaren Hold (z. B. 48 h) erstellen.
5. Eigene und externe Kalender abgleichen; Synchronisationsstand und Restrisiken festhalten.
6. Übergabe an P02 bzw. direkte Übernahme einer bereits verbindlichen Buchung.
## Zentrale Gates
- Buchungsart und Quelle nachvollziehbar.
- Zeitraum/Objekt bekannt oder Klärungsaufgabe vorhanden.
- Für unsere eigene Angebotszusage Zeitraum im eigenen System gesichert; externe Bestätigung der Holds ist nicht automatisch garantiert.
- Bei Portalbuchung Nachweis externer Verbindlichkeit an P02 übergeben.
## Noch offen
Mindestfelder nach Eingangstyp, Übergaberegeln für unklare iCal-Ereignisse, Konfliktverhalten, genaue Hold- und Kalenderregeln.
## Praxisfälle und Aktivitätsvarianten v0.7
- **FeWo-direkt (A4):** Sofortbuchung kann während verzögertem iCal-Abgleich entstehen. Portal-Verfügbarkeitsstatus darf nicht als Echtzeitgarantie dargestellt werden; eigenes Sync-Ereignis, Zeitpunkt des Abrufs und bekannte Konflikte festhalten.
- **Destination Solutions (A3):** Im konkret genutzten Zugang **keine aktive Kalender-Synchronisation** laut Betreiber; externe neue Buchung kommt bereits verbindlich an. Andere Vertriebskanäle müssen im Portal **manuell blockiert** werden; nachgelagerter Partnervertrieb kann weitere Verzögerungen verursachen. Eigene protokollierte Aufgabe mit Zeitpunkt, Bearbeiter, Portalanzeige/Screenshot (wenn möglich) – keine Behauptung, der Portalserver habe eine rechtzeitige Übernahme quittiert.
- **Portalunabhängig:** Art des Belegungs-Inputs (iCal, API, E-Mail, manuell), Ausführungspfad (automatisch/manuell/hybrid), Verzögerung/Unsicherheit und Kontrollmöglichkeiten im Portalprofil hinterlegen. Neue, extern **bereits verbindliche** Kollisionsbuchung als Konflikt behandeln; keine stillschweigende Ablehnung oder Löschung.
- **Drei Sperrzustände:** `Sperrung veranlasst`, `im Zielportal sichtbar`, `nachweislich im relevanten Vertrieb wirksam`. Fehlender Nachweis bleibt **unbekannt**. Für eigene Holds eigene atomare Freihaltung und Sicherung des bindenden Angebots prüfen, ohne fremde Echtzeitwirkung zu versprechen.
Siehe [[X01_Belegungskonflikte_und_Sperrnachweise|X01 – Konfliktmanagement und Nachweise]].
## Präzisierung v0.9 – Vorgang, A6 und Haltefrist
**Gemeinsamer Vorgang (E-023/E-028):** Ein fachlich identifizierter Anlass erzeugt einen Vorgang ohne separate Entscheidung „Buchungsakte anlegen“. Das gilt auch für **A6** (Eigenbelegung, Familienbesuch, Wartung und sonstige Sperrgründe). Der vorhandene Mechanismus zur Zuordnung externer Buchungen zum auslösenden Portal/Owner ist bereits implementiert und wird wiederverwendet. A6 erhält je nach Anlass optional Gäste/Kontakte, Leistungen und Kosten; der Sperrgrund ist zu protokollieren.
**Anfragen A1/A2 – vereinfachte Haltefrist (E-026):** Der Vermieter kann je relevantem Anfragekanal einen Standard wie 0, 24, 48 oder 72 Stunden wählen (frei konfigurierbare Werte als spätere Umsetzung zu prüfen).
- **Hold > 0:** Zeitraum im eigenen System vorübergehend sperren, externe Sperren je Portalprofil automatisch oder manuell anstoßen, Status/Nachweise erfassen. Verbindliches Angebot nur mit dazu passender Annahme-/Haltefrist und geeigneter Angebotsvorlage.
- **Hold = 0:** Keine Vorreservierung und keine externen Sperraufgaben allein wegen der Anfrage. Preis-/Verfügbarkeitsauskunft mit passender Vorlage versenden; **keine verbindliche Verfügbarkeitszusage**. Bei Buchungswunsch Verfügbarkeit erneut prüfen und erst dann bestätigen.
- **Keine eigenständige Preisbindefrist als MVP-Standard.** Jahresbezogene Tarifpflege bleibt möglich; der bei tatsächlichem Vertragsschluss maßgebliche Preis wird später dokumentiert.
**A6:** Zeitraum intern sichern, externe Kanäle entsprechend deren realer Synchronisationsfähigkeit berücksichtigen. Eine private Überlassung kann nach P02/P03/P04 verzweigen; eine reine Wartungssperre kann mit verkürztem Ablauf weitergeführt oder abgeschlossen werden. **Kein neuer A6** für eine A1/A2-Hold-Reservierung.
**Risiko/Pragmatik (E-027):** Restrisiko bleibt bei verzögerten oder manuell gepflegten Portalen. Betreibererfahrung: zwei Doppelbuchungen in etwa 20 Jahren. Wenige robuste Sperr- und Klärungsschritte statt überkomplexer Risikoengine; niemals ungeprüfte externe Echtzeitwirkung zusagen.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|Weiter zu P02]] · [[G00_Gates_und_Uebergaben|Gates]] · [[X01_Belegungskonflikte_und_Sperrnachweise|X07 Belegungskonflikte]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]]
@@ -1,81 +0,0 @@
---
id: P02
typ: prozessphase
titel: Konditionen und Buchungsverbindlichkeit
status: entwurf
version: "0.9"
---
# P02 – Konditionen und Buchungsverbindlichkeit
**Status:** wesentliche Geschäftsregeln im Betreiberinterview bestätigt; Detail- und Rechtsprüfung offen.
## Zweck
Konditionen und **nachweisbare Buchungsverbindlichkeit** herstellen oder von einem externen Portal übernehmen.
## Weg A – Unser verbindliches Angebot mit Hold > 0
1. Pflichtdaten/Preisgrundlagen soweit für das Angebot nötig vervollständigen.
2. Endpreis mit Saison, Rabatten, Sonderleistungen und ggf. Loyalty-Input kalkulieren.
3. Gültige Vertragsbedingungen/Anlagen, Storno- und Zahlungsfristen zuordnen; bei **Hold > 0** eine Annahmefrist passend zur gesicherten Reservierung festlegen. Für **Hold = 0** keine unbedingte Annahmemöglichkeit vortäuschen.
4. **Bei wirksamer Reservierung bindendes, befristetes Angebot** erstellen und vollständigen gültigen Konditionsstand versioniert sichern (PDF und strukturierte Snapshot-Daten/Nachweise).
5. Angebot mit signiertem Annahmelink senden; Annahme innerhalb der Frist nachweisen.
6. Mit fristgerechter Annahme: Buchung verbindlich, keine weitere Betreiberbestätigung nötig.
7. Ohne fristgerechte Annahme: Angebot erlischt; eigene Vorreservierung nur dann freigeben, wenn kein anderer bindender Belegungstatbestand oder ungeklärter Konflikt vorliegt. Verlauf bewahren.
## Weg A0 – Preisauskunft ohne Hold (Haltefrist = 0)
1. Preis und aktuelle Verfügbarkeit aus der gültigen Jahres-/Saisonpreisliste ermitteln.
2. Passende, rechtlich zu prüfende **Preisauskunft unter Verfügbarkeitsvorbehalt** ohne automatischen Vertragsannahmelink senden; **keine Reservierung** anlegen.
3. Wenn der Gast buchen möchte: Verfügbarkeit erneut prüfen, Konditionen bestätigen und den verbindlichen Abschluss gesondert herbeiführen. Der Buchungspreis wird erst mit der wirksamen Vereinbarung fixiert.
## Weg B – Externe verbindliche Direktbuchung, Vertrag von uns
1. **Verbindlichkeit bereits extern entstanden**; keine erneute offizielle Gastannahme in FewoPortal.
2. **Portalpreis als verbindlichen Buchungspreis übernehmen** und mit Quelle/Portalreferenz festhalten; eigene Kalkulation allenfalls als interne Vergleichsgröße.
3. Für die Vertragsdokumentation erforderliche Gastinformationen ggf. nachbeschaffen.
4. Vertrag/Bestätigung aus den tatsächlich maßgeblichen Konditionen der bestehenden Buchung erzeugen und übermitteln; nicht unbemerkt zusätzliche Bedingungen setzen.
5. Zahlung, Mahnung, Storno gemäß Kanalprofil intern/extern zuordnen.
## Weg C – Externe Direktbuchung, vollständige Abwicklung durch Portal
1. Bindungsnachweis und nötige Belegungsdaten übernehmen.
2. Keine zweite Angebotsannahme und kein eigener Vertrags-/Mahn-/Stornoablauf anstoßen.
3. Erforderliche Gästeinformationen für örtliche Betreuung, Meldung/Abgaben und andere gesetzliche Pflichten beschaffen; Verantwortung/Status des Portals nachvollziehbar halten.
## Zustands-Gate
**Buchung verbindlich** durch (A) rechtzeitig angenommene eigene Angebotversion oder (B/C) nachgewiesene externe Direktbuchung. Angaben wie Anschrift können für **einzelne nachfolgende Aktivitäten** noch offen sein, ohne diesen Zustand aufzuheben.
## Wichtige Hinweise / offene Prüfungen
- Angebot und Hold dürfen nicht auseinanderlaufen; konkrete Fristen-/Synchronisationslogik ist gesondert zu gestalten.
- Verspätete oder geänderte Annahme ist **nicht** automatische Annahme des alten Angebots (BGB §§ 146–150, insbesondere § 150).
- Digitale Verbraucher-Bestellsituation und AGB-Einbeziehung sowie konkrete Portalbedingungen gesondert rechtlich prüfen, insbesondere § 312j BGB je nach Anwendungsfall.
- Angebotsänderung vor Annahme und Vertragsänderung nach Verbindlichkeit bleiben unterschiedliche Sonderprozesse.
## Normquellen
- [§ 145 BGB – Bindung an den Antrag](https://www.gesetze-im-internet.de/bgb/__145.html)
- [§ 146 BGB – Erlöschen des Antrags](https://www.gesetze-im-internet.de/bgb/__146.html)
- [§ 148 BGB – Bestimmung einer Annahmefrist](https://www.gesetze-im-internet.de/bgb/__148.html)
- [§ 150 BGB – verspätete und abändernde Annahme](https://www.gesetze-im-internet.de/bgb/__150.html)
- [§ 312j BGB – Besonderheiten im elektronischen Geschäftsverkehr](https://www.gesetze-im-internet.de/bgb/__312j.html)
## Konditions- und Vertragsprofile v0.7
- **Kanalabhängige Vorlagen:** Für A1/A2 bindendes Angebot einschließlich wirksam zur Kenntnis gegebener Bedingungen; für A3/A4 Dokumentation bereits extern abgeschlossener Buchung; für A5 nur die zur eigenen Tätigkeit nötigen Unterlagen. Vorlagen/Anlagen je Vermieter, Objekt, Portal und Buchungstyp unterscheiden, Version + verwendeten Konditionsstand aufbewahren.
- **Extern verbindliche Preisgrundlage:** Der bestätigte Gastpreis kann lediglich **als Gesamtbetrag** vorliegen. Dies ist kein Grund, Tagespreise oder einzelne Gebühren zu erfinden. Vom Portal selbst erhobene Gast-Servicegebühren und Vermieterprovisionen können davon abweichen und separat oder nur aggregiert bekannt sein.
- **Vorvertragliche Einbeziehung:** Ob dem Gast vor Abschluss Stornostaffeln, Pflichtgebühren und sonstige Bedingungen angezeigt wurden, ist je Portal zu prüfen; ein nachträgliches Dokument erzeugt nicht automatisch neue Vertragspflichten.
- **Destination Solutions:** Genannte Stornostaffel (vom Betreiber berichtet): mindestens 60 Tage vorher 0 %, 59–45 Tage 35 %, 44–33 Tage 50 %, 32–22 Tage 70 %, 21–12 Tage 90 %, 11 Tage oder weniger 100 % des „Mietpreises“. **Ungeklärt:** Nachweis im Buchungsprozess, Durchsetzbarkeit, genaue Kostenbasis. Nicht als globalen A3-Standard verwenden.
Siehe [[00_Portalprofile_und_Vertragsvorlagen|K00]], [[K01_Preisstruktur_und_Abrechnung|K01]] und [[R00_Szenarien/R08_Destination_Solutions|R08 Destination Solutions]].
## Präzisierung v0.9 – zwei Angebotswege und A6-Bestätigung
**A1/A2 mit Hold > 0:** Konfigurierter kanalabhängiger Haltezeitraum und Vertragsangebot werden aufeinander abgestimmt. Vorlagenauswahl, Bedingungen, Annahmelink und Folgeaktivitäten sind von der Angebotsart abhängig. Der eigene Hold garantiert **keine nachweislich wirksame Sperre in fremden Portalen**; Restrisiko siehe [[X01_Belegungskonflikte_und_Sperrnachweise|X01]].
**A1/A2 mit Hold = 0:** Keine Reservierung, keine eigene automatische Annahme eines verbindlichen Unterkunftsangebots. Stattdessen wird ein **Preis-/Verfügbarkeitsangebot unter Vorbehalt** bzw. eine Preisauskunft versandt. Auf erneuten Buchungswunsch folgt **nochmals Verfügbarkeitsprüfung** und anschließend erst ein ausdrücklich bestätigter bindender Abschluss. Eine zweite, unabhängig zu überwachende Preisbindefrist wird **nicht** eingerichtet. Die Preise werden überwiegend pro Kalenderjahr festgelegt; dynamische Hotel-/Flugtarifmodelle sind nicht Ziel des MVP. **Rechtliche Formulierung dieser beiden Vorlagen separat prüfen**; „Preis gilt“ und „Wohnung ist gebucht“ dürfen nicht verwechselt werden.
**A6:** Keine pauschale Mietvertragsbindung. Je nach Anlass: interne Sperr-/Reservierungsbestätigung, Bestätigung an private Gäste oder kein Versand. Können private Gäste Zusatzleistungen bezahlen müssen, sind diese transparent auf der gewählten Bestätigung zu dokumentieren; gesetzliche/örtliche Abgaben sind anhand der tatsächlichen Pflichten zu prüfen. Falls eine rechtsgeschäftliche Vereinbarung besteht, ist deren Bindung eigenständig festzuhalten. Ein rein technischer Block darf nicht als Mietvertrag erscheinen.
**Fachliche Auswahlregel:** Kanal/Owner + Vorgangs-/Buchungsart + Vermieter/Objekt steuern die **richtige versionierte Vorlage** und die internen Aktivitäten. Die konkrete Auswahl/Überschreibung wird protokolliert; später geänderte Vorlagen verändern bestehende Vorgänge nicht.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|Zurück zu P01]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|Weiter zu P03]] · [[G00_Gates_und_Uebergaben|Gates]] · [[00_Portalprofile_und_Vertragsvorlagen|Vertragsprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]]
@@ -1,100 +0,0 @@
---
id: A04-DOK-01
typ: prozessanalyse
titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess
status: diskussionsentwurf
version: "0.2"
stand: 2026-10-31
prozess: V01
archetyp: A4
quellen:
- "Vorlage MV für fewo-direkt.pdf (4 Seiten, Betreiber)"
- "Betreiberbeschreibung: manueller A4-Istprozess, 31.10.2026"
---
# A4 – Vertragsvorlage und Prozessanalyse
> **Arbeitsdokument, keine Freigabe zur Änderung rechtlicher Klauseln.** Die Vertragsvorlage ist ein Beispiel für den aktuellen Ablauf, kein Nachweis der beim Buchungsabschluss über FeWo-direkt tatsächlich akzeptierten Konditionen. **Zugangscodes, Passwörter, persönliche Kontaktdaten und Namen von Gästen werden hier bewusst nicht reproduziert.**
## 1. Einordnung in den dokumentierten Istprozess
1. FeWo-direkt bestätigt extern eine verbindliche Buchung und sendet eine E-Mail mit Gastname und Zeitraum.
2. Der Vermieter sperrt andere Belegungskalender manuell.
3. Im FeWo-direkt-Vermieterbereich werden verfügbare Gastkontakte und Buchungs-/Preisdaten ermittelt.
4. Fehlende Angaben aller tatsächlich erforderlichen Reisenden werden per Gastkontakt angefordert.
5. Der Vermieter erstellt einen individuellen Mietvertrag anhand der vierseitigen Vorlage und versendet ihn mit der Internetvereinbarung.
6. FeWo-direkt fordert Anzahlung und Restzahlung an und verarbeitet diese; Vermieter hat nach eigener Aussage unzureichende Zahlungstransparenz.
7. FeWo-direkt versendet ca. 72 Stunden vor Check-in eine Gastinformation (Betreiberangabe).
8. Vermieter informiert lokale Dienstleister (Schlüssel, Reinigung, Gästebetreuung).
9. Stornierungen werden nach aktueller Praxis über FeWo-direkt abgewickelt; konkrete Verantwortlichkeiten und Statusübermittlung sind noch zu prüfen.
### Nachtrag: vom Betreiber bestätigte Portalpraxis (31.10.2026)
- **Der eigene vierseitige Mietvertrag ist nicht im FeWo-direkt-Inserat hinterlegt.** Gäste erhalten ihn erst im nachgelagerten eigenen Versand, soweit der derzeitige Ablauf beschrieben ist.
- Der Betreiber **kann derzeit nicht einsehen**, welche Buchungs-/Vertragsunterlagen FeWo-direkt dem Gast im konkreten Abschluss zusendet. Deshalb ist **nicht nachgewiesen**, welche Klauseln der Gast wann erhält und akzeptiert.
- **Mietpreise müssen nach bisheriger Praxis im FeWo-direkt-Kalender gepflegt werden**; Rabatte und Stornobedingungen werden ebenfalls im Portal verwaltet. Der bei Buchung vereinbarte Portalkonditionsstand ist für diese Buchung maßgeblich und darf nicht durch unsere eigene Kalkulation ersetzt werden.
- Dies ist ein **konkretes Kanalprofil A4**, **keine allgemeine Regel** für andere Portale. Andere Kanäle können Preise, Konditionen, Vertrag und Abwicklung anders verteilen.
- **Die Vertragsvorlage wird passend zu Portal, tatsächlichem Buchungstyp und ggf. Herkunft ausgewählt**. Andere Portale können eigene Vorlagen und Anlagen erfordern; bestehende Vertragsdokumente werden versioniert.
## 2. Was die vierseitige Vorlage derzeit enthält
| Textabschnitt | Inhalt | Prozesszuordnung |
|---|---|---|
| Präambel, § 1–2 | Vertragsparteien, konkrete Ferienwohnung, Zeitraum, An-/Abreisezeiten | P02/P04 |
| § 2–3 | Schlüsselübergabe durch lokalen Dienstleister, Kurabgabe/Anmeldung | P04 |
| § 4 | Mietsumme einschließlich verschiedener Kosten; Portal-Servicegebühr; Anzahlung/Restzahlung | P02/P03 |
| § 5 | 'Annahme' des Vertrages durch Anzahlung; Sorgfalt/Schäden | P02 / Sonderfall |
| § 6–9 | Wäsche, Sauna, Schlüssel, Hausordnung | P04 |
| § 10–12 | Sorgfalt, Beanstandungen, Rauchverbot, Internet und Internetvereinbarung | P02/P04 |
| § 13 | Rücktritt: 60+ Tage 0 %, 59–30 Tage 50 %, ab 29 Tage 100 % des Mietpreises; Ersatzmieterregelung | Sonderprozess Stornierung |
| § 14 | Abreise- und Reinigungsanforderungen | P04/P05 |
| § 15–18 | Gerichtsstand, Form, Datenschutz, salvatorische Klausel | Recht/Compliance |
| Anlage Seite 4 | Internetnutzung, WLAN-Zugang, Gerätehinweise | Gästeinformation/Sicherheitsdaten |
## 3. Wesentliche Befunde und Prüfaufträge
**F-01 – Verbindlichkeit (§ 5), hohe Priorität.** Die Klausel setzt 'Annahme des Vertrages' mit einer bereits gezahlten Anzahlung in Zusammenhang. Nach der fachlich angenommenen A4-Logik besteht die bindende Portalbuchung aber **vor** unserem späteren Dokumentenversand. Es ist zu prüfen, was vor Vertragsschluss auf FeWo-direkt bereitgestellt wurde. Ein nachgeschicktes PDF darf neue Bedingungen nicht stillschweigend zur bisherigen Buchung hinzufügen. **Fachliches Soll:** Trennung zwischen Nachweis der externen Buchung und nachgelagerter Übermittlung bestehender Bedingungen.
**F-02 – Vollständige Konditionen vor Buchung, hohe Priorität.** Der bisherige Ablauf lässt offen, ob Hausordnung, Internetanlage, Stornoregel, Zusatzleistungen und weitere Bedingungen vor dem FeWo-direkt-Klick einsehbar waren. Die offiziellen Vermieter-AGB verlangen die Offenlegung der jeweiligen Konditionen und erlauben Zusatzvereinbarungen nur im Einklang mit den zuvor veröffentlichten Informationen. **Bestätigter Ist-Zustand:** Die PDF-Vorlage ist nicht im Inserat hinterlegt. **Offen:** Welche Vertragsbedingungen und Unterlagen FeWo-direkt im konkreten Abschluss anzeigt oder übersendet, kann der Betreiber derzeit nicht nachvollziehen. Ob eine Hinterlegung sinnvoll ist, bleibt eine optionale Maßnahme, keine allgemeine Systemvorgabe. Die konkret angezeigten Bedingungen sind gesondert zu ermitteln.
**F-03 – Preisstruktur (§ 4), hohe Priorität.** Das Dokument nennt Gesamtbetrag, Endreinigung, Betreuung, Servicegebühr des Portals, Anzahlung und Restzahlung in einem Text. Erforderlich sind fachlich getrennte Werte: vom Gast verbindlich vereinbarte Gesamtkonditionen, darin enthaltene Unterkunfts-/Leistungsentgelte, ggf. separate Reisenden-Servicegebühr des Portals, Vermieterprovision, Auszahlungsbetrag und Zahlungsstatus. **Keine zusätzlichen Beträge durch FewoPortal erheben, die nicht Bestandteil der Vereinbarung sind.** Konkrete Gebührenstruktur im Vermieter-/Gastbeleg gegenprüfen.
**F-04 – Storno (§ 13), hohe Priorität.** Die Vorlage enthält die oben genannten Staffeln. Nicht belegt ist, ob exakt diese Staffel für die konkrete FeWo-direkt-Buchung vor Abschluss angezeigt und vereinbart wurde. Der Gast kann laut FeWo-direkt über sein Konto stornieren; Erstattungen richten sich nach der anwendbaren Richtlinie. Der Vermieter darf daher aus der nachträglich versandten Vorlage keine abweichenden Gebühren ableiten. Vermieterseitige Stornierungen sind zusätzlich durch FeWo-direkt-Sanktionsregeln besonders riskant.
**F-05 – Gast- und Meldedaten (§ 3), mittlere Priorität.** Der Vertrag sieht die örtliche Anmeldung durch einen Dienstleister und die Kurabgabe vor. Welche Felder für wen und zu welchem Zeitpunkt rechtlich erforderlich sind, muss anhand der kommunalen Vorgaben gesondert definiert werden. Die im Vertrag genannten Tarife und Altersgrenzen stimmen mit der derzeit öffentlich ausgewiesenen Kühlungsborner Information überein, sollten aber nicht dauerhaft als fixe Vertragskonstanten im Produkt behandelt werden.
**F-06 – Rechtlich prüfbedürftige Vertragsklauseln, hohe Priorität.** Besonders § 10–11 (pauschale Einschränkungen von Mietminderung/Beanstandungen), § 15 (vorgegebener Gerichtsstand Dortmund für private Gäste), § 16 (Schriftform/E-Mail), § 17 (Datenverwendung/Übermittlung an Dienstleister) und die Formulierung zur maschinellen Unterschrift sind juristisch zu prüfen. Die Wirksamkeit ist nicht allein aus dieser Analyse abschließend zu beurteilen.
**F-07 – Zugangsdaten und Anlagen, hohe Priorität.** Seite 2 und 4 enthalten feste Zutritts-/WLAN-Daten. Diese sollten nicht dauerhaft Bestandteil der allgemeinen, archivierten Vertragsvorlage sein. Empfehlung: separate, gezielt zur Anreise freigegebene Gästeinformation. Bereits offengelegte Zugangsdaten kontrollieren/ggf. wechseln. Eine separate Internet-Nutzungsvereinbarung ist fachlich eine versionierte Anlage, muss aber in ihrem rechtlichen Status geklärt sein.
**F-08 – Unterschiedliche Dokumentzwecke, mittlere Priorität.** Vertrags-/Konditionsnachweis, ortsbezogene Aufenthaltshinweise und sensible Zugriffsinformationen nicht zwingend in einem vierseitigen 'Mietvertrag' bündeln. Ziel: **ein gemeinsames, einfaches FewoPortal-Dokumentenmanagement** mit richtigem Zeitpunkt der Bereitstellung, kein neues eigenständiges Buchungsformular.
**F-09 – Datenqualität, mittlere Priorität.** Die konkrete Vorlage enthält variable, noch unbesetzte Felder (z. B. Reisende, Daten, Preis, Nächte). Beim Dokumenterstellen müssen Vollständigkeit, Übereinstimmung mit der Portalbuchung und Version der gültigen Anlagen geprüft werden; bei einem Konflikt wird der Versand gesperrt bzw. eine Klärung ausgelöst.
## 4. Soll-Funktionsbild für A4 (noch nicht beschlossen)
**Bindungsnachweis aus FeWo-direkt** → **Portalpreis und bei Buchung vereinbarte Konditionen übernehmen** → **Gastdaten gezielt nachfordern** → **Dokumente aus verifiziertem Konditionsstand erstellen und ohne zweite Annahme übermitteln** → **Portalzahlungen/Storno extern verfolgen, ohne Zahlungen zu erfinden** → **separate Anreiseinformationen und Dienstleisteraufgaben auslösen**.
Bei einer Abweichung zwischen dem vom Gast akzeptierten Konditionsstand und dem späteren Dokument **nicht automatisch ein abweichendes Vertragsdokument verschicken**, sondern in FewoPortal einen Klärungsfall eröffnen.
## 5. Noch offene fachliche Klärung
**Welche Konditionen sieht und bestätigt der Gast bei einer konkreten FeWo-direkt-Direktbuchung und welche Dokumente erhält er anschließend tatsächlich vom Portal?**
Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [Portalprofile und Vertragsvorlagen](00_Portalprofile_und_Vertragsvorlagen.md).
## 6. Öffentliche Quellen für die juristisch-technischen Prüfpunkte
- [FeWo-direkt – AGB für Vermieter (29.10.2026), insb. Nr. 2.2–2.3](https://www.fewo-direkt.de/lp/b/partner-terms-of-use)
- [FeWo-direkt – Hochladen Ihres Mietvertrags](https://hilfe.fewo-direkt.de/articles/Wie-kann-ich-meinen-Mietvertrag-hochladen)
- [FeWo-direkt – Stornierungen durch Gäste](https://hilfe.fewo-direkt.de/articles/Kann-ein-Urlauber-eine-Reservierung-stornieren)
- [FeWo-direkt – Richtlinie für Gastgeberstornierungen](https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy)
- [§ 305 BGB – Einbeziehung von AGB](https://www.gesetze-im-internet.de/bgb/__305.html)
- [§ 307 BGB – Inhaltskontrolle](https://www.gesetze-im-internet.de/bgb/__307.html)
- [§ 309 Nr. 5 BGB – Pauschalierter Schadensersatz](https://www.gesetze-im-internet.de/bgb/__309.html)
- [§ 536 BGB – Mietminderung](https://www.gesetze-im-internet.de/bgb/__536.html)
- [§ 38 ZPO – Gerichtsstandsvereinbarung](https://www.gesetze-im-internet.de/zpo/__38.html)
- [§ 126 BGB – Schriftform](https://www.gesetze-im-internet.de/bgb/__126.html), [§ 127 BGB – Vereinbarte Form](https://www.gesetze-im-internet.de/bgb/__127.html)
- [Kühlungsborn – Kurabgabe](https://www.kuehlungsborn.de/kurabgabe/)
**Abgrenzung:** Dies ist eine fachliche Prozess- und Risikoprüfung, keine rechtliche Freigabe und keine eigenmächtige Überarbeitung der Betreiber-Vertragstexte.
@@ -1,100 +0,0 @@
---
id: A04-DOK-01
typ: prozessanalyse
titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess
status: diskussionsentwurf
version: "0.2"
stand: 2026-10-31
prozess: V01
archetyp: A4
quellen:
- "Vorlage MV für fewo-direkt.pdf (4 Seiten, Betreiber)"
- "Betreiberbeschreibung: manueller A4-Istprozess, 31.10.2026"
---
# A4 – Vertragsvorlage und Prozessanalyse
> **Arbeitsdokument, keine Freigabe zur Änderung rechtlicher Klauseln.** Die Vertragsvorlage ist ein Beispiel für den aktuellen Ablauf, kein Nachweis der beim Buchungsabschluss über FeWo-direkt tatsächlich akzeptierten Konditionen. **Zugangscodes, Passwörter, persönliche Kontaktdaten und Namen von Gästen werden hier bewusst nicht reproduziert.**
## 1. Einordnung in den dokumentierten Istprozess
1. FeWo-direkt bestätigt extern eine verbindliche Buchung und sendet eine E-Mail mit Gastname und Zeitraum.
2. Der Vermieter sperrt andere Belegungskalender manuell.
3. Im FeWo-direkt-Vermieterbereich werden verfügbare Gastkontakte und Buchungs-/Preisdaten ermittelt.
4. Fehlende Angaben aller tatsächlich erforderlichen Reisenden werden per Gastkontakt angefordert.
5. Der Vermieter erstellt einen individuellen Mietvertrag anhand der vierseitigen Vorlage und versendet ihn mit der Internetvereinbarung.
6. FeWo-direkt fordert Anzahlung und Restzahlung an und verarbeitet diese; Vermieter hat nach eigener Aussage unzureichende Zahlungstransparenz.
7. FeWo-direkt versendet ca. 72 Stunden vor Check-in eine Gastinformation (Betreiberangabe).
8. Vermieter informiert lokale Dienstleister (Schlüssel, Reinigung, Gästebetreuung).
9. Stornierungen werden nach aktueller Praxis über FeWo-direkt abgewickelt; konkrete Verantwortlichkeiten und Statusübermittlung sind noch zu prüfen.
### Nachtrag: vom Betreiber bestätigte Portalpraxis (31.10.2026)
- **Der eigene vierseitige Mietvertrag ist nicht im FeWo-direkt-Inserat hinterlegt.** Gäste erhalten ihn erst im nachgelagerten eigenen Versand, soweit der derzeitige Ablauf beschrieben ist.
- Der Betreiber **kann derzeit nicht einsehen**, welche Buchungs-/Vertragsunterlagen FeWo-direkt dem Gast im konkreten Abschluss zusendet. Deshalb ist **nicht nachgewiesen**, welche Klauseln der Gast wann erhält und akzeptiert.
- **Mietpreise müssen nach bisheriger Praxis im FeWo-direkt-Kalender gepflegt werden**; Rabatte und Stornobedingungen werden ebenfalls im Portal verwaltet. Der bei Buchung vereinbarte Portalkonditionsstand ist für diese Buchung maßgeblich und darf nicht durch unsere eigene Kalkulation ersetzt werden.
- Dies ist ein **konkretes Kanalprofil A4**, **keine allgemeine Regel** für andere Portale. Andere Kanäle können Preise, Konditionen, Vertrag und Abwicklung anders verteilen.
- **Die Vertragsvorlage wird passend zu Portal, tatsächlichem Buchungstyp und ggf. Herkunft ausgewählt**. Andere Portale können eigene Vorlagen und Anlagen erfordern; bestehende Vertragsdokumente werden versioniert.
## 2. Was die vierseitige Vorlage derzeit enthält
| Textabschnitt | Inhalt | Prozesszuordnung |
|---|---|---|
| Präambel, § 1–2 | Vertragsparteien, konkrete Ferienwohnung, Zeitraum, An-/Abreisezeiten | P02/P04 |
| § 2–3 | Schlüsselübergabe durch lokalen Dienstleister, Kurabgabe/Anmeldung | P04 |
| § 4 | Mietsumme einschließlich verschiedener Kosten; Portal-Servicegebühr; Anzahlung/Restzahlung | P02/P03 |
| § 5 | 'Annahme' des Vertrages durch Anzahlung; Sorgfalt/Schäden | P02 / Sonderfall |
| § 6–9 | Wäsche, Sauna, Schlüssel, Hausordnung | P04 |
| § 10–12 | Sorgfalt, Beanstandungen, Rauchverbot, Internet und Internetvereinbarung | P02/P04 |
| § 13 | Rücktritt: 60+ Tage 0 %, 59–30 Tage 50 %, ab 29 Tage 100 % des Mietpreises; Ersatzmieterregelung | Sonderprozess Stornierung |
| § 14 | Abreise- und Reinigungsanforderungen | P04/P05 |
| § 15–18 | Gerichtsstand, Form, Datenschutz, salvatorische Klausel | Recht/Compliance |
| Anlage Seite 4 | Internetnutzung, WLAN-Zugang, Gerätehinweise | Gästeinformation/Sicherheitsdaten |
## 3. Wesentliche Befunde und Prüfaufträge
**F-01 – Verbindlichkeit (§ 5), hohe Priorität.** Die Klausel setzt 'Annahme des Vertrages' mit einer bereits gezahlten Anzahlung in Zusammenhang. Nach der fachlich angenommenen A4-Logik besteht die bindende Portalbuchung aber **vor** unserem späteren Dokumentenversand. Es ist zu prüfen, was vor Vertragsschluss auf FeWo-direkt bereitgestellt wurde. Ein nachgeschicktes PDF darf neue Bedingungen nicht stillschweigend zur bisherigen Buchung hinzufügen. **Fachliches Soll:** Trennung zwischen Nachweis der externen Buchung und nachgelagerter Übermittlung bestehender Bedingungen.
**F-02 – Vollständige Konditionen vor Buchung, hohe Priorität.** Der bisherige Ablauf lässt offen, ob Hausordnung, Internetanlage, Stornoregel, Zusatzleistungen und weitere Bedingungen vor dem FeWo-direkt-Klick einsehbar waren. Die offiziellen Vermieter-AGB verlangen die Offenlegung der jeweiligen Konditionen und erlauben Zusatzvereinbarungen nur im Einklang mit den zuvor veröffentlichten Informationen. **Bestätigter Ist-Zustand:** Die PDF-Vorlage ist nicht im Inserat hinterlegt. **Offen:** Welche Vertragsbedingungen und Unterlagen FeWo-direkt im konkreten Abschluss anzeigt oder übersendet, kann der Betreiber derzeit nicht nachvollziehen. Ob eine Hinterlegung sinnvoll ist, bleibt eine optionale Maßnahme, keine allgemeine Systemvorgabe. Die konkret angezeigten Bedingungen sind gesondert zu ermitteln.
**F-03 – Preisstruktur (§ 4), hohe Priorität.** Das Dokument nennt Gesamtbetrag, Endreinigung, Betreuung, Servicegebühr des Portals, Anzahlung und Restzahlung in einem Text. Erforderlich sind fachlich getrennte Werte: vom Gast verbindlich vereinbarte Gesamtkonditionen, darin enthaltene Unterkunfts-/Leistungsentgelte, ggf. separate Reisenden-Servicegebühr des Portals, Vermieterprovision, Auszahlungsbetrag und Zahlungsstatus. **Keine zusätzlichen Beträge durch FewoPortal erheben, die nicht Bestandteil der Vereinbarung sind.** Konkrete Gebührenstruktur im Vermieter-/Gastbeleg gegenprüfen.
**F-04 – Storno (§ 13), hohe Priorität.** Die Vorlage enthält die oben genannten Staffeln. Nicht belegt ist, ob exakt diese Staffel für die konkrete FeWo-direkt-Buchung vor Abschluss angezeigt und vereinbart wurde. Der Gast kann laut FeWo-direkt über sein Konto stornieren; Erstattungen richten sich nach der anwendbaren Richtlinie. Der Vermieter darf daher aus der nachträglich versandten Vorlage keine abweichenden Gebühren ableiten. Vermieterseitige Stornierungen sind zusätzlich durch FeWo-direkt-Sanktionsregeln besonders riskant.
**F-05 – Gast- und Meldedaten (§ 3), mittlere Priorität.** Der Vertrag sieht die örtliche Anmeldung durch einen Dienstleister und die Kurabgabe vor. Welche Felder für wen und zu welchem Zeitpunkt rechtlich erforderlich sind, muss anhand der kommunalen Vorgaben gesondert definiert werden. Die im Vertrag genannten Tarife und Altersgrenzen stimmen mit der derzeit öffentlich ausgewiesenen Kühlungsborner Information überein, sollten aber nicht dauerhaft als fixe Vertragskonstanten im Produkt behandelt werden.
**F-06 – Rechtlich prüfbedürftige Vertragsklauseln, hohe Priorität.** Besonders § 10–11 (pauschale Einschränkungen von Mietminderung/Beanstandungen), § 15 (vorgegebener Gerichtsstand Dortmund für private Gäste), § 16 (Schriftform/E-Mail), § 17 (Datenverwendung/Übermittlung an Dienstleister) und die Formulierung zur maschinellen Unterschrift sind juristisch zu prüfen. Die Wirksamkeit ist nicht allein aus dieser Analyse abschließend zu beurteilen.
**F-07 – Zugangsdaten und Anlagen, hohe Priorität.** Seite 2 und 4 enthalten feste Zutritts-/WLAN-Daten. Diese sollten nicht dauerhaft Bestandteil der allgemeinen, archivierten Vertragsvorlage sein. Empfehlung: separate, gezielt zur Anreise freigegebene Gästeinformation. Bereits offengelegte Zugangsdaten kontrollieren/ggf. wechseln. Eine separate Internet-Nutzungsvereinbarung ist fachlich eine versionierte Anlage, muss aber in ihrem rechtlichen Status geklärt sein.
**F-08 – Unterschiedliche Dokumentzwecke, mittlere Priorität.** Vertrags-/Konditionsnachweis, ortsbezogene Aufenthaltshinweise und sensible Zugriffsinformationen nicht zwingend in einem vierseitigen 'Mietvertrag' bündeln. Ziel: **ein gemeinsames, einfaches FewoPortal-Dokumentenmanagement** mit richtigem Zeitpunkt der Bereitstellung, kein neues eigenständiges Buchungsformular.
**F-09 – Datenqualität, mittlere Priorität.** Die konkrete Vorlage enthält variable, noch unbesetzte Felder (z. B. Reisende, Daten, Preis, Nächte). Beim Dokumenterstellen müssen Vollständigkeit, Übereinstimmung mit der Portalbuchung und Version der gültigen Anlagen geprüft werden; bei einem Konflikt wird der Versand gesperrt bzw. eine Klärung ausgelöst.
## 4. Soll-Funktionsbild für A4 (noch nicht beschlossen)
**Bindungsnachweis aus FeWo-direkt** → **Portalpreis und bei Buchung vereinbarte Konditionen übernehmen** → **Gastdaten gezielt nachfordern** → **Dokumente aus verifiziertem Konditionsstand erstellen und ohne zweite Annahme übermitteln** → **Portalzahlungen/Storno extern verfolgen, ohne Zahlungen zu erfinden** → **separate Anreiseinformationen und Dienstleisteraufgaben auslösen**.
Bei einer Abweichung zwischen dem vom Gast akzeptierten Konditionsstand und dem späteren Dokument **nicht automatisch ein abweichendes Vertragsdokument verschicken**, sondern in FewoPortal einen Klärungsfall eröffnen.
## 5. Noch offene fachliche Klärung
**Welche Konditionen sieht und bestätigt der Gast bei einer konkreten FeWo-direkt-Direktbuchung und welche Dokumente erhält er anschließend tatsächlich vom Portal?**
Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [Portalprofile und Vertragsvorlagen](00_Portalprofile_und_Vertragsvorlagen.md).
## 6. Öffentliche Quellen für die juristisch-technischen Prüfpunkte
- [FeWo-direkt – AGB für Vermieter (29.10.2026), insb. Nr. 2.2–2.3](https://www.fewo-direkt.de/lp/b/partner-terms-of-use)
- [FeWo-direkt – Hochladen Ihres Mietvertrags](https://hilfe.fewo-direkt.de/articles/Wie-kann-ich-meinen-Mietvertrag-hochladen)
- [FeWo-direkt – Stornierungen durch Gäste](https://hilfe.fewo-direkt.de/articles/Kann-ein-Urlauber-eine-Reservierung-stornieren)
- [FeWo-direkt – Richtlinie für Gastgeberstornierungen](https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy)
- [§ 305 BGB – Einbeziehung von AGB](https://www.gesetze-im-internet.de/bgb/__305.html)
- [§ 307 BGB – Inhaltskontrolle](https://www.gesetze-im-internet.de/bgb/__307.html)
- [§ 309 Nr. 5 BGB – Pauschalierter Schadensersatz](https://www.gesetze-im-internet.de/bgb/__309.html)
- [§ 536 BGB – Mietminderung](https://www.gesetze-im-internet.de/bgb/__536.html)
- [§ 38 ZPO – Gerichtsstandsvereinbarung](https://www.gesetze-im-internet.de/zpo/__38.html)
- [§ 126 BGB – Schriftform](https://www.gesetze-im-internet.de/bgb/__126.html), [§ 127 BGB – Vereinbarte Form](https://www.gesetze-im-internet.de/bgb/__127.html)
- [Kühlungsborn – Kurabgabe](https://www.kuehlungsborn.de/kurabgabe/)
**Abgrenzung:** Dies ist eine fachliche Prozess- und Risikoprüfung, keine rechtliche Freigabe und keine eigenmächtige Überarbeitung der Betreiber-Vertragstexte.
@@ -1,106 +0,0 @@
---
id: A04-DOK-ARCHIV
typ: prozessanalyse
titel: FeWo-direkt – Vertragsvorlage und Einordnung in den A4-Istprozess
status: diskussionsentwurf
version: "0.3"
stand: 2026-10-31
prozess: V01
archetyp: A4
quellen:
- "Vorlage MV für fewo-direkt.pdf (4 Seiten, Betreiber)"
- "Betreiberbeschreibung: manueller A4-Istprozess, 31.10.2026"
---
> **Historischer Bearbeitungsstand (ursprünglich v0.2)** – für die aktuelle Analyse siehe [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A4 – aktuelle Hauptfassung]].
# A4 – Vertragsvorlage und Prozessanalyse (historische Fassung)
> **Arbeitsdokument, keine Freigabe zur Änderung rechtlicher Klauseln.** Die Vertragsvorlage ist ein Beispiel für den aktuellen Ablauf, kein Nachweis der beim Buchungsabschluss über FeWo-direkt tatsächlich akzeptierten Konditionen. **Zugangscodes, Passwörter, persönliche Kontaktdaten und Namen von Gästen werden hier bewusst nicht reproduziert.**
## 1. Einordnung in den dokumentierten Istprozess
1. FeWo-direkt bestätigt extern eine verbindliche Buchung und sendet eine E-Mail mit Gastname und Zeitraum.
2. Der Vermieter sperrt andere Belegungskalender manuell.
3. Im FeWo-direkt-Vermieterbereich werden verfügbare Gastkontakte und Buchungs-/Preisdaten ermittelt.
4. Fehlende Angaben aller tatsächlich erforderlichen Reisenden werden per Gastkontakt angefordert.
5. Der Vermieter erstellt einen individuellen Mietvertrag anhand der vierseitigen Vorlage und versendet ihn mit der Internetvereinbarung.
6. FeWo-direkt fordert Anzahlung und Restzahlung an und verarbeitet diese; Vermieter hat nach eigener Aussage unzureichende Zahlungstransparenz.
7. FeWo-direkt versendet ca. 72 Stunden vor Check-in eine Gastinformation (Betreiberangabe).
8. Vermieter informiert lokale Dienstleister (Schlüssel, Reinigung, Gästebetreuung).
9. Stornierungen werden nach aktueller Praxis über FeWo-direkt abgewickelt; konkrete Verantwortlichkeiten und Statusübermittlung sind noch zu prüfen.
### Nachtrag: vom Betreiber bestätigte Portalpraxis (31.10.2026)
- **Der eigene vierseitige Mietvertrag ist nicht im FeWo-direkt-Inserat hinterlegt.** Gäste erhalten ihn erst im nachgelagerten eigenen Versand, soweit der derzeitige Ablauf beschrieben ist.
- Der Betreiber **kann derzeit nicht einsehen**, welche Buchungs-/Vertragsunterlagen FeWo-direkt dem Gast im konkreten Abschluss zusendet. Deshalb ist **nicht nachgewiesen**, welche Klauseln der Gast wann erhält und akzeptiert.
- **Mietpreise müssen nach bisheriger Praxis im FeWo-direkt-Kalender gepflegt werden**; Rabatte und Stornobedingungen werden ebenfalls im Portal verwaltet. Der bei Buchung vereinbarte Portalkonditionsstand ist für diese Buchung maßgeblich und darf nicht durch unsere eigene Kalkulation ersetzt werden.
- Dies ist ein **konkretes Kanalprofil A4**, **keine allgemeine Regel** für andere Portale. Andere Kanäle können Preise, Konditionen, Vertrag und Abwicklung anders verteilen.
- **Die Vertragsvorlage wird passend zu Portal, tatsächlichem Buchungstyp und ggf. Herkunft ausgewählt**. Andere Portale können eigene Vorlagen und Anlagen erfordern; bestehende Vertragsdokumente werden versioniert.
## 2. Was die vierseitige Vorlage derzeit enthält
| Textabschnitt | Inhalt | Prozesszuordnung |
|---|---|---|
| Präambel, § 1–2 | Vertragsparteien, konkrete Ferienwohnung, Zeitraum, An-/Abreisezeiten | P02/P04 |
| § 2–3 | Schlüsselübergabe durch lokalen Dienstleister, Kurabgabe/Anmeldung | P04 |
| § 4 | Mietsumme einschließlich verschiedener Kosten; Portal-Servicegebühr; Anzahlung/Restzahlung | P02/P03 |
| § 5 | 'Annahme' des Vertrages durch Anzahlung; Sorgfalt/Schäden | P02 / Sonderfall |
| § 6–9 | Wäsche, Sauna, Schlüssel, Hausordnung | P04 |
| § 10–12 | Sorgfalt, Beanstandungen, Rauchverbot, Internet und Internetvereinbarung | P02/P04 |
| § 13 | Rücktritt: 60+ Tage 0 %, 59–30 Tage 50 %, ab 29 Tage 100 % des Mietpreises; Ersatzmieterregelung | Sonderprozess Stornierung |
| § 14 | Abreise- und Reinigungsanforderungen | P04/P05 |
| § 15–18 | Gerichtsstand, Form, Datenschutz, salvatorische Klausel | Recht/Compliance |
| Anlage Seite 4 | Internetnutzung, WLAN-Zugang, Gerätehinweise | Gästeinformation/Sicherheitsdaten |
## 3. Wesentliche Befunde und Prüfaufträge
**F-01 – Verbindlichkeit (§ 5), hohe Priorität.** Die Klausel setzt 'Annahme des Vertrages' mit einer bereits gezahlten Anzahlung in Zusammenhang. Nach der fachlich angenommenen A4-Logik besteht die bindende Portalbuchung aber **vor** unserem späteren Dokumentenversand. Es ist zu prüfen, was vor Vertragsschluss auf FeWo-direkt bereitgestellt wurde. Ein nachgeschicktes PDF darf neue Bedingungen nicht stillschweigend zur bisherigen Buchung hinzufügen. **Fachliches Soll:** Trennung zwischen Nachweis der externen Buchung und nachgelagerter Übermittlung bestehender Bedingungen.
**F-02 – Vollständige Konditionen vor Buchung, hohe Priorität.** Der bisherige Ablauf lässt offen, ob Hausordnung, Internetanlage, Stornoregel, Zusatzleistungen und weitere Bedingungen vor dem FeWo-direkt-Klick einsehbar waren. Die offiziellen Vermieter-AGB verlangen die Offenlegung der jeweiligen Konditionen und erlauben Zusatzvereinbarungen nur im Einklang mit den zuvor veröffentlichten Informationen. **Bestätigter Ist-Zustand:** Die PDF-Vorlage ist nicht im Inserat hinterlegt. **Offen:** Welche Vertragsbedingungen und Unterlagen FeWo-direkt im konkreten Abschluss anzeigt oder übersendet, kann der Betreiber derzeit nicht nachvollziehen. Ob eine Hinterlegung sinnvoll ist, bleibt eine optionale Maßnahme, keine allgemeine Systemvorgabe. Die konkret angezeigten Bedingungen sind gesondert zu ermitteln.
**F-03 – Preisstruktur (§ 4), hohe Priorität.** Das Dokument nennt Gesamtbetrag, Endreinigung, Betreuung, Servicegebühr des Portals, Anzahlung und Restzahlung in einem Text. Erforderlich sind fachlich getrennte Werte: vom Gast verbindlich vereinbarte Gesamtkonditionen, darin enthaltene Unterkunfts-/Leistungsentgelte, ggf. separate Reisenden-Servicegebühr des Portals, Vermieterprovision, Auszahlungsbetrag und Zahlungsstatus. **Keine zusätzlichen Beträge durch FewoPortal erheben, die nicht Bestandteil der Vereinbarung sind.** Konkrete Gebührenstruktur im Vermieter-/Gastbeleg gegenprüfen.
**F-04 – Storno (§ 13), hohe Priorität.** Die Vorlage enthält die oben genannten Staffeln. Nicht belegt ist, ob exakt diese Staffel für die konkrete FeWo-direkt-Buchung vor Abschluss angezeigt und vereinbart wurde. Der Gast kann laut FeWo-direkt über sein Konto stornieren; Erstattungen richten sich nach der anwendbaren Richtlinie. Der Vermieter darf daher aus der nachträglich versandten Vorlage keine abweichenden Gebühren ableiten. Vermieterseitige Stornierungen sind zusätzlich durch FeWo-direkt-Sanktionsregeln besonders riskant.
**F-05 – Gast- und Meldedaten (§ 3), mittlere Priorität.** Der Vertrag sieht die örtliche Anmeldung durch einen Dienstleister und die Kurabgabe vor. Welche Felder für wen und zu welchem Zeitpunkt rechtlich erforderlich sind, muss anhand der kommunalen Vorgaben gesondert definiert werden. Die im Vertrag genannten Tarife und Altersgrenzen stimmen mit der derzeit öffentlich ausgewiesenen Kühlungsborner Information überein, sollten aber nicht dauerhaft als fixe Vertragskonstanten im Produkt behandelt werden.
**F-06 – Rechtlich prüfbedürftige Vertragsklauseln, hohe Priorität.** Besonders § 10–11 (pauschale Einschränkungen von Mietminderung/Beanstandungen), § 15 (vorgegebener Gerichtsstand Dortmund für private Gäste), § 16 (Schriftform/E-Mail), § 17 (Datenverwendung/Übermittlung an Dienstleister) und die Formulierung zur maschinellen Unterschrift sind juristisch zu prüfen. Die Wirksamkeit ist nicht allein aus dieser Analyse abschließend zu beurteilen.
**F-07 – Zugangsdaten und Anlagen, hohe Priorität.** Seite 2 und 4 enthalten feste Zutritts-/WLAN-Daten. Diese sollten nicht dauerhaft Bestandteil der allgemeinen, archivierten Vertragsvorlage sein. Empfehlung: separate, gezielt zur Anreise freigegebene Gästeinformation. Bereits offengelegte Zugangsdaten kontrollieren/ggf. wechseln. Eine separate Internet-Nutzungsvereinbarung ist fachlich eine versionierte Anlage, muss aber in ihrem rechtlichen Status geklärt sein.
**F-08 – Unterschiedliche Dokumentzwecke, mittlere Priorität.** Vertrags-/Konditionsnachweis, ortsbezogene Aufenthaltshinweise und sensible Zugriffsinformationen nicht zwingend in einem vierseitigen 'Mietvertrag' bündeln. Ziel: **ein gemeinsames, einfaches FewoPortal-Dokumentenmanagement** mit richtigem Zeitpunkt der Bereitstellung, kein neues eigenständiges Buchungsformular.
**F-09 – Datenqualität, mittlere Priorität.** Die konkrete Vorlage enthält variable, noch unbesetzte Felder (z. B. Reisende, Daten, Preis, Nächte). Beim Dokumenterstellen müssen Vollständigkeit, Übereinstimmung mit der Portalbuchung und Version der gültigen Anlagen geprüft werden; bei einem Konflikt wird der Versand gesperrt bzw. eine Klärung ausgelöst.
## 4. Soll-Funktionsbild für A4 (noch nicht beschlossen)
**Bindungsnachweis aus FeWo-direkt** → **Portalpreis und bei Buchung vereinbarte Konditionen übernehmen** → **Gastdaten gezielt nachfordern** → **Dokumente aus verifiziertem Konditionsstand erstellen und ohne zweite Annahme übermitteln** → **Portalzahlungen/Storno extern verfolgen, ohne Zahlungen zu erfinden** → **separate Anreiseinformationen und Dienstleisteraufgaben auslösen**.
Bei einer Abweichung zwischen dem vom Gast akzeptierten Konditionsstand und dem späteren Dokument **nicht automatisch ein abweichendes Vertragsdokument verschicken**, sondern in FewoPortal einen Klärungsfall eröffnen.
## 5. Noch offene fachliche Klärung
**Welche Konditionen sieht und bestätigt der Gast bei einer konkreten FeWo-direkt-Direktbuchung und welche Dokumente erhält er anschließend tatsächlich vom Portal?**
Der nachträgliche eigene Mietvertrag ist **nicht** vorab hinterlegt. Ein extern zu prüfender Beispielbuchungsablauf bzw. belegbarer Buchungsauszug soll die tatsächlichen Konditionen und Dokumente identifizieren; die Buchung bleibt schon vor unserer Datennachforderung verbindlich, soweit der Portalabschluss dies belegt. Auf Basis dieser Feststellung wird je Kanal die passende **versionierte eigene Vertrags-/Dokumentenvorlage** zugeordnet. Siehe [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile und Vertragsvorlagen]].
## 6. Öffentliche Quellen für die juristisch-technischen Prüfpunkte
- [FeWo-direkt – AGB für Vermieter (29.10.2026), insb. Nr. 2.2–2.3](https://www.fewo-direkt.de/lp/b/partner-terms-of-use)
- [FeWo-direkt – Hochladen Ihres Mietvertrags](https://hilfe.fewo-direkt.de/articles/Wie-kann-ich-meinen-Mietvertrag-hochladen)
- [FeWo-direkt – Stornierungen durch Gäste](https://hilfe.fewo-direkt.de/articles/Kann-ein-Urlauber-eine-Reservierung-stornieren)
- [FeWo-direkt – Richtlinie für Gastgeberstornierungen](https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy)
- [§ 305 BGB – Einbeziehung von AGB](https://www.gesetze-im-internet.de/bgb/__305.html)
- [§ 307 BGB – Inhaltskontrolle](https://www.gesetze-im-internet.de/bgb/__307.html)
- [§ 309 Nr. 5 BGB – Pauschalierter Schadensersatz](https://www.gesetze-im-internet.de/bgb/__309.html)
- [§ 536 BGB – Mietminderung](https://www.gesetze-im-internet.de/bgb/__536.html)
- [§ 38 ZPO – Gerichtsstandsvereinbarung](https://www.gesetze-im-internet.de/zpo/__38.html)
- [§ 126 BGB – Schriftform](https://www.gesetze-im-internet.de/bgb/__126.html), [§ 127 BGB – Vereinbarte Form](https://www.gesetze-im-internet.de/bgb/__127.html)
- [Kühlungsborn – Kurabgabe](https://www.kuehlungsborn.de/kurabgabe/)
**Abgrenzung:** Dies ist eine fachliche Prozess- und Risikoprüfung, keine rechtliche Freigabe und keine eigenmächtige Überarbeitung der Betreiber-Vertragstexte.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|Aktuelle FeWo-direkt-Analyse]]
@@ -1,52 +0,0 @@
---
id: P03
typ: prozessphase
titel: Buchungsverwaltung und kaufmännische Abwicklung
status: entwurf
version: "0.9"
---
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
**Status:** Phasengerüst; Detailinterview steht aus.
## Zweck
Verbindliche Buchung, Vertragsnachweise, Zahlungen, Fristen und operative Verwaltungsaufgaben in einem Vorgang steuern, auch bei extern übernommenen Verantwortlichkeiten.
## Aktivitäten (vorläufig)
- Vertrags-/Buchungsbestätigung und Unterlagen verwalten; an den richtigen Empfänger über den verfügbaren Kommunikationsweg übermitteln.
- Fehlende Gast-/Kontaktdaten beschaffen, soweit weitere Aktivitäten sie benötigen.
- Nach intern oder extern zuständigen Zahlungsvorgängen unterscheiden; fällige Aufgaben und Fristen führen.
- Mahn-/Erstattungs-/Stornoprofil des Kanals beachten. Keine zusätzliche automatische Mahnung oder Stornierung ohne Freigabe.
- Belegungs-/Portalabgleich und Konflikte überwachen; Änderungen/Storno als Sonderprozesse behandeln.
- Extern abgewickelte Schritte mit Quelle und Status dokumentieren, nicht als intern abgearbeitet behaupten.
## Gates
Für jede auszuführende Aktivität: erforderliche Daten vorhanden, Verantwortlichkeit, Dokument/Nachweis, Ausführungsstatus und Ausnahmebehandlung geklärt. Ausstehende Zahlung kann parallel zu P04 weiterlaufen.
## Noch offen
Mindestdaten je Portalprofil, eigene versus externe Zahlungsstände, Reconciliation, Übergänge zum Abschluss.
## Flexible Preis- und Zahlungsbearbeitung v0.7
1. Übernommene Positionen **unverändert mit Quelle** speichern: Einzelpositionen, Misch-/Sammelbeträge oder nur verbindlichen Gesamtbetrag. Fehlende Details nicht als 0 interpretieren.
2. **Preis-/Kostenbeziehungen** unterscheiden: Gast ↔ Vermieter (Mietforderung und enthaltene Leistungen); Gast ↔ Portal (mögliche eigene Servicegebühr); Vermieter ↔ Portal (Provision/Servicekosten); Zahlungen, Rückerstattungen und spätere Auszahlungen jeweils separat.
3. **Manuelle Ergänzung und Aufteilung** ermöglichen (auch ohne Portal-API): originalen Sammelbetrag erhalten, abgeleitete Teilpositionen zuordnen, Summen abstimmen, doppelte Zählung verhindern. Nicht bekannte Debitoren/Kreditoren, Rabattbezüge und Gebührenarten als **ungeklärt** führen.
4. **Zahlungsstände** trennen: Gast-Fälligkeit, portalbestätigte Gastzahlung, Auszahlungsvorschau, tatsächlicher Geldeingang, Abweichung/Erstattung. Widersprüche als Klärung auf demselben Vorgang, nicht heimlich mit Eigenkalkulation ausgleichen.
5. **Pflicht nur je Tätigkeit:** Fehlt für eine von uns zu stellende Rechnung die rechtlich nötige Aufschlüsselung, Klärungsaktivität einplanen. Fehlende reine Vermieter-Kostenanalytik darf Anreise oder andere unabhängige Schritte nicht grundsätzlich sperren.
6. **Destination Solutions A3:** Vermieter führt Vertrag, Zahlungsanforderung, Zahlungskontrolle und ggf. Stornobearbeitung; Höhe der Vermittlerprovision je Herkunft unterschiedlich möglich. Keine zusätzliche Provisionsrechnung an den Gast ohne vorbestehende Vereinbarung.
7. **FeWo-direkt A4:** Sichtbarer Gastzahlungsplan und erwartete Auszahlung ersetzen weder den Beleg über Bankeingang noch vollständige Gebührenaufschlüsselung; siehe konkrete A4-Screenshots und offenen 5,51-€-Differenzfall.
[[K01_Preisstruktur_und_Abrechnung|Vertiefung: K01]].
## Präzisierung v0.9 – A6 mit optionalen Gästen und Zusatzleistungen
**A6 kann kaufmännische Aktivitäten auslösen, ohne reguläre Vermietung zu sein (E-024):** Bei Aufenthalt von Familie/Freunden können Gäste/Teilnehmer, Kurabgabe (sofern geschuldet), Wäschepakete, sonstige Zusatzleistungen, Zahlungsfristen und Eingänge erfasst werden. **Mietpreis = 0** darf nicht dazu führen, dass Zusatzleistungen automatisch als kostenlos oder nicht anwendbar gelten. Für reine Reparatur-/Wartungssperren sind Gastzahlung, Gastrechnung und Mahnung nicht anwendbar; gegebenenfalls betriebliche Ausgaben separat nachvollziehen, ohne sie als Gastforderung auszugeben.
**Wiederverwendung:** Gemeinsame Positions-, Zahlungs-, Dokumenten-, Aufgaben- und Ereignisfunktionen statt gesonderter „Sperrenabrechnung“. Nicht bekannte Preisanteile bleiben unbekannt; bestehende Jahrespreise/Portal-Preissnapshots bleiben unverändert.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|Zurück zu P02]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|Weiter zu P04]] · [[K01_Preisstruktur_und_Abrechnung|Preis und Abrechnung]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|Aktuelle FeWo-direkt-Analyse]] · [[P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch|Historischer FeWo-direkt-Entwurf]]
@@ -1,43 +0,0 @@
---
id: P04
typ: prozessphase
titel: Leistungsvorbereitung und Aufenthalt
status: entwurf
version: "0.9"
---
# P04 – Leistungsvorbereitung und Aufenthalt
**Status:** Phasengerüst; Detailinterview steht aus.
## Zweck
Gebuchte Unterkunft und benötigte lokale Dienstleistungen vorbereiten und den Aufenthalt bis zur Abreise begleiten.
## Aktivitäten (vorläufig)
- Anreisedaten, Anreiseinformationen, Kontaktmöglichkeiten und Check-in-Verfahren bereitstellen.
- Meldedaten/Kurabgabe und ortsspezifische Pflichten prüfen und bei Bedarf abwickeln.
- Lokale Stellen für Schlüssel, Reinigung, Hausmeister oder sonstige Leistungen informieren/beauftragen.
- Aufgabenstatus und Leistungserbringung im Buchungsvorgang nachvollziehen, unabhängig vom Ausführenden.
- Anreise, Betreuung/Probleme, Sonderwünsche und Abreise verarbeiten.
## Gates
Informationen und Ressourcen müssen für die **konkret anstehende Leistung** bereitstehen. Fehlende externe Gastdaten nachfordern, ohne den Bindungsstatus der Buchung zu verändern.
## Noch offen
Ob die Organisation des Objektbetriebs vollständig als Supportprozess geführt wird; örtliche Anforderungen; Übergabe- und Eskalationsstandards.
## Ergänzung v0.7: externe Kommunikationszuständigkeit
Bei Portal-Direktbuchungen unterscheiden: Portal kündigt Gastnachricht an, Portalversand ist tatsächlich bestätigt oder Vermieter versendet eigene Informationen. FeWo-direkt kündigt in der gezeigten Buchung eine E-Mail etwa 72 Stunden vor Anreise an; dies ist **noch kein Nachweis**, dass sie dem Gast zugegangen ist. Falls erforderliche Gäste-/Meldedaten fehlen, manuell nachfordern. Bei Destination Solutions führt Vermieter die Gast- und Dienstleisterkommunikation im Rahmen der eigenen Abwicklung.
## Präzisierung v0.9 – fakultative Aufenthaltsleistungen bei A6
**A6 ist kein pauschal gastloser Vorgang:** Private Überlassung an Familienmitglieder/Freunde kann Teilnehmerinformationen, Anreise, Schlüsselübergabe, Wäschepakete, Kurabgabe und Aufenthaltsbetreuung erfordern. Die jeweils einschlägigen lokalen Abgaben und Melderegeln sind **fallbezogen** zu prüfen; private oder kostenlose Nutzung bedeutet keine automatische Befreiung.
**A6 als reine Sperre:** Bei Wartung/Reparatur werden Gästeaktivitäten, reguläre Buchungskommunikation und gegebenenfalls die komplette Aufenthaltsbetreuung übersprungen. Soweit eine reale Arbeit durchgeführt wird, können dafür Aufgaben, Kontakte und Abschlussnotizen im selben Vorgang dokumentiert werden. **Keine zusätzliche Modulpflicht** für Dienstleister- oder Objektverwaltung.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|Zurück zu P03]] · [[P05/P05_Abschluss_und_Nachbereitung|Weiter zu P05]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Supportprozesse]]
@@ -1,46 +0,0 @@
---
id: P05
typ: prozessphase
titel: Abschluss und Nachbereitung
status: entwurf
version: "0.9"
---
# P05 – Abschluss und Nachbereitung
**Status:** Phasengerüst; Detailinterview steht aus.
## Zweck
Buchungs- und Leistungserbringung nachvollziehbar abschließen, Feedback einholen und offene nachlaufende Fälle **kontrolliert an zuständige Folgeprozesse übergeben**, ohne den V01-Hauptprozess deshalb künstlich offen zu halten (E-010).
## Aktivitäten (vorläufig)
- Abreise und Leistungsabschluss dokumentieren.
- Ausstehende Abrechnung, Erstattungen, Schäden oder Nachforderungen erkennen, soweit Teil der unmittelbaren Buchungsabwicklung behandeln und sonst mit nachvollziehbarer Zuständigkeit und Buchungsreferenz an einen Folgeprozess übergeben.
- Reinigung/Reparatur/Objektbereitstellung für nächsten Aufenthalt initiieren und Status verfolgen.
- Dankesnachricht, Feedback und Bewertung im **Buchungsprozess V01** abwickeln.
- Zulässige Informationen an den **eigenständigen Wertschöpfungsprozess V02 – Gästebindung/Marketing** übergeben; ggf. Loyalty-Ereignis auslösen.
## Gates
Fachlicher, finanzieller und objektbezogener Abschluss können unterschiedliche Zustände haben. **Grundsatz (E-010):** V01 kann nach erfolgter Buchungs- und Leistungserbringung fachlich abgeschlossen werden, auch wenn übergebene Ansprüche oder Konflikte noch zu bearbeiten sind. Übergaben müssen zugeordnet, nachvollziehbar und mit der Buchung verknüpft bleiben. **Welche Pflichtaktivitäten den V01-Abschluss konkret freigeben, ist noch offen.**
## Abgrenzung zu alternativen Prozessausgängen (E-011)
P05 beschreibt den regulären Abschluss nach Buchungs- und Leistungserbringung. **Ohne Buchung beendete** Vorgänge (z. B. Angebotsablauf) und **stornierte** verbindliche Buchungen können V01 über andere End-Gates beenden, ohne die regulären P05-Aktivitäten künstlich zu durchlaufen. Offene Folgepflichten und Belege bleiben mit dem ursprünglichen Vorgang verknüpft. Die konkreten Gate- und Nachweiskriterien sind noch offen.
## Noch offen
Genaue Abschlusskriterien und erforderliche Nachweise; Zuständigkeit und Verknüpfung nachlaufender Folgeprozesse; Objektbereitstellung und Abgrenzung zum Folgeaufenthalt; alternativer Ausgang bei Stornierung oder abgebrochenem Vorgang. **Der einheitliche Vorgang bleibt als fachlicher Nachweis bestehen; welche technischen Statusfelder hierfür verwendet werden, ist in der Bestandsanalyse zu prüfen.**
## Ergänzung v0.7: Abrechnung und Nachweislücken
Eine Buchung darf nach erbrachter Leistung fachlich regulär enden, selbst wenn **Provisionsaufschlüsselung, ausstehende Auszahlung oder ungeklärte Sammelgebühren** in einem gesondert zugewiesenen Folgefall weiterbearbeitet werden. Gastbezogene offene Forderungen, Storno- oder Auszahlungsdifferenzen müssen mit Quelle, Verantwortlichem und Buchungsreferenz nachvollziehbar übergeben werden. Fehlende detaillierte Preisaufteilung ist nicht automatisch eine unvollständige Gastleistung.
## Präzisierung v0.9 – Abschluss von A6
**A6-Endergebnisse:** Eigen-/Privataufenthalt abgeschlossen, Wartungs-/sonstige Sperre planmäßig beendet, vorzeitig aufgehoben oder geändert. Der Abschluss kann mit Freigabe/Anpassung der betroffenen Belegung und ggf. externem Kalenderabgleich verbunden sein. Bei privaten Gästen können offene Kurabgabe-/Zusatzleistungszahlungen oder andere Nachlaufaufgaben bestehen, die dokumentiert beziehungsweise übergeben werden. Eine reine Sperre braucht weder Feedbackmarketing noch eine Mietvertragsabrechnung.
**Ein gemeinsamer Vorgang statt separater Buchungsakte:** Dokumente, Bearbeitungsverlauf und gebuchte Leistungen bleiben erhalten. Abschluss-Gates sind **abhängig von der Vorgangsart** und erzwingen keine nicht anwendbaren Phasen.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|Zurück zu P04]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Supportprozesse]]
@@ -1,47 +0,0 @@
---
id: SOURCE-MANIFEST
typ: dokumentationshilfe
titel: "Quellenmanifest"
status: arbeitsstand
version: "0.1"
---
# QUELLENMANIFEST – FewoPortal v0.7
Erstellt: 2026-10-31. 22 Markdown-Dateien im Paket.
| Dokument | Bytes | SHA-256 (Kurz) | Version |
|---|---:|---|---|
| `00_Buchungsarchetypen.md` | 19628 | `1fce0ae9d4d96461` | 0.6 |
| `00_Portalprofile_und_Vertragsvorlagen.md` | 10411 | `1215dc28cbaef9c4` | 0.2 |
| `00_Prozesslandkarte.md` | 14691 | `713b167567fc3872` | 0.7 |
| `A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md` | 20734 | `9f8490a0cf2459ca` | 0.5 |
| `AENDERUNGSUEBERSICHT.md` | 1769 | `38bfdc11e5c036eb` | — |
| `D00_Dokumentationsregel_und_Uebergabe.md` | 4028 | `4cda4ff14c6fec4b` | 0.1 |
| `E00_Entscheidungsprotokoll.md` | 11628 | `e4ce5c34dc02001d` | 0.7 |
| `G00_Gates_und_Uebergaben.md` | 5443 | `22ff22c2ab5dcd92` | 0.7 |
| `K01_Preisstruktur_und_Abrechnung.md` | 7820 | `1d1a32c3e131d5de` | 0.1 |
| `O00_Offene_Portalprueffaelle.md` | 5466 | `64e2b267692d907b` | 0.1 |
| `P01/P01_Buchungseingang_und_Verfuegbarkeit.md` | 3084 | `c973deca69337d9b` | 0.7 |
| `P02/P02_Konditionen_und_Buchungsverbindlichkeit.md` | 5224 | `16a1d7dbca578169` | 0.7 |
| `P03/P03_Buchungsverwaltung_und_Abwicklung.md` | 3387 | `a0fcb52cd97240fa` | 0.7 |
| `P04/P04_Leistungsvorbereitung_und_Aufenthalt.md` | 1763 | `ff623e109d2b5920` | 0.7 |
| `P05/P05_Abschluss_und_Nachbereitung.md` | 2968 | `d32fb1fbc3811f82` | 0.7 |
| `R00_Szenarien/00_Szenariomatrix.md` | 2489 | `febe66f849e094bd` | 0.2 |
| `R00_Szenarien/R01_Eigene_Webseite.md` | 9146 | `7b8c24afbaa006fa` | 0.1 |
| `R00_Szenarien/R08_Destination_Solutions.md` | 6641 | `974b0d42dc0089f2` | 0.1 |
| `README.md` | 4390 | `0522d3c73a8cf032` | 0.7 |
| `S00_Supportprozesse.md` | 3293 | `456ec79411296821` | 0.7 |
| `X00_Sonderprozesse.md` | 3345 | `427cc1e2ca52bd79` | 0.7 |
| `X01_Belegungskonflikte_und_Sperrnachweise.md` | 3846 | `3354e08ef93c9a45` | 0.1 |
## Quellenstand
- Hauptprozess: `/mnt/data/FewoPortal_Dokumentation_v0.6.zip` (mit vollständigen P01–P05).
- Archetypen/Portalprofile/A4: `/mnt/data/FewoPortal_Portalprofile_Update/` v0.5 / v0.1 / v0.4.
- R01 / R00 Szenarien: `/mnt/data/FewoPortal_R01_Arbeitsentwurf/R00_Szenarien/`.
- Entscheidungen: Nutzerinterview vom 31.10.2026.
- Gitea-Stand unbekannt und nicht verändert. **Vor weiteren Änderungen aktuelle Originale anfordern.**
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]] · [[E00_Entscheidungsprotokoll|Entscheidungen]]
@@ -0,0 +1,29 @@
---
id: X07
typ: sonderprozess
titel: Belegungskonflikte, Kalender und Sperrnachweise
status: fachlicher-arbeitsstand
version: "0.10"
---
# Belegungskonflikte, Kalender und Sperrnachweise
## Betriebsrealität
**FeWo-direkt:** Importierte iCal-Belegungen können verzögert übernommen werden; FewoPortal kann nicht garantieren, dass eine eigene Sperre sofort im Portal wirksam ist. **Destination Solutions (konkret verwendeter Zugang):** Keine automatisierte Kalendersynchronisation; Sperren in anderen Portalen werden manuell eingetragen. Eine gesonderte Bestätigung der serverseitigen Übernahme oder Partnerweitergabe steht nach Betreiberangabe nicht zur Verfügung.
Laut Betreiberhistorie gab es **zwei Doppelbuchungen in etwa 20 Jahren**. Dieses niedrige beobachtete Auftreten rechtfertigt pragmatische Sperr- und Klärungsaufgaben, ist aber kein Nachweis der technischen Unmöglichkeit oder künftigen Risikofreiheit. Eine Echtzeitabfrage des führenden Systems durch alle Portale wäre besser, ist **bei den konkreten Integrationen nicht als vorhanden anzunehmen**.
## Fachliches Vorgehen
1. Auslösende Buchung, Quelle/Owner, ggf. externe Referenz und eingehende Zeitstempel erfassen.
2. Eigene Belegungswirkung dokumentieren; automatische Exporte bzw. konkrete manuelle Sperraufgaben anstoßen.
3. Wenn verfügbar Erledigungszeit, Bearbeiter und **Sichtkontrolle/Screenshot** dokumentieren.
4. Den Nachweisgrad korrekt unterscheiden: **Sperrung veranlasst**, **im Zielportal erkennbar**, **im betroffenen Vertrieb nachweislich wirksam**. Ohne entsprechenden Nachweis bleibt Wirksamkeit unbekannt.
5. Bei tatsächlicher Überschneidung beide Verbindlichkeitsnachweise, zeitliche Abfolge und denkbare Ursache prüfen; Lösung bzw. wirksame Änderung/Stornierung mit Beteiligten abstimmen; Kalender-/Finanz-/Dokumentenfolgen nachvollziehen.
Eine Sichtkontrolle beweist nicht den serverseitigen Speicherzeitpunkt oder eine Weitergabe an Partnerportale. Ein technischer Sync-Verzug beweist für sich genommen **keine rechtliche Schuldlosigkeit**. Keine verbindliche Fremdbuchung wegen einer Kalenderspiegelung still löschen; eine Stornoanfrage nicht mit einer wirksamen Stornierung gleichsetzen.
**Abgrenzung:** Interner A6-Sperrvorgang und ein A1/A2-Hold können dieselbe Belegungsmechanik nutzen, bleiben aber unterschiedliche fachliche Anlässe. Fehlende externe Freigabenachweise dürfen ein bereits abgeschlossenes Vertragsverhältnis nicht automatisch umdeuten.
[Zur Prozesslandkarte](../00_Prozesslandkarte.md) · [P01](../V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md)
@@ -0,0 +1,33 @@
---
id: G00
typ: fachkonzept
titel: Gates, Informationsqualität und Übergaben
status: fachlicher-arbeitsstand
version: "0.10"
---
# Gates, Informationsqualität und Übergaben
**Gates sind fachliche Prüfregeln, keine vorgeschriebenen zusätzlichen Statusmaschinen.** Sie unterscheiden nachweisbare Vorgangszustände (z. B. verbindlich gebucht) und Voraussetzungen konkreter Aktionen (z. B. Adresse für ein eigenes Dokument). Nicht jede Aktivität ist in jedem Archetyp erforderlich.
| Gate | Fachliche Frage | Fehlende Information |
|---|---|---|
| **G1 – Eingang** | Ist Anlass/Objekt/Zeitraum, Eingangsart, Kanal/Owner und ggf. Portalreferenz ausreichend qualifiziert? | Unklaren Import prüfen, keine künstliche Buchungsbestätigung |
| **G2 – Bindung/Konditionen** | Eigene fristgerechte Annahme oder externen bindenden Abschluss nachweisbar? Sind die für die konkrete Aktion benötigten Konditionen bekannt? | Nachweis/Einzelinformation klären; Bindung nicht wegen fehlender Anschrift rückgängig machen |
| **G3 – Abwicklung** | Wer ist für Dokumente, Zahlungen, Mahnung, Storno, Erstattung und Kommunikation tatsächlich verantwortlich? | Zuständigkeit/Status als offen erfassen und klären |
| **G4 – Durchführung** | Sind für Gast oder A6-Zweck die nötigen Kontakt-, Leistungs-, Anreise-, Melde- oder Arbeitsinformationen vorhanden? | Nur entsprechende Aktivität zurückstellen oder ergänzen |
| **G5 – Ende** | Ist Leistung bzw. Sperrzweck erfüllt/beendet und sind offene Nachläufer verantwortlich übergeben? | Abschlussbezogene Klärung/Folgeaufgabe |
**Mögliche Ergebnisse:** intern erledigt, extern erledigt (mit Nachweis/Quelle), fachlich nicht anwendbar, offen, widersprüchlich. Extern *verantwortet* ist nicht automatisch extern *erledigt*. `Unbekannt` und `nicht anwendbar` sind voneinander und von `0` zu unterscheiden.
**Wesentliche Nachweise:** Quelle, externe Buchungs-/Vorgangsreferenz, Zeitpunkt, Person/System, gegebenenfalls Beleg, Gültigkeit/Aktualität, tatsächlicher Zustand und nächste Verantwortung. Der Detailgrad hängt von Relevanz und Portalverfügbarkeit ab; es wird kein universelles Nachweis-Enum für jedes Feld verlangt.
**Spezialfälle:**
- Preise können nur als Gesamtbetrag vorliegen; Tagespositionen sind nicht Voraussetzung einer bereits nachgewiesenen Bindung.
- Storno-/Änderungswunsch ist **noch keine** wirksame Stornierung/Änderung.
- Extern gesendete Belegungssperre ist **nicht automatisch** im Zielportal oder Partnernetz wirksam.
- Portalrate „bezahlt“ ist **nicht gleich** tatsächlicher Bankeingang beim Vermieter.
- A6 kann G2/G3/G4 ohne Gast, Vertrag oder Zahlung erfüllen, indem diese Tätigkeiten **nicht anwendbar** sind.
[Zur Prozesslandkarte](../00_Prozesslandkarte.md) · [P02](../V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md)
@@ -0,0 +1,51 @@
---
id: K01
typ: fachkonzept
titel: Preise, Gebühren, Provisionen und Zahlungsstände
status: fachlicher-arbeitsstand
version: "0.10"
---
# Preise, Gebühren, Provisionen und Zahlungsstände
## Geschäftsregel
Bei eigener Angebotsstellung werden normalerweise **Jahres-/Saisonpreise** und ggf. Rabatte, Leistungen und Loyalty berücksichtigt; eine dynamische Hotel-/Flugtarifoptimierung ist nicht Teil des MVP. Bei **extern verbindlichen Buchungen** ist der tatsächlich vereinbarte **Gastpreis** maßgeblich. Die interne Vergleichsberechnung verändert ihn nicht. Die tatsächlich vereinbarten Konditionen und ihre Quelle bleiben pro Vorgang nachvollziehbar.
## Verschiedene wirtschaftliche Größen
| Größe | Bedeutung |
|---|---|
| Gastforderung für Unterkunft/gebuchte Leistungen | Vertraglich dem Vermieter zustehender Betrag, soweit nachgewiesen |
| Gast-Gesamtzahlung im Portal | Kann neben Unterkunft auch portalbezogene Leistungen/Servicegebühren enthalten |
| Gast-Servicegebühr des Vermittlers | Eigene Forderung des Portals gegen Gast, **soweit nachweisbar**; nicht automatisch Vermietermiete |
| Vermieterprovision / Vermittlergebühr | Aufwand des Vermieters; nicht nachträglich als zusätzliche Gastforderung ansetzen |
| Möglicher Partneraufschlag | Kann den gastseitigen Endpreis beeinflussen; nur bei nachgewiesener Berechnung klassifizieren |
| Rabatt | Vom gebuchten Preis abzuziehender/bei Buchung vereinbarter Betrag, gegebenenfalls portalabhängig |
| Zahlungsplan | Raten, Höhe, Fälligkeit und vom Portal gemeldeter Status |
| Vermieterauszahlung | Erwarteter Portalbetrag und tatsächlicher Bankeingang sind **verschiedene Sachverhalte** |
| Kurtaxe/Kurabgabe / Zusatzleistungen | Ggf. separate Positionen auch bei privater Nutzung mit **Mietpreis null** |
## Zulässige Informationsformen
Portale liefern **vollständige Einzelpositionen**, **kombinierte Sammelpositionen** oder **nur einen Gesamtbetrag**. FewoPortal muss alle drei Fälle bearbeiten können, ohne eine Einzelaufstellung zu fingieren. Kombinationen aus Servicepauschale, Provision, Reinigung, Steuern oder anderen Posten dürfen vorläufig als unbekannte Sammelposition bleiben. Bei späterer Aufteilung bleiben **Ursprungswert und Quelle** nachvollziehbar. Teil-/Summenwerte dürfen **nicht doppelt gezählt** werden.
Zu jeder für den Prozess relevanten Information sollen nach Bedarf Betrag/Währung, Positionstyp oder „ungeklärt“, Kosten-/Zahlungsträger, Quelle, Zeitpunkt, Beleg und Zuordnung verfügbar sein. Dies ist **eine fachliche Beschreibung**, keine vorgreifende Datenbankspezifikation. Falls Informationen widersprüchlich sind, beide Beobachtungen erhalten und Klärungsaufgabe anbieten, statt einen Betrag ohne Nachweis zu überschreiben.
## Unterschiedliche Zahlungsstände
- Betrag **vereinbart** / **fällig laut Plan**;
- vom Portal **als bezahlt gemeldet**;
- **Auszahlung angekündigt**;
- beim Vermieter **tatsächlich eingegangen**;
- **erstattet**, **storniert** oder **ungeklärt**.
Die Zuständigkeit für Zahlungseinzug, Mahnung, Rückerstattung und Inkasso ist **kanal- und buchungstypabhängig**. Der Vermieter kann Informationen manuell nachreichen, wenn das Portal sie nicht maschinenlesbar bereitstellt. Eine fehlende Vermittler-Provisionszerlegung blockiert nicht automatisch die lokale Leistungserbringung.
## Konkretes Referenzbeispiel: FeWo-direkt (eine Buchung)
7 Nächte/840,00 € Übernachtungen, −42,00 € Rabatt, 181,51 € „Gebühren und Steuern“, **979,51 € Gastgesamtbetrag**; −84,82 € als „An FeWo-direkt gezahlt“ bezeichnet, **894,69 € ausgewiesene Auszahlung**. Eine zweite Ansicht zeigte **900,20 € erwartete Auszahlung**: Differenz **5,51 € ungeklärt**. Zahlungsraten 390,61 € (als bezahlt markiert) und 588,90 € (später fällig). Diese Angaben sind Beobachtungen in **einer** Portalansicht; sie belegen keine detaillierte Tagespreiszerlegung oder tatsächlich erfolgte Auszahlung.
**Achtung:** Ohne Prüfung der Gebührenzusammensetzung ist keine eindeutige Zuordnung der 181,51 € bzw. 84,82 € als Gast- oder Vermieterprovision zulässig.
[Zur Prozesslandkarte](../00_Prozesslandkarte.md) · [R09 – FeWo-direkt](../Szenarien/R09_FeWoDirekt.md)
@@ -0,0 +1,35 @@
---
id: X00-S00
typ: prozesskatalog
titel: Sonderprozesse und unterstützende Funktionen
status: fachlicher-arbeitsstand
version: "0.10"
---
# Sonderprozesse und unterstützende Funktionen
Sonderprozesse können in mehreren P01–P05-Phasen entstehen und werden **im Zusammenhang mit demselben Vorgang** bearbeitet. Keine parallelen Buchungsakten oder separaten Portalfachprozesse. Nach dem regulären Ende können klar zugewiesene Folgeangelegenheiten weiterlaufen.
## Sonderfälle
| ID | Geschäftsvorfall | Fachliche Kernregel |
|---|---|---|
| X01 | Angebotsänderung/Neuangebot | Vor Vertragsabschluss neue bzw. geänderte Konditionen und passende Angebotsversion; rechtliche Wirkung beachten |
| X02 | Vertragsänderung/Umbuchung | Nach Verbindlichkeit Anfrage, Entscheidung, tatsächliche Wirksamkeit, neue Leistung/Preise und Nachweise trennen |
| X03 | Angebotsablehnung/-ablauf und Holdfreigabe | Kein stilles Lösen anderer wirksamer Belegungen; alternativer Ausgang „ohne Buchung beendet“ |
| X04 | Stornierung/Rücktritt/Aufhebung | Ursache, Initiator, technisch Ausführender und Zuständigkeit trennen; Gast- und Vermieterstorno nicht nach bedientem Button umdeuten |
| X05 | Zahlungsverzug, Mahnung, Erstattung, Streitfall | Vertrags-/Portalverantwortung beachten; offene Nachläufer dokumentieren |
| X06 | Datenkonflikt und Dubletten | Fehlende/widersprüchliche Felder klären; keine Scheingenauigkeit oder Dubletten-Vorgänge |
| X07 | Doppelbuchung, Sperr- oder Portalsynchronisationskonflikt | Belegungs- und Vertragslage sichern, keine verbindliche Fremdbuchung still löschen |
| X08 | No-show, Verlängerung, vorzeitige Abreise | Je nach Vertragsstatus Belegung, Leistungen und Zahlungen anpassen |
| X09 | Reklamation, Schaden, Kaution und Nachforderung | Lokale Klärung und verantwortliche Folgeaufgabe |
**Ereignisprinzip:** Ein Änderungs-/Stornowunsch ist nicht automatisch wirksam. Erfasst werden – soweit relevant – tatsächlicher Grund, Antragsteller, handelnde Person/Portal, Entscheidung, Wirksamkeitszeitpunkt und Folgen für Vertrag, Kalender, Leistungen und Zahlungen. Eine aufgehobene Wartungssperre nutzt dieselben generischen Mechanismen, ist rechtlich aber **keine Mietvertragsstornierung**.
## Unterstützende Funktionen (keine automatischen eigenständigen Module)
S01 Kanal-/Integrationsverwaltung; S02 Kalender- und Belegungsabgleich; S03 Gast-/Objekt-/Teilnehmerstammdaten; S04 Preise, Konditionen, Leistungen; S05 Dokument-/Vorlagenmanagement; S06 Kommunikation, Aufgaben und Fristen; S07 Zahlungen, Forderungen und Portalstatus; S08 buchungsbezogene lokale Dienstleister/Reinigung/Schlüssel/Reparatur; S09 Mandanten/Berechtigungen/Compliance/Sicherheit.
Eine kleine Vermietungsplattform soll diese Funktionen nach Möglichkeit **in den Buchungsvorgang integrieren**. Umfangreiche Objekt- oder Personaldisposition, ein vollumfängliches CRM oder freie Workflow-Modellierung werden durch diesen Katalog **nicht** als MVP-Anforderung festgelegt.
[Zur Prozesslandkarte](../00_Prozesslandkarte.md) · [X07 vertieft](Belegungskonflikte.md)
@@ -1,40 +0,0 @@
---
id: R00
typ: szenariokatalog
titel: Buchungsszenarien und Vergleichsfälle
autor: FewoPortal Fachinterview
status: diskussionsentwurf
version: "0.9"
---
# R00 – Buchungsszenarien und Vergleichsfälle
Die Szenarien sind **Geschäftsvarianten eines generischen Buchungsprozesses V01**, keine separat zu implementierenden Workflow-Systeme. R01 wird als fachlicher Referenzfall zuerst geprüft; weitere Varianten werden anschließend entlang derselben fünf Phasen verglichen.
| ID | Szenario | Eingang und Bindung | Typische Abweichung | Bearbeitungsstand |
|---|---|---|---|---|
| R01 | Eigene Webseite | Anfrage → eigenes bindendes Angebot → Annahme | Hold/Angebotsfrist, eigene Zahlung, Kalenderabgleich | **In Diskussion:** [[R00_Szenarien/R01_Eigene_Webseite\|R01]] |
| R02 | Telefonisch/manuell | Manuell erfasste Anfrage → eigenes Angebot | Eingabe durch Betreiber, Kommunikationskanal | Vorgemerkt |
| R03 | Unverbindliche Portalanfrage | Portal-Anfrage → eigenes Angebot → Annahme | Fehlende Gastdaten, Portal-Kommunikation | Vorgemerkt |
| R04 | Verbindliche Portalbuchung, Vertrag durch uns | Bereits extern verbindlich | Externer bindender Preis, nachträgliche Vertragsdokumentation ohne erneute Annahme, Zahlung je Portal | Vorgemerkt |
| R05 | Portal wickelt verbindliche Buchung vollständig ab | Bereits extern verbindlich | Lokale Leistung und notwendige Informationen, Portal für Vertrag/Zahlung/Mahnung/Storno zuständig | Vorgemerkt |
| R06 | (Historisch) Hub-/Partnervermittlung | Kein eigener Buchungsprozess; A1–A5 richten sich nach Bindung/Abwicklungszuständigkeit | Herkunft allenfalls für Provision/Auswertung relevant | Als separates Szenario nicht weiterführen (E-012) |
| R07 | **A6: Eigenbelegung, Privatüberlassung, Wartungs-/sonstige Sperre** | Interner Belegungsanlass, ggf. Gäste und kostenpflichtige Zusatzleistungen | Gemeinsamer Vorgang mit passender Bestätigung und bedarfsabhängig verkürztem P01–P05-Ablauf | **[[R00_Szenarien/R07_Eigenbelegung_und_Sperren\|R07 – A6-Referenzszenario]]** |
**Quellen:** Ausgangsdokumente vom 30./31.10.2026 und Entscheidungsstand der Prozessarchitektur v0.6. Die Bearbeitungsstände beziehen sich auf das Fachinterview, nicht auf die Implementierung.
## Ergänzung v0.2: Externe Direktbuchung
**R08 – Destination Solutions (A3):** Bereits verbindliche Buchung, danach Vertrags-/Zahlungs-/Gastabwicklung durch Vermieter; manuelle Sperre externer Kalender, kein belegter Partner-Sync; unterschiedliche Vermittlerprovisionen je Kanal, zusätzliche Gastgebühren und einzelne Preispositionen derzeit unklar. **Der historische Partner-A6 entfällt; der neue A6 beschreibt interne Belegungs-/Sperrvorgänge (E-022).** [[R00_Szenarien/R08_Destination_Solutions|R08 Referenzfall]].
## Präzisierung v0.9 – A6 in der Szenariomatrix
Die Szenariokennung **R07** bleibt für Eigenbelegung/Sperren erhalten und ist nun ein regulärer **A6-Vergleichsfall**, nicht nur ein angrenzendes Belegungsereignis. A6 nutzt denselben Vorgang und dieselben optionalen Funktionen für Gäste, Leistungen, Zahlungen, Vorlagen, Belegung und Änderungen. Siehe [[R00_Szenarien/R07_Eigenbelegung_und_Sperren|R07 – privater Aufenthalt und reine Sperre]].
Für **R01/R02/R03** wurde die konfigurierbare Haltefrist vereinfacht: >0 = Hold plus mögliches bindendes Angebot; 0 = Preis-/Verfügbarkeitsauskunft und erneute Verfügbarkeitsprüfung vor Bestätigung. **Keine unabhängige Preisbindefrist** als MVP-Standard.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen]] · [[R00_Szenarien/R01_Eigene_Webseite|R01 – Eigene Webseite]] · [[R00_Szenarien/R08_Destination_Solutions|R08 – Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|A4 – FeWo-direkt]]
@@ -1,89 +0,0 @@
---
id: R01
typ: geschaeftsszenario
titel: Buchung über eigene Webseite – End-to-End-Referenzfall
status: diskussionsentwurf
version: "0.9"
---
# R01 – Buchung über die eigene Webseite
**Einordnung:** Referenzszenario für V01/P01–P05; keine Freigabe für Code- oder Produktivänderungen. Der Ablauf ist aus den Übergaben (30./31.10.2026) und aus den Entscheidungen E-001–E-011 konsolidiert. Aussagen mit `OFFEN` sind **nicht beschlossen**.
**Quellenbasis:** `crystalline-floating-glacier.md`, `UEBERGABE-BUCHUNGSPROZESS.md` sowie FewoPortal-Prozessarchitektur v0.6, insbesondere `E00_Entscheidungsprotokoll.md`, `G00_Gates_und_Uebergaben.md`, `P01` bis `P05`.
## 1. Ausgangslage und fachlicher Anwendungsfall
Ein Gast möchte eine oder mehrere Nächte in einer auf der Vermieterwebseite angebotenen Ferienwohnung buchen. Er stellt zunächst eine unverbindliche Anfrage. FewoPortal verwaltet den Vorgang bis zum regulären Abschluss als **führendes System**; der Vermieter verwendet grundsätzlich denselben Vorgang und dieselben Konditions-/Vertragsfunktionen wie bei anderen Eingangskanälen.
## 2. Regelfall über fünf Phasen
| Phase | Auslöser und Tätigkeiten | Erforderliches Ergebnis / Nachweis |
|---|---|---|
| **P01 – Eingang und Verfügbarkeitssicherung** | Gast stellt Webseite-Anfrage mit Zeitraum, Personenzahl, Kontaktmöglichkeit und ggf. Leistungen/Sonderwünschen. FewoPortal prüft Verfügbarkeit, legt konfigurierbaren Hold **nur falls Haltefrist > 0** an (Beispiel: 48 h); bei **0** entfällt die Reservierung, stößt Kalender-/Portalabgleich an. Fehlende Daten werden sichtbar und nachgefordert. | Anfrage mit Quelle, Gastzuordnung, Objekt/Zeitraum, Status der Belegung und tatsächlichem Synchronisationsstand. Kein garantiert sofortiger Block bei Fremdportalen unterstellen. |
| **P02 – Konditionen und Verbindlichkeit** | Preis nach Jahres-/Saisonpreisliste, Zusatzleistungen, Rabatten und ggf. Loyalty berechnen; bei **Hold > 0** Vertragsvorlage, Anlagen, Storno- und Zahlungsbedingungen zuordnen; bindendes befristetes Angebot inkl. Vertragsentwurf als versioniertes, unveränderliches Dokument und Konditions-Snapshot erstellen; signierten Annahmelink senden. Rechtzeitige Annahme nachweisen. | **Bei Hold > 0:** verbindliche Buchung durch Annahme unseres bindenden Angebots, mit unverändert nachvollziehbaren Konditionen und Annahmenachweis; sonst alternativer Ausgang **ohne Buchung beendet**. **Bei Hold = 0:** erst erneute Prüfung und ausdrückliche Buchungsbestätigung, kein Annahmelink für ein ungesichertes Angebot. |
| **P03 – Verwaltung und kaufmännische Abwicklung** | Buchungsbestätigung/Vertragsdokumentation versenden; Belegung/Kalender abgleichen; Anzahlung und Restzahlung als Aufgaben/Fristen überwachen; offene Zahlungen ggf. als manuelle Erinnerungs-/Eskalationsaufgaben abwickeln. | Buchung samt Dokumenten, Fristen, Zahlungsstatus und Ereignissen zentral verwaltet. Keine eigenmächtigen automatischen Mahnungen oder Stornos. |
| **P04 – Leistungsvorbereitung und Aufenthalt** | Anreiseinformationen rechtzeitig senden (derzeit dokumentierter Standard: 3 Tage vor Anreise, je Wohnung konfigurierbar); lokale Betreuung, ggf. Meldedaten/Kurabgabe, Schlüssel/Anreise, Aufenthalt und Abreise organisieren. | Für die lokale Leistung erforderliche Daten/Aufgaben erledigt oder kontrolliert zugewiesen; Aufenthalt und Abreise nachvollziehbar. Örtliche rechtliche Pflichten separat zu prüfen. |
| **P05 – Abschluss und Nachbereitung** | Abschluss der Buchungs-/Leistungserbringung; Dank, Feedback und Bewertungen; Objektfolgeaktivitäten anstoßen; noch offene Forderungen/Schadenfälle geordnet an Folgeprozesse übergeben; ggf. zulässiges Ereignis an V02. | V01 mit Endergebnis **regulär abgeschlossen**. Übergebene offene Fälle bleiben mit der Buchung verknüpft, blockieren den fachlichen Abschluss nicht allein aufgrund ihrer Existenz. |
## 3. Fachliche Leitregeln des Referenzfalls (bereits beschrieben/entschieden)
- **E-002:** ein generischer Prozess, eine gemeinsame Akte und gemeinsame Verwaltungsfunktionen; keine kanalabhängigen Parallelformulare.
- **E-003:** eigenes Angebot ist für den Vermieter bindend und hat eine Annahmefrist. Eine rechtzeitige Gastannahme stellt ohne zweite Vermieterfreigabe die Verbindlichkeit her. Angebot ohne Annahme erlischt; Freigabe der eigenen Vorreservierung nur nach Konfliktprüfung.
- **E-010/E-011:** regulärer Abschluss, ohne Buchung beendet und storniert sind mögliche alternative V01-Endergebnisse; offene Folgefälle werden nachvollziehbar übergeben.
- **Dokumentation:** Vertragsvorlagen/-anlagen sind versioniert, konkrete Angebote/Verträge unveränderlich; Konditionen einschließlich Rabatten und Zusatzleistungen müssen nachvollziehbar bleiben.
- **Kommunikation:** signierter Annahmelink; Mailzustellung/Fehler und wichtige Aktionen nachvollziehbar. Storno-/Hold-Freigabelinks müssen bot-sicher sein.
- **Zahlungen:** Aufgaben/Zusammenfassung, keine unbeauftragten automatischen Mahn-Mails; für R01 wird die Zahlungsüberwachung von uns geführt.
## 4. Szenariovarianten und Ausnahmen zur gemeinsamen Diskussion
| ID | Abweichung / Ereignis | Fachlich erwartete Behandlung (soweit bekannt) | Status |
|---|---|---|---|
| **R01-A01** | Eingangsangaben fehlen oder Gast ist bereits bekannt | Datenklärung, bestehende Kontaktkarte zuordnen, nichts erfinden und keinen zusätzlichen Platzhalter-Gast erzeugen | Grundsatz bekannt; Feldpflichten offen |
| **R01-A02** | Zeitraum nicht verfügbar | Keine ungesicherte Zusage; Anfrage ablehnen oder Alternative anbieten | Alternative/Vorgehen offen |
| **R01-A03** | Parallele Anfragen/Holds für denselben Zeitraum | Kalender- und Verfügbarkeitskonflikt sicher verhindern bzw. klären | Sperr-/Prioritätsregel offen |
| **R01-A04** | Hold endet, während bindendes Angebot noch annahmefähig ist | **Kritischer Widerspruch:** Es darf daraus keine zweite verbindliche Belegung entstehen | Konkrete Fristenkopplung offen |
| **R01-A05** | Externer Kalender übernimmt unseren Hold verspätet oder gar nicht | Quelle, Aktualität, Konflikt und eingeschränkte Zusagefähigkeit erkennen; Folgeaktion bei Kollisionsgefahr | Detaillierte Regeln offen |
| **R01-A06** | Gast wünscht vor Annahme geänderte Daten/Konditionen | Neue Angebotsversion, alte Konditionsstände und Verlauf erhalten; gültige Angebotsfassung für Annahme eindeutig | Grundsatz entschieden, Fristenverhalten offen |
| **R01-A07** | Gast lehnt ab oder Angebotsfrist verstreicht | Ende ohne Buchung; Hold nur nach sicherer Prüfung freigeben; Dokumentation bewahren | Grundsatz entschieden |
| **R01-A08** | Annahme kommt zu spät, wird geändert oder ist nicht eindeutig | Nicht unbesehen als Annahme des alten Angebots buchen; rechtliche und technische Behandlung klären | Details/rechtliche Prüfung offen |
| **R01-A09** | E-Mail wird nicht zugestellt, Annahmelink beschädigt oder doppelt betätigt | Aufgabe/erneute Zustellung bzw. kontrolliert idempotente Verarbeitung, keine doppelte Buchung | Technische Verfahrensregeln offen |
| **R01-A10** | Gast verlangt nach Annahme eine Änderung | Separater Änderungsvertragsprozess; bis wirksamer Bestätigung bleibt der bisherige Vertrag gültig | Fachgrundsatz dokumentiert; rechtliche Prüfung offen |
| **R01-A11** | Gast oder Vermieter storniert | Separater Stornoprozess, Gebühren/Erstattungsaufgaben, Belegungsfolgen und Ende `storniert` | Grundsatz dokumentiert; Details offen |
| **R01-A12** | Anzahlung oder Restzahlung wird nicht geleistet | Aufgaben, Mahnstatus/Eskalation; kein automatischer Storno oder automatische Mahnung ohne Freigabe | Grundsatz dokumentiert; Eskalationsmodell offen |
| **R01-A13** | No-show, vorzeitige Abreise, Verlängerung, Reklamation/Schaden | Aus Aufenthalt angestoßene Sonderprozesse, ggf. Änderung von Leistungen, Termin oder nachlaufender Anspruch | Details offen |
| **R01-A14** | Nach Abreise noch Forderung/Rückerstattung/Schadenbearbeitung offen | Geordnete Übergabe an Folgeprozess mit verantwortlicher Stelle und Buchungsreferenz | Grundsatz E-010 entschieden; Übergabekriterien offen |
## 5. Prüfpunkte mit hoher fachlicher Auswirkung
1. **Bindendes Angebot gegen Belegungssteuerung:** Welche Reservierungsregel garantiert, dass wir während der Annahmefrist liefern können, obwohl externe Portale eventuell nicht sofort synchronisieren?
2. **Zeitliche Kopplung:** Beginnt die Bindungs-/Hold-Frist bereits bei der Anfrage oder erst beim Angebotsversand? Was geschieht bei ausbleibender Angebotsbearbeitung?
3. **Angebotsversion:** Wenn während einer laufenden Frist eine Änderung erbeten wird, welches Angebot bleibt gültig und welche Vorreservierung bleibt bestehen?
4. **Automatikgrenze:** Wann darf das System Preis/Angebot automatisch versenden und wann ist die Vermieterfreigabe erforderlich?
5. **Prioritäten bei Konflikt:** Was ist bei praktisch gleichzeitiger eigener Annahme und externer Direktbuchung die fachliche Reaktion?
## 6. Noch nicht entschieden
Weder genaue Zeitregeln des Holds noch die Konfliktpriorisierung, die Pflichtfelder je Schritt oder der Automatisierungsgrad sind durch dieses Szenariodokument neu entschieden. Dieses Dokument ist ein **Diskussionsentwurf**, der erst nach Betreiberprüfung in die vorhandenen Phasen- und Gate-Dokumente übernommen werden soll.
## 7. Präzisierung v0.9 – mit und ohne Haltefrist
**Entscheidung E-026 (01.11.2026) ersetzt die frühere Annahme, dass stets ein Hold erzeugt wird:**
| Parameter | Haltefrist > 0 | Haltefrist = 0 |
|---|---|---|
| Interne Belegung | Zeitlich befristeter Hold im selben Vorgang | **Kein Hold**, kein aus der Anfrage folgender Block |
| Dokumententyp | Bindendes Mietvertrags-/Buchungsangebot mit darauf abgestimmter Frist | Preis-/Verfügbarkeitsauskunft **ohne vorbehaltlosen Annahmeabschluss** |
| Annahme durch Gast | Fristgerechte wirksame Annahme kann bindende Buchung erzeugen | Gast äußert Buchungswunsch; **erneute Verfügbarkeitsprüfung** und ausdrückliche Bestätigung erforderlich |
| Externe Kalender | Hold-Sperrung je Portalprofil anstoßen / manuelle Schritte | Ohne verbindliche Belegung keine Holds auf Fremdportalen auslösen |
| Fristkonfiguration | Eine Haltefrist je Anfragekanal, z. B. 24/48/72 h | 0 h |
| Preisbindung | Keine separate Preisbindefrist im MVP | Keine separate Preisbindefrist im MVP |
Die ursprünglichen Szenario-Varianten (insbesondere R01-A04 zu auseinanderlaufenden Fristen) bleiben als **kritische Prüfungen für die Variante mit Hold** erhalten. Die bisher diskutierte unabhängige Preisbindefrist wird dagegen **nicht** als MVP-Pflicht geführt. Jahrespreise können saisonal variieren, es ist keine laufende Buchungsklassen-/Yield-Optimierung vorgesehen.
**Vorlagen müssen auf Angebotsart und Kanal abgestimmt sein**; nach tatsächlichem Abschluss unveränderlicher Konditionsstand und Dokumentenstand. Die vorhandene Owner-Zuordnung externer Eingänge ist kein neuer R01-Entwicklungsschritt.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[R00_Szenarien/00_Szenariomatrix|Szenariomatrix]] · [[00_Buchungsarchetypen|Archetypen]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04]] · [[P05/P05_Abschluss_und_Nachbereitung|P05]]
@@ -1,45 +0,0 @@
---
id: R07
typ: geschaeftsszenario
titel: A6 – Eigenbelegung, private Überlassung und sonstige Sperren
status: diskussionsentwurf
version: "0.9"
stand: 2026-11-01
prozess: V01
archetyp: A6
---
# R07 – A6: Eigenbelegung, Privatüberlassung und Sperren
**Status:** Bestätigte Fachgrundsätze E-022–E-028; konkrete technische Umsetzung / lokale Abgabenpflichten noch nicht freigegeben. **Dies ist keine Hub-/Partnervermittlung.**
## 1. Gemeinsame Fachregel
Ein intern qualifizierter Belegungsanlass erzeugt **einen Vorgang**. A6 verwendet dieselben Funktionen und die für ihn geeigneten Aktivitäten von P01–P05. **Vorgang** und **Belegungswirkung** bleiben fachlich unterscheidbar. Der Grund ist konfigurierbar und wird historisiert. Der Vorgang kann Gäste, Leistungen, Zahlungen und Dokumente haben, muss aber nicht.
## 2. Zwei charakteristische Abläufe
| Phase | R07-A: Familien-/Freundesaufenthalt | R07-B: Wartungs-/organisatorische Sperre |
|---|---|---|
| P01 Eingang | Interner Anlass, Zeitraum, Unterkunft, ggf. Beteiligte erfassen; belegen und externe Kalender entsprechend Profil sperren | Anlass und Sperrgrund erfassen; Zeitraum intern sperren, externe Sperraufgaben auslösen |
| P02 Konditionen/Dokument | Ggf. Buchungs-/Aufenthalts- oder Reservierungsbestätigung mit gewählten Bedingungen und Zusatzleistungen | Interne Bestätigung oder kein Dokument, kein Mietvertrag erforderlich |
| P03 Abwicklung | Gäste-/Personendaten soweit nötig, ggf. Kurabgabe, Wäschepaket, sonstige Leistungen, Zahlung und Nachweise | Keine Gastforderung; optional Wartungsausgaben ohne künstliche Gastrechnung |
| P04 Durchführung | Aufenthalt und relevante Vor-Ort-Leistungen betreuen | Arbeiten/Prüfungen durchführen oder Sperrgrund beseitigen |
| P05 Abschluss | Aufenthalt beenden, offene Punkte übergeben, Belegung terminlich abschließen | Sperre aufheben/ändern, Freigabe und externen Kalenderabgleich nachvollziehen |
## 3. Wichtige Grenzziehungen
- **Private Überlassung ist nicht automatisch gast-/abgabenfrei.** Kurabgabe und Meldedaten richten sich nach tatsächlich geltender örtlicher Regel; Befreiungen nicht erfinden.
- **Kostenpflichtige Zusatzleistungen sind unabhängig vom Mietpreis.** Ein Mietbetrag von null darf Wäschepakete oder andere geschuldete Leistungen nicht löschen.
- **Vorlagen gelten pro Vermieter, Objekt, Kanal/Owner, Vorgangsart und Anlass.** Ein Dokument belegt den jeweiligen Stand; es begründet nicht automatisch einen Mietvertrag.
- **Änderungen/Storno:** Gemeinsame Bearbeitungsmechanik für Verkürzung, Verschiebung, Absage oder Freigabe; fachliche Auswirkungen hängen vom Anlass ab. Keine pauschalen mietvertraglichen Stornogebühren.
- **Kein separater Hold-Vorgang:** Die zeitlich befristete Vorreservierung einer A1/A2-Anfrage bleibt innerhalb dieses Vermietungsvorgangs; sie ist keine zusätzliche A6.
- **Externe Sperrung:** Bei Portalen mit manueller Belegungspflege kann die Sicherung trotz richtiger Bedienung verzögert sein; nachgewiesene und nur vermutete Wirksamkeit trennen.
## 4. Noch zu klären
Konkrete Gast-/Teilnehmerpflichtfelder nach örtlichen Regeln, zulässige und wirksame Bestätigungstexte für Privatüberlassung, Ablauf für Rücknahme einer A6-Belegung und technische Ist-Integration bestehender Sperreinträge. Das sind **Prüfpunkte**, keine Gründe für getrennte Workflows.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[R00_Szenarien/00_Szenariomatrix|Szenariomatrix]] · [[00_Buchungsarchetypen|Archetypen A1–A6]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04]] · [[P05/P05_Abschluss_und_Nachbereitung|P05]] · [[00_Portalprofile_und_Vertragsvorlagen|Vorlagen]]
@@ -1,70 +0,0 @@
---
id: R08
typ: geschaeftsszenario
titel: Verbindliche Direktbuchung – Destination Solutions
status: diskussionsentwurf
version: "0.9"
stand: 2026-11-01
---
# R08 – Destination Solutions: Verbindliche Direktbuchung mit Abwicklung durch Vermieter
**Zuordnung:** A3; Partnerherkunft **kein eigener Archetyp**. Der **neue A6** meint interne Eigenbelegung, private Überlassung und Sperren, **nicht** den Partnervertrieb. Dies ist ein reales, vom Betreiber beschriebenes Referenzszenario, keine Implementierungsfreigabe. Anbieter: [Destination Solutions](https://www.ds-destinationsolutions.com/). Die Angaben beschreiben den **konkret verwendeten Betreiberzugang**, nicht zwangsläufig alle Kunden und Softwareprodukte des Unternehmens.
## 1. Dokumentierter Ist-Sachverhalt (Betreiberangaben)
- Der Anbieter bzw. sein Partnernetz vermittelt und bestätigt Buchungen **verbindlich**, bevor der Vermieter sie erhält.
- Die Buchung wird dem Vermieter mit den für die weitere Abwicklung vorgesehenen Daten übermittelt; die Abwicklung von **Vertragsunterlagen, Gastkommunikation, Zahlungsforderung/-kontrolle, Aufenthalt und Folgevorgängen** liegt danach beim Vermieter. Einzelne Preis-/Gebührenpositionen können trotzdem fehlen; vollständige kaufmännische Aufschlüsselung ist nicht bestätigt.
- Für diesen Betreiberzugang gibt es **keinen automatischen Abgleich mit den Vermieterkalendern**. Andere Portale müssen nach Eingang einer Buchung **unverzüglich manuell gesperrt** werden. Für den Zeitpunkt der Portalübernahme/Weitergabe der Sperrung gibt es nach Betreiberangabe **keinen belastbaren Bestätigungsbeleg**.
- Destination Solutions nutzt zusätzlich Partnervertrieb. Der Vermieter erhält je nach Vertriebspartner **unterschiedliche Provisionen**. Eine unbekannte Gastgebühr oder ein Endpreisaufschlag ist **nicht nachgewiesen** und darf nicht als Tatsache modelliert werden.
- Beim Buchungsabschluss ist der Preis bereits vereinbart. Unsere Provision an den Vermittler darf daher **nicht nachträglich als Zusatzforderung gegenüber dem Gast** erhoben werden.
## 2. Generischer Sollablauf P01–P05 mit manuellen Aufgaben
| Phase | Tätigkeiten / Abweichung | Gate / Nachweis |
|---|---|---|
| **P01 Eingang & Belegung** | Eingehende **bereits verbindliche** Buchung übernehmen, Objekt/Zeitraum/Referenz und Gastdaten zuordnen. Eigene Kalender sofort aktualisieren, für nicht angebundene Portale **manuelle Sperraufgabe** erzeugen, mit Bearbeiter und Zeitpunkt quittieren. Bei Kollision X07. | Buchung verbindlich extern; Sperraufgabe erledigt ≠ nachweislich partnernetzweit wirksam |
| **P02 Konditionen/Vertrag** | Ursprünglich vereinbarten Gastpreis und bekannte Konditionen übernehmen, nicht selbst nachkalkulieren. Zugehöriges Vertragsprofil/Anlagen auswählen; Gast bereits gebunden – **keine zweite Annahme**. Storno-/Pflichtbedingungen auf vorvertragliche Einbeziehung prüfen. | Quelle für Gastpreis, vertragsrelevante Bedingungen und ggf. offene Rechts-/Datenlücke |
| **P03 Kaufmännisch** | Eigene Buchungsdokumentation versenden; Zahlungsplan/Anzahlung/Restzahlung festlegen bzw. gemäß Vereinbarung übernehmen, Zahlungen überwachen, Mahn-/Stornofälle selbst führen. Vermittlerrechnung/Provision ggf. nach Kanal zuordnen, Gastservicegebühren nur soweit nachgewiesen. | Eigener Zahlungsstand und offene Finanz-/Konditionsprüfungen erkennbar |
| **P04 Aufenthalt** | Gastkontakt, lokale Ansprechpartner, Anreise, Schlüssel, Reinigung, Kurabgabe/Meldedaten soweit nötig, Aufenthalt/Abreise. | Erforderliche Leistungsinformationen vorhanden; manuelle Schritte möglich |
| **P05 Abschluss** | Aufenthalt abschließen, Feedback, finanzielle Rest-/Provisionsprüfung ggf. Folgefall. | V01 regulär beendet oder offener Nachläufer verantwortlich übergeben |
## 3. Betreiberangabe zu Stornobedingungen
| Zeit vor Mietbeginn | Stornopauschale vom „Mietpreis“ |
|---|---:|
| 60 Tage oder mehr | 0 % |
| 59–45 Tage | 35 % |
| 44–33 Tage | 50 % |
| 32–22 Tage | 70 % |
| 21–12 Tage | 90 % |
| 11 Tage oder weniger | 100 % |
**Wichtige Einschränkung:** Der Betreiber ist nicht sicher, ob diese Bedingungen **bereits vor der Buchung** im Portal angezeigt und wirksam einbezogen wurden oder erst mit dem eigenen, nachträglich übersandten Vertrag vereinbart werden sollen. Ein späteres Dokument kann nicht ohne Weiteres einseitig neue Pflichten begründen. Auch ob „Mietpreis“ nur Übernachtungen oder Zusatzleistungen enthält und wie 90–100 % als Pauschalierung rechtlich einzuordnen sind, muss geprüft werden. Siehe [§ 305 BGB](https://www.gesetze-im-internet.de/bgb/__305.html), [§ 309 Nr. 5 BGB](https://www.gesetze-im-internet.de/bgb/__309.html) und [§ 537 BGB](https://www.gesetze-im-internet.de/bgb/__537.html) als Prüfquellen, **nicht als abschließendes Rechtsgutachten**.
## 4. Finanzielle Unklarheiten / Konfigurationsfragen
1. Wird die vereinbarte Gastmiete vom Portal oder einem Partnerportal **durch eigene Gast-Servicegebühr** ergänzt?
2. Werden je Vermittlungskanal unterschiedliche **Gäste-Endpreise/Vertriebsaufschläge** berechnet?
3. Wie werden Provisionskosten und die (eventuell andere) **vertragliche Mietforderung** beim Vermieter nachgewiesen?
4. Welche Beträge/Positionen sieht der Gast vor dem Abschluss und in der Gast-Buchungsbestätigung?
5. Wie ist die **Stornokostenbasis** bei unbekannten Einzelpreisen definiert; was passiert bei optionalen Leistungen und Neuvermietung?
## 5. Risiko: Nachweislose Sperrung trotz Sofortbuchung
Das System muss die **eigene Ausführung** dokumentieren (Sperraufgabe, Zeitstempel, Screenshot sofern verfügbar) und gleichzeitig ehrlich kennzeichnen, dass kein Nachweis über den Servereingang bzw. die Partnernetz-Verteilung vorliegt. Buchungsüberschneidungen können auch dann auftreten, wenn der Vermieter schnell handelt. **Technisch verursachte Verzögerung beweist für sich genommen keine rechtliche Entlastung.** Livefreigabe durch Vermieter oder Karenzfrist sind hier **nicht vorhandene Ist-Funktionen** und bleiben lediglich hypothetische Integrationsoptionen.
## 6. Quellen- und Verifizierungsstatus
- **Bestätigt aus dem Betreiberinterview:** verbindliche Buchungsübermittlung, komplette weitere Vermieterabwicklung, manuelle Sperre ohne Bestätigungsbeleg, unterschiedliche Vermittlerprovisionen je Partner, Stornostaffel als genannte Vertragsbedingung.
- **Nicht verifiziert:** konkrete Ansicht/Bestätigung des Gastes, Vertragseinbeziehung der Stornoregeln, zusätzliche Gastgebühren oder Aufschläge, Preisaufschlüsselung, verwendete Destination-Solutions-Vertragsvariante, technische Verteilung/Protokollierung.
- Weitere Nachweise erforderlich: [[O00_Offene_Portalprueffaelle|O00]].
## Einordnung v0.9 – Partnervertrieb bleibt A3, A6 ist intern
Die Betreiberentscheidung E-022 ändert **nichts** am Destination-Solutions-Fall: **A3** bleibt maßgeblich; unterschiedliche Provisionen pro Partnerkanal sind kaufmännische Informationen. Der neu benannte A6 ist ausschließlich die [[R00_Szenarien/R07_Eigenbelegung_und_Sperren|interne Belegung und Sperre]].
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[R00_Szenarien/00_Szenariomatrix|Szenariomatrix]] · [[00_Buchungsarchetypen|Archetypen A1–A5]] · [[K01_Preisstruktur_und_Abrechnung|Preisstruktur]] · [[X01_Belegungskonflikte_und_Sperrnachweise|Sperrnachweise]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]]
+39 -61
View File
@@ -1,76 +1,54 @@
---
id: README
typ: projektindex
titel: FewoPortal Prozessarchitektur
status: arbeitsstand
version: "0.9"
id: START
typ: navigation
titel: FewoPortal – Prozessarchitektur
status: fachlicher-arbeitsstand
version: "0.10"
---
# FewoPortal – Prozessarchitektur v0.9
# FewoPortal – Prozessarchitektur
**Status:** Fachlicher Arbeitsstand / Interview, keine Implementierungsfreigabe
**Stand:** 01.11.2026
**Fachliche Sollbeschreibung · Stand 1. November 2026 · Version 0.10**
Diese Konsolidierung führt die Version v0.6 mit **E-011 (alternative fachliche Prozessausgänge)** fort und bewahrt die Betreiberangaben vom 31.10.2026, die v0.3/v0.4, die Entscheidungen E-001 bis E-010 sowie die Übergaben vom 30./31.10.2026. Die **fünf Hauptphasen** dienen als gemeinsames Prozessmodell; ihre Detailregeln sind noch nicht vollständig spezifiziert. **Keine Änderungen am Anwendungscode oder an der produktiven Installation.**
Dieses Verzeichnis beschreibt den **aktuell gültigen fachlichen Arbeitsstand**, nicht den tatsächlichen Implementierungsstand und keine rechtliche Freigabe. Es ist bewusst hierarchisch organisiert. Die Historie der früheren Fassungen gehört in Git; innerhalb der Fachdokumente werden keine veralteten Regelversionen weitergeführt.
## Lesereihenfolge
## Start in Obsidian – Navigationsübersicht v0.9
1. [Prozesslandkarte](00_Prozesslandkarte.md): Produktziel, V01/V02, Prinzipien und Prozessgrenzen.
2. [Buchungsarchetypen](01_Buchungsarchetypen.md): A1–A6 und Verantwortlichkeiten.
3. [Abwicklungsprofile, Konfiguration und Dokumente](02_Abwicklungsprofile_und_Dokumente.md): Vermieterstandards, Kanalabweichungen, Angebotsarten, Vorlagen.
4. **V01 – Hauptwertschöpfungsprozess:** [P01](V01_Buchung_und_Aufenthalt/P01_Buchungseingang_und_Verfuegbarkeit.md) → [P02](V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md) → [P03](V01_Buchung_und_Aufenthalt/P03_Buchungsverwaltung_und_Abrechnung.md) → [P04](V01_Buchung_und_Aufenthalt/P04_Leistungsvorbereitung_und_Aufenthalt.md) → [P05](V01_Buchung_und_Aufenthalt/P05_Abschluss_und_Nachbereitung.md).
5. Bei konkretem Bedarf die **Querschnittsthemen** sowie die **Referenzszenarien** lesen.
Dieses Verzeichnis als **Obsidian-Vault** öffnen. Interne Verweise sind als Obsidian-Wikilinks hinterlegt und verweisen mit Vault-relativen Pfaden auf die vorhandenen Notizen. Die **Prozesslandkarte** dient als fachlicher Ausgangspunkt; Szenarien, Gates und Teilprozesse sind gegenseitig vernetzt.
## Querschnitt und Beispiele
**Hauptprozess:** [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01 Eingang]] → [[P02/P02_Konditionen_und_Buchungsverbindlichkeit|P02 Bindung]] → [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Abwicklung]] → [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04 Aufenthalt]] → [[P05/P05_Abschluss_und_Nachbereitung|P05 Abschluss]].
[Szenariomatrix](Szenarien/00_Szenariomatrix.md) – alle bisherigen und weiteren vorgesehenen Referenzfälle.
**Fachliche Navigation:** [[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen]] · [[R00_Szenarien/00_Szenariomatrix|Szenarien]] · [[G00_Gates_und_Uebergaben|Gates]] · [[S00_Supportprozesse|Support]] · [[X00_Sonderprozesse|Sonderfälle]] · [[E00_Entscheidungsprotokoll|Entscheidungen]].
| Bereich | Dokument | Zweck |
|---|---|---|
| Querschnitt | [Gates und Nachweise](Querschnitt/Gates_und_Nachweise.md) | Voraussetzungen, Zuständigkeit, Ergebnisqualität |
| Querschnitt | [Preis und Zahlung](Querschnitt/Preise_und_Zahlungen.md) | Gesamtbeträge, Sammelpositionen, Provisionen, Zahlungsstatus |
| Querschnitt | [Sonder- und Supportprozesse](Querschnitt/Sonder_und_Supportprozesse.md) | Änderung, Storno, Schaden, Klärung, integrierte Hilfsfunktionen |
| Querschnitt | [Belegungskonflikte](Querschnitt/Belegungskonflikte.md) | Kalender, Sperren, externe Verzögerungen |
| Szenario | [R01 – eigene Website](Szenarien/R01_Eigene_Webseite.md) | Angebot, Annahme, Hold = 0 oder > 0 |
| Szenario | [R07 – Eigenbelegung/Sperren](Szenarien/R07_Eigenbelegung_und_Sperren.md) | A6 mit und ohne Gäste/Leistungen |
| Szenario | [R08 – Destination Solutions](Szenarien/R08_Destination_Solutions.md) | A3 mit manueller Kalendersperrung |
| Szenario | [R09 – FeWo-direkt](Szenarien/R09_FeWoDirekt.md) | A4 mit geteilter Abwicklung |
| Verwaltung | [Gültige Entscheidungen](Entscheidungen.md) | Konsolidierte Beschlüsse; fachliche IDs |
| Verwaltung | [Offene Prüfungen](Offene_Fragen.md) | Recht, Portalverhalten, fachliche und technische Validierung |
| Referenz | [Analyse der bisherigen FeWo-direkt-Vorlage](Referenzen/FeWoDirekt_Vertragsanalyse.md) | Belegmaterial, kein Vertragsmuster zur automatischen Verwendung |
| Referenz | [Quellenverzeichnis](Referenzen/Quellenverzeichnis.md) | Öffentliche Quellen und Grenzen ihrer Aussagekraft |
**Vertiefungen:** [[00_Portalprofile_und_Vertragsvorlagen|Portalprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preis- und Abrechnung]] · [[O00_Offene_Portalprueffaelle|Offene Portalfragen]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt (aktuell)]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]].
## Geltung und Übernahme in das Repository
> **Dateihistorie:** Die fachlich aktuelle FeWo-direkt-Analyse steht im Vault-Stammverzeichnis. Die zwei älteren P03-Fassungen sind als [[P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_historisch|historischer Stand]] und [[P03/A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse_alt_v02|ältere Fassung v0.2]] gekennzeichnet. Letztere musste in v0.9 wegen eines noch vorhandenen doppelten Dateinamens eindeutig umbenannt werden; ihr Inhalt blieb unverändert.
Der Ordner **`docs/Prozessarchitektur/`** soll beim Import als **vollständige neue Fassung ersetzt**, nicht lediglich um die neuen Dateien ergänzt werden. Andernfalls bleiben bisherige Dubletten, historische Markdown-Dateien und unnötige Vault-Konfigurationen aktiv. Git hält den bisherigen Stand weiterhin über frühere Commits vor. Ältere Übergabe- oder Konzeptdateien außerhalb dieses Ordners sind **Hintergrundmaterial**, sofern sie dem hier dokumentierten aktuellen Fachstand widersprechen.
## Dateien
## Navigations- und Pflegeprinzip
- `00_Prozesslandkarte.md` – Generischer Gesamtprozess, Prozessfamilien und Zuordnung
- `P01/` bis `P05/` – je ein eigener Unterordner mit dem bisherigen Phasengerüst; weitere Detaildokumente können dort ergänzt werden
- `G00_Gates_und_Uebergaben.md` – übergreifende Gates
- `S00_Supportprozesse.md` und `X00_Sonderprozesse.md` – vorläufige Kataloge
- `E00_Entscheidungsprotokoll.md` – beschlossene Punkte und offene Fragen
- Normative Fachregel **einmal** am zuständigen Ort; Szenarien illustrieren, ohne sie abweichend neu zu definieren.
- Nur Eltern-Kind-Links und wenige notwendige Querverweise; normale **relative Markdown-Links** für Obsidian, Gitea und VS Code.
- Auf Dateiebene keine Versionsnachträge, künstlichen Link-Fußzeilen oder vollständigen Änderungshistorien. Git dokumentiert Änderungen.
- **Entschieden**, **Betreiberbeobachtung**, **fachliche Empfehlung** und **offener Prüfpunkt** nicht vermischen.
- Eine künftig neue Dokumentbearbeitung beginnt erst mit der ausdrücklich vom Betreiber bereitgestellten aktuellen Repository-Fassung. Der Coding-Agent legt Analyse- und Umsetzungsergebnisse **als Datei im Repository** ab und nennt im Chat nur den Pfad und die wichtigsten Ergebnisse.
**Quellen:** `crystalline-floating-glacier.md`, `UEBERGABE-BUCHUNGSPROZESS.md`, Gesamtprozess v0.3 und die Betreiberpräzisierung vom 31.10.2026. Weitere Fach- und Rechtsprüfung erforderlich.
**Arbeitsregel:** Nur ausdrücklich beschlossene Punkte als Entscheidung kennzeichnen; Vorschläge als solche markieren. Jede Datei trägt einen YAML-Header mit `id`, `typ`, `titel`, `status`, `version`. Die Version v0.5 bezeichnet den konsolidierten **Dokumentationsstand**, nicht eine Implementierungsversion. Bestehende Inhalte werden nicht stillschweigend gekürzt. Änderungen an Gitea erfolgen erst nach Abgleich mit dem dortigen Stand. Keine automatischen Änderungen am produktiven System.
## Konsolidierung v0.7 (31.10.2026)
**Historische Entscheidung E-012 (31.10.2026):** Fünf Buchungsarchetypen A1–A5; der damalige A6 für Partner-/Hubvermittlung wurde gestrichen. **Durch E-022 vom 01.11.2026 fortgeschrieben:** Ein neuer A6 für Eigenbelegung, private Überlassung und Sperren ergänzt A1–A5. Referenzportale: Destination Solutions = **A3**, FeWo-direkt = **A4**. Ein generischer V01-Buchungsprozess mit variabler Aktivitäts- und Informationslage; keine separaten Portalworkflows.
**Neue Anforderungen:** Portal-/Dokumentenprofile, versionierter Vertrags-/Konditionsnachweis, manuelle/automatische/gemischte Datenbeschaffung, flexible Einzel- und Sammelpreise, unbekannte Gastgebühr/Provision ohne Scheingenauigkeit, Abstimmung Zahlungsplan vs. tatsächliche Auszahlung, unsichere Kalender-/Sperrnachweise und Änderungs-/Stornoteilprozesse. Externe Direktbuchungen werden nicht durch neues Eigenangebot ersetzt. Rechtlich ungeklärte Portal- und Stornokonditionen bleiben offene Prüffälle.
**Neue bzw. fortgeschriebene Dateien:**
- [[00_Buchungsarchetypen|`00_Buchungsarchetypen.md`]] – A1–A5 und reale Referenzfälle
- [[00_Portalprofile_und_Vertragsvorlagen|`00_Portalprofile_und_Vertragsvorlagen.md`]] – Profile und Vertragstypen
- [[K01_Preisstruktur_und_Abrechnung|`K01_Preisstruktur_und_Abrechnung.md`]] – Einzel-/Sammel-/Gesamtbeträge, Provisionen, Zahlungsfluss
- [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|`A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse.md`]] – konkrete A4-Beobachtungen und rechtliche Prüffragen
- [[R00_Szenarien/R01_Eigene_Webseite|`R00_Szenarien/R01_Eigene_Webseite.md`]] – früherer Referenzentwurf, **im damaligen Stand noch inhaltlich unverändert, v0.9 präzisiert**
- [[R00_Szenarien/R08_Destination_Solutions|`R00_Szenarien/R08_Destination_Solutions.md`]] – A3 Referenzfall
- [[X01_Belegungskonflikte_und_Sperrnachweise|`X01_Belegungskonflikte_und_Sperrnachweise.md`]] – X07-Vertiefung
- [[O00_Offene_Portalprueffaelle|`O00_Offene_Portalprueffaelle.md`]] – spätere Konfigurations- und Nachweispunkte
- [[D00_Dokumentationsregel_und_Uebergabe|`D00_Dokumentationsregel_und_Uebergabe.md`]] – **Pflicht zur erneuten Dokumentenanforderung vor jedem zukünftigen Edit**
- [[E00_Entscheidungsprotokoll|`E00_Entscheidungsprotokoll.md`]] – Beschlüsse E-012–E-021
**Quellenintegrität:** v0.6 aus dem originalen ZIP extrahiert, da die entpackte v0.6-Verzeichnisansicht P01–P05 nicht enthielt; ergänzende Dokumente aus ihrem jeweils neuesten im Chat verfügbaren Bearbeitungsstand. **Kein direkter Schreibzugriff auf Gitea; keine Repository-Aktualisierung behauptet.** Vor jeder künftigen Änderung aktuelle Quelldokumente erneut vom Betreiber anfordern.
## Neu in v0.9 – Vorgang, A6 und schlanker Angebotsablauf
**Neu v0.9:** Ein **Vorgang** ist die gemeinsame Bearbeitungsklammer für Anfrage, Buchung und interne Sperr-/Belegungsanlässe. Der gesonderte Schritt „Buchungsakte anlegen“ entfällt; die bereits bestehende **Owner-Zuordnung** externer Eingänge wird genutzt. A6 nutzt die gleichen Funktionen und bedarfsgerecht verkürzte Phasen, auch bei Familien-/Freundesaufenthalten mit Gastdaten, Kurabgabe, Wäsche oder Zahlungen.
**A1/A2 vereinfachter Angebotsprozess:** Je relevantem Anfragekanal **Haltefrist 0 oder >0**. Mit Hold kann eine passende verbindliche Buchungsofferte versendet werden; ohne Hold eine Preis-/Verfügbarkeitsauskunft, vor einer Buchungsbestätigung erneut prüfen. **Keine eigenständige Preisbindefrist** und keine dynamischen Hotel-/Flug-Buchungsklassen im MVP.
**Zentrale Einstiege:** [[00_Prozesslandkarte|Prozesslandkarte v0.9]] · [[00_Buchungsarchetypen|A1–A6]] · [[R00_Szenarien/R07_Eigenbelegung_und_Sperren|R07 A6-Szenario]] · [[R00_Szenarien/R01_Eigene_Webseite|R01 Angebotsweg]] · [[00_Portalprofile_und_Vertragsvorlagen|Dokumentenprofile]] · [[E00_Entscheidungsprotokoll|Entscheidungen E-022–E-028]] · [[AENDERUNGSUEBERSICHT|Änderungshistorie v0.9]].
**Technische Einordnung:** Dokumentationsstand für Analyse und gestufte Umsetzung, **keine pauschale produktive Implementierungsfreigabe**. Vor jeder weiteren Dokumentänderung erneut den aktuellen Originalstand anfordern.
## Verknüpfungen (Obsidian)
[[00_Prozesslandkarte|Prozesslandkarte]] · [[00_Buchungsarchetypen|Archetypen A1–A6]] · [[R00_Szenarien/00_Szenariomatrix|Szenariomatrix]] · [[G00_Gates_und_Uebergaben|Gates und Übergaben]] · [[00_Portalprofile_und_Vertragsvorlagen|Portal- und Vertragsprofile]] · [[K01_Preisstruktur_und_Abrechnung|Preis und Abrechnung]] · [[E00_Entscheidungsprotokoll|Entscheidungen]] · [[O00_Offene_Portalprueffaelle|Offene Prüffälle]] · [[D00_Dokumentationsregel_und_Uebergabe|Dokumentationsregeln]]
**Priorität:** Die vollständige, fachlich konsistente Prozesskette ist wichtiger als ein komplexer Workflow-Designer. Technische Umsetzung, Migration und Go-live bedürfen gesonderter Freigabe.
@@ -0,0 +1,43 @@
---
id: A04-DOK
typ: referenzanalyse
titel: FeWo-direkt – Analyse der bisherigen Betreiber-Vertragsvorlage
status: pruefbedarf
version: "0.10"
---
# Analyse der bisherigen FeWo-direkt-Vertragsvorlage
**Grundlage:** Die vom Betreiber bereitgestellte vierseitige Mietvertragsvorlage und Beobachtungen einer konkreten Buchung. Das Dokument ist **keine rechtliche Freigabe**, keine automatische Vertragsvorlage und kein Nachweis, welche Bedingungen der Gast vor dem verbindlichen Portalabschluss akzeptiert hat. Zugangscodes, WLAN-Passwörter und personenbezogene Informationen werden nicht reproduziert.
## Inhalt und fachliche Einordnung
| Teil | Inhalt | Relevanz |
|---|---|---|
| Präambel/§§ 1–2 | Vertragsparteien, Wohnung, Zeitraum, An-/Abreise, Schlüsselservice | P02/P04, individuelle Felder |
| § 3 | Kurabgabe und örtliche Anmeldung | P03/P04, lokale Vorgaben überprüfen |
| § 4 | Mietsumme inkl. Leistungen/Endreinigung/Service, Anzahlung und Restbetrag | Gastpreis, Portal-Servicegebühr, Vermieterprovision und Zahlungsflüsse trennen |
| § 5 | Annahme des Mietvertrags durch Anzahlung | **Problematisch**, wenn Portalbuchung bereits vorher verbindlich war |
| §§ 6–9 | Wäsche, Sauna, Schlüssel, Hausregeln | Vertragliche Leistungen vs. spätere Gästeinformation trennen |
| §§ 10–12 | Sorgfalt, Beanstandung, Mietminderung, Internet-Nutzungsregeln | **Juristisch prüfen**, insbesondere pauschale Haftungs-/Minderungsausschlüsse |
| § 13 | Eigene Stornostaffel: 60+ Tage 0 %, 59–30 Tage 50 %, darunter 100 % | Nicht ohne Vergleich mit **vorher vereinbarter Portalregel** anwenden |
| § 14 | Abreise und Reinigungspflichten | P04/P05 |
| §§ 15–18 | Gerichtsstand, Form, Datenschutz, salvatorische Klausel | Juristische Prüfung, u. a. Verbrauchergerichtsstand, Text-/Schriftform, Datenweitergabe |
| Seite 4 | WLAN- und Internetvereinbarung inkl. Zugangsdaten | Sensible Zugangsdaten getrennt und zum richtigen Zeitpunkt übermitteln |
## Prüf- und Handlungsbedarf
1. **Verbindlichkeit und Einbeziehung:** Der Betreiber hat den eigenen Vertrag **nicht** im FeWo-direkt-Inserat hinterlegt. Welche Bedingungen der Gast bei Portalabschluss tatsächlich sieht, ist offen. Nachträglich versandter Vertrag darf keine neuen nicht akzeptierten Verpflichtungen vortäuschen.
2. **Konditionen:** Gesamtsumme, separate Reisenden-Servicegebühren, Vermittler-/Vermieterprovision, Raten, Erstattungen und Auszahlung nicht vermischen. Fehlende Einzelwerte als unbekannt behandeln.
3. **Storno:** Eigene §13-Staffel kann von den im Portal gezeigten Bedingungen abweichen. Rechtliche Wirksamkeit/Einbeziehung und eventuell zwingende portalbezogene Regeln prüfen.
4. **Klauseln:** Besonders §§ 10–11 (Mietminderung/Beschwerden), 15 (fester Gerichtsstand), 16 (Form), 17 (Datenschutz) anwaltlich prüfen. Keine eigenmächtige Klauseländerung aufgrund dieser Analyse.
5. **Zugangsdaten:** Feste WLAN-/Zutrittscodes aus allgemeinen, langfristig gespeicherten Vertragsunterlagen entfernen und sicher in separaten Anreiseinformationen bereitstellen; mögliche Rotation offengelegter Zugangsdaten prüfen.
6. **Datenqualität:** Individuelle Angaben dürfen nicht leer, erfunden oder unbemerkt vom bestätigten Portalstand abweichend versandt werden. Bei ungeklärten Widersprüchen gezielte Klärung vor dem betroffenen Versand.
**Gebührenbeobachtung und Zahlungsverlauf:** Die Beispielzahlen und die ungeklärte Auszahlungsdifferenz sind unter [R04](../Szenarien/R09_FeWoDirekt.md) und [Preis-/Zahlungsmodell](../Querschnitt/Preise_und_Zahlungen.md) beschrieben, nicht nochmals als abweichende Fassung dieses Referenzdokuments.
## Quelle und Prüfungsvorbehalt
Verwendete Dokumente: ursprüngliche Betreiber-PDF „Vorlage MV für fewo-direkt“ (hier **nicht** enthalten, da personenbezogene und Zugangsdaten); Portalansichten; Betreiberbeschreibung. Relevante öffentliche Regelungen: [FeWo-direkt Gastgeberbedingungen](https://www.fewo-direkt.de/lp/b/partner-terms-of-use), [Mietvertrag hochladen](https://hilfe.fewo-direkt.de/articles/Wie-kann-ich-meinen-Mietvertrag-hochladen), [Gaststornierung](https://hilfe.fewo-direkt.de/articles/Kann-ein-Urlauber-eine-Reservierung-stornieren), [Gastgeberstornierungsrichtlinie](https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy); [BGB §§305](https://www.gesetze-im-internet.de/bgb/__305.html), [309](https://www.gesetze-im-internet.de/bgb/__309.html), [536](https://www.gesetze-im-internet.de/bgb/__536.html); [ZPO §38](https://www.gesetze-im-internet.de/zpo/__38.html).
[Zum FeWo-direkt-Szenario](../Szenarien/R09_FeWoDirekt.md)
@@ -0,0 +1,31 @@
---
id: Q00
typ: quellenverzeichnis
titel: Quellen und Evidenzgrenzen
status: fachlicher-arbeitsstand
version: "0.10"
---
# Quellen und Evidenzgrenzen
## Interne Primärgrundlagen
- **Betreiberinterviews**: Beschreibung der realen FeWo-direkt- und Destination-Solutions-Abläufe, Preis- und Stornokonfiguration, Gästedaten, manueller Sperren, privaten Nutzungen und Dokumentenanforderungen.
- **FeWo-direkt-Beispielbuchung**: Vier Screenshots mit zusammengefassten Zahlungen und Raten. Sie belegen den dort angezeigten Zustand, **nicht** eine allgemeine Exportfähigkeit, die Gastbestätigung oder einen echten Bankeingang.
- **Vierseitige Vertragsvorlage des Betreibers**: Grundlage für die Analyse rechtlicher und fachlicher Prüfpunkte. Sie ist kein Nachweis wirksamer Einbeziehung vor einer extern verbindlichen Buchung und wird aus Datenschutz-/Sicherheitsgründen **nicht als Original-PDF beigepackt**.
- **Coding-Agent-Bestandsanalyse vom 01.11.2026**: Hinweise zum technischen Ist-Stand; nicht unabhängig verifiziert. Die aktualisierte Fachspezifikation ist **keine technische Architekturentscheidung**.
## Öffentliche Fach-/Rechtsquellen (zur individuellen Prüfung)
- [FeWo-direkt: Gastgeberbedingungen](https://www.fewo-direkt.de/lp/b/partner-terms-of-use)
- [FeWo-direkt: Gastbedingungen](https://www.fewo-direkt.de/lp/b/terms-of-service)
- [FeWo-direkt: Mietvertrag hochladen](https://hilfe.fewo-direkt.de/articles/Wie-kann-ich-meinen-Mietvertrag-hochladen)
- [FeWo-direkt: Gastgeberstornierungsrichtlinie](https://www.fewo-direkt.de/tlp/trust-and-safety/partner-initiated-cancellation-policy)
- [Destination Solutions](https://www.ds-destinationsolutions.com/)
- [BGB §§145](https://www.gesetze-im-internet.de/bgb/__145.html), [148](https://www.gesetze-im-internet.de/bgb/__148.html), [150](https://www.gesetze-im-internet.de/bgb/__150.html), [305](https://www.gesetze-im-internet.de/bgb/__305.html), [309](https://www.gesetze-im-internet.de/bgb/__309.html), [537](https://www.gesetze-im-internet.de/bgb/__537.html)
- [ZPO §38](https://www.gesetze-im-internet.de/zpo/__38.html)
- [Kühlungsborn – Kurabgabe](https://www.kuehlungsborn.de/kurabgabe/)
**Wichtig:** Öffentlich verfügbare Portaldokumentation beschreibt nicht zwangsläufig Funktionen des **konkreten Betreiberkontos**. Gesetzeslinks markieren Rechtsprüffelder, keine abschließende juristische Beratung. Die meisten Geschäftsregeln dieser Dokumentation stammen aus ausdrücklich dokumentierten Betreiberentscheidungen und benötigen deshalb keine zusätzliche externe Rechtfertigung.
[Zur Startseite](../README.md)
@@ -1,44 +0,0 @@
---
id: S00
typ: prozesskatalog
titel: Supportprozesse
status: arbeitsstand
version: "0.9"
---
# S00 – Supportprozesse (vorläufiger Katalog)
Diese Prozesse unterstützen V01 und V02. **Produktmandat E-007 bis E-009:** FewoPortal richtet sich zunächst an Vermieter mit typischerweise 1–3 Ferienwohnungen, mehreren möglichen Mandanten, aber **ohne Marktplatz-/Agentur-Schwerpunkt**. Ein fachlicher Supportprozess rechtfertigt **kein eigenständiges Softwaremodul**. Buchungsbezogene Aufgaben sind möglichst im gemeinsamen Vorgang integriert und automatisiert; weitergehende Objektverwaltung bleibt Zukunftsoption.
| ID | Prozessfamilie | Wofür gebraucht? |
|---|---|---|
| S01 | Portal- und Integrationsmanagement | Kanäle/Portale, Herkunft, Konnektoren, Prozessprofile; Unterscheidung Vertriebs-/Marketingkanal und Buchungsabwicklung |
| S02 | Belegung und Kalendersynchronisation | Verfügbarkeit, Holds, Sperrzeiten, Sync/Abgleich und Konflikte |
| S03 | Stammdaten | Gäste, Objekt, Kontakte, Dienstleister; Quellen/Historie |
| S04 | Preise und Konditionen | Saison, Sonderleistungen, Rabatte, Loyalty-Input, Portalpreis-Übernahme |
| S05 | Dokumente und Nachweise | Vorlagen, Anhänge, Angebot-/Vertrags-Snapshots, Versionen |
| S06 | Kommunikation und Aufgaben | E-Mail, Portalnachricht, Fristen, Fallback, Eskalation |
| S07 | Zahlungs-/Forderungsverwaltung | Zahlungspläne intern; Portalzuständigkeit und Status extern |
| S08 | Buchungsbezogene Objekt- und Dienstleisterleistungen | Reinigung, Schlüsselübergabe, Vorbereitung, bei Bedarf Reparatur **als integrierte Aktivitäten in P04/P05**; keine umfassende Objektverwaltung im heutigen Produktumfang |
| S09 | Administration und Compliance | Mandanten, Rechte, Datenschutz, Sicherheit, Nachvollziehbarkeit |
**Einordnung für den heutigen Produktumfang:** S01–S07 und S09 soweit für Buchungsabwicklung nötig; S08 schlank in P04/P05. V02-Marketing und Loyalty sind **Wertschöpfung** und nicht bloß allgemeine administrative Supportprozesse. Marketingfunktionen werden fachlich vorgesehen, aber nach dem Kernbuchungsprozess detailliert.
Einzelheiten folgen nach Freigabe der Gesamtprozesslandkarte. Keine zusätzlichen Organisations-/Oberflächenmodule aus dieser Tabelle ableiten.
## Präzisierung v0.7 (E-012 bis E-020)
- **S01:** Portalprofil umfasst tatsächliche Datenschnittstelle (oder manuelle Schritte), Ausführungsverantwortung, Quellennachweis, Preis-/Storno-Verfügbarkeit und den Status nachgelagerter Vertriebskanäle, soweit relevant. Partnerherkunft ist **kein A6-Prozess**; nur kaufmännisches Merkmal bei Bedarf.
- **S02:** Kalenderverzögerung, manuelle Sperrung und fehlender Bestätigungsbeleg als reale Normalfälle. „Exportiert“ oder „im Portal eingetragen“ ist nicht gleich „partnernetzweit wirksam“.
- **S04/S07:** Kaufmännische **Einzel-, Sammel- und Gesamtbeträge** unterstützen; Gast-Servicegebühr, Vermieterprovision, Preisaufschlag, Rabatte, Zahlung und Auszahlung getrennt, soweit feststellbar. Unbekannte Zusammenhänge bleiben ungeklärt; manueller Abgleich möglich.
- **S05/S06:** unterschiedliche Vertragsvorlagen/Anlagen und Versionen je Buchungsprofil; manuelle Daten-/Dokumentenbeschaffung und Klärungsaufgaben ohne separate Portalsoftware-Workflows.
## Präzisierung v0.9 – Supportfunktionen auch für A6
**A6 nutzt die bestehenden Unterstützungsfunktionen:** Belegung, Gästedaten (falls relevant), Dokumente, Leistungen, Zahlungen, Kalenderabgleich sowie Aufgaben. Reine Sperren erfordern keine eigene Gäste-/Vertragsverwaltung. **Kein neues „Sperrverwaltungssystem“** und keine Wiederimplementierung des vorhandenen Buchungs-Owner-Mechanismus; der Coding-Agent soll die tatsächliche Ist-Architektur prüfen.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03 Abwicklung]] · [[P04/P04_Leistungsvorbereitung_und_Aufenthalt|P04 Aufenthalt]] · [[X00_Sonderprozesse|Sonderprozesse]]
@@ -0,0 +1,26 @@
---
id: R00
typ: szenarienkatalog
titel: Referenz- und Prüfszenarien
status: fachlicher-arbeitsstand
version: "0.10"
---
# Referenz- und Prüfszenarien
Die Fälle prüfen denselben Hauptprozess V01 entlang unterschiedlicher Quellen und Verantwortlichkeiten. Nicht für jeden vorgemerkten Vergleich ist bereits ein separates Dokument erforderlich.
| ID | Szenario | Typ | Dokument-/Prüfstatus |
|---|---|---|---|
| **R01** | Anfrage über eigene Website mit und ohne Hold | A1 | [Ausgearbeitet](R01_Eigene_Webseite.md) |
| R02 | Telefonische/manuelle Anfrage | A1/A2 je Ursprung | Vorgemerkt; keine zusätzliche Prozessvariante |
| R03 | Unverbindliche Portalanfrage | A2 | Vorgemerkt; Gastdaten/Portalnachricht können unvollständig sein |
| R04 | Externe verbindliche Buchung, Vertrag/Zahlung durch uns | A3 | Generischer Vergleichsfall; konkret als R08 geprüft |
| R05 | Portal wickelt Vertrag/Zahlung/Storno weitgehend selbst ab | A5 | Vorgemerkt; nur eigene lokale Pflichten |
| **R07** | Interne Belegung, private Überlassung, Wartung | A6 | [Ausgearbeitet](R07_Eigenbelegung_und_Sperren.md) |
| **R08** | Destination Solutions, direkte Bindung + eigene Abwicklung | A3 | [Ausgearbeitet](R08_Destination_Solutions.md) |
| **R09** | FeWo-direkt, direkte Bindung + geteilte Abwicklung | A4 | [Ausgearbeitet](R09_FeWoDirekt.md) |
**Partnerherkunft** ist kein eigener Falltyp; sie kann bei Bedarf Auswirkungen auf Provision und ausgewiesenen Endpreis haben. A4 ist eine geteilte Abwicklungsvariante, nicht dasselbe wie der allgemeine R04-Fall mit weitgehend eigener Abwicklung.
[Zur Startseite](../README.md)
@@ -0,0 +1,38 @@
---
id: R01
typ: referenzszenario
titel: Eigene Website – Anfrage bis Abschluss
status: fachlicher-arbeitsstand
version: "0.10"
---
# R01 – Eigene Website (A1)
Ein Gast fragt eine Wohnung mit Zeitraum, Kontakt und ggf. Zusatzleistungen an. Es entsteht ohne zusätzlichen Klick ein **Vorgang**. Bei Anfragen über einen externen Vermittler (A2) ist derselbe Grundablauf nutzbar, nachdem fehlende Daten nachgefordert wurden.
## Regelfall
| Phase | Vorgehen |
|---|---|
| **P01** | Eingang erfassen, Gast zuordnen, Verfügbarkeit prüfen; **nur bei Haltefrist > 0** Hold anlegen und nach Kanal-/Portalprofil Sperrungen veranlassen |
| **P02** | Jahres-/Saisonpreis, Leistungen und Rabatte zusammenstellen; richtige Vorlage/Anlagen wählen; bei Hold > 0 bindendes befristetes Angebot und Annahmelink; rechtzeitige Annahme stellt Verbindlichkeit ohne zweite Freigabe her |
| **P03** | Vertrag/Buchungsbestätigung, Zahlungsplan, Aufgaben und Fristen im Vorgang; keine unbeauftragte automatische Mahnung oder Stornierung |
| **P04** | Gäste-/Anreiseinformationen, lokale Leistungen, ggf. Kurabgabe und Meldedaten; Anreise-Info je konfiguriertem Ablauf (bisherige Praxis etwa drei Tage vorher) |
| **P05** | Aufenthalt abschließen, Dank/Feedback/Bewertung, Objektbereitstellung und ggf. kontrollierte Nachläuferübergabe |
## Variante: Haltefrist 0
Es wird **keine Reservierung** ausgelöst. Die Antwort ist eine Preis-/Verfügbarkeitsauskunft unter Vorbehalt und kein unbedingtes Mietvertragsangebot. Will der Gast buchen, erfolgt **eine neue Verfügbarkeitsprüfung**. Anschließend bestätigt FewoPortal automatisch oder legt die Entscheidung dem Vermieter vor – gemäß seinem globalen Standard bzw. der **ausdrücklichen kanalindividuellen Einstellung**. Die tatsächlich versandte Bestätigung muss zur Vertragswirkung passen. Keine separate Preisbindefrist und kein versteckter zweiter Hold.
## Kritische Ausnahmen
- Angaben fehlen: gezielte Nachfrage; keine Platzhalter-Gäste, erfundenen Personenzahlen oder Preise.
- Zeitraum nicht frei / parallele Holds: keine ungesicherte bindende Zusage; Alternativen oder Klärung.
- Änderung während laufender Angebotsfrist: richtige Angebotsversion und verbleibende Annahmemöglichkeit feststellen.
- Fristablauf/Ablehnung: ohne Vertrag beenden, eigenen Hold nur nach Konfliktprüfung freigeben.
- Verspätete/abweichende Annahme, unzustellbare E-Mail, mehrfach betätigter Link: keine stillschweigende zweite oder falsche Buchung.
- Nach Buchung: Umbuchung, Storno, Zahlungsausfall, No-show, Schaden und Reklamation über dieselben fachlichen Sonderfälle.
**Noch fachlich zu detaillieren:** Beginn/Ende der Hold-Frist, Verhalten bei mehreren gleichzeitig ausstehenden Angeboten, exakt erforderliche Felder und rechtliche Anforderungen des Buchungsbuttons.
[Zum Szenarioüberblick](../README.md) · [P02](../V01_Buchung_und_Aufenthalt/P02_Konditionen_und_Verbindlichkeit.md)
@@ -0,0 +1,25 @@
---
id: R07
typ: referenzszenario
titel: A6 – Eigenbelegung, private Überlassung und Sperren
status: fachlicher-arbeitsstand
version: "0.10"
---
# R07 – Eigenbelegung, private Überlassung und Sperren (A6)
Ein **interner Belegungsanlass** (Familienbesuch, Eigennutzung, Wartung, Renovierung, Vorbereitung, organisatorische Sperre) wird als **Vorgang** mit Grund, Zeitraum und Belegungswirkung geführt. Er nutzt denselben Geschäftsprozess wie A1–A5, führt aber nur die fachlich erforderlichen Aktivitäten aus.
| Phase | Private Überlassung / Familie / Freunde | Wartung / reine Sperre |
|---|---|---|
| **P01** | Anlass, Zeitraum, Gäste soweit nötig; Belegung sichern, andere Portale sperren | Grund und Zeitraum, Sperrung/Kalenderabgleich |
| **P02** | Passende Aufenthalts-/Buchungsbestätigung, ggf. Bedingungen und Leistungen | Interne Bestätigung oder kein Dokument, **kein Mietvertrag** |
| **P03** | Kurtaxe soweit geschuldet, Wäsche, andere Leistungen und Zahlungen; **Mietpreis kann 0 sein** | Keine fiktiven Gäste/Zahlungen; ggf. gesondert zu verfolgende Wartungsausgaben |
| **P04** | Anreise, Leistungen und Aufenthalt entsprechend Bedarf | Arbeiten und Sperrzweck durchführen |
| **P05** | Belegung abschließen, offene Nebenpflichten übergeben | Sperre aufheben/ändern, betroffene Kalender aktualisieren |
**Gemeinsame Änderungslogik:** Zeitraum verschieben, verlängern, verkürzen oder absagen. Bei privaten Gästen können Dokumente/Zahlungen betroffen sein; bei Wartung lediglich Sperrwirkung und ggf. Arbeit. Eine reine Freigabe ist **keine rechtliche Mietvertragsstornierung**.
**Abgrenzung:** Der kurzfristige Hold einer A1/A2-Anfrage ist keine zusätzliche A6. Eine private Nutzung kann lokale Abgabepflichten auslösen; Befreiungen müssen anhand geltender kommunaler Regeln und Personenkonstellation geprüft werden. Vertrags-/Bestätigungstexte sind nicht ohne juristische Prüfung freigegeben.
[Zum Archetypenkatalog](../01_Buchungsarchetypen.md)
@@ -0,0 +1,42 @@
---
id: R08
typ: referenzszenario
titel: Destination Solutions – verbindliche Buchung, Vermieterabwicklung
status: fachlicher-arbeitsstand
version: "0.10"
---
# R08 – Destination Solutions (A3)
**Quelle:** Betreiberangaben zum konkret genutzten Zugang, nicht zur vollständigen Produktpalette von [Destination Solutions](https://www.ds-destinationsolutions.com/).
## Tatsächlicher Geschäftsfall
Das Portal bestätigt eine Buchung **verbindlich** und leitet sie mit den zur Verfügung stehenden Daten an den Vermieter weiter. Ab dann verantwortet der Vermieter Vertrags-/Gastkommunikation, Zahlungsforderung und -überwachung sowie Aufenthalt. **Kein erneuter Angebotsabschluss** und keine nachträgliche Belastung des Gastes mit der Vermieterprovision.
Eine automatische Kalendersynchronisation existiert im genutzten Zugang **nicht**. Weitere Portale müssen manuell gesperrt werden; ein belastbarer Nachweis des serverseitigen Übernahmezeitpunkts bzw. der Weitergabe an Partnerportale fehlt. Das ist ein offener Risikostatus, keine Zusicherung synchroner Belegung.
Destination Solutions kann über Partnerkanäle verkaufen. Unterschiedliche **Vermieterprovisionen** je Herkunft sind bekannt. Ob eigene Gast-Servicegebühren, höhere Vertriebs-Endpreise oder eine getrennte Preisaufschlüsselung auftreten, ist **ungeklärt**. Partnerherkunft ist ein kaufmännisches Merkmal, **kein eigener Archetyp**.
## Verarbeitung P01–P05
- **P01:** Verbindliche Portalbuchung mit Ursprungskanal, Referenz, Zeitraum und Gastdaten übernehmen; interne Belegung sichern; manuelle Sperraufgaben in anderen Kanälen erzeugen und bearbeitete Schritte nachweisbar halten.
- **P02:** Vereinbarten Portalpreis/Konditionsstand übernehmen; dazu passende eigene Vertragsdokumentation der **bereits verbindlichen** Buchung erstellen, ohne zweite Annahme oder zusätzliche nicht vereinbarte Gebühr.
- **P03:** Eigene Gast-/Zahlungs-/Mahn-/Kommunikationsaufgaben erledigen; Portalprovision getrennt vom Gastpreis prüfen.
- **P04:** Gäste betreuen, Schlüssel/Reinigung/Dienstleister und ggf. lokale Abgaben organisieren.
- **P05:** Leistung/Feedback abschließen, ausstehende Zahlung/Provision/Streitfragen zuständig weiterführen.
## Vom Betreiber genannte Stornostaffel
| Zeit bis Mietbeginn | Anteil des „Mietpreises“ |
|---|---:|
| 60 Tage oder mehr | 0 % |
| 59–45 Tage | 35 % |
| 44–33 Tage | 50 % |
| 32–22 Tage | 70 % |
| 21–12 Tage | 90 % |
| 11 Tage oder weniger | 100 % |
**Kein bestätigter Nachweis**, dass diese Staffel schon **vor** bindendem Portalabschluss wirksam eingebunden war; der Betreiber versendet bislang eigene Bedingungen nach Buchung. Auch die Basis „Mietpreis“ (nur Übernachtung oder inkl. Leistungen), rechtliche Wirksamkeit pauschaler Stornokosten und etwaige Gastgebühren sind zu klären. Eine erst nachträglich übermittelte Bedingung kann nicht automatisch eine bereits verbindliche Buchung ändern.
[Zum Archetypenkatalog](../01_Buchungsarchetypen.md) · [Offene Fragen DS-01 bis DS-06](../Offene_Fragen.md)
@@ -0,0 +1,34 @@
---
id: R09
typ: referenzszenario
titel: FeWo-direkt – extern verbindlich, geteilte Abwicklung
status: fachlicher-arbeitsstand
version: "0.10"
---
# R09 – FeWo-direkt (A4)
**Quelle:** Vom Betreiber beschriebener tatsächlicher Ablauf, ergänzt durch gezeigte Einzelbuchungsansichten; das Portal kann in anderen Konten anders konfiguriert sein.
## Vorgang und Zuständigkeiten
FeWo-direkt bestätigt die Buchung unmittelbar **verbindlich**. Der Vermieter erhält eine Buchungsmeldung, pflegt die Belegung anderer Kanäle, ermittelt im Portal zusätzliche Buchungs-/Kontaktdaten, fordert fehlende Gastdaten nach und versendet eine eigene Vertragsdokumentation. Das Portal verwaltet nach bisheriger Praxis **Anzahlung und Restzahlung**, kündigt eine Gästeinformation etwa 72 Stunden vor Anreise an und übernimmt Teile der Stornoabwicklung. Exakte Mahn-/Storno-/Erstattungspflichten sind noch zu bestätigen. Reinigung, Schlüssel und lokale Gastbetreuung übernimmt der Vermieter bzw. sein Dienstleister.
**Der eigene vierseitige Mietvertrag ist aktuell nicht im Portal hinterlegt.** Was Gäste vor dem bindenden Abschluss sehen oder als Buchungsbestätigung erhalten, ist nicht vollständig bekannt. Vertragsdokumente müssen die vorher wirksam vereinbarten Bedingungen widerspiegeln; ein später versandtes PDF darf keine neuen Pflichtbedingungen unterstellen. FeWo-direkt ist **kein universeller Standard** für Dokumente oder Portalkonditionen.
## Nachweisbare Preis- und Zahlungsinformationen eines Beispiels
In einer gezeigten Buchung vom **10.–17. Juli 2027** waren 840,00 € Übernachtungen, −42,00 € Rabatt, 181,51 € Gebühren/Steuern, **979,51 € Gastgesamtbetrag**, −84,82 € „An FeWo-direkt gezahlt“ und **894,69 € Auszahlung** angezeigt; in anderer Ansicht **900,20 € erwartete Auszahlung**. Die **5,51 € Abweichung** bleibt ungeklärt. Zwei Raten (390,61 € als bezahlt markiert; 588,90 € später fällig) sowie eine angekündigte Auszahlung waren sichtbar. Einzelne Tagespreise, Gebühren-/Provisionsbestandteile, Nachweis des tatsächlichen Bankeingangs und die Gast-Buchungsunterlagen sind dadurch nicht belegt.
Eine gezeigte Stornoübersicht nennt vollständige Erstattung bei mehr als 60 Tagen, 50 % bei mehr als 30 Tagen und keine Erstattung bei weniger als 30 Tagen. Exakte Grenztage und Einbeziehung im Abschluss sind zu prüfen. Diese Anzeige ist **nicht** automatisch identisch mit der eigenen nachträglichen Vertragsvorlage.
## Besondere Abläufe
- iCal-Übernahme externer Sperren kann verzögert sein; keine Live-Verfügbarkeitsgarantie für FeWo-direkt annehmen.
- Gäste können laut Portaldokumentation Storno-/Änderungsaktionen im Portal auslösen; der Betreiber hat eine eigene Vermieterstornierung oder Umbuchung bislang nicht selbst ausgeführt. Das echte Verhalten bei einem Vorgang muss geprüft werden.
- FeWo-direkt untersagt die Veranlassung einer Gästestornierung zur Umgehung von Gastgeberstornofolgen. Bei Doppelbuchungen tatsächliche Ursache, Vertragslage und Portalregelung korrekt behandeln.
- Dokumenten-/Abrechnungsangaben, die der Vermieter nicht elektronisch erhält, können gezielt manuell aus Portal-/Gastinformationen ergänzt werden.
Die **ausführliche Prüfung der eigenen Vertragsvorlage** steht als getrennte Referenz bereit; sie ist keine gültige allgemeine Vertragsvorlage.
[Zur Referenzanalyse](../Referenzen/FeWoDirekt_Vertragsanalyse.md) · [Offene Fragen FW-01 bis FW-07](../Offene_Fragen.md)
@@ -0,0 +1,224 @@
# Umsetzungsergebnis Paket 4: Ein Eingang für alle Kanäle
Stand: 03.11.2026 · Branch `feature/eingang` (aufbauend auf `cf11c8a`, Pakete 1–3) · Grundlage: [UMSETZUNGSPLAN_v0.10](UMSETZUNGSPLAN_v0.10.md) §4.3, §5.5, Abnahmekriterien 4.1–4.7. Die normative Prozessarchitektur v0.10 wurde nicht verändert.
> Hinweis: Der Auftrag kam abgeschnitten an (Abschnitt 11 endet mitten im Satz). Umgesetzt wurde alles bis dahin. Dokumentation und Bericht folgen dem Muster der Pakete 1–3.
---
## 1. Implementierungsstand
Paket 4 ist umgesetzt. Alle Abnahmekriterien 4.1–4.7 sind durch Tests belegt, die Oberflächen wurden im Browser geprüft. **Kein Portal ist automatisch aktiviert:** Jeder Kanal steht auf „Aus“, auch nach der Migration. Die Aktivierung auf Produktion ist nicht Teil des Auftrags.
| Bereich | Stand |
|---|---|
| Ein Eingang für Kalender, Buchungs-, Anfrage- und Stornomails (`App\Channels\Intake\PortalIntake`) | umgesetzt |
| Automatische Vorgänge nur bei sicherer Erkennung; unsichere Fälle werden geklärt | umgesetzt |
| Dublettenregel: Referenz → gleiches Portal mit gleichen Nächten → Spiegelung; keine Zusammenführung nach Überschneidung | umgesetzt |
| Schalter je Kanal: Aus / Beobachten / Anlegen / Anlegen und weiterbearbeiten | umgesetzt |
| Eingangsprotokoll (Expertenansicht und Befehl) | umgesetzt |
| Portalstorno und -änderung als Aufgabe am Vorgang, nie stille Stornierung | umgesetzt |
| Sperrnachweis in drei Stufen | umgesetzt |
| Bestandsübernahme mit Vorschau, Bericht, Wiederholbarkeit, Rücknahme | umgesetzt |
| A2-Portalanfrage aus der Anfrage-Mail | umgesetzt |
| Rückbau von „Ungeklärte Belegungen“ und `AssignOccupationGuest` | teilweise (siehe §7) |
Tests: **662 grün** (vorher 648; 14 neue in `CaseIntakeTest`), Pint sauber.
---
## 2. Umgesetzte Geschäftsfunktionen
**Sicher erkannte Buchung → Vorgang ohne Klick.**
- *Quellen:* eine Buchungsmail des Portals mit Zeitraum und Buchungsnummer, oder ein Kalendereintrag, den die Regeln des Kanals als Reservierung dieses Portals erkennen bzw. den die Vermieterin so eingeordnet hat.
- *Ergebnis:* ein Vorgang „Gebucht über FeWo-direkt“ mit Ursprungskanal, Buchungsnummer und Abwicklungsprofil; die Vorgangsart ergibt sich aus dem Profil (A3/A4/A5).
- *Was nicht entsteht:* kein Angebot, keine Annahme, kein eigener Preis. Gast, Personen und Preis bleiben „noch nicht bekannt“; ein Name aus dem Kalender steht nur als Hinweis in der Notiz.
- *Nächste Schritte:* Die Aktivitäten aus Paket 2 übernehmen, z. B. „Kontaktdaten eintragen“, „Gesamtpreis laut Portal eintragen“, „Buchungsunterlagen prüfen und senden“.
**Derselbe Fall auf mehreren Wegen bleibt ein Vorgang.**
- Kommt die Buchung zuerst per Mail und dann im Kalender, wird der Kalendereintrag dem Vorgang zugeordnet. Ebenso die Spiegelung bei einem anderen Portal.
- Wiederholte Abgleiche und Mails erzeugen nichts doppelt.
- Unterschiedliche Buchungsnummern oder nur überlappende Termine werden **nie** zusammengeführt, sondern geklärt.
**Unklare Belegung.**
- Unter „Zu erledigen“ steht: „Belegung von FeWo-direkt klären – Für den Zeitraum 26.11.–29.11.2026 wurde eine Belegung von FeWo-direkt gemeldet. Bitte klären Sie, um welche Art von Belegung es sich handelt.“
- Der Knopf „Klären: Was ist das?“ bietet drei Antworten:
- Buchung über das Portal: Der Vorgang entsteht.
- Gehört zu einem vorhandenen Vorgang: nur Vorgänge mit genau diesen Nächten.
- Keine Buchung: Sperre, eigene Nutzung oder Spiegelung.
- Die bisherigen Detailwerkzeuge liegen unter „Weitere Möglichkeiten“.
**Portalanfrage (A2).** Eine Anfrage-Mail des Portals wird zum Vorgang „Anfrage über FeWo-direkt“ mit Zeitraum und Anfragenummer. Gast und Personen bleiben unbekannt, der Vorgang fragt sie gezielt ab und läuft danach wie A1. Ob der Zeitraum reserviert wird, folgt der Einstellung für Anfragen dieses Portals.
**Portalstorno und -änderung.**
- *Auslöser:*
- Stornomail mit Buchungsnummer eines gebuchten Vorgangs;
- Kalendereintrag eines gebuchten Vorgangs, der verschwunden ist (erst nach zwei bestätigenden Abgleichen);
- abweichende Termine im Kalender.
- *Folgen am Vorgang:*
- Aufgabe „Das Portal meldet eine Stornierung – bitte prüfen“ bzw. „… eine Änderung …“;
- Eintrag im Verlauf mit dem Portal als Quelle;
- die Aufgabe wird zum nächsten Schritt des Vorgangs.
- *Was nicht passiert:* Der Vorgang bleibt gebucht und der Zeitraum belegt. Ein mit dem Vorgang verbundener Mail-Eintrag wird nicht mehr freigegeben. Über „Stornieren …“ (Paket 2) gelangt die Vermieterin in den Stornoweg.
- Jede Meldung zählt einmal. Zwei verschiedene Mails sind zwei Meldungen; derselbe verschwundene Eintrag bleibt eine.
**Sperrnachweis.**
- „Erledigt“ bei einer Portalaufgabe fragt, was die Person sagen kann:
- „Ich habe den Zeitraum im Portal gesperrt“ (*veranlasst*);
- „… und im Kalender des Portals gesehen“ (*im Portal gesehen*);
- „Das Portal hat es bestätigt“ (*Wirksamkeit bestätigt*);
- optional mit Notiz.
- „Nachweis ergänzen“ hebt die Stufe später an, senkt sie aber nie.
- Die Vorgangsseite zeigt die Stufe, z. B. „In Ostseeklar sperren · 07.12.–14.12.2026 · im Portal gesehen (im Kalender rot)“.
- Eine erledigte Automatisierung gilt nur als *veranlasst*.
---
## 3. Nachweise zu den Abnahmekriterien
| ID | Kriterium | Nachweis (`tests/Feature/CaseIntakeTest.php`) | Ergebnis |
|---|---|---|---|
| 4.1 | A3 Destination Solutions manuell; gebucht ohne Angebot/Annahme; Sperraufgaben, Unterlagen, Zahlung durch uns, Portalpreis | `test_a_destination_solutions_booking_is_entered_by_hand_and_handled_by_us`: A3, bestätigt, Angebotsversion 0, Preis 840,00 €, Zahlungsaufgaben aktiv, „In Ostseeklar sperren“, „Buchungsunterlagen prüfen und senden“ | **erfüllt** |
| 4.2 | FeWo-direkt-Mail → Vorgang ohne Klick; späterer iCal-Eintrag → kein zweiter; Zahlung „über das Portal“, keine eigenen Mahnungen | `test_a_booking_mail_becomes_a_case_and_the_later_calendar_entry_joins_it` | **erfüllt**. Fehlende Postanschrift erzeugt keine Aufgabe; die E-Mail-Adresse wird nur verlangt, weil eigene Unterlagen sie brauchen. |
| 4.3 | iCal-Eintrag ohne Erkennung → kein Vorgang, Aufgabe „Was ist das?“, Antwort „Buchung“ legt ihn an | `test_an_unrecognised_calendar_entry_is_clarified_and_the_answer_booking_creates_the_case` | **erfüllt** |
| 4.4 | Stornomail oder verschwundener iCal-Eintrag → „Stornierung prüfen“, Vorgang bleibt gebucht | `test_a_cancellation_mail_reaches_the_case_as_a_task_and_cancels_nothing`, `test_a_disappeared_or_changed_calendar_entry_is_reported_once_and_nothing_is_released` | **erfüllt** |
| 4.5 | „In Portal X sperren“, Erledigen mit Stufe und Notiz, Vorgangsseite zeigt Nachweisgrad | `test_portal_blocks_state_how_far_they_are_proven` | **erfüllt** |
| 4.6 | Beobachtungsmodus: keine Vorgänge, Bericht über das, was entstanden wäre | `test_observing_creates_nothing_and_reports_what_would_have_been_created` (`channels:intake-report`) | **erfüllt** |
| 4.7 | A2-Portalanfrage mit unvollständigen Daten → Anfrage, fordert fehlende Daten | `test_a_portal_request_becomes_a_request_that_asks_for_the_missing_data` | **erfüllt** |
Weitere Tests:
- Kalender mehrfach gelesen ergibt genau einen Vorgang und einen Protokolleintrag.
- Gleiches Portal mit gleichen Nächten wird dem vorhandenen Vorgang zugeordnet.
- Fremdportal-Reservierung und überlappende Reservierung werden nie zum Vorgang.
- Ein nicht eingeschalteter Kanal verhält sich wie bisher; neue Kanäle starten auf „Aus“.
- „Anlegen und weiterbearbeiten“ versendet trotzdem keine unfreigegebenen Unterlagen.
- Bestandsübernahme: Vorschau, Anwendung, Wiederholung ohne Dublette, Rücknahme.
---
## 4. Technische Umsetzung
| Baustein | Inhalt |
|---|---|
| `App\Channels\Intake\PortalIntake` (neu) | `evaluate()` bewertet ohne Änderung; `process()` handelt nach Kanalschalter; `afterSync()` nach jedem Kalenderabgleich; `cancellationMail()`, `inquiryMail()`; `adopt()` für die Bestandsübernahme. Ergebnisse als `IntakeDecision` mit Begründung und fehlenden Angaben. |
| `App\Enums\CaseIntakeMode`, `IntakeOutcome`, `ChannelTaskProof` (neu) | Schalter je Kanal, Ergebnis eines Eingangs, Nachweisstufe |
| `App\Models\IntakeObservation` (neu) | Eingangsprotokoll; ein Eintrag je Ereignis und Ergebnis (Fingerabdruck, eindeutig je Mandant) |
| `App\Actions\TakeOverPortalInquiry` (neu) | A2-Anfrage mit unbekannten Angaben, Reservierung nach Kanalprofil |
| `TakeOverExternalBooking` | Neues Feld `processing_mode`. Automatisch angelegte Vorgänge laufen bei „Anlegen“ mit Freigabe, bei „Anlegen und weiterbearbeiten“ nach Profil. |
| `SyncChannel` | Ruft nach erfolgreichem Abgleich `afterSync()` auf, gekapselt mit `rescue()`. Ein Fehler im Eingang lässt den 5-Minuten-Abgleich nie scheitern. |
| `ProcessPortalMail` | Leitet Buchung, Anfrage und Storno an den Eingang. Ein mit einem Vorgang verbundener Mail-Eintrag wird durch eine Stornomail nicht mehr freigegeben (Status „Bitte prüfen“). |
| `BookingTaskKind` | `PortalCancellationReported`, `PortalChangeReported`. Je Vorgang und Art eine Aufgabe; eine neue Meldung öffnet sie wieder. |
| `ChannelTask` | `proof`, `proof_note`, `proof_at`, `proof_by`; `complete()` mit Stufe; `prove()` hebt nur an; `proofLabel()` |
| `CaseActivities` | Portalmeldungen haben Vorrang als nächster Schritt; Sperraufgaben zeigen ihren Nachweis. |
| Oberfläche | Kanalformular „Erkannte Buchungen automatisch als Vorgang übernehmen?“; Klärdialog an der Portalbelegung; Dialoge „Erledigt“ und „Nachweis ergänzen“ bei Portalaufgaben; Eingangsprotokoll unter System (Expertenansicht); Vorgangsseite, technischer Abschnitt „Quellen und Kalenderdarstellungen“ |
| Befehle | `channels:intake-report {--days}`; `channels:adopt-occupations {--channel=*} {--apply} {--revert=}` |
| Migration | `2026_11_03_090000_create_case_intake`, rein additiv: `channels.case_intake` (Standard `off`), Tabelle `intake_observations`, Nachweisspalten an `channel_tasks` |
**Wann ein Eintrag als sicher gilt.**
- Mail: Typ „Buchung“ mit Zeitraum *und* Buchungsnummer. Ohne Nummer wird geklärt, weil sich ein späterer Kalendereintrag sonst nicht sicher zuordnen lässt.
- Kalender: Die Regel erkennt „Portalreservierung“, „Kandidat für führende Belegung“ und Ursprung „dieses Portal“; oder die Vermieterin hat den Eintrag als Reservierung dieses Portals eingeordnet.
**Was immer geklärt wird.**
- Belegt-Meldungen ohne Regel
- Spiegelungen fremder Portale
- Überschneidung mit einem Vorgang oder mit weiteren Einträgen desselben Portals
- Prüfhinweise am Eintrag
- „Was kommt über dieses Portal?“ = „nur Anfragen“
**Was nie ein Vorgang wird.** Einträge, die als Sperrzeit oder privat eingeordnet sind, sowie Vergangenes.
**Zuordnung nach Terminen.** Nur innerhalb *desselben* Portals, bei *genau* gleichen Nächten und *genau einem* passenden Vorgang ohne widersprechende Buchungsnummer. Ein Portal kann dieselben Nächte nicht zweimal vergeben, deshalb ist das keine Datumsheuristik im Sinn des Auftrags.
**Mandantentrennung.** Alle Abfragen laufen über den Mandantenbereich der Modelle; das Protokoll ist je Mandant eindeutig.
---
## 5. Aktivierung, Automatik und externe Kommunikation
**Schalter je Kanal** (Kanäle › Portal bearbeiten):
| Stufe | Wirkung |
|---|---|
| Aus (Standard, auch für alle bestehenden Kanäle) | Wie bisher. Erkannte Buchungen erscheinen als Klärungsfall; es wird nichts protokolliert. |
| Beobachten | Es entsteht nichts und es wird nichts geändert. Das Eingangsprotokoll zeigt Ergebnis, Vorgangsart, Zuordnung, fehlende Angaben und Begründung. |
| Anlegen | Vorgänge, Zuordnungen, Klärungen und Meldungsaufgaben entstehen. Neue Vorgänge stehen auf „Sie geben frei“. |
| Anlegen und weiterbearbeiten | Wie „Anlegen“; die neuen Vorgänge folgen der Einstellung unter „So arbeite ich“. |
**Externe Kommunikation.** Kein automatisch angelegter Vorgang versendet etwas, das nicht freigegeben ist. Buchungsunterlagen extern gehen erst raus, wenn beides vorliegt:
- die Buchungsunterlagen sind freigegeben;
- die Portalvorlage ist freigegeben und als Wiedergabe der Portalbedingungen bestätigt.
Das ist der Freigabeschutz aus Paket 3. Bei „Anlegen“ gibt die Vermieterin zusätzlich jeden Schritt selbst frei. Zahlungsaufforderungen entstehen nur, wenn wir laut Profil für die Zahlung zuständig sind.
**Meldungen zu bekannten Vorgängen** (Storno, Änderung) erzeugen Aufgaben nur bei „Anlegen“ oder „Anlegen und weiterbearbeiten“. Bei „Beobachten“ werden sie nur protokolliert. Bei „Aus“ bleibt es wie bisher: Die Portalmail wird als „Bitte prüfen“ gemeldet.
**Vermeidung unnötiger Aufgaben.**
- Ein verschwundener Eintrag zählt erst, wenn der Abgleich ihn nach zwei bestätigenden Läufen entfernt.
- Bei ungewöhnlich vielen fehlenden Einträgen wird nichts entfernt.
- Unveränderte Wiederholungen erzeugen weder Aufgaben noch Verlaufseinträge.
- Fehlgeschlagene Abgleiche lösen keine Meldungen aus.
---
## 6. Ergebnisse der Tests und der visuellen Prüfung
**Tests:** 662 Tests, 3636 Zusicherungen, alle grün. Pint sauber. Die bestehenden Kanal-, Mail-, Spiegelungs- und Klärungstests (129) laufen unverändert; nur ein Listentitel unter „Zu erledigen“ wurde angepasst.
**Browser:** Chromium über Playwright, lokaler Server, **Kopie** der lokalen Datenbank im Scratchpad, Anmeldung mit Zwei-Faktor-Code, Kanal „FeWo-direkt“ auf „Anlegen“. Geprüft:
- **„Zu erledigen“:**
- „Belegung von FeWo-direkt klären“ mit dem Klartextsatz;
- „Das Portal meldet eine Stornierung – bitte prüfen“ am automatisch angelegten Vorgang;
- „In Ostseeklar sperren“;
- „Buchungsunterlagen prüfen und senden“ mit den Prüfpunkten aus Paket 3.
- **Klärdialog:** zwei passende Antworten, die dritte („vorhandener Vorgang“) erscheint nur bei Vorgängen mit gleichen Nächten.
- **Dialog „Erledigt“** mit den drei Nachweisstufen und Notiz.
- **Eingangsprotokoll** mit Klärung, Neuer Vorgang und Stornomeldung. Daraufhin habe ich die Begründung unter das Ergebnis verlegt, weil sie in der breiten Tabelle abgeschnitten war.
Keine Konsolenfehler. Die lokale Arbeitsdatenbank blieb unberührt.
**Nicht geprüft:** echte Portalmails und echte Feeds von FeWo-direkt; Tablet und Smartphone; MariaDB.
---
## 7. Rückwärtskompatibilität und verbleibende Risiken
**Kompatibilität:**
- Ohne Einschalten ändert sich nichts. Die einzige sichtbare Änderung für alle sind der neue Klärdialog und der Titel unter „Zu erledigen“.
- Bestehende Vorgänge, Preise, Dokumente und Spiegelungen bleiben unverändert.
- Die Bestandsübernahme ändert nur mit `--apply` etwas. Sie legt Vorgänge mit Freigabe an und schreibt einen Bericht nach `storage/app/private/intake-adoptions/`.
- `--revert=<Bericht>` stellt die Einträge wieder her und entfernt die Vorgänge des Laufs, sofern mit ihnen noch nichts geschehen ist (kein Dokument, keine Zahlung). Offene Sperraufgaben des Laufs werden verworfen.
- Vor `--apply` auf echten Daten zusätzlich eine Datenbanksicherung ziehen.
**Nicht vollständig zurückgebaut:**
- „Gast zuordnen“ an der Portalbelegung (`AssignOccupationGuest`) und die Liste „Portalbelegungen & Klärung“ bestehen in der Expertenansicht weiter. Die einfache Ansicht braucht sie nicht mehr. Der vollständige Rückbau gehört in einen eigenen Schritt, weil viele bestehende Tests und der Belegungsplan darauf aufbauen.
- `OpenPortalFile` bleibt als Baustein der Antwort „Buchung“.
**Risiken:**
- *Erkennung realer Mails:* nur an Testmustern geprüft (Annahme §8.5 des Plans). Deshalb zuerst „Beobachten“ und das Protokoll mit echten Fällen abgleichen.
- *Kalenderregeln:* Die Sicherheit der iCal-Übernahme hängt an der Regel des Kanals („Portalreservierung, führend, dieses Portal“). Eine zu weit gefasste Regel würde falsche Vorgänge erzeugen. Auch dafür ist der Beobachtungsmodus da.
- *Buchungsmails ohne Nummer* werden geklärt, nicht übernommen. Liefert ein Portal nie Nummern, bleibt dort die Klärung.
- *Last im 5-Minuten-Abgleich:* `afterSync()` läuft je Kanal über dessen offene Einträge. Bei wenigen Wohnungen ist das unkritisch, und ein Fehler bricht den Abgleich nicht ab.
- Sperraufgaben entstehen wie bisher für jede belegende Sperre, auch für unklare Einträge. Das ist unverändert und gewollt, damit nichts doppelt vermietet wird.
- Die Migration ist auf MariaDB noch nicht geprüft.
---
## 8. Offene Punkte und erforderliche Entscheidungen
| Was | Wer | Wirkung bis dahin |
|---|---|---|
| Je Portal entscheiden, wann von „Aus“ auf „Beobachten“ und danach auf „Anlegen“ umgestellt wird | Betreiber | Alles wie bisher |
| Kalenderregeln je Portal prüfen: Liefert der Feed Buchungsnummer oder Gastnamen? (§8.3: „Erkennt die iCal-Regel sicher?“) | Betreiber, Kanaleinrichtung | Ohne Regel nur Klärung |
| Absenderadressen der Portalmails eintragen, Mail-Eingang einschalten | Betreiber | Keine Mail-Übernahme |
| Freigaben aus Paket 3 (Buchungsunterlagen, FeWo-direkt-Vorlage FW-01) | Betreiber | Unterlagen nur von Hand mit Bestätigung |
| Bestandsübernahme auf Test, dann Produktion (`--apply`, mit Sicherung) | Betreiber | Bestehende Belegungen bleiben Klärungsfälle |
Grundsatzentscheidungen wurden nicht getroffen; B1 und B3–B5 bleiben offen.
---
## 9. Empfehlung für die nächsten Schritte
1. **Pakete 1–4 auf dem Testsystem** ausrollen. Danach FeWo-direkt auf „Beobachten“ stellen, nach einigen echten Buchungen `channels:intake-report` prüfen und erst dann auf „Anlegen“.
2. **Paket 5 (Änderung, Storno, kontrollierter Abbruch)** schließt direkt an: Die Aufgaben „Das Portal meldet eine Stornierung/Änderung“ sind die Einstiege. Paket 5 kann sie um „Stornierung übernehmen“ (Initiator „Gast über Portal“) und die Stornobestätigung als Dokumentart erweitern.
3. Danach den Rückbau der Expertenwerkzeuge an Portalbelegungen (§7) und die Bedienprobe mit der Vermieterin.
@@ -0,0 +1,31 @@
---
id: P01
typ: prozessphase
titel: Buchungseingang und Verfügbarkeit
status: fachlicher-arbeitsstand
version: "0.10"
---
# P01 – Buchungseingang und Verfügbarkeit
**Ziel:** Relevanten Geschäftsfall als **einheitlichen Vorgang** erfassen, Verfügbarkeit und Belegungsfolgen bewerten und nur tatsächlich erforderliche Sperr-/Klärungsaufgaben auslösen.
## Aktivitäten
1. **Eingang klassifizieren:** Eigene Website, externer Kanal, Telefon/manuell oder interner Belegungsanlass; unterscheiden zwischen unverbindlicher Anfrage, bereits extern verbindlicher Buchung, A6-Nutzung/Sperre und ungeklärter Fremdmeldung. Vorhandene Owner-/Ursprungskanal-Zuordnung nutzen. Partnerherkunft nur erfassen, wenn kaufmännisch relevant.
2. **Identität und Daten übernehmen:** Unterkunft, Zeitraum, externe Referenz, verfügbare Gastdaten und Statusquellen. Meldungen desselben externen Buchungsfalls zusammenführen, nicht mehrfach Vorgänge erzeugen. **Unklare iCal-Sperre ist nicht automatisch ein Gastvertrag.** Fehlende Angaben bleiben unbekannt und lösen nur bei Bedarf Klärung aus.
3. **Verfügbarkeit bewerten:** Bereits verbindliche Buchungen, interne Belegungen, aktive Holds und bestehende Kalenderkonflikte berücksichtigen. Neue bereits extern verbindliche Konfliktbuchung **nicht still löschen oder für unverbindlich erklären**.
4. **Angebots-/Belegungswirkung festlegen:** Bei unverbindlicher Anfrage gilt die konfigurierbare Haltefrist. Bei `>0` interne Vorreservierung und passende externe Sperraktionen; bei `0` keine Sperre allein wegen der Auskunft. Für A6 entsteht ein eigener Vorgang mit Grund; bei Wartung kann der weitere Ablauf sehr kurz sein. Ein Hold innerhalb A1/A2 erzeugt keinen A6-Vorgang.
5. **Externe Kalender behandeln:** Wo möglich automatisch aktualisieren, andernfalls priorisierte manuelle Sperraufgabe. Zeitpunkt, Quelle, Bearbeiter und ggf. sichtbaren Nachweis erfassen. „Gesendet“, „im Zielportal sichtbar“ und „in Partnerkanälen nachweislich wirksam“ sind nicht gleichbedeutend; unbekannte Wirkung bleibt unbekannt.
6. **P02 übergeben:** Anlass, Archetyp, Belegungsstatus, Quellen und offene erforderliche Aufgaben; bei extern verbindlicher Buchung Nachweis des bereits erfolgten Abschlusses.
## Ergebnisse und Grenzen
- Anfrage ohne Hold: Preis-/Verfügbarkeitsauskunft möglich, aber **keine Verfügbarkeitsgarantie**.
- Mit Hold: Nur mit fachlich passender Belegungssicherung ein wirklich bindendes befristetes Angebot; Angebots-/Haltefrist dürfen nicht widersprüchlich enden.
- A3–A5: Bei Eingang existiert die Verbindlichkeit bereits extern; neue Sperr- und Konfliktaufgaben ändern daran nichts.
- A6: Sperrgrund immer dokumentieren, Gäste/Leistungen optional.
**Offen für die technische Ist-/Sollprüfung:** Kriterien zur sicheren Portalbuchungserkennung, Dubletten bei mehrfachen Portalrepräsentationen, konkrete Hold-Freigaberegel und atomare eigene Buchungsprüfung. Ein seltenes Doppelbuchungsrisiko bleibt bei zeitverzögerten Fremdportalen bewusst akzeptiert; keine überdimensionierte Risiko-Engine erforderlich.
[Zur Prozesslandkarte](../00_Prozesslandkarte.md) · [Konfliktfälle](../Querschnitt/Belegungskonflikte.md)
@@ -0,0 +1,35 @@
---
id: P02
typ: prozessphase
titel: Konditionen und Buchungsverbindlichkeit
status: fachlicher-arbeitsstand
version: "0.10"
---
# P02 – Konditionen und Buchungsverbindlichkeit
**Ziel:** Entweder eine eigene verbindliche Buchung rechtssicher herbeiführen oder eine bereits extern verbindliche Buchung mit ihren tatsächlich vereinbarten Bedingungen dokumentieren; A6 entsprechend seinem Anlass bestätigen.
## A1/A2 – Eigener Buchungsweg
**Haltefrist > 0:** Erforderliche Angaben und Preisgrundlagen feststellen; gültige Jahres-/Saisonpreise, Rabatte und Leistungen berücksichtigen; passende Vorlage einschließlich Bedingungen und Anlagen wählen. Eine wirksame Vorreservierung wird mit einem **zeitlich passenden verbindlichen Angebot** verbunden. Angebot/Konditionsstand und Versand nachweisbar halten. Rechtzeitige, wirksame Annahme über einen geeigneten, abgesicherten (z. B. signierten) Annahmeweg begründet den Vertrag ohne zweite Vermieterzustimmung. Fristablauf, Ablehnung oder abändernde/verspätete Annahme führen in den jeweils passenden Klärungs-/Neuantragsweg; fremde wirksame Belegungen werden nicht gelöscht.
**Haltefrist = 0:** Eine **Preis-/Verfügbarkeitsauskunft unter Vorbehalt** senden; keine Reservierung und kein Annahmeweg, der irrtümlich sofort einen Vertrag entstehen lässt. Bei einem späteren Buchungswunsch Verfügbarkeit **erneut prüfen** und dann nach gültiger Vermieter-/Kanaleinstellung automatisch bestätigen oder manuell freigeben. Die Bedingungen des tatsächlichen Vertragsschlusses sind maßgeblich. Eine eigenständige Preisbindefrist ist im MVP **nicht vorgesehen**.
## A3–A5 – Extern bereits verbindliche Buchung
Die Buchung ist **bereits vor Eingang in FewoPortal verbindlich**. Externe Buchungsreferenz, maßgeblicher Preis, Konditions- und Stornostand sowie die Nachweisqualität übernehmen; **keine zweite Angebotsannahme**. Eigene Preiskalkulation oder Vertragsvorlage darf den gebuchten Preis bzw. akzeptierte Bedingungen **nicht** still ersetzen. Fehlende Daten gezielt nachfordern; unterschiedliche Bereitstellungstiefe (Gesamtpreis oder Einzelwerte) ist zulässig.
Für A3/A4 passende Unterlagen zur bestehenden Buchung erzeugen, soweit eigene Dokumentation erforderlich und mit dem tatsächlichen Vertragsstand vereinbar ist. Für A5 nur die Dokumentation, die eigenen Pflichten entspricht. Ob der Gast bestimmte AGB/Stornoklauseln vor Buchung gesehen hat, ist ggf. **offen und zu prüfen**, nicht aus späterem PDF-Versand abzuleiten.
## A6 – Interne Nutzung und Sperre
Bei privater Überlassung ggf. Aufenthalts-/Reservierungs-/Buchungsbestätigung mit zutreffenden Teilnehmern, Zusatzleistungen und Konditionen. Eine Wartungs- oder sonstige reine Sperre benötigt keinen Mietvertrag; das Ergebnis kann interne Bestätigung oder `nicht anwendbar` sein. Die Belegungssicherung erfolgt unabhängig davon, ob ein Mietpreis anfällt.
## Zustandsregel
**Verbindlichkeit**, **Vollständigkeit von Gästedaten**, **Finanzdetails** und **Dokumentenversand** sind unterschiedliche Zustände. Eine externe verbindliche Buchung bleibt bindend, auch wenn Anschriften oder Tagespreise fehlen. Die nächste Tätigkeit wartet nur auf die dafür notwendigen Informationen.
**Juristische Prüfungen:** AGB-Einbeziehung, Online-Bestellablauf und signierte Annahme sowie verspätete/abweichende Annahme sind separat zu prüfen; kein Fachdokument ersetzt Rechtsberatung. Maßgeblich u. a. [BGB §§145](https://www.gesetze-im-internet.de/bgb/__145.html), [148](https://www.gesetze-im-internet.de/bgb/__148.html), [150](https://www.gesetze-im-internet.de/bgb/__150.html), [305](https://www.gesetze-im-internet.de/bgb/__305.html).
[Zur Prozesslandkarte](../00_Prozesslandkarte.md) · [Profil- und Vorlagenregeln](../02_Abwicklungsprofile_und_Dokumente.md)
@@ -0,0 +1,28 @@
---
id: P03
typ: prozessphase
titel: Buchungsverwaltung und kaufmännische Abwicklung
status: fachlicher-arbeitsstand
version: "0.10"
---
# P03 – Buchungsverwaltung und kaufmännische Abwicklung
**Ziel:** Nach Vertragsschluss beziehungsweise bei A6 nach Belegungsanlage alle erforderlichen Dokumentations-, Gäste-, Leistungs-, Zahlungs- und Verwaltungsaufgaben im **selben Vorgang** steuern.
## Aktivitäten
1. **Abwicklungsprofil anwenden:** Wer verantwortet Vertragsunterlagen, Gastkontakt, Zahlungen, Mahnung, Storno, Rückzahlung und lokale Leistungen? Automatisch/manuell nach Vermieterstandard, ausdrücklicher Kanalabweichung und tatsächlichem Vorgang; fremde Erfüllung mit Quelle kennzeichnen.
2. **Buchungs-/Aufenthaltsunterlagen bearbeiten:** Gewählte Vorlagen/Anlagen, bereits vereinbarte Konditionen und erforderlichen Versand verwenden. Keine erneute Vertragsannahme für A3–A5 und keine zusätzlichen nicht vereinbarten Gebühren in Dokumenten.
3. **Gäste und Leistungen bearbeiten:** Fehlende für konkrete Aufgaben erforderliche Gastdaten beschaffen; Zusatzleistungen, Kurabgabe soweit tatsächlich geschuldet und Belege unabhängig vom Mietpreis führen. A6 kann Gäste und Zahlungspositionen enthalten oder als reine Sperre ohne sie ablaufen.
4. **Finanzinformationen nachvollziehen:** Gesamtsummen, Einzel- und Sammelpositionen, Rabatte, Portalgebühren, Gastservice, Vermieterprovision und Vermieterauszahlungen getrennt erfassen **soweit tatsächlich bekannt**. Fehlende Positionen nicht künstlich kalkulieren; manuelle Zuordnung/Nachprüfung ermöglichen. Vertragsforderung, Zahlungsplan, Portalstatus und Bankeingang nicht gleichsetzen.
5. **Fristen und Abweichungen überwachen:** Anzahlungen/Restzahlungen, offene Forderungen, bestätigte Portalzahlungen, erwartete Auszahlungen, Mahnungen/Storno-/Änderungsfälle gemäß tatsächlicher Zuständigkeit. Nachweise und Abweichungen verknüpfen, ohne die verbindliche Buchung willkürlich umzuschreiben.
6. **P04 versorgen:** Erforderliche Informationen, Aufgaben und Kontakte für den Aufenthalt bzw. die private Nutzung/Wartung bereitstellen; nicht kritische Abrechnungsdetails dürfen als offene Aufgabe verbleiben.
## Anforderungen an die Darstellung
Für den Vermieter wenige verständliche nächste Schritte, nicht mehrere getrennte Portalmasken. Bei fehlenden Informationen unterscheiden zwischen **„nicht geliefert“**, **„nicht erforderlich“**, **„widersprüchlich“** und **„nachgewiesen“**. Ein als „laut Portal bezahlt“ markierter Betrag ist nicht automatisch auf dem Vermieterkonto eingegangen.
**Offen:** Exakte rechtlich erforderliche Gäste-/Melde-/Kurabgabedaten, Zahlungs- und Belegpflichten je Portal, Detailkriterien für Mahnung und Abrechnung; technische Datenstruktur ist nicht vorgeschrieben.
[Zur Prozesslandkarte](../00_Prozesslandkarte.md) · [Preis- und Zahlungsmodell](../Querschnitt/Preise_und_Zahlungen.md)
@@ -0,0 +1,28 @@
---
id: P04
typ: prozessphase
titel: Leistungsvorbereitung und Aufenthalt
status: fachlicher-arbeitsstand
version: "0.10"
---
# P04 – Leistungsvorbereitung und Aufenthalt
**Ziel:** Den zugesagten Aufenthalt oder den intern geplanten Belegungs-/Wartungszweck mit den tatsächlich notwendigen Informationen und lokalen Leistungen durchführen.
## Aktivitäten
1. Prüfen, ob Anreise- bzw. Arbeitsdaten für diesen Fall ausreichen; bei externen Portalen Kontaktinformationen ggf. manuell beim Gast oder im Portal beschaffen.
2. Relevante Hinweise versenden bzw. die **externe Versandzuständigkeit** und deren belegten Status nachvollziehen. Eine für 72 Stunden vor Anreise angekündigte Portalnachricht ist nicht dasselbe wie nachgewiesene Zustellung.
3. Schlüssel-/Zugang, Reinigung, Wäsche, lokale Betreuung und sonstige vereinbarte Leistungen organisieren; ggf. Dienstleister kontaktieren und Aufgaben nachverfolgen. Keine eigenständige umfangreiche Personal- oder Objektmanagementlösung voraussetzen.
4. Kurabgabe und örtliche Melde-/Nachweispflichten prüfen, soweit für die konkrete Person und den Aufenthalt einschlägig; bei privaten Gästen (A6) nicht pauschal auf null setzen.
5. Auf Aufenthaltsänderung, verspätete Anreise, No-show, Verlängerung, Reklamation und Schäden über die vorhandenen Sonderprozesse reagieren.
6. Bei Wartung/organisatorischer Sperre statt Gästebetreuung die nötigen Arbeits-/Prüfaktivitäten ausführen und den Zeitraum geschützt halten.
## Ergebnis
Leistung/Arbeit wurde erbracht oder die relevante Abweichung ist geklärt beziehungsweise als Aufgabe sichtbar. P03-Finanzfragen können weiterlaufen, sofern sie nicht Voraussetzung für diese Tätigkeit sind.
**Noch offen:** Detaillierte Regeln zur Erforderlichkeit von Anreisedaten, zur Gastkommunikation je Kanal, zur lokalen Dienstleisterübergabe und zu gesetzlichen Melde-/Abgabefeldern.
[Zur Prozesslandkarte](../00_Prozesslandkarte.md) · [Sonderprozesse](../Querschnitt/Sonder_und_Supportprozesse.md)
@@ -0,0 +1,32 @@
---
id: P05
typ: prozessphase
titel: Abschluss und Nachbereitung
status: fachlicher-arbeitsstand
version: "0.10"
---
# P05 – Abschluss und Nachbereitung
**Ziel:** Einen tatsächlich abgewickelten Aufenthalt bzw. die interne Nutzung oder Sperre fachlich beenden, Ergebnisse sichern und offene Folgeangelegenheiten zuordnen.
## Aktivitäten
1. Ende des Aufenthalts, der privaten Nutzung oder der Sperr-/Wartungsaktivität feststellen; geeignete Rückgabe-, Reinigungs- und Objektbereitstellungsaufgaben berücksichtigen.
2. Zutreffende Belegungswirkung behandeln; abgelaufene Nutzung bzw. Wartungssperre beenden/ändern und notwendige externe Kalenderaktualisierungen veranlassen. Ein abgelaufener Aufenthalt darf nicht mit einem stillen Löschen der Buchung verwechselt werden.
3. Offene Zahlungen, Portal-Auszahlungen, Provisionen, Rückerstattungen, Schäden oder Streitfälle prüfen; wenn die eigentliche Leistung abgeschlossen ist, **an verantwortliche Folgeaufgabe/-prozess übergeben** statt den ganzen Hauptprozess dauerhaft offen zu lassen.
4. Bei regulärem Gastaufenthalt Dank, zulässige Feedback-/Bewertungsabwicklung und gegebenenfalls Übergabe an **V02 Gästebindung**; bei Wartungssperre keine künstliche Bewertung oder Marketingaktivität.
5. Fachliches Endergebnis und verantwortliche Nachläufer im **gleichen Vorgang** nachvollziehbar halten.
## Mögliche Endergebnisse
| Ergebnis | Beispiel |
|---|---|
| Regulär abgeschlossen | Gast ist abgereist, Leistung erbracht; ggf. klar zugewiesener offener Abrechnungsnachläufer |
| Ohne Vertragsschluss beendet | Anfrage abgelehnt, Angebot abgelaufen, keine verbindliche Buchung entstanden |
| Wirksam storniert | Verbindliche Buchung nach tatsächlich wirksamer Stornoentscheidung beendet |
| A6 abgeschlossen/aufgehoben | Privater Aufenthalt beendet, Wartung abgeschlossen, Sperre vorzeitig aufgehoben oder verschoben |
**Abschluss-Gate:** Die genauen Mindestnachweise je Vorgangsart sind noch fachlich zu bestimmen. Nicht anwendbare Gästedaten, Vertragsunterlagen oder Finanzschritte sind **keine fehlenden Pflichtdaten**.
[Zur Prozesslandkarte](../00_Prozesslandkarte.md) · [Gates und Nachweise](../Querschnitt/Gates_und_Nachweise.md)
@@ -0,0 +1,17 @@
---
id: V02
typ: wertschöpfungsprozess
titel: Vermarktung, Gästegewinnung und Gästebindung
status: rahmenmodell
version: "0.10"
---
# V02 – Vermarktung, Gästegewinnung und Gästebindung
V02 ist der zweite, von V01 getrennte, **vor- und nachgelagerte Wertschöpfungsprozess**. Er umfasst Reichweite und Nachfrage über eigene Website, Social Media, Print und Vermittlungsportale, Interessentenbeziehungen, Wiederbuchung, Stammgastpflege und mögliche Loyalty-Maßnahmen.
**Schnittstellen:** V02 übergibt qualifizierte Anfragen an V01. Loyalty-/Stammgastmerkmale können in der Angebotskalkulation von V01 berücksichtigt werden. Nach dem regulären Aufenthalt verbleiben **Dank, Feedback und Bewertung** fachlich in V01/P05; zulässig nutzbare Informationen können zur Gästebindung an V02 übergeben werden.
**Status:** Die detaillierte Kampagnen-, CRM- oder Loyalty-Prozessgestaltung ist **nicht beschlossen** und gehört nicht zur aktuellen Priorität der Buchungsprozess-Umsetzung. Keine vorsorgliche Ausgestaltung als großes Marketingmodul.
[Zur Prozesslandkarte](00_Prozesslandkarte.md)
@@ -1,47 +0,0 @@
---
id: X00
typ: prozesskatalog
titel: Sonder- und Ausnahmeprozesse
status: arbeitsstand
version: "0.9"
---
# X00 – Sonder- und Ausnahmeprozesse (vorläufiger Katalog)
Sonderprozesse können aus unterschiedlichen Phasen starten. Sie nutzen denselben Vorgang; keine parallelen Buchungsformulare/-workflows.
| ID | Prozessfamilie | Typische Auslöser |
|---|---|---|
| X01 | Angebotsänderung | Verhandlung oder Anpassung **vor** Annahme |
| X02 | Vertragsänderung/Umbuchung | Änderungen **nach** verbindlicher Buchung |
| X03 | Angebots-/Holdablauf | Ablehnung, Fristablauf, Freigabeprüfung |
| X04 | Stornierung | Gast, Vermieter, externes Portal |
| X05 | Zahlungsstörung/Erstattung | Zahlungsverzug, Rückerstattung, Streit |
| X06 | Datenklärung/Dublette | Fehlende oder widersprüchliche Gast-/Buchungsdaten |
| X07 | Verfügbarkeits-/Portalfehler | Doppelbuchung, verspätete Sync, falsche Zuordnung |
| X08 | Aufenthaltsabweichung | No-show, Verlängerung, vorzeitige Abreise |
| X09 | Schäden/Reklamation | Mangel, Schaden, Kaution/Nachforderung |
**Alternative Prozessausgänge (E-011):** X03 kann zu **ohne Buchung beendet** führen; X04 kann eine bereits verbindliche Buchung zu **storniert** führen. Dies sind Endergebnisse von V01, keine eigenständigen parallelen Buchungsworkflows. Vorreservierung, Kalender, Dokumentation und offene Pflichten müssen je Fall nachweisbar behandelt werden. Einzelregeln noch offen.
**Prozessübergabe nach V01 (E-010):** Nach Abschluss der Buchungs- und Leistungserbringung noch offene Fälle (z. B. Schadenersatzforderung, Erstattung, Streitfall) werden an einen zuständigen Folgeprozess übergeben. Sie bleiben mit der ursprünglichen Buchung verbunden. Ob dafür ein separater Vorgang oder eine verknüpfte Aktivität angelegt wird, ist noch nicht entschieden.
**Rechtsfragen separat:** Für externe Vollabwicklung liegt die Vertrags-/Mahn-/Storno-Verantwortung beim Portal gemäß vertraglicher Vereinbarung; FewoPortal braucht einen nachvollziehbaren Übergabestatus und mindestens die für eigene Pflichten nötigen Informationen.
## Präzisierung v0.7: Änderungs-/Stornovorgang und Konfliktnachweise
- **X02/X04:** Zwischen *Anfrage*, *Annahme/Bestätigung*, *wirksamer Vertragsänderung/Stornierung* und *tatsächlichen Finanz-/Belegungsfolgen* unterscheiden. Ursache, Initiator, Ausführender und Verantwortlicher sind keine austauschbaren Felder. Tatsächlicher Vermieterstornogrund bleibt Vermieterstornogrund, selbst wenn ein Gast auf der Portaloberfläche die Aktion ausführt; Portalregeln und rechtliche Wirkungen gesondert prüfen. Der Betreiber hat beim FeWo-direkt-Konto bislang keine solche Änderung oder Vermieterstornierung selbst durchgeführt; unbekannte Prozesse nicht als erprobte Ist-Abläufe ausgeben.
- **X05/X06:** Fehlende Preisdetails, zusammengefasste Service-/Provisionsanteile oder abweichende Auszahlungssummen sind normale Klärungsfälle; manuelle Zuordnung und erneuter Abgleich, ohne Buchungspreis zu überschreiben.
- **X07:** Bei Destination Solutions manuelle Kalendersperre ohne serverseitig/partnernetzweit bestätigten Sperrnachweis; bei FeWo-direkt verzögerter iCal-Import. Technische Ursache und mögliche Rechts-/Haftungsfolgen getrennt bewerten. [[X01_Belegungskonflikte_und_Sperrnachweise|Ausführlicher Fachfall X07]].
## Präzisierung v0.9 – A6 und gemeinsame Änderungsmechanik
**A6** ist ein **normaler Vorgangstyp**, kein eigenständiger Sonderprozess. Änderung, Verschiebung, Verkürzung, Verlängerung und Aufhebung von Eigenbelegung, privatem Aufenthalt oder Sperre können den bestehenden Änderungs-/Stornomechanismus nutzen. Die **technische Wiederverwendung** macht eine Wartungssperre aber nicht zu einem Mietvertrag; Vertragsstorno, Aufhebung einer Sperre und Rücktritt von privater Überlassung sind fachlich zu unterscheiden.
Ereignis, Grund, Nutzer, Zeitstempel, Auswirkungen auf Belegung/Kalender, Gäste, Zusatzleistungen und Zahlungen sind nur soweit relevant aufzunehmen. Holds von A1/A2 sind keine eigenen A6 und werden im jeweiligen Angebot verwaltet.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[00_Prozesslandkarte|Prozesslandkarte]] · [[X01_Belegungskonflikte_und_Sperrnachweise|X07 Belegungskonflikte]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[P03/P03_Buchungsverwaltung_und_Abwicklung|P03]]
@@ -1,52 +0,0 @@
---
id: X07-DOK
typ: sonderprozess
titel: Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen
status: diskussionsentwurf
version: "0.9"
stand: 2026-11-01
---
# X07 – Verfügbarkeitsabgleich, Sperrnachweise und Doppelbuchungen
**Geltungsbereich:** Alle Buchungsarchetypen und Vertriebskanäle. Das Dokument ist eine Vertiefung von X07 aus [[X00_Sonderprozesse|X00]], kein zusätzlicher Buchungsarchetyp.
## 1. Reale Ursachen und Grenzen
- **FeWo-direkt:** Verzögertes iCal-Importintervall kann dazu führen, dass nach einer eigenen verbindlichen Buchung dort noch buchbare Zeiten angezeigt werden. Dass ein eigener Export korrekt aktualisiert wurde, beweist keine rechtzeitige Portalübernahme.
- **Destination Solutions:** Beim konkreten Vermieteraccount fehlt ein automatischer Kalenderabgleich; manuelle Sperrung im Zielportal. Anschließende Weitergabe an Partnerportale und wirksamer Zeitpunkt sind **nicht verifizierbar**; eine protokollierte Sichtkontrolle des Vermieters ist kein Portalserver-Zeitstempel.
- **Generische Grenze:** Bei heute sofort wirksam werdenden externen Direktbuchungen verhindert FewoPortal **nicht jede Doppelbuchung**. Vom Betreiber vorgeschlagene 10-Minuten-Bestätigung oder Livefreigabe sind sinnvolle technische Zukunftsoptionen, werden **nicht als bestehende Funktionen** vorausgesetzt.
## 2. Minimale Nachweiskette, ohne Überbürokratisierung
1. **Auslösende Buchung:** Portal/Quelle, externe Referenz, Ankunft der Nachricht, soweit ermittelbarer tatsächlicher Buchungs-/Bestätigungszeitpunkt.
2. **Eigene Belegungsänderung:** Zeitstempel, interne Buchungs-ID, Zeitraum, Nutzer/Systemaktion, Stand eigener Kalender.
3. **Propagation:** Ausgeführter Export oder angelegte manuelle Sperraufgabe; Zeitpunkt und verantwortliche Person.
4. **Zielportal:** Soweit möglich manuelle Sichtkontrolle und optionaler Screenshot. Status nur **„angezeigt“**, wenn dadurch belegt.
5. **Partnernetz:** Nur als **„wirksam nachgewiesen“** markieren, falls geeignete Rückmeldung/Protokoll vorhanden; sonst **„unbekannt“**.
6. **Fehler:** Doppelbuchung → Meldungszeitpunkte, beide Verbindlichkeitsnachweise, mögliche Ursache, Kommunikation und Entscheidung gesondert festhalten.
**Rechtliche Vorsicht:** Ein technisch nicht vermeidbarer Sync-Verzug belegt nicht automatisch fehlendes Verschulden nach Miet- und Portalvertrag. Verantwortlichkeit erst nach Vertrags- und Sachverhaltsprüfung beurteilen. FeWo-direkt-Richtlinien zu Gastgeberstornierungen gesondert beachten; die tatsächliche Ursache nicht durch Gast-Button umdeklarieren.
## 3. Generischer Konflikt-Teilprozess
Konflikt entdecken → unverändert dokumentieren → **bereits verbindliche Buchungen** und Zeitachse prüfen → Ursache/Zuständigkeiten ermitteln → realistische Lösung mit Gästen/Portalen abstimmen → **rechtlich tatsächlich wirksame** Umbuchung/Stornierung oder Alternativleistung dokumentieren → Kalender/Finanzen/Vertragsdokumente aktualisieren → Folgefälle übergeben.
Keine bereits verbindliche externe Buchung nur aufgrund widersprüchlicher Kalenderdaten löschen; keine bloße Stornoanfrage als wirksam verbuchen. Mit dem Gast wird transparent kommuniziert, ohne durch Druck eine abweichende Ursache zu konstruieren.
## 4. Zielarchitektur, nicht Ist-Funktionen
Mögliche spätere technische Fähigkeiten: Live-API-Verfügbarkeitsabfrage, atomare Reservierung, Portalbestätigung vor Vertragsschluss, Webhooks/Audit-Logs, automatische Konfliktfrüherkennung. **Aktuell nicht als verfügbar oder implementiert voraussetzen.** Für den MVP zunächst: gut sichtbare Sperraufgaben und revisionsfähige Eigenprotokolle.
Siehe [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]], [[E00_Entscheidungsprotokoll|E00]], [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]].
## Präzisierung v0.9 – eigener A6-Vorgang und pragmatische Sicherung
A6-Sperren und Holds von A1/A2 benutzen denselben Mechanismus zur Belegungswirkung, bleiben aber **verschiedene Vorgangssachverhalte**. Eine eigenständige A6-Eigenbelegung/Sperre wird mit Anlass, Grund und Bearbeitungsverlauf erfasst; ein A1/A2-Hold ist nur eine zeitlich begrenzte Aktivität im bestehenden Vermietungsvorgang.
**Pragmatisches Risikoniveau (E-027):** Nach Betreiberangabe traten rund zwei Doppelbuchungen in 20 Jahren auf. Das begründet **keine technische Null-Risiko-Garantie**, aber die Priorität liegt bei einfachen Sperr-/Nachweisaufgaben und sachgerechter Konfliktbehandlung, nicht bei komplexer Risikoprognose. Externe Echtzeitprüfung unmittelbar vor verbindlicher Direktbuchung wäre eine sinnvolle Schnittstellenfähigkeit, wird aber nicht unterstellt.
## Verknüpfungen (Obsidian)
[[README|Startseite]] · [[X00_Sonderprozesse|Sonderprozesse]] · [[P01/P01_Buchungseingang_und_Verfuegbarkeit|P01]] · [[R00_Szenarien/R08_Destination_Solutions|Destination Solutions]] · [[A04_FeWoDirekt_Vertragsvorlage_Prozessanalyse|FeWo-direkt]]
+2
View File
@@ -1,5 +1,7 @@
# Projektstand
**Ein Eingang für alle Kanäle – Paket 4 der Prozessarchitektur v0.10 (03.11.2026, Branch `feature/eingang`, nicht ausgeliefert):** Portalbuchungen und -anfragen kommen über einen Eingang (`App\Channels\Intake\PortalIntake`, aufgerufen nach jedem Kalenderabgleich und aus `ProcessPortalMail`): sicher erkannte Buchungen (Buchungsmail mit Nummer, Kalenderregel „Reservierung dieses Portals“) werden zum Vorgang ohne Angebot/Annahme, Anfrage-Mails zur A2-Anfrage; Dubletten über Buchungsnummer → gleiches Portal mit gleichen Nächten → Spiegelung, nie nach bloßer Überschneidung; Unsicheres wird unter „Zu erledigen“ geklärt („Klären: Was ist das?“). Stornomail, verschwundener oder geänderter Kalendereintrag eines gebuchten Vorgangs → Aufgabe am Vorgang, keine stille Stornierung. Schalter je Kanal `channels.case_intake` (Aus = Standard, Beobachten, Anlegen, Anlegen + weiter); Eingangsprotokoll (System › Eingangsprotokoll, `channels:intake-report`); Bestandsübernahme `channels:adopt-occupations` (Vorschau, `--apply`, `--revert`). Portalaufgaben mit Nachweisstufe (veranlasst / im Portal gesehen / bestätigt). **662 Tests grün**, Browserprüfung durchgeführt. Ergebnis und Aktivierungsweg: [docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P4.md](Prozessarchitektur/UMSETZUNGSERGEBNIS_P4.md).
**Dokumentenzusammenstellung und Vorlagensteuerung – Paket 3 der Prozessarchitektur v0.10 (02.11.2026, Branch `feature/vorgang`, nicht ausgeliefert):** Vor jedem Dokument dieselbe Zusammenstellung (`App\Documents\DocumentComposer`, Ansicht `filament/document-composition`): Empfänger, Zeitraum, Preis mit Herkunft, Leistungen, Stornoregel, Vorlage mit Herkunft, Anlagen, Hinweise (fehlt / bitte prüfen / Info), E-Mail- und PDF-Vorschau. Dokumentart je Vorgang automatisch (`App\Enums\DocumentKind`): Anfrage → Angebot mit Annahmelink, eigene Buchung → Bestätigung mit Mietvertrag, beim Portal verbindlich (A3/A4) → **Buchungsunterlagen ohne Annahmelink** (`BookingDocumentation`). Unterlagen verbindlicher Vorgänge nur über `SendBookingDocuments` (automatisch nur ohne Prüfpunkte, von Hand mit bestätigten Hinweisen, einmalig per Sperre); Angebote mit `expected_version` gegen Doppelversand; ohne Vorreservierung (Hold 0) kein Angebot ohne ausdrückliche Entscheidung. Vorlagen haben Freigabe und „gibt nur Portalbedingungen wieder“ (entfallen bei Textänderung); die Buchungsunterlagen extern sind eine Arbeitsfassung bis zur Freigabe unter So arbeite ich › Dokumente. **648 Tests grün**, Browserprüfung durchgeführt. Ergebnis, offene Freigaben (FeWo-direkt-Vorlage FW-01, Unterlagentext) und Empfehlung Paket 4: [docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P3.md](Prozessarchitektur/UMSETZUNGSERGEBNIS_P3.md).
**Vorgangskern und geführte Vorgangsbearbeitung – Pakete 1 und 2 der Prozessarchitektur v0.10 (01.11.2026, Branch `feature/vorgang`, nicht ausgeliefert):** Die Buchung ist der einheitliche Vorgang (Eingangsart, Vorgangsart A1–A6, eingefrorenes Abwicklungsprofil, gespeicherter Verlauf `booking_events`); Gast, Personen und Preis dürfen unbekannt sein, keine Platzhalter-Gäste mehr. Einstellungen in Ebenen: System › **So arbeite ich** (Vermieterstandard) → Abweichung der Wohnung (Expertenansicht) → Abweichung je Portal und Buchungstyp → Vorgang (`App\Process\ProcessSettings`). Ein Übernahmeweg für beim Portal feste Buchungen (`TakeOverExternalBooking`, Portalpreis als eine Position) ersetzt „Portal-Buchung erfassen“ und die Logik von „Akte anlegen“. Startseite **„Zu erledigen“**, neue Vorgangsseite (Stand in einem Satz, „Als Nächstes“, Ablauf, Verlauf, Hauptknopf, Automatik/Freigabe, „Beenden“ nur über Storno), „Neu“-Dialog mit drei Einstiegen, Status von Hand nur im Expertenmodus. Migration übernimmt bisheriges Verhalten unverändert (Bericht `php artisan process:settings-report`). **634 Tests grün**, Pint. Ergebnis, Abnahmekriterien und offene Punkte: [docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md](Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md). Vor dem Deployment: Migration auf dem Testsystem (MariaDB) prüfen, Bedienprobe mit der Vermieterin.
+367
View File
@@ -0,0 +1,367 @@
<?php
namespace Tests\Feature;
use App\Actions\ProcessPortalMail;
use App\Actions\ProvideGuestContact;
use App\Actions\SyncChannel;
use App\Actions\TakeOverExternalBooking;
use App\Channels\Mail\PortalMail;
use App\Enums\BookingStatus;
use App\Enums\BookingTaskKind;
use App\Enums\CaseIntakeMode;
use App\Enums\CaseType;
use App\Enums\ChannelTaskProof;
use App\Enums\IntakeKind;
use App\Enums\IntakeOutcome;
use App\Enums\ProcessingMode;
use App\Filament\Resources\ChannelTasks\Pages\ListChannelTasks;
use App\Filament\Resources\PortalOccupations\Pages\ViewPortalOccupation;
use App\Mail\BookingConfirmed;
use App\Mail\BookingDocumentation;
use App\Mail\OfferMade;
use App\Models\Booking;
use App\Models\BookingTask;
use App\Models\Channel;
use App\Models\ChannelTask;
use App\Models\IntakeObservation;
use App\Models\Property;
use App\Models\User;
use App\Process\CaseActivities;
use App\Process\CaseAutomation;
use App\Process\WorkList;
use App\Support\Settings;
use App\Tenancy\TenantContext;
use Carbon\CarbonImmutable;
use Database\Seeders\PropertySeeder;
use Database\Seeders\SiteSeeder;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Mail;
use Illuminate\Support\Facades\Storage;
use Livewire\Livewire;
use Tests\TestCase;
/**
* Package 4 of UMSETZUNGSPLAN_v0.10: one intake for all channels – bookings and requests from portals become cases
* without a manual "file", the same booking arriving by mail and calendar stays one case, uncertain entries are
* clarified, portal reports reach the case as tasks, portal blocks state their proof, and nothing happens on a channel
* that was not switched on.
*/
class CaseIntakeTest extends TestCase
{
use RefreshDatabase;
private const BOOKING_MAIL = "Neue Buchung für Ferienwohnung Stommer\nAnreise: 07.12.2026\nAbreise: 14.12.2026\nBuchungsnummer: HA-7X3K9Q";
private Property $property;
private Channel $fewo;
/** What the portal calendars deliver right now. */
private string $currentFeed = '';
protected function setUp(): void
{
parent::setUp();
$this->travelTo(CarbonImmutable::parse('2026-11-02 10:00'));
$this->seed([PropertySeeder::class, SiteSeeder::class]);
$this->property = Property::sole();
app(TenantContext::class)->set($this->property->tenant);
$this->fewo = Channel::factory()->for($this->property)->create([
'name' => 'FeWo-direkt',
'booking_model' => 'portal_booking',
'case_intake' => CaseIntakeMode::Create,
'settings' => ['import_url' => 'https://portal.example/fewo.ics', 'email_senders' => 'fewo-direkt.de'],
'process_overrides' => ['booking' => ['payments' => 'portal']],
]);
$this->fewo->forceFill(['ical_active_rules' => [self::reservationRule()]])->save();
Mail::fake();
Storage::fake('local');
Http::fake(fn () => Http::response($this->currentFeed));
$this->withoutVite();
}
/** 4.2 */
public function test_a_booking_mail_becomes_a_case_and_the_later_calendar_entry_joins_it(): void
{
$this->mail('Neue Buchung', self::BOOKING_MAIL);
$case = Booking::query()->sole();
$this->assertSame([BookingStatus::Confirmed, IntakeKind::Booking, CaseType::A4, 'HA-7X3K9Q', $this->fewo->id], [$case->status, $case->intake, $case->case_type, $case->portal_reference, $case->origin_channel_id]);
$this->assertNull($case->guest_id);
$this->assertNull($case->total);
$this->assertNull($case->guests);
$this->assertSame(ProcessingMode::Manual, $case->processing_mode);
$this->assertSame(0, $case->offer_version);
$this->assertSame('Automatisch aus der Buchungsmail von FeWo-direkt angelegt', $case->events()->where('type', 'intake')->value('summary'));
$this->sync($this->fewo, self::feed('evt-1', 'Reservation: Nora Beispiel', 'Buchung HA-7X3K9Q', '20261207', '20261214'));
$this->assertSame(1, Booking::query()->count());
$entry = $this->fewo->blockedPeriods()->where('source', 'channel')->sole();
$this->assertTrue($entry->is_representation);
$this->assertSame($case->id, $entry->linked_booking_id);
$this->assertStringContainsString('Weitere Quelle zugeordnet', (string) $case->events()->where('type', 'intake')->reorder()->orderByDesc('id')->value('summary'));
// The portal collects the money: no payment tasks of our own; nothing went to the guest.
$this->assertFalse($case->fresh()->wantsPaymentTasks());
$this->assertSame('läuft über das Portal', collect(CaseActivities::for($case->fresh()))->firstWhere('key', 'payment')?->detail);
Mail::assertNotSent(BookingDocumentation::class);
Mail::assertNotSent(BookingConfirmed::class);
}
public function test_a_calendar_reservation_becomes_one_case_however_often_the_calendar_is_read(): void
{
$feed = self::feed('evt-2', 'Reservation: Nora Beispiel', 'Buchung HA-AAAAA1', '20261207', '20261214');
$this->sync($this->fewo, $feed);
$this->sync($this->fewo, $feed);
$this->sync($this->fewo, $feed);
$case = Booking::query()->sole();
$this->assertSame('HA-AAAAA1', $case->portal_reference);
$this->assertStringContainsString('Name laut Portal: Nora Beispiel', (string) $case->internal_notes);
$this->assertNull($case->guest_id, 'a name in a calendar is no guest identity');
$this->assertSame(1, IntakeObservation::query()->where('outcome', IntakeOutcome::Create)->count());
}
public function test_the_same_portal_with_the_same_nights_joins_the_existing_case(): void
{
$case = app(TakeOverExternalBooking::class)->handle($this->property, $this->fewo, CarbonImmutable::parse('2026-12-07'), CarbonImmutable::parse('2026-12-14'), ['portal_total' => 90000]);
$this->sync($this->fewo, self::feed('evt-3', 'Reservation: Nora Beispiel', '', '20261207', '20261214'));
$this->assertSame(1, Booking::query()->count());
$this->assertSame($case->id, $this->fewo->blockedPeriods()->sole()->linked_booking_id);
}
/** 4.3 */
public function test_an_unrecognised_calendar_entry_is_clarified_and_the_answer_booking_creates_the_case(): void
{
$this->sync($this->fewo, self::feed('evt-4', 'Blocked', '', '20261207', '20261214'));
$this->assertSame(0, Booking::query()->count());
$this->assertContains('Belegung von FeWo-direkt klären', array_column(WorkList::items(), 'title'));
$observation = IntakeObservation::query()->sole();
$this->assertSame(IntakeOutcome::Clarify, $observation->outcome);
$this->assertStringContainsString('Belegt-Meldung ist kein Nachweis', implode(' ', $observation->reasons));
$this->actingAs(User::factory()->create());
Livewire::test(ViewPortalOccupation::class, ['record' => $this->fewo->blockedPeriods()->sole()->id])
->callAction('clarify', ['answer' => 'booking'])
->assertRedirect();
$this->assertSame(IntakeKind::Booking, Booking::query()->sole()->intake);
}
public function test_entries_that_are_no_booking_of_this_portal_never_become_cases(): void
{
$other = Channel::factory()->for($this->property)->create(['name' => 'Ostseeklar', 'case_intake' => CaseIntakeMode::Create, 'settings' => ['import_url' => 'https://portal.example/other.ics']]);
$other->forceFill(['ical_active_rules' => [[...self::reservationRule(), 'origin' => 'channel:'.$this->fewo->id]]])->save();
// Reservation booked at another portal, shown in this calendar.
$this->sync($other, self::feed('evt-5', 'Reservation: Nora Beispiel', '', '20261207', '20261214'));
// A reservation overlapping a case without being the same booking.
app(TakeOverExternalBooking::class)->handle($this->property, $this->fewo, CarbonImmutable::parse('2027-01-10'), CarbonImmutable::parse('2027-01-17'));
$this->sync($this->fewo, self::feed('evt-6', 'Reservation: Max Muster', 'Buchung HA-BBBBB2', '20270112', '20270119'));
$this->assertSame(1, Booking::query()->count());
$this->assertTrue($this->fewo->blockedPeriods()->where('external_uid', 'evt-6')->sole()->needs_review);
$this->assertSame(0, IntakeObservation::query()->where('outcome', IntakeOutcome::Create)->count());
}
/** 4.4 */
public function test_a_cancellation_mail_reaches_the_case_as_a_task_and_cancels_nothing(): void
{
$this->mail('Neue Buchung', self::BOOKING_MAIL);
$case = Booking::query()->sole();
$this->mail('Buchung storniert: HA-7X3K9Q', 'Die Buchung vom 07.12.2026 bis 14.12.2026 wurde storniert.', 'msg-2');
$this->mail('Buchung storniert: HA-7X3K9Q', 'Die Buchung vom 07.12.2026 bis 14.12.2026 wurde storniert.', 'msg-3');
$case->refresh();
$this->assertSame(BookingStatus::Confirmed, $case->status);
$task = BookingTask::query()->where('booking_id', $case->id)->sole();
$this->assertSame(BookingTaskKind::PortalCancellationReported, $task->kind);
$this->assertStringContainsString('FeWo-direkt meldet eine Stornierung', $task->note);
$this->assertSame(2, $case->events()->where('type', 'portal_signal')->count(), 'two different mails are two reports');
$this->assertNotNull($this->fewo->blockedPeriods()->where('source', 'email')->first(), 'the mail entry of the case is not released');
$this->assertSame('Das Portal meldet eine Stornierung – bitte prüfen', CaseActivities::next($case)?->label);
}
/** 4.4 */
public function test_a_disappeared_or_changed_calendar_entry_is_reported_once_and_nothing_is_released(): void
{
$feed = self::feed('evt-7', 'Reservation: Nora Beispiel', 'Buchung HA-CCCCC3', '20261207', '20261214');
$this->sync($this->fewo, $feed);
$case = Booking::query()->sole();
$this->sync($this->fewo, self::feed('evt-7', 'Reservation: Nora Beispiel', 'Buchung HA-CCCCC3', '20261208', '20261214'));
$this->assertSame(BookingTaskKind::PortalChangeReported, BookingTask::query()->where('booking_id', $case->id)->sole()->kind);
$empty = self::feed();
$this->sync($this->fewo, $empty);
$this->assertSame(0, BookingTask::query()->where('kind', BookingTaskKind::PortalCancellationReported)->count(), 'one missing import is no report yet');
$this->sync($this->fewo, $empty);
$this->sync($this->fewo, $empty);
$this->assertSame(1, BookingTask::query()->where('kind', BookingTaskKind::PortalCancellationReported)->count());
$this->assertSame(2, $case->events()->where('type', 'portal_signal')->count());
$this->assertSame(BookingStatus::Confirmed, $case->fresh()->status);
$this->assertTrue(Booking::query()->occupying()->whereKey($case->id)->exists());
}
/** 4.5 */
public function test_portal_blocks_state_how_far_they_are_proven(): void
{
$manual = Channel::factory()->for($this->property)->create(['name' => 'Ostseeklar', 'requires_manual_blocking' => true, 'export_enabled' => true, 'export_mode' => 'regular', 'status' => 'active']);
$case = app(TakeOverExternalBooking::class)->handle($this->property, $this->fewo, CarbonImmutable::parse('2026-12-07'), CarbonImmutable::parse('2026-12-14'));
$task = ChannelTask::query()->where('channel_id', $manual->id)->sole();
$this->actingAs(User::factory()->create(['name' => 'Ingrid']));
Livewire::test(ListChannelTasks::class)
->callTableAction('done', $task, ['proof' => ChannelTaskProof::Initiated->value, 'note' => null])
->assertHasNoTableActionErrors();
$this->assertStringContainsString('veranlasst', collect(CaseActivities::for($case))->firstWhere('key', 'channel_block')->detail);
Livewire::test(ListChannelTasks::class)
->filterTable('status', null)
->callTableAction('prove', $task, ['proof' => ChannelTaskProof::Observed->value, 'note' => 'im Kalender rot'])
->assertHasNoTableActionErrors();
$task->refresh();
$this->assertSame(ChannelTaskProof::Observed, $task->proof);
$this->assertStringContainsString('im Portal gesehen (im Kalender rot)', collect(CaseActivities::for($case))->firstWhere('key', 'channel_block')->detail);
$task->prove(ChannelTaskProof::Initiated, 'Ingrid');
$this->assertSame(ChannelTaskProof::Observed, $task->fresh()->proof, 'proof is never lowered');
}
/** 4.6 */
public function test_observing_creates_nothing_and_reports_what_would_have_been_created(): void
{
$this->fewo->update(['case_intake' => CaseIntakeMode::Observe]);
$this->mail('Neue Buchung', self::BOOKING_MAIL);
$this->sync($this->fewo, self::feed('evt-8', 'Reservation: Nora Beispiel', 'Buchung HA-DDDDD4', '20270110', '20270117'));
$this->assertSame(0, Booking::query()->count());
$this->assertSame(2, IntakeObservation::query()->where('outcome', IntakeOutcome::Create)->where('applied', false)->count());
$this->artisan('channels:intake-report')->expectsOutputToContain('Wären entstanden (Beobachten): 2')->assertSuccessful();
}
public function test_a_channel_that_was_not_switched_on_behaves_as_before(): void
{
$this->fewo->update(['case_intake' => CaseIntakeMode::Off]);
$this->mail('Neue Buchung', self::BOOKING_MAIL);
$this->sync($this->fewo, self::feed('evt-9', 'Reservation: Nora Beispiel', 'Buchung HA-EEEEE5', '20270110', '20270117'));
$this->assertSame(0, Booking::query()->count());
$this->assertSame(0, IntakeObservation::query()->count());
$this->assertSame(CaseIntakeMode::Off, Channel::factory()->for($this->property)->create()->fresh()->case_intake, 'new channels start switched off');
}
/** 4.7 */
public function test_a_portal_request_becomes_a_request_that_asks_for_the_missing_data(): void
{
$this->mail('Neue Buchungsanfrage von Max', "Anreise: 07.12.2026\nAbreise: 14.12.2026\nBuchungsnummer: HA-FFFFF6");
$case = Booking::query()->sole();
$this->assertSame([IntakeKind::Inquiry, CaseType::A2, BookingStatus::Reserved, 'HA-FFFFF6'], [$case->intake, $case->case_type, $case->status, $case->portal_reference]);
$this->assertNull($case->guest_id);
$this->assertNull($case->guests);
$this->assertNull($case->total);
$this->assertSame('provideContact', CaseActivities::next($case)?->action);
Mail::assertNotSent(OfferMade::class);
}
public function test_cases_created_with_automatic_handling_still_send_no_unreleased_documents(): void
{
$this->fewo->update(['case_intake' => CaseIntakeMode::Continue]);
Settings::tenant()->update(['process_defaults' => ['processing' => 'automatic']]);
$this->mail('Neue Buchung', self::BOOKING_MAIL);
$case = Booking::query()->sole();
app(ProvideGuestContact::class)->handle($case, ['first_name' => 'Erika', 'last_name' => 'Muster', 'email' => 'erika@example.org'], ProvideGuestContact::MANUAL);
$case->update(['total' => 90000]);
app(CaseAutomation::class)->advance($case->fresh());
$this->assertNull($case->fresh()->processing_mode);
Mail::assertNotSent(BookingDocumentation::class);
$this->assertSame('sendDocuments', CaseActivities::next($case->fresh())?->action);
}
/** 4.1 */
public function test_a_destination_solutions_booking_is_entered_by_hand_and_handled_by_us(): void
{
$ds = Channel::factory()->for($this->property)->create(['name' => 'Destination Solutions', 'booking_model' => 'portal_booking']);
$manual = Channel::factory()->for($this->property)->create(['name' => 'Ostseeklar', 'requires_manual_blocking' => true, 'export_enabled' => true, 'export_mode' => 'regular', 'status' => 'active']);
$case = app(TakeOverExternalBooking::class)->handle($this->property, $ds, CarbonImmutable::parse('2027-02-01'), CarbonImmutable::parse('2027-02-08'), ['portal_reference' => 'DS-1', 'portal_total' => 84000, 'guests' => 2, 'guest' => ['first_name' => 'Hans', 'last_name' => 'Gast', 'email' => 'hans@example.org']]);
$this->assertSame([CaseType::A3, BookingStatus::Confirmed, 0, 84000], [$case->case_type, $case->status, $case->offer_version, $case->total]);
$this->assertTrue($case->wantsPaymentTasks());
$keys = array_column(array_map(fn ($activity): array => ['key' => $activity->key], CaseActivities::for($case)), 'key');
$this->assertContains('channel_block', $keys);
$this->assertContains('deposit', $keys);
$this->assertSame(1, ChannelTask::query()->where('channel_id', $manual->id)->count());
$this->assertSame('sendDocuments', collect(CaseActivities::for($case))->firstWhere('key', 'documents')->action);
}
public function test_existing_portal_entries_are_adopted_by_a_command_with_preview_report_and_revert(): void
{
$this->fewo->update(['case_intake' => CaseIntakeMode::Off]);
$this->sync($this->fewo, self::feed('evt-10', 'Reservation: Nora Beispiel', 'Buchung HA-GGGGG7', '20270110', '20270117'));
$this->assertSame(0, Booking::query()->count());
$this->artisan('channels:adopt-occupations')->expectsOutputToContain('Vorschau – nichts geändert')->assertSuccessful();
$this->assertSame(0, Booking::query()->count());
$this->artisan('channels:adopt-occupations', ['--apply' => true])->assertSuccessful();
$case = Booking::query()->sole();
$this->assertSame(ProcessingMode::Manual, $case->processing_mode);
$this->assertSame($case->id, $this->fewo->blockedPeriods()->sole()->linked_booking_id);
$this->artisan('channels:adopt-occupations', ['--apply' => true])->assertSuccessful();
$this->assertSame(1, Booking::query()->count(), 'a repeated run adopts nothing twice');
$report = collect(Storage::disk('local')->files('intake-adoptions'))->first(fn (string $file): bool => ! str_contains($file, 'vorschau') && str_contains(Storage::disk('local')->get($file), '"created": true'));
$this->artisan('channels:adopt-occupations', ['--revert' => $report])->expectsOutputToContain('Zurückgenommen')->assertSuccessful();
$this->assertSame(0, Booking::query()->count());
$entry = $this->fewo->blockedPeriods()->sole();
$this->assertFalse($entry->is_representation);
$this->assertNull($entry->linked_booking_id);
}
private function mail(string $subject, string $text, string $messageId = 'msg-1'): void
{
app(ProcessPortalMail::class)->handle(new PortalMail($messageId, 'noreply@fewo-direkt.de', $subject, $text, CarbonImmutable::now()));
}
private function sync(Channel $channel, string $feed): void
{
$this->currentFeed = $feed;
$this->assertTrue(app(SyncChannel::class)->handle($channel->fresh())->successful);
}
private static function reservationRule(): array
{
return ['name' => 'Buchung', 'priority' => 10, 'enabled' => true, 'case_sensitive' => false, 'match' => 'all',
'conditions' => [['field' => 'SUMMARY', 'operator' => 'starts_with', 'value' => 'Reservation: ']],
'event_type' => 'portal_reservation', 'origin' => 'current', 'representation' => 'leading_candidate',
'extractions' => [
['field' => 'SUMMARY', 'target' => 'guest_full_name', 'method' => 'after', 'start' => 'Reservation: '],
['field' => 'DESCRIPTION', 'target' => 'booking_reference', 'method' => 'after', 'start' => 'Buchung '],
]];
}
private static function feed(?string $uid = null, string $summary = '', string $description = '', string $start = '20261207', string $end = '20261214'): string
{
$event = $uid === null ? '' : "BEGIN:VEVENT\r\nUID:{$uid}\r\nDTSTAMP:20261102T090000Z\r\nDTSTART;VALUE=DATE:{$start}\r\nDTEND;VALUE=DATE:{$end}\r\nSUMMARY:{$summary}\r\n".($description !== '' ? "DESCRIPTION:{$description}\r\n" : '')."END:VEVENT\r\n";
return "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//Synthetic//DE\r\n{$event}END:VCALENDAR\r\n";
}
}
+1 -1
View File
@@ -159,7 +159,7 @@ public function test_the_work_list_brings_everything_to_do_into_one_list(): void
$this->assertContains('Angebot prüfen und senden', $titles);
$this->assertContains('In Ostsee-Portal sperren', $titles);
$this->assertContains('Unbekannte Belegung von Ostsee-Portal – was ist das?', $titles);
$this->assertContains('Belegung von Ostsee-Portal klären', $titles);
$this->assertContains('Angebot nicht zugestellt', $titles);
Livewire::test(WorkListWidget::class)->assertSee('In Ostsee-Portal sperren')->assertSee('Vorgang öffnen');
}
+174
View File
@@ -0,0 +1,174 @@
<?php
namespace Tests\Feature;
use App\Actions\CreateReservation;
use App\Actions\SendOffer;
use App\Listeners\EnforceMailTestMode;
use App\Models\Property;
use App\Models\Tenant;
use App\Pricing\StayRequest;
use App\Support\Settings;
use App\Tenancy\TenantConfig;
use App\Tenancy\TenantContext;
use Carbon\CarbonImmutable;
use Database\Seeders\PropertySeeder;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Mail\Events\MessageSending;
use Illuminate\Mail\MailManager;
use Illuminate\Mail\SentMessage;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Mail;
use Illuminate\Support\Facades\Storage;
use Symfony\Component\Finder\Finder;
use Tests\TestCase;
/**
* The test operation is one gate for every outgoing e-mail ({@see EnforceMailTestMode}): whichever mailer or mailable
* sends, in test operation nothing reaches a real recipient – and without a test address nothing is sent at all.
*/
class MailTestModeGateTest extends TestCase
{
use RefreshDatabase;
protected function setUp(): void
{
parent::setUp();
config(['fewo.mail_redirect_to' => null, 'mail.default' => 'array']);
}
public function test_the_gate_is_registered_for_every_outgoing_message(): void
{
$listeners = json_encode(app('events')->getRawListeners()[MessageSending::class] ?? []);
$this->assertStringContainsString(addslashes(EnforceMailTestMode::class), (string) $listeners);
}
public function test_in_test_operation_to_cc_and_bcc_all_go_to_the_test_recipient_only(): void
{
$this->landlord(['operating_mode' => Settings::MODE_TEST, 'test_recipient' => 'test@example.com']);
Mail::raw('Hallo', fn ($message) => $message->to('gast@example.com')->cc('vermieterin@example.com')->bcc('archiv@example.com')->subject('Angebot'));
$sent = $this->sent();
$this->assertCount(1, $sent);
$this->assertSame(['test@example.com'], $this->recipients($sent[0]));
$this->assertStringContainsString('gast@example.com', $sent[0]->getOriginalMessage()->getHeaders()->get(EnforceMailTestMode::ORIGINAL_RECIPIENTS_HEADER)?->getBodyAsString());
}
public function test_any_mailer_is_gated_not_only_the_default_one(): void
{
$this->landlord(['operating_mode' => Settings::MODE_TEST, 'test_recipient' => 'test@example.com']);
config(['mail.default' => 'log']);
app(MailManager::class)->mailer('array')->raw('Hallo', fn ($message) => $message->to('gast@example.com')->subject('Direkt'));
$this->assertSame(['test@example.com'], $this->recipients($this->sent()[0]));
}
public function test_test_operation_without_any_address_sends_nothing_instead_of_the_real_recipient(): void
{
config(['fewo.notification_email' => null]);
$this->landlord(['operating_mode' => Settings::MODE_TEST, 'test_recipient' => null, 'notification_emails' => null]);
Mail::raw('Hallo', fn ($message) => $message->to('gast@example.com')->subject('Angebot'));
$this->assertSame([], $this->sent());
}
public function test_a_mode_switched_in_the_database_applies_to_the_next_mail_at_once(): void
{
$tenant = $this->landlord(['operating_mode' => Settings::MODE_LIVE, 'test_recipient' => 'test@example.com']);
// Switched back to test operation elsewhere (another process); this process was not told.
DB::table('tenants')->where('id', $tenant->id)->update(['operating_mode' => Settings::MODE_TEST]);
Mail::raw('Hallo', fn ($message) => $message->to('gast@example.com')->subject('Angebot'));
$this->assertSame(['test@example.com'], $this->recipients($this->sent()[0]));
}
public function test_only_a_landlord_switched_live_reaches_real_recipients_and_the_server_override_always_wins(): void
{
$this->landlord(['operating_mode' => Settings::MODE_LIVE]);
Mail::raw('Hallo', fn ($message) => $message->to('gast@example.com')->subject('Angebot'));
$this->assertSame(['gast@example.com'], $this->recipients($this->sent()[0]));
config(['fewo.mail_redirect_to' => 'server@example.com']);
Mail::raw('Hallo', fn ($message) => $message->to('gast@example.com')->cc('x@example.com')->subject('Angebot'));
$this->assertSame(['server@example.com'], $this->recipients($this->sent()[1]));
}
public function test_real_guest_mails_of_the_booking_process_go_to_the_test_recipient(): void
{
$this->travelTo(CarbonImmutable::parse('2026-10-22 10:00'));
$this->seed(PropertySeeder::class);
Storage::fake('local');
$property = Property::sole();
$property->tenant->update(['operating_mode' => Settings::MODE_TEST, 'test_recipient' => 'test@example.com']);
app(TenantContext::class)->set($property->tenant->fresh());
$booking = app(CreateReservation::class)->handle($property, new StayRequest(CarbonImmutable::parse('2026-11-07'), CarbonImmutable::parse('2026-11-10'), 2), ['first_name' => 'Gesa', 'last_name' => 'Gast', 'email' => 'gesa@gast.example']);
app(SendOffer::class)->handle($booking);
$sent = $this->sent();
$this->assertNotEmpty($sent);
foreach ($sent as $message) {
$this->assertSame(['test@example.com'], $this->recipients($message));
}
}
/**
* Nothing in the application may send around the gate: no direct transports, no PHP mail(), no own SMTP.
*/
public function test_no_code_sends_mail_around_the_gate(): void
{
$forbidden = [
'/(?<![\w>:])mail\s*\(/' => 'PHP mail()',
'/Symfony\\\\Component\\\\Mailer\\\\(Transport|Mailer)\b/' => 'Symfony-Transport direkt',
'/getSymfonyTransport\s*\(/' => 'Transport direkt',
'/fsockopen|stream_socket_client/' => 'eigene Socket-Verbindung',
'/PHPMailer|SwiftMailer|Swift_/' => 'fremde Mail-Bibliothek',
'/sendmail/' => 'sendmail',
];
$violations = [];
foreach ((new Finder)->files()->in([app_path(), base_path('routes'), base_path('config')])->name('*.php') as $file) {
foreach ($forbidden as $pattern => $what) {
if (preg_match($pattern, $file->getContents()) === 1 && ! str_ends_with($file->getRealPath(), 'config'.DIRECTORY_SEPARATOR.'mail.php')) {
$violations[] = $file->getRelativePathname().': '.$what;
}
}
}
$this->assertSame([], $violations);
}
/**
* @return list<SentMessage|\Symfony\Component\Mailer\SentMessage>
*/
private function sent(): array
{
return array_values(iterator_to_array(app(MailManager::class)->mailer('array')->getSymfonyTransport()->messages()));
}
/**
* @return list<string>
*/
private function recipients(object $sent): array
{
return array_map(fn ($address) => $address->getAddress(), $sent->getEnvelope()->getRecipients());
}
/**
* @param array<string, mixed> $attributes
*/
private function landlord(array $attributes = []): Tenant
{
$tenant = Tenant::factory()->create($attributes);
app(TenantContext::class)->set($tenant);
app(TenantConfig::class)->refresh();
return $tenant;
}
}