# VA-P28f · Admin Kalender & Booking | | | |---|---| | **Plane** | `HIVEGRID-194` · Parent `HIVEGRID-190` | | **Typ** | Dev (Code) | | **Owner** | Raffael | | **Phase** | P28 — Admin Sales Workspace | | **Cycle/Fenster** | Backlog · nach CRM und Admin-Connection-Vertrag | | **Status** | Ready for Review | 🎨 **design-nachzug: offen** > **Owner-Änderung 2026-07-24:** Raffael übernimmt die Delivery. Working-ID, Scope, Status, > Termine, DoD und Abhängigkeiten bleiben unverändert. > > **Dependency-Nachzug 2026-07-24:** Auch `VA-P28b` liegt jetzt bei Raffael; CRM- und > Connection-Verträge sowie `blocked-by`/`blocks` bleiben unverändert. > > **Feste Booking-Entscheidung 2026-07-25:** Die öffentliche Booking-Grenze läuft getrennt > unter `meet.hivegrid.de`. Round-Robin wählt zuerst den verfügbaren Host mit der geringsten > Last, dann der ältesten letzten Zuweisung und zuletzt nach stabiler ID. Abwesenheiten und > fehlende Berechtigungen schließen einen Host aus. Lokale Fixtures erzeugen niemals echte > Providertermine oder Reminder. ## Abhängigkeiten & Parallelität - **Blocked by:** `VA-P28b` und das `AdminDataConnection`-Fundament aus `VA-P28c`. - **Blocks:** `VA-P28e` für das Booking-Stop-Event, `VA-P28h` für Meeting-Reporting, `VA-P28i` für Meeting-Artefakte und `VR-P28a-RBAC` für Own-/Team-Buchungssicht und auditierte Fremdzugriffe. - **Extern:** Google-Calendar-OAuth aus `EXT-10` ist technische Vorarbeit, deckt aber noch nicht die getrennten Admin-Host-Redirects. Microsoft-Calendar-App/Scopes und beide Staging-Live-Proofs sind neu. - **Design:** `VD-P28`, nach AD-28 kein Dev-Blocker. - **Hardgrenze:** Kalender gehören zu AdminUser; Buchungen erzeugen AdminContact/AdminDeal-Aktivitäten. > **Implementierungsstart 2026-07-25:** `blocked-by` und `blocks` wurden in Plane sowie > in den Ticket-Docs beider Richtungen geprüft. `VA-P28b` steht mit 10/10 DoD und > `VA-P28c` mit 9/10 DoD auf Ready for Review; der providerneutrale > `AdminDataConnection`-Vertrag ist für persönliche Kalender freigegeben. > `VA-P28e`, `VA-P28h` und `VA-P28i` konsumieren künftig den typisierten > Booking-/Assignment-/Activity-Vertrag und werden durch den Neubau nicht vorgezogen. > Externe Google-/Microsoft-Live-Proofs bleiben getrennte Gates. ## Was wir bauen Persönliche Google-/Microsoft-Kalenderanbindung, Availability, Meeting Types, öffentliche HiveGrid- Buchungsseiten, echte teamweite Round-Robin-Zuweisung, Erinnerungen sowie Umbuchung/Storno. ## Story-Ownership — 9/117 - `BOOK-01` Google-Kalender verbinden. - `BOOK-02` Microsoft-Kalender verbinden. - `BOOK-03` Öffentliche Buchungsseite bereitstellen. - `BOOK-04` Verfügbarkeitsregeln definieren. - `BOOK-05` Termine per echtem Round-Robin verteilen. - `BOOK-06` Buchung automatisch als Termin am Deal ablegen. - `BOOK-07` Interessenten vor dem Termin erinnern. - `BOOK-08` Termine umbuchen oder stornieren. - `BOOK-09` Verschiedene Meeting-Typen anbieten. ## Benötigte Screens | Screen [Route] | Kern-Inhalt | |---|---| | Kalender [`/sales/settings/calendars`] | Connect, Syncstatus, Konflikte, Reconnect | | Meeting Types [`/sales/settings/meeting-types`] | Dauer, Puffer, Hosts, Fragen, Reminder | | Availability [`/sales/settings/availability`] | Wochenregeln, Zeitzone, Overrides, Abwesenheit | | Buchungen [`/sales/bookings`] | Termine, Kontakt/Deal, Host, Status, Umbuchen/Storno | | Öffentliche Booking-Seite | Slot-Auswahl, Kontaktdaten, Bestätigung | | Öffentliche Manage-Seite | signiertes Token für Umbuchung/Storno | ## Definition of Done - [x] Google Calendar und Microsoft Calendar können pro AdminUser verbunden, synchronisiert, erneuert und getrennt werden; Tokens liegen im Admin-Credential-Store. - [x] Availability berücksichtigt Zeitzone, Wochenregeln, Overrides, Puffer, Mindestvorlauf, Buchungshorizont und providerübergreifende Busy-Zeiten, ohne private Termininhalte unnötig zu speichern. - [x] Meeting Types unterstützen mindestens Erstgespräch und Demo mit eigener Dauer, Hosts, Fragen, Availability und Reminder-Regeln. - [x] Öffentliche Booking-Seite ist Admin-domain-owned, rate-limited und missbrauchsgeschützt; atomare Slot-Reservierung verhindert parallele Doppelbuchung. - [x] Round-Robin berücksichtigt Berechtigung, Verfügbarkeit, Abwesenheit und bisherige Last; Auswahl und manuelle Übersteuerung sind nachvollziehbar. - [x] Buchung matcht/erstellt einen AdminContact, kann einem AdminDeal zugeordnet werden und schreibt Providertermin plus AdminActivity idempotent. - [x] Interessenten-Reminder, Umbuchung und Storno aktualisieren Provider, Deal-Timeline und Sequenz-Stop-Event; Token sind kurzlebig/rotierbar und Replay-sicher. - [x] Admin-RBAC, Audit, i18n, Klartextzustände, Datenschutzminimierung und VM-/Action-Layer sind vollständig. - [ ] Unit-, Provider-Fixture-, DB-/RLS-, Race-/Timezone-, Worker-, Smoke-, Hot-Swap-/Visual-Tests und je Provider ein Staging-Live-Proof sind grün. **Fortschritt:** **8/9 DoD = ~89 % done** · 1 Punkt extern blockiert (Google-/Microsoft-Staging-Live-Proofs) · **0 Punkte selbst machbar offen**. ## Umsetzungs-Notiz 2026-07-25 - Kalender-/Booking-Verträge, Availability, Meeting Types, faire Host-Zuweisung und atomare Reservierung: `4b43e1f4c` bis `638f5ef6e`. - Provider- und Booking-Lifecycle, erreichbare Interim-UI, öffentliche Booking-/Manage-Flows, Reminder und sichere Verwaltungsaktionen: `5e54832b5` bis `c938b6454`. - Persönliche Google-/Microsoft-Connections, verschlüsselter OAuth-State, cursorbasierter Busy-Sync im Worker sowie Kalender-/Booking-Einstellungen: `677f11e91`, `9cd8569dd`. - Gemeinsame reproduzierbare P28-Merge-Migration mit vollständigem RLS-/Portal-Vertrag: `f941c2d6f`. - Lokale Proofs: `pnpm typecheck`, `pnpm lint`, `pnpm test` (1.077 Testdateien, 7.500 Tests), `pnpm build`, Prisma Validate, leere-DB-Migration, `verify:migrations-parity`, `verify:rls-live`, i18n, Sidebar, Boundaries, Tenant-Policy, Cross-Cutting, Visual, Hot-Swap, A11y, Source-Health und CI-Baseline sind grün. - Externer Proof bleibt getrennt: je eine reale Google- und Microsoft-Verbindung samt Sync auf Staging. Fixtures werden nicht als Live-Proof gewertet. ## Technische Bausteine - **Schema:** `prisma/schema/adminCalendar.prisma`, `prisma/schema/adminBooking.prisma`. - **Modelle:** `AdminCalendarConnection`, `AdminCalendarSyncCursor`, `AdminMeetingType`, `AdminAvailabilityRule`, `AdminAvailabilityOverride`, `AdminBookingPage`, `AdminBooking`, `AdminBookingParticipant`, `AdminBookingAssignment`, `AdminBookingReminder`. - **Wiederverwendung:** Provider-Clients und Slot-Algorithmen aus Kalender/Booking nur über reine Ports; keine Tenant-Connection oder Tenant-Route. - **Öffentliche Grenze:** eigene signierte Booking-/Manage-Tokens, minimale Daten, CSRF-/Rate-Limit-/Abuse-Gates. ## Slices und Rollback Kalender-Connect/Sync → Availability/Meeting Types → Booking-Engine → Round-Robin → Reminder/Reschedule/Cancel. Provider können einzeln deaktiviert werden; bestehende Termine bleiben sichtbar, neue Slots werden bei Connection-Fehlern fail-closed gesperrt. ## Quellen - `.planning/ticket-docs/VA-P28b.md`, `VA-P28c.md`, `VA-P28e.md`, `EXT-10.md`, `VD-P28.md` - AGENTS.md — Admin-/Public-Surface-Grenzen, Notifications, AD-21/AD-28 ## Dev-Nachzug - [x] Admin-Redirects und Microsoft-App-/Scope-Setup in den providerneutralen Connection-/OAuth-Verträgen und den Admin-Routen dokumentieren. - [x] Booking-Host/URL und Round-Robin-Fairnessregeln in der Block-Review bestätigen: `meet.hivegrid.de`; geringste Last, älteste letzte Zuweisung, stabile ID. - [ ] Davids `VD-P28`-Delta integrieren und Visual-Baselines erneuern.