Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/D-BOOK.md
T

54 lines
4.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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: