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

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

  • 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: 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

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