8.7 KiB
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: