7.6 KiB
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-P28bliegt jetzt bei Raffael; CRM- und Connection-Verträge sowieblocked-by/blocksbleiben 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-P28bund dasAdminDataConnection-Fundament ausVA-P28c. - Blocks:
VA-P28efür das Booking-Stop-Event,VA-P28hfür Meeting-Reporting,VA-P28ifür Meeting-Artefakte undVR-P28a-RBACfür Own-/Team-Buchungssicht und auditierte Fremdzugriffe. - Extern: Google-Calendar-OAuth aus
EXT-10ist 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-byundblockswurden in Plane sowie in den Ticket-Docs beider Richtungen geprüft.VA-P28bsteht mit 10/10 DoD undVA-P28cmit 9/10 DoD auf Ready for Review; der providerneutraleAdminDataConnection-Vertrag ist für persönliche Kalender freigegeben.VA-P28e,VA-P28hundVA-P28ikonsumieren 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-01Google-Kalender verbinden.BOOK-02Microsoft-Kalender verbinden.BOOK-03Öffentliche Buchungsseite bereitstellen.BOOK-04Verfügbarkeitsregeln definieren.BOOK-05Termine per echtem Round-Robin verteilen.BOOK-06Buchung automatisch als Termin am Deal ablegen.BOOK-07Interessenten vor dem Termin erinnern.BOOK-08Termine umbuchen oder stornieren.BOOK-09Verschiedene 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
- Google Calendar und Microsoft Calendar können pro AdminUser verbunden, synchronisiert, erneuert und getrennt werden; Tokens liegen im Admin-Credential-Store.
- Availability berücksichtigt Zeitzone, Wochenregeln, Overrides, Puffer, Mindestvorlauf, Buchungshorizont und providerübergreifende Busy-Zeiten, ohne private Termininhalte unnötig zu speichern.
- Meeting Types unterstützen mindestens Erstgespräch und Demo mit eigener Dauer, Hosts, Fragen, Availability und Reminder-Regeln.
- Öffentliche Booking-Seite ist Admin-domain-owned, rate-limited und missbrauchsgeschützt; atomare Slot-Reservierung verhindert parallele Doppelbuchung.
- Round-Robin berücksichtigt Berechtigung, Verfügbarkeit, Abwesenheit und bisherige Last; Auswahl und manuelle Übersteuerung sind nachvollziehbar.
- Buchung matcht/erstellt einen AdminContact, kann einem AdminDeal zugeordnet werden und schreibt Providertermin plus AdminActivity idempotent.
- Interessenten-Reminder, Umbuchung und Storno aktualisieren Provider, Deal-Timeline und Sequenz-Stop-Event; Token sind kurzlebig/rotierbar und Replay-sicher.
- 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:
4b43e1f4cbis638f5ef6e. - Provider- und Booking-Lifecycle, erreichbare Interim-UI, öffentliche Booking-/Manage-Flows,
Reminder und sichere Verwaltungsaktionen:
5e54832b5bisc938b6454. - 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
- Admin-Redirects und Microsoft-App-/Scope-Setup in den providerneutralen Connection-/OAuth-Verträgen und den Admin-Routen dokumentieren.
- 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.