diff --git a/AGENTS.md b/AGENTS.md index 58c020c..16e9fbe 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -13,7 +13,7 @@ # Ferienwohnung Stommer - Special offers are evaluated automatically by `PriceCalculator`; discounts are `QuoteLineType::Discount` lines with negative amounts. Kinds (`OfferKind`): rule, fixed dates, gap filler (`App\Availability\GapFinder`). Which offers the website advertises is decided by `App\Pricing\OfferShowcase` (not by appearances); it prices fixed dates/gaps with `PriceCalculator`. - Portal sync lives in `app/Channels` (connector interface + registry in `config/channels.php`, iCal connector/parser/feed). Our system leads; `SyncChannel` imports portal occupations as `BlockedPeriod` rows with `channel_id`; each channel's export feed excludes its own blocks. Observers on Booking/BlockedPeriod create `ChannelTask`s for portals with `requires_manual_blocking`. Portal booking e-mails are a fast path (`app/Channels/Mail`, `ProcessPortalMail`): they create blocks with source `email`, which `SyncChannel` later confirms/replaces and never removes as stale. Portal analysis: `docs/PORTALE.md`. - Website = theme system (`docs/THEMES.md`): themes live in `resources/themes/` (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 `, `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 admins via `RequireTwoFactorForAdmins`. +- 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 admins via `RequireTwoFactorForAdmins`. 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 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//`); CI `.gitea/workflows/deploy.yml`. Production has no dev packages (no factories/Faker) – production seeding via `ProductionSeeder`. - 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). diff --git a/CLAUDE.md b/CLAUDE.md index 58c020c..16e9fbe 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -13,7 +13,7 @@ # Ferienwohnung Stommer - Special offers are evaluated automatically by `PriceCalculator`; discounts are `QuoteLineType::Discount` lines with negative amounts. Kinds (`OfferKind`): rule, fixed dates, gap filler (`App\Availability\GapFinder`). Which offers the website advertises is decided by `App\Pricing\OfferShowcase` (not by appearances); it prices fixed dates/gaps with `PriceCalculator`. - Portal sync lives in `app/Channels` (connector interface + registry in `config/channels.php`, iCal connector/parser/feed). Our system leads; `SyncChannel` imports portal occupations as `BlockedPeriod` rows with `channel_id`; each channel's export feed excludes its own blocks. Observers on Booking/BlockedPeriod create `ChannelTask`s for portals with `requires_manual_blocking`. Portal booking e-mails are a fast path (`app/Channels/Mail`, `ProcessPortalMail`): they create blocks with source `email`, which `SyncChannel` later confirms/replaces and never removes as stale. Portal analysis: `docs/PORTALE.md`. - Website = theme system (`docs/THEMES.md`): themes live in `resources/themes/` (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 `, `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 admins via `RequireTwoFactorForAdmins`. +- 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 admins via `RequireTwoFactorForAdmins`. 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 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//`); CI `.gitea/workflows/deploy.yml`. Production has no dev packages (no factories/Faker) – production seeding via `ProductionSeeder`. - 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). diff --git a/app/Enums/AdminMode.php b/app/Enums/AdminMode.php new file mode 100644 index 0000000..c039ffd --- /dev/null +++ b/app/Enums/AdminMode.php @@ -0,0 +1,75 @@ + + */ + public const SIMPLE_NAVIGATION = [ + BookingResource::class, + BlockedPeriodResource::class, + GuestResource::class, + ChannelTaskResource::class, + ReviewResource::class, + ]; + + public function getLabel(): string + { + return match ($this) { + self::Simple => 'Einfache Ansicht', + self::Expert => 'Expertenansicht', + }; + } + + public function getDescription(): string + { + return match ($this) { + self::Simple => 'Nur das Tägliche: Anfragen, Buchungen und Verträge, Sperrzeiten, Gäste, Portal-Aufgaben, Bewertungen', + self::Expert => 'Alle Einstellungen: Preise, Angebote, Portale, Webseite, System', + }; + } + + /** + * Whether a resource or page appears in the menu in this mode. + * + * @param class-string $class + */ + public function shows(string $class): bool + { + return $this === self::Expert || in_array($class, self::SIMPLE_NAVIGATION, true); + } + + /** + * Label of the user menu entry that switches to this mode. + */ + public function switchLabel(): string + { + return match ($this) { + self::Simple => 'Zur einfachen Ansicht wechseln', + self::Expert => 'Zur Expertenansicht wechseln', + }; + } + + public function other(): self + { + return $this === self::Simple ? self::Expert : self::Simple; + } +} diff --git a/app/Filament/Concerns/FollowsAdminMode.php b/app/Filament/Concerns/FollowsAdminMode.php new file mode 100644 index 0000000..d1839a0 --- /dev/null +++ b/app/Filament/Concerns/FollowsAdminMode.php @@ -0,0 +1,22 @@ +user(); + $mode = $user instanceof User ? $user->adminMode() : AdminMode::Expert; + + return parent::shouldRegisterNavigation() && $mode->shows(static::class); + } +} diff --git a/app/Filament/Pages/EditContent.php b/app/Filament/Pages/EditContent.php index 878db4a..cb69704 100644 --- a/app/Filament/Pages/EditContent.php +++ b/app/Filament/Pages/EditContent.php @@ -3,6 +3,7 @@ namespace App\Filament\Pages; use App\Enums\UserRole; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Forms\Components\PhotoSelect; use App\Support\Content; use BackedEnum; @@ -29,6 +30,8 @@ */ class EditContent extends Page { + use FollowsAdminMode; + protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedPencilSquare; protected static string|UnitEnum|null $navigationGroup = 'Webseite'; diff --git a/app/Filament/Resources/Amenities/AmenityResource.php b/app/Filament/Resources/Amenities/AmenityResource.php index 1bfe7c8..341194b 100644 --- a/app/Filament/Resources/Amenities/AmenityResource.php +++ b/app/Filament/Resources/Amenities/AmenityResource.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\Amenities; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Amenities\Pages\CreateAmenity; use App\Filament\Resources\Amenities\Pages\EditAmenity; use App\Filament\Resources\Amenities\Pages\ListAmenities; @@ -17,6 +18,8 @@ class AmenityResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = Amenity::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedListBullet; diff --git a/app/Filament/Resources/Appearances/AppearanceResource.php b/app/Filament/Resources/Appearances/AppearanceResource.php index 42efd94..421d9b1 100644 --- a/app/Filament/Resources/Appearances/AppearanceResource.php +++ b/app/Filament/Resources/Appearances/AppearanceResource.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\Appearances; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Appearances\Pages\CreateAppearance; use App\Filament\Resources\Appearances\Pages\EditAppearance; use App\Filament\Resources\Appearances\Pages\ListAppearances; @@ -17,6 +18,8 @@ class AppearanceResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = Appearance::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedSwatch; diff --git a/app/Filament/Resources/BlockedPeriods/BlockedPeriodResource.php b/app/Filament/Resources/BlockedPeriods/BlockedPeriodResource.php new file mode 100644 index 0000000..9456781 --- /dev/null +++ b/app/Filament/Resources/BlockedPeriods/BlockedPeriodResource.php @@ -0,0 +1,105 @@ +columns(2) + ->components([ + Select::make('property_id') + ->label('Wohnung') + ->options(fn (): array => Property::query()->orderBy('name')->pluck('name', 'id')->all()) + ->default(fn (): ?int => Property::query()->where('is_active', true)->value('id')) + ->required() + ->columnSpanFull() + ->hidden(fn (): bool => Property::query()->count() <= 1) + ->dehydratedWhenHidden(), + DatePicker::make('starts_on')->label('Von (erste gesperrte Nacht)')->required(), + DatePicker::make('ends_on')->label('Bis (erster freier Tag)')->after('starts_on')->required(), + TextInput::make('reason') + ->label('Grund') + ->placeholder('z. B. Eigennutzung, Renovierung') + ->maxLength(255) + ->columnSpanFull(), + ]); + } + + public static function table(Table $table): Table + { + return $table + ->description('Zeiträume, in denen die Wohnung nicht vermietet wird. Belegungen aus Portalen erscheinen hier automatisch.') + ->defaultSort('starts_on') + ->columns([ + TextColumn::make('starts_on')->label('Von')->date('D, d.m.Y')->sortable(), + TextColumn::make('ends_on')->label('Bis')->date('D, d.m.Y'), + TextColumn::make('reason')->label('Grund')->placeholder('–'), + TextColumn::make('property.name')->label('Wohnung')->visible(fn (): bool => Property::query()->count() > 1), + TextColumn::make('source') + ->label('Quelle') + ->formatStateUsing(fn (string $state): string => match ($state) { + 'manual' => 'von Hand', + 'channel' => 'Portal-Kalender', + 'email' => 'Portal-E-Mail', + default => $state, + }) + ->badge(), + ]) + ->filters([ + Filter::make('upcoming') + ->label('Nur kommende') + ->default() + ->query(fn (Builder $query): Builder => $query->whereDate('ends_on', '>=', today())), + ]) + ->recordActions([ + EditAction::make()->visible(fn (BlockedPeriod $record): bool => $record->source === 'manual'), + DeleteAction::make()->visible(fn (BlockedPeriod $record): bool => $record->source === 'manual'), + ]); + } + + public static function getPages(): array + { + return [ + 'index' => ManageBlockedPeriods::route('/'), + ]; + } +} diff --git a/app/Filament/Resources/BlockedPeriods/Pages/ManageBlockedPeriods.php b/app/Filament/Resources/BlockedPeriods/Pages/ManageBlockedPeriods.php new file mode 100644 index 0000000..8add1c3 --- /dev/null +++ b/app/Filament/Resources/BlockedPeriods/Pages/ManageBlockedPeriods.php @@ -0,0 +1,19 @@ +label('Zeitraum sperren')->mutateDataUsing(fn (array $data): array => [...$data, 'source' => 'manual']), + ]; + } +} diff --git a/app/Filament/Resources/Bookings/BookingResource.php b/app/Filament/Resources/Bookings/BookingResource.php index 7827e4b..7918273 100644 --- a/app/Filament/Resources/Bookings/BookingResource.php +++ b/app/Filament/Resources/Bookings/BookingResource.php @@ -3,6 +3,7 @@ namespace App\Filament\Resources\Bookings; use App\Enums\BookingStatus; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Bookings\Pages\CreateBooking; use App\Filament\Resources\Bookings\Pages\ListBookings; use App\Filament\Resources\Bookings\Pages\ViewBooking; @@ -20,6 +21,8 @@ class BookingResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = Booking::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedCalendarDays; diff --git a/app/Filament/Resources/ChannelTasks/ChannelTaskResource.php b/app/Filament/Resources/ChannelTasks/ChannelTaskResource.php index dec7b66..b8a2c39 100644 --- a/app/Filament/Resources/ChannelTasks/ChannelTaskResource.php +++ b/app/Filament/Resources/ChannelTasks/ChannelTaskResource.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\ChannelTasks; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\ChannelTasks\Pages\ListChannelTasks; use App\Filament\Resources\ChannelTasks\Tables\ChannelTasksTable; use App\Models\ChannelTask; @@ -13,6 +14,8 @@ class ChannelTaskResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = ChannelTask::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedClipboardDocumentCheck; diff --git a/app/Filament/Resources/Faqs/FaqResource.php b/app/Filament/Resources/Faqs/FaqResource.php index 83c3341..8675139 100644 --- a/app/Filament/Resources/Faqs/FaqResource.php +++ b/app/Filament/Resources/Faqs/FaqResource.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\Faqs; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Faqs\Pages\CreateFaq; use App\Filament\Resources\Faqs\Pages\EditFaq; use App\Filament\Resources\Faqs\Pages\ListFaqs; @@ -17,6 +18,8 @@ class FaqResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = Faq::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedQuestionMarkCircle; diff --git a/app/Filament/Resources/Guests/GuestResource.php b/app/Filament/Resources/Guests/GuestResource.php index 19f399f..cf52f88 100644 --- a/app/Filament/Resources/Guests/GuestResource.php +++ b/app/Filament/Resources/Guests/GuestResource.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\Guests; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Guests\Pages\CreateGuest; use App\Filament\Resources\Guests\Pages\EditGuest; use App\Filament\Resources\Guests\Pages\ListGuests; @@ -18,6 +19,8 @@ class GuestResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = Guest::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedUsers; diff --git a/app/Filament/Resources/Notices/NoticeResource.php b/app/Filament/Resources/Notices/NoticeResource.php index 57740c7..39d6e03 100644 --- a/app/Filament/Resources/Notices/NoticeResource.php +++ b/app/Filament/Resources/Notices/NoticeResource.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\Notices; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Notices\Pages\CreateNotice; use App\Filament\Resources\Notices\Pages\EditNotice; use App\Filament\Resources\Notices\Pages\ListNotices; @@ -17,6 +18,8 @@ class NoticeResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = Notice::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedMegaphone; diff --git a/app/Filament/Resources/Pages/PageResource.php b/app/Filament/Resources/Pages/PageResource.php index fde69e3..97774f5 100644 --- a/app/Filament/Resources/Pages/PageResource.php +++ b/app/Filament/Resources/Pages/PageResource.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\Pages; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Pages\Pages\CreatePage; use App\Filament\Resources\Pages\Pages\EditPage; use App\Filament\Resources\Pages\Pages\ListPages; @@ -17,6 +18,8 @@ class PageResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = Page::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedDocumentDuplicate; diff --git a/app/Filament/Resources/Photos/PhotoResource.php b/app/Filament/Resources/Photos/PhotoResource.php index 065281c..4a372cd 100644 --- a/app/Filament/Resources/Photos/PhotoResource.php +++ b/app/Filament/Resources/Photos/PhotoResource.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\Photos; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Photos\Pages\CreatePhoto; use App\Filament\Resources\Photos\Pages\EditPhoto; use App\Filament\Resources\Photos\Pages\ListPhotos; @@ -17,6 +18,8 @@ class PhotoResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = Photo::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedPhoto; diff --git a/app/Filament/Resources/PortalEmails/PortalEmailResource.php b/app/Filament/Resources/PortalEmails/PortalEmailResource.php index ed71bee..e9b14a6 100644 --- a/app/Filament/Resources/PortalEmails/PortalEmailResource.php +++ b/app/Filament/Resources/PortalEmails/PortalEmailResource.php @@ -3,6 +3,7 @@ namespace App\Filament\Resources\PortalEmails; use App\Enums\PortalEmailStatus; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\PortalEmails\Pages\ListPortalEmails; use App\Filament\Resources\PortalEmails\Tables\PortalEmailsTable; use App\Models\PortalEmail; @@ -14,6 +15,8 @@ class PortalEmailResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = PortalEmail::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedEnvelopeOpen; diff --git a/app/Filament/Resources/Properties/PropertyResource.php b/app/Filament/Resources/Properties/PropertyResource.php index 17c3047..c5baabe 100644 --- a/app/Filament/Resources/Properties/PropertyResource.php +++ b/app/Filament/Resources/Properties/PropertyResource.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\Properties; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Properties\Pages\CreateProperty; use App\Filament\Resources\Properties\Pages\EditProperty; use App\Filament\Resources\Properties\Pages\ListProperties; @@ -22,6 +23,8 @@ class PropertyResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = Property::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedHomeModern; diff --git a/app/Filament/Resources/Reviews/ReviewResource.php b/app/Filament/Resources/Reviews/ReviewResource.php index 6a6d45d..28aef41 100644 --- a/app/Filament/Resources/Reviews/ReviewResource.php +++ b/app/Filament/Resources/Reviews/ReviewResource.php @@ -3,6 +3,7 @@ namespace App\Filament\Resources\Reviews; use App\Enums\ReviewStatus; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Reviews\Pages\CreateReview; use App\Filament\Resources\Reviews\Pages\EditReview; use App\Filament\Resources\Reviews\Pages\ListReviews; @@ -18,6 +19,8 @@ class ReviewResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = Review::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedStar; diff --git a/app/Filament/Resources/Sites/SiteResource.php b/app/Filament/Resources/Sites/SiteResource.php index 8356e23..abf79a4 100644 --- a/app/Filament/Resources/Sites/SiteResource.php +++ b/app/Filament/Resources/Sites/SiteResource.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\Sites; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Sites\Pages\CreateSite; use App\Filament\Resources\Sites\Pages\EditSite; use App\Filament\Resources\Sites\Pages\ListSites; @@ -17,6 +18,8 @@ class SiteResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = Site::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedGlobeAlt; diff --git a/app/Filament/Resources/Users/Schemas/UserForm.php b/app/Filament/Resources/Users/Schemas/UserForm.php index f2d5c3e..3bb288b 100644 --- a/app/Filament/Resources/Users/Schemas/UserForm.php +++ b/app/Filament/Resources/Users/Schemas/UserForm.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\Users\Schemas; +use App\Enums\AdminMode; use App\Enums\UserRole; use Filament\Forms\Components\Radio; use Filament\Forms\Components\TextInput; @@ -26,9 +27,15 @@ public static function configure(Schema $schema): Schema ->maxLength(255), Radio::make('role') ->label('Rolle') + ->helperText('Bestimmt, was die Person darf.') ->options(UserRole::class) ->required() ->columnSpanFull(), + Radio::make('admin_mode') + ->label('Ansicht') + ->helperText('Bestimmt nur, was im Menü erscheint. Leer = Administratoren Expertenansicht, alle anderen einfache Ansicht. Jederzeit umschaltbar über das Benutzermenü oben rechts.') + ->options(AdminMode::class) + ->columnSpanFull(), TextInput::make('password') ->label(fn (string $operation): string => $operation === 'create' ? 'Passwort' : 'Neues Passwort (leer lassen = unverändert)') ->password() diff --git a/app/Filament/Resources/Users/Tables/UsersTable.php b/app/Filament/Resources/Users/Tables/UsersTable.php index ba3a7e6..4f821a4 100644 --- a/app/Filament/Resources/Users/Tables/UsersTable.php +++ b/app/Filament/Resources/Users/Tables/UsersTable.php @@ -2,8 +2,13 @@ namespace App\Filament\Resources\Users\Tables; +use App\Models\User; +use Filament\Actions\Action; use Filament\Actions\DeleteAction; use Filament\Actions\EditAction; +use Filament\Notifications\Notification; +use Filament\Support\Icons\Heroicon; +use Filament\Tables\Columns\IconColumn; use Filament\Tables\Columns\TextColumn; use Filament\Tables\Table; @@ -16,9 +21,23 @@ public static function configure(Table $table): Table TextColumn::make('name')->label('Name')->searchable(), TextColumn::make('email')->label('E-Mail')->searchable(), TextColumn::make('role')->label('Rolle')->badge(), + TextColumn::make('mode')->label('Ansicht')->state(fn (User $record): string => $record->adminMode()->getLabel()), + IconColumn::make('two_factor')->label('2FA')->state(fn (User $record): bool => filled($record->getAppAuthenticationSecret()))->boolean(), ]) ->recordActions([ EditAction::make(), + Action::make('resetTwoFactor') + ->label('2FA zurücksetzen') + ->icon(Heroicon::OutlinedKey) + ->color('warning') + ->requiresConfirmation() + ->modalDescription('Zum Beispiel bei verlorenem Handy: Die Person richtet die Zwei-Faktor-Anmeldung bei der nächsten Anmeldung neu ein.') + ->visible(fn (User $record): bool => filled($record->getAppAuthenticationSecret())) + ->action(function (User $record): void { + $record->saveAppAuthenticationSecret(null); + $record->saveAppAuthenticationRecoveryCodes(null); + Notification::make()->title('2FA zurückgesetzt')->success()->send(); + }), DeleteAction::make(), ]); } diff --git a/app/Filament/Resources/Users/UserResource.php b/app/Filament/Resources/Users/UserResource.php index 7e46f6a..275ae82 100644 --- a/app/Filament/Resources/Users/UserResource.php +++ b/app/Filament/Resources/Users/UserResource.php @@ -2,6 +2,7 @@ namespace App\Filament\Resources\Users; +use App\Filament\Concerns\FollowsAdminMode; use App\Filament\Resources\Users\Pages\CreateUser; use App\Filament\Resources\Users\Pages\EditUser; use App\Filament\Resources\Users\Pages\ListUsers; @@ -17,6 +18,8 @@ class UserResource extends Resource { + use FollowsAdminMode; + protected static ?string $model = User::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedUserGroup; diff --git a/app/Models/User.php b/app/Models/User.php index 8ac9804..f3d58d6 100644 --- a/app/Models/User.php +++ b/app/Models/User.php @@ -3,6 +3,7 @@ namespace App\Models; // use Illuminate\Contracts\Auth\MustVerifyEmail; +use App\Enums\AdminMode; use App\Enums\UserRole; use Database\Factories\UserFactory; use Filament\Auth\MultiFactor\App\Concerns\InteractsWithAppAuthentication; @@ -17,7 +18,7 @@ use Illuminate\Foundation\Auth\User as Authenticatable; use Illuminate\Notifications\Notifiable; -#[Fillable(['name', 'email', 'role', 'password'])] +#[Fillable(['name', 'email', 'role', 'admin_mode', 'password'])] #[Hidden(['password', 'remember_token'])] class User extends Authenticatable implements FilamentUser, HasAppAuthentication, HasAppAuthenticationRecovery { @@ -32,6 +33,14 @@ public function canAccessPanel(Panel $panel): bool return $this->role !== null; } + /** + * The admin menu this user sees; without an explicit choice administrators get the expert mode. + */ + public function adminMode(): AdminMode + { + return $this->admin_mode ?? ($this->hasRole(UserRole::Admin) ? AdminMode::Expert : AdminMode::Simple); + } + public function hasRole(UserRole ...$roles): bool { return in_array($this->role, $roles, true); @@ -48,6 +57,7 @@ protected function casts(): array 'email_verified_at' => 'datetime', 'password' => 'hashed', 'role' => UserRole::class, + 'admin_mode' => AdminMode::class, ]; } } diff --git a/app/Policies/BlockedPeriodPolicy.php b/app/Policies/BlockedPeriodPolicy.php new file mode 100644 index 0000000..59a72c6 --- /dev/null +++ b/app/Policies/BlockedPeriodPolicy.php @@ -0,0 +1,13 @@ +user(); + + return $user instanceof User ? $user : null; + } + public function panel(Panel $panel): Panel { return $panel @@ -36,6 +48,17 @@ public function panel(Panel $panel): Panel isRequired: true, ) ->multiFactorAuthenticationRequiredMiddlewareName(RequireTwoFactorForAdmins::class) + ->userMenuItems([ + 'admin-mode' => Action::make('switchAdminMode') + ->label(fn (): string => (self::currentUser()?->adminMode() ?? AdminMode::Expert)->other()->switchLabel()) + ->icon(fn (): Heroicon => self::currentUser()?->adminMode() === AdminMode::Simple ? Heroicon::OutlinedAdjustmentsHorizontal : Heroicon::OutlinedSparkles) + ->action(function () { + $user = self::currentUser(); + $user?->forceFill(['admin_mode' => $user->adminMode()->other()])->save(); + + return redirect(url()->previous()); + }), + ]) ->brandName('FeWo Stommer · Verwaltung') ->navigationGroups(['Vermietung', 'Webseite', 'System']) ->colors([ diff --git a/database/migrations/2026_10_22_210023_add_admin_mode_to_users_table.php b/database/migrations/2026_10_22_210023_add_admin_mode_to_users_table.php new file mode 100644 index 0000000..f1e0a8c --- /dev/null +++ b/database/migrations/2026_10_22_210023_add_admin_mode_to_users_table.php @@ -0,0 +1,28 @@ +string('admin_mode', 20)->nullable()->after('role'); + }); + } + + /** + * Reverse the migrations. + */ + public function down(): void + { + Schema::table('users', function (Blueprint $table) { + $table->dropColumn('admin_mode'); + }); + } +}; diff --git a/docs/BETRIEB.md b/docs/BETRIEB.md index 926f10d..2ef8124 100644 --- a/docs/BETRIEB.md +++ b/docs/BETRIEB.md @@ -103,7 +103,11 @@ ## 7. Zugang zur Verwaltung (`/admin`) "cd test.fewo-stommer.de/current && /opt/RZphp84/bin/php-cli artisan users:create lars@stommer.com --name='Lars Stommer' --role=admin" ``` -Weitere Benutzer legt ein Administrator in der Verwaltung an (System › Benutzer). Rollen: `admin` (alles inkl. Benutzer), `rentals` (Vermietung), `content` (Inhalte); ohne Rolle kein Zugang. +Weitere Benutzer legt ein Administrator in der Verwaltung an (System › Benutzer): Name, E-Mail, **Rolle** (was die Person darf) und **Ansicht** (was das Menü zeigt), Passwort. Rollen: `admin` (alles inkl. Benutzer), `rentals` (Vermietung), `content` (Inhalte); ohne Rolle kein Zugang. Empfehlung: Lars `admin`, Brigitte `rentals` mit einfacher Ansicht. + +**Ansichten:** *Einfache Ansicht* – nur Anfragen & Buchungen (inkl. Bestätigen, Mietvertrag, Zahlungen), Sperrzeiten, Gäste, Portal-Aufgaben, Bewertungen. *Expertenansicht* – alle Einstellungen, die die Rolle erlaubt (Preise, Angebote, Portale, Webseite, System). Ohne Auswahl: Administratoren Experten-, alle anderen einfache Ansicht. Umschalten jederzeit über das Benutzermenü oben rechts („Zur … Ansicht wechseln“). Die Ansicht blendet nur Menüpunkte aus; Rechte regelt allein die Rolle. + +**Passwort vergessen:** Ein Administrator vergibt unter System › Benutzer › Bearbeiten ein neues Passwort (eine Selbst-Zurücksetzung per E-Mail gibt es bewusst nicht). **Handy verloren:** dort Aktion „2FA zurücksetzen“ – die Person richtet die 2FA bei der nächsten Anmeldung neu ein. **Zwei-Faktor-Anmeldung (2FA):** Filament-eigene Lösung mit Authenticator-App (TOTP, z. B. Bitwarden/Vaultwarden, Google oder Microsoft Authenticator) und Wiederherstellungscodes. - **Pflicht für Administratoren:** Nach der ersten Anmeldung wird man auf die Einrichtungsseite geleitet (QR-Code scannen, Code bestätigen, Wiederherstellungscodes sichern). Umgesetzt mit `App\Http\Middleware\RequireTwoFactorForAdmins`. diff --git a/docs/BUCHUNGSPROZESS.md b/docs/BUCHUNGSPROZESS.md new file mode 100644 index 0000000..08f4a11 --- /dev/null +++ b/docs/BUCHUNGSPROZESS.md @@ -0,0 +1,89 @@ +# BUCHUNGSPROZESS – Vertrags-, Zahlungs- und Stornierungsablauf + +> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu). + +Stand: 22.10.2026 · **Entwurf zur Freigabe.** Keine Umsetzung. Juristische Einordnung (u. a. §§ 312j, 312k BGB) ist **offener Prüfpunkt** – nichts hier ist als rechtskonform bestätigt. + +## 1. Ist-Stand (im Code belegt) + +`Reserved` (Anfrage = zugleich zeitlich begrenzte Vorreservierung, `hold_hours`) → `Confirmed` (Vermieterin bestätigt: Vertrag-PDF + Mail, Anzahlungsfrist) → `DepositPaid` → `Paid` → `Completed`; Nebenpfade `Declined`, `Expired`, `Cancelled`. Alle Statuswechsel laufen manuell (Admin) oder per Zeitjob; Zahlungen werden manuell erfasst (`RecordPayment`). Quellen: `app/Enums/BookingStatus.php`, `app/Actions/*`. + +Nicht vorhanden: Angebot als eigener Schritt, Annahme durch Gast, Nachweis des Vertragsschlusses, Stornokostenberechnung, Gäste-Storno, Erstattungsworkflow, Empfangsbestätigung mit Vertragstext. + +## 2. Ziel-Statusmodell + +| Status | Bedeutung | Belegt Kalender? | Übergang durch | Mail an Gast | +|---|---|---|---|---| +| `inquiry` | Unverbindliche Anfrage (nur Daten) | nein | Gast (Formular) | Eingangsbestätigung (nicht verbindlich) | +| `reserved` | Vorreservierung, befristet gehalten | ja (Hold) | Vermieterin/Automatik | Info zur Frist | +| `offer_sent` | Ausdrückliches Angebot mit Preis, Bedingungen, Frist | ja (bis `offer_expires_at`) | Vermieterin (später KI-Entwurf + Freigabe) | Angebot + Annahme-Link | +| `offer_expired` / `offer_declined` | Frist verstrichen / Gast lehnt ab | nein | Zeitjob / Gast | Info | +| `confirmed` | **Annahme durch Gast** → verbindliche Buchung (Vertrag geschlossen) | ja | Gast (Annahme) | Vertragsunterlagen + Zahlungsaufforderung | +| `deposit_paid`, `paid`, `completed` | wie bisher | ja | Zahlung/Zeit | Quittungen/Hinweise | +| `cancel_requested` | Stornierung/Kündigung vom Gast erklärt | ja bis Entscheidung | Gast | Eingangsbestätigung | +| `cancelled` | Storniert, Kosten berechnet | nein | Vermieterin/Automatik | Stornobeleg | +| `declined` | Vermieterin lehnt Anfrage ab | nein | Vermieterin | Absage | +| `no_show` (optional) | Nichtanreise | – | Vermieterin | – | + +Bestehende Werte bleiben gültig (Spalte `status` ist String): `Reserved` bleibt, `Confirmed` wird semantisch auf „Annahme erfolgt“ geschärft. Migrationspfad: bestehende `Confirmed`-Buchungen gelten als angenommen (Entscheidung nötig). + +**Zahlungspflicht:** Nur im Übergang `offer_sent → confirmed` durch eindeutigen Button (Beschriftung z. B. „zahlungspflichtig buchen“, ⚖ Wortlaut § 312j (3) BGB prüfen) wird sie begründet; alle übrigen Schritte sind ausdrücklich nicht zahlungspflichtig. + +## 3. Ablauf Direktbuchung + +1. **Anfrage** (Formular, bestehend `BookingRequest`): Pflichtfelder wie heute, Hinweis „unverbindlich“, Datenschutzhinweis (Art. 13). Eingangsbestätigung per Mail (bestehend `ReservationReceived`). +2. **Vorreservierung**: Datumshold wie `hold_expires_at`; Ablauf durch bestehenden Job. +3. **Angebot**: Vermieterin erstellt/prüft Angebot aus `PriceQuote` (bestehend) + Stornobedingungen + Kurabgabe-Hinweis + AGB/Datenschutz; Angebotsdokument als PDF (`documents.type=offer`), Hash gespeichert. Gültigkeit `offer_expires_at`. +4. **Annahme durch Gast** (ohne Konto): Mail mit **signiertem, befristeten, einmal nutzbaren Link** (Muster wie `URL::temporarySignedRoute` bei Newsletter/Bewertung) → Seite zeigt Angebot vollständig (Preis, Leistungen, Bedingungen) und Zusammenfassung; Bestätigung per Button. Zusätzlich möglich: Rückbestätigung per Mail-Link (Double-Check), falls ⚖ erforderlich. +5. **Verbindliche Buchung**: System setzt `accepted_at`, speichert **Annahmenachweis** (Zeitpunkt, Angebots-Hash, Angebotsversion, Bedingungenversion, IP-Hash/User-Agent – nur wenn zwingend nötig und ⚖ datenschutzrechtlich geprüft, sonst weglassen), Kalender belegt, Portal-Sperr-Aufgaben laufen (bestehender Observer). +6. **Vertragsunterlagen per E-Mail**: Bestätigungsmail + Vertrag/AGB/Stornobedingungen als PDF (bestehend `RentalContract`, `BookingConfirmed`) = **elektronische Empfangsbestätigung** des Annahme-Eingangs (⚖ § 312i BGB). +7. **Zahlung**: Anzahlung/Restzahlung wie `SendBookingReminders`/`RecordPayment`. +8. **Abschluss**: `Completed`; Bewertungsanfrage (bestehend). + +Die Akteure „Vermieterin“ und später „KI-Agent“ sind getrennt: Angebotserstellung/Annahme-Prüfung dürfen automatisiert **vorbereiten**; Versand von Preis/Angebot/Absage erfordert zunächst menschliche Freigabe (offene Entscheidung zur späteren Autonomiestufe). + +## 4. Technische Voraussetzungen (Prüfung Ist/Soll) + +| Voraussetzung | Ist | Soll | +|---|---|---| +| Eindeutige Kennzeichnung der Zahlungspflicht | ❌ | Angebotsseite/Button; Text und Reihenfolge ⚖ | +| Dokumentation des Vertragsschlusses | ❌ (nur `confirmed_at`) | `accepted_at`, Angebots-/AGB-Version, Hash, Audit-Event | +| Vertragsunterlagen per E-Mail | ✅ (PDF bei Bestätigung) | Beibehalten, um Angebot/AGB-Hash ergänzen | +| Sichere Storno-/Kündigungserklärung ohne Konto | ❌ | Signierter Link in jeder Buchungsmail → Formular (Grund optional, Pflicht: Buchungsreferenz via Link-Token); Bestätigungsmail mit Zeitstempel; Alternative: Antwort-Mail; ⚖ ob Pflicht zur elektronischen Erklärung/Button nach § 312k BGB besteht (vermutlich Dauerschuldverhältnis-bezogen, **offen**) | +| Nachvollziehbare Stornokosten | ❌ (Freitext) | Staffel als Daten (`cancellation_policy`: ab Tag X vor Anreise Y % vom Mietpreis), Berechnung im `Action`, Anzeige im Angebot und Storno-Beleg; ⚖ Zulässigkeit der Pauschalen (§ 309 Nr. 5 BGB, ggf. Angemessenheit) | +| Rückerstattungen | ⚠ negative `Payment` möglich | Erstattungs-Action: Betrag aus Policy, Grund, Beleg, Zahlungsweg (Überweisung), Status in `payments` | +| Elektronische Empfangsbestätigung | ⚠ Anfragebestätigung ✅, Annahmebestätigung ❌ | Unmittelbare Mail nach Annahme/Storno | +| Zahlungsarten | Überweisung/bar | Keine Online-Zahlung geplant (damit PCI-DSS/PSD2-Thema nicht berührt) | + +## 5. Stornierung (Entwurf) + +1. Gast klickt Link → sieht Buchung, **berechnete Stornokosten** (Policy + Datum), erklärt Storno (Button). +2. System setzt `cancel_requested`/`cancelled`, speichert Zeitpunkt (`cancelled_at`, bestehend), `cancelled_by=guest`, berechnet `cancellation_fee`; sendet Bestätigung; Admin-Hinweismail; Observer erzeugt Portal-Entsperraufgaben (bestehend). +3. Erstattung: Differenz aus Zahlungen − Kosten → Erstattungsbuchung; Beleg als Dokument. +4. Storno durch Vermieterin: wie heute möglich, aber mit Grund, Gast-Mail, automatischer Erstattung (heute nur Statuswechsel). +5. Portalbuchungen: Storno läuft über das Portal; System importiert Stornomail (bestehend `PortalEmailType::Cancellation`) und gibt Block frei; Stornokosten/Erstattung nach Portalregeln (manuell, ggf. Portalabrechnung). + +## 6. Kurabgabe, Küstenkarte, Gästemeldung (Kühlungsborn) + +**Trennung der Rechtsgrundlagen (Prüfannahme, ⚖):** +- **Bundesrechtlich:** Meldepflicht Beherbergungsstätten (Bundesmeldegesetz, §§ 29 f. BMG; Länder-/Ortsregelungen zu elektronischer Meldung beachten). Zweck: Gästemeldung/Meldeschein; Daten laut Gesetz (u. a. Name, Anschrift, Ankunft/Abreise, Zahl und Staatsangehörigkeit Mitreisender – exakter Umfang ⚖). Aufbewahrungs- und Vernichtungsfristen: **gesetzlich**, nicht frei wählbar. +- **Kommunal:** Kurabgabe (Kommunalabgabengesetz M-V + Kurabgabesatzung Ostseebad Kühlungsborn): Abgabepflichtige Personen, Befreiungen, Erhebung durch Beherbergungsbetrieb, Abführung, ggf. Aufwandsentschädigung. Erforderliche Daten (je Person: Alter/Befreiung, Aufenthaltstage) und Fristen ⚖ der Satzung. +- **Küstenkarte** (digitale Gästekarte): Ausgabe an Gäste über das lokale System; Leistungen/Daten ⚖ bei Tourist-Information klären. +- **feratel MeldeClient:** Laut `docs/PORTALE.md` Schnittstelle für Software-Partner (Testbetrieb); Konditionen, Datenumfang, Rolle (Auftragsverarbeitung oder eigene Verantwortung der Gemeinde) ❓ offen. + +**Datenfluss (Soll, vorbehaltlich Klärung):** Gast liefert Meldedaten (Pre-Check-In-Link, ohne Konto) → Daten **getrennt** vom Buchungs-CRM gespeichert (Tabellen `registrations`, `registration_guests`) → Übermittlung an feratel/Gemeinde → Löschung nach gesetzlicher Frist. Portalgäste: Meldedaten gesondert beim Gast erfragen, nicht aus Portalmails raten. + +**Technische Datenfelder (Entwurf):** je Person Vorname, Nachname, Geburtsdatum/Altersgruppe, Anschrift/Staatsangehörigkeit (nur soweit gesetzlich), An-/Abreise, Befreiungsgrund; je Buchung Kurabgabebetrag (`tourist_tax_amount`) und Erhebungsstatus (`collected_by_host`/`portal`/`on_site`). + +**Offen:** Formal Erhebung der Kurabgabe bei Portalbuchungen (Portal zieht ggf. ein), Abrechnungsweg mit Gemeinde, Rolle Tourist-Information (⚖). + +## 7. Offene Rechtsfragen (Buchungsprozess) + +1. Geltung und Ausgestaltung von § 312j BGB (Button, Informationspflichten) für Beherbergung/Ferienwohnung. +2. Anwendbarkeit von § 312k BGB (Kündigungsbutton) auf Ferienwohnungsmietverträge. +3. Widerrufsrecht bzw. gesetzliche Ausnahme bei Beherbergung zu bestimmtem Termin (§ 312g BGB). +4. Wirksamkeit/Angemessenheit der Stornopauschalen und AGB-Einbeziehung. +5. Beweisanforderungen an den Annahmenachweis; Umfang zulässiger Protokolldaten (IP). +6. Preisangaben-Pflichten (PAngV) bei Pflichtkosten/Kurabgabe. +7. Einbeziehung der Gäste-Informationspflichten (Art. 13/14) in Angebot/Vertrag. +8. Zulässigkeit automatisierter Entscheidungen bei Ablehnung/Preisbildung durch KI (Art. 22 DSGVO). diff --git a/docs/DATENMODELL-KONZEPT.md b/docs/DATENMODELL-KONZEPT.md new file mode 100644 index 0000000..8076f43 --- /dev/null +++ b/docs/DATENMODELL-KONZEPT.md @@ -0,0 +1,95 @@ +# DATENMODELL-KONZEPT – Zielarchitektur Gäste, Buchungen, Portale + +> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu). + +Stand: 22.10.2026 · **Entwurf zur Freigabe.** Keine Migration erstellt oder ausgeführt. Grundprinzipien: Datenminimierung, Quellenkennzeichnung, keine geratenen Daten, möglichst Wiederverwendung des Bestands. + +## 1. Bestandsaufnahme (Implementiert?) + +| Anforderung | Bestand | Status | +|---|---|---| +| Portalübergreifende Gästekartei, interne ID | `guests.id` ✅; aber nur Direktgäste, Dublette nur exakt per E-Mail | Teilweise | +| Herkunftsportal | `bookings.source` (Text, z. B. `website`), `referral_source` (Marketing), `blocked_periods.channel_id` + `source` | Teilweise (Portal nur am Block) | +| Externe Buchungsreferenz | `blocked_periods.external_uid`, `portal_emails.reference`; nicht am Buchungsdatensatz | Teilweise | +| Reservierungs-/Buchungsstatus | `BookingStatus` (8 Werte) ✅; kein Angebot/Annahme | Teilweise | +| Mietpreis | `bookings.total/deposit`, `quote` JSON ✅ (nur Direkt) | Teilweise | +| Portalgebühren | – | Fehlt | +| Kurtaxe | nur Hinweistext | Fehlt | +| Zahlungen | `payments` ✅ (Überweisung/bar/sonstige; Erstattung = negativer Betrag) | Vorhanden | +| Steuerrelevante Nachweise | Vertrags-PDF (`contract_path`) ✅; keine Rechnungen/Belege/Portalabrechnungen | Teilweise | +| Ein-/ausgehende Portalnachrichten | `portal_emails` (nur eingehende Benachrichtigungen, Auszug) | Teilweise | +| Dublettenprüfung / Zusammenführung | – | Fehlt | +| Datenquelle + Importzeitpunkt | `channel_sync_logs`, `portal_emails.received_at`; nicht am Gast/Buchung | Teilweise | + +## 2. Leitentscheidung (Annahme) + +**Portalbuchungen werden als `Booking` geführt** (nicht länger nur als `BlockedPeriod`), mit `source = `, optionalem Gast und leeren Feldern, wo keine Daten vorliegen. `BlockedPeriod` bleibt für Eigenbelegung, Wartung und rein per iCal bekannte Sperren. Zuordnung `BlockedPeriod` → `Booking` über neue FK, sobald eine Portal-Mail/API die Buchung identifiziert. Vorteil: ein Reporting, ein Zahlungs-/Belegmodell; bestehende `Booking::occupying()`-Logik und Observer greifen weiter. *(Entscheidung/Alternative zu bestätigen.)* + +## 3. Zielmodell (Änderungen am Bestand, kursiv = neu) + +### 3.1 `guests` (Erweiterung) +| Feld | Zweck | +|---|---| +| `id` (intern, bleibt) | eindeutige Gäste-ID | +| *`data_source`* (`direct`, `portal_mail`, `portal_api`, `manual`) | Herkunft der Stammdaten | +| *`imported_at`* | Importzeitpunkt | +| *`merged_into_id`* (nullable FK) | Zusammenführung, Quelle bleibt als „gemergt“ erhalten | +| *`address_verified`* / Feldquellen | Kennzeichnung, ob Daten vom Gast selbst stammen | +| bestehende Felder | unverändert; `email` darf bei Portalgästen **NULL** sein (Portale liefern oft maskierte Adressen) | + +### 3.2 *`guest_identities`* (optional, später) +Mehrere Kennungen je Gast (E-Mail, Portal-Alias, Telefon) mit Quelle – Grundlage der Dublettenprüfung ohne Überschreiben (löst D8). + +### 3.3 `bookings` (Erweiterung) +| Feld | Zweck | +|---|---| +| `source` (bestehend) | Kanal-Schlüssel (`website`, `fewo_direkt`, …) – mit `channels` verknüpfbar | +| *`channel_id`* (nullable) | exakte Portalzuordnung | +| *`external_reference`* (nullable, unique je Kanal) | Portal-Buchungsnummer, nur wenn belegt | +| *`imported_at`*, *`import_source`* (`ical`, `email`, `api`, `manual`) | Quelle/Zeitpunkt | +| *`offer_sent_at`, `offer_expires_at`, `accepted_at`, `acceptance_evidence`* (JSON) | Angebot/Annahme, s. BUCHUNGSPROZESS.md | +| *`rent_amount`* (bestehend `total` weiterverwendbar), *`portal_fee`*, *`tourist_tax_amount`*, *`tourist_tax_collected_by`* | Beträge in Euro-Cent | +| *`cancellation_fee`*, *`cancelled_by`*, *`cancellation_reason`* | Storno | +| `contract_path` (bestehend) | wird durch `documents` abgelöst (§3.5) | + +Beträge unverändert als Integer-Cent (Projektregel). + +### 3.4 `payments` (Erweiterung) +`type` (`deposit`, `balance`, `refund`, `portal_payout`, `tourist_tax`), `external_reference`, `currency` (EUR). Erstattungen weiter als negativer Betrag oder Typ `refund` (Entscheidung offen). + +### 3.5 *`documents`* (neu) – steuerrelevante Nachweise +`booking_id`, `type` (`contract`, `offer`, `invoice`, `receipt`, `portal_statement`, `registration_form`, `correspondence`), `path`, `sha256` (Unveränderbarkeitsnachweis), `created_at`, `retain_until` (aus Löschkonzept), `contains_personal_data`. Dateien auf privatem Disk, nicht öffentlich. Ablösung des Einzelfelds `contract_path`. + +### 3.6 *`messages`* (neu) – Portal-/Gästekommunikation +`booking_id`/`guest_id`, `direction` (`in`/`out`), `channel` (`email`, `portal`), `external_id` (z. B. Message-ID, bereits in `portal_emails.message_id`), `subject`, `body` (optional, **mit kurzer Frist**), `received_at`/`sent_at`, `source`. Bestehende `portal_emails` bleibt als Parsing-Protokoll; Auszug (`excerpt`) wird gekürzt/entfernt (D6). + +### 3.7 *`guest_merge_candidates`* (neu, optional) +`guest_a_id`, `guest_b_id`, `score`, `reasons` (z. B. gleiche E-Mail, gleicher Name + Zeitraum), `status` (`open`, `merged`, `rejected`). Zusammenführung nur manuell im Admin. + +### 3.8 *`audit_events`* (neu) +Wer/Was/Wann für Statuswechsel, Zusammenführung, Export, Anonymisierung, Dokumentabruf – ohne Inhalte, mit Löschfrist. + +## 4. Datenquellen je Feld + +| Feld | iCal | Portal-E-Mail | Autorisierte API | Direkt (Formular) | +|---|---|---|---|---| +| Zeitraum | ✅ | ✅ (Parser) | ✅ | ✅ | +| Portal/Kanal | ✅ (über Channel) | ✅ (Absender) | ✅ | – | +| Externe Referenz | UID (nicht Buchungsnr.) | ✅ falls im Text | ✅ | – | +| Gastname/E-Mail/Tel. | ❌ | ❓ nur wenn Mail sie enthält | ✅ (vertragsabhängig) | ✅ | +| Preis/Gebühren | ❌ | ❓ | ✅ | ✅ (Quote) | +| Zahlungen | ❌ | ❌ | ❓ | manuell | +| Nachrichten | ❌ | eingeschränkt | ✅ | ✅ (Mail) | + +Regel: Importer schreiben **nur** belegte Felder; Unbekanntes = `NULL` + Kennzeichnung; Parser-Unsicherheit → `needs_review` (bereits so umgesetzt). + +## 5. Dublettenprüfung und Zusammenführung + +1. Exakter Treffer: normalisierte E-Mail (bestehend) → vorschlagen, **nicht** stillschweigend überschreiben. +2. Weiche Treffer: Name + Zeitraum/Portal-Referenz, Telefonnummer normalisiert → nur als Kandidat. +3. Zusammenführung manuell: Zielgast wählen, Felder einzeln übernehmen, Buchungen umhängen, Quellgast `merged_into_id`, Audit-Eintrag; keine Löschung der Historie. +4. Direktanfragen mit bekannter E-Mail aktualisieren Stammdaten **nur nach Bestätigung** (Fix für D8). + +## 6. Wiederverwendung / Umsetzungsreihenfolge (nach Freigabe) + +1. Felder/Migrationen (additiv, rückwärtskompatibel). 2. `documents` + Umzug von `contract_path`. 3. Importpfad Portal-Mail → `Booking` (Parser bleibt). 4. Merge-Kandidaten + Admin-Aktion. 5. Finanzfelder (Gebühren, Kurtaxe). 6. API-Connector über `ChannelConnector` (nur nach Anbieter-/AVV-Klärung). diff --git a/docs/DATENSCHUTZ-AUDIT.md b/docs/DATENSCHUTZ-AUDIT.md index 2e036ce..aeb0bdd 100644 --- a/docs/DATENSCHUTZ-AUDIT.md +++ b/docs/DATENSCHUTZ-AUDIT.md @@ -1,5 +1,7 @@ # Datenschutz- und Datenfluss-Audit – Ferienwohnung Stommer +> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu). + Stand: 22.10.2026 · Art: **Read-only-Codeaudit** (Repository-Stand `main` + lokale, noch nicht committete Änderungen) · Verantwortliche: Brigitte Stommer > **Hinweis zur Verwendung:** Dies ist eine technische Bestandsaufnahme, keine Rechtsberatung. Alle Rechtsgrundlagen sind *Prüfannahmen*. Vor Veröffentlichung der Datenschutzerklärung ist eine juristische Prüfung (ggf. Datenschutzbeauftragte/r bzw. Rechtsberatung) erforderlich. Der Bericht ist vor Weitergabe an Dritte zu prüfen und zu validieren. diff --git a/docs/DATENSCHUTZ-FAKTENBASIS.md b/docs/DATENSCHUTZ-FAKTENBASIS.md new file mode 100644 index 0000000..03f4394 --- /dev/null +++ b/docs/DATENSCHUTZ-FAKTENBASIS.md @@ -0,0 +1,54 @@ +# DATENSCHUTZ-FAKTENBASIS – Grundlage für die Datenschutzerklärung + +> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu). + +Stand: 22.10.2026 · **Kein Erklärungstext, sondern strukturierte Faktenlage.** Rechtsgrundlagen sind *vorgeschlagen* (Prüfannahme) und juristisch zu bestätigen. Grundlage: Code-Audit ([DATENSCHUTZ-AUDIT.md](DATENSCHUTZ-AUDIT.md)), [LOESCHKONZEPT.md](LOESCHKONZEPT.md), [BUCHUNGSPROZESS.md](BUCHUNGSPROZESS.md). + +Status: ✅ im Code belegt · 📄 dokumentiert/konfiguriert · 🗓 geplant · ❓ unbekannt · ⚖ rechtlich zu prüfen. **Browserverhalten wurde nicht beobachtet** (nur Codebefund). + +**Verantwortliche:** Brigitte Stommer (Kontaktdaten aus `config/fewo.php`/Impressum). Datenschutzbeauftragte/r: ❓ Pflicht ⚖ prüfen. + +## Verarbeitungsvorgänge + +| # | Vorgang | Datenkategorien | Zweck | Vorgeschlagene Rechtsgrundlage ⚖ | Herkunft | Empfänger | Drittland | Speicher-/Löschregel | Technische Schutzmaßnahmen | Offene Rechtsfragen | Status | +|---|---|---|---|---|---|---|---|---|---|---|---| +| 1 | Besuch der Website / Server-Logs | IP, Zeit, URL, User-Agent | Auslieferung, Sicherheit | Art. 6 (1) f | Besucher | STRATO (Hosting) | keins bekannt ❓ | Strato-Logs ❓; Anwendungslog: Rotation geplant | HTTPS, Throttling | Log-Dauer; AVV Strato | ❓ | +| 2 | Technisch notwendige Cookies | Session-Cookie, XSRF-Token (Session-ID, IP/UA in `sessions`) | Formularschutz, Session | Art. 6 (1) f; § 25 (2) Nr. 2 TDDDG | Besucher | STRATO | – | Lifetime 120 Min. (`config/session.php`) | httpOnly, SameSite=lax, Secure auf Staging gesetzt | Banner-Pflicht verneint? Browserprüfung | ✅ Code / ❓ Browser | +| 3 | Externe Ressourcen | – (keine Drittanfragen im Code) | – | – | – | – | – | – | Schriften lokal | Verifikation im Browser | ✅ Code | +| 4 | Link zu OpenStreetMap | beim Klick: IP, Referrer, Adresse als Suchparameter an OSMF | Orientierung | Art. 6 (1) f | Besucher (Klick) | OpenStreetMap Foundation (UK) | ⚖ Drittland UK (Angemessenheitsbeschluss prüfen) | – | Kein Einbetten, kein Laden bei Seitenaufruf | Hinweis in DSE | ✅ | +| 5 | Buchungsanfrage (Direkt) | Name, E-Mail, Telefon*, Anschrift*, Zeitraum, Personen, Extras, Nachricht*, Herkunft*, UTM* (*optional) | Vertragsanbahnung | Art. 6 (1) b; Herkunft/UTM: Art. 6 (1) f | Gast | Vermieterin; STRATO (Datenbank, SMTP) | keins bekannt | Anfragen ohne Vertrag: Frist vorgeschlagen 3–6 Monate (⚖); heute 10 J. | Rate-Limit, Honeypot, CSRF, Validierung | Fristen; Einwilligungstext im Formular | ✅ | +| 6 | Vorreservierung/Angebot/Annahme | Buchungsdaten, Preise, Angebotsversion, Annahmezeit (+ Nachweisdaten) | Vertragsabschluss | Art. 6 (1) b | Gast/Vermieterin | wie 5 | – | Beleg bis Steuerfrist ⚖ | Signierter, befristeter Annahme-Link | § 312i/j/k BGB; Umfang Nachweisdaten | 🗓 (Annahme nicht implementiert) | +| 7 | Vertrag & Rechnung/Quittung | Gast-, Buchungs-, Zahlungsdaten | Vertragserfüllung, steuerl. Pflichten | Art. 6 (1) b, c | Vermieterin/Gast | Gast; Steuerberater ❓ | – | steuerliche Frist ⚖ | privater Speicher, Rollenzugriff | Frist, Anonymisierung der Belege | ✅ PDF / 🗓 Rechnungen | +| 8 | Zahlungsabwicklung | Betrag, Datum, Methode, Notiz | Zahlungsverwaltung | Art. 6 (1) b, c | Vermieterin (manuell) | Bank der Vermieterin | – | steuerliche Frist ⚖ | Kein Zahlungsdienstleister im System | Banken als eigene Verantwortliche | ✅ | +| 9 | Transaktions-E-Mails | E-Mail, Name, Buchungsdaten | Information zur Buchung | Art. 6 (1) b | Anwendung | STRATO SMTP; Gast | – | Mail-Archiv ❓ | TLS ❓ | Mail-Aufbewahrung | ✅ Code / 📄 Betrieb | +| 10 | Bewertungsanfrage + Bewertung | E-Mail, Name, Bewertung, Anzeigename, Einwilligung | Qualitätssicherung, Veröffentlichung | Anfrage: Art. 6 (1) f (⚖ § 7 UWG); Veröffentlichung: Art. 6 (1) a | Gast | Öffentlichkeit (nach Freigabe) | – | siehe LOESCHKONZEPT | Signierter Link 90 Tage, Moderation | Zulässigkeit Anfrage-Mail | ✅ | +| 11 | Angebots-/Newsletter-Einwilligung | E-Mail, Name, Consent-Zeitpunkt | Marketing | Art. 6 (1) a; § 7 UWG | Gast | Vermieterin; Versanddienst ❓ | ❓ | Bis Widerruf; Nachweis ⚖ | DOI, signierte Links | Versandweg/Dienstleister | ✅ Consent / ❓ Versand | +| 12 | Gästekartei/CRM | Stammdaten, Notizen, Tags, Aufenthalte | Kundenpflege | Art. 6 (1) f | Gast/Portal | Vermieterin | – | 3 J.-Stufe vorgeschlagen ⚖ | Policy-Rollen, 2FA für Admin | Berechtigtes Interesse; Frist | ✅ | +| 13 | CSV-Export Gäste | Stammdaten | Verwaltung/Mailing | Art. 6 (1) f | Admin | Lokaler Rechner der/des Admins | – | Verantwortung Nutzer | Rollenschutz, Audit-Log 🗓 | Auditpflicht | ✅ | +| 14 | Portal-Kalenderabgleich (iCal) | nur Zeiträume; ggf. Portal-SUMMARY | Doppelbuchung vermeiden | Art. 6 (1) b/f | Portal | Portale (nur „Belegt“) | Portalbetreiber ❓ (z. B. Vrbo/Expedia → ⚖ Drittland) | Sperren bis Zeitraumende + Frist | Token-URL, Throttle | Inhalt SUMMARY | ✅ | +| 15 | Portal-Buchungsmails | Absender, Betreff, Auszug (500 Z.), Zeitraum, Referenz; Gästedaten *nur wenn in Mail* | Sofortige Sperre, Verwaltung | Art. 6 (1) b/f | Portal (E-Mail) | STRATO (Postfach), Vermieterin | Portalbetreiber ❓ | Auszug kurz; Referenz/Zeitraum bis Steuerfrist ⚖ | IMAP/SSL, Parser „nie raten“ | Art. 14-Information | ✅ Code / 🗓 Produktiv | +| 16 | Portalbuchungen als Gast (geplant) | Gastdaten laut Portal, Preise, Gebühren | zentrale Verwaltung, Steuer | Art. 6 (1) b, c, f | Portal (E-Mail/API) | wie oben | ❓ | wie 7/12 | s. DATENMODELL-KONZEPT | Art. 14, AVV mit Channel-Manager | 🗓 | +| 17 | Gästemeldung / Kurabgabe | Meldedaten je Person, Aufenthalt, Befreiung | gesetzliche Meldung, Abgabe | Art. 6 (1) c (BMG), Art. 6 (1) e/c (Kurabgabesatzung) ⚖ | Gast | Gemeinde/Tourist-Info, feratel ❓ | ❓ | gesetzliche Frist ⚖ | getrennte Speicherung (Soll) | Bund/Kommune trennen; Rolle feratel | 🗓 | +| 18 | Admin-Zugang | Name, E-Mail, Rolle, 2FA | Verwaltung | Art. 6 (1) f | Admins | – | – | bis Ausscheiden | Passwort-Hash, TOTP-2FA, Rollen | – | ✅ | +| 19 | Monitoring/Automation (n8n, Webhook) | Betriebsstatus, Aufgaben | Überwachung, Portalsperre | Art. 6 (1) f | Anwendung | Privater Server ❓ | ❓ | ❓ | HMAC, Tokens (Query ⚠) | Auftragsverarbeitung, Standort | 📄 | +| 20 | KI-Agent | – | – | – | – | – | – | – | – | Anbieter, EU/EWR, Training, Art. 22 | 🗓 nicht implementiert | +| 21 | Backups | gesamter Datenbestand | Verfügbarkeit | Art. 6 (1) f, Art. 32 | – | STRATO/Eigenbetrieb ❓ | ❓ | rollierend (Vorschlag 30 T.) | ❓ | Retention vs. Löschung | ❓ | + +## Empfänger-/Dienstleisterliste (für DSE) + +STRATO AG (Hosting, DB, E-Mail) – AVV ❓ · OpenStreetMap Foundation (nur bei Klick) · Portalbetreiber (FeWo-direkt/Vrbo/Expedia u. a.) als eigene Verantwortliche – ❓ · Steuerberater ❓ · Gemeinde/Tourist-Information/feratel (nur bei Meldepflicht) ❓ · n8n-Betreiber ❓ · KI-Anbieter 🗓. + +## Rechte und Pflichttexte (⚖ ausformulieren) + +Auskunft (Art. 15), Berichtigung, Löschung, Einschränkung, Übertragbarkeit, Widerspruch (Art. 21), Widerruf Einwilligung, Beschwerde bei Aufsichtsbehörde, Pflichtangaben vs. freiwillige Angaben, automatisierte Entscheidungen (derzeit keine ✅). + +## Querschnitts-Fragen für Rechtsberatung / Datenschutzbeauftragte + +1. DSB-Pflicht, Verarbeitungsverzeichnis (Art. 30), AVVs (Strato, n8n-Betreiber, ggf. Channel-Manager/KI). +2. TDDDG/Cookie-Einordnung der technisch notwendigen Cookies. +3. Art. 14-Information für Portalgäste und Ausnahmen. +4. Rechtsgrundlage und Fristen für Anfragen, Bewertungen, Marketing-Nachweis. +5. Drittlandbezug der Portalbetreiber und der KI-Anbieter. +6. Beweis-/Annahmeprotokoll beim Vertragsschluss (Datenumfang). + +*Vor externer Verwendung (Veröffentlichung/Weitergabe) bitte durch fachkundige Stelle prüfen.* diff --git a/docs/GAP-DELTA.md b/docs/GAP-DELTA.md new file mode 100644 index 0000000..5488719 --- /dev/null +++ b/docs/GAP-DELTA.md @@ -0,0 +1,54 @@ +# GAP-DELTA – Ergänzungen zum Datenschutz-Audit + +> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu). + +Stand: 22.10.2026 · Ergänzt [DATENSCHUTZ-AUDIT.md](DATENSCHUTZ-AUDIT.md) um die verbindlichen Produktentscheidungen (Folgeauftrag). **Reine Analyse – keine Codeänderung, keine Migration, kein Deployment.** Rechtliche Punkte sind Prüfannahmen und mit ⚖ „rechtlich zu prüfen“ markiert. + +Legende: ✅ implementiert und im Code belegt · 📄 nur konfiguriert/dokumentiert · 🗓 geplant · ❓ unbekannt · ⚖ juristische Prüfung nötig + +## 1. Verbindliche Entscheidungen und ihr Umsetzungsstand + +| # | Entscheidung | Ist-Stand | Status | +|---|---|---|---| +| E1 | Laravel-System führend für alle Buchungen und Gäste | Direktbuchungen ✅ (`bookings`, `guests`). **Portalbuchungen sind keine `Booking`-Datensätze**, sondern `BlockedPeriod` (Sperre, ohne Gast, ohne Preis) bzw. `PortalEmail` (Auszug). Damit ist das System nur für die *Belegung* führend, nicht für Portalgäste und -umsätze | ⚠ Lücke | +| E2 | Portalbuchungen zentral verwalten | Nur Kalenderblock + Hinweis-Mail; keine Gäste-, Preis-, Gebühren-, Zahlungsdaten | ⚠ Lücke | +| E3 | Buchungs-/Zahlungsnachweise steuerlich verfügbar | Direkt: `payments`, `bookings.quote` (JSON), Vertrags-PDF ✅. Keine Rechnung/Beleg-Dokumente, keine Portalabrechnungen, keine Unveränderbarkeit/Revisionssicherheit | ⚠ Teilweise | +| E4 | Kein Gästekonto | ✅ (signierte Links für Bewertung/Newsletter). Für Annahme/Storno fehlt ein Äquivalent | ⚠ Lücke | +| E5 | Anfrage → Vorreservierung → Angebot → Annahme → Buchung | Status: `Reserved` (Anfrage+Vorreservierung vermischt) → `Confirmed` durch Vermieterin. **Kein Angebot, keine Gast-Annahme** | ⚠ Lücke | +| E6 | KI später | Kein KI-Code (✅ belegt: keine KI-Pakete/Aufrufe) | 🗓 | +| E7 | Privacy by Design / Datenminimierung | Teilweise (Honeypot, Rate-Limit, Anonymisierung, signierte Links); Lücken in Löschung, Logs, Sessions | ⚠ Teilweise | + +## 2. Neue/präzisierte Befunde (Delta zum Audit) + +| ID | Prio | Befund | Beleg | Folge | +|---|---|---|---|---| +| D1 | **K** | Portalgäste existieren im System nicht (nur Zeitraum). Entscheidung E1/E2 erfordert Erweiterung des Datenmodells | `app/Models/BlockedPeriod.php`, `ProcessPortalMail`, `SyncChannel` | → DATENMODELL-KONZEPT.md | +| D2 | **K** | Kein Angebot-/Annahme-Mechanismus, keine Dokumentation des Vertragsschlusses (Zeitpunkt, Inhalt, IP/Nachweis) | `BookingStatus`, `ConfirmBooking` | → BUCHUNGSPROZESS.md | +| D3 | **H** | Stornierung = reiner Statuswechsel im Admin (`ViewBooking`), ohne Stornokosten-Berechnung, Gast-Benachrichtigung, Rückerstattungsbuchung, Beleg | `ViewBooking.php` Z. ~112; `RecordPayment` erlaubt negative Beträge als Erstattung (nur Hinweis im Docblock) | → BUCHUNGSPROZESS.md | +| D4 | **H** | Stornobedingungen nur als optionaler Freitext (`stay.cancellation`, Default `null`), nicht maschinenlesbar | `config/content.php` | Staffel als Daten modellieren | +| D5 | **H** | iCal-`SUMMARY` wird in `blocked_periods.reason` übernommen („Portalname: Summary“). Falls ein Portal Namen im SUMMARY liefert, würden Gästenamen ungeplant gespeichert; keine Löschung | `app/Actions/SyncChannel.php` Z. ~67, `ICalParser` | Prüfen, was FeWo-direkt tatsächlich liefert (❓); ggf. SUMMARY nicht speichern | +| D6 | **H** | `portal_emails.excerpt` (500 Zeichen) kann Namen/Kontaktdaten enthalten; keine Frist, keine Anonymisierung | `ProcessPortalMail` | Löschfrist (z. B. kurz nach Verarbeitung) oder Felder gezielt extrahieren | +| D7 | **H** | Dublettenprüfung nur exakt über E-Mail (`firstOrNew` auf `email`, kleingeschrieben). Keine Zusammenführung, keine Mehrfach-Identitäten, keine Quelle/Importzeitpunkt am Gast | `CreateReservation` Z. ~52, `Guest` | → DATENMODELL-KONZEPT.md | +| D8 | **H** | Bei Anfrage über E-Mail-Adresse eines bestehenden Gastes werden dessen Stammdaten per `fill()` **überschrieben** (Adresse/Telefon) – fremde Person könnte mit bekannter E-Mail Daten verändern | `CreateReservation` | Stammdaten versionieren/Bestätigung vor Überschreiben | +| D9 | **M** | Kurtaxe/Kurabgabe nur als Textinfo; keine Daten (Personen, Alter, Befreiung), keine Meldung, keine Abführung | `PricesSection`, Mail-Views; `docs/PORTALE.md` | → BUCHUNGSPROZESS.md §Kurabgabe | +| D10 | **M** | feratel-Meldeschein-Anbindung nur als Plan (Schnittstelle für Software-Partner, Konditionen offen) | `docs/PORTALE.md` | Klärung mit Tourist-Information; ⚖ | +| D11 | **M** | Portalgebühren/Provisionen: nicht modelliert | – | Felder in Buchung/Finanzposten | +| D12 | **M** | Nachrichtenhistorie (ein-/ausgehend) wird nicht gespeichert; versendete System-Mails nur im Mail-Log/Postfach | `app/Mail/*` | Nachrichtenprotokoll ohne Volltext oder mit Frist | +| D13 | **M** | Quelle: `bookings.source` (string, z. B. `website`); `referral_source` ist Marketing-Herkunft. Keine externe Buchungsreferenz an `Booking`; `BlockedPeriod.external_uid` und `PortalEmail.reference` existieren | Migrationen | Bestehende Felder wiederverwenden | +| D14 | **M** | Art. 14 DSGVO (Portalgäste): Informationspflicht gegenüber Gästen, deren Daten aus Portalen kommen, ist nicht umgesetzt | – | Information im Erstkontakt/Vertragsmail; ⚖ Ausnahme Art. 14 (5) prüfen | +| D15 | **M** | Staging-Mailer `log`: Gästemails (Vertrag, Preis, Namen) im Logfile; Log-Level `debug` per Default | `docs/BETRIEB.md` | Nur Testdaten verwenden; Produktiv-Logging härten | + +## 3. Was bereits wiederverwendbar ist + +- `Guest` (Stammdaten, Anonymisierung, Marketing-Consent), `Booking` (Status, `quote`, Beträge, Zahlungstermine, `contract_path`), `Payment` (negative Beträge möglich), `PortalEmail` (Typ, Status, Referenz, Zeitraum), `Channel`/`ChannelTask`/`ChannelSyncLog`, Actions-Muster in `app/Actions`, Observer-Mechanik, signierte URLs, Rate-Limiter, Rollen-Policies, Pflicht-2FA für Admins. +- `PriceQuote`/`bookings.quote`: Preisaufschlüsselung als JSON → Basis für Angebots- und Rechnungsdarstellung. + +## 4. Quellenlage Portaldaten (nichts raten) + +| Quelle | Verfügbare Daten | Gästedaten | Status | +|---|---|---|---| +| iCal | Zeitraum, UID, SUMMARY (portalabhängig) | keine zugesichert | ✅ implementiert | +| Portal-E-Mail | Typ, Zeitraum, Referenz (heuristisch geparst); Mailtext enthält ggf. Gast-/Preisdaten | Nur nachweislich im Text vorhandene Daten; Parser extrahiert aktuell **nur** Typ/Zeitraum/Referenz | ✅ Code, ❓ reale Mails | +| Autorisierte API (Channel-Manager/Partner) | Gast, Preis, Gebühren, Nachrichten (je Anbieter) | ja (vertragsabhängig) | 🗓 nicht implementiert | + +Regel: Felder ohne belegte Quelle bleiben leer (`NULL`) mit Kennzeichnung `unbekannt`; keine Ableitung aus Nachnamen, Telefonnummern o. Ä. diff --git a/docs/GO-LIVE-CHECKLISTE.md b/docs/GO-LIVE-CHECKLISTE.md new file mode 100644 index 0000000..869b85a --- /dev/null +++ b/docs/GO-LIVE-CHECKLISTE.md @@ -0,0 +1,58 @@ +# GO-LIVE-CHECKLISTE – priorisierte Maßnahmen + +> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu). + +Stand: 22.10.2026 · Priorität: **P0** Blocker (ohne diese nicht produktiv) · **P1** unmittelbar nach Go-Live bzw. vor Portalintegration · **P2** Ausbau. Die Checkliste ist eine *Maßnahmenplanung*; Konformität ist **nicht** nachgewiesen. Umsetzung nur nach Freigabe. Verweise: [GAP-DELTA.md](GAP-DELTA.md), [DATENSCHUTZ-AUDIT.md](DATENSCHUTZ-AUDIT.md). + +## P0 – Blocker + +| ☐ | Maßnahme | Bezug | Wer | +|---|---|---|---| +| ☐ | Impressum und Datenschutzerklärung erstellen, juristisch prüfen, im Footer + Buchungsformular verlinken | G1, G2 | Rechtsberatung/Betreiberin | +| ☐ | AVV mit STRATO prüfen/abschließen; Verarbeitungsverzeichnis anlegen; DSB-Pflicht prüfen | Faktenbasis | Betreiberin/DSB | +| ☐ | Produktiv-`.env` härten: `APP_ENV=production`, `APP_DEBUG=false`, `MAIL_MAILER=smtp` (TLS), `LOG_CHANNEL=daily`, `LOG_LEVEL` ≥ warning, `SESSION_SECURE_COOKIE=true` | G8 | Technik | +| ☐ | Browser-Verifikation Staging: Netzwerk/Cookies/Storage; Ergebnis in DSE | G9 | Technik | +| ☐ | Backup-Verfahren festlegen, Restore testen, Aufbewahrung dokumentieren | G5 | Technik | +| ☐ | Fristen des Löschkonzepts bestätigen lassen (Steuerberatung/Recht) | LOESCHKONZEPT | Steuerberatung/Recht | +| ☐ | Stornobedingungen, AGB, Widerrufs-/Verbraucherhinweise rechtlich klären (§§ 312g, 312i, 312j, 312k BGB) | BUCHUNGSPROZESS §7 | Recht | +| ☐ | Entscheidung: Direktbuchung vorerst als „Anfrage → Bestätigung“ betreiben (ohne Angebot/Annahme-Funktion) **oder** Go-Live erst nach Umsetzung des Angebot-/Annahmeprozesses | D2 | Betreiberin | +| ☐ | Staging mit Testdaten betreiben (kein Echtdaten-Import); Mail-Log nur Testadressen | D15 | Technik | + +## P1 – Kurzfristig (Go-Live / vor Portal-Echtbetrieb) + +| ☐ | Maßnahme | Bezug | +|---|---|---| +| ☐ | Löschjobs: Anfragen ohne Vertrag, `portal_emails.excerpt`, UTM, privates Review-Feedback; `anonymize()` um `internal_notes`, Review-Anzeigename erweitern | G3, G4, D6 | +| ☐ | Tokens aus Query-Parametern in Header verlegen (`/health/sync`, `/automation/scheduler`) | G6 | +| ☐ | Security-Header (HSTS, CSP, X-Frame-Options, Referrer-Policy, Permissions-Policy) | G11 | +| ☐ | Pflicht-2FA auch für Rolle `rentals`; Audit-Log für Export/Anonymisierung/Statuswechsel | G14, G15 | +| ☐ | Throttle für Bewertungs-/Annahme-/Storno-Routen | G12 | +| ☐ | iCal-`SUMMARY` prüfen (Portal liefert Namen?) und ggf. nicht speichern | D5 | +| ☐ | Gästestammdaten bei bekannter E-Mail nicht stillschweigend überschreiben | D8 | +| ☐ | Prozess Betroffenenrechte (Auskunft/Löschung) dokumentieren, Frist 1 Monat | G13 | +| ☐ | Art. 14-Information für Portalgäste (erste Mail + DSE-Abschnitt) | D14 | +| ☐ | n8n/Privatserver: Standort, Betreiber, Datenumfang dokumentieren; keine Gästedaten in Webhooks | G7 | +| ☐ | Cron/Scheduler produktiv einrichten und überwachen | `docs/BETRIEB.md` | + +## P2 – Ausbau (Entscheidungen E1–E5) + +| ☐ | Maßnahme | Bezug | +|---|---|---| +| ☐ | Datenmodell: `documents`, `messages`, Gebühren/Kurtaxe, Quelle/Importzeitpunkt (additiv, ohne Migrationsausführung vor Freigabe) | DATENMODELL-KONZEPT | +| ☐ | Portalbuchungen als `Booking` führen (Importpfad Portal-Mail); Merge-Kandidaten + manuelle Zusammenführung | DATENMODELL §5 | +| ☐ | Angebot + Annahme (signierter Link), Annahmenachweis, Empfangsbestätigung | BUCHUNGSPROZESS §3 | +| ☐ | Stornoformular ohne Konto, Stornokosten-Policy als Daten, Erstattungs-Action | BUCHUNGSPROZESS §5 | +| ☐ | Kurabgabe/Gästemeldung: Klärung mit Tourist-Information/feratel; getrennte Tabellen mit eigener Löschfrist | BUCHUNGSPROZESS §6 | +| ☐ | Steuerliche Nachweise: Rechnungen/Belege, Hash, `retain_until`, Export für Steuerberater | LOESCHKONZEPT | +| ☐ | Channel-Manager/API-Connector (nur nach AVV-/Anbieterprüfung) | PORTALE.md | +| ☐ | KI-Agent: Anbieter/Region/Training-Opt-out, Pseudonymisierung, Freigabe bei Preis/Angebot/Absage, Audit-Log, DSFA-Prüfung | Audit §5 | + +## Entscheidungsbedarf (offen) + +1. Portalbuchungen als `Booking` (empfohlener Entwurf) – bestätigen? +2. Angebot/Annahme **vor** oder **nach** Go-Live? +3. Gästedaten-Frist: 3 Jahre + Beleg (Vorschlag) – bestätigen nach Rechtsprüfung. +4. Bestehende `Confirmed`-Buchungen: als „angenommen“ migrieren? +5. Soll Annahmenachweis IP/User-Agent speichern (⚖) oder nur Zeitpunkt + Versionshash? +6. Kurabgabe/Gästemeldung: selbst erfassen oder über feratel/Tourist-Information? +7. Freigabe zur Umsetzung der Punkte P0/P1 (Code, Migrationen, Deployments erst auf Zuruf). diff --git a/docs/KONZEPT.md b/docs/KONZEPT.md index 83f4311..340ddf2 100644 --- a/docs/KONZEPT.md +++ b/docs/KONZEPT.md @@ -112,6 +112,23 @@ ## 6. Workflows Zahlungseingang wird manuell im Admin abgehakt (später optional: Abgleich über Bank-CSV-Import). +### 6a. Buchungswege (Entscheidung Lars Stommer, 22.10.2026) + +**Weg 1 – über ein unverbindliches Angebot (jetzt umsetzen):** Der Gast fragt unverbindlich an → der Zeitraum wird vorgemerkt → die Vermieterin erstellt ein **Angebot** (heute manuell im Admin, später mit KI-Entwurf und menschlicher Freigabe) → das Angebot geht per **E-Mail** an den Gast → **nimmt der Gast das Angebot an** (signierter, befristeter Link ohne Gästekonto), ist die Buchung abgeschlossen → Bestätigung + Mietvertrag, Zahlungsfristen laufen. Läuft die Angebotsfrist ab oder lehnt der Gast ab, wird der Kalender wieder frei. + +**Weg 2 – verbindliche Direktbuchung (Zukunft):** Der Gast bucht direkt verbindlich, die Bestätigung geht sofort raus, Stornierungsfristen laufen an. Voraussetzung: sehr verlässliche, nahezu sofortige Synchronität mit den anderen Buchungssystemen mit Sofortbuchung (v. a. FeWo-direkt), damit keine Doppelbuchungen entstehen. Erst nach Lösung dieser Voraussetzung (z. B. Channel-Manager-API, siehe PORTALE.md). + +Rechtliche Ausgestaltung (Wortlaut des Annahme-Buttons, Informationspflichten, Storno-Regeln, AGB) wird fachkundig geprüft; Impressum und Datenschutzerklärung werden separat erstellt. + +### 6b. Weitere Festlegungen (22.10.2026) + +- **Kurabgabe** wird vor Ort durch den **Ferienservice Balu** erledigt – das System erhebt und meldet sie nicht. (Offen: ob Balu auch den Meldeschein übernimmt.) +- **Lösch- und Aufbewahrungsfristen** nach allgemeiner Rechtsauffassung festlegen (fachkundig bestätigen lassen); technisch als Einstellungen umsetzen (Vorschläge: docs/LOESCHKONZEPT.md). +- **Auftragsverarbeitung mit Strato:** Strato stellt dafür nach unserem Kenntnisstand einen Standardvertrag im Kundenbereich bereit – dort prüfen/abschließen. +- **Portalgäste** = Gäste, die über ein Buchungsportal (FeWo-direkt u. a.) buchen; ihre Daten erreichen uns nur über die Portal-Benachrichtigungen. Wir betreiben selbst kein Portal. +- **Verwaltung:** mehrere Verwalter-Konten (mindestens Lars und Brigitte Stommer); **einfache Ansicht** (Anfragen/Buchungen/Verträge, Sperrzeiten, Gäste, Portal-Aufgaben, Bewertungen) und **Expertenansicht** (alle Einstellungen), umschaltbar je Benutzer – umgesetzt. +- Die Dokumente BUCHUNGSPROZESS, DATENMODELL-KONZEPT, GAP-DELTA, GO-LIVE-CHECKLISTE, LOESCHKONZEPT und DATENSCHUTZ-* wurden von einem Analyse-Agenten erstellt; die dort genannten „verbindlichen Entscheidungen E1–E7“ sind **dessen Annahmen**. Maßgeblich sind die Festlegungen in diesem Dokument. + ## 7. Connector-/Plugin-System für Portale Portale wechseln → jedes Portal ist ein eigenständiger **Channel-Connector** hinter einer gemeinsamen Schnittstelle: diff --git a/docs/LOESCHKONZEPT.md b/docs/LOESCHKONZEPT.md new file mode 100644 index 0000000..b61a77a --- /dev/null +++ b/docs/LOESCHKONZEPT.md @@ -0,0 +1,69 @@ +# LOESCHKONZEPT – Datenkategorien und Fristen + +> **Hinweis (22.10.2026):** Von einem Analyse-Agenten erstellt. Die als „verbindlich“ bezeichneten Entscheidungen (E1–E7) sind Annahmen des Agenten, keine Festlegungen der Betreiber. Maßgeblich sind die Entscheidungen in [KONZEPT.md §6a/6b](KONZEPT.md) (u. a. Buchungsweg 1 über Angebot + Annahme, Weg 2 Direktbuchung später; Kurabgabe vor Ort durch Ferienservice Balu). + +Stand: 22.10.2026 · **Entwurf.** Alle Fristen sind **Vorschläge bzw. Prüfannahmen und rechtlich zu bestätigen** (Steuerberatung, Rechtsberatung, ggf. Datenschutzbeauftragte/r), sofern nicht „im Code belegt“. Kein Code geändert. + +## 1. Prinzipien + +1. **Trennung** operativer personenbezogener Daten (Gäste-Kommunikation, Marketing, Anfragen) von **archivierungspflichtigen Nachweisen** (Buchungs-/Zahlungsbelege, Verträge/Rechnungen). +2. Nach Ablauf des operativen Zwecks: Löschung bzw. Anonymisierung; Nachweise bleiben, werden aber auf das Nötige reduziert und nur noch zugriffsbeschränkt (Einschränkung der Verarbeitung, Art. 18 / Art. 17 (3) b). +3. Steuerliche Aufbewahrung geht der Löschung vor (Art. 17 (3) b DSGVO); Löschung erfolgt unverzüglich nach Fristende. +4. Jede Frist ist maschinell konfigurierbar (`config/fewo.php`) und im Verfahrensverzeichnis dokumentiert. + +## 2. Frist-Übersicht + +Fristbeginn, wo nicht anders genannt: Ende des Kalenderjahres, in dem das Ereignis eintrat (⚖ je Rechtsnorm bestätigen). Steuerliche Fristen laut AO (§ 147: Buchungsbelege und Handels-/Geschäftsbriefe mit unterschiedlicher Dauer; Änderungen durch das Bürokratieentlastungsgesetz IV ⚖ aktuell prüfen). + +| Datenkategorie | Tabelle/Ort | Typ | Vorschlag Frist | Mechanismus Ist | Mechanismus Soll | Status | +|---|---|---|---|---|---|---| +| Unverbindliche Anfrage ohne Folgebuchung | `guests`, `bookings` (Status `reserved`) | operativ | z. B. 3–6 Monate nach Ablauf/Ablehnung ⚖ (Zweck: Rückfragen, Abwehr Ansprüche) | Keine; erst 10-Jahre-Anonymisierung | Job `inquiries:purge` löscht Anfrage + ggf. verwaisten Gast | ❌ Lücke | +| Abgelaufene/abgelehnte Vorreservierung | `bookings` (`expired`/`declined`) | operativ | wie oben ⚖ | Statusjob (`bookings:expire-holds`), keine Löschung | wie oben | ❌ Lücke | +| Verbindliche Buchung – Stammdaten Gast | `guests`, `bookings` | operativ + Nachweis | Gastdaten operativ bis Ende der Gewährleistungs-/Verjährungsfrist (3 Jahre, ⚖ BGB § 195); danach Anonymisierung des Gastes, Buchung bleibt als Beleg | Anonymisierung nach `guest_retention_years` = 10 J. (im Code belegt, ✅ `AnonymizeGuests`) | Zweistufig: Gast nach 3 J. anonymisieren, Beleg bis Steuerfrist | ⚠ zu lang/gebündelt | +| Vertrags-/Rechnungsdokumente | `storage/app/private/contracts` | Nachweis | Steuerliche Aufbewahrung (Prüfannahme 6–10 Jahre, ⚖) | Nicht gelöscht, **nicht** anonymisiert | `documents.retain_until`, Job löscht Datei nach Fristende; Zugriff auf Rolle begrenzen | ❌ Lücke | +| Zahlungen und Belege | `payments` | Nachweis | steuerliche Frist ⚖ | Bleiben (keine Löschung) ✅ gewollt | `retain_until`; `note`/`recorded_by` minimieren | ⚠ | +| Portalnachrichten (E-Mail-Auszug) | `portal_emails.excerpt` | operativ | kurz, z. B. 30–90 Tage nach Verarbeitung ⚖; Referenz/Zeitraum bleiben | Keine | Job leert `excerpt`; Mail im IMAP-Postfach löschen | ❌ Lücke | +| Portal-E-Mails im Postfach | IMAP bei STRATO | operativ/Beleg | Mails mit Buchungsbeleg-Charakter ggf. Geschäftsbrief-Frist ⚖ | Mails werden nur gelesen (`leaveUnread`) | Ablage-/Löschregel im Postfach | ❓ | +| Iterative iCal-Sperren | `blocked_periods.reason` | operativ | Sperren bis Zeitraumende + Frist; `reason` ohne Personenbezug | Behalten | `reason` nicht speichern, wenn Namen enthalten (D5) | ❓ | +| Bewertungen | `reviews` | operativ/Veröffentlichung | Veröffentlichte Bewertung bis Widerruf der Einwilligung; privates Feedback kurz (z. B. 12 Monate) ⚖ | Nicht von `anonymize` erfasst | Bei Gast-Anonymisierung `display_name` neutralisieren, `private_feedback` löschen | ❌ Lücke | +| Marketing-Einwilligungen | `guests.marketing_consent_at` | Nachweis Einwilligung | Bis Widerruf, **Nachweis** der Einwilligung ggf. 3 J. über Widerruf hinaus ⚖ | Widerruf per Link setzt `NULL` (✅); Nachweis geht verloren | Nachweis-Log (Zeitpunkt, DOI-Bestätigung, ohne IP) separat | ⚠ | +| Gästekartei (Notizen, Tags) | `guests.notes/tags` | operativ | mit Gast-Anonymisierung | ✅ bei `anonymize()` | – | ✅ | +| `bookings.message` (Gastnachricht) | `bookings` | operativ | mit Gast-Anonymisierung | ✅ | früher möglich | ✅ | +| `bookings.internal_notes` | `bookings` | operativ | mit Gast-Anonymisierung | ❌ nicht erfasst | in `anonymize()` aufnehmen | ❌ Lücke | +| Herkunft/UTM | `bookings.utm_*`, `referral_source` | operativ (Statistik) | kurz (z. B. 12–24 Monate) oder aggregieren ⚖ | Behalten | Job nullt UTM nach Frist | ❌ Lücke | +| Kurabgabe-/Meldedaten | s. BUCHUNGSPROZESS.md §Kühlungsborn | gesetzlich | Meldeschein: kurz (⚖ BMG § 30: ca. 1 Jahr, danach Vernichtung); Kurabgabe-Nachweise nach Satzung/Steuerrecht ⚖ | nicht implementiert | getrennte Tabelle mit eigener Frist | 🗓 | +| Admin-Konten | `users` | operativ | bis Ausscheiden | manuell | Offboarding-Prozess | ⚠ | +| Sessions | `sessions` (IP, UA) | technisch | Lifetime 120 Min.; Tabellenbereinigung | Laravel-Lotterie-GC (✅ Standard) | täglicher Job + nur bei Bedarf Session starten | ⚠ | +| Rate-Limit-Schlüssel | `cache` (IP-Hash im Key) | technisch | 1 Stunde (✅ im Code `RateLimiter::hit(…, 3600)`) | Laufzeit | – | ✅ | +| Anwendungs-Logs | `storage/logs` | technisch | z. B. 14 Tage (`LOG_DAILY_DAYS` Default) | Default `single` ohne Rotation ❌ | `LOG_CHANNEL=daily` | ❌ Lücke | +| Webserver-Logs STRATO | Hosting | technisch | Anbieterabhängig | ❓ | Strato-Info/AVV | ❓ | +| Audit-Log (neu) | `audit_events` | Nachweis Sicherheit | z. B. 12 Monate ⚖ | existiert nicht | einführen | 🗓 | +| Fehlgeschlagene Jobs | `failed_jobs` | technisch | 30 Tage | Standard behalten | Job `queue:prune-failed` | ⚠ | +| Datenbank-Backups | Strato/eigen | technisch | z. B. 30 Tage rollierend ⚖ | ❓ nicht belegt | dokumentieren; Restore-Test; Löschung aus Backups via Frist | ❓ | + +## 3. Löschmechanik (Soll) + +- **Zeitgesteuerte Jobs** (Laravel-Scheduler, bereits genutzt: `guests:anonymize` monatlich) je Kategorie, mit Zähler-Log (ohne personenbezogene Inhalte). +- **Zwei Stufen** für Gäste: (1) operative Daten entfernen, (2) Beleg-Datensatz anonymisieren; Buchungsnummer, Beträge, Zeitraum, Steuerdaten bleiben. +- **Dokumente:** Datei und Datensatz am `retain_until` löschen; vorher Dokumentenhash prüfen/protokollieren. +- **Betroffenenrechte:** manuelle Aktion „Gast löschen/anonymisieren“ prüft steuerliche Sperre (offene Fristen) und führt Teil-Löschung durch; Rückmeldung innerhalb eines Monats (⚖ Art. 12). +- **Backups:** Löschung wirkt über Rotation; keine Wiederherstellung gelöschter Daten ohne erneute Löschung (Verfahrensvorgabe). + +## 4. Informationspflichten bei Datenherkunft (Art. 13/14) + +| Fall | Pflicht | Umsetzungsvorschlag | Status | +|---|---|---|---| +| Direkt erhoben (Formular) | Art. 13: Identität, Zwecke, Rechtsgrundlage, Empfänger, Dauer, Rechte, Beschwerde | Datenschutzerklärung verlinkt am Formular; Kurzinfo in Bestätigungsmail | ❌ DSE leer | +| Aus Portal übernommen (E-Mail/API) | Art. 14: Herkunft, Kategorien; Information binnen 1 Monat, spätestens beim ersten Kontakt | Hinweis in erster Gästemail + DSE-Abschnitt „Portalbuchungen“; ⚖ Ausnahme Art. 14 (5) a (Gast ist bereits durch Portal informiert) prüfen | ❌ offen | +| iCal ohne Gästedaten | keine Gästedaten → keine Pflicht | – | ✅ | +| Marketing (DOI) | Art. 13 + § 7 UWG | Hinweis im Opt-in; Widerruf in jeder Mail | ✅ teilweise | + +## 5. Offene Rechtsfragen (Löschkonzept) + +1. Konkrete steuerliche Fristen je Dokumentart und Fristbeginn (Steuerberatung). +2. Zulässige Dauer der Speicherung von Anfragen ohne Vertragsschluss. +3. Verjährungs-/Beweiszweck als Grundlage für 3-Jahres-Speicherung von Gästedaten. +4. Nachweis der Einwilligung nach Widerruf (Dauer). +5. Meldeschein-/Kurabgabe-Fristen (Satzung Ostseebad Kühlungsborn; BMG). +6. Ob Portal-E-Mails im Postfach als Handelsbriefe aufbewahrungspflichtig sind. +7. Backup-Retention-Dauer als zulässiges Maß. diff --git a/scripts/deploy.sh b/scripts/deploy.sh index bb5b773..27ef30f 100644 --- a/scripts/deploy.sh +++ b/scripts/deploy.sh @@ -207,7 +207,7 @@ build() { $COMPOSER_BIN install --no-dev --prefer-dist --optimize-autoloader --no-interaction --no-progress npm ci --no-audit --no-fund npm run build - rm -rf node_modules tests docs .gitea .github scripts storage .env.example .env.production.example .ai .claude .cursor AGENTS.md CLAUDE.md boost.json phpunit.xml + rm -rf node_modules tests docs styles .gitea .github scripts storage .env.example .env.production.example .ai .claude .cursor AGENTS.md CLAUDE.md boost.json phpunit.xml prune_vendor echo "$REVISION" > REVISION ) diff --git a/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_12-1.png b/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_12-1.png new file mode 100644 index 0000000..d1f7448 Binary files /dev/null and b/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_12-1.png differ diff --git a/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_50-2.png b/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_50-2.png new file mode 100644 index 0000000..adde991 Binary files /dev/null and b/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_50-2.png differ diff --git a/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_54-3.png b/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_54-3.png new file mode 100644 index 0000000..cc6a117 Binary files /dev/null and b/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_54-3.png differ diff --git a/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_56-4.png b/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_56-4.png new file mode 100644 index 0000000..028dd0e Binary files /dev/null and b/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_56-4.png differ diff --git a/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_58-5.png b/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_58-5.png new file mode 100644 index 0000000..341b781 Binary files /dev/null and b/styles/ChatGPT-Bild 22. Okt. 2026, 19_44_58-5.png differ diff --git a/styles/README.md b/styles/README.md new file mode 100644 index 0000000..ac1c80c --- /dev/null +++ b/styles/README.md @@ -0,0 +1,42 @@ +# Markenelemente FeWo Stommer + +Stand: 22.10.2026 + +## Inhalt + +| Ordner/Datei | Status | Verwendung | +|---|---|---| +| `ChatGPT-Bild …-1.png` … `-5.png` | **Original-Entwürfe** (KI-generiert, transparent) | Vorlage; nicht direkt auf der Webseite einsetzen (300–850 KB) | +| `*.svg` im Ordner `styles/` | automatisch nachgezeichnete Entwürfe | **nicht verwenden:** Löcher/Sprenkel in Flächen, treppige Kanten, Icons sind Ausschnitte mit Resten der Nachbarsymbole, 6–170 KB je Datei | +| `final/` | **saubere Fassungen zur Verwendung** | siehe unten | + +## `final/` – freigegebene Fassungen + +| Datei | Größe | Zweck | +|---|---|---| +| `mark.svg` | 1,4 KB | Bildmarke (Haus, Wellen, Sonne) – Kopfzeile, Fußzeile, Ladeanzeigen | +| `logo.svg` | 2,3 KB | Bildmarke + Schriftzug „FeWo Stommer“ + Unterzeile. Der Schriftzug ist SVG-Text mit fester Breite (Schrift: Cormorant Garamond, sonst Georgia); auf der Webseite besser Bildmarke + HTML-Text in der Theme-Schrift | +| `logo-600.png` | 87 KB | Logo für E-Mails und das Vertrags-PDF (Mail-Programme zeigen SVG nicht zuverlässig) | +| `favicon.svg` | 0,8 KB | Browser-Tab; im Dunkelmodus des Browsers mit hellem Dach | +| `apple-touch-icon.png` | 11 KB | Symbol beim „Zum Home-Bildschirm“ (180 × 180) | +| `icon-apartment.svg`, `icon-sea.svg`, `icon-terrace.svg`, `icon-location.svg` | je ≈ 1 KB | Symbole für Eckdaten, Ausstattung, Lage | +| `wave-divider.svg` | 1,6 KB | Trenner zwischen Abschnitten, Abschluss des Titelbereichs (skaliert auf volle Breite) | +| `coastal-illustration-1200.webp` | 85 KB | Illustration „Haus in den Dünen“ – Platzhalter ohne Foto, Fehlerseite, Design-Akzent | + +## Farben + +| Variable | Standard | Bedeutung | +|---|---|---| +| `--brand-navy` | `#0B2E55` | Dach, Schrift, Symbole | +| `--brand-teal` | `#0286A2` | Welle (kräftig) | +| `--brand-wave` | `#6DBFC2` | Welle (hell) | +| `--brand-sun` | `#F2C27A` | Sonne, Spiegelung, Zierlinien | + +Alle SVGs nutzen diese Variablen mit Standardwert. Als `` eingebunden zeigen sie die Markenfarben. **Inline** in einer Blade-Vorlage eingebunden übernehmen sie Werte, die ein Theme oder Erscheinungsbild setzt, z. B. `--brand-navy: var(--ink)`. So bleibt das Logo im dunklen Silvester-Erscheinungsbild sichtbar. + +## Regeln + +- Keine Verzerrung, keine Schatten oder Effekte; Mindestbreite der Bildmarke 24 px, des Logos mit Schriftzug 160 px. +- Schutzraum rund um das Logo: mindestens die Höhe des Dachfensters. +- Das Logo ist KI-generiert. Vor einer Anmeldung als Marke die Rechtslage fachkundig prüfen lassen. +- Einbau in die Webseite: Logo und Favicon gehören zur **Website** (Admin › Websites), nicht zu einem Theme. Wellenband, Symbole und Illustration gehören ins Theme (siehe `docs/THEME-ERSTELLUNG.md`). diff --git a/styles/coastal-illustration.svg b/styles/coastal-illustration.svg new file mode 100644 index 0000000..ccc40b5 --- /dev/null +++ b/styles/coastal-illustration.svg @@ -0,0 +1,18 @@ +coastal-illustration + + + + + + + + + + + + + + + + + diff --git a/styles/favicon.svg b/styles/favicon.svg new file mode 100644 index 0000000..00f231c --- /dev/null +++ b/styles/favicon.svg @@ -0,0 +1,7 @@ +favicon + + + + + + diff --git a/styles/final/apple-touch-icon.png b/styles/final/apple-touch-icon.png new file mode 100644 index 0000000..cbf73d0 Binary files /dev/null and b/styles/final/apple-touch-icon.png differ diff --git a/styles/final/coastal-illustration-1200.webp b/styles/final/coastal-illustration-1200.webp new file mode 100644 index 0000000..64a9951 Binary files /dev/null and b/styles/final/coastal-illustration-1200.webp differ diff --git a/styles/final/favicon.svg b/styles/final/favicon.svg new file mode 100644 index 0000000..71cf564 --- /dev/null +++ b/styles/final/favicon.svg @@ -0,0 +1,8 @@ + + + + + + + + diff --git a/styles/final/icon-apartment.svg b/styles/final/icon-apartment.svg new file mode 100644 index 0000000..7bb50f8 --- /dev/null +++ b/styles/final/icon-apartment.svg @@ -0,0 +1,9 @@ + + Ferienwohnung + + + + + + + diff --git a/styles/final/icon-location.svg b/styles/final/icon-location.svg new file mode 100644 index 0000000..c6a1522 --- /dev/null +++ b/styles/final/icon-location.svg @@ -0,0 +1,10 @@ + + Lage + + + + + + + + diff --git a/styles/final/icon-sea.svg b/styles/final/icon-sea.svg new file mode 100644 index 0000000..2ab8794 --- /dev/null +++ b/styles/final/icon-sea.svg @@ -0,0 +1,5 @@ + + Ostsee + + + diff --git a/styles/final/icon-terrace.svg b/styles/final/icon-terrace.svg new file mode 100644 index 0000000..4e6125f --- /dev/null +++ b/styles/final/icon-terrace.svg @@ -0,0 +1,11 @@ + + Terrasse und Strand + + + + + + + + + diff --git a/styles/final/logo-600.png b/styles/final/logo-600.png new file mode 100644 index 0000000..5c33d1e Binary files /dev/null and b/styles/final/logo-600.png differ diff --git a/styles/final/logo.svg b/styles/final/logo.svg new file mode 100644 index 0000000..9cc1a77 --- /dev/null +++ b/styles/final/logo.svg @@ -0,0 +1,20 @@ + + FeWo Stommer – Ferienwohnung in Kühlungsborn + + + + + + + + + + + + + + FeWo Stommer + + + FERIENWOHNUNG IN KÜHLUNGSBORN + diff --git a/styles/final/mark.svg b/styles/final/mark.svg new file mode 100644 index 0000000..a9dca48 --- /dev/null +++ b/styles/final/mark.svg @@ -0,0 +1,14 @@ + + FeWo Stommer + + + + + + + + + + + + diff --git a/styles/final/wave-divider.svg b/styles/final/wave-divider.svg new file mode 100644 index 0000000..15db63d --- /dev/null +++ b/styles/final/wave-divider.svg @@ -0,0 +1,9 @@ + diff --git a/styles/icon-apartment.svg b/styles/icon-apartment.svg new file mode 100644 index 0000000..237fe66 --- /dev/null +++ b/styles/icon-apartment.svg @@ -0,0 +1,7 @@ +icon-apartment + + + + + + diff --git a/styles/icon-location.svg b/styles/icon-location.svg new file mode 100644 index 0000000..822c7e8 --- /dev/null +++ b/styles/icon-location.svg @@ -0,0 +1,7 @@ +icon-location + + + + + + diff --git a/styles/icon-sea.svg b/styles/icon-sea.svg new file mode 100644 index 0000000..4742b26 --- /dev/null +++ b/styles/icon-sea.svg @@ -0,0 +1,6 @@ +icon-sea + + + + + diff --git a/styles/icon-set.svg b/styles/icon-set.svg new file mode 100644 index 0000000..85fef15 --- /dev/null +++ b/styles/icon-set.svg @@ -0,0 +1,9 @@ +icon-set + + + + + + + + diff --git a/styles/icon-terrace.svg b/styles/icon-terrace.svg new file mode 100644 index 0000000..99f651b --- /dev/null +++ b/styles/icon-terrace.svg @@ -0,0 +1,9 @@ +icon-terrace + + + + + + + + diff --git a/styles/logo-illustrated.svg b/styles/logo-illustrated.svg new file mode 100644 index 0000000..5f5d7b2 --- /dev/null +++ b/styles/logo-illustrated.svg @@ -0,0 +1,17 @@ +logo-illustrated + + + + + + + + + + + + + + + + diff --git a/styles/logo.svg b/styles/logo.svg new file mode 100644 index 0000000..cda2494 --- /dev/null +++ b/styles/logo.svg @@ -0,0 +1,11 @@ +logo + + + + + + + + + +FERIENWOHNUNG IN KÜHLUNGSBORN diff --git a/styles/wave-divider.svg b/styles/wave-divider.svg new file mode 100644 index 0000000..bf30f40 --- /dev/null +++ b/styles/wave-divider.svg @@ -0,0 +1,10 @@ +wave-divider + + + + + + + + + diff --git a/tests/Feature/AdminModeTest.php b/tests/Feature/AdminModeTest.php new file mode 100644 index 0000000..8247e86 --- /dev/null +++ b/tests/Feature/AdminModeTest.php @@ -0,0 +1,112 @@ +role(UserRole::Rentals)->create(); + $this->actingAs($user); + + $this->assertSame(AdminMode::Simple, $user->adminMode()); + $this->get(Dashboard::getUrl()) + ->assertOk() + ->assertSee('Anfragen & Buchungen', false) + ->assertSee('Sperrzeiten') + ->assertSee('Portal-Aufgaben') + ->assertDontSee('Wohnungen') + ->assertDontSee('Portal-E-Mails') + ->assertSee('Zur Expertenansicht wechseln'); + } + + public function test_expert_mode_shows_everything_the_role_allows(): void + { + $this->actingAs(User::factory()->role(UserRole::Rentals)->create(['admin_mode' => AdminMode::Expert])); + + $this->get(Dashboard::getUrl()) + ->assertOk() + ->assertSee('Wohnungen') + ->assertSee('Portal-E-Mails') + ->assertSee('Zur einfachen Ansicht wechseln'); + } + + public function test_every_admin_resource_and_page_follows_the_admin_mode(): void + { + $panel = Filament::getPanel('admin'); + $classes = [...$panel->getResources(), ...array_filter($panel->getPages(), fn (string $page): bool => $page !== Dashboard::class)]; + + foreach ($classes as $class) { + $this->assertContains(FollowsAdminMode::class, class_uses_recursive($class), "{$class} must use FollowsAdminMode"); + } + } + + public function test_administrators_default_to_the_expert_mode(): void + { + $this->assertSame(AdminMode::Expert, User::factory()->create()->adminMode()); + } + + public function test_simple_mode_only_changes_the_menu_not_the_rights(): void + { + $this->actingAs(User::factory()->role(UserRole::Rentals)->create()); + + $this->get(PropertyResource::getUrl('index'))->assertOk(); + $this->get(UserResource::getUrl('index'))->assertForbidden(); + } + + public function test_user_menu_switches_the_mode(): void + { + $user = User::factory()->role(UserRole::Rentals)->create(); + $this->actingAs($user); + + Filament::setCurrentPanel('admin'); + Livewire::test(Topbar::class)->callAction('switchAdminMode'); + + $this->assertSame(AdminMode::Expert, $user->fresh()->adminMode()); + } + + public function test_blocked_periods_can_be_managed_in_their_own_list(): void + { + $property = Property::factory()->create(); + $this->actingAs(User::factory()->role(UserRole::Rentals)->create()); + + $this->get(BlockedPeriodResource::getUrl('index'))->assertOk(); + Livewire::test(ManageBlockedPeriods::class) + ->callAction(CreateAction::class, ['property_id' => $property->id, 'starts_on' => '2026-12-01', 'ends_on' => '2026-12-05', 'reason' => 'Eigennutzung']) + ->assertHasNoFormErrors(); + + $this->assertSame(['manual', 'Eigennutzung'], [BlockedPeriod::sole()->source, BlockedPeriod::sole()->reason]); + } + + public function test_administrator_can_reset_the_two_factor_login_of_another_user(): void + { + $mother = User::factory()->role(UserRole::Rentals)->create(); + $this->actingAs(User::factory()->create()); + + Livewire::test(ListUsers::class)->callAction(TestAction::make('resetTwoFactor')->table($mother)); + + $this->assertNull($mother->fresh()->getAppAuthenticationSecret()); + } +}