Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/SCREEN-MAP.md
T

30 KiB
Raw Blame History

pdf_options, css
pdf_options css
format margin
A4 14mm
body { font-size: 10px; font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; } h1 { font-size: 18px; } h2 { font-size: 14px; border-bottom: 2px solid #f5a623; padding-bottom: 3px; margin-top: 20px; break-after: avoid; page-break-after: avoid; } h3 { font-size: 11.5px; margin-top: 14px; break-after: avoid; page-break-after: avoid; } table { font-size: 8.5px; border-collapse: separate; border-spacing: 0; width: 100%; border-top: 1px solid #ccc; border-left: 1px solid #ccc; } thead { display: table-header-group; } tr { break-inside: avoid !important; page-break-inside: avoid !important; } td, th { break-inside: avoid !important; page-break-inside: avoid !important; border-right: 1px solid #ccc; border-bottom: 1px solid #ccc; padding: 3px 5px; text-align: left; vertical-align: top; } th { background: #fff7e8; } li { break-inside: avoid; page-break-inside: avoid; } p { orphans: 3; widows: 3; } code { background: #f4f4f4; padding: 1px 3px; font-size: 8px; } .pagebreak { page-break-after: always; }

SCREEN-MAP — HiveGrid 2.0 v1 (präzise Bau-Liste für David)

Stand: 12.06.2026 (nach Scope-Schnitt #12 + Infra-Wechsel) · Quelle: 36 Specs (requirements-pur) + TIMELINE-Deadlines + Playbook-Archetypen Regeln: (1) Screens beschreiben WAS angezeigt wird — Layout/Anordnung ist Davids Freiheit. (2) Hot-Swap: kein Screen blockt den Dev-Bau; Deadlines = Demo-/Politur-Termine. (3) Pro Screen vor Übergabe: Reconciliation-Checkliste (Playbook §6a) — jedes Feld hat eine Datenquelle, jeder Button eine Aktion, 4 Zustände designt (leer/laden/Fehler/keine Berechtigung). Legende: [A2] = aus Archetyp komponiert (Stunden) · BESPOKE = Sonder-UI (Tage) · 🌐 = öffentlich (höchster Polish) · 📱 = Monteur-mobile-first + offline

🔴 MODELL-PIVOT (AD-20) — §2/§3/§4 nachgezogen 2026-06-16 (ENTITY-MODEL.md LOCKED): Projekt-zentrisch. Sales-Kanban + Projekt-Kanban → EIN konfigurierbarer Pipeline-Kanban (Pipeline = View; „Deal"/„Auftrag" = Pipeline-Typen typ_hint sales/auftrag/custom, KEINE eigenen Entitäten). Projekt-Detail mit Sub-Areas (Kontakte, Termine, Rechnungen [v1 NEU], Checklisten, Aufgaben, Aktivitäten, Dokumente). KEIN Won-Handoff (Projekt wechselt nur die Pipeline, kein zweiter Datensatz). Lead → Projekt bei Weiterverarbeitungsfreigabe (Lead-Promotion-Modal mit 4 Optionen entfällt; Kontakt separat verknüpft). Abnahme bleibt als immutable Checklisten/Protokoll-Sub-Area am Projekt (Mängel = Checkliste). Neuer Pipeline-Config-Admin-Screen (Zugriff/Feld-Sichtbarkeit inkl. Field-Level-Rechte je Rolle/Gruppe/User PipelineFieldVisibility/Pflichtfelder/Statuswerte je Pipeline). Kontaktmodell: Kontakttyp (Privatperson/Organisation — nicht „Unternehmen")/Kontaktstatus (Kontakt/Kunde/Bestandskunde)/Kontaktart=Rolle. KWP komplett v2 (auch kein Feld-Halter v1). Die §2–§4-Tabellen sind nachgezogen; David finalisiert sein PDF gegen .planning/ENTITY-MODEL.md.


§0 BASELINE — Sprint D0 (Fertig: So 21.06.) — blockt ~70 % aller Screens

0.1 App-Shell (Archetyp A1) — wird von JEDEM Screen konsumiert

Komponente Muss enthalten
Sidebar Modul-Navigation mit Icons + Labels · Konnektor-Gating-Zustand (Modul ausgeblendet/gesperrt je tenantHasModule()) · Sektionen: Arbeit (Dashboard, Kontakte, Leads, Projekte (eine Liste/Kanban über alle Pipelines, Pipeline-Switcher im Header), Plantafel, Aufgaben, Dateien, Kalender, Buchungen, Formulare, Chat, Telefonie, Marketing, HR) + Verwaltung (Settings, Admin) · Collapse-Zustand · aktiver Eintrag · Mobile: Drawer/Bottom-Nav-Variante 📱
Topbar Tenant-Switcher (Dropdown, Liste mit zuletzt-genutzt, Suchfeld ab 5 Tenants) · Cmd+K-Suchfeld-Trigger · Notification-Bell mit Unread-Badge · User-Menü (Profil, Settings, Hell/Dunkel-Toggle, Logout)
Breadcrumb Pfad bis Entität (z. B. Projekte → Pipeline Heizung (Sales-Sicht) → P-2026-0042)
Status-Banner-System Tenant-Status-Banner: past_due / frozen / deletion_pending / suspended — je eigener Text + Action-Button · stapelbar mit System-Hinweisen
Toast/Inline-Feedback Erfolg / Klartext-Fehler mit Lösungs-Knopf (Bauprinzip A.1!) / Warnung

0.2 Archetypen A2–A7 — einmal designen, überall komponieren

# Kit Muss enthalten
A2 List-View-Kit Filterbar (Multi-Select, Datum-Range, Toggle-Chips) · Tabelle mit sortierbaren Headern · Karten-Alternative · Bulk-Select + Bulk-Action-Bar · Pagination (50/Seite) · Spalten-Konfiguration · CSV-Export-Button · Suchfeld · Archiviert-Toggle · Leerzustand mit CTA
A3 Detail-View-Kit Header mit Titel + Quick-Actions (Anrufen, Email, Termin, Task, Notiz) · Inline-Edit-Feld (Klick → Edit → Save/Cancel) · Related-Panels (verknüpfte Entitäten gruppiert) · Activity-Stream-Komponente (chronologisch, Typ-Icons, Filter) · Custom-Felder-Sektion (typ-abhängige Eingaben) · Tags-Zeile · Sub-Tabs
A4 Form/Input-Kit Alle 12 Feldtypen: Text, Textarea (Markdown), Zahl, Währung, Datum, Datum-Range, Select, Multi-Select, Boolean, Email, Telefon, Datei · Validierungs-Zustände + Klartext-Fehler · Auto-Complete-Picker (Kontakt/User/Entity) · Pflichtfeld-Markierung
A5 Modal/Wizard-Kit Einfacher Dialog · mehrstufiger Wizard mit Progress · Bestätigungs-Dialog (mit Confirm-Phrase-Variante für destruktive Aktionen) · Side-Panel/Drawer
A6 Settings/Connection-Kit Settings-Seitenlayout mit Sektionen · Toggle-Zeile mit Klartext-Beschreibung · Connection-Card (App-Logo, Status-Ampel grün/gelb/rot/grau, Klartext-Status, letzte-Sync-Zeit, Buttons Verbinden/Trennen/Re-Sync) · Key/Secret-Eingabe mit Reveal
A7 Zustands-Kit Leer (Illustration + CTA) · Laden (Skeleton) · Fehler (Klartext + Lösungs-Knopf) · Keine-Berechtigung · Offline-Hinweis 📱

0.3 Basis-Primitives

Buttons (primär/sekundär/destruktiv/ghost) · Badges + Status-Pills · Tags (farbig) · Avatare + Avatar-Stapel · Tabs · Dropdown-Menü · Date/Time-Picker · Tooltip · KPI-Kachel (Wert, Label, Trend-Pfeil, Vergleich) · Chart-Basis (Linie, Balken, Donut) · Drawer · Markdown-Editor + -Renderer · Datei-Dropzone mit Upload-Progress · Unterschriften-Feld (Touch) 📱 · Emoji-Picker · Mention-Highlight


§1 AUTH-SCREENS (P2) — Fertig: So 21.06. (mit D0)

Screen [Route] Inhalt Typ
Signup [/signup] Email, Passwort (Stärke-Anzeige), Firmenname, Vor-/Nachname, Telefon, USt-ID, AGB/DSGVO/AVV-Checkboxen → erzeugt Tenant + Auto-SHK-Seed (kein Wizard!) [A4]
Login [/login] Email, Passwort, mCaptcha ab 3. Fehlversuch, Magic-Link-Alternative [A4]
2FA-Eingabe 6-stelliger TOTP-Code, Trust-Device-Checkbox [A4/A5]
Passwort vergessen [/forgot-password] Email-Eingabe → Magic-Link [A4]
Tenant-Auswahl Tenant-Liste mit zuletzt-genutzt, Suchfeld [A2]
Session-Verwaltung [/settings/security] Aktive Sessions (Gerät, Browser, IP, Standort, letzte Aktivität) + Abmelden je Session + „überall abmelden" · Trust-Device-Liste mit Revoke [A2/A6]
Profil [/settings/profile] Name, Avatar, Telefon, Passwort ändern, 2FA einrichten (QR), Hell/Dunkel-Toggle. (Sprache: fest DE — kein Wechsler v1) [A6]
Rollen-Editor [/admin/roles] Rollen-Liste (Name, User-Anzahl) · Editor: Name, Beschreibung, Permission-Bundles + Advanced-Einzelrechte · 6 SHK-Rollen vorgeseedet [A2+A6]
Gruppen [/admin/groups] Gruppen-Liste mit Mitgliederzahl, Bulk-Add/Remove [A2]
Mitarbeiter [/admin/users] User-Liste (Name, Email, Rolle, Status, 2FA) · Einladungs-Modal (Email, Rolle, Gruppen, Nachricht) · Einladungs-Status-Liste · Deaktivieren mit Reassign-Workflow (offene Verknüpfungen anzeigen, Bulk-Übertragung) [A2+A5]
Konto löschen [/settings/account] Multi-Step: Erklärung → optional Daten-Export → Passwort+2FA → Countdown-Bestätigung [A5]

§2 CRM-CLUSTER (P6/P7) — Fertig: Mi 24.06. → Noah-Demo #1

Screen [Route] Inhalt Typ
Kontakt-Liste [/contacts] Avatar+Name, Organisation, Kontaktstatus (Kontakt/Kunde/Bestandskunde), Email, Telefon, Tags, Verantwortlicher, letzte Activity · Filter: Verantwortlicher, Kontakttyp (Privatperson/Organisation), Kontaktstatus, Tags (UND/ODER), Organisation, Datum · Bulk: Tag/Zuweisen/Archiv/CSV [A2]
Organisationen-Liste [/contacts/organizations] Name, org_merkmal, Branche, Kontakt-Anzahl, Verantwortlicher, letzte Activity · (Kontakt mit Kontakttyp=organisation; Label „Organisation", NICHT „Unternehmen") [A2]
Kontakt-Detail [/contacts/:id] Stammdaten inline-editierbar · verknüpfte Kontakte/Organisationen mit Kontaktart=Rolle (Haupt-/Sekundärkontakt) · Tags · Projekte-Panel (alle verknüpften Projekte über ProjektKontakt, Pipeline-Sicht erkennbar)/Dateien/Tasks-Panels · Custom-Felder · Notizen (Markdown) · Activity-Stream (inkl. BCC-gelogde Mails + Anrufe!) · Quick-Actions: Anrufen (AirCall), Email (mailto), Termin, Task, Tag [A3] — das Muster-Template für alle Detail-Views
Organisation-Detail [/contacts/organizations/:id] Analog Kontakt + Kontakt-Verknüpfungen mit Primär-Markierung + Kontaktart (Rolle der Relation) [A3]
Lead-Inbox [/leads] Tabelle/Karten: Name, Email/Telefon, Quelle, Status, Weiterverarbeitungsfreigabe (ja/nein/unklar), Verantwortlicher, Eingegangen, 80-Zeichen-Vorschau · Marker: „Mögliches Duplikat", „Spam-Verdacht" · Quick-Actions inline: Zuweisen, Status, „Zu Projekt" (Freigabe ja), Spam · Toggle „Spam ausblenden" [A2 + Triage-Akzente]
Lead-Detail [/leads/:id] Stammdaten · Quellen-Detail (Formular-Name/IP bzw. Inbound-Mail) · Spam-Score mit Begründung · Match-Hinweise (existierende Kontakte gleiche Email/Telefon, zum separaten Verknüpfen) · Re-Submission-Verlauf · Status-Wechsler (new/qualified/converted/lost/spam) · Weiterverarbeitungsfreigabe-Schalter [A3]
Lead → Projekt (Konvertierung) Bei Weiterverarbeitungsfreigabe=ja: Aktion „Zu Projekt" → erzeugt Projekt (konvertiert_aus_lead_id), Lead-Daten vorausgefüllt, Ziel-Pipeline + Start-Status wählbar, Kontakt separat verknüpfen (existierenden zuordnen über Match-Hinweise ODER neu anlegen) · Mängel-Banner bei fehlendem Namen · (KEIN 4-Optionen-Promotion-Modal mehr — Kontakt-Anlage entkoppelt) [A5] — Kern-Moment der Kette!
Lead-Statistiken [/leads/statistics] KPI-Kacheln: Eingegangen, Konversion Lead→Projekt, Reaktionszeit, Spam-Quote · Aufschlüsselung nach Quelle/Verantwortlichem · Trend-Chart mit Vorperioden-Vergleich [A2+KPI-Kit]
Custom-Felder [/admin/custom-fields] Felder je Entity-Ziel (projekt/kontakt/lead/rechnung), Typ, Nutzungs-Anzahl, Quelle (SHK-Template/eigen), Sortierung, Archiv · (pro Pipeline via PipelineFieldConfig schaltbar) [A2]
Tag-Verwaltung [/admin/tags] Name, Farbe, Verknüpfungs-Anzahl, Merge-Funktion [A2]
Duplikat-Tool [/admin/duplicates] Duplikat-Paare mit Match-Kriterium · Side-by-Side-Merge mit Feld-für-Feld-Auswahl [A5 + Side-by-Side]
Quellen-Verwaltung [/admin/lead-sources] Quellen mit Typ, 30-Tage-Lead-Count, Status + Webhook-URL mit Token (für Fremd-Website-Leads) [A2/A6]
Anti-Spam-Settings [/admin/lead-anti-spam] Limits pro Quelle/IP, Disposable-Domain-Check, Honeypot, Quarantäne-Modus [A6]

Dazu im selben Paket (P3/P4/P5-Oberflächen — Archetyp-Compose, Bau läuft schon):

Screen Inhalt Typ
Audit-Viewer [/admin/audit] Zeit, Actor (+Kind-Marker: User/Automation/KI/Admin), Aktion, Subjekt, deutscher Summary-Text · Filter: Zeitraum, Actor, Kategorie, Subjekt-Typ · Detail-Drawer mit Diff-Ansicht · Export-Button (CSV/NDJSON, Zweck-Pflichtfeld). (Kein Retention-Editor/Legal-Hold/Saved-Views — v2) [A2+Drawer]
Notification-Center [Topbar-Drawer + /notifications] Einträge: Titel, Body, Actor, Zeit, Read-Status · Tabs Alle/Ungelesen · Mark-read/unread, Klick→Deeplink · Bulk [A2]
Notification-Settings [/settings/notifications] Event-Typen nach Modul gruppiert, je In-App/Email-Toggle · Master-Toggle „alle Emails aus". (Keine Quiet-Hours/Bündelung/Push — v2) [A6]
Files-Browser [/files] Tabelle/Grid-Umschalter: Name, Größe, Datum, Tags, verknüpfte Entität, Thumbnail · Filter: Entität, MIME-Gruppe, Tags, Verantwortlicher · Bulk: Tag/Verknüpfen/Archiv/ZIP. (Keine Versions-Spalte — v2) [A2]
Upload-View + Datei-Dropzone Drag&Drop, Multi-Datei-Queue mit Fortschritt je Datei, Fehler+Retry · HEIC-Hinweis: „wird zu JPG konvertiert" [A4]
File-Detail [/files/:id] Stammdaten, Vorschau (Bild/PDF; HEIC→JPG), Tags, Notizen, verknüpfte Entitäten mit Rolle, Activity · Download, Ersetzen, Archiv. (Kein Versionsverlauf — v2) [A3]
Task-Liste [/tasks] Titel, Prioritäts-Marker, Fälligkeit (überfällig rot), verknüpfte Entität, Assignee, Status, Quelle · Presets: Meine/Erstellt/Alle · Bulk [A2] — als wiederverwendbare Komponente bauen (P12/P14/P16 betten sie ein!)
Task-Detail + Anlage-Modal Titel, Beschreibung (Markdown), Status/Priorität/Fälligkeit inline, Assignee (Person/Gruppe), Verknüpfung, Watcher, Kommentare, Quelle (manuell/Chat/Form/Automation) [A3+A5]
Integrations-Katalog [/admin/integrations] App-Karten nach Kategorie (ERP/Kommunikation/Kalender/Signatur/Payment/KI) · je: Logo, Beschreibung, Status-Ampel, aktive Connections [A6]
Connection-Setup-Wizard Voraussetzungen-Check → Credential-Formular (auto-generiert) → Health-Check → Initial-Sync-Option · Sync-History-Liste mit Klartext-Zusammenfassung je Lauf [A5+A6]

§3 PAKET Fr 26.06. — Kanban, Form-Builder, Kampagnen-Editor, HR

Screen [Route] Inhalt Typ
Pipeline-Kanban (Sales-Sicht) [/projects?pipeline=…] EIN Projekt-Kanban, Pipeline = View (typ_hint=sales). Spalten je Status (PipelineStage): Name, Projekt-Anzahl, Aggregat-Volumen, Win-% · Karten: Titel, Volumen (field-level-gegated via PipelineFieldVisibility, z.B. nur Vertrieb!), Avatar, Termin-Datum, max. 3 Tags, Stuck-Marker · Drag&Drop zwischen Status · Verloren-Status → Begründung-Pflicht · (KEIN Won-Handoff/„Projekt anlegen?"-Dialog — Projekt wechselt zum Gewinn nur in die Auftrags-Pipeline, kein zweiter Datensatz) · Filter + „nur meine" BESPOKE
Projekt-Liste [/projects/list] Nummer (P-…), Projektname, Pipeline, Status, Volumen (gegated), Kontakt+Organisation, Termin-Datum · Cross-Pipeline mit Pipeline-Filter [A2]
Projekt-Detail (Sales-Sicht) [/projects/:id] Ein Projekt-Detail (gleicher Datensatz wie Auftrags-Sicht, §4). Stammdaten inline · Status-Visualisierung klickbar (pipeline-interne Statuswerte) · Lead-Herkunft-Hinweis (konvertiert_aus_lead_id) · Status-Historie mit Verweildauer · Gewonnen/Verloren-Banner mit 24h-Rückgängig · Sub-Areas Kontakte/Termine/Rechnungen/Aktivität/Dateien/Tasks/Formulare · „Angebot zur Signatur senden"-Button [A3+Status-Bar]
Pipeline-Config [/admin/pipelines] Pipelines-Liste (typ_hint sales/auftrag/custom) · Editor: Statuswerte (PipelineStage) mit Drag&Drop, je Name, Art (offen/gewonnen/verloren), Win-%, Farbe · Zugriff (PipelineAccess: wer sieht/bearbeitet je Rolle/User/Gruppe) · Feld-Config (PipelineFieldConfig: sichtbar/pflicht je Feld+Status) · Field-Level-Rechte (PipelineFieldVisibility: kann_sehen/kann_bearbeiten je Rolle/Gruppe/User — z.B. Volumen nur Vertrieb) · Verloren-Gründe als Checklisten-Werte/Status-Metadaten [A2+A6] — v1-Pflicht-Feature (Entsch. 16.06.)
Form-Builder-Canvas [/forms/:id/edit] Feld-Palette (12 Typen) · Canvas mit Drag&Drop-Feldliste · Feld-Konfiguration (Label, Pflicht, Optionen) · Conditional-Logic-Editor („zeige Feld X wenn Y = Z") · Live-Vorschau · Publish-Toggle · Sharing: öffentliche URL + QR-Code + iFrame-Code (personalisierte Links/JS-Snippet — v2) · Post-Submit-Actions (Lead/Projekt/Task anlegen, Email, Webhook, Automation-Trigger) mit Field-Mapping BESPOKE (schwerste UI nach Flow-Editor)
🌐 Öffentliches Formular [/f/{tenant}/{slug}] Gerenderte Felder, Conditional Logic live, mCaptcha, Submit → Erfolgs-Text oder Redirect · Tenant-Logo BESPOKE-Public
Submissions [/forms/:id/submissions] Tabelle der Antworten, Spalten = Felder, Filter, CSV, Detail mit Action-Log + PDF-Export [A2/A3]
Kampagnen-Editor [/email-marketing/campaigns/new] Schritte: Basis (Name, Sender, Betreff, Preheader) → Inhalt (Rich-Text + Personalisierungs-Tokens, Bild-Upload, Pflicht-Footer mit Impressum + Unsubscribe) → Empfänger (Segment-Wahl, Vorschau mit Ausschluss-Aufschlüsselung: Abgemeldet/Bounce/Suppression) → Test-Versand (max. 5 Adressen) → Zeitpunkt (sofort/geplant) → Bestätigung mit Klartext-Checkliste (Domain verifiziert? Unsubscribe? Impressum?) — Versand blockiert bei rotem Check BESPOKE
Kampagnen-Liste + -Detail Liste: Name, Status, Empfänger, Versanddatum, Stats · Detail: KPI-Header (Zugestellt/Geöffnet/Geklickt/Bounces/Abmeldungen in %), Klick-Map (URLs mit Counts), Pro-Empfänger-Tabelle, A/B-Varianten-Vergleich [A2/A3+KPI]
Segmente [/email-marketing/segments] Filter-Baum lesbar dargestellt, Live-Empfänger-Anzahl, Sample-Vorschau (50), dynamisch/statisch [A2+Filter-Builder]
Sender + Suppression Sender: From-Name/-Email, Domain-DKIM-Status, Default-Marker · Suppression-Liste: Adresse, Grund (Bounce/Beschwerde/manuell) [A2/A6]
🌐 Unsubscribe-Page [/unsubscribe/{token}] Klartext, Bestätigungs-Button, optionale Grund-Auswahl, Erfolgs-Meldung [A4-Public]
HR-Hub-Start [/hr] Angepinnte Announcements, offene Bestätigungen, ausstehende Anträge, Team heute (Urlaub/krank), Geburtstage, Quick-Links [Compose aus KPI+Listen]
Announcements + Detail Feed mit Ungelesen-Filter · Detail: Markdown, Anhänge, Reaktionen, Kommentare (1 Ebene), Bestätigungs-Button + Read-Receipt-Tabelle (nur Autor/HR) [A2/A3]
Urlaub & Krankmeldung [/hr/leave] Tabs: Meine / Genehmigungen / Team · Antrag (M05-Form): Zeitraum, Art, Genehmiger · Genehmiger-Sicht: Approve/Reject/Rückfrage + Konflikt-Hinweise (Plantafel!) · Krankmeldung: Start, Rückkehr, AU-Upload (verschlüsselt) · Admin-Kalender-Monatssicht + KPI-Kacheln [A2+A4+A5]
Lohnabrechnungen [/hr/payslips] Eigene: Liste nach Periode + PDF-Viewer · Admin: alle MA, Einzel-/Bulk-Upload mit Auto-Match-Vorschau [A2]
MA-Anträge [/hr/requests] Template-Wahl (Spesen, Hardware, Schulung, Zeugnis), M05-Form, Genehmiger, Kommentar-Stream (interne Notizen verborgen), Entscheidung [A2/A3]
Passwort-Safe [/hr/password-safe] Vault-Liste → Eintrags-Liste (Titel, Tags — keine Werte!) → Detail: Reveal-Button je Wert (audit-geloggt!), Copy mit 30s-Auto-Clear, Access-Verwaltung [A2/A3+Reveal]
Surveys [/hr/surveys] Teilnahme: Items (Text/Rating/NPS/Choice/Boolean) · Auswertung: Häufigkeits-Charts, Durchschnitte, Textantworten · Admin-Editor mit Audience + Sichtbarkeit [A4+Charts]
MA-Verzeichnis + Standorte Karten/Tabelle: Avatar, Name, Position, Team, Standort, Click-to-Call/Mail/Chat · Standorte mit Karte [A2]

Plattform-Admin (admin.hivegrid.de — eigene Shell, interner Polish reicht):

Screen Inhalt Typ
Admin-Dashboard Basis-KPIs: Tenants, aktive User, MRR + System-Health-Ampel + Queue-Status. (Churn/ARPU/Sales-Pipeline — v2) [KPI]
Tenant-Liste + Detail Liste: Name, Slug, Status, Plan, MRR, User-Anzahl · Detail: Stammdaten, Status-Wechsler, Abo-Zusammenstellung (Feature-Konnektoren togglen + Stripe-Positionen — Abo-Baukasten!), Trial-Verlängerung, Notizen (Markdown, gepinnt), Impersonate mit Begründungs-Pflicht [A2/A3+A6]
Manuelle Tenant-Anlage Name, Slug, Branche, Admin-Email, Initial-Module, Trial-Dauer, Demo-Daten-Häkchen, Begründung [A4]
User-Liste + Detail Email, Name, Tenants, 2FA-Status, Sessions · Ops: 2FA-Reset, Session-Revoke, Deaktivieren [A2/A3]
Feature-Flags [/admin/feature-flags] Flag-Liste (Key, Status, Targeting), Filter-Editor (plan-tier!), Tenant-Override mit Ablauf. (Massen-Statistik — v2) [A2+A6]
Health + Worker-Queues Service-Ampeln (Web/API/Worker), DB/Redis, Storage · BullMQ-Queues: Active/Waiting/Failed je Queue, Job-Detail mit Error-Stack, Retry/Pause [A2+KPI]
Support-Inbox Tickets: Betreff, Tenant, Status, Priorität, Zugewiesen · Detail: Konversation, Antwort (Markdown), interne Notiz · speist sich aus Feedback-Widget! [A2/A3]
Admin-Audit Cross-Tenant-AuditLog mit Filter + Export [A2]

(Entfällt v1: AdminUser-/AdminRole-Verwaltung, Plattform-Lead-Pipeline + Deal-Kanban, KWP-Sync-Status — alles v2.)

§4 PAKET Mi 01.07. — Plantafel + Chat

Screen [Route] Inhalt Typ
📱 Plantafel [/projects/plantafel] Desktop: Y = Mitarbeiter, X = Zeit (Tag/Woche/Monat) · Einträge: Projekt-Titel, Status-Farbe, Adresse-Kurzform · Drag&Drop verschieben/resizen · Konflikt-Indikatoren (Doppelbelegung, Urlaub/krank aus HR!) · MA-Filter, Projekt-Filter · Monteur-Mobil-Modus: „Meine Termine heute" — Liste mit Adresse + Navigations-Link, Tap-Statuswechsel (bestätigt→unterwegs→fertig), offline-fähig + „Meine Woche" kompakt BESPOKE (höchste Priorität nach Flow-Editor)
Projekt-Kanban (Auftrags-Sicht) + Liste [/projects?pipeline=…] Derselbe Projekt-Kanban (Pipeline typ_hint=auftrag), Karten zusätzlich: Mitglieder-Avatare (PL hervorgehoben), Zeitraum, Mängel-Marker · Status-Wechsel mit Abnahme-Pflicht-Block [Kanban-Reuse]
📱 Projekt-Detail [/projects/:id] EIN Projekt-Datensatz (gleiche Route/Entität wie Sales-Sicht §3). Stammdaten, Lead-Herkunft-Hinweis (konvertiert_aus_lead_id), PL + Mitglieder (ProjektMitglied) mit Rollen, Tabs: Übersicht/Mitglieder/Tasks/Termine/Rechnungen/Dateien/Formulare/Abnahmen/Aktivität (inkl. früherer Sales-Status-Historie — derselbe Datensatz, kein read-only Fremd-Objekt) · Mobil-Modus: Stammdaten + heutige Tasks + Abnahme-Button + One-Tap-Foto-Upload · (kein KWP-Felder-Tab — KWP komplett v2) [A3 + 📱-Variante]
📱 Abnahme-Workflow [/projects/:id/acceptance/new] SHK-Abnahme-Formular (Datum, Anwesende, Druckprobe ja/nein+Wert, Funktionsprüfung, Zählerstände, Dokumente-Checkliste, Mängel-Repeater mit Foto je Mangel, Bemerkungen) → Mängel-Klassifizierung (kritisch/klein/kosmetisch) → Touch-Unterschriften Kunde + Monteur → PDF + Auto-Email · offline-fähig, Sync bei Verbindung BESPOKE-Mobile
Chat [/chat] Channel-Index: Name, Avatar, Snippet (80 Z.), Unread-Badge, Mention-Marker, Pin/Mute, Projekt-Stage bei Projekt-Chats · Channel-Detail: Verlauf mit Datums-Separatoren, Nachricht = Avatar+Name+Zeit, Markdown-Body, Reactions (Emoji+Count), Thread-Indikator, Anhänge inline, Edited-Marker, „X von Y gelesen" · Composer: Markdown, Emoji, @-Mention, Anhang, Entwurf-Autosave · Tipp-Indikator · Thread-Detail-Ansicht · Pinned-Übersicht (max 50) · Mentions-Aggregat · Cross-Channel-Suche · Neuer Channel/DM-Modal · Channel-Settings (Mitglieder, Archiv) · Admin: DM-Audit mit Begründungs-Pflicht-Banner BESPOKE

§5 PAKET Fr 03.07. — Flow-Editor, Dashboard, Booking, Kalender

Screen [Route] Inhalt Typ
Flow-/Node-Editor [/automations/:id/edit] Graph-Canvas: Knoten + Kanten, Knoten-Katalog nach Modul (Trigger: CRM/Sales/Projekte/Email/Forms/Kalender/Zeit/Webhook · Aktionen: CRM/Notification/HTTP/Task/If-Else/Delay/Loop) · Konfigurations-Panel je Knoten mit Klartext-Label · Mini-Map, Zoom, Undo/Redo · Dry-Run-Vorschau: „trifft X Datensätze, sendet an: [Liste]" + Bestätigungs-Pflicht · Sprach-zu-Automation: Text-/Spracheingabe-Feld → KI baut Flow-Vorschau → User bestätigt (nie Auto-Aktivierung!) · Loop-Guard-Warnmodal mit Abhängigkeits-Graph BESPOKE — schwerste UI der App, ab 22.06. täglich 1h
Automation-Liste + Executions Liste: Name, Trigger, Status, Läufe (30d) · Execution-Detail: Step-by-Step-Verlauf mit Klartext je Schritt, Dauer, 24h-Rückgängig-Button, Retry [A2/A3]
Template-Katalog [/automations/templates] SHK-Vorlagen nach Kategorie mit Beschreibung + Use-Case, „Verwenden"-Button [A2]
Dashboard [/dashboard] 3 feste Rollen-Layouts (kein Drag&Drop!): GF: Begrüßung, Sales-KPIs, Umsatz-Forecast (einfach), Projekt-KPIs, Auslastung, offene Mängel, Team-heute · Büro: Begrüßung, Projekt-KPIs, meine Tasks, Anrufe heute, HR-Anträge · Monteur 📱: meine Termine heute, meine Projekte, meine Tasks · Widgets: KPI-Kachel, Liste, Trend-Chart · Edit = nur Widget-Filter/Zeitraum konfigurieren [KPI+Widget-Compose]
Cmd+K-Suche [global] Modal: Live-Suche (300ms debounce), Treffer gruppiert nach Entity-Typ mit Icon, Titel, Kontext-Snippet mit Match-Highlight, Tastatur-Navigation · Leer-Zustand: letzte Suchen · Vollbild-Variante [/search] mit Filter-Sidebar (Typ, Datum, Verantwortlicher, Tags) + Trefferzahl BESPOKE (klein)
🌐 Booking-Page [/b/{tenant}/{slug}] Slot-Picker (Kalender-Grid mit freien Slots, timezone-aware), Intake-Formular (M05), mCaptcha, Bestätigung + Add-to-Calendar (.ics) · Tenant-Logo · iFrame-Embed-Variante BESPOKE-Public (höchster Polish!)
Buchungen intern [/bookings] Liste: Termin, Endkunde, Page, Status, Mitarbeiter · Detail: Daten, Form-Antworten, Kalender-Status · Ops: stattgefunden/No-Show markieren, Storno mit Begründung + Auto-Mail, Verschieben mit Slot-Picker, Mitarbeiter-Re-Assignment (M129 voll!) [A2/A3]
Booking-Page-Editor + Verfügbarkeit Grunddaten, Dauer, Mitarbeiter-Auswahl (eine Zuteilungs-Strategie: „erster freier"), Bestätigungs-Mail-Template, Intake-Form-Wahl, Embed-Code · Verfügbarkeit: Wochenregel-Tabelle + Ausnahme-Daten [A6+A4]
Kalender [/calendar] Monats-/Wochen-Grid mit Terminen aus Google-Sync + HiveGrid-Quellen (Booking, Plantafel) · Verbindungs-Settings: Google-Connect-Card, Kalender-Auswahl, Sync-Richtung, Konflikt-Log (kein Outlook — v2) BESPOKE (mittel)
Signatur-Wizard [im Projekt] PDF-Upload → Unterzeichner (Name, Email, Reihenfolge) → Provider (PandaDoc) → Senden · Status-Tracking je Unterzeichner (entwurf/gesendet/angesehen/signiert/abgelehnt) + Erinnerung + Widerruf [A5+A6]

§6 PAKET Mo 06.07. — KI, Telefonie-Reste, Billing, DSGVO (Compose)

Screen Inhalt Typ
KI-Settings [/admin/ai] Use-Case-Toggles, Modell-Wahl (Mistral), Token-Limit, EU-Datenresidenz-Klartext [A6]
AI-Credits [/admin/usage/ai] Saldo, Verbrauch je Use-Case (Donut), Verlauf, Top-User, 80%-Warnbanner, Hochrechnung [KPI+Charts]
AirCall-Setup + Anrufe Connect-Card + User-Binding (AirCall-User ↔ HiveGrid-User mit Auto-Match) · Anruf-Liste: Nummer, Richtung, Dauer, gematchter Kontakt, Notiz-Snippet · Anruf-Detail: Match-Override, Notiz-Editor (Markdown), Aufnahme-Link · Click-to-Call-Button + eingehender-Anruf-Notification [A6+A2/A3]
Sende-Domain [/settings/integrations/email] Domain-Eingabe, DNS-Records (DKIM/SPF/DMARC) mit Copy-Button, Verifikations-Status-Ampel, 5-Min-Prüf-Indikator · BCC-Logging: Toggle + angezeigte BCC-Adresse + Klartext „Mails erscheinen am Kontakt" (kein Postfach/Inbox/Compose — v2!) [A6]
Abo-Übersicht [/admin/subscription] Basis-Plan + gebuchte Feature-Module als Positionsliste mit Preisen · Status/Trial-Countdown · Verbrauch: Automation-Läufe, AI-Tokens, Speicher mit Quota-Balken · Stripe-Portal-Embed (Rechnungen, Zahlungsmethode) · Pausieren/Kündigen (kein Self-Service-Modul-Toggle — Admin macht das, v2) [A6+KPI]
Demo-Daten [/admin/onboarding/demo-data] Settings-Knopf „Beispieldaten anlegen" (25 Datensätze, Klartext-Liste was kommt) · Demo-Liste mit Zähler + Lösch-Funktion · „Demo ausblenden"-Filter erscheint in allen Listen (kein Wizard, kein KI-Walkthrough — v2) [A6]
Erste-Schritte-Checkliste [/onboarding/checklist] Items mit Status-Häkchen, Klartext, CTA-Link je Item (KWP verbinden → v2-Item ausgeblendet), manuell abhakbar, ausblendbar [A2]
Privacy-Hub [/admin/privacy] Export: Job-Liste mit Status/Progress/Download (72h-Link) · Tenant-Löschung: Multi-Step (Erklärung 30-Tage-Grace → Export-Angebot → Stripe-Hinweis → Passwort+2FA → Slug als Bestätigungs-Phrase) + Grace-Countdown mit Abbruch · Subprozessoren-Tabelle (Name, Land, EU-Marker, Zweck, DPA-Link) · AVV: aktuelle Version als PDF + Akzeptanz-Historie [A2+A5]
User-Daten-Export [/settings/account/data-export] Klartext was exportiert wird, Start-Button, Job-Status mit Download [A6]
Feedback-Widget [global, klein] Schwebender Button → Mini-Form (Kategorie, Text, Screenshot-Häkchen) → landet in Admin-Support-Inbox [A5-klein]

§7 Zähl-Übersicht & Diskussionspunkte

~95 v1-Screens = ~12 BESPOKE (Flow-Editor, Form-Builder + Public-Form, Plantafel, Abnahme, Chat, Sales-Kanban, Kampagnen-Editor, Booking-Page, Kalender, Cmd+K, Dashboard-Compose) + ~83 Archetyp-Composes (Stunden-Arbeit nach D0).

Offene Punkte (Raffael entscheiden):

  1. Dashboard-Rollen-Layouts: Spec definiert 7 Presets (auch Vertriebsleiter, Vertriebler, PL, Marketing) — beschlossen sind 3 (GF/Büro/Monteur). Weitere Presets sind nur Widget-Listen (~0 Aufwand) — bei Zeit via Beschleunigungs-Leiter nachschieben oder v2?
  2. KI-Lead-Zusammenfassung (Widget im Kontakt/Projekt-Detail, on-demand): nicht in den 5 v1-KI-Milestones — v2 oder Beschleunigungs-Kandidat?
  3. Notification-Test-Tool (Admin sendet Test-Notification): Mini-Screen, hilft beim Demo-Vorbereiten — drin lassen?

Quellen: 36 Specs _bmad-output/specs/ · Scope-Schnitte #1–#12 (SCOPE-V1-CUTS.md) · Archetypen (DESIGNER-FIRST-PLAYBOOK.md) · Deadlines (TIMELINE.md). Entfallene Screens (Portal, Mobile-PWA, Help-Center, Wizard, Postfach-Inbox, KWP-UI, AdminUser-Verwaltung, Quiet-Hours, Datei-Versionen) sind bewusst NICHT gelistet — v2-Planung erzeugt ihre eigene Map.