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,62 @@
# D-P16 · Screens P16 — Kalender, Booking, Forms & Signatur (ohne Form-Builder & Booking-Page)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P16 — Kalender/Booking/Forms/Signatur (bedient `AK-P16a`–`AK-P16d`) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-03 → 2026-07-07 · Gate W4 |
| **Status** | geplant (NEU — schließt P16-Screen-Lücke außerhalb Form-Builder & Booking-Page) |
> **Ergänzt die Bespoke-Tickets `D-FORM` (Form-Builder-Canvas + öffentliches Formular) und `D-BOOK` (Booking-Page öffentlich + Kalender-View).** **Dieses Ticket deckt die übrigen P16-Screens**: Kalender-Verbindungen/Sync, Buchungen-Verwaltung (Liste/Detail/Page-Editor/Verfügbarkeit), Forms-Liste/Submissions und den Angebots-/Signatur-Wizard. Der Form-Builder-Canvas, das öffentliche Formular, die öffentliche Booking-Page und die Kalender-Grid-View sind **NICHT** Teil von D-P16 (→ D-FORM / D-BOOK).
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail, A4 Form, A5 Modal/Wizard, A6 Settings/Connection, A7 Zustände), `D-P5` (Connection-Card-Stil), `D-P4` (Task-Komponente — hier eingebettet, nicht neu)
- **Bedient (Dev):** `AK-P16a` (Kalender-Sync Google), `AK-P16b` (Booking Slots/Verfügbarkeit/Storno), `AK-P16c` (Form-Builder Editor/Submission/Actions), `AK-P16d` (Angebot/Signatur PandaDoc)
- **Parallel/Geschwister:** `D-FORM` (Form-Builder-Canvas + öffentliches Formular) und `D-BOOK` (Booking-Page öffentlich + Kalender-View) — D-P16 liefert die Verwaltungs-/Settings-/Submissions-/Signatur-Flächen
- **Subframe:** Pflicht je Route (A6 Connection/Settings, A2/A3 Listen/Detail, A4 Page-Editor, A5 Signatur-Wizard, A7 Zustände)
## Was wir bauen
Die **Verwaltungs- und Workflow-Flächen von P16** (ohne die öffentlichen Bespoke-Seiten und den Form-Builder-Canvas): Kalender-Verbindungen + Sync-Settings, Buchungen-Liste/-Detail/-Page-Editor + Verfügbarkeit, Forms-Liste + Submissions-Ansicht und den Multi-Signer-Angebots-/Signatur-Wizard.
> 🟡 **v1-Schnitte (verbindlich):** Kalender-Sync nur **Google** (Outlook → v2, Interface bleibt agnostisch); Booking nur **eine** Zuteilungs-Strategie „Erster der frei ist" (Round-Robin/Provider-Wahl → v2); Signatur über **PandaDoc**. **Pivot:** Signatur hängt am **`Projekt`**-Kern (nicht „Deal") — `ProjektSignatureDocument`/`Signer`; Einstieg lebt im Projekt-Detail (P8/P9). Die Task-Komponente aus P4 (D-P4) wird eingebettet, nicht neu gebaut.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| 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 |
| Buchungen-Liste [`/bookings`] | Termin, Endkunde (Name/Email), Booking-Page, Provider, Status · Tabs Anstehend/Vergangen/Storniert/Alle · Filter (Status/Provider/Page/Zeitraum) · Bulk-Cancel · CSV | A2 |
| Buchung-Detail [`/bookings/:id`] | Termin-Daten, Provider, verknüpfter Kontakt/Lead, Form-Antworten, Kalender-Sync-Status-Badge, interne Notiz · Aktionen: held/no-show, Cancel (mit Grund + Auto-Mail), Reschedule (Slot-Picker), Provider-Re-Assign | A3 |
| Booking-Page-Editor [`/bookings/pages/:id`, `/new`] | Grunddaten, Dauer, Puffer, Vorlauf/Vorausbuchbarkeit, Provider-Auswahl, Intake-Form-Wahl, Bestätigungsmail-Template (Markdown + Tokens), Publish-Toggle, Public-URL + Embed-Code-Generator (iFrame) | A6 + A4 |
| Booking-Pages-Liste [`/bookings/pages`] | Title, Slug, aktive Provider, Buchungen (gesamt/30T), Status, Public-URL mit Copy | A2 |
| Verfügbarkeit [`/availability`] | Wöchentliche Standard-Regeln (mehrere Zeitfenster/Tag), Datums-Ausnahmen (frei/Custom-Window), Timezone, Hinweis welche Booking-Pages zugreifen | A6 + A4 |
| Forms-Liste [`/forms`] | Name, Subtyp, Status (Entwurf/Publiziert/Archiviert), Submissions-Anzahl, letzte Submission · SHK-Templates geseedet | A2 |
| Submissions [`/forms/:id/submissions`] | Tabelle der Antworten (Spalten = Felder), Filter, CSV-Export · Detail: alle Antworten in Reihenfolge, Submitter-Metadata, Action-Log mit Status (Re-Run), File-/Foto-Vorschau, PDF-Export | A2 / A3 |
| Signatur-Wizard [im Projekt-Detail] | PDF-Upload (aus Files oder neu) → Unterzeichner (Name vorausgefüllt aus Kontakt, Email, Rolle, Reihenfolge sequenziell/parallel) → Provider (PandaDoc, Default) → Senden · Status-Tracking je Unterzeichner (entwurf/gesendet/angesehen/signiert/abgelehnt) + Erinnerung + Widerruf · Original- + Signed-PDF-Download | A5 + A6 |
*(Form-Builder-Canvas + öffentliches Formular = **D-FORM**. Öffentliche Booking-Page + Kalender-Grid-View = **D-BOOK**. Lead-Inbox/Detail → P7. Plantafel/Projekt-Detail → P9. Sende-Domain-Card → P14. Integrations-Katalog/Connection-Setup → P5. Task-Komponente → P4.)*
## Features (muss abgedeckt sein)
- [ ] Kalender-Verbindungen (Google-Connect-Card, Kalender-Auswahl, Sync-Richtung, Disconnect mit Extern-Entfernen-Wahl, Re-Connect-Banner) + Konflikt-Liste mit Klartext-Resolution
- [ ] Buchungen-Liste (Tabs/Filter/Bulk-Cancel/CSV) + Buchung-Detail (held/no-show/Cancel mit Grund + Auto-Mail/Reschedule/Re-Assign)
- [ ] Booking-Page-Editor (Dauer/Puffer/Vorlauf/Provider/Intake-Form/Bestätigungsmail/Publish/Embed-Code) + Pages-Liste + Verfügbarkeits-Editor
- [ ] Forms-Liste + Submissions-Ansicht (Tabelle/Filter/CSV, Detail mit Action-Log + Re-Run + File-/Foto-Vorschau + PDF-Export)
- [ ] Signatur-Wizard am Projekt (PDF-Upload → Unterzeichner → PandaDoc → Senden) + Status-Tracking je Unterzeichner + Erinnerung/Widerruf + Original-/Signed-PDF-Download
- [ ] Empty/Loading/Fehler/Permission-Denied/Offline-States (Klartext + Lösungs-Knopf)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Connection-Card mit Status-Ampel + letzter-Sync-Zeit + verbundenem Konto-Email; Sync-Richtungs-Selector; Konflikt-Log-Liste mit Klartext + Resolution; Daten-Tabelle (sortierbar, paginiert) + Filter-Bar + Bulk-Action-Toolbar (Buchungen); Status-Badge mit Klartext-Tooltip; Reschedule-Slot-Picker; **Wochen-Verfügbarkeits-Editor** (mehrere Zeitfenster/Tag) + Ausnahmen-Editor (Datum + frei/Custom-Window); Embed-Code-Generator + QR-Generator + Copy-to-Clipboard (Booking-Page-Editor); **Post-Submit-Action-Log-Liste** mit Re-Run + Status; File-/Foto-Vorschau; PDF-Export-Button; **PDF-Upload-Dropzone**; **Unterzeichner-Liste** mit Reihenfolge + Rollen-Badge; **Status-Tracker je Unterzeichner** (entwurf/gesendet/angesehen/signiert/abgelehnt); PDF-Download-Buttons (Original/Signed); eingebettete Task-Komponente (aus D-P4); Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States.
## Quellen (granular)
- `designer-briefs/P16-kalender-booking-forms-signatur.md` (vollständiger Brief MINUS Form-Builder-Canvas/öffentliches Formular & öffentliche Booking-Page/Kalender-Grid-View)
- `ENTITY-MODEL.md` → **Domäne 9** (Kalender/Booking/Forms/Signatur; `ProjektSignatureDocument`/`Signer` am Projekt-Kern — 🔴 Pivot: Signatur hängt am Projekt, nicht „Deal")
- `ROADMAP.md` → Phase 16 · `REQUIREMENTS.md` → Modul 25/06/05/07 · `PHASE-SOURCES.md` → P16
- `_bmad-output/specs/M25-calendar-sync.md`, `M06-booking.md`, `M05-form-builder.md`, `M07-angebot-signatur.md`
- Geschwister-Tickets: `D-FORM`, `D-BOOK` · eingebettet: `D-P4` · Dev-Pendant: `ticket-docs/AK-P16a.md`–`AK-P16d.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev: