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

62 lines
8.0 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-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 SES-Default + BYOK-Adapter)
- **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 **gehärteten SES-Eigenbau als Default** (Fern-Link/OTP + Touch vor Ort + PAdES + Completion-Certificate), **PandaDoc nur optionaler BYOK-Adapter**. **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) → Signaturmodus (Fern-Link/OTP oder Touch vor Ort; PandaDoc nur BYOK-Opt-in) → Senden · Status-Tracking je Unterzeichner (entwurf/gesendet/angesehen/signiert/abgelehnt) + Erinnerung + Widerruf · Original-, Signed-PDF- und Completion-Certificate-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 → SES-Signatur per Fern-Link/OTP oder Touch vor Ort; PandaDoc nur BYOK-Opt-in) + Status-Tracking je Unterzeichner + Erinnerung/Widerruf + Original-/Signed-PDF-/Completion-Certificate-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; Signaturmodus-Switch (Fern-Link/OTP, Touch vor Ort, PandaDoc BYOK falls verbunden); **Status-Tracker je Unterzeichner** (entwurf/gesendet/angesehen/signiert/abgelehnt); PDF-Download-Buttons (Original/Signed/Certificate); 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
- 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: