Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/designer-briefs/P16-kalender-booking-forms-signatur.md
2026-07-08 16:15:37 +02:00

9.0 KiB
Raw Permalink Blame History

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 gehärteten SES-Eigenbau als Default (Fern-Link/OTP + Touch vor Ort + PAdES + Completion-Certificate), PandaDoc nur optionaler BYOK-Adapter. 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 SES-Default plus Apps-Engine-Adapter.

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) → 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

(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 SES-Eigenbau-Default (Fern-Link/OTP + Touch vor Ort + PAdES + Completion-Certificate); PandaDoc bleibt optionaler BYOK-Adapter über die Apps-Engine (M33a). Status-Updates, optionaler 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: