Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,53 @@
# D-BOOK · Booking-Page (Public, Polish) + Kalender-View
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P16 — Kalender, Booking, Forms & Signatur (bedient `AK-P16a`–`AK-P16d`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-07-02 → fällig 2026-07-03 |
| **Status** | geplant |
> 🟦 **Bespoke-Abgrenzung:** Dieses Ticket deckt **NUR die öffentliche Booking-Page + die Kalender-View** (inkl. Kalender-Connection-Card). Der **Form-Builder + das öffentliche Formular** (P16) → **`D-FORM`**. Die übrigen P16-Screens (Buchungen-Liste/-Detail, Booking-Page-Editor, Booking-Pages-Liste, Verfügbarkeit, Submissions, Signatur-Wizard) sind Compose aus A2/A3/A6 → P16-Compose-Anteil (Signatur-Wizard → `D-REST`).
> 🟡 **v1-Schnitte:** Kalender-Sync nur **Google** (Outlook → v2, Interface bleibt provider-agnostisch); Booking nur **eine** Zuteilung „Erster der frei ist" (Round-Robin/Provider-Wahl → v2).
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, A6 Connection-Card, Tokens)
- **Blockt:** `D-POLISH` (die öffentliche Booking-Page bekommt in W4 die finale Politur)
- **Bedient (Dev):** `AK-P16a`–`AK-P16d` (M25 Kalender-Sync + M06 Booking)
- **Subframe:** Pflicht je Route. Booking-Page ist **BESPOKE-Public (höchster Polish)**; Kalender ist BESPOKE (mittel); Connection-Card aus A6.
## Was wir bauen
**Nur die öffentliche Booking-Page** (Calendly-Style Slot-Picker, .ics, Tenant-Branding, iFrame-Embed — höchster Polish) und die **Kalender-View** (Monats-/Wochen-Grid mit Quell-Markern) inkl. Kalender-Verbindungs-Cards.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| 🌐 Booking-Page [`/b/{tenant}/{slug}`] | Multi-Step: Slot-Picker (Kalender-Grid freie Slots, timezone-aware + Wechsler) → Intake-Form (M05) → Bestätigung + Add-to-Calendar (.ics) · Tenant-Logo · iFrame-Embed-Variante · 4 Zustände | BESPOKE-Public (höchster Polish) |
| Kalender [`/calendar`] | Monats-/Wochen-Grid mit Terminen aus Google-Sync + HiveGrid-Quellen (Booking, Plantafel, Projekt-Termine) · Quell-Marker je Termin · Konflikt-Log | BESPOKE (mittel) |
| Kalender-Verbindungen [`/settings/integrations/calendar`] | Google-Connect-Card (Status-Ampel, verbundenes Konto-Email, letzte Sync), Kalender-Auswahl, Sync-Richtung, Disconnect mit „auch extern entfernen?"-Wahl · Re-Connect-Banner bei Fehler | A6 |
| Kalender-Verbindungs-Detail [`/settings/integrations/calendar/:id`] | gewählte Kalender, Sync-Status, Konflikt-Liste (letzte 50, Klartext + Resolution) | A6 + A2 |
*(Form-Builder + öffentliches Formular → `D-FORM`. Buchungen-Liste/-Detail, Booking-Page-Editor, Booking-Pages-Liste, Verfügbarkeit, Submissions = P16-Compose. Signatur-Wizard → `D-REST`.)*
## Features (muss abgedeckt sein)
- [ ] Öffentliche Booking-Page berechnet Slots timezone-aware (Verfügbarkeitsregeln, Ausnahmen, Kalender-Sync, Puffer, Vorlauf); nach Buchung: Lead **oder** Activity (Email-Match), FormSubmission, Bestätigungs-Email; iFrame-Embed; Race-Schutz beim Submit; Add-to-Calendar (.ics)
- [ ] Booking nur eine Zuteilungs-Strategie „Erster der frei ist"
- [ ] Kalender synchronisiert bidirektional mit Google (Auto-Token-Refresh, Webhook-Subscriptions); HiveGrid-Termine gehen extern, externe Events read-only für Verfügbarkeit
- [ ] Connection pro User; externe Event-Inhalte nie an andere User leaken (Booking sieht nur „belegt von X bis Y"); Last-Write-Wins-Konflikt mit Klartext-Notification
- [ ] Höchster Polish auf der Public-Booking-Page (4 Zustände, Tenant-Branding)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Kalender-Grid (Monat/Woche, Quell-farbige Termine); Connection-Card mit Status-Ampel + letzter-Sync-Zeit; Sync-Richtungs-Selector; Konflikt-Log-Liste mit Klartext + Resolution; Slot-Picker (Kalender mit freien/belegten Tagen + Zeitslot-Liste); Timezone-Wechsler; Multi-Step-Flow (öffentlich); Add-to-Calendar-Button (.ics); Tenant-Logo/Branding; iFrame-Embed-Variante; Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext mit Lösungs-Knopf).
## Quellen (granular)
- `designer-briefs/P16-kalender-booking-forms-signatur.md` → §Benötigte Screens „Booking-Page" + „Kalender" + „Kalender-Verbindungen/-Detail" (NUR diese) + zugehörige Features/UI-Elemente
- `ENTITY-MODEL.md` → Domäne 9 (Kalender/Booking)
- `SCREEN-MAP.md` → §5 Booking/Kalender · `ROADMAP.md` → Phase 16 · `_bmad-output/specs/M25-calendar-sync.md`, `M06-booking.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev: