# Designer-Brief · P16 — Kalender, Booking, Forms & Signatur **Phase:** 16/21 · **Module:** M25 / M06 / M05 / M07 · **Owner-Dev:** Akeshan (AK-P16a–d) · **Designer:** David **Quellen:** `ROADMAP.md` §Phase 16 · `ENTITY-MODEL.md` Domäne 9 (Kalender/Booking/Forms/Signatur) · `SCREEN-MAP.md` §3 (Form-Builder) + §5 (Booking/Kalender/Signatur) + §6 (Signatur) · `_bmad-output/specs/M25-calendar-sync.md`, `M06-booking.md`, `M05-form-builder.md`, `M07-angebot-signatur.md` **Subframe:** Pflicht je Route. Archetypen aus D0 (A2 Liste, A3 Detail, A4 Form/Input, A5 Modal/Wizard, A6 Settings/Connection, A7 Zustände); zusätzlich BESPOKE für Form-Builder-Canvas, Booking-Page (öffentlich), Kalender. > 🟡 **Vier Module, vier Screen-Gruppen — bewusst gebündelt:** Termin- und Dokument-Workflows. Bitte je Gruppe (1) Kalender-Sync, (2) Booking, (3) Form-Builder, (4) Angebots-Signatur getrennt halten. **v1-Schnitte (verbindlich):** Kalender-Sync nur **Google** (Outlook-Adapter → v2, Interface bleibt provider-agnostisch); Booking nur **eine** Zuteilungs-Strategie „Erster der frei ist" (Round-Robin/Provider-Wahl → v2); Form-Sharing = **URL + QR + iFrame** (personalisierte Links / JS-Snippet → v2); Signatur über **PandaDoc** (DocuSign-Adapter bleibt möglich). Pivot-Hinweis: Signatur hängt am **`Projekt`**-Kern (nicht „Deal") — `ProjektSignatureDocument`/`ProjektSignatureSigner`; der Signatur-Einstieg lebt im Projekt-Detail (P8/P9). Die Task-Komponente aus P4 wird hier eingebettet, nicht neu gebaut. ## Was dieses Modul tut (Kurzfassung) Deckt Termin- und Dokument-Workflows ab: bidirektionaler **Kalender-Sync** mit Google (Settings + Connection-Health), öffentliche **Buchungsseiten** (Calendly-Style, timezone-aware Slots, iFrame-Embed, Auto-Bestätigungsmail, erzeugt Lead/Activity), ein Drag-&-Drop-**Form-Builder** auf Google-Forms-Niveau (12 Feld-Typen, Conditional Logic, SHK-Templates, Post-Submit-Actions) und Multi-Signer-**Angebots-Signatur** über die Apps-Engine. ## Benötigte Screens | Screen [Route] | Kern-Inhalt | Archetyp | |---|---|---| | 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 | | 🌐 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) | | 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 | | **Form-Builder-Canvas** [`/forms/:id/edit`] | Feld-Palette (12 Typen) · Canvas mit Drag-&-Drop-Feldliste · Feld-Konfiguration (Label, Pflicht, Validierung, Optionen) · Conditional-Logic-Editor („zeige Feld X wenn Y = Z") · Live-Vorschau · Publish-Toggle · Sharing: öffentliche URL + QR + iFrame · Post-Submit-Actions (Lead/Kontakt/Projekt/Task, Email, Webhook, Automation-Trigger) mit Field-Mapping | BESPOKE (schwerste UI nach Flow-Editor) | | Forms-Liste [`/forms`] | Name, Subtyp, Status (Entwurf/Publiziert/Archiviert), Submissions-Anzahl, letzte Submission · SHK-Templates geseedet | A2 | | 🌐 Öffentliches Formular [`/f/{tenant}/{slug}`] | Gerenderte Felder, Conditional Logic live, mCaptcha, Submit → Erfolgs-Text oder Redirect · Tenant-Logo · 4 Zustände | BESPOKE-Public | | 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 | *(Lead-Inbox/Lead-Detail → P7. Plantafel/Projekt-Detail → P9. Sende-Domain-Card → P14. Integrations-Katalog/Connection-Setup → P5. Task-Komponente → P4.)* ## Geplante Features (muss abgedeckt sein) - [ ] Kalender synchronisiert bidirektional mit **Google** (CalendarAdapter, Auto-Token-Refresh, Webhook-Subscriptions); HiveGrid-Termine (Booking/Projekt/Plantafel) gehen extern, externe Events kommen read-only für Verfügbarkeit (Outlook → v2) - [ ] Connection pro **User** (nicht pro Tenant); externe Event-Inhalte nie an andere User leaken (Booking sieht nur „belegt von X bis Y"); Last-Write-Wins-Konflikt mit Klartext-Notification - [ ] Öffentliche Booking-Seiten berechnen 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 - [ ] Booking nur **eine** Zuteilungs-Strategie „Erster der frei ist" (Round-Robin/Provider-Wahl → v2) - [ ] Form-Builder mit Drag-&-Drop, **12 Feld-Typen**, **Conditional Logic**, Validierung pro Feld, SHK-Form-Templates geseedet, iFrame-Embed + QR + öffentliche URL - [ ] Post-Submit-Actions feuern mit Field-Mapping + ActionLog (Lead/Kontakt/Projekt/Task anlegen, Email an Submitter/Team, Webhook, Automation-Trigger, Auto-Match) - [ ] Angebote durchlaufen Multi-Signer-Signatur via **PandaDoc** über die Apps-Engine (M33a) mit Webhook-Verarbeitung, Status-Updates, optionalem Auto-Stage-Wechsel; Signed-PDF landet in Files - [ ] Signatur hängt am **`Projekt`**-Kern (`ProjektSignatureDocument`/`Signer`) — kein eigenes „Deal"-Objekt - [ ] Permission-Bundles: `calendar.*` (connect_own/admin), `bookings.*` (read_own/read_all/write/admin), `forms.*` (basic/builder/publisher/admin), `signature.*` (read/send/revoke/admin) — serverseitig Owner-gefiltert ## Benötigte 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), Wochen-Verfügbarkeits-Editor (mehrere Zeitfenster/Tag), Ausnahmen-Editor (Datum + frei/Custom-Window), Daten-Tabelle (sortierbar, paginiert), Filter-Bar, Bulk-Action-Toolbar, Reschedule-Slot-Picker, Status-Badge mit Klartext-Tooltip, Feld-Palette (12 Typen), Drag-&-Drop-Canvas-Feldliste, Feld-Konfigurations-Panel, Conditional-Logic-Editor (Wenn-Dann-Regeln), Live-Vorschau-Pane, Embed-Code-Generator + QR-Generator + Copy-to-Clipboard, Post-Submit-Action-Liste mit Field-Mapping-Zeilen, gerenderter Form-Player (öffentlich, mCaptcha), Action-Log-Liste mit Re-Run, PDF-Upload-Dropzone, Unterzeichner-Liste mit Reihenfolge + Rollen-Badge, Status-Tracker je Unterzeichner, PDF-Download-Buttons (Original/Signed), Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext mit Lösungs-Knopf). ## Davids Delta (David füllt aus) - [ ] Überschriebene/geänderte Spec-Punkte: - [ ] Neue UI/UX-Entscheidungen: - [ ] Subframe-Screen-Link(s): - [ ] Offene Fragen an Dev: ## Dev-Nachzug (wir nach Davids Delta) - [ ] Spec/ENTITY-MODEL an Davids Entscheidungen angepasst: - [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen: - [ ] Plane-Ticket (AK-P16a–d) aktualisiert: