Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VA-P28f.md
T

142 lines
7.6 KiB
Markdown

# 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.