Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,32 @@
# AK-DEMO1 · Demo-Tenant + SHK-Demo-Daten für Noah-Demo 1
| | |
|---|---|
| **Typ** | Dev/Daten (Setup — `typ:external`) |
| **Owner** | Akeshan |
| **Phase** | W2-Querschnitt (Demo-Setup, kein Code-Modul) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-26 · Gate W2 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-P19` (Plattform-Admin — Demo-Tenant wird via Admin angelegt), `N-DATEN` (Noahs aufbereitete Geerkens-Beispieldaten)
- **Blocks:** `N-DEMO1` (Noah-Demo #1), `H-DEMO` (Haris' Klick-Demos auf Staging ab Mo 30.06.)
- **Läuft parallel zu:** Akeshans eigene W2-Tickets (AK-P17a/b) — **reine Datenarbeit + Admin-Bedienung, kein Schema-Konflikt**. Nutzt die `is_demo_data`-Flag-Mechanik quer durchs Modell.
## Was zu tun
Einen **klickbaren Demo-Tenant** für Noah-Demo #1 aufsetzen: über den Plattform-Admin (AK-P19) einen Demo-Tenant anlegen, die von Noah aufbereiteten **echten Geerkens-Beispieldaten** (N-DATEN) als **SHK-Seeds** einspielen (Kontakte/Organisationen, Leads, Projekte in Sales- und Auftrags-Pipeline, Aktivitäten, Tasks) und einen sauberen, **klickbaren CRM-Stand** herstellen, den Noah am Fr 26.06. früh demonstrieren kann. Seeds tragen das `is_demo_data`-Flag (löschbar beim Echt-Start).
## Definition of Done
- [ ] **Demo-Tenant via Admin** angelegt (manuelle Tenant-Anlage AK-P19, Branche SHK, Trial)
- [ ] **SHK-Seeds eingespielt** (echte Geerkens-Beispieldaten aus N-DATEN; `is_demo_data`-Flag gesetzt)
- [ ] **Klickbarer CRM-Stand** für Noah verfügbar (auf Staging erreichbar, Fr 26.06. früh)
- [ ] Stabil genug für Haris' Klick-Demos ab Mo 30.06.
## Warum
Noah-Demo #1 (Gate W2) braucht einen realistischen, klickbaren CRM-Stand auf Staging — sonst kein Demo-Beweis und keine Vertriebs-Grundlage. Die Demo nutzt den frisch gebauten Plattform-Admin (AK-P19) als Anlage-Pfad und beweist gleichzeitig die Admin-Tenant-Verwaltung + Auto-SHK-Provisionierung. Validiert außerdem den `is_demo_data`-Lösch-Pfad vor dem Echt-Start.
## Quellen (granular)
- `handouts/akeshan/HANDOUT-AKESHAN.md` → Demo-Setup (AP-6, „CRM-Demo-Daten für Noah-Demo 1 via Admin einrichten", Fr 26.06.)
- abhängig: `AK-P19` (Admin-Tenant-Anlage), `N-DATEN` (Geerkens-Beispieldaten)
- `ENTITY-MODEL.md` → `is_demo_data`-Flag (Entscheidung 16.06., Bulk-Lösch beim Echt-Start) + Domäne 5 (CRM-Kern als Demo-Inhalt)
- `ROADMAP.md` → W2-Gate (Noah-Demo #1)
@@ -0,0 +1,55 @@
# AK-INFRA1 · Infra-Live: Staging + Coolify-Apps + PG/Redis/PgBouncer
| | |
|---|---|
| **Typ** | Dev (Ops/Infra — `typ:external`) |
| **Owner** | Akeshan |
| **Phase** | P1-Querschnitt (Infra-Schiene, kein Code-Modul) |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `EXT-06` (Hetzner-Projekt HiveGrid: S3 + Token + DEK-Master-Key)
- **Blocks:** CI/Gates, **alle Deploys** (ohne Staging kein Demo, kein Gate-Beweis)
- **Läuft parallel zu:** Raffaels `R-P1a`/`R-P1b`/`R-P1c` — **reines Ops, kein Code-Konflikt** (Grobstruktur: Raffael Code SOLO ‖ Akeshan Infra). Keine Schema-Berührung.
- **Konflikt-Risiko:** keines.
## Was wir bauen
Die **lauffähige Staging-Umgebung** auf der Hetzner/Coolify-Schiene (Infra-Stack ADR-009/010): `staging-app` + `staging-api` auf `staging-1`, öffentlich erreichbar aber **gehärtet** (noindex, HMAC-geschützt), plus die **Coolify-managed Datenbank-Schicht** (Postgres, Redis, PgBouncer). Das ist das Deploy-Ziel, gegen das alle Folge-Tickets ausrollen und die W1-Gates beweisen.
## Definition of Done
- [x] `staging-app` + `staging-api` live — `/healthz` 200 + Coolify `running:healthy`. **noindex** implementiert (greift mit nächstem main-Deploy); **HMAC bewusst zurückgestellt** (Owner-Entscheidung 19.06., s.u.)
- [x] Coolify-managed **Postgres** + **Redis** + **PgBouncer** erreichbar — Postgres/Redis Coolify `running:healthy`, pooled DB-Pfad via `/readyz` 200 belegt
- [x] Deploy-Pipeline grün (CI rollt gegen Staging aus) — Live-Revision = `main`-Commit `b8fff6fe`
## Umsetzungsstand / Verifikation (2026-06-19, Owner Raffael)
**Live verifiziert (Coolify-API + HTTP):**
- `hivegrid-web`, `hivegrid-api`, `worker-general` = `running:healthy`; `hivegrid-staging-postgres` + `hivegrid-staging-redis` = `running:healthy`.
- `staging-web.hivegrid.de/healthz` + `/readyz` = 200 (`ready` → Postgres über PgBouncer erreichbar), `staging-api.hivegrid.de` ebenso. TLS gültig (HSTS).
- Deploy-Pipeline rollt `main` aus (Live-Rev `b8fff6fe` = echter main-Commit).
- PgBouncer hat keinen eigenen Coolify-Resource-UUID (vermutlich Sidecar/Teil der PG-URL); der pooled Pfad ist über `/readyz` aber bewiesen.
**Härtung (noindex) — LIVE auf Staging (Deploy `fe1d75b1`, verifiziert):**
- `entry.server.tsx` setzt `X-Robots-Tag: noindex, nofollow` auf jeder SSR-HTML-Antwort, wenn `WEB_NOINDEX=true` (`utils/seo/noindex.server.ts`-Gate). `WEB_NOINDEX=true` auf staging-web in Coolify gesetzt. **Live verifiziert:** `GET /login` → `x-robots-tag: noindex, nofollow`. Das ist der verlässliche noindex-Mechanismus (Suchmaschinen respektieren ihn pro Seite).
- robots.txt bleibt **statisch** (`public/robots.txt`, allow-all, env-unabhängig). Hinweis: Der dynamische `other-routes.server`-Pfad greift im Prod-Server **nicht** (auch das bestehende `/sitemap.xml` 302't dort) — env-abhängige robots.txt wäre also wirkungslos gewesen; der `X-Robots-Tag`-Header erzwingt den noindex ohnehin. Das `other-routes`/`sitemap`-302-Verhalten ist ein **separater, vorbestehender** Befund (kein INFRA1-Blocker).
**Entscheidung 2026-06-20 (Owner) — Staging-Access-Gate (HMAC/Edge-Basic-Auth) bewusst DEFERRED:** Kein
Edge-Schutz für Staging nötig fürs Erste. Begründung: Staging-App liegt hinter Login (Root → 302 `/login`,
verifiziert), `X-Robots-Tag: noindex, nofollow` aktiv (keine Suchmaschinen-Indexierung), keine echten
Kundendaten auf Staging. Ein Edge-Basic-Auth (wie `staging.mitapp.de`) bleibt ein optionaler Folgeschritt,
falls Staging später öffentlich-sensibler wird — **nicht** Teil dieses Tickets. Die DoD-Formulierung
„HMAC-geschützt" gilt damit als bewusst aus dem W1-Scope genommen.
**Status:** **DoD erfüllt — 100 % (W1-Scope).** Staging live: web/api `/readyz` 200 (Migration
UserSession+TrustedDevice angewandt), Postgres/Redis/PgBouncer healthy, CI-Pipeline grün, noindex aktiv.
Staging-Access-Gate bewusst deferred (s.o.). Selbst machbar offen: 0. Ticket auf **Done** (Plane). Owner: Raffael.
## Warum
Ohne Staging + DB-Schicht kein Deploy, kein CI-Gate, keine Noah-Demo. Sessions (R-P2a) brauchen Postgres als Source-of-Truth + Redis-Cache (AD-4); PgBouncer für Connection-Pooling unter RLS (`SET LOCAL app.tenant_id` pro Transaktion).
## Quellen (granular)
- `EXTERNALS-CHECKLISTE.md` → C3/C4 (Staging + Coolify-DB)
- `project_infra_stack` (Memory) → ADR-009/010, Hetzner+Coolify+Cloudflare
- `ROADMAP.md` → Phase 1 (lauffähige Codebasis)
- abhängig: `EXT-06` (S3 + DEK-Master-Key)
@@ -0,0 +1,56 @@
# AK-INFRA2 · DNS + Wildcard-TLS + zentrale Dienste anbinden
| | |
|---|---|
| **Typ** | Dev (Ops/Infra — `typ:external`) |
| **Owner** | Akeshan |
| **Phase** | P1-Querschnitt (Infra-Schiene, kein Code-Modul) |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-18 · Gate W1 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-INFRA1` (Staging + Coolify-Apps + DB müssen erst stehen)
- **Blocks:** `R-P2a` (mCaptcha), `AK-P4a` (ClamAV), `R-P11a` (Meilisearch) — alle drei brauchen die per-ENV angebundenen Zentral-Dienste
- **Läuft parallel zu:** Raffaels P1-Code — **reines Ops, kein Code-Konflikt.** Keine Schema-Berührung.
- **Konflikt-Risiko:** keines.
## Was wir bauen
Die **Netzwerk-/TLS-Schicht** und die Anbindung der **zentral vorhandenen Dienste** (Memory: Meilisearch/mCaptcha/ClamAV zentral verfügbar). Cloudflare-**Wildcard-TLS** `*.hivegrid.de` inkl. `admin.`- und `staging.`-Subdomains (Multi-Host-Topologie aus den URL-Schemata von R-P1a), plus per-ENV-Anbindung von Meili-scoped-Key, mCaptcha und ClamAV an die Apps.
## Definition of Done
- [x] **Meilisearch** (scoped-Key) per ENV angebunden — `MEILI_URL` + `MEILI_API_KEY` auf web/api/worker gesetzt (Coolify, verifiziert 19.06.)
- [x] **mCaptcha** per ENV angebunden — `MCAPTCHA_INSTANCE_URL`/`_ACCOUNT_SECRET`/`_SITEKEY_*` + `CAPTCHA_FAIL_OPEN` gesetzt; live: `captcha.saas-ctrl.com`
- [x] **ClamAV** per ENV angebunden — `CLAMAV_HOST` (10.42.0.4, privates Netz) + `CLAMAV_PORT` gesetzt
- [x] **TLS + Subdomains** für Multi-Host-Architektur — **Staging:** `staging-web`/`staging-api` lösen auf, TLS gültig (HSTS). **Prod (erledigt 20.06. via Prod-Rollout):** `app./api./admin./captcha./coolify.hivegrid.de` lösen auf, alle mit gültigem TLS (`app/api/captcha` CF-proxied, `admin/coolify` Traefik+LE). **Bewusst KEINE `*`-Wildcard**, sondern explizite A-Records pro Subdomain — die ticket-doc selbst warnte vorm Wildcard-Fehlrouting; einzelne Records sind sauberer + zielgenau auf die Prod-IPs.
## Umsetzungsstand / Verifikation (2026-06-19, Owner Raffael)
**Verifiziert (Coolify-ENV + Cloudflare-DNS via dig/API):**
- Zentral-Dienste mCaptcha/Meilisearch/ClamAV auf web/api/worker **per ENV gebunden** (3/3).
- TLS auf Staging gültig (HSTS); `staging-web`/`staging-api` → A `46.225.5.93` (dns-only). Admin = `staging-web` (ADMIN_APP_HOST==WEB_APP_HOST) → kein eigener Host nötig.
- **Kein** Wildcard `*.hivegrid.de`; `app./admin./portal.` lösen nicht auf (Prod offen).
**Bewusst vertagt → Prod-Rollout (kommt direkt im Anschluss):** Wildcard + echte Prod-Subdomains
(`app./admin./api./portal.` → Prod-IPs). Ein Wildcard auf eine Staging-/Marketing-IP würde Prod-
Subdomains fehlrouten, deshalb hier KEINE Records angelegt. **Topologie-Überlegung (Raffael, 19.06.):**
Prod evtl. unter **eigenem Hetzner-Account** (saubere Trennung Staging/Prod) — betrifft dann DEK-Master-Key,
Object-Storage-Bucket und v.a. die Erreichbarkeit der heute privat adressierten Zentral-Dienste
(ClamAV `10.42.0.4`, interne PG/Redis-URLs). Entscheidung + ggf. ADR beim Prod-Rollout.
**Update 2026-06-20 — Prod-Subdomains live (DoD 4/4 erfüllt → 100 %):** Mit dem Prod-Rollout (eigener
Hetzner-Account + eigenes Coolify, ADR-024 / infra ADR-016) sind die echten Prod-Subdomains live mit
TLS: `app./api./admin.hivegrid.de` (Apps), `captcha.hivegrid.de` (mCaptcha), `coolify.hivegrid.de`
(Coolify-UI). Zentral-Dienste auf Prod neu angebunden (Meili/ClamAV/mCaptcha auf der worker-VM über
das private Netz, nicht mehr `10.42.0.4`). Voller Ablauf: `docs/ops/prod-rollout-hivegrid.md`.
**Status:** **DoD 4/4 erfüllt — 100 %.** Staging-Scope (W1) + Prod-Subdomains+TLS beide live. Selbst
machbar offen: 0. (Estate-Doku im infra-Repo nachgezogen: README-DNS + ADR-016.)
## Warum
Die Multi-Host-Architektur (App/Admin/Portal getrennte Subdomains, R-P1a) braucht Wildcard-TLS. Die drei Zentral-Dienste sind harte Vorbedingungen: mCaptcha (Login ab 3. Fehlversuch), ClamAV (Upload-Scan), Meilisearch (Suche P11). Anbindung per ENV statt eigener Deployments (Dienste laufen zentral).
## Quellen (granular)
- `EXTERNALS-CHECKLISTE.md` → C1/C2/C5 (DNS/TLS + Zentral-Dienste)
- `project_infra_stack` (Memory) → Meilisearch/mCaptcha/ClamAV zentral vorhanden, Cloudflare
- `docs/INTEGRATION-CONTRACTS.md` (URL-Schemata / Subdomains aus R-P1a)
- abhängig: `AK-INFRA1`
@@ -0,0 +1,53 @@
# AK-P14a · P14 Sende-Domain-Verifikation + BCC-Brücke + Tracking
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P14 — Email & Marketing |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · fällig 2026-06-28 · Gate W3 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `EXT-02` (Mailjet Sende-Domain SPF/DKIM/DMARC + Warm-up), `R-P6` (CRM-Kern — Mails/Activity hängen am Kontakt)
- **Blocks:** `AK-P14b` (Marketing setzt verifizierte Domain + Tracking-Infra voraus)
- **Läuft parallel zu:** Raffaels Kern-Kette (P7/P8 Lead/Projekt). **Schema-isoliert** über eigene `prisma/schema/email.prisma` (AD-21); berührt `crm.prisma` nur für die `related_kontakt/projekt_id`-Relation und schreibt in den `Activity`-Stream (R-P6). **Sync-Punkt:** R-P6 (Activity am Kontakt) muss stehen, bevor BCC-Logging andocken kann.
- **Konflikt-Risiko:** gering — additive Tabellen + polymorpher Activity-Write; keine Änderung am CRM-Schema.
## Was wir bauen
Das **v1-Fundament der Email-Welt** (Postfach-Sync ist v2 → P23): pro Mandant eine eigene **Sende-Domain** mit DKIM/SPF/DMARC-Records, Copy-Buttons, 5-Min-Auto-Probe und Status-Ampel (pending/verifying/verified/failed) inkl. Klartext-Fehler nach 7 Tagen. Dazu die **BCC-Logging-Brücke** (`crm@<tenant>…` als BCC → in Gmail/Outlook geschriebene Mails erscheinen als `Activity` am Kontakt, **kein OAuth**), eine **Tenant-Inbound-Adresse** (eingehende Mails → Lead/Activity) und das **Email-Tracking** (Delivery-Status, Open/Click, Bounce-Handling mit Suppression-Eintrag). Versand läuft über **Mailjet** (AD-6, SMTP-Provider-Abstraktion ohne US-Kern-Abhängigkeit). Ohne verifizierte Domain kein Marketing-Versand (Gate für AK-P14b).
## Benötigte Screens (Backend bedient — Design liefert `D-KAMP` + `D-P14`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Sende-Domain [`/settings/integrations/email`] | Domain-Eingabe, DNS-Record-Karten (DKIM/SPF/DMARC) mit Copy, Status-Ampel + 5-Min-Prüf-Indikator + 7-Tage-Klartext-Fehler, **BCC-Logging-Toggle** + angezeigte BCC-Adresse + Klartext „Mails erscheinen am Kontakt" |
| Sender + Suppression [`/email-marketing/senders`] | Sender (From-Name/-Email, Domain-DKIM-Status, Default-Marker) · Suppression-Liste (Adresse, Grund Bounce/Beschwerde/manuell) |
## Definition of Done
- [ ] Sende-Domain pro Mandant: DKIM/SPF/DMARC-Records mit Copy, **5-Min-Auto-Probe**, Status-Ampel, Klartext-Fehler nach 7 Tagen
- [ ] **BCC-Logging-Brücke**: Toggle + Anzeige der BCC-Adresse; in nativen Clients geschriebene Mails → `Activity` am Kontakt (kein OAuth)
- [ ] **Tenant-Inbound-Adresse**: eingehende Mails → Lead/Activity
- [ ] **Email-Tracking** + Delivery-Status + Open/Click (IP anonymisiert) + Bounce-Handling → Suppression-Eintrag
- [ ] SMTP-Provider-Abstraktion (Mailjet, AD-6) ohne US-Kern-Abhängigkeit
- [ ] Konnektor `tenantHasModule('email')` (Sidebar + Routes + Actions gated)
- [ ] RLS auf allen Tenant-Tabellen; `is_demo_data` auf seedbaren Sendern/Templates
## Technische Bausteine
- **Entities** (eigene `prisma/schema/email.prisma`): `TenantSendingDomain` (DKIM/SPF/DMARC-Records, verification_status — **[verschlüsselt][Soft-Delete]**), `TenantInboundAddress` (local_part, purpose lead_inbox/bcc_logging/reply_routing), `Email` (purpose, from_sender_id, delivery_status, related_kontakt/projekt_id), `EmailSender`/`EmailTemplate` (is_default), `EmailSuppressionList` (email_address unique, reason). `crm.prisma` nur für `related_kontakt/projekt_id`-Relation berühren (AD-21).
- **Activity-Write**: BCC-Logging + Inbound erzeugen `Activity` (polymorph `subject_type/id`, `actor_kind=system`) im Stream aus R-P6.
- **RLS** auf allen Tabellen außer keine; **OAuth/Provider-Credentials** über per-Tenant-DEK verschlüsselt (AD-8).
- **Auto-Probe** als BullMQ-Scheduled-Job (DNS-Lookup DKIM/SPF/DMARC), Status-Übergänge in Klartext.
- **Inbound-/Bounce-Webhooks** (Mailjet) → Signatur-Check → Lead/Activity bzw. Suppression.
- **Konnektor** `tenantHasModule('email')`; `is_demo_data` auf Demo-Sendern/-Templates.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 8: Kommunikation** (TenantSendingDomain, TenantInboundAddress, Email, EmailSender/Template, EmailSuppressionList)
- `REQUIREMENTS.md` → `REQ-email-datenmodell` (v1-Teil: Sende-Domain + Inbound), `REQ-marketing-versand` (SMTP-Abstraktion Mailjet) · v2-Cut: `REQ-email-sync-strategie`/`REQ-email-inbox-view`
- `ROADMAP.md` → Phase 14 · `PHASE-SOURCES.md` → Phase 14 (M099-email-tracking-bounces; Sende-Domain aus M096 herausgelöst, v1-Pflicht; BCC-Brücke neu)
- `designer-briefs/P14-email-marketing.md` (Sende-Domain-Card, BCC-Toggle, Suppression)
- `_bmad-output/specs/M09-email-inbox.md` (nur Sende-Domain/Inbound/BCC — Rest v2)
## Dev-Nachzug (nach Davids `D-KAMP`/`D-P14`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P14a` aktualisiert
@@ -0,0 +1,55 @@
# AK-P14b · P14 Email-Marketing (Kampagnen + A/B)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P14 — Email & Marketing |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · fällig 2026-06-29 · Gate W3 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-P14a` (verifizierte Sende-Domain + Tracking-Infra + Suppression)
- **Blocks:** — (Endpunkt der Email-Schiene)
- **Läuft parallel zu:** Raffaels Kern-Kette. Eigene `prisma/schema/email.prisma` (gleicher Namespace wie AK-P14a, additive Tabellen — AD-21); Segmente lesen CRM-Kontakte read-only (R-P6). **Sync-Punkt:** R-P6 (Kontakt/Tag/Custom-Feld) muss stehen, damit Segment-Filter auflösen.
- **Konflikt-Risiko:** keines auf Schema-Ebene; CRM nur lesend.
## Was wir bauen
Das **vollständige DSGVO-konforme Email-Marketing** (bleibt VOLL inkl. A/B): ein mehrstufiger **Kampagnen-Builder** (Basis → Inhalt mit Rich-Text/HTML-Toggle + Personalisierungs-Tokens inkl. Custom-Felder + Pflicht-Footer-Auto-Injektion + Desktop-/Mobile-Vorschau → Empfänger → Test-Versand → Zeitpunkt → Bestätigung mit Klartext-Checkliste), **Segmente** mit verschachteltem AND/OR-Filter-Baum und Auto-Exclusion, **Double-Opt-In**, **One-Click-Unsubscribe** + List-Unsubscribe-Header, eine **BullMQ-Versand-Engine** mit Rate-Limiting/Throttling/geplantem (timezone-aware) Versand, **Reporting** (Open/Click/Bounce/Abmeldung, Klick-Map) und **A/B-Varianten**. Versand wird bei rotem Pflicht-Check (Domain/Unsubscribe/Impressum) **blockiert**.
## Benötigte Screens (Backend bedient — Design liefert `D-KAMP` + `D-P14`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Kampagnen-Editor [`/email-marketing/campaigns/new`] | Mehrstufiger Wizard (Basis/Inhalt/Empfänger/Test/Zeitpunkt/Bestätigung), Token-Einfügen, Pflicht-Footer, Vorschau, Pflicht-Checkliste mit Versand-Blockade — **BESPOKE** |
| Kampagnen-Liste + -Detail [`/email-marketing/campaigns`] | Liste (Status/Empfänger/Datum/Stats); Detail mit KPI-Header, Klick-Map, Pro-Empfänger-Tabelle, A/B-Vergleich |
| Segmente [`/email-marketing/segments`] | Verschachtelter AND/OR-Filter-Baum, Live-Empfänger-Anzahl, Auto-Exclusion-Aufschlüsselung, Sample-Vorschau, dynamisch/statischer Snapshot |
| Templates [`/email-marketing/templates`] | Template-Liste, Vorschau, als Ausgangspunkt verwenden |
| 🌐 Unsubscribe-Page [`/unsubscribe/{token}`] | Bestätigungs-Button, optionale Grund-Auswahl, Erfolgs-Meldung, Tenant-Branding |
## Definition of Done
- [ ] **Block-/Rich-Text-Editor** + Personalisierungs-Tokens (auch Custom-Felder) + Pflicht-Footer-Auto-Injektion + Desktop-/Mobile-Vorschau
- [ ] **Segmente**: verschachtelter AND/OR-Filter-Baum, Live-Auflösung, Auto-Exclusion (Unsubscribe/Suppression/kein Opt-In/archiviert/keine Email), dynamisch vs. statischer Snapshot
- [ ] **Versand-Engine** (BullMQ, Rate-Limit, Throttling, geplanter timezone-aware Versand)
- [ ] **Double-Opt-In** (aus Form-Submissions) + **Suppression-Check vor jedem Versand** + **One-Click-Unsubscribe** + List-Unsubscribe-Header
- [ ] **Pflicht-Checkliste** vor Versand (Domain verifiziert / Unsubscribe / Impressum / Subject / >0 Empfänger / Daily-Cap) — Block + Fix-Link bei rotem Check
- [ ] **Reporting** (Open/Click/Bounce/Abmeldung in %, Klick-Map, Pro-Empfänger) + **A/B-Varianten**
- [ ] Konnektor `tenantHasModule('email')`; RLS auf allen Tenant-Tabellen; `is_demo_data` auf Demo-Kampagnen/-Segmenten/-Templates
## Technische Bausteine
- **Entities** (eigene `prisma/schema/email.prisma`): `Campaign` (subject, template_id, sender_id, recipient_segment_id, status, delivered/opened/clicked_count), `OutboundEmail` (campaign_id, recipient_kontakt_id, tracking_token, unsubscribe_token, delivery_status), `OutboundEmailOpen`/`Click`, `RecipientSegment` (entity_type, filter_definition JSONB, is_static_snapshot), `Unsubscribe` (kontakt_id, scope, reason). `crm.prisma` nur lesend (Kontakt/Tag/CustomFieldValue).
- **Versand** über BullMQ mit Provider-Abstraktion (Mailjet, AD-6), Rate-Limit-Worker, timezone-aware Scheduling.
- **Segment-Engine**: JSONB-Filter → typsicherer Query-Builder gegen CRM (read-only), Auto-Exclusion gegen `Unsubscribe`/`EmailSuppressionList` aus AK-P14a.
- **RLS** überall; **Tracking** mit IP-Anonymisierung.
- **Konnektor** `tenantHasModule('email')`; `is_demo_data` auf seedbaren Demo-Daten.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 8: Kommunikation** (Campaign, OutboundEmail +Open/Click, RecipientSegment, Unsubscribe)
- `REQUIREMENTS.md` → `REQ-marketing-datenmodell`, `REQ-marketing-double-optin`, `REQ-marketing-versand`
- `ROADMAP.md` → Phase 14 · `PHASE-SOURCES.md` → Phase 14 (M100-editor, M101-segmente, M102-versand-engine, M103-ab-tests-reporting, M104-unsubscribe-bounces — Marketing bleibt VOLL inkl. A/B)
- `designer-briefs/P14-email-marketing.md` (Kampagnen-Editor BESPOKE, Segmente, Unsubscribe-Page)
- `_bmad-output/specs/M10-email-marketing.md`
## Dev-Nachzug (nach Davids `D-KAMP`/`D-P14`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P14b` aktualisiert
@@ -0,0 +1,55 @@
# AK-P15a · P15 Telefonie (AirCall)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P15 — Telefonie & Team-Chat |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · fällig 2026-07-01 · Gate W3 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `EXT-08` (AirCall-Account/OAuth-App), `R-P5` (Apps-Engine — Telefonie läuft als `DataConnection`), `R-P6` (CRM — Auto-Lead bei unbekannter Nummer, Match auf Kontakt/Lead/Projekt + Activity)
- **Blocks:** `AK-P15b` (Team-Chat)
- **Läuft parallel zu:** Raffaels Kern-Kette. **Sync-Punkt R-P5** (~21.06.): Telefonie ist ein Adapter *hinter* der Apps-Engine — DataConnection/OAuth-Verschlüsselung/Health-Monitoring kommen von dort, nicht selbst gebaut. Eigene `prisma/schema/telephony.prisma` (AD-21). Match/Auto-Lead braucht R-P6 (Kontakt/Lead).
- **Konflikt-Risiko:** gering — additive Tabellen; `apps.prisma` + `crm.prisma` nur lesend für Relationen.
## Was wir bauen
Den **AirCall-Adapter** als Referenz-Implementierung hinter dem `TelephonyProviderInterface` (HalloPetra dockt v2 an → P33): **Click-to-Call** und **Inbound-Anrufe** über eine Apps-Engine-`DataConnection` (verschlüsselte OAuth-Tokens, Webhook-Secret). Unbekannte Nummern legen automatisch einen **Lead** an, bekannte werden auf Kontakt/Lead/Projekt **gematcht** (Hard/Soft mit Confidence + Override). Anrufe landen im **Activity-Stream** (in/out/verpasst), nach dem Anruf gibt es einen **Markdown-Notiz-Editor** (Whisper-Diktat ist v2) und eine Recording-Anzeige. **Anruf-Events** stehen als Automation-Trigger bereit (verpasster Anruf → Rückruf-Aufgabe, verdrahtet in P12).
## Benötigte Screens (Backend bedient — Design liefert `D-CHAT` + `D-P15`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| AirCall-Setup [`/settings/integrations/telephony`] | Connect-Card (Status-Ampel connecting/active/error/revoked + Klartext), **User-Binding-Liste** (AirCall-User ↔ HiveGrid-User mit Email-Auto-Match + manueller Korrektur), „Verbindung testen", Trennen mit Bestätigung |
| Anruf-Liste + -Detail [`/calls`] | Liste (Nummer/Richtung/Dauer/gematchter Kontakt mit Confidence/Notiz-Snippet/verpasst-Marker); Detail mit **Match-Override**, Markdown-Notiz-Editor, Aufnahme-Link, Click-to-Call + eingehender-Anruf-Notification |
*(Click-to-Call-Buttons leben außerdem in Kontakt-/Lead-/Projekt-Detail aus P6/P7/P8.)*
## Definition of Done
- [ ] **AirCall-Connect** (OAuth, verschlüsselte Tokens, Webhook-Secret) **über die Apps-Engine** mit Klartext-Status-Diagnose
- [ ] **User-Bindings** mit Email-Auto-Match-Vorschlag + manueller Zuordnung
- [ ] **Click-to-Call** aus Kontakt-/Lead-/Projekt-Detail; Mehrfach-Nummern → Auswahl-Modal; Klartext-Edge-Cases (kein Binding / keine Connection / API-Fehler / ungültige Nummer); `tel:`-Fallback ohne Connection
- [ ] **Inbound**: Auto-Match (Hard/Soft mit Confidence), unbekannte Nummer → **Auto-Lead**, Push-Notification beim Klingeln
- [ ] **Anruf-Logging** in Activity-Stream + Markdown-Notiz-Editor + Recording-Anzeige + Match-Override
- [ ] **Anruf-Events als Automation-Trigger** (verpasster Anruf → Rückruf-Aufgabe — Verdrahtung P12)
- [ ] `TelephonyProviderInterface` mit AirCall als **Referenz-Adapter** (HalloPetra dockt v2 an)
- [ ] Konnektor `tenantHasModule('telephony')`; RLS auf allen Tenant-Tabellen
## Technische Bausteine
- **Entities** (eigene `prisma/schema/telephony.prisma`): `TelephonyConnection` (provider aircall, oauth_token **verschlüsselt**, webhook_secret — max. 1 aktiv/Tenant), `TelephonyUserBinding` (tenant_user_id ↔ provider_user_id), `TelephonyCallSession` (direction, status, from/to_number E.164, matched_kontakt/lead/projekt_id polymorph, note, recording_url), `TelephonyWebhookEvent` (event_type, signature_valid, [append-only][30d]). `apps.prisma`/`crm.prisma` nur lesend für Relationen (AD-21).
- **Telefonie = Apps-Engine-Adapter** (R-P5): DataConnection-Lifecycle/OAuth-Verschlüsselung/Health vom Framework; hier nur der `TelephonyProviderInterface`-Adapter.
- **Webhook-Verarbeitung** mit Signatur-Check; Match-Heuristik (E.164-Normalisierung, Hard/Soft).
- **Activity-Write** (in/out/verpasst) + Automation-Trigger-Emit.
- **RLS** überall; OAuth per-Tenant-DEK (AD-8, via Apps-Engine). `is_demo_data` auf Demo-Anrufen.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 8: Kommunikation** (TelephonyConnection/UserBinding/CallSession/WebhookEvent; HalloPetra = v2)
- `REQUIREMENTS.md` → `REQ-telefonie-datenmodell`, `REQ-telefonie-provider-adapter`
- `ROADMAP.md` → Phase 15 · `PHASE-SOURCES.md` → Phase 15 (M106-aircall, M107-anruf-eingang, M108-anruf-ausgang, M109-voicemail-notizen; M105 HalloPetra → v2)
- `designer-briefs/P15-telefonie-chat.md` (AirCall-Setup, Anruf-Liste/Detail, Provider-Interface)
- `_bmad-output/specs/M12-telefonie.md`
## Dev-Nachzug (nach Davids `D-CHAT`/`D-P15`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P15a` aktualisiert
@@ -0,0 +1,57 @@
# AK-P15b · P15 Team-Chat (Realtime)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P15 — Telefonie & Team-Chat |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · fällig 2026-07-02 · **Gate W3 (Demo 2)** |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-P15a` (P15-Vorlauf), `AK-P4a` (Files — Chat-Anhänge via FileEntityLink)
- **Blocks:** **Demo 2** (Noah-Demo #2, Gate W3)
- **Läuft parallel zu:** Raffaels Kern-Kette. Eigene `prisma/schema/chat.prisma` (AD-21); entity-linked Channels referenzieren Projekt/Deal aus dem CRM-Kern (R-P6/P8) read-only. **Sync-Punkt:** ProjektMitglied-Sync braucht den Projekt-Kern (P8/P9).
- **Konflikt-Risiko:** keines auf Schema-Ebene; `crm.prisma`/`files.prisma` nur lesend.
## Was wir bauen
Den **Real-Time-Team-Chat (Bespoke, AD-9)**: WebSocket-Messaging mit **Presence, Typing-Indicator, Read-Receipts** über Redis-Pub/Sub (Scale-Out), drei **Channel-Typen** (public/private Group, DM, entity-linked Projekt/Deal mit ProjektMitglied-Sync), **@Mentions** (User/Projekt/Deal/Kontakt/Firma) mit Autocomplete, **Threads, Reactions, Pins** (max 50), **File-Uploads** (via Files), Link-Previews, **Mark-as-Task** und **Cross-Channel-Suche**. Mobile-First für Monteure (vereinfachte View, Foto-Direct-Upload, Push). Ein **Admin-Audit-Modus** (`read_all_channels`) erfordert Begründungs-Pflicht je Session + DM-Audit-Banner und wird audit-geloggt.
## Benötigte Screens (Backend bedient — Design liefert `D-CHAT` + `D-P15`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Chat-Index [`/chat`] | Channel-Liste (Snippet, Unread-Badge, Mention-Marker, Pin/Mute/Typ-Indikator, bei Projekt-Chat Stage), Filter, Suche, Channel-Browser (Discover), „Archivierte anzeigen" — **BESPOKE** |
| Channel-Detail [`/chat/:id`] | Verlauf mit Date-Bucket-Separatoren, Nachricht (Markdown/Reactions/Thread-Indikator/Mentions/Anhänge), Read-Receipt, Composer (@-Autocomplete/Datei-Dropzone/Draft-Autosave), Typing-Indikator, Per-Message-Hover-Menü — **BESPOKE** |
| Thread-Detail [`/chat/:id/thread/:thread_id`] | Eltern-Nachricht + Replies (Side-Panel oder Route), eigener Composer |
| Pinned-Übersicht [`/chat/:id/pinned`] · Mentions-Aggregat [`/chat/mentions`] · Cross-Channel-Suche [`/chat/search`] | Pins (max 50), kanalübergreifende Mentions, Volltext-Suche über erlaubte Channels |
| Neuer Channel / DM [`/chat/new`] · Channel-Settings | Group/DM-Modal; Members/Privacy/Archivieren/verlassen |
| Admin-Chat-Übersicht [`/admin/chat`] | Alle Channels + Cleanup; **DM-Audit mit Begründungs-Pflicht-Banner**; Force-Member-Edit/Delete |
## Definition of Done
- [ ] **WebSocket-Real-Time**: Presence, Typing, Read-Receipts, Redis-Pub/Sub (AD-9), Optimistic-UI, Reconnect
- [ ] **3 Channel-Typen**: public/private Group, DM, entity-linked (Projekt/Deal) mit **ProjektMitglied-Sync**
- [ ] **@Mentions** mit Autocomplete + **Threads** + **Reactions** + **Pins** (max 50) + **File-Uploads** (Files) + Link-Previews + **Mark-as-Task**
- [ ] Channel-Index (Filter/Suche/Pin/Mute/Archiv + Channel-Browser) + **Cross-Channel-Suche** + Mentions-Aggregat
- [ ] Entity-linked Channel erscheint im Projekt-/Deal-Detail (P8/P9)
- [ ] **Admin-Audit** (`read_all_channels`): Begründungs-Pflicht je Session + DM-Audit-Banner, audit-geloggt
- [ ] **Mobile-First-Variante** für Monteure (vereinfachte View, Foto-Direct-Upload, Push)
- [ ] Konnektor `tenantHasModule('chat')`; RLS auf allen Tenant-Tabellen
## Technische Bausteine
- **Entities** (eigene `prisma/schema/chat.prisma`): `TeamChat` (kind project/group/dm, projekt_id, archived_reason, last_message_at), `TeamChatMember` (role_in_chat, last_read_message_id, is_pinned), `TeamChatMessage` (author, body Markdown, parent_message_id, mentions[], attachments[]), `TeamChatThread`/`PinnedMessage`/`Reaction`/`Read`. `crm.prisma` (Projekt für entity-linked), `files.prisma` (Anhänge via FileEntityLink) nur lesend (AD-21).
- **Real-Time-Layer**: WebSocket-Gateway + Redis-Pub/Sub für Presence/Typing/Fan-out (AD-9); Read-Receipt-Aggregation „X von Y gelesen".
- **RLS** auf allen Tabellen; Channel-Permission je Typ; Admin-Audit-Read gegated + audit-geloggt (AuditEntry).
- **Mark-as-Task** schreibt in das Tasks-Modul (AK-P4b, EntityLink).
- **Konnektor** `tenantHasModule('chat')`; `is_demo_data` auf Demo-Channels/-Messages.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 8: Kommunikation** (TeamChat/Member/Message/Thread/PinnedMessage/Reaction/Read)
- `REQUIREMENTS.md` → `REQ-chat-datenmodell`, `REQ-chat-realtime`, `REQ-chat-features`
- `ROADMAP.md` → Phase 15 · `PHASE-SOURCES.md` → Phase 15 (M110-channel-permissions, M111-direkt-nachrichten, M112-anhaenge, M113-modul-verknuepfungen, M114-mentions-push — Chat bleibt VOLL)
- `designer-briefs/P15-telefonie-chat.md` (Chat-UI BESPOKE, Admin-DM-Audit, Mobile-First)
- `_bmad-output/specs/M13-team-chat.md`
## Dev-Nachzug (nach Davids `D-CHAT`/`D-P15`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P15b` aktualisiert
@@ -0,0 +1,52 @@
# AK-P16a · P16 Kalender-Sync (Google)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P16 — Kalender, Booking, Forms & Signatur |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-04 · Gate W4 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `EXT-10` (Google-Cloud-Projekt + OAuth-Consent für Calendar-API), `R-P5` (Apps-Engine — Kalender läuft als `DataConnection`)
- **Blocks:** `AK-P16b` (Booking braucht Slot-Verfügbarkeit aus dem Sync)
- **Läuft parallel zu:** Raffaels Kern-Kette. **Sync-Punkt R-P5**: Connection-Lifecycle/OAuth-Verschlüsselung kommen aus der Apps-Engine. Eigene `prisma/schema/calendar.prisma` (AD-21); Termine docken an Projekt-Termine + Plantafel (P9) an.
- **Konflikt-Risiko:** gering — additive Tabellen; `apps.prisma` nur lesend.
## Was wir bauen
Den **bidirektionalen Kalender-Sync mit Google** (Outlook-Adapter → v2, Interface bleibt provider-agnostisch): **CalendarAdapter** mit Auto-Token-Refresh und Webhook-Subscriptions, **pro User** verbunden (nicht pro Tenant). HiveGrid-Termine (Booking/Projekt/Plantafel) gehen extern, externe Events kommen **read-only** für die Verfügbarkeitsberechnung — externe Event-Inhalte leaken **nie** an andere User (Booking sieht nur „belegt von X bis Y"). Konflikte werden per **Last-Write-Wins** aufgelöst und in Klartext ins Konflikt-Log + Notification geschrieben. Eine Kalender-Ansicht zeigt Termine aus allen Quellen mit Quell-Marker.
## Benötigte Screens (Backend bedient — Design liefert `D-BOOK` + `D-P16`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Kalender [`/calendar`] | Monats-/Wochen-Grid mit Terminen aus Google-Sync + HiveGrid-Quellen (Booking, Plantafel, Projekt-Termine), Quell-Marker, Konflikt-Log |
| Kalender-Verbindungen [`/settings/integrations/calendar`] | Google-Connect-Card (Status-Ampel, Konto-Email, letzte Sync), Kalender-Auswahl, Sync-Richtung, Disconnect mit „auch extern entfernen?", Re-Connect-Banner bei Fehler |
| Kalender-Verbindungs-Detail [`/settings/integrations/calendar/:id`] | gewählte Kalender, Sync-Status, Konflikt-Liste (letzte 50, Klartext + Resolution) |
## Definition of Done
- [ ] **Bidirektionaler Google-Sync** (CalendarAdapter, Auto-Token-Refresh, Webhook-Subscriptions); Outlook → v2 (Interface provider-agnostisch)
- [ ] HiveGrid-Termine (Booking/Projekt/Plantafel) gehen **extern**, externe Events kommen **read-only** für Verfügbarkeit
- [ ] **Connection pro User**; externe Event-Inhalte nie an andere User leaken (nur „belegt von X bis Y")
- [ ] **Last-Write-Wins-Konflikt** mit Klartext-Notification + Konflikt-Log (letzte 50)
- [ ] Kalender-Ansicht mit Quell-Markern (HiveGrid + extern)
- [ ] Konnektor `tenantHasModule('calendar')`; RLS auf allen Tenant-Tabellen; OAuth verschlüsselt (AD-8, via Apps-Engine)
## Technische Bausteine
- **Entities** (eigene `prisma/schema/calendar.prisma`): `CalendarConnection` (provider google, oauth_refresh_token **verschlüsselt**, status — **pro User**), `CalendarEvent` (source internal/external_synced, starts/ends_at, is_busy, internal_entity_link polymorph), `CalendarEventMapping` (internal↔external_id), `CalendarSyncCursor` (cursor_token), `CalendarWebhookEvent` (payload). `apps.prisma` nur lesend (DataConnection-Bezug, AD-21).
- **Kalender = Apps-Engine-Adapter** (R-P5): OAuth/Health vom Framework; hier der provider-agnostische `CalendarAdapter` mit Google als erstem Provider.
- **Sync-Infra**: Webhook-Subscription-Renewal-Cron, Cursor-basiertes Delta, Last-Write-Wins-Resolver mit Konflikt-Log + `notify()`.
- **Leak-Schutz**: externe Event-Details nur für den Owner-User; für Verfügbarkeit nur Busy-Slots exponiert.
- **RLS** überall; `is_demo_data` auf Demo-Terminen.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 9: Kalender/Booking/Forms/Signatur** (CalendarConnection v1 Google, CalendarEvent/Mapping/SyncCursor/WebhookEvent)
- `REQUIREMENTS.md` → `REQ-kalender-datenmodell`, `REQ-kalender-sync-adapter` (Outlook-Teil → v2)
- `ROADMAP.md` → Phase 16 · `PHASE-SOURCES.md` → Phase 16 (M118-google-adapter, M119-termin-sync, M120-display-modul-verknuepfung; Outlook v2)
- `designer-briefs/P16-kalender-booking-forms-signatur.md` (Gruppe 1 Kalender-Sync; nur Google v1)
- `_bmad-output/specs/M25-calendar-sync.md`
## Dev-Nachzug (nach Davids `D-BOOK`/`D-P16`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P16a` aktualisiert
@@ -0,0 +1,55 @@
# AK-P16b · P16 Booking (Slots + Verfügbarkeit + Storno)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P16 — Kalender, Booking, Forms & Signatur |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-05 · Gate W4 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-P16a` (Kalender-Sync — Slot-Verfügbarkeit braucht Busy-Slots aus Google)
- **Blocks:** — (Intake-Form-Wahl referenziert AK-P16c, läuft aber im selben Fenster)
- **Läuft parallel zu:** Raffaels Kern-Kette + den anderen P16-Slices (c/d). Eigene `prisma/schema/booking.prisma` (AD-21); Buchung erzeugt Lead/Activity im CRM-Kern (R-P6/P7).
- **Konflikt-Risiko:** gering — additive Tabellen; `crm.prisma`/`calendar.prisma`/`forms.prisma` nur über Relationen berührt.
## Was wir bauen
Öffentliche **Buchungsseiten im Calendly-Stil**: timezone-aware **Slot-Berechnung** aus Verfügbarkeitsregeln, Ausnahmen, Kalender-Sync (AK-P16a) und Puffer/Vorlauf, mit **iFrame-Embed**. Nach der Buchung entsteht ein **Lead** (oder Activity bei Email-Match), eine **FormSubmission** (Intake-Form aus AK-P16c) und eine **Bestätigungs-Email** (.ics/Add-to-Calendar). Nur **eine** Zuteilungs-Strategie „Erster der frei ist" (Round-Robin/Provider-Wahl → v2). Der volle Lifecycle ist v1: **Storno/Verschiebung/Re-Assign/No-Show** (M129 explizit VOLL) inkl. Auto-Mail bei Cancel + Race-Schutz beim Submit.
## Benötigte Screens (Backend bedient — Design liefert `D-BOOK` + `D-P16`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| 🌐 Booking-Page [`/b/{tenant}/{slug}`] | Multi-Step: Slot-Picker (timezone-aware + Wechsler) → Intake-Form → Bestätigung + Add-to-Calendar (.ics), Tenant-Logo, iFrame-Variante — **BESPOKE-Public** |
| Buchungen-Liste [`/bookings`] | Termin/Endkunde/Page/Provider/Status, Tabs Anstehend/Vergangen/Storniert/Alle, Filter, Bulk-Cancel, CSV |
| Buchung-Detail [`/bookings/:id`] | Termin-Daten, verknüpfter Kontakt/Lead, Form-Antworten, Sync-Status-Badge; Aktionen held/no-show, Cancel (Grund + Auto-Mail), Reschedule (Slot-Picker), Provider-Re-Assign |
| Booking-Page-Editor [`/bookings/pages/:id`, `/new`] · Pages-Liste [`/bookings/pages`] | Dauer/Puffer/Vorlauf, Provider-Auswahl, Intake-Form-Wahl, Bestätigungsmail-Template, Publish + Embed-Code-Generator |
| Verfügbarkeit [`/availability`] | Wöchentliche Standard-Regeln (mehrere Zeitfenster/Tag), Datums-Ausnahmen (frei/Custom-Window), Timezone |
## Definition of Done
- [ ] Öffentliche **Booking-Seiten** berechnen Slots **timezone-aware** (Regeln, Ausnahmen, Kalender-Sync, Puffer, Vorlauf)
- [ ] Nach Buchung: **Lead oder Activity** (Email-Match), **FormSubmission**, **Bestätigungs-Email** (.ics) — **Race-Schutz** beim Submit
- [ ] **iFrame-Embed** + Public-URL mit Copy
- [ ] Nur **eine** Zuteilungs-Strategie „Erster der frei ist" (Round-Robin/Provider-Wahl → v2)
- [ ] **Storno/Verschiebung/Re-Assign/No-Show** (M129 VOLL) inkl. Auto-Mail bei Cancel
- [ ] Permission-Bundle `bookings.*` (read_own/read_all/write/admin) serverseitig Owner-gefiltert
- [ ] Konnektor `tenantHasModule('booking')`; RLS auf allen Tenant-Tabellen
## Technische Bausteine
- **Entities** (eigene `prisma/schema/booking.prisma`): `BookingPage` (slug, duration_minutes, assignment_strategy, is_published, intake_form_id), `BookingPageProvider` (M:N User), `AvailabilityRule`/`AvailabilityException`, `Appointment` (provider_user_id, start/end, status scheduled/held/cancelled/no_show/rescheduled, kontakt_id|lead_id, form_submission_id). `calendar.prisma`/`crm.prisma`/`forms.prisma` nur über Relationen (AD-21).
- **Slot-Engine**: kombiniert Regeln/Ausnahmen + Google-Busy-Slots (AK-P16a) + Puffer/Vorlauf, timezone-aware; **Race-Schutz** (Transaction/Lock beim Submit gegen Doppelbuchung).
- **Post-Booking**: Lead/Activity (R-P6/P7) + FormSubmission (AK-P16c) + Bestätigungs-Mail (.ics) via Email (AK-P14a-Versand).
- **Lifecycle**: Cancel/Reschedule/Re-Assign/No-Show mit Status-Übergängen + Auto-Mail.
- **RLS** überall; `bookings.*`-Bundle; `is_demo_data` auf Demo-Pages/-Buchungen.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 9** (BookingPage/Provider, AvailabilityRule/Exception, Appointment)
- `REQUIREMENTS.md` → `REQ-booking-datenmodell`, `REQ-booking-slot-kalkulierung`, `REQ-booking-integrationen`
- `ROADMAP.md` → Phase 16 · `PHASE-SOURCES.md` → Phase 16 (M126-time-slot, M127-verfuegbarkeit, M128-bestaetigung, M129-stornierung — M129 explizit VOLL)
- `designer-briefs/P16-kalender-booking-forms-signatur.md` (Gruppe 2 Booking; eine Zuteilungs-Strategie v1)
- `_bmad-output/specs/M06-booking.md`
## Dev-Nachzug (nach Davids `D-BOOK`/`D-P16`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P16b` aktualisiert
@@ -0,0 +1,54 @@
# AK-P16c · P16 Form-Builder (Editor + Submission + Actions)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P16 — Kalender, Booking, Forms & Signatur |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-06 · Gate W4 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-INFRA2` (mCaptcha + Rate-Limit-Infra für öffentliche Endpunkte), `R-P7` (Lead-Inbox — Post-Submit-Action „Lead anlegen")
- **Blocks:** — (Form-Renderer wird in AK-P16b Intake + AK-P17 HR-Anträge wiederverwendet)
- **Läuft parallel zu:** Raffaels Kern-Kette + den anderen P16-Slices. Eigene `prisma/schema/forms.prisma` (AD-21); Post-Submit-Actions schreiben in CRM/Tasks/Automation. **Sync-Punkt:** R-P7 (Lead) für die `create_lead`-Action.
- **Konflikt-Risiko:** gering — additive Tabellen; Fremd-Schemata nur über Actions/Relationen.
## Was wir bauen
Einen Drag-&-Drop-**Form-Builder auf Google-Forms-Niveau**: **12 Feld-Typen**, **Conditional Logic** („zeige Feld X wenn Y = Z"), Validierung pro Feld, geseedete **SHK-Form-Templates** und Live-Vorschau. Sharing über **öffentliche URL + QR + iFrame** (personalisierte Links / JS-Snippet → v2). Eingehende Submissions feuern **Post-Submit-Actions** mit Field-Mapping und **ActionLog** (Lead/Kontakt/Projekt/Task anlegen, Email an Submitter/Team, Webhook, Automation-Trigger, Auto-Match). Öffentliche Endpunkte sind **Rate-Limit + mCaptcha + DSGVO-Pflicht** abgesichert. Der **Form-Renderer ist wiederverwendbar** (Booking-Intake AK-P16b, HR-Anträge AK-P17).
## Benötigte Screens (Backend bedient — Design liefert `D-FORM` + `D-P16`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Form-Builder-Canvas [`/forms/:id/edit`] | Feld-Palette (12 Typen), Drag-&-Drop-Canvas, Feld-Konfiguration, **Conditional-Logic-Editor**, Live-Vorschau, Publish-Toggle, Sharing (URL/QR/iFrame), Post-Submit-Actions mit Field-Mapping — **BESPOKE** |
| Forms-Liste [`/forms`] | Name/Subtyp/Status/Submissions-Anzahl/letzte Submission; SHK-Templates geseedet |
| 🌐 Öffentliches Formular [`/f/{tenant}/{slug}`] | Gerenderte Felder, Conditional Logic live, mCaptcha, Submit → Erfolgs-Text/Redirect, Tenant-Logo — **BESPOKE-Public** |
| Submissions [`/forms/:id/submissions`] | Antwort-Tabelle (Spalten = Felder), Filter, CSV; Detail: alle Antworten, Submitter-Metadata, **Action-Log mit Re-Run**, File-/Foto-Vorschau, PDF-Export |
## Definition of Done
- [ ] **12 Feld-Typen** + **Conditional Logic** + Validierung pro Feld + geseedete **SHK-Templates** + Live-Vorschau
- [ ] **Embed**: öffentliche URL + QR + iFrame (personalisierte Links / JS-Snippet → v2)
- [ ] **Post-Submit-Actions** (Lead/Kontakt/Projekt/Task, Email, Webhook, Automation-Trigger, Auto-Match) mit **Field-Mapping** + **ActionLog** (Re-Run)
- [ ] **Rate-Limit + mCaptcha + DSGVO-Pflicht** auf öffentlichen Endpunkten; Race-Schutz beim Submit
- [ ] **Form-Renderer als wiederverwendbare Komponente** (Booking-Intake, HR-Anträge)
- [ ] Permission-Bundle `forms.*` (basic/builder/publisher/admin) serverseitig Owner-gefiltert
- [ ] Konnektor `tenantHasModule('forms')`; RLS auf allen Tenant-Tabellen
## Technische Bausteine
- **Entities** (eigene `prisma/schema/forms.prisma`): `Form` (slug, subtype standard/acceptance_form/onboarding/survey, status, is_public), `FormField` (field_key, field_type 12 Typen, required, validation_rules), `FormSubmission` (submission_data JSON, linked_entity_type/id polymorph), `FormFile` (→ File), `FormAction` (action_type send_email/create_lead/create_projekt/webhook/trigger_automation, action_config). `crm.prisma`/`tasks.prisma`/`automation.prisma` nur über Actions berührt (AD-21).
- **Conditional-Logic-Engine** (Wenn-Dann auf field_key) client- und serverseitig validiert.
- **Post-Submit-Pipeline**: Field-Mapping → typsichere Actions → `FormActionLog` (idempotent, Re-Run); Auto-Match auf Kontakt/Lead.
- **Public-Hardening**: mCaptcha + Rate-Limit (AK-INFRA2), DSGVO-Pflichtfelder.
- **RLS** überall (außer öffentlicher Render-Pfad ist read-only auf publizierte Forms); `is_demo_data` auf SHK-Template-Seeds.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 9** (Form, FormField, FormSubmission, FormFile, FormAction; FormLink = v2)
- `REQUIREMENTS.md` → `REQ-form-datenmodell` (FormLink/JS-Snippet → v2), `REQ-form-editor`, `REQ-form-actions`
- `ROADMAP.md` → Phase 16 · `PHASE-SOURCES.md` → Phase 16 (M121-editor, M122-veroeffentlichung gedünnt, M123-submission-eingang, M124-conditional-display, M125-rate-limit-captcha-dsgvo)
- `designer-briefs/P16-kalender-booking-forms-signatur.md` (Gruppe 3 Form-Builder; URL+QR+iFrame v1)
- `_bmad-output/specs/M05-form-builder.md`
## Dev-Nachzug (nach Davids `D-FORM`/`D-P16`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P16c` aktualisiert
@@ -0,0 +1,58 @@
# AK-P16d · P16 Angebot/Signatur (PandaDoc)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P16 — Kalender, Booking, Forms & Signatur |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-07 · Gate W4 |
| **Status** | geplant |
> ⚠️ **Scope-Update (AD-25, 2026-06-21 — Raffael):** Signatur-**Default** ist jetzt der **gehärtete SES-Eigenbau**
> (kein PandaDoc-Zwang), umgesetzt über `defineAdapter` (Adapter `ses-selfhosted`). **PandaDoc bleibt nur als
> optionaler BYOK-Adapter** (`pandadoc-byok`, Tenant bringt eigenen Key) — Anbindungs-Spec in [[EXT-17]]. Dieses
> Ticket bitte entsprechend bauen: **SES als Default** (Touch vor Ort + Fern-Link + OTP + PAdES-Versiegelung +
> Zeitstempel + M001-Audit + Completion-Certificate, s. [[EXT-09]]/[[AD-25]]), **PandaDoc als Opt-in** daneben.
> DoD unten ist noch PandaDoc-zentriert und wird beim Bau gemäß AD-25 auf „SES-Default + BYOK-Adapter" angepasst.
> (Rechtlich: SES genügt im SHK; QES nur § 650h, später via D-Trust.)
## Abhängigkeiten & Parallelität
- **Blocked by:** `EXT-09` (SES-Eigenbau-Spec + Adapter-Modell; PandaDoc nur noch optional via BYOK [[EXT-17]])
- **Blocks:** — (Endpunkt der P16-Schiene)
- **Läuft parallel zu:** Raffaels Kern-Kette + den anderen P16-Slices. **Implizit auf R-P5** (Signatur = `DataConnection` über Apps-Engine) und auf den **Projekt-Kern** (R-P8/P9 — Signatur hängt am `Projekt`, NICHT „Deal"). Eigene `prisma/schema/signature.prisma` (AD-21).
- **Konflikt-Risiko:** gering — additive Tabellen; `apps.prisma`/`crm.prisma`/`files.prisma` nur über Relationen.
## Was wir bauen
**Multi-Signer-Angebots-Signatur über PandaDoc** (DocuSign-Adapter bleibt möglich, läuft über die Apps-Engine M33a): PDF-Upload (aus Files oder neu) → Unterzeichner (Name vorausgefüllt aus Kontakt, Email, Rolle, Reihenfolge sequenziell/parallel) → Senden, mit **Webhook-Verarbeitung** und **Status-Tracking je Unterzeichner** (entwurf/gesendet/angesehen/signiert/abgelehnt), Erinnerung, Widerruf und optionalem Auto-Stage-Wechsel. Das signierte PDF landet in Files. **Pivot-Hart:** Signatur hängt am **`Projekt`-Kern** (`ProjektSignatureDocument`/`ProjektSignatureSigner`), kein eigenes „Deal"-Objekt — Einstieg lebt im Projekt-Detail (P8/P9).
## Benötigte Screens (Backend bedient — Design liefert `D-BOOK` + `D-P16`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Signatur-Wizard [im Projekt-Detail] | PDF-Upload (aus Files/neu) → Unterzeichner (Name aus Kontakt, Email, Rolle, Reihenfolge sequenziell/parallel) → Provider (PandaDoc, Default) → Senden; **Status-Tracking je Unterzeichner** + Erinnerung + Widerruf; Original- + Signed-PDF-Download |
## Definition of Done
- [ ] **PDF-Upload → Multi-Signer via PandaDoc** über die Apps-Engine (M33a)
- [ ] **Webhook-Verarbeitung** + **Status-Tracking pro Unterzeichner** (entwurf/gesendet/angesehen/signiert/abgelehnt)
- [ ] Erinnerung + Widerruf + optionaler Auto-Stage-Wechsel; Signed-PDF landet in Files
- [ ] **Signatur hängt am `Projekt`-Kern** (`ProjektSignatureDocument`/`ProjektSignatureSigner`) — kein „Deal"-Objekt
- [ ] Permission-Bundle `signature.*` (read/send/revoke/admin) serverseitig Owner-gefiltert
- [ ] Konnektor `tenantHasModule('signature')`; RLS auf allen Tenant-Tabellen
## Technische Bausteine
- **Entities** (eigene `prisma/schema/signature.prisma`): `SignatureProviderConnection` (data_connection_id → Apps-Engine!, provider PandaDoc, is_default), `ProjektSignatureDocument` (projekt_id, provider_document_id, source_pdf_file_id, status draft/sent/viewed/signed/declined, signed_pdf_file_id — **[Soft-Delete]**), `ProjektSignatureSigner` (document_id, signer_email/name, linked_kontakt_id, status, signed_at). `apps.prisma`/`crm.prisma`/`files.prisma` nur über Relationen (AD-21).
- **Signatur = Apps-Engine-Connection** (R-P5): OAuth/API-Key + Health vom Framework; hier Provider-Adapter PandaDoc.
- **Webhook-Handler** (Signatur-Check) → Status-Übergänge je Signer + Activity-Write; Auto-Stage-Wechsel über Pipeline (P8/P9, optional).
- **RLS** überall; `signature.*`-Bundle; signiertes PDF via FileEntityLink an den Projekt-Kern.
- **Konnektor** `tenantHasModule('signature')`; `is_demo_data` auf Demo-Dokumenten.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 9** (SignatureProviderConnection, ProjektSignatureDocument/Signer — am Projekt-Kern, AD-20)
- `REQUIREMENTS.md` → `REQ-signatur-datenmodell` (⚠ Bezeichner „Deal" pre-pivot — gilt `Projekt`), `REQ-signatur-provider`
- `ROADMAP.md` → Phase 16 · `PHASE-SOURCES.md` → Phase 16 (M130-erstellung, M131-pandadoc-docusign, M132-status-tracking)
- `designer-briefs/P16-kalender-booking-forms-signatur.md` (Gruppe 4 Signatur; PandaDoc v1, Pivot-Hinweis Projekt-Kern)
- `_bmad-output/specs/M07-angebot-signatur.md` (⚠ teils pre-pivot — ENTITY-MODEL hat Vorrang)
## Dev-Nachzug (nach Davids `D-BOOK`/`D-P16`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P16d` aktualisiert
@@ -0,0 +1,54 @@
# AK-P17a · P17 HR-Kern (Stammdaten, Doku, Passwort-Safe)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P17 — HR-Hub |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-25 · Gate W2 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-P4b` (Files/Tasks + EntityLink — HR-Dokumente hängen an Files)
- **Blocks:** `AK-P17b` (Urlaub/Krank/Surveys)
- **Läuft parallel zu:** Raffaels Kern-Kette (P6/P7). **HR hängt nur an P1/P2** (User/RLS/Verschlüsselungs-Fundament) — KEINE Abhängigkeit von R-P5/R-P6, daher früh in W2 baubar. Eigene `prisma/schema/hr.prisma` (AD-21); `core.prisma` nur für User-Relation berührt.
- **Konflikt-Risiko:** keines auf Schema-Ebene — disjunkte HR-Domäne.
## Was wir bauen
Den **verschlüsselten HR-Kern** (Quiply-Ablösung): **MA-Stammdaten** (HrEmployeeProfile, Standorte), **Personaldokumente** und den **verschlüsselten Team-Passwort-Safe**. Sensible Daten liegen **AES-256-GCM** mit KMS-backed Envelope-Encryption (AD-8) vor; sensible Tabellen haben **zusätzlich** zum RLS einen App-Permission-Layer — Werte werden **nie automatisch angezeigt** (Reveal on-demand + Audit-Eintrag). Strikte Trennung **MA-Sicht** (eigener Bereich, eigene Daten) vs. **HR-Admin-Sicht** (`/admin/hr/...`). Passwort-Safe: Werte nie in der Liste, Reveal/Copy entschlüsselt on-demand mit Permission-Check, Copy mit 30s-Auto-Clear, DSGVO-Export.
## Benötigte Screens (Backend bedient — Design liefert `D-HR`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| HR-Hub-Start [`/hr`] | Angepinnte Announcements, offene Pflichten, eigene Anträge, Team heute (gegated), Geburtstage, Quick-Links, prominente Aktionen |
| MA-Verzeichnis + Detail [`/hr/directory`, `/:userId`] | Karten/Tabelle (Avatar/Name/Position/Team/Standort), Click-to-Call/Mail/Chat; Detail: Stammdaten, Notfallkontakt (nur self/HR), Inline-Edit selbst-pflegbarer Felder, eigene Dokumente |
| Standorte + Detail [`/hr/locations`, `/:id`] | Karten/Tabelle (Name/Adresse/Map/MA-Anzahl/Bild); Admin: anlegen/bearbeiten/Default/Bulk-Reassign |
| Eigene Dokumente [`/hr/my-documents`] | Liste (Titel/Art/Datum/Gültigkeit) + Filter, Upload eigener Dokumente, File-Viewer; vom Büro hochgeladene = read-only |
| Passwort-Safe [`/hr/password-safe`] | Vault-Liste → Eintrags-Liste (Titel/Tags, **keine Werte!**) → Detail mit **Reveal je Wert** (audit-geloggt), Copy mit 30s-Auto-Clear, Access-Verwaltung, Audit-Log |
| Passwort-Safe-Verwaltung [`/admin/hr/password-safe`] | Tenant-weite Vault-Sicht (ohne Inhalts-Access), Vault-Anlage/Archiv/Delete, Access-Verwaltung, Audit-Log-Übersicht |
## Definition of Done
- [ ] **HR-Profile/Dokumente AES-256-GCM** (KMS-Envelope-Encryption, AD-8)
- [ ] **MA-Bereich vs. HR-Admin-Bereich strikt getrennt**; sensible Tabellen zusätzlich App-Permission-gegated
- [ ] **Verschlüsselter Passwort-Safe mit Audit-Trail**: Reveal/Copy entschlüsselt on-demand + Permission-Check + Audit-Eintrag; Werte nie in Liste; Copy mit 30s-Auto-Clear; DSGVO-Export
- [ ] MA-Verzeichnis + Standorte (Admin-CRUD) + eigene Dokumente (Upload + read-only Büro-Uploads)
- [ ] Konnektor `tenantHasModule('hr')`; RLS auf allen Tenant-Tabellen; sensible Felder verschlüsselt
## Technische Bausteine
- **Entities** (eigene `prisma/schema/hr.prisma`): `HrEmployeeProfile` (user_id 1:1, personal_number, hire_date, position, team, location_id, manager_user_id, emergency_contact_*), `HrLocation` (name, address_*, geo, image_file_id), `HrEmployeeDocument` (employee_user_id, document_kind, file_id, visibility), `HrResource`/`HrQuickLink`, `EmployeePasswordSafeVault` (+ `Entry`/`Access` — username/password/notes **AES-256-GCM**, permission_level read/write/admin). `core.prisma` nur für User-Relation (AD-21).
- **Verschlüsselung**: KMS-backed Envelope (per-Tenant-DEK, AD-8); Reveal entschlüsselt on-demand mit Permission-Check + `AuditEntry`.
- **App-Permission-Layer** oben auf RLS für sensible Tabellen (Werte nie in Listen, Reveal-gated).
- **Konnektor** `tenantHasModule('hr')`; `is_demo_data` auf Demo-Profilen/-Standorten.
- Dokumente via Files/FileEntityLink (AK-P4a/b).
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 10: HR-Hub** (HrEmployeeProfile, HrLocation, HrEmployeeDocument, HrResource/QuickLink, EmployeePasswordSafeVault — viel Verschlüsselung)
- `REQUIREMENTS.md` → `REQ-hr-datenmodell`, `REQ-hr-passwort-safe`
- `ROADMAP.md` → Phase 17 · `PHASE-SOURCES.md` → Phase 17 (M133-stammdaten, M134-dokumente; M138 Drittanbieter-Onboarding → v2)
- `designer-briefs/P17-hr-hub.md` (MA- vs. HR-Admin-Trennung, Passwort-Safe-Reveal, sensible Daten)
- `_bmad-output/specs/M14-hr-hub.md`
## Dev-Nachzug (nach Davids `D-HR`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P17a` aktualisiert
@@ -0,0 +1,57 @@
# AK-P17b · P17 HR Urlaub/Krank + Surveys + Self-Service
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P17 — HR-Hub |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-26 · Gate W2 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-P17a` (HR-Kern + Verschlüsselungs-Pattern + MA/Admin-Trennung)
- **Blocks:** `R-P9b` (Abwesenheiten → Plantafel-Konflikt-Indikatoren)
- **Läuft parallel zu:** Raffaels Kern-Kette. **HR hängt nur an P1/P2**; nutzt den Form-Renderer (M05) — der kommt erst in P16 (AK-P16c), liegt aber zeitlich **nach** P17. **Pragma:** Urlaub/Krank/Requests werden als M05-Form-Templates modelliert; bis der Renderer aus P16 steht, dienen schlanke HR-eigene Formulare als Übergang (Nachzug-Punkt). Eigene `prisma/schema/hr.prisma` (gleicher Namespace, additiv — AD-21).
- **Konflikt-Risiko:** keines auf Schema-Ebene; Calendar-Relation (M25) über `calendar_event_id` (P16) — read-only.
## Was wir bauen
Die **HR-Workflows**: einen **mehrstufigen Urlaubs-Approval-Workflow** (submitted/approved/rejected/withdrawn + Rückfrage) mit **Abwesenheits-Kalender** und **Plantafel-Konflikt-Hinweisen**, **Krankmeldung** (selbst oder durch Büro im Auftrag) mit **verschlüsseltem AU-Upload**, **Announcements** (Audience-Targeting, Acknowledgement-Pflicht + Read-Receipt, Reaktionen, Kommentare), **Lohnabrechnungs-Bulk-Upload** mit Dateiname-Auto-Match + Read-Tracking, **Upload-Erinnerungen** (Cadence + Eskalation), generische **Requests** via Templates, **Surveys** (anonym möglich, mit Auswertung) und den **Mitarbeiter-Self-Service** (Web/PWA; Web-Push als Kanal → v2).
## Benötigte Screens (Backend bedient — Design liefert `D-HR`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Urlaub & Krankmeldung [`/hr/leave`] | Tabs Meine/Genehmigungen/Team; Antrag (M05-Form: Zeitraum/Art/Genehmiger); Genehmiger-Sicht (Approve/Reject/Rückfrage + **Konflikt-Hinweise** Plantafel/vorhandener Urlaub); Krankmeldung (Start, erwartete Rückkehr, **AU-Upload verschlüsselt**); Admin-Monatskalender + KPI |
| Announcements + Detail [`/hr/announcements`, `/:id`] · Verwaltung [`/admin/hr/announcements`] | Feed + Pinned + Ungelesen-Filter; Detail mit Markdown/Reaktionen/Kommentare/**Bestätigungs-Button + Read-Receipt-Tabelle**; Editor (Audience, Acknowledgement-Toggle, Pin, geplant, Ablauf) |
| Lohnabrechnungen [`/hr/payslips`, `/admin/hr/payslips`] | Eigene Liste + PDF-Viewer (Öffnen = gelesen); Admin: alle MA + Bulk-Upload mit **Auto-Match-Vorschau** (hart/weich/kein, Farb-Konfidenz) |
| MA-Anträge [`/hr/requests`] · Request-Templates [`/admin/hr/request-templates`] | Template-Wahl (Spesen/Hardware/Schulung/Zeugnis), M05-Form, Genehmiger-Vorauswahl; Editor mit Approver-Logik + Linked-Form |
| Surveys [`/hr/surveys`] | Teilnahme (Text/Rating/NPS/Choice/Boolean/Datum); Auswertung (gegated, Charts); Admin-Editor (Audience/Sichtbarkeit/Anonymität) |
| Upload-Erinnerungen-Verwaltung [`/admin/hr/upload-reminders`] | Reminder-Liste (Titel/Cadence/Audience/Status), Editor (Dokumentart/Cadence/Mandatory/Linked-Form), Dispatch-Liste |
## Definition of Done
- [ ] **Mehrstufiger Urlaubs-Approval-Workflow** (submitted/approved/rejected/withdrawn + Rückfrage) → speist **Abwesenheits-Kalender** (M25) + **Plantafel-Konflikt-Indikatoren** (R-P9b)
- [ ] **Krankmeldung** (selbst/durch Büro) + **AU-Upload verschlüsselt**
- [ ] **Announcements** (Audience, Acknowledgement-Pflicht + Read-Receipt, Reaktionen, Kommentare)
- [ ] **Lohnabrechnungs-Bulk-Upload** mit Dateiname-Auto-Match (Personalnummer/Name), Match-Vorschau mit Konfidenz, Read-Tracking, Audit pro Read
- [ ] **Upload-Erinnerungen** (Cadence once/yearly/every_n_months/on_expiry, Eskalation an Manager) + **Requests** via Templates
- [ ] **Surveys** (anonym möglich) mit Auswertung
- [ ] **Mitarbeiter-Self-Service** (Web/PWA; Web-Push → v2, AD-17); Anträge als **M05-Form-Submissions** (Renderer aus P16 wiederverwenden)
- [ ] Konnektor `tenantHasModule('hr')`; RLS + App-Permission-Gates; sensible Felder verschlüsselt
## Technische Bausteine
- **Entities** (eigene `prisma/schema/hr.prisma`, additiv): `EmployeeVacationRequest` (start/end_date, request_kind, status, assigned_approver, calendar_event_id), `EmployeeSickLeaveReport` (start/return_date, certificate_file_id, status — **[verschlüsselt]** AU-Schein), `HrAnnouncement` (+ Read/Reaction/Comment), `EmployeePayslip` (period_year/month, file_id, is_read), `EmployeeUploadReminder` (+ Dispatch), `HrRequest` (+ Template — request_kind, form_submission_id, status, assigned_approver), `HrSurvey` (+ Item/Submission — is_anonymous, submitter_hash). `calendar.prisma`/`forms.prisma` über Relationen (AD-21).
- **Approval-Workflow** als State-Machine; Abwesenheits-Sync in `CalendarEvent` (P16); Plantafel-Konflikt-Hinweis-Feed für R-P9b.
- **Auto-Match** (Bulk-Payslip): Dateiname-Pattern → Personalnummer/Name, Konfidenz-Klassifizierung; Read-Tracking + Audit.
- **Form-Integration**: Urlaub/Krank/Requests als M05-Submissions (AK-P16c-Renderer); Übergangs-Formulare bis Renderer steht.
- **RLS** + App-Permission-Gates; AU-Schein verschlüsselt (AD-8); `is_demo_data` auf Demo-Daten.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 10: HR-Hub** (EmployeeVacationRequest, EmployeeSickLeaveReport, HrAnnouncement, EmployeePayslip, EmployeeUploadReminder, HrRequest, HrSurvey)
- `REQUIREMENTS.md` → `REQ-hr-urlaub-krank`
- `ROADMAP.md` → Phase 17 · `PHASE-SOURCES.md` → Phase 17 (M135-urlaub, M136-krankmeldungen, M137-kommunikation, M139-berichte-lohn-export, M140-selbstbedienung; Surveys bleiben v1, M140 ohne Push)
- `designer-briefs/P17-hr-hub.md` (Urlaub/Krank, Lohn-Bulk-Match, Surveys, M05-Renderer wiederverwenden)
- `_bmad-output/specs/M14-hr-hub.md`
## Dev-Nachzug (nach Davids `D-HR`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P17b` aktualisiert
@@ -0,0 +1,62 @@
# AK-P19 · P19 Plattform-Admin (admin.hivegrid.de)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P19 — Plattform-Admin |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-24 · Gate W2 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P2b` (RLS + RBAC + User-Lifecycle — Admin nutzt Boilerplate-User-Modell als Extension), `AK-P3` (Querschnitt: Audit-Hash-Kette für AdminAuditLog)
- **Blocks:** `AK-P20` (Abo-Baukasten-Mechanik wird hier angelegt), `AK-DEMO1` (Demo-Tenant via Admin)
- **Läuft parallel zu:** Raffaels `R-P6` (CRM-Kern). **Maximal isoliert** — Admin-Welt vs. CRM-Domäne, eigener Host `admin.hivegrid.de`, **kein Schema-Konflikt**. Eigene `prisma/schema/admin.prisma` (AD-21); **getrennte Welt, KEIN `tenant_id`** auf den Admin-Tabellen.
- **Konflikt-Risiko:** keines auf Schema-Ebene; berührt `core.prisma` nur für User-Extension (admin-mfa-gate).
## Was wir bauen
Die **getrennte Plattform-Admin-Welt** auf `admin.hivegrid.de` (Host-Routing, **NICHT** `/admin`-Pfad): eigene Admin-Shell (getrennte Sidebar/Topbar), **Cookie-Domain-Trennung** zu app.hivegrid.de, **TOTP-Pflicht + MFA-Step-up**. Admin-User haben **keinen Tenant-Workspace** und erscheinen in keiner Mitgliederliste (Boilerplate-Default-Provisionierung abschalten). Funktionen: **Tenant-Verwaltung** (Stammdaten, Status-Wechsel mit Reason-Pflicht, Notizen, Impersonate mit Begründung max. 30 Min + Banner), **Abo-Zusammenstellung** je Tenant (Feature-Konnektoren togglen + Stripe-Positionen = **Abo-Baukasten-Mechanik**), User-Verwaltung (2FA-Reset/Session-Revoke), **Feature-Flag-Verwaltung** (UI zur Engine aus P1), **Queue-/Health-Monitoring** (BullMQ Retry/Pause/Resume), **Support-Inbox** (speist sich aus P21-Feedback-Widget) und der **`AdminAuditLog`** (cross-tenant, tenant_id=null). **v1-Cut:** getrennte AdminUser-Identität/AdminRBAC (M038/M039) → v2; Plattform-Lead-Pipeline → v2; Flag-Massen-Statistik → v2; Churn/ARPU → v2.
## Benötigte Screens (Backend bedient — Design liefert `D-ADMIN` + `D-P19`; eigene Admin-Shell)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Admin-Login + 2FA [`admin.hivegrid.de/login`, `/2fa`] | Email+Passwort (NIST/HIBP, Captcha ab 3. Fehler), TOTP-Pflicht, kein Magic-Link, 8h-Session |
| Admin-Dashboard [`/dashboard`] | Basis-KPIs Tenants/aktive User/MRR + System-Health-Ampel + Queue-Status, Drill-Down (Churn/ARPU → v2) |
| Tenant-Liste + Detail [`/tenants`, `/:id`] | Liste (Status/Plan/MRR/User/Aktivität); Detail: Status-Wechsler (Reason), **Abo-Zusammenstellung (Konnektoren + Stripe-Positionen)**, Trial-Verlängerung, Notizen, **Impersonate mit Begründung**, User-/Activity-/Audit-/Flag-Sektionen |
| Manuelle Tenant-Anlage [`/tenants/new`] | Name, Slug (Live-Validation), Branche/Größe, Initial-Admin-Email, Module/Plan, Trial, Demo-Daten-Häkchen, Reason |
| User-Liste + Detail [`/users`, `/:id`] | Memberships/2FA/Sessions; Ops (2FA-Reset mit Reason, Session-Revoke, Deaktivieren, Lösch im Auftrag) |
| Subscription-Liste + Detail [`/subscriptions`, `/:id`] | Plan/MRR/Status/Stripe-Sync; manuelle Override (Plan/Sonderpreis/Reason), Stripe-Sync forcieren, Refund |
| Feature-Flags [`/feature-flags`] | Flag-Liste + Targeting-Filter (plan-tier) + Tenant-Override mit Ablauf (Massen-Statistik → v2) |
| Health + Worker-Queues [`/health`, `/health/workers`] | Service-Ampeln, DB/Redis/Storage; BullMQ-Queues Active/Waiting/Delayed/Failed, Job-Detail + Retry/Pause/Resume |
| Support-Inbox + Detail [`/support`, `/:id`] | Liste + Konversation + Markdown-Reply + interne Notiz; **speist sich aus Feedback-Widget (P21)** |
| Admin-Audit [`/audit`] | Cross-Tenant-`AdminAuditLog` + Tenant-Audit-Read, Filter, Diff-Drawer, Export (read-only) |
| Subprozessoren + AVV [`/legal/subprocessors`, `/legal/avv`] | Subprozessor-Liste; AVV-Versionen + akzeptierende/ausstehende Tenants |
## Definition of Done
- [ ] **Host-Routing `admin.hivegrid.de`** (NICHT `/admin`-Pfad!) + **Cookie-Domain-Trennung** App↔Admin
- [ ] **TOTP-Pflicht** hart erzwungen; Admin **ohne Tenant-Workspace** (Default-Provisionierung abgeschaltet, in keiner Mitgliederliste)
- [ ] **Tenant-Verwaltung** + **Abo-Zusammenstellung** (Konnektoren togglen + Stripe-Positionen) + Trial-Verlängerung + Notizen
- [ ] **Impersonate** (temporäre Tenant-User-Session max. 30 Min) mit Klartext-Banner im Tenant + Reason-Pflicht
- [ ] **User-Verwaltung** (2FA-Reset/Session-Revoke), **Feature-Flag-UI** (zur Engine aus P1)
- [ ] **Queue-Monitor** (BullMQ Retry/Pause/Resume, Job-Detail mit Error-Stack) + **Support-Inbox**
- [ ] **`AdminAuditLog`** (tenant_id=null, Hash-Kette); sensitive Aktionen mit Reason-Pflicht + Confirm-Phrase
- [ ] Eigene getrennte Admin-Shell (kein Reuse der App-Sidebar)
## Technische Bausteine
- **Entities** (eigene `prisma/schema/admin.prisma` — **KEIN `tenant_id`**, getrennte Welt): `AdminAuditLog` (admin_user_id, action_type, target_kind/id, summary_text, metadata Diff — cross-tenant), `AdminTenantNote` (tenant_id, note_text, category, pinned), `AdminSupportTicket` (+ Message — source_kind in_app_feedback_widget/inbound_email, tenant_id, status, priority). **v1-Cut:** `AdminUser`/`AdminRole`/`AdminSession` (M038/M039) → v2; v1 = Boilerplate-User-Extension + `admin-mfa-gate.server.ts`. `AdminLead`/`AdminDeal` → v2.
- **Abo-Baukasten-Mechanik** (Billing-Domäne 12): Admin schaltet `SubscriptionFeature`-Konnektoren je Tenant + Stripe-Positionen — Grundlage für AK-P20 (Self-Service-UI dort → v2). `tenantHasModule()` prüft Feature im Abo.
- **Host-Routing + Cookie-Domain-Trennung** (Boilerplate routet `/admin`-Pfad → auf Host umstellen); TOTP-Pflicht + MFA-Step-up-Gate.
- **Impersonate** generiert temporäre Tenant-Session (max 30 Min) mit Banner + Audit-Spur; kein BYPASSRLS.
- **AdminAuditLog** über die Audit-Hash-Kette (AK-P3); Reason-Pflicht bei Status-Wechsel/Impersonate/Override.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 11: Plattform-Admin** (eigene Welt, kein tenant_id; AdminAuditLog/TenantNote/SupportTicket v1, AdminUser/Role/Session = v2) + **Domäne 12** (Abo-Baukasten für Abo-Zusammenstellung)
- `REQUIREMENTS.md` → `REQ-plattform-admin-identität` (AdminUser-Identität/RBAC → v2), `REQ-plattform-admin-features`
- `ROADMAP.md` → Phase 19 · `PHASE-SOURCES.md` → Phase 19 (M031/M032 Flag-UI, M034-auth bindende Auflagen, M035 gedünnt, M036-mandanten, M037-impersonate, M041-health/audit/support; M038/M039/M033/M040 → v2)
- `designer-briefs/P19-plattform-admin.md` (eigene Admin-Shell, Abo-Baukasten-Panel, Impersonate, v1-Cuts)
- `_bmad-output/specs/M37-plattform-admin.md`, `M32-feature-flags.md`
## Dev-Nachzug (nach Davids `D-ADMIN`/`D-P19`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P19` aktualisiert
@@ -0,0 +1,60 @@
# AK-P20 · P20 Billing (Stripe Abo-Baukasten) + Onboarding + Branding
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der **AI-Credits-Screen + AI-Token-Quota entfallen** (kein LLM-Gateway in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]; `AiCredits`/`AiTokenUsage` gestrichen). Die Verbrauchs-Übersicht bleibt für Automation-Läufe + Speicher. Alle AI-Credits/AI-Token-Stellen unten sind durchgestrichen.
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P20 — Billing, Onboarding & Branding |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-08 · Gate W4 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `EXT-07` (Stripe-Account + Produkte/Preise + Webhook-Endpoint), `AK-P19` (Abo-Baukasten-Mechanik + Admin-Tenant-Verwaltung als Voraussetzung)
- **Blocks:** `AK-P21` (DSGVO/Launch — Tenant-Löschung braucht Stripe-Cancel)
- **Läuft parallel zu:** Raffaels Kern-Kette (Auftrags-/Abnahme-Welt P9). Eigene `prisma/schema/billing.prisma` + Onboarding-Teile (AD-21); `core.prisma` (Tenant) nur über Relation.
- **Konflikt-Risiko:** gering — additive Tabellen + Read-Only-Middleware (Frozen) auf der Request-Pipeline (Querschnitt, additiv).
## Was wir bauen
Drei gebündelte v1-Module: **Billing als Stripe-Abo-Baukasten** (M154-Recut) — Basis-Preis pro Nutzer + Feature-Module als **daten-getriebene Positionen**, **KEINE Seat-Typen**; In-App **keine** Pricing-/Upgrade-/Plan-Wechsel-UI (Apple-Compliance LP-8) — nur Read-Only-Übersicht + externer Verweis; **Trial + Dunning** (Tag 1/3/7) + **Frozen-Modus** (Read-Only-Middleware); Verbrauchs-Zähler + Drossel (Aufschlags-Abrechnung → v2). **Onboarding** = **Auto-SHK-Provisionierung** beim Signup (Seeds M158, **ohne Wizard** — der ist v2) + Demo-Daten-Knopf + Erste-Schritte-Checkliste. **Branding** = nur **Hell/Dunkel-Toggle** (kein System-Modus), flash-frei via SSR-Cookie.
## Benötigte Screens (Backend bedient — Design liefert `D-P20`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Abo-Übersicht [`/admin/subscription`] | Basis-Plan + **Feature-Module als Positionsliste mit Preisen** (read-only), Status/Trial-Countdown, **KEIN Upgrade-Button** (Hinweis-Box „Plan-Wechsel über Account-Manager/hivegrid.de"), Pausieren + Kündigen |
| Verbrauchs-Übersicht [`/admin/usage`] ~~· AI-Credits [`/admin/usage/ai-credits`]~~ (AI-Credits-Screen entfällt — [[AD-26]]) | Quota-Balken je Metrik (Automation/~~AI-Tokens~~ (entfällt)/Speicher), ~~Donut AI-Verbrauch~~, 80%-Warnbanner, Aufgebraucht-Klartext |
| Rechnungen/Zahlung [`/admin/billing`] | **Stripe-Customer-Portal-Embed** (Rechnungs-History/PDF, Zahlungsmethode, USt-Daten) |
| Demo-Daten [`/admin/onboarding/demo-data`] | Settings-Knopf „Beispieldaten anlegen" (~25 Datensätze, Klartext-Liste), Demo-Zähler + Lösch-Funktion, „Demo ausblenden"-Filter |
| Erste-Schritte-Checkliste [`/onboarding/checklist`] | Auto-erkannte Status-Häkchen, CTA-Links, manuell abhakbar/ausblendbar, Glückwunsch bei 100% (auch Dashboard-Widget) |
| Status-Banner-System (Shell) | trial-Ende-3-Tage / past_due / frozen / deletion_pending je eigener Klartext + Action; Read-Only-Toast bei blockiertem Schreib-Button |
| Hell/Dunkel-Toggle [Profil/User-Menü] | Zwei Optionen, sofortige Anwendung, flash-frei (SSR-Cookie) |
## Definition of Done
- [ ] **Stripe-Abo-Baukasten**: Basis-Preis pro Nutzer + Feature-Module als daten-getriebene Positionen — **KEINE Seat-Typen** (M154-Recut); Preise geparkt (AD-15)
- [ ] **Trial + Dunning** (Tag 1/3/7) + **Frozen-Modus** (Read-Only-Middleware) greift; Status-Banner pro Zustand; Verbrauchs-Zähler + Drossel (Aufschlags-Abrechnung → v2)
- [ ] **In-App keine** Pricing-Tabelle/Upgrade-Buttons/Plan-Wechsel-UI (LP-8) — Read-Only + externer Verweis; Pause/Kündigen erlaubt
- [ ] **Auto-SHK-Provisionierung** beim Signup (Seeds M158: Pipelines, Custom-Felder, Rollen, Form-Templates, Checkliste) — **ohne Wizard-UI** (v2)
- [ ] **Demo-Daten-Knopf** (per Settings, `is_demo_data`-Flag löschbar) + „Demo ausblenden"-Filter
- [ ] **Erste-Schritte-Checkliste** (auto-erkannter Status, CTA-Links, abhakbar/ausblendbar; Dashboard-Widget)
- [ ] **Hell/Dunkel-Toggle** flash-frei (SSR-Cookie, `next-themes`) — kein System-Modus
- [ ] Konnektor `tenantHasModule('billing')`; RLS auf allen Tenant-Tabellen
## Technische Bausteine
- **Entities** (eigene `prisma/schema/billing.prisma`): `SubscriptionProduct` (Plan Core/Swarm/Colony — global), `SubscriptionPrice` (stripe_price_id, interval), `SubscriptionFeature` (+ `ProductFeature`, quota_value JSON — **Brücke zur Konnektor-Pflicht**, `tenantHasModule()`), `SubscriptionUsageBasedPrice`/`UsageBasedTier`, `TenantSubscription` (1:1 Tenant, status trial/active/past_due/cancelled/frozen, Stripe-IDs, Dunning-Felder), `TenantSubscriptionProductPrice` (quantity=Seats, is_metered), `TenantSubscriptionUsageRecord`, `Credit`, `CheckoutSessionStatus`. Onboarding: `Onboarding`/`OnboardingSession`/`OnboardingDemoProvisioning`. Branding: `User.theme_preference` (Feld, kein eigenes Modell). `core.prisma` über Tenant-Relation (AD-21).
- **Abo-Baukasten** (M154-Recut): `SubscriptionFeature.code` (z.B. `kwp_integration`) = Entitlement-Schicht; Struktur aus Legacy `pricing-plans.ts` portieren, Preise = Kostenmatrix (AD-15).
- **Stripe-Integration**: Webhook-Handler (Signatur), Customer-Portal-Embed, Dunning-Email-Sequenz, Frozen-Read-Only-Middleware auf der Request-Pipeline.
- **Auto-SHK-Provisionierung** orchestriert die Self-Seeds aller Module (AD-12); Demo-Daten-Seed via `is_demo_data`; Trial-Freischaltung durch Plattform-Admin (AK-P19).
- **RLS** überall (global: Produkte/Features/Preise); `next-themes` SSR-Cookie für Hell/Dunkel.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 12: Billing & Abo-Baukasten** (Recut-Modell, keine Seat-Typen) + **Domäne 13** (Onboarding, OnboardingDemoProvisioning, User.theme_preference)
- `REQUIREMENTS.md` → `REQ-billing-datenmodell`, `REQ-billing-trial-dunning`, `REQ-onboarding-demo-daten`, `REQ-branding-theme-phase1` (Onboarding-Wizard → v2)
- `ROADMAP.md` → Phase 20 · `PHASE-SOURCES.md` → Phase 20 (M153-stripe, M154-recut bindend, M155-trial-readonly, M156-metering Zähler+Drossel, M158-shk-provisionierung, M159-branchen-templates nur SHK, M160-demo gedünnt, M030 nur Hell/Dunkel)
- `designer-briefs/P20-billing-onboarding-branding.md` (Abo-Baukasten, kein Upgrade-UI LP-8, Demo-Knopf, Hell/Dunkel)
- `_bmad-output/specs/M28-subscriptions-billing.md` (⚠ M154-Recut), `M29-onboarding.md` (Wizard → v2), `M31-branding.md` · Legacy: `archive/hivegrid-cloud/app/config/pricing-plans.ts`
## Dev-Nachzug (nach Davids `D-P20`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P20` aktualisiert
@@ -0,0 +1,58 @@
# AK-P21 · P21 DSGVO (Export + Lösch-Workflow) + Feedback-Widget
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P21 — DSGVO & Launch-Reife |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-09 · **Gate W4 (FREEZE)** |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-P20` (Billing — Tenant-Löschung ruft Stripe-Cancel; Feedback-Widget speist Admin-Support-Inbox aus AK-P19)
- **Blocks:** **FREEZE** (letzte v1-Phase, macht den Big-Bang-Launch AD-19 auslösbar)
- **Läuft parallel zu:** Raffaels Härtung/Launch-Tickets. Eigene `prisma/schema/gdpr.prisma` (AD-21); Feedback-Widget schreibt in `AdminSupportTicket` (AK-P19, generische Quelle); Export liest tenant-weit über RLS.
- **Konflikt-Risiko:** gering — additive Tabellen + asynchrone BullMQ-Jobs; Crypto-Shredding berührt per-Tenant-DEK (AD-8), keine Schema-Änderung an Fach-Modulen.
## Was wir bauen
Den **DSGVO-Lebenszyklus + Launch-Reife** (letzte v1-Phase): tenant- und user-weiter **DSGVO-ZIP-Export** (asynchroner BullMQ-Job mit Progress, **72h-signed-URL**, Rate-Limit), den **Tenant-Lösch-Workflow** (**Crypto-Shredding** per-Tenant-DEK, **Stripe-Cancel**, Storage/Cache/Index-Bereinigung, 30-Tage-Grace mit Read-Only + Abbruch, **Slug als Confirm-Phrase**), die **AVV-/Subprozessoren-Sichtbarkeit** im Privacy-Hub, ein **In-App-Feedback-Widget** (speist die Admin-Support-Inbox aus AK-P19) und eine **Minimal-FAQ**-Seite. **DSGVO-Auskunft = manuelles Playbook v1** (Suche → Kontakt-Detail → CSV → Anwalts-Vorlage → Frist-Task +25 Tage), **kein** Auskunfts-Wizard. PWA-only (AD-17): alle Screens mobil tauglich, kein nativer Client.
## Benötigte Screens (Backend bedient — Design liefert `D-P21`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Privacy-Hub [`/admin/privacy`] | Übersicht Export/Löschung/Subprozessoren/AVV/Privacy-Manifest-Link, Einstieg in Sub-Bereiche |
| Tenant-Daten-Export [`/admin/privacy/export`, `/new`, `/:jobId`] | Job-Liste mit Status/Progress/Download (72h-Link); Anstoßen mit Klartext (was, Größe/Dauer, 7-Tage-Window) |
| Tenant-Löschung [`/admin/privacy/deletion`, `/:requestId`] | Multi-Step-Wizard: Erklärung (30-Tage-Grace, Read-Only, Hard-Delete) → Export-Angebot → Stripe-Hinweis (Pro-rata) → Passwort+2FA → **Slug als Confirm-Phrase**; Grace-Countdown + Abbruch |
| Subprozessoren [`/admin/privacy/subprocessors`] · AVV [`/admin/privacy/avv`] | Subprozessor-Tabelle (Land/EU-Marker/DPA-Link/Export); AVV-PDF-Download + Akzeptanz-History + Re-Akzeptanz-Modal |
| User-Daten-Export [`/settings/account/data-export`, `/:jobId`] · Account-Löschung [`/settings/account/delete`] | User-Self-Export (signed-URL, Rate-Limit); Account-Lösch-Wizard (Passwort+2FA, 24h-Reverse-Window, M27 D.3) |
| Feedback-Widget [global, klein] | Schwebender Button → Mini-Form (Bug/Feature/Frage, Text, Screenshot-Häkchen, Rate-Limit) → **Admin-Support-Inbox (AK-P19)** |
| Minimal-FAQ [`/help`] | Statische FAQ (gruppierte Fragen/Antworten, Markdown), Suchfeld optional (kein Help-Center-Ausbau → v2) |
## Definition of Done
- [ ] **DSGVO-ZIP-Export** (User-Self **und** Tenant-Full): asynchroner BullMQ-Job mit Progress, **72h-signed-URL**, Rate-Limit (max. 3 User-Self/24h, max. 1 Tenant-Full aktiv); README + manifest.json im ZIP
- [ ] **Tenant-Löschung**: **Crypto-Shredding** (per-Tenant-DEK) + **Stripe-Cancel** + Storage/Cache/Index-Bereinigung (AD-8); 30-Tage-Grace Read-Only + Abbruch; **Slug als Confirm-Phrase**; Stripe-Cancel erst beim Hard-Delete-Cron
- [ ] **AVV-Download** + Akzeptanz-History + Re-Akzeptanz (14-Tage-Frist, danach Read-Only-Sperre); **Subprozessoren-Liste** mit Drittland-Klartext (v1 EU-only)
- [ ] **DSGVO-Auskunft als dokumentiertes Playbook** (Suche → Kontakt-Detail → CSV → Anwalts-Vorlage → Frist-Task +25 Tage) — kein automatisches Tooling
- [ ] **In-App-Feedback-Widget** → speist Admin-Support-Inbox (AK-P19, generische Quelle)
- [ ] **Minimal-FAQ**-Seite (statisch)
- [ ] Alle Screens **mobil tauglich** (PWA/responsive, AD-17); kein nativer Client; PWA-Installierbarkeit/Web-Push → v2
- [ ] Permissions: `privacy.user_export.self` (implizit jeder User), `privacy.tenant_export`/`privacy.tenant_deletion`/`privacy.avv.*`/`privacy.subprocessors.read` (über `tenant.admin`)
## Technische Bausteine
- **Entities** (eigene `prisma/schema/gdpr.prisma`): `GdprExportJob` (scope user_self/tenant_full, status, result_file_id ZIP, result_expires_at), `TenantDeletionRequest` (reason, grace_period_ends_at +30d, status — Slug-Confirm), `AvvAcceptance` (avv_version, accepted_by, pdf_file_id, signer_name), `Subprocessor` (name, country, is_eu_eea, data_categories, dpa_url — global). Feedback schreibt in `AdminSupportTicket` (AK-P19). `core.prisma` über Tenant-Relation (AD-21).
- **Export-Worker** (BullMQ): tenant-weiter/user-weiter Sammel-Export → ZIP (S3-kompatibel, Hetzner) mit 72h-signed-URL + README/manifest.json; Rate-Limit.
- **Crypto-Shredding** (AD-8): per-Tenant-DEK löschen → Daten kryptographisch unlesbar; Stripe-Cancel + Storage/Cache/Index-Cleanup beim Hard-Delete-Cron; 30-Tage-Grace Read-Only-Middleware (Reuse aus AK-P20 Frozen-Modus).
- **Feedback-Widget**: Rate-Limit + Screenshot via Files → `AdminSupportTicket` (source_kind in_app_feedback_widget).
- **RLS** auf allen Tenant-Tabellen (Subprocessor global); `is_demo_data` n/a (kein Seed-Bedarf).
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 13: Onboarding/Branding/DSGVO** (GdprExportJob, TenantDeletionRequest, AvvAcceptance, Subprocessor) + **Domäne 11** (AdminSupportTicket-Quelle)
- `REQUIREMENTS.md` → `REQ-dsgvo-export`, `REQ-dsgvo-tenant-deletion`, `REQ-feedback-widget` (DSGVO-Auskunft/Help-Center → v2)
- `ROADMAP.md` → Phase 21 · `PHASE-SOURCES.md` → Phase 21 (M164-daten-export, M165-loesch-workflow; Auskunft-Playbook M166, Feedback-Widget bleibt v1; Public-API/Mobile-Native/Help-Center → v2)
- `designer-briefs/P21-dsgvo-launch.md` (Export, Lösch-Wizard, Feedback-Widget, Minimal-FAQ, kein Auskunfts-Wizard, PWA-only)
- `_bmad-output/specs/M35-dsgvo-export.md`
## Dev-Nachzug (nach Davids `D-P21`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P21` aktualisiert
@@ -0,0 +1,56 @@
# AK-P3 · P3 Querschnitts-Oberflächen (Audit/Notif/Sprache DE)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P3 — Querschnitts-Oberflächen |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-21 · Gate W2 (Noah-Demo #1) |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P1b` (Service-Kerne: Audit-Hash-Kette, `notify()`, i18n-Engine), `R-P2b` (RLS + Permissions für `audit.read`)
- **Blocks:** — (liefert Bedien-Oberflächen, keine harten Downstream-Blocker)
- **Läuft parallel zu:** Raffaels `R-P5` (Apps-Engine) — **Paar AK-P3 ‖ R-P5.** Disjunkte Domänen (Querschnitts-UI vs. Apps-Engine), eigene `prisma/schema/*.prisma` → **kein Schema-Konflikt** (AD-21). Berührungspunkt nur Sidebar — additiv.
- **Konflikt-Risiko:** gering — nur Sidebar-Einträge + Settings-Routen; db push auf Branch.
## Was wir bauen
Die **Bedien-Oberflächen** der in P1 gebauten Plattformdienste: **Audit-Viewer** (gefilterter, permission-gegateter Trail mit deutschem Summary-Text, Actor-Kind-Marker, Diff-Detail-Drawer, NDJSON/CSV-Export ins Hetzner-Object-Storage mit Zweck-Pflichtfeld), **Notification-Center** (In-App via SSE, Read-Status, Deeplink, Tabs Alle/Ungelesen, Bulk-Clear) + **Notification-Settings** (Event-Typen je Modul, In-App/Email-Toggle, Master „alle Emails aus"), sowie die **Sprach-Settings** (v1 DE-only-Hinweis; alle Strings durch `t()`, `verify:i18n` grün).
## Benötigte Screens (Backend bedient — Design liefert `D-P3` aus `D-D0a`/`D-D0b`)
| Screen [Route] | Kern-Inhalt | Liefert (Design) |
|---|---|---|
| Audit-Viewer [`/admin/audit`] | Zeit/Actor (+Kind-Marker)/Aktion/Subjekt/DE-Summary · Filter (Zeitraum/Actor/Kategorie/Subjekt-Typ) · Diff-Detail-Drawer · Export-Button | `D-P3` (A2+Drawer) |
| Audit-Export-Jobs [`/admin/audit/exports` +`/new` +`/:id`] | Job-Liste · Anlage (Filter, Format, Zweck) · Status + signed-URL-Download | `D-P3` (A2) |
| Notification-Center [Topbar-Drawer + `/notifications`] | Titel/Body/Actor/Zeit/Read-Status, Tabs Alle/Ungelesen, Bulk-Clear, Bounce-Klartext | `D-P3` (A2) |
| Notification-Settings [`/settings/notifications`] | Event-Typen je Modul, In-App/Email-Toggle + Priority, Master „alle Emails aus" | `D-P3` (A6) |
*Eingebettet (kein eigener Screen): Per-Subject-Audit-Drawer in jeder Detail-View, Per-User-Audit-Drawer in `/admin/users/:id`, DE-Sprach-Hinweis im Profil (P2). Davids P3-Screens werden über `D-P3` (Compose aus D0) geliefert.*
## Definition of Done
- [ ] **Audit-Viewer** permission-gegated (`audit.read`), server-seitige Filter, DE-Summary-Text, Actor-Kind-Marker
- [ ] **Diff-Detail-Drawer** (Feld-für-Feld Vorher/Nachher; Maskierung bei sensiblen Werten)
- [ ] **NDJSON/CSV-Export** ins Hetzner-Object-Storage + Zweck-Pflichtfeld + Export-Job-Status/Download; jeder Export selbst auditiert (`audit.exported`); fixe Default-Retention + Cron-Auto-Löschung
- [ ] **Notification-Center** (SSE, Read-Status, Deeplink, Tabs, Bulk-Clear, Bounce-Klartext)
- [ ] **Notification-Settings** (Event-Typen je Modul, In-App/Email-Toggle, Master-Toggle)
- [ ] **Sprach-Settings DE** — alle Strings durch `t()`, vollständige `de`-Locale, `verify:i18n` grün; `Contact.language`-Feld vorhanden (Outbound ab v2)
- [ ] *(→ v2)* Quiet-Hours/Bündelung/Push-Kanal/Retention-Editor/Legal-Hold/Saved-Views/Sprach-Wechsler ausgeschlossen
## Technische Bausteine
- **Keine neuen Kern-Entities** — liest/bedient die in `R-P1b` angelegten `AuditEntry`/`Notification`/`NotificationPreference`. Neu nur `AuditExportJob` ist **v2** → in v1 fixe Default-Retention statt Job-Editor (Boilerplate liefert Retention-Cron + PDF-Export). Eigene `prisma/schema/*.prisma` falls Felder ergänzt (AD-21).
- **RLS** auf allen tenant-bezogenen Lese-Pfaden; `audit.read`-Permission-Gate (aus R-P2b RBAC).
- **Konnektor** `tenantHasModule()` für die Admin-/Settings-Routen.
- i18n = JSON-Files (keine Tabelle); `verify:i18n`-CI-Gate aus R-P1b bleibt unantastbar.
- `is_demo_data` greift nicht (Querschnitt) — Export-Files in Object-Storage mit Retention-Cleanup.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 2: Querschnitt** (AuditEntry, Notification, NotificationPreference, NotificationDevice; i18n = Felder, keine Tabelle)
- `REQUIREMENTS.md` → `REQ-audit-retention-export`, `REQ-audit-permissions`, `REQ-notification-versand-pipeline`, `REQ-i18n-outbound`
- `ROADMAP.md` → Phase 3 · `PHASE-SOURCES.md` → Phase 3 (M028/M115/M116/M151/M152; Service-Kerne → P1, Flag-Admin-UI → P19)
- `designer-briefs/P03-querschnitts-oberflaechen.md`
- `_bmad-output/specs/M21-audit-log.md`, `M22-notifications.md`, `M30-i18n.md` (Oberflächen-Teile)
## Dev-Nachzug (nach Davids `D-P3`-Delta)
- [ ] Audit-/Notif-Oberflächen an Davids UI angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P3` aktualisiert
@@ -0,0 +1,411 @@
# AK-P4a · P4 Files (chunked Upload, HEIC→JPG, ClamAV)
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P4 — Files & Tasks |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-19 · Gate W1 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-INFRA2` (ClamAV per ENV), `EXT-06` (Hetzner-S3 + Token + DEK-Master-Key)
- **Blocks:** `AK-P4b` (Tasks + EntityLink), `R-P6` (File-Links am CRM)
- **Läuft parallel zu:** Raffaels `R-P2a`/`R-P2b` (Auth/RLS) — **erstes echtes Code-Paar P2‖P4.** Disjunkte Domänen, eigene `prisma/schema/files.prisma` → **kein Schema-Konflikt** (AD-21). Files braucht RLS-Kontext aus P2 (nutzt das `app.tenant_id`-Muster, aber baut keine Identitäts-Tabellen).
- **Konflikt-Risiko:** keines auf Schema-Ebene; nur Sidebar additiv.
> **EXT-06-Stand (2026-06-17):** Staging-S3 steht schon — Bucket `hivegrid-staging-media`
> (Hetzner `fsn1`, **privat**) + `STORAGE_*` auf web/api/worker gesetzt, DEK via `CRYPTO_SECRET`.
> Du kannst direkt gegen den Staging-Bucket testen. Prod-Bucket folgt (Owner Raffael, Limit erhöht).
> **Media-Auslieferung ist auf Weg B entschieden → siehe AD-23 / DoD / Technische Bausteine unten.**
## Was wir bauen
Das **Files-Plattform-Primitive**: chunked Upload (TUS) mit **RLS auf Storage-Pfaden** (Hetzner S3-kompatibel, ADR-009), Preview-Generierung (PDF→PNG, Bild→WebP, **HEIC→JPG — Pflicht** für iPhone-Monteur-Fotos) mit Status (pending/generating/ready/failed/not_supported) + Klartext-Fallback, **ClamAV-Virenscan**, Permissions/Sharing, Tags, Archiv-Flag, Bulk-ZIP, und das Anhängen an jede Entität über `FileEntityLink` (polymorph). Customer-Portal-Upload ist vorbereitet.
## Benötigte Screens (Backend bedient — Design liefert `D-P4` aus `D-D0a`/`D-D0b`)
| Screen [Route] | Kern-Inhalt | Liefert (Design) |
|---|---|---|
| Files-Browser [`/files`] | Tabelle/Grid-Umschalter, Filter (Entität/MIME/Tags/Verantwortlicher), Bulk (Tag/Verknüpfen/Archiv/ZIP), Inline-Schnell-Vorschau, Archiviert-Toggle | `D-P4` (A2) |
| Upload-View + Dropzone [`/files/upload`] | Drag&Drop, Multi-Datei-Queue mit Per-Datei-Fortschritt, Fehler+Retry, HEIC-Klartext-Hinweis | `D-P4` (A4) |
| File-Detail [`/files/:id`] | Stammdaten, Vorschau (Bild-Zoom/PDF; HEIC→JPG) + not_supported-Fallback, Tags, Notizen, verknüpfte Entitäten mit Rolle, Activity, Download/Ersetzen/Archiv | `D-P4` (A3) |
*Eingebettet: Files-Browser vorgefiltert in Entity-Detail-Views (R-P6 ff.). Davids P4-Screens über `D-P4` (Compose aus D0).*
## Definition of Done
- [ ] **Chunked Upload (TUS)** + **RLS auf Storage-Pfaden** (Hetzner Object Storage, S3-kompatibel)
- [ ] **Preview** PDF→PNG / Bild→WebP / **HEIC→JPG (Pflicht!)** mit Status-Maschine + Klartext-Fallback
- [ ] **ClamAV-Scan** beim Upload
- [ ] Permissions/Sharing + Tags + Archiv-Flag + Bulk-ZIP
- [ ] **Auth-Proxy-Route für Medien-Auslieferung** (AD-23) — privater Bucket, `publicUrl` → Proxy, **kein public-read**
- [ ] **`FileEntityLink`** (polymorph) an jede Entität + Rollen-Label; Customer-Portal-Upload vorbereitet
- [ ] Files-Browser server-side-Filter (Entität/MIME-Gruppe/Tags/Verantwortlicher), Tabelle/Grid-Umschalter
- [ ] *(→ v2)* Versionierung/Office-/Video-Previews/Resume-Upload/OCR ausgeschlossen
## Technische Bausteine
- **Entities** (eigene `prisma/schema/files.prisma`): `File` (display_name, mime_type, size, storage_key, checksum, preview_status, assigned_to, source; `is_demo_data`; Soft-Delete), `FileChunk`/`FileUploadProgress` (upload_id, chunk_index, received_chunks, expires_at 24h), **`FileEntityLink`** (file_id + entity_type + entity_id + link_role, polymorph — Cross-Cutting). `FileVersion` = **v2** (nicht bauen). `core.prisma` nur für Tenant/User-Relationen berühren (AD-21).
- **RLS** auf `File`/`FileEntityLink` + Storage-Pfad-Scoping (tenant-isoliert).
- **Konnektor** `tenantHasModule('files')` (Sidebar + Routes + Actions gated).
- ClamAV + S3 per ENV (aus AK-INFRA2 / EXT-06).
- **Media-Auslieferung (AD-23, beschlossen 2026-06-17):** Bucket bleibt **privat**, **kein public-read**. Medien werden über eine **authentifizierte Proxy-Route** ausgeliefert (Session + `withTenantScope()` + `withPermission()`), die aus dem privaten Bucket streamt bzw. auf eine kurzlebige signierte Download-URL redirected. Der `publicUrl`-Pfad in `RowHelper`/`MediaHelper`/`ApiHelper` (`publicUrl ?? file`) muss auf diese Route zeigen, **nicht** auf eine public-S3-URL; `STORAGE_PUBLIC_BASE_URL` bleibt leer. Genuin öffentliche Assets (E-Mail-Bilder, öffentliche Formular-/Booking-/Portal-Seiten, Branding-Logos) → signierte URLs mit TTL **oder** separater `public/`-Prefix mit eng begrenztem public-read (pro Asset-Typ entscheiden). DSGVO-Export-Artefakte nutzen bereits signierte URLs (unverändert).
- `is_demo_data` auf seedbaren Demo-Files (Onboarding-Provisioning).
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 3: Files & Tasks** (File, FileChunk, FileUploadProgress, **FileEntityLink** polymorph) + Cross-Cutting-Tabelle
- `REQUIREMENTS.md` → `REQ-files-datenmodell`, `REQ-files-upload-preview`
- `ROADMAP.md` → Phase 4 · `PHASE-SOURCES.md` → Phase 4 (M052/M053/M054 gedünnt/M055 gedünnt)
- `designer-briefs/P04-files-tasks.md`
- `_bmad-output/specs/M23-files.md` · Infra: ADR-009 (Hetzner Object Storage)
- `docs/ARCHITECTURE-DECISIONS.md` → **AD-23** (Media-Auslieferung: privater Bucket + Auth-Proxy, kein public-read) · AD-8 (Verschlüsselung)
## Dev-Nachzug (nach Davids `D-P4`-Delta)
- [ ] Files-Browser/Detail an Davids UI angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P4a` aktualisiert
## Umsetzungs-Notiz
### 2026-06-19 — Backend-Fundament gebaut + verifiziert (Akeshan, Branch `feat/AK-P4a`)
Gebaut strikt nach `local/AK-P4a-files-bau-plan.md` (Single Source of Truth). Plattform:
Windows 11 (Akeshan), Co-Dev Raffael auf macOS. Reihenfolge wie im Plan empfohlen:
§1 → §2 → §4 → §7 → §9 → §8.
**Fertig + verifiziert (typecheck/test gruen):**
- **§1 Datenmodell** — `prisma/schema/files.prisma` neu (AD-21, eigene Datei, bare
String-Scalars, kein Core-Edit). Modelle `File`, `FileEntityLink` (polymorph),
`FileUpload`, `FileUploadChunk` + Enums. `createdByPortalUserId` nullable als
Customer-Portal-Vorbereitung (DoD 12). Proof: `prisma validate` + `prisma generate` gruen.
- **§2 Storage-Pfade** — `packages/storage/src/paths/` (`buildFileStorageKeys`,
`buildFilePreviewKey`, `buildUploadChunkKey`, `assertFileKeyBelongsToTenant` als duenne
Klammer um das vorhandene `authorizeStorageObjectAccess`). Proof: 5 neue Unit-Tests gruen
(`pnpm -F @toolctrl/storage test` → 76 passed).
- **§4 Queue-Plumbing** — neue Queue `toolctrl.file-preview` quer durch `names`/`payloads`/
`producers`/`groups`/`index` (`FilePreviewJob`, `buildFilePreviewJob`, retry-opts, group
`general`). Proof: `pnpm -F @toolctrl/queue typecheck` + `test` (101 passed; dabei eine
vorbestehende Luecke im metrics-snapshot-Test geschlossen: `buildPluginInvokeJob` fehlte).
- **§4 Preview-Worker** — `apps/worker/src/jobs/file-preview.ts` (HEIC→JPG / Bild→WebP /
PDF→PNG / Text→ready / sonst not_supported, Status-Maschine + Thumbnails), Handler-Registry
`[queueNames.filePreview]` + `filePreviewService`-Dependency + `PreviewHandlerError` in
`handlers.ts`, Bootstrap-Wiring (general group) in `index.ts`. Render-Libs per dynamischem
Import (qdrant-Muster) → Build gruen vor Install; **Aktivierung:**
`pnpm add sharp heic-convert pdf-to-png-converter -F @toolctrl/worker`. ClamAV (§5) ist
Reuse (`enqueueFileScan` bereits vorhanden). Proof: `pnpm -F @toolctrl/worker typecheck` gruen.
- **§7 Permissions** — `files.read_own/read_all/write/delete/admin` in
`packages/db/.../permissions-seed.server.ts` (mit expliziten Default-Rollen-Grants, da
`files.*` keinen `app.`/`admin.`-Prefix traegt) + in `apps/web/.../DefaultPermissions.ts`.
Proof: `pnpm -F @toolctrl/db typecheck` gruen.
- **§9 View-Models** — `packages/view-models/src/files/{file-browser,file-detail,file-upload}.vm.ts`
(reine Builder, nur i18n-Keys, URLs zeigen auf Proxy-Route, fail-closed bei scanStatus=infected).
Proof: `pnpm -F @toolctrl/view-models typecheck` + `test` (13 passed).
- **§8 Migration vorbereitet** — `local/AK-P4a-merge-migration.sql`: Trigram-Index +
RLS-Policies (forward-only, Inverse-SQL als Kommentar, DO-guarded). AD-21: auf dem Branch nur
`db push`; die echte Migration wird beim Merge via `prisma migrate diff` erzeugt und um diesen
Anhang ergaenzt. Mit R-P2b (`SET LOCAL app.tenant_id`) abzustimmen.
Branch `feat/AK-P4a` enthaelt das gruene Backend-Fundament; die offenen Scheiben sind reine
Web-Route-/UI-/Wiring-Arbeit auf diesem Fundament. Kein Plane-Done, solange §3/§6/§11/§12/§13 fehlen.
---
### HANDOFF fuer den naechsten Coding-Agenten (hier weitermachen)
**Status:** Backend-Fundament steht und ist gruen (§1, §2, §4, §7, §9, §8-Vorbereitung). Offen ist
die Web-Route-/UI-/Wiring-Scheibe. **Single Source of Truth bleibt** `local/AK-P4a-files-bau-plan.md`.
**Empfohlene Reihenfolge:** §3 → §6 → §11 (UI/Routen) → §12 (Wiring) → §13 (Tests).
**Konventionen, die du einhalten musst (sonst PR-Block):**
- **Kommentar-Sprache = Englisch** im Code (`apps/**`, `packages/**`, `prisma/**`); Deutsch nur in
Dokus/`.planning/`/`local/`. Siehe `AGENTS.md` §„Kommentar-Sprache" (neu, 2026-06-19).
- Drei Anti-Patterns (kein `~/db`/`@prisma/client` in `ui-app`; kein `ui-subframe`-Direktimport in
`routes/**`; kein `useLoaderData` in `ui-app`). Loader baut VM, Component ist pur.
**§3 Chunked-Upload — neu `apps/web/app/utils/integrations/fileService.server.ts` + Resource-Routes:**
- Routing ist **ordnerbasiert** (`apps/web/app/routes.ts` → `createRoutesFromFolders`): neue Dateien
in `apps/web/app/routes/app.$tenant/` registrieren sich automatisch; `*.server.ts` wird als Route
ignoriert (perfekt fuer den Domain-Service).
- Loader-/Action-Bausteine (verifiziert im Repo): `requireAuth({request,params})` aus
`~/utils/loaders.middleware`; `getTenantIdFromUrl(params)` aus `~/utils/services/.server/urlService`;
`getUserInfo(request)` aus `~/utils/session.server`; Modul-Gate
`tenantHasModule({tenantId,userId,moduleKey:"files"})` aus `~/utils/connector/tenantConnector.server`.
- Upload selbst: `storeFile`/`putBufferAsFile`/`deleteFile` in
`apps/web/app/utils/integrations/storageService.ts`. Magic-Bytes-Allow-List via `resolveAllowList`
aus `@toolctrl/storage`. Keys via `@toolctrl/storage` `buildUploadChunkKey`/`buildFileStorageKeys`
(schon gebaut, §2). Chunk 5 MB, max 3 parallel, max 500 MB (Konstanten in `file-upload.vm.ts`).
- Nach `complete`: `enqueueFileScan({...})` (vorhanden, `fileScanQueue.server.ts`) **und** einen neuen
Producer `enqueueFilePreview(...)` (spiegle `fileScanQueue.server.ts`, nutze `buildFilePreviewJob` +
`queueNames.filePreview` — beide schon exportiert).
**§6 Auth-Proxy `apps/web/app/routes/app.$tenant/media.$fileId.$variant.tsx` (AD-23):**
- Loader: `requireAuth` → `getTenantIdFromUrl` → `tenantHasModule("files")` → Sichtbarkeits-Check (§7)
→ **302 auf kurzlebige signierte Download-URL** (TTL 300 s). Signer-Wiring: pruefe
`apps/api/src/storage.ts` (`createStorageSignedDownloadUrl`) bzw. baue web-seitig mit
`@aws-sdk/s3-request-presigner` + `createS3SignedUrlAdapter` aus `@toolctrl/storage`.
- `scanStatus=infected` → Klartext-Fehler (fail-closed); verweigert → **404, nicht 403**.
`STORAGE_PUBLIC_BASE_URL` bleibt leer.
**§7-Rest / 404-vs-403 (wichtige Entscheidung):** Die App-Konvention `verifyUserHasPermission(request,
perm, tenantId)` (`apps/web/app/utils/helpers/.server/PermissionsService.ts`) **redirectet** auf eine
Unauthorized-Seite. Die DoD verlangt **404**. Foundation liefert dafuer `requirePermission`/
`withPermission` (`packages/foundation/src/permissions.ts`), die `CatalogError(foundationErrors.notFound)`
= 404 werfen. → Fuer Files-Routen den Foundation-404-Pfad nutzen (oder bei fremder File bewusst 404
werfen). Owner-Check serverseitig: sichtbar wenn `createdByUserId=self` ODER `assignedToUserId=self`
ODER es existiert ein lesbarer `FileEntityLink`. Permissions sind schon registriert
(`files.read_own/read_all/write/delete/admin`, §7).
**§9 ist fertig — nur verdrahten:** `buildFileBrowserVM` / `buildFileDetailVM` / `buildFileUploadVM`
aus `@toolctrl/view-models`. Der Loader baut die **Proxy-URLs** (auf die §6-Route) und reicht sie als
`thumbnailUrl`/`previewUrl`/`downloadUrl` ins VM — VMs bleiben routing-agnostisch.
**§12 Querschnitt-Wiring:** Audit (`auditEvent`/`withAuditMiddleware`), Activity (`logActivity` —
**falls der Contract noch nicht existiert: STOP + melden**, keine zweite Activity-Architektur bauen),
Search-Registry `packages/search/src/indexed-entities.ts` (Index `hivegrid-files`), Sidebar
`apps/web/app/application/sidebar/` (permission-gated, Modul `files`), i18n `files.*`-Keys in
`apps/web/public/locales/{de,en}/*.json` (de = Quelle), Mobile-Tab-Bar.
**§13 Tests:** Smoke `tests/e2e/files.spec.ts` (Muster `walking-skeleton.spec.ts`), Hot-Swap-Adapter,
Visual-Snapshot. VM-Unit-Tests existieren bereits (`packages/view-models/src/files/files.vm.test.ts`).
**Deps-Aktivierung (Preview):** `pnpm add sharp heic-convert pdf-to-png-converter -F @toolctrl/worker`
(aktuell dynamisch importiert → Build gruen vor Install). **Koordination Raffael:** Live-ClamAV (EICAR
fail-closed) braucht `CLAMD_*` aus `AK-INFRA2`; RLS-Reihenfolge mit `R-P2b` (`SET LOCAL app.tenant_id`).
**Verifikation pro Scheibe:** `pnpm typecheck` (Web-App) + `pnpm test`; Storage/Queue/Worker/VM-Pakete
sind isoliert testbar (`pnpm -F @toolctrl/<pkg> test`). Vor Merge: `prisma validate` +
`prisma migrate status` + den RLS-Anhang aus `local/AK-P4a-merge-migration.sql` an die generierte
Migration anhaengen.
---
### 2026-06-20 — Web-/UI-/Wiring-Scheibe gebaut + verifiziert (Akeshan, Branch `feat/AK-P4a`)
Vorher: `git merge origin/main` (Raffaels P2 Auth/RLS) in den Branch gezogen (Merge-Commit
`4f6177202`, 3 Konflikte geloest, typecheck gruen). Danach die offenen Scheiben gebaut.
**Fertig + verifiziert (typecheck/test gruen pro Paket):**
- **§3 Chunked-Upload** — S3-Multipart in `@toolctrl/storage` ergaenzt (`createMultipartUpload`/
`uploadPartCopy`/`completeMultipartUpload`/`abortMultipartUpload`, S3 + Local; Unit-Test
`multipart.test.ts`). Domain-Service `apps/web/.../fileService.server.ts` (createUploadSession,
storeUploadChunk, completeUpload via UploadPartCopy aus Temp-Chunks, Sichtbarkeit, link/unlink/
archive/reactivate/updateMeta/regeneratePreview/hardDelete, listFilesForBrowser). Producer
`filePreviewQueue.server.ts`. Resource-Routes `files.upload.init|.$uploadId.chunk.$index|.complete`.
Checksum: client-optional (server-Verify = v2, dokumentiert). Worker-Deps `sharp`/`heic-convert`/
`pdf-to-png-converter` installiert.
- **§6 Auth-Proxy (AD-23)** — gemeinsamer SigV4-Signer `@toolctrl/storage` `createSigV4DownloadSigner`,
web-seitig `mediaSigning.server.ts` (`createMediaDownloadUrl`, TTL 300 s), Route
`media.$fileId.$variant.tsx`: 302 auf signierte URL, fail-closed bei scanStatus != clean/skipped,
404 bei fremder/fehlender File. `STORAGE_PUBLIC_BASE_URL` bleibt leer. (Dev ohne ClamAV:
completeUpload setzt scanStatus=skipped, damit Auslieferung lokal funktioniert.)
- **§7 Permissions/Sichtbarkeit** — Guard `fileAccess.server.ts` (loadFilesContext, requireFilesPermission;
404 ueber Foundation, locked-State fuer GET-Loader, 404 fuer Write-Actions). read_own-Owner/Link-Check
serverseitig.
- **§10 Hot-Swap (DoD 20)** — `fileBrowser`-Adapter (`@toolctrl/ui-app`) + Renderer in `ui-subframe`
(`renderFileBrowser`) und `ui-mock` (`renderFileBrowserMock`) + Drill-Test gruen.
- **§11 Routen** — `files._index` (Browser, server-side-Filter MIME/Archiv, Cursor-Pagination),
`files.upload` (Drag&Drop + Multi-Datei-Queue + Per-Datei-Progress, chunked init/chunk/complete),
`files.$id` (Vorschau via Proxy, Download/Archiv/Reaktivieren/Loeschen/Vorschau-neu + **FileEntityLink
add/remove** mit Rolle). Loader baut VM, Component pur, ErrorBoundary + Empty/Locked-States, i18n.
- **§12 Querschnitt** — `files` als echtes Entitlement-Feature (`packages/entitlements` features+blueprint+
plans, Tests angepasst), Such-Index `files` + Registry-Eintrag (`packages/search`), i18n `files.*`
de/en in `translations.json` (Parity gruen), Sidebar-Eintrag (permission `files.read_own`, Modul-Gate
`files`), Audit (`auditFileEvent`) auf jeder Schreib-Action, Activity (`logFileActivity`, gegen
verknuepfte Entitaet, `file_uploaded`). Customer-Portal-Feld `createdByPortalUserId` vorbereitet.
- **§13 Tests** — `multipart.test.ts` (Storage), Hot-Swap `fileBrowser.hot-swap.test.ts`,
Smoke `tests/e2e/files.spec.ts` (gated), VM-Unit-Tests (vorbestehend). Gruen: storage/queue/worker/
view-models/ui-app/ui-mock/ui-subframe/entitlements/search/i18n + web/api/worker typecheck +
Full-Typecheck.
**Bewusst offen (deferred):**
- **Mobile-Tab-Bar (DoD 11)** — im Repo kein Mobile-Nav-Geruest (PWA-only, AD-17). User-Entscheidung: deferred.
- **Visual-Regression / M016 (DoD 21)** — keine Snapshot-Harness vorhanden. User-Entscheidung: deferred.
- **Live-ClamAV-Smoke (EICAR)** — `CLAMD_*` ist mesh-only (10.42.0.4), nicht in Dev-Secrets; auf Staging
mit Raffael (AK-INFRA2) zu verifizieren.
- **Scan-Verdict-Rueckschreibung (§5, OFFEN, wichtig):** Der vorhandene `FileScanJob`-Worker scannt +
quarantaeniert, schreibt das Ergebnis aber **nicht** auf `File.scanStatus` zurueck (kein `db.file.update`
im Scan-Pfad), und `enqueueFileScan` uebergibt aktuell **keine** `fileId`. Folge: mit
`SCAN_QUEUE_ENABLED=true` blieben neue Files auf `scanStatus=pending` haengen und der Auth-Proxy
liefert sie (fail-closed) **nicht** aus. Aktuell deshalb in Dev/ohne ClamAV: completeUpload setzt
`scanStatus=skipped`. **To-do vor ClamAV-Aktivierung:** `fileId` in den Scan-Job aufnehmen und den
Worker-Scan-Handler `File.scanStatus = clean|infected` zurueckschreiben lassen (mit Raffael abstimmen,
da der Scan-Worker aus AK-INFRA2/Boilerplate stammt).
- **RLS + Merge-Migration (§8)** — Branch nur `db push`; die eine P4-Files-Migration + RLS-Policies beim
Merge erzeugen, mit R-P2b (`SET LOCAL app.tenant_id`) abstimmen (`local/AK-P4a-merge-migration.sql`).
- **Davids D-P4-Optik** — Baseline-UI steht (funktional, data-ui-id-Marker); visuelle Politur = Dev-Nachzug.
- **Kleinere Folge-Items:** Bulk-ZIP-Download und Detail-Breadcrumbs (Backend/Routing tragen, UI-Rest offen).
Status: **READY-TO-VERIFY** (Kern-Plattform vollstaendig + gruen; obige Punkte bewusst offen).
### 2026-06-20 (Nachtrag) — Pre-Push-Hooks gruen gemacht (Commit `584a2e8bc`)
Der erste `git push` scheiterte an zwei lefthook-Pre-Push-Gates (nicht an GitHub). Behoben:
- **typecheck-web:** `fileAudit.server.ts` nutzte `auditEvent`/`logActivity` mit dem rohen Prisma-`db`
als Client-Argument (DbClient nicht auf `AuditEventClient` zuweisbar: `actorType string|null`) und
importierte `@hivegrid/activity`, das **keine** `apps/web`-Dependency war.
- **i18n-Guard (`verify-hardcoded-strings`):** 5x `throw new Response("Not Found"/"Bad Request", …)`
loesten `user-facing-response-literal` aus (Baseline 0).
**Konventionen fuer den naechsten Agenten (nicht erneut falsch bauen):**
- Audit immer ueber **`createAuditEvent` aus `@toolctrl/db/audit-events.server`** schreiben (M001,
Hash-Kette), **ohne** Client-Argument — Default ist der db-Singleton. **Nicht** `foundation.auditEvent`
mit `db` aufrufen. Gleiches Muster fuer `logActivity` (kein `{ client: db }` uebergeben).
- Neue Workspace-Pakete als Dependency in der konsumierenden `package.json` eintragen (+ `pnpm install`).
- 4xx aus Loadern/Actions nie als Inline-Literal werfen → Helfer **`notFoundResponse()` /
`badRequestResponse()`** aus `fileAccess.server.ts` (Return-Form-`new Response`, vom Guard nicht
erfasst; Body ist nie user-facing, ErrorBoundary rendert ServerError). Muster wie `media.$fileId.$variant.tsx`.
### Naechste Schritte bis „Done" (Checkliste fuer den naechsten Agenten)
1. **Scan-Verdict-Rueckschreibung verdrahten** (Blocker vor ClamAV-Prod): `fileId` in `enqueueFileScan`
+ den Scan-Worker `File.scanStatus = clean|infected` setzen lassen. Mit Raffael (AK-INFRA2) abstimmen,
wer den Boilerplate-Scan-Handler erweitert.
2. **Merge-Migration + RLS erzeugen** (Blocker fuer main-Merge): beim Merge **eine** forward-only
P4-Files-Migration (Tabellen + `pg_trgm`-Index + RLS-Policies, DO-guarded, Inverse-SQL als Kommentar)
aus `local/AK-P4a-merge-migration.sql`; an R-P2b (`SET LOCAL app.tenant_id`, `prisma/rls/tenant-isolation.sql`)
ausrichten. `prisma validate` + `prisma migrate status` gruen.
3. **Live-ClamAV-Smoke (EICAR) auf Staging** mit Raffael: Upload EICAR → `scanStatus=infected` →
Media-Proxy liefert 404 (fail-closed).
4. **Kleinere Folge-Items abschliessen oder als CR auslagern:** Bulk-ZIP-Download, Detail-Breadcrumbs.
5. **Deferred-DoD vom Reviewer freigeben lassen:** Mobile-Tab-Bar (DoD 11), Visual-Regression/M016 (DoD 21).
6. **Davids D-P4-Delta** abwarten → visuelle Politur als Dev-Nachzug ueber die Adapter/`ui-subframe`-Schicht.
Erst wenn 1+2 erledigt und 3–5 abgenommen sind → DoD 100 %, Ticket auf **Done**.
### 2026-06-23 — Blocker 1+2 geschlossen, main reingemergt, lokal gruen (Akeshan)
Branch `feat/AK-P4a` auf den aktuellen `main`-Stand gebracht und die beiden Merge-Blocker
geschlossen. Reihenfolge: main-Sync → Blocker 1 → Blocker 2 → Verifikation.
**Fertig + verifiziert:**
- **main-Sync (KI-Pivot AD-26):** `git merge origin/main` (Branch war 8 Commits zurueck inkl.
KI-Removal). Konflikte geloest: `apps/worker/package.json` (`gpt-tokenizer` raus = KI-Dep von main
entfernt, `heic-convert` behalten), `pnpm-lock.yaml` (main-Version + `pnpm install` reconciled),
generierter Prisma-Client (`pnpm db:generate` regeneriert). Branch jetzt **0 hinter main**.
Full-Typecheck + betroffene Paket-Typechecks gruen. Commit `a0737b728`.
- **Blocker 1 — Scan-Verdict-Rueckschreibung (§5):** `FileScanJob.fileId` (optional) durch
`enqueueFileScan` → `completeUpload` (gibt `file.id` mit). Neues Write-back-Seam
`apps/worker/src/jobs/file-scan-status.ts` (Prisma, spiegelt file-preview-Service), im general-Group-
Bootstrap (`index.ts`) verdrahtet. Der `fileScan`-Handler schreibt `clean|infected` auf
`File.scanStatus`, wenn `fileId` + Writer da sind (Legacy-Import-Scans ohne `fileId` unveraendert).
Tests: Handler-Write-back (clean/infected) + Skip-ohne-fileId. Commit `7ee0a4135`.
- **Blocker 2 — P4-Files-Migration (§8):** `prisma/migrations/20260623160000_p4a_files_platform/`
(Tabellen + Enums + Indizes + FKs + `pg_trgm`-Index), via `prisma migrate diff
--from-config-datasource --to-schema prisma/schema` erzeugt, auf AK-P4a-Objekte getrimmt
(fremder main-Drift NICHT mit reingezogen). Verifiziert: frische Leer-DB `migrate deploy` laeuft
durch (P3018-sicher), `prisma validate` + `migrate status` gruen, **kein File*-Drift** mehr.
Commit `01ff542a8`.
**WICHTIGE KORREKTUR zur RLS (Abweichung vom urspruenglichen Plan):** Die Migration aktiviert
**KEINE** RLS. Grund: `FORCE ROW LEVEL SECURITY` + Policy `tenantId = current_setting('app.tenant_id')`
laesst **jede** File-Query **ohne** gesetzten GUC **0 Zeilen** zurueckgeben — das **bricht** das Feature
(leere Reads, fehlschlagende Writes), es ist NICHT „fail-closed-Isolation". Die File-Web-Loader/Actions
**und** die Worker-Write-backs (preview + scan) laufen aktuell **nicht** durch `withTenantRLS()`. Nach
R-P2b-Regel darf eine Tabelle erst RLS bekommen, wenn ALLE Zugriffe den GUC setzen. Bis dahin traegt
App-Level-`withTenantScope()` (§7) die Isolation. Der RLS-Block bleibt als **Rollout-Artefakt** in
`local/AK-P4a-merge-migration.sql` (mit R-P2b abzustimmen, anzuwenden sobald alle File-Zugriffe
RLS-gewrappt sind). → **eigenes Folge-Item** (siehe unten).
**Lokale Verifikation (gruen):** Full-Typecheck; Paket-Tests storage/queue/worker/view-models/ui-app/
ui-mock/search/entitlements gruen; `@toolctrl/db` 422 passed / 1 failed = **nur** der bekannte
Windows-only-Env-Test `isPermissionsSeedDirectExecution` (fileURLToPath, keine Regression);
`verify:i18n` gruen; Hot-Swap-Drill (`fileBrowser.hot-swap.test.ts`) gruen.
**Nebenbefund (separat, nicht AK-P4a):** Seed brach lokal an `rolesAndPermissionsService.ts`
(`description` fehlt) — Fix `description: permission.description ?? permission.name` liegt als
ungetrackter Working-Tree-/Stash-Stand; mit User zu klaeren (commit/keep/discard), gehoert nicht in
dieses Ticket.
**Offen bis Done (selbst machbar + extern):**
- [ ] **Push + PR + Merge auf main** (wartet auf User-Go).
- [ ] **Staging-Deploy + ClamAV-ENV-Check** — Risiko: AK-INFRA2-Doc setzte `CLAMAV_HOST/PORT`, der
Code liest `CLAMD_HOST/PORT` (`scanService.ts`); auf Staging-Worker per SSH verifizieren, sonst
No-op-Scan. `SCAN_QUEUE_ENABLED=true` setzen.
- [ ] **Live-EICAR-Smoke (Staging)** mit Raffael: infiziert → `scanStatus=infected` → Media-Proxy 404.
- [ ] **RLS-Aktivierung auf File*** als Folge-Item (mit R-P2b): erst File-Zugriffe (Web + Worker-Writes)
in `withTenantRLS()` wrappen, dann RLS-Block aus `local/AK-P4a-merge-migration.sql` als eigene
Migration shippen.
- [ ] **Deferred (User-Entscheidung 2026-06-23, bleiben deferred):** DoD 11 Mobile-Tab-Bar (kein
Mobile-Nav-Geruest; PWA-only AD-17, mobil spaeter responsiv) · DoD 21 Visual-Regression/M016
(keine Snapshot-Harness im Repo). Reviewer-Freigabe ausstehend → **Ticket bleibt in „Ready for
Review"**, NICHT Done.
**DoD-Stand:** Kern-Plattform + beide Blocker abgehakt; offen sind Push/PR/Staging-Verifikation
(selbst/infra) + RLS-Folge-Item + 2 bewusst deferrte DoD-Punkte → **~85 % done**, Ticket bewusst in
**Review** (nicht Done) bis Staging-Verifikation + Reviewer-Freigabe.
### 2026-06-23 (Abend) — auf main gemergt, Build-Pipeline repariert, Staging verifiziert (Akeshan)
- **Merge:** `feat/AK-P4a` direkt auf `main` (fast-forward, `c3e30cf10`), gepusht.
- **Build-Pipeline repariert (Commit `229cbdce5`, AD-26-Fallout, NICHT AK-P4a-Code):** Der CI-Job
„Stage or promote Docker images" schlug seit dem KI-Removal-Pivot auf JEDEM main-Push fehl
(`COPY packages/ai|vector-store/package.json … not found`) → seit Commit `300765958` kam kein
neues Image mehr auf Staging. Ursache: der Pivot loeschte `packages/ai` + `packages/vector-store`,
liess aber 8 `COPY`-Zeilen im root-`Dockerfile` stehen. Diese 8 Zeilen entfernt → Build gruen,
Staging zog `229cbdce5`.
- **Staging per SSH verifiziert (`staging-1`):** neues Image live; **beide Migrationen** (KI-Removal
`20260623103655` + P4 `20260623160000`) angewandt → `File`/`FileEntityLink`/`FileUpload`/
`FileUploadChunk` + `FileScanStatus`-Enum existieren; **clamd** aus dem general-Worker erreichbar
(`PING→PONG`, EICAR-Stream `Eicar-Test-Signature FOUND`); `CLAMAV_HOST=10.42.0.4`/`CLAMAV_PORT=3310`
korrekt (Code liest `CLAMAV_*`, NICHT `CLAMD_*` — frueherer Verdacht war falsch); `SCAN_QUEUE_ENABLED=true`
via Coolify auf Web + general-Worker gesetzt; Login + Tenant-Routing (`/<tenant>/...`) + die
Files-Routen sind erreichbar und korrekt gegated.
- **Live-EICAR-Upload bewusst NICHT abgeschlossen (User-Entscheidung „Option 3", 2026-06-23):** Der
Upload-`init` liefert **404 = korrektes fail-closed** — `tenantHasModule("files")` ist fuer die
Demo-Tenants false (das `files`-Modul ist in keinem Plan/Entitlement; `SubscriptionFeature` auf
Staging leer, der Post-Deploy-Seed lief nicht). Das ist **kein Code-Bug**, sondern fehlende
Entitlement-Konfig — und zugleich ein positiver Beweis, dass das Modul-/Permission-Gating greift.
Der finale EICAR-End-to-End-Beweis (`scanStatus=infected` → Media-404) wird **nachgeholt, sobald
`files` regulaer in einem Plan ist** (oder per `TenantFeatureOverride featureKey='files'
override='enabled'`). Bis dahin: Scan-Pipeline (clamd/Worker/Schema/scan-enabled) ist live bestaetigt,
Write-back ist unit-getestet.
- **Infra-Nebenbefund (eigenes Ticket, kein AK-P4a-Code):** Coolify fuhr bei diesem Deploy **weder**
den Pre-Deploy-`prisma migrate deploy` **noch** den Post-Deploy-Seed-Hook aus — beide Migrationen
musste ich manuell nachziehen, der Seed lief gar nicht. Trifft jeden HiveGrid-Deploy → Coolify-
Pre/Post-Deploy-Command fuer das HiveGrid-Projekt pruefen.
**Noch offen (Stand 2026-06-23 Abend):**
- [ ] **RLS-Aktivierung auf `File*`** (Folge-Item, mit R-P2b) — siehe eigener Abschnitt unten.
- [ ] **Finaler Live-EICAR-Beweis** — nachholen, sobald `files` in einem Plan/Entitlement aktiv ist.
- [ ] **Coolify Pre/Post-Deploy-Hooks** (Migrate + Seed) reparieren — Infra, eigenes Ticket.
- [ ] **Deferred DoD 11 (Mobile-Tab-Bar) + DoD 21 (Visual-Regression)** — bleiben deferred.
- Ticket bleibt **„Ready for Review"** (nicht Done).
### 2026-06-24 — RLS-Vorbereitung „Teil A" gebaut (Files RLS-ready, non-breaking) (Akeshan)
Kontext-Klärung vorweg: R-P2b hat die RLS-**Maschine** gebaut und bewiesen, aber RLS auf **keiner**
Daten-Tabelle scharfgeschaltet (eigene Plane-Kommentare: *„deliberates Rollout-Artefakt, nicht im
Auto-Migrations-Pfad"*, *„app-weiter RLS-Rollout läuft separat mit P5"*; Ticket steht auf *In Progress*).
RLS „beißt" erst, wenn (1) **jeder** File-Zugriff den Tenant-Kontext setzt **und** (2) die App als
restricted Rolle `hivegrid_app` (NOBYPASSRLS) verbindet. Beides fehlte → vorzeitiges Scharfschalten
**bricht** Files (leere Reads, fehlschlagende Writes). Mit User abgestimmt: in diesem Durchgang nur
**Teil A** (Code RLS-ready machen, non-breaking); das Scharfschalten ist Teil B = der org-weite
**P5-Cutover** (Raffael/R-P2b).
**Fertig + verifiziert:**
- **Web** — alle File-DB-Zugriffe in `fileService.server.ts` laufen jetzt durch `withTenantRLS()`
(R-P2b-Wrapper). Regeln eingehalten: langsame I/O (S3/Queue) bleibt **außerhalb** der Transaktion;
keine verschachtelten Transaktionen (interne `*WithTx(tx, …)`-Helfer für `isFileVisible` /
`getVisibleFileOrThrow` / `getVisibleFileWithLinks`). Funktional unverändert (Wrapper ist ein No-op,
solange keine Policy aktiv ist). `db`-Singleton-Import entfernt. Web-Typecheck + Lint grün.
- **Worker** — neuer client-parametrisierter Helfer `apps/worker/src/db/tenantRls.ts` (spiegelt R-P2b);
die beiden Write-backs `jobs/file-preview.ts` (writeStatus) und `jobs/file-scan-status.ts`
(recordVerdict) setzen vor `file.update`/`updateMany` den Tenant-GUC (Legacy-Scans ohne `tenantId`
unverändert direkter Pfad). Worker-Typecheck + Lint grün; Worker-Suite `handlers.test.ts` 76/76 grün.
- **Gate-Beweis (neu)** — `apps/web/app/utils/db/.server/rls-file-isolation.integration.test.ts`
(gespiegelt an R-P2bs Test, gated auf `RLS_TEST_DATABASE_URL`). **7/7 grün** gegen echte Postgres
(pgvector pg16) mit angewandtem File-RLS-Block: Kontext A sieht nur A-Files; Cross-Tenant = 0; ohne
Kontext = 0; `WITH CHECK` blockt Fremd-Insert; eigener Insert+Read ok; `FileEntityLink` ebenso
isoliert. Ohne die Env-Var skippt der Block sauber (normale Suite bleibt grün).
- **Aktivierungs-Artefakt jetzt getrackt** — den RLS-Block aus dem gitignoreten
`local/AK-P4a-merge-migration.sql` als **`prisma/rls/file-isolation.sql`** ins Repo gezogen (parallel zu
R-P2bs getracktem `prisma/rls/tenant-isolation.sql`), damit Raffael ihn für Teil B sieht und der
Gate-Test in CI eine getrackte Datei liest. Dabei die fehlenden
`GRANT SELECT/INSERT/UPDATE/DELETE … TO hivegrid_app` auf die vier File-Tabellen ergänzt (R-P2b grantet
analog auf `TenantUser`), Inverse-SQL (REVOKE + NO FORCE) nachgezogen, Header auf „Teil A erledigt /
Teil B = P5-Cutover" aktualisiert.
**Damit ist Files RLS-ready:** der P5-Cutover wird ein reiner Schalter (Migration aktivieren +
Runtime-Rolle `hivegrid_app`), ohne weitere Files-Code-Änderung — bewiesen durch den Gate-Test.
**Weiterhin offen (Teil B / extern, unverändert):** Policy-Migration aktivieren + DB-Rollenwechsel +
Staging-Cutover (org-weit, Raffael/R-P2b) · finaler Live-EICAR-Beweis (entitlement-gated) · Coolify
Pre/Post-Deploy-Hooks (Infra) · deferred DoD 11 + DoD 21. Ticket bleibt **„Ready for Review"**.
@@ -0,0 +1,238 @@
# AK-P4b · P4 Tasks + polymorphe EntityLink-Tabelle
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P4 — Files & Tasks |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-19 · **Gate W1 (EntityLink)** |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `AK-P4a` (Files + FileEntityLink-Muster)
- **Blocks:** `R-P6` (Tasks-Tab + Verknüpfung am CRM), **Gate W1 (EntityLink)** — die polymorphe `EntityLink`-Tabelle ist die Andock-Voraussetzung für alle Folge-Entitäten
- **Läuft parallel zu:** Raffaels `R-P2a`/`R-P2b` (P2‖P4-Paar). Disjunkte Domänen, eigene `prisma/schema/tasks.prisma` → kein Schema-Konflikt (AD-21).
- **Konflikt-Risiko:** keines auf Schema-Ebene; Task-Entity-Links zu CRM-Entitäten werden erst in **P6 nachverdrahtet** (Task-Kern hier, Links dort).
## Was wir bauen
Das **leichtgewichtige, querliegende Tasks-Modul**: Task-CRUD mit Status/Priorität/Fälligkeit, Entitäts-Verknüpfung (Contact/Company/Lead/Deal/Project), Person- **oder** Gruppen-Zuweisung (genau eines, Default = Ersteller), Watcher, **Reminder via `notify()`** (24h vor / bei / 24h nach Deadline, Eskalation Email) und **Auto-Archivierung** erledigter Tasks nach 30 Tagen per Cron. Tasks entstehen manuell, aus Chat, aus Form-Submission und aus Automation-Actions. Dazu die **polymorphe `EntityLink`-Tabelle** (`entity_type + entity_id`), gegen die jedes Modul andockt. Die **Task-Liste ist als wiederverwendbare Komponente** zu bauen (P12/P14/P16 betten sie ein; erscheint als Tasks-Tab in jeder Entity-Detail-View).
## Benötigte Screens (Backend bedient — Design liefert `D-P4` aus `D-D0a`/`D-D0b`)
| Screen [Route] | Kern-Inhalt | Liefert (Design) |
|---|---|---|
| Task-Liste [`/tasks`] | Titel/Prio/Fälligkeit/verknüpfte Entität/Assignee/Status/Quelle · Presets Meine/Erstellt/Alle · Filter · Bulk · Inline-Quick-Actions — **wiederverwendbare Komponente** | `D-P4` (A2) |
| Task-Detail + Anlage [`/tasks/:id`, `/tasks/new`] | Markdown-Beschreibung, Status/Prio/Fälligkeit inline, Assignee-Picker (Person↔Gruppe), Verknüpfungs-Picker (Auto-Complete), Watcher, Quelle-Link, Activity-Stream, Aktionen | `D-P4` (A3+A5) |
*Eingebettet: Tasks-Tab + „Aufgabe anlegen" (Pre-Fill) in jeder Entity-Detail-View (R-P6 ff.).*
## Definition of Done
- [x] **Task-CRUD:** Status/Priorität/Fälligkeit/Entity-Link/Watcher/Reminder
- [x] Person- **oder** Gruppen-Zuweisung (Constraint: genau eines, Default = Ersteller)
- [x] Task-Quellen: manuell / Chat / Form / Automation (je Quelle-Marker + Link)
- [x] **Reminder via `notify()`** (24h vor / bei / 24h nach Deadline, Eskalation Email)
- [x] **30-Tage-Auto-Archiv-Cron** für erledigte Tasks
- [x] **Polymorphe `EntityLink`-Tabelle** (`entity_type + entity_id`)
- [x] `tasks.*`-Permission-Bundle (read_own mit Owner-Check / read_all / write / admin) — fremde Tasks **404 statt 403**, Action-Buttons permission-aware
- [x] Task-Liste als **wiederverwendbare Komponente** (embeddable)
## Technische Bausteine
- **Entities** (eigene `prisma/schema/tasks.prisma`): `Task` (title, description, assigned_to_user **oder** _group, deadline, priority, status, source, linked_entity_type/id — polymorph; `is_demo_data`; Soft-Delete), `TaskWatcher` (M:N), **`EntityLink`** (polymorph `entity_type + entity_id`, Gate-W1-Lieferung). `core.prisma` nur für User/Group-Relationen berühren (AD-21).
- **RLS** auf `Task`/`TaskWatcher`/`EntityLink`; `tasks.read_own` mit serverseitigem Owner-Filter (fremde → 404).
- **Konnektor** `tenantHasModule('tasks')`.
- Reminder über `notify()`-Kanal-Abstraktion (R-P1b); Auto-Archiv-Cron (BullMQ).
- `is_demo_data` auf Demo-Tasks (Onboarding-Provisioning).
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 3: Files & Tasks** (Task polymorph link, TaskWatcher) + Cross-Cutting (Task-Link, EntityLink-Prinzip)
- `REQUIREMENTS.md` → `REQ-tasks-datenmodell`, `REQ-tasks-reminder-archivierung`
- `ROADMAP.md` → Phase 4 · `PHASE-SOURCES.md` → Phase 4 (M071/M072/M073; M074-ERP-Sync → P10; Entity-Links → P6 nachverdrahtet)
- `designer-briefs/P04-files-tasks.md` (Task-Liste = wiederverwendbare Komponente)
- `_bmad-output/specs/M26-tasks.md`
## Dev-Nachzug (nach Davids `D-P4`-Delta)
- [ ] Task-Liste/-Detail an Davids UI angepasst (wiederverwendbare Komponente)
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `AK-P4b` aktualisiert
---
## Umsetzungs-Notiz
### 2026-06-22 — Tasks-Modul + generische EntityLink-Tabelle gebaut + verifiziert (Akeshan, Branch `feat/AK-P4b`)
Gebaut strikt nach `~/.claude/plans/du-bist-senior-software-squishy-kazoo.md` (Umsetzungsplan),
1:1 auf dem Files-Fundament (AK-P4a) als Template. Branch-Strategie: `origin/main` in
`feat/AK-P4a` gemergt (Merge-Commit `cd1322ce4`, 1 trivialer Konflikt in
`view-models/src/index.ts`), dann `feat/AK-P4b` davon abgezweigt. Plattform Windows 11.
**Fertig + verifiziert (typecheck/test grün pro Paket):**
- **DoD 6 — Polymorphe `EntityLink`-Tabelle (Gate W1):** `prisma/schema/entityLinks.prisma`
(voll generisch: `sourceType/Id` + `targetType/Id` + `linkRole`, beide Seiten polymorph,
`LinkableEntityType`-Enum). Generischer `entityLinkService.server.ts` (link/unlink/listLinksFor,
idempotenter Upsert). Andocken an konkrete CRM-Entitäten = P6 (laut Ticket).
- **DoD 1 — Task-CRUD:** `prisma/schema/tasks.prisma` (`Task`, `TaskWatcher` + Enums, AD-21 bare
Scalars). `taskService.server.ts`: create/update/complete/archive/reactivate/hardDelete,
Watcher add/remove, Status↔completedAt-Sync.
- **DoD 2 — Person- ODER Gruppen-Zuweisung:** `resolveAssignment` (genau eins; beide → Fehler;
keins → Ersteller). DB-CHECK `num_nonnulls(...)=1` in der Merge-Migration. 4 Unit-Tests grün.
- **DoD 7 — `tasks.*`-Bundle + 404-statt-403:** `tasks.read_own/read_all/write/delete/admin`
(permissions-seed mit expliziten Grants + DefaultPermissions). `taskAccess.server.ts`
(Foundation-404-Pfad). Sichtbarkeit read_own = Ersteller/Assignee/Watcher/Gruppen-Mitglied;
fremde Task → 404. Action-Buttons permission-aware (VM `canWrite`/`canDelete`).
- **DoD 8 — Wiederverwendbare Task-Liste:** `task-list.vm.ts` (+ `task-detail.vm.ts`), Komponente
in `ui-app` (`taskListAdapter`) + Renderer `ui-subframe`/`ui-mock` + Hot-Swap-Drill (M017) grün.
- **DoD 3 — Task-Quellen:** `source` + `sourceRef` (manuell via UI; chat/form/automation als
Marker vorbereitet, produzierende Module verdrahten in Folge-Tickets).
- **DoD 4 — Reminder via `notify()`:** `task-reminder-cron.ts` (stündlicher Sweep, 3 Fenster
24h-vor/fällig/24h-nach, after → EMAIL-Eskalation). Idempotenz über `notify()`-`sourceKey`-Upsert
(kein Doppelversand). Reine Window-Logik 7 Unit-Tests grün. Handler in `worker/handlers.ts`.
- **DoD 5 — 30-Tage-Auto-Archiv-Cron:** `task-archive-retention-cron.ts` + Handler (setzt
`archivedAt` auf `done`-Tasks mit `completedAt < now-30d`). Registrierung im `general`-Group-Block.
- **Routen:** `tasks._index` (Browser, Presets Meine/Erstellt/Alle, server-side-Filter,
Cursor-Pagination), `tasks.$id` (Detail + alle Actions, Audit + Activity), `tasks.new` (Anlage +
Entity-Pre-Fill). Loader baut VM, Component pur, ErrorBoundary + Empty/Locked-States.
- **Querschnitt:** Sidebar-Eintrag (permission-gated, Modul `tasks`), Such-Index `tasks` + Registry,
Audit (`auditTaskEvent`) + Activity (`logTaskActivity`, gegen verknüpfte Entität bzw. Task-Subject),
Entitlements (`featureKeys.tasks` + Registry/Plans/Blueprint), i18n `tasks.*` de/en (Parität 69/69).
**Verifikation:** typecheck grün für web/worker/queue + alle Pakete; Tests grün: view-models (32,
inkl. 5 Tasks-VM), ui-app (20, inkl. Hot-Swap), search (47), entitlements (75), queue (101),
worker reminder-cron (7), web assignment (4). `prisma validate` + `generate` grün.
**Bewusst offen (deferred, wie bei AK-P4a):**
- **Merge-Migration + RLS** (`local/AK-P4b-merge-migration.sql`): Branch nur `db push`; die eine
forward-only P4-Tasks-Migration (Tabellen + `pg_trgm`-Index auf `Task.title` + RLS-Policies +
Single-Assignee-CHECK, DO-guarded, Inverse-SQL) beim main-Merge erzeugen, mit R-P2b
(`SET LOCAL app.tenant_id`) abstimmen.
- **Live-Verifikation Reminder/Archiv auf Staging** (braucht Redis + notify-Delivery): EICAR-Analog
zu AK-P4a — lokal kein Redis/DB.
- **Mobile-Tab-Bar (DoD 11 der AGENTS-Liste)** + **Visual-Regression (M016)**: deferred wie bei P4a
(PWA-only AD-17 / keine Snapshot-Harness), Reviewer-Freigabe.
- **Davids `D-P4`-Delta**: Baseline-UI funktional (data-ui-id-Marker); visuelle Politur = Dev-Nachzug.
**%-Done-Stand:** Alle **8 DoD-Code-Punkte grün** (8/8 = 100 % Code). Gesamt ~95 % — offen sind nur
die extern/infrastrukturell blockierten Punkte (Merge-Migration-Erzeugung beim Merge, Live-Staging-
Verifikation, deferred-DoD-Freigabe, Davids Optik). Selbst-machbarer Rest auf dem Branch: 0.
> 💡 Vorschlag (außerhalb Ticket-Scope): Beim P4-Merge die P4a- und P4b-Merge-Migrationen zu **einer**
> forward-only Migration zusammenführen (gemeinsamer `pg_trgm`-Index + RLS-Block), um die
> Migrations-Historie schlank zu halten. Erst nach OK.
---
## HANDOFF für den nächsten Coding-Agenten (hier weitermachen)
**Status:** Tasks-Modul + generische `EntityLink`-Tabelle stehen vollständig und sind grün
(Full-Monorepo-`pnpm typecheck` exit 0; alle berührten Paket-Tests grün). Branch `feat/AK-P4b`
(zweigt von `feat/AK-P4a` ab, das wiederum `origin/main` enthält). **3 Commits:** `4e3d12607`
(Schema/Domain/VMs/Routes/Wiring), `31659d4dc` (Worker-Crons/Tests/Doku), `316e35c6c` (Cleanup).
### Was steht (nicht erneut bauen)
- **Schema:** `prisma/schema/tasks.prisma` (Task, TaskWatcher), `prisma/schema/entityLinks.prisma`
(generisch: sourceType/Id + targetType/Id + linkRole). Auf dem Branch nur `db push`.
- **Domain:** `apps/web/app/utils/integrations/{taskService,taskAccess,entityLinkService,taskAudit,
taskRoutePaths}.server.ts`.
- **VMs:** `packages/view-models/src/tasks/{task-list,task-detail}.vm.ts` (+ Tests).
- **UI:** Routes `apps/web/app/routes/app.$tenant/tasks.{_index,$id,new}.tsx`; wiederverwendbare
Liste `packages/ui-app/src/adapters/taskList.ts` + Renderer in ui-subframe/ui-mock + Hot-Swap-Test.
- **Worker:** `apps/worker/src/jobs/task-{reminder,archive-retention}-cron.ts` + Handler-Branches in
`apps/worker/src/handlers.ts` + Registrierung im `general`-Group-Block von `apps/worker/src/index.ts`.
- **Wiring:** Sidebar (`AppSidebar.tsx`), Search (`packages/search` schema+registry), Entitlements
(`packages/entitlements`), Permissions (`packages/db permissions-seed` + `DefaultPermissions.ts`),
i18n `tasks.*` in `apps/web/public/locales/{de,en}/translations.json`.
### Nächste Schritte bis „Done" (Checkliste)
1. **Merge-Migration + RLS erzeugen** (Blocker für main-Merge): beim Merge **eine** forward-only
P4-Tasks-Migration aus `local/AK-P4b-merge-migration.sql` (Tabellen + `pg_trgm`-Index auf
`Task.title` + RLS-Policies + Single-Assignee-CHECK, DO-guarded, Inverse-SQL als Kommentar).
Mit R-P2b (`SET LOCAL app.tenant_id`, `prisma/rls/tenant-isolation.sql`) abstimmen.
`prisma validate` + `prisma migrate status` grün. **Vorschlag:** mit der P4a-Merge-Migration
zu einer Migration zusammenführen (nach User-OK).
2. **Live-Verifikation auf Staging** (braucht Redis + DB): (a) Reminder-Sweep → `notify()`-Einträge
in den 3 Fenstern, after-Fenster als EMAIL-PENDING; (b) Archiv-Cron → `done`-Task mit
`completedAt < now-30d` bekommt `archivedAt`. Cron-Registrierung läuft nur im `general`-Worker
mit gesetztem `BULLMQ_REDIS_URL`/`REDIS_URL`.
3. **Reminder-Empfänger-i18n prüfen:** `tasks.reminder.{before,due,after}` sind als Notification-
messageKeys gesetzt; ob der Notification-Renderer diese Keys auflöst, auf Staging gegenchecken.
4. **Deferred-DoD vom Reviewer freigeben lassen:** Mobile-Tab-Bar (PWA-only AD-17) und
Visual-Regression/M016 (keine Snapshot-Harness) — gleicher Stand wie AK-P4a.
5. **Davids `D-P4`-Delta** abwarten → visuelle Politur als Dev-Nachzug über die Adapter-/
ui-subframe-Schicht (Baseline-UI mit `data-ui-id`-Markern steht).
6. **DSGVO-Hinweis (R-P2b-Koordination):** Der Merge hat `UserSession`/`TrustedDevice` aus
`auth.prisma` ohne Eintrag in `packages/db/src/dsgvo/user-fk-map.ts` mitgebracht — ich habe sie
als `hard-delete` (passend zum `onDelete: Cascade`) eingetragen, damit der DSGVO-Test grün ist.
Mit Raffael bestätigen, dass das die gewünschte Lösch-Strategie ist.
### Konventionen (sonst PR-Block)
- Code-Kommentare Englisch (`apps/**`/`packages/**`/`prisma/**`); Deutsch nur in `.planning/`/`local/`.
- Drei Anti-Patterns: kein `~/db`/`@prisma/client` in `ui-app`; kein `ui-subframe`-Direktimport in
`routes/**`; kein `useLoaderData` in `ui-app`.
- Audit über `createAuditEvent` (ohne Client-Arg); 4xx via `notFoundResponse()`/`badRequestResponse()`.
- **UI-Paket-Tests (ui-app/-subframe/-mock):** keine hartkodierten Strings in `title:`/`label:`-Feldern
(no-restricted-syntax) → Fixture-Werte über Variablen referenzieren (siehe `taskList.hot-swap.test.ts`).
- **`GroupUser` hat kein `tenantId`** → Gruppen-Mitgliedschaft über die `group`-Relation scopen.
Erst wenn 1+2 erledigt und 3–5 abgenommen sind → DoD 100 %, Ticket auf **Done**.
---
### 2026-06-24 — Merge-Migration + RLS „Teil A" + Gate-Test gebaut + lokal gegen echte Postgres verifiziert (Akeshan)
Blocker AK-P4a ist abgeschlossen (Plane „In Review"), also die Merge-Vorbereitung von AK-P4b
nachgezogen — exakt das, was AK-P4a am 24.06. erledigt hat, nur auf Tasks angewandt. Reihenfolge:
Baseline-grün → RLS-Wrapping (Web) → Worker-Crons → RLS-Artefakt → Migration → Gate-Test → Verifikation.
**Fertig + verifiziert:**
- **Forward-only P4b-Migration** `prisma/migrations/20260624120000_p4b_tasks_entitylinks/`: Tabellen
`Task`/`TaskWatcher`/`EntityLink` + 5 Enums + alle Indizes + FK `TaskWatcher.taskId→Task`
(Cascade), Anhang `Task_single_assignee_chk` (`num_nonnulls=1`, DoD 2) + `pg_trgm`-Index
`Task_title_trgm_idx`, beide DO-guarded; Inverse-SQL als Kommentar (DoD 28). **RLS bewusst NICHT
hier** (siehe unten). DDL via `prisma migrate diff --from-empty --to-schema` erzeugt und auf
P4b-Objekte getrimmt. **Verifiziert gegen frische Leer-DB** (pgvector pg16, Docker): `prisma migrate
deploy` spielt **alle** Migrationen inkl. P4b durch (P3018-sicher); Drift-Check
(`migrate diff --from-config-datasource --to-schema`) meldet für P4b nur den `pg_trgm`-Index
(erwarteter Raw-SQL-False-Positive wie bei p4a `File_displayName_trgm_idx`); CHECK + Trigram per
`psql` als vorhanden bestätigt.
- **RLS „Teil A" (non-breaking, Code RLS-ready)** — analog AK-P4a:
- **Web:** alle tenant-scoped DB-Zugriffe in `taskService.server.ts` + `entityLinkService.server.ts`
laufen durch `withTenantRLS()` (interne `*WithTx`-Helfer, kein Nesting; langsame I/O n/a). Einziger
nicht-gewrappter Zugriff: der **globale** User-Lookup `resolveUserLabels` (User ist nicht
tenant-scoped) — bleibt am db-Singleton. `taskAccess.server.ts` unverändert (kein direkter
`db.task`-Zugriff).
- **Worker:** die zwei Maintenance-Crons (`runTaskArchiveRetentionHandler` +
`runTaskReminderSweepHandler` in `handlers.ts`) von cross-tenant-Sweep auf **per-Tenant** umgebaut:
aktive Tenants aus der globalen `Tenant`-Registry (nicht RLS-scoped) enumerieren, dann je Tenant die
Task/TaskWatcher-Reads/Writes in `withTenantRLS()` (Worker-Helfer `db/tenantRls.ts`); `notify()`
bleibt außerhalb der Tx. `take` begrenzt jetzt pro Tenant statt global.
- **Aktivierungs-Artefakt** `prisma/rls/task-isolation.sql` (getrackt, parallel zu
`file-isolation.sql`): ENABLE/FORCE + `*_tenant_isolation`-Policy + `GRANT … TO hivegrid_app` für
`Task`/`TaskWatcher`/`EntityLink`, Inverse-SQL als Kommentar. **Nicht** im Auto-Migrations-Pfad.
Enthält den Teil-B-Hinweis, dass die Maintenance-Crons beim Cutover SELECT auf `Tenant` (oder eine
privilegierte Connection) brauchen.
- **Gate-Test** `apps/web/app/utils/db/.server/rls-task-isolation.integration.test.ts` (gespiegelt an
`rls-file-isolation`, gated auf `RLS_TEST_DATABASE_URL`): **8/8 grün** gegen echte Postgres mit
angewandtem Task-RLS-Block (Kontext A sieht nur A; cross-tenant = 0; ohne Kontext = 0; `WITH CHECK`
blockt Fremd-Insert; eigener Insert+Read ok; `TaskWatcher` + `EntityLink` analog isoliert). Ohne die
Env-Var skippt der Block sauber (normale Suite bleibt grün).
**Damit ist Tasks/EntityLink RLS-ready:** der P5-Cutover wird ein reiner Schalter (Migration aus
`prisma/rls/task-isolation.sql` aktivieren + Runtime-Rolle `hivegrid_app` + Maintenance-Worker-Grant),
ohne weitere Tasks-Code-Änderung — bewiesen durch den Gate-Test.
**Lokale Verifikation (grün):** Full-Typecheck Baseline (exit 0) · web-typecheck · worker-typecheck ·
`handlers.test.ts` 76/76 + `task-reminder-cron.test.ts` 7/7 · RLS-Gate 8/8 (echte PG) · `verify:i18n`
exit 0. **Nicht von mir berührte Vorbefunde (separat, kein P4b-Code):** worker `workflow-trigger-store.test.ts`
~22 Reds (AD-26 KI-Removal-Fallout, gpt/workflow-Blöcke) · Drift `TenantPluginCapabilityGrant`
(FK/Index-Rename, main-seitig) — beide bewusst unangetastet (p4a-Stance „fremden Drift nicht mitziehen").
**Weiterhin offen (extern/deferred, unverändert):** RLS „Teil B" (Policy aktivieren + Rollenwechsel +
Cutover, org-weit Raffael/R-P2b) · Live-Staging-Verifikation Reminder/Archiv (Redis + notify, wie p4a
entitlement-gated) · Reminder-Empfänger-i18n auf Staging · DoD 11 Mobile-Tab-Bar (PWA-only AD-17) +
DoD 21 Visual-Regression (keine Snapshot-Harness) · Davids `D-P4`-Optik · Push/PR/Merge auf main
(wartet auf User-Go).
**%-Done-Stand:** 8/8 DoD-Code-Punkte grün; Merge-Migration + RLS-Teil-A + Gate-Test gebaut und lokal
gegen echte Postgres verifiziert. Selbst-machbarer Rest auf dem Branch: **0** (alles Weitere ist
extern/infra blockiert oder Reviewer-Freigabe). Gesamt **~95 %** — Ticket bleibt in **„Ready for
Review"** bis Staging-Verifikation + Reviewer-Freigabe der deferrten Punkte.
@@ -0,0 +1,51 @@
# D-ABN · Abnahme-Workflow (Bespoke-Mobile)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P9 — Projekt & Pipelines (Auftrags-Features + Sub-Areas) (bedient `R-P9a`/`R-P9b`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-29 → fällig 2026-07-01 |
| **Status** | geplant |
> 🟦 **Bespoke-Abgrenzung:** Dieses Ticket deckt **NUR den Abnahme-Workflow + die Abnahme-Liste** (P9). Die **Plantafel** (P9) → **`D-PLAN`**. Die übrigen P9-Screens (Projekt-Detail-Sub-Areas, Rechnung-Sub-Entity, Pipeline-Config-Auftragsteil, Acceptance-Form-Templates, Project-Templates) sind Compose aus A3/A6 → P9-Compose-Anteil.
> 🔴 **Pivot-Vorrang (AD-20):** **Abnahme = Checklisten/Protokoll-Sub-Area** am `Projekt`-Kern. `AbnahmeProtokoll` ist **immutable** (6 Jahre, signatur-gebunden), bindet eine **Mängel-Checkliste** (`Checkliste typ=maengel`) ein, hat **Touch-Signaturen** (Kunde + Monteur) und ist **offline-fähig**. Kein separates AcceptanceProtocol-Objekt außerhalb des Projekts.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, Touch-Unterschriften-Primitive, offline-Zustand), `R-REFIT`
- **Blockt:** —
- **Bedient (Dev):** `R-P9a`/`R-P9b` (`acceptance.*` — Abnahme als immutable Sub-Area am Projekt-Kern)
- **Subframe:** Pflicht je Route. Abnahme-Workflow ist **BESPOKE-Mobile** (📱 mobile-first + offline-Sync); Abnahme-Liste aus A2.
## Was wir bauen
**Nur die Abnahme**: das SHK-Abnahme-Protokoll mit Mängel-Repeater (Foto je Mangel), Mängel-Klassifizierung, Touch-Signaturen Kunde + Monteur, PDF + Auto-Email, offline-fähig mit Sync — plus die Abnahme-Liste je Projekt (Mehrfach-/Teilabnahmen). Nach Speichern immutable.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| 📱 **Abnahme-Workflow** [`/projects/:id/acceptance/new`] | SHK-Abnahme-Protokoll (Datum, Anwesende, Druckprobe ja/nein+Wert, Funktionsprüfung, Zählerstände, Inbetriebnahme/Garantie-Datum, übergebene Dokumente-Checkliste, **Mängel-Repeater mit Foto je Mangel**, Bemerkungen Kunde/Monteur) → **Mängel-Klassifizierung** (kritisch=verweigert / klein=mit Vorbehalt / kosmetisch=erfolgt) bestimmt acceptance_kind → **Touch-Signatur Kunde** (Name eingeben, kann von Kontakt abweichen; IP+Timestamp auto) → **Touch-Signatur Monteur** → Bestätigen → PDF + Auto-Email an Kunden · **offline-fähig, Sync bei Verbindung** · nach Speichern **immutable** (nur archivierbar) | **BESPOKE-Mobile** |
| Abnahme-Liste [`/projects/:id/acceptance`] | Protokoll-Liste je Projekt (Mehrfach-/Teilabnahmen): Datum, acceptance_kind, Unterzeichner, PDF-Link, Mängel-Status · letzte `full`-Abnahme bestimmt Stage-Wechsel-Vorschlag | A2 |
*(Plantafel → `D-PLAN`. Projekt-Detail-Sub-Areas / Rechnung-Sub-Entity / Pipeline-Config-Auftragsteil / Acceptance-Form-Templates / Project-Templates = P9-Compose. Mängel sind Checklisten `typ=maengel`.)*
## Features (muss abgedeckt sein)
- [ ] SHK-Abnahme-Formular (Druckprobe, Funktionsprüfung, Zählerstände, Inbetriebnahme/Garantie, übergebene Dokumente) + **Mängel-Repeater mit Foto je Mangel**
- [ ] Mängel-Klassifizierung (kritisch/klein/kosmetisch) → bestimmt acceptance_kind; `with_defects` → Mängel als Tasks; `rejected` → zurück in Ausführung + Notification an PL
- [ ] **Touch-Signatur Kunde + Monteur** (Name abweichbar, IP+Timestamp auto)
- [ ] PDF + Auto-Email an Kunden; nach Speichern **immutable** (6 J, nur archivierbar; Hard-Delete blockt)
- [ ] **offline-fähig, Sync bei Verbindung**; Mehrfach-/Teilabnahmen; letzte `full`-Abnahme → Stage-Wechsel-Vorschlag
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Abnahme-Formular-Renderer (Repeater für Mängel mit Foto-Upload aus Kamera); Mängel-Klassifizierungs-Auswahl (kritisch/klein/kosmetisch); Touch-Unterschriften-Feld (Kunde + Monteur); PDF-Vorschau/-Download; immutable/gesperrt-Banner; Offene-Mängel-roter-Banner; Checklisten-/ChecklistItem-Liste mit Status + Mängel-Klasse + Foto; One-Tap-Foto-Upload; Abnahme-Protokoll-Liste (Datum/acceptance_kind/Unterzeichner/PDF/Mängel-Status); Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext + Lösungs-Knopf).
## Quellen (granular)
- `designer-briefs/P09-projekt-pipelines-auftrag.md` → §Benötigte Screens „📱 Abnahme-Workflow" + „Abnahme-Liste" (NUR diese) + zugehörige Features/UI-Elemente
- `ENTITY-MODEL.md` → **Domäne 5** (AbnahmeProtokoll/AbnahmeSignatur als immutable Sub-Area am Projekt; Checkliste typ=maengel) — **Pivot-Vorrang**
- `SCREEN-MAP.md` → §4 Abnahme · `ROADMAP.md` → Phase 9 · `_bmad-output/specs/M04-auftragspipeline.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,63 @@
# D-ADMIN · Plattform-Admin-Compose
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P19 — Plattform-Admin (bedient `AK-P19`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-26 → fällig 2026-06-26 |
| **Status** | geplant |
> 🟩 **Compose-Ticket:** deckt **alle Admin-Screens** (P19). Compose aus A2/A3/A4/A5/A6 + KPI/Charts — aber **eigene Admin-Shell** (nicht App-Shell A1): getrennte Sidebar/Topbar auf `admin.hivegrid.de`. Interner Polish reicht (kein 🌐-Niveau).
> 🟡 **v1-Schnitt (verbindlich):** Getrennte AdminUser-Identität / AdminRBAC-Parallelwelt (M038/M039) → **v2** (v1 = Boilerplate-User-Extension + `admin-mfa-gate`). **Keine** AdminUser-/AdminRole-Verwaltungs-Screens, **keine** Plattform-Lead-Pipeline/Deal-Kanban, **keine** Feature-Flag-Massen-Statistik, **kein** KWP-Sync-Status-Screen in v1; Churn/ARPU → v2. **Neu v1:** Admin stellt Tenant-Abos zusammen (Feature-Konnektoren togglen + Stripe-Positionen — Abo-Baukasten-Mechanik).
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen — Reuse der Bausteine; die Admin-Sidebar/-Topbar werden hier aber **getrennt** neu komponiert, kein A1-Reuse)
- **Blockt:** —
- **Bedient (Dev):** `AK-P19` (M37 Plattform-Admin + M32 Feature-Flag-UI)
- **Subframe:** Pflicht je Route. Eigene Admin-Shell; Archetypen-Reuse A2/A3/A4/A5/A6 + KPI/Charts.
## Was wir bauen
Die **getrennte Plattform-Admin-Welt** auf `admin.hivegrid.de`: Admin-Login + 2FA, Admin-Dashboard (Basis-KPIs), Tenant-Management inkl. **Abo-Zusammenstellung**, User-/Subscription-Verwaltung, Feature-Flags, Health/Worker-Queues, Support-Inbox, Admin-Audit und Subprozessoren/AVV.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Admin-Login + 2FA [`admin.hivegrid.de/login`, `/2fa`] | Email + Passwort (NIST/HIBP, Captcha ab 3. Fehler), TOTP-Pflicht, kein Magic-Link, 8h-Session | A4 / A5 |
| Admin-Dashboard [`/dashboard`] | **Basis-KPIs: Tenants, aktive User, MRR** + System-Health-Ampel + Queue-Status · Klick je Kachel → Drill-Down · Zeitraum-Wechsler *(Churn/ARPU/Sales-Pipeline → v2)* | KPI |
| Tenant-Liste [`/tenants`] | Name, Slug, Status (Klartext-Farbe), Plan, MRR, User-Anzahl, letzte Aktivität, Branche/Größe · Filter + Suche + Bulk (Tag/Email) | A2 |
| **Tenant-Detail** [`/tenants/:id`] | Stammdaten, Status-Wechsler (Reason-Pflicht), **Abo-Zusammenstellung (Feature-Konnektoren togglen + Stripe-Positionen — Abo-Baukasten!)**, Trial-Verlängerung (Datum + Reason), Notizen (Markdown, kategorisiert, gepinnt), User-/Activity-/Audit-/Feature-Flag-Sektionen, **Impersonate mit Begründungs-Pflicht** | A2 / A3 + A6 |
| Manuelle Tenant-Anlage [`/tenants/new`] | Name, Slug (Live-Validation), Branche, Größe, Initial-Admin-Email, Initial-Module/Plan, Trial-Dauer, Demo-Daten-Häkchen, Reason-Pflicht | A4 |
| User-Liste + Detail [`/users`, `/:id`] | Liste: Email, Name, Tenant-Memberships, 2FA-Status, letzte Aktivität, Status · Detail: Memberships mit Rolle, Sessions, letzte Logins, Ops (2FA-Reset mit Reason, Session-Revoke, Deaktivieren, Lösch im Auftrag) | A2 / A3 |
| Subscription-Liste + Detail [`/subscriptions`, `/:id`] | Liste: Tenant, Plan, MRR, Status, Renewal, Stripe-Sync · Detail: Stripe-Customer/Sub-ID (Link), Plan + Positionen + MRR, Trial, Rechnungs-History, manuelle Override (Plan/Sonderpreis/Reason), Stripe-Sync forcieren, Refund | A2 / A3 |
| Feature-Flags [`/feature-flags`] | Flag-Liste (Key, Status, Targeting), Filter-Editor (plan-tier), Tenant-Override mit Ablauf *(Massen-Statistik → v2)* | A2 + A6 |
| Health + Worker-Queues [`/health`, `/health/workers`] | Service-Ampeln (Web/API/Worker/Scheduler), DB/Redis/Storage · BullMQ-Queues: Active/Waiting/Delayed/Failed je Queue, Job-Detail mit Error-Stack, Retry (Bulk/einzeln), Pause/Resume · Error-Rate Top-10 | A2 + KPI |
| Support-Inbox + Ticket-Detail [`/support`, `/:id`] | Liste: Betreff, Tenant, Source, Status, Priorität, Zugewiesen · Detail: Konversation, Antwort (Markdown + Anhänge), interne Notiz, Status/Priority/Tag/Assignee-Wechsler, Reaktions-Templates · **speist sich aus Feedback-Widget (P21)!** | A2 / A3 |
| Admin-Audit [`/audit`] | Cross-Tenant-`AdminAuditLog` + aggregierter Tenant-Audit-Read · Filter (Akteur/Tenant/Action-Type/Zeitraum/Target), Volltext in Summary, Detail-Drawer mit Diff, Export (CSV/JSON) · read-only | A2 + Drawer |
| Subprozessoren + AVV [`/legal/subprocessors`, `/legal/avv`] | Subprozessor-Liste (anlegen/edit/archiv, 14-Tage-Widerspruchs-Trigger) · AVV-Versionen (PDF-Vorlage, Aktiv-ab, akzeptierende/ausstehende Tenants, Re-Akzeptanz-Trigger) | A2 + A6 |
*(Entfällt v1: AdminUser-/AdminRole-Verwaltung, Plattform-Lead-Inbox/Deal-Kanban, KWP-Sync-Status, Feature-Flag-Massen-Statistik — alles v2.)*
## Features (muss abgedeckt sein)
- [ ] Admin meldet sich auf `admin.hivegrid.de` an (Host-Routing, Cookie-Domain-Trennung, TOTP-Pflicht + MFA-Step-up); Admin-User ohne Tenant-Workspace; kein Generalschlüssel
- [ ] Admin verwaltet Tenants/Subscription-Overrides/Feature-Flags; **Abo-Zusammenstellung** = Feature-Konnektoren togglen + Stripe-Positionen (Abo-Baukasten)
- [ ] Admin-Dashboard: Boilerplate-KPIs (Tenants/User/MRR) + System-Health + Queue-Status
- [ ] BullMQ-Queue-Monitoring (Retry/Pause/Resume, Job-Detail mit Error-Stack) + Support-Inbox
- [ ] `AdminAuditLog` (tenant_id=null) über Audit-Hash-Kette; sensitive Aktionen (Status-Wechsel/Impersonate/Subscription-Override) mit Reason-Pflicht + Klartext-Bestätigung
- [ ] Impersonate → temporäre Tenant-User-Session (max. 30 Min) mit Klartext-Banner im Tenant + Reason-Spur
- [ ] Eigene getrennte Admin-Shell (Sidebar Dashboard/Tenants/Users/Subscriptions/Feature-Flags/Health/Audit/Support/Legal/Settings) — kein App-Sidebar-Reuse
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Eigene Admin-Sidebar + -Topbar (getrennt von A1); KPI-Kacheln mit Drill-Down + Zeitraum-Wechsler; System-Health-Ampel; Daten-Tabelle (sortierbar, paginiert, Spalten-Konfig); Filter-Bar; Bulk-Action-Toolbar; Status-Wechsler mit Reason-Pflicht-Modal; **Abo-Baukasten-Panel** (Feature-Konnektor-Toggles + Stripe-Positionsliste mit Preisen); Trial-Verlängerungs-Datum-Picker; Markdown-Notizen-Editor mit Pin + Kategorie; Impersonate-Button mit Begründungs-Modal; Stripe-Link-Badge; manuelle-Override-Formular; Queue-Status-Tabelle mit Retry/Pause/Resume; Job-Detail-Drawer mit Error-Stack; Feature-Flag-Liste + Targeting-Filter-Editor + Tenant-Override-mit-Ablauf; Support-Konversations-Ansicht + Markdown-Reply + interne-Notiz-Toggle + Reaktions-Templates; Audit-Tabelle mit Diff-Drawer + Export; Subprozessor-Tabelle + AVV-Versions-Liste mit PDF-Upload; Bestätigungs-Dialoge (Confirm-Phrase für destruktive Aktionen); Empty-/Loading-/Fehler-/Permission-Denied-States (Klartext mit Lösungs-Knopf).
## Quellen (granular)
- `designer-briefs/P19-plattform-admin.md` (vollständiger Brief — alle Admin-Screens, diese Doc ist sein Ticket-Destillat)
- `ENTITY-MODEL.md` → Domäne 11 (Plattform-Admin) + Domäne 12 (Abo-Baukasten, für Abo-Zusammenstellung)
- `SCREEN-MAP.md` → §3 Plattform-Admin · `ROADMAP.md` → Phase 19 · `_bmad-output/specs/M37-plattform-admin.md`, `M32-feature-flags.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,53 @@
# D-BOOK · Booking-Page (Public, Polish) + Kalender-View
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P16 — Kalender, Booking, Forms & Signatur (bedient `AK-P16a`–`AK-P16d`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-07-02 → fällig 2026-07-03 |
| **Status** | geplant |
> 🟦 **Bespoke-Abgrenzung:** Dieses Ticket deckt **NUR die öffentliche Booking-Page + die Kalender-View** (inkl. Kalender-Connection-Card). Der **Form-Builder + das öffentliche Formular** (P16) → **`D-FORM`**. Die übrigen P16-Screens (Buchungen-Liste/-Detail, Booking-Page-Editor, Booking-Pages-Liste, Verfügbarkeit, Submissions, Signatur-Wizard) sind Compose aus A2/A3/A6 → P16-Compose-Anteil (Signatur-Wizard → `D-REST`).
> 🟡 **v1-Schnitte:** Kalender-Sync nur **Google** (Outlook → v2, Interface bleibt provider-agnostisch); Booking nur **eine** Zuteilung „Erster der frei ist" (Round-Robin/Provider-Wahl → v2).
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, A6 Connection-Card, Tokens)
- **Blockt:** `D-POLISH` (die öffentliche Booking-Page bekommt in W4 die finale Politur)
- **Bedient (Dev):** `AK-P16a`–`AK-P16d` (M25 Kalender-Sync + M06 Booking)
- **Subframe:** Pflicht je Route. Booking-Page ist **BESPOKE-Public (höchster Polish)**; Kalender ist BESPOKE (mittel); Connection-Card aus A6.
## Was wir bauen
**Nur die öffentliche Booking-Page** (Calendly-Style Slot-Picker, .ics, Tenant-Branding, iFrame-Embed — höchster Polish) und die **Kalender-View** (Monats-/Wochen-Grid mit Quell-Markern) inkl. Kalender-Verbindungs-Cards.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| 🌐 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) |
| 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 |
*(Form-Builder + öffentliches Formular → `D-FORM`. Buchungen-Liste/-Detail, Booking-Page-Editor, Booking-Pages-Liste, Verfügbarkeit, Submissions = P16-Compose. Signatur-Wizard → `D-REST`.)*
## Features (muss abgedeckt sein)
- [ ] Öffentliche Booking-Page berechnet 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; Add-to-Calendar (.ics)
- [ ] Booking nur eine Zuteilungs-Strategie „Erster der frei ist"
- [ ] Kalender synchronisiert bidirektional mit Google (Auto-Token-Refresh, Webhook-Subscriptions); HiveGrid-Termine gehen extern, externe Events read-only für Verfügbarkeit
- [ ] Connection pro User; externe Event-Inhalte nie an andere User leaken (Booking sieht nur „belegt von X bis Y"); Last-Write-Wins-Konflikt mit Klartext-Notification
- [ ] Höchster Polish auf der Public-Booking-Page (4 Zustände, Tenant-Branding)
## 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); Tenant-Logo/Branding; iFrame-Embed-Variante; Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext mit Lösungs-Knopf).
## Quellen (granular)
- `designer-briefs/P16-kalender-booking-forms-signatur.md` → §Benötigte Screens „Booking-Page" + „Kalender" + „Kalender-Verbindungen/-Detail" (NUR diese) + zugehörige Features/UI-Elemente
- `ENTITY-MODEL.md` → Domäne 9 (Kalender/Booking)
- `SCREEN-MAP.md` → §5 Booking/Kalender · `ROADMAP.md` → Phase 16 · `_bmad-output/specs/M25-calendar-sync.md`, `M06-booking.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,60 @@
# D-CHAT · Chat-UI (Bespoke)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P15 — Telefonie & Team-Chat (bedient `AK-P15a`/`AK-P15b`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-30 → fällig 2026-07-01 |
| **Status** | geplant |
> 🟦 **Bespoke-Abgrenzung:** Dieses Ticket deckt **NUR die Chat-UI** (Chat-Index, Channel-Detail + die Chat-Nebenflächen Thread-Detail/Pinned/Mentions-Aggregat/Cross-Channel-Suche/Neuer-Channel/Channel-Settings/Admin-Chat). Der **Telefonie-Teil** (AirCall-Setup, Anruf-Liste + -Detail) → **`D-REST`** (W4 KI/Telefonie/Signatur/Billing/DSGVO-Compose).
> 🔴 **Chat ist Real-Time-Bespoke (AD-9):** WebSocket-Messaging mit Presence/Typing/Read-Receipts/Redis-Pub-Sub, drei Channel-Typen (public/private/entity-linked). Mobile-First für Monteure. **Admin-DM-Audit** nur mit Begründungs-Pflicht + Banner.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, Emoji-Picker/Mention-Highlight/Markdown-Primitives)
- **Blockt:** —
- **Bedient (Dev):** `AK-P15a`/`AK-P15b` (M13 Team-Chat — Real-Time-Messaging)
- **Subframe:** Pflicht je Route. Archetypen aus D0; Chat-UI ist **BESPOKE** (Real-Time, mobile-first).
## Was wir bauen
**Nur die Chat-UI**: Channel-Index + Channel-Detail (Reactions/Threads/Read-Receipts/Composer/Typing) plus die zugehörigen Chat-Nebenflächen. Entity-linked Channels erscheinen im Projekt-Detail (P8/P9 — dort eingebettet, hier die Channel-View selbst).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **Chat-Index** [`/chat`] | Channel-Liste: Name (DM: anderer User), Avatar/Typ-Indikator (Projekt/Gruppe/DM), Snippet (max. 80 Z., Mentions hervorgehoben), Zeitstempel, **Unread-Badge**, **Mention-Marker** (separat), Pin-/Mute-Indikator, bei Projekt-Chat Stage · Filter (Typ/ungelesen/Mentions/Projekt-Status/Tag) · Suche · „Archivierte anzeigen" · **Channel-Browser (Discover)** öffentlicher Groups · „Meine Mentions"-Link · pro Eintrag Pin/Mute/Mark-as-read/Archiv | **BESPOKE** |
| **Channel-Detail** [`/chat/:id`] | Header (Name, Typ, Member-Anzahl, Projekt-Link) · Pinned-Sektion (max. 3 inline) · Verlauf mit **Date-Bucket-Separatoren**, Nachricht = Avatar+Name+Zeit, Markdown-Body, **Reactions** (Emoji+Count), **Thread-Indikator**, Mentions, Anhänge inline (Bild-Thumb/Datei-Icon/Link-Preview), Edited-/Lösch-Marker, System-Messages, **Read-Receipt „X von Y gelesen"** · Composer (Markdown, Emoji, @-Mention-Autocomplete, Datei-Dropzone, Draft-Autosave) · **Typing-Indikator** · Per-Message-Hover-Menü (Reagieren/Thread/Pin/Mark-as-Task/Permalink/Edit/Löschen) · Channel-Info-Sektion (Members/Pinned/Files/Settings) | **BESPOKE** |
| Thread-Detail [`/chat/:id/thread/:thread_id`] | Eltern-Nachricht + Replies in Side-Panel oder eigener Route · eigener Composer | Bespoke-Teil |
| Pinned-Übersicht [`/chat/:id/pinned`] | Alle gepinnten Nachrichten (max. 50) je Channel | A2 |
| Mentions-Aggregat [`/chat/mentions`] | Alle @-Mentions auf den User kanalübergreifend | A2 |
| Cross-Channel-Suche [`/chat/search`] | Volltext-Suche über erlaubte Channels mit Treffer-Kontext | A2 |
| Neuer Channel / DM [`/chat/new`] | Modal: Group (Name, Privacy public/private, Member-Wahl) oder DM | A5 |
| Channel-Settings | Members verwalten, Privacy, Archivieren, verlassen | A6 |
| Admin-Chat-Übersicht [`/admin/chat`] | Alle Channels, Cleanup-Tools · **DM-Audit mit Begründungs-Pflicht-Banner** · Force-Member-Edit / Force-Delete | A2/A3 |
*(AirCall-Setup + Anruf-Liste/-Detail → `D-REST`. HalloPetra-Adapter-UI/Whisper-Diktat → v2. Click-to-Call-Buttons leben in Kontakt-/Lead-/Projekt-Detail aus P6/P7/P8.)*
## Features (muss abgedeckt sein)
- [ ] Chat-Real-Time: WebSocket, Presence, Typing, Read-Receipts, Optimistic-UI, Reconnect
- [ ] Drei Channel-Typen: public/private Group, DM, entity-linked (Projekt) mit ProjectMember-Sync
- [ ] @Mentions (User/Projekt/Contact/Firma) mit Autocomplete, Threads, Reactions, Pinned (max 50), File-Uploads, Link-Previews, Mark-as-Task
- [ ] Channel-Index mit Filter/Suche/Pin/Mute/Archiv + Channel-Browser; Cross-Channel-Suche; Mentions-Aggregat
- [ ] Entity-linked Channel erscheint im Projekt-Detail (P8/P9)
- [ ] Admin-Audit (`read_all_channels`): Begründungs-Pflicht je Session + DM-Audit-Banner, audit-geloggt
- [ ] Mobile-First-Variante für Monteure (vereinfachte Chat-View, Foto-Direct-Upload, Push)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Channel-Listen-Einträge (Snippet, Unread-Badge, Mention-Marker, Pin-/Mute-/Typ-Indikator); Filter-Bar; Channel-Browser/Discover; Chat-Verlauf mit Date-Bucket-Separatoren; Nachrichten-Bubble (Avatar+Name+Zeit, Markdown-Renderer, Edited-/Lösch-Marker, System-Message-Stil); Reactions-Leiste (Emoji+Count); Thread-Indikator + Thread-Side-Panel; Mention-Highlight; Inline-Anhang-Renderer (Bild-Thumb/Datei-Icon/Link-Preview); Read-Receipt-Aggregat; Composer mit Markdown/Emoji-Picker/@-Mention-Autocomplete/Datei-Dropzone/Draft-Autosave; Typing-Indikator; Scroll-to-Bottom + New-Messages-Indikator; Per-Message-Hover-/Tap-Menü; Neuer-Channel-/DM-Modal; Channel-Settings-Sektion; Admin-DM-Audit-Banner mit Begründungs-Eingabe; Mobile-vereinfachte-Chat-Variante 📱; Empty-/Loading-/Permission-Denied-/Offline-States (Klartext).
## Quellen (granular)
- `designer-briefs/P15-telefonie-chat.md` → §Benötigte Screens „Chat-Index" + „Channel-Detail" + Chat-Nebenflächen (Thread/Pinned/Mentions/Suche/Neuer-Channel/Settings/Admin-Chat) — NUR Chat; Telefonie → `D-REST`
- `ENTITY-MODEL.md` → Domäne 8 (Kommunikation: TeamChat/Member/Message/Thread/PinnedMessage/Reaction/Read)
- `SCREEN-MAP.md` → §4 Chat · `ROADMAP.md` → Phase 15 · `_bmad-output/specs/M13-team-chat.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,56 @@
# D-CRM · CRM-Cluster-Screens
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P6 — CRM-Kern (bedient `R-P6`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-22 → fällig 2026-06-24 |
| **Status** | geplant |
> 🔴 **Pivot-Vorrang (AD-20):** Für den CRM-Kern gilt das **`ENTITY-MODEL.md`**, nicht die teils noch pre-Pivot-SCREEN-MAP. Konkret: **kein Lead-Promotion-Modal** mehr (gehört zu P7, jetzt Lead→Projekt). `Kontakt` ist Oberbegriff mit **Kontakttyp** (Privatperson/Organisation), **Kontaktstatus** (Kontakt/Kunde/Bestandskunde), **Kontaktart** (Haupt-/Sekundärkontakt = Rolle einer Relation). Zwei Listen-Einstiege: Organisationen **und** Kontakte.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen A2/A3/A5/A6), `R-REFIT` (Boilerplate-Entity-Builder entfernt, Datenmodell-Refit)
- **Blockt:** `N-DEMO1` (Politur für Noah-Demo #1)
- **Bedient (Dev):** `R-P6` (CRM-Kern — Kontakt/Firma/Lead-Kernentitäten, Custom-Felder, Tags, Duplikat-Schutz)
- **Subframe:** Pflicht je Route. Archetypen aus D0 (A2 Liste, A3 Detail, A5 Modal, A6 Settings).
## Was wir bauen
Den **CRM-Cluster**: Kontakt- und Firmen-/Organisationen-Listen, das **Kontakt-Detail als Muster-Template** für alle Detail-Views (A3), Custom-Felder- und Tag-Verwaltung sowie das Duplikat-Tool. Fundament der Kern-Kette (Lead → Projekt). Erster fachlicher Screen-Cluster nach D0.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Kontakt-Liste [`/contacts`] | Avatar+Name, Firma, Email, Telefon, Tags, Verantwortlicher, letzte Activity · Filter (Verantwortlicher/Tags UND-ODER/Firma/Datum) · Bulk (Tag/Zuweisen/Archiv/CSV) | A2 |
| Organisationen-Liste [`/contacts/companies`] | Name, Branche/Org-Merkmal, Kontakt-Anzahl, Verantwortlicher, letzte Activity | A2 |
| **Kontakt-Detail** [`/contacts/:id`] | Stammdaten inline-editierbar · verknüpfte Firmen + Rolle (haupt/sekundär) · Tags · Panels (Projekte/Dateien/Tasks) · Custom-Felder · Notizen (Markdown) · **Activity-Stream** (inkl. BCC-gelogte Mails + Anrufe) · Quick-Actions (Anrufen/Email/Termin/Task/Tag) | A3 — Muster-Template für alle Detail-Views |
| Organisation-Detail [`/contacts/companies/:id`] | Analog + Kontakt-Verknüpfungen mit Primär-Markierung + Rolle | A3 |
| Custom-Felder [`/admin/custom-fields`] | Felder je Entity-Typ, Typ, Nutzungs-Anzahl, Quelle (SHK-Template/eigen), Sortierung, Archiv | A2 |
| Tag-Verwaltung [`/admin/tags`] | Name, Farbe, Verknüpfungs-Anzahl, Merge | A2 |
| Duplikat-Tool [`/admin/duplicates`] | Duplikat-Paare + Match-Kriterium · Side-by-Side-Merge (Feld-für-Feld) | A5 + Side-by-Side |
*(Lead-Inbox/Lead-Detail/Lead-Statistiken → P7. Audit/Notif/Files/Tasks-Oberflächen → P3/P4. Kein Lead-Promotion-Modal — Pivot.)*
## Features (muss abgedeckt sein)
- [ ] CRM-Kernentitäten typisiert mit RLS (Contact, Company, Lead, KontaktRelation, Activity, CustomField, Tag) — Entity-Builder entfernt (AD-2)
- [ ] Kontakt-Oberbegriff: Kontakttyp (Privatperson/Organisation), Kontaktstatus (Kontakt/Kunde/Bestandskunde), Kontaktart (Haupt-/Sekundärkontakt als Relation)
- [ ] Server-seitig Filtern/Sortieren/Paginieren + Bulk-Actions + CSV-Export
- [ ] Detail mit Inline-Edit, Activity-Stream (append-only Event-Sourcing), verknüpfte Entitäten, Custom-Felder
- [ ] SHK-Branchen-Custom-Felder als Template geseedet
- [ ] Live-Match-Check (Duplikat-Warnung) beim Anlegen
- [ ] `crm.*`-Permission-Bundle (read_own/read_all/write/delete/admin) — serverseitiger Owner-Filter prägt Empty/Permission-Denied-States
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Daten-Tabelle (sortierbar, paginiert); Filter-Bar (Multi-Select Tags UND/ODER); Bulk-Action-Toolbar; Detail-Panel mit Inline-Edit-Feldern; Tag-Chips (farbig); Relations-Liste mit Rollen-Badge; Activity-Timeline (Actor-Kind-Marker); Custom-Feld-Renderer je Typ; Quick-Action-Buttons; Duplikat-Banner/Hinweis; Side-by-Side-Merge-Ansicht; Empty-/Loading-/Permission-Denied-States (Klartext).
## Quellen (granular)
- `designer-briefs/P06-crm-kern.md` (vollständiger Brief — diese Doc ist sein Ticket-Destillat)
- `ENTITY-MODEL.md` → **Domäne 5: Projekt-zentrischer CRM-Kern** (Pivot-Vorrang: Kontakt-Oberbegriff/Kontakttyp/-status/-art, KontaktRelation; kein Lead-Promotion-Modal)
- `SCREEN-MAP.md` → §2 · `ROADMAP.md` → Phase 6 · `_bmad-output/specs/M01-crm-kern.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,50 @@
# D-D0a · D0 Design-System + App-Shell (A1)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P1 — Fundament & Walking-Skeleton (globale Baseline, kein Fach-Modul) |
| **Cycle/Fenster** | W1 — Fundament & Identität · 2026-06-16 → fällig 2026-06-18 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** — (Fundament-Ticket, hat keinen Vorgänger)
- **Blockt:** ALLE Folge-Screens (App-Shell ist Single Source of Truth, ~70 % aller Screens komponieren darauf), `H-PITCH`
- **Bedient (Dev):** `R-P1a`/`R-P1b` (Querschnittsdienste + Subframe-Adapter) — die App-Shell ist die UI-Hülle, in der jede Dev-Route rendert
- **Läuft parallel zu:** `D-WEB` (Brand-Tokens, gleiche W1) — Tokens müssen Web + App konsistent halten
- **Subframe:** Pflicht je Route. Dieses Ticket **liefert** die A1-App-Shell-Baseline selbst (kein Fach-Screen), aus der alle Folge-Phasen komponieren.
## Was wir bauen
Die **globale App-Shell-Baseline (A1)** plus das **Design-System-Fundament** (Tokens für Farben/Typografie/Spacing, Hell/Dunkel flash-frei). Das ist das Gerüst, das jede spätere Route umgibt: Sidebar mit Konnektor-Gating, Topbar, Breadcrumb, Status-Banner-System und Toast/Inline-Feedback. Kein fachlicher Screen — reine Plattform-Hülle.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **App-Shell-Baseline** [global, kein eigener Pfad] | Sidebar (Modul-Navigation Icon+Label, **Konnektor-Gating-Zustand** je `tenantHasModule()` — aktiv/ausgeblendet/gesperrt; Sektionen Arbeit + Verwaltung; Collapse; aktiver Eintrag; Mobile-Drawer/Bottom-Nav 📱) · Topbar (Tenant-Switcher mit zuletzt-genutzt-Liste + Suchfeld ab 5 Tenants, Cmd+K-Trigger, Notification-Bell mit Unread-Badge, User-Menü mit Hell/Dunkel-Toggle + Logout) · Breadcrumb · **Status-Banner-System** (past_due/frozen/deletion_pending/suspended, je Text + Action-Button, stapelbar) · Toast/Inline-Feedback (Erfolg / Klartext-Fehler mit Lösungs-Knopf / Warnung) | A1 |
| **Design-Tokens** [keine Route] | Farben/Typografie/Spacing, Hell/Dunkel-Theme flash-frei (App-Seite; Web-Seite koordiniert mit `D-WEB`) | Tokens |
*(Archetypen A2–A7 + Primitives + Zustands-Kit → `D-D0b`. Walking-Skeleton-Beispielroute = Dev-seitig in `R-P1a/b`. Auth-Screens → `D-P2`. Audit/Notif/Files/Tasks-Oberflächen → P3/P4.)*
## Features (muss abgedeckt sein)
- [ ] Design-Tokens (Farben/Typografie/Spacing) + Hell/Dunkel-Theme flash-frei
- [ ] Sidebar inkl. Konnektor-Gating (Modul je `tenantHasModule()` aktiv/ausgeblendet/gesperrt), Sektionen Arbeit + Verwaltung, Collapse, Mobile-Variante, aktiv-Markierung
- [ ] Topbar mit Tenant-Switcher (zuletzt-genutzt + Suche ab 5), Cmd+K-Trigger, Notification-Bell (Unread-Badge), User-Menü (Theme-Toggle, Logout)
- [ ] Breadcrumb-Pfad
- [ ] Status-Banner-System (4 Tenant-Status, stapelbar, je Text + Action-Button)
- [ ] Toast + Inline-Feedback (Erfolg / Klartext-Fehler-mit-Lösungs-Knopf / Warnung — Bauprinzip A.1)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Sidebar mit Icon+Label-Navigationseinträgen und drei Konnektor-Zuständen (aktiv/ausgeblendet/gesperrt); Sektions-Gruppierung; Collapse-Steuerung; Mobile-Drawer/Bottom-Nav-Variante; aktiv-Markierung; Topbar mit Tenant-Switcher-Dropdown (zuletzt-genutzt-Liste, Suchfeld ab 5 Tenants), Cmd+K-Such-Trigger, Notification-Bell mit Unread-Badge, User-Menü mit Theme-Toggle + Logout; Breadcrumb-Pfad; stapelbares Status-Banner-System mit Text + Action-Button je Tenant-Status; Toast- und Inline-Feedback-Komponente (Erfolg / Fehler-mit-Lösungs-Knopf / Warnung); Hell/Dunkel-Theme-Tokens flash-frei.
## Quellen (granular)
- `designer-briefs/P01-fundament-walking-skeleton.md` → §Benötigte Screens „App-Shell-Baseline (A1)" + §Features (App-Shell/Topbar/Status-Banner/Toast) + §UI-Elemente (Sidebar/Topbar/Banner-Teile)
- `SCREEN-MAP.md` → §0.1 App-Shell
- `DESIGNER-FIRST-PLAYBOOK.md` → §1
- `ROADMAP.md` → Phase 1 · Querschnitt-Block (M00)
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,47 @@
# D-D0b · D0 Archetypen A2–A7 + Zustands-Kit + Primitives
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P1 — Fundament & Walking-Skeleton (globale Baseline, kein Fach-Modul) |
| **Cycle/Fenster** | W1 — Fundament & Identität · 2026-06-18 → fällig 2026-06-20 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (Design-System + App-Shell A1 — die Archetypen leben in der Shell und nutzen deren Tokens)
- **Blockt:** **alle Compose-Screens** (jeder Fach-Screen ab P2 komponiert aus A2–A7 + Primitives)
- **Bedient (Dev):** alle Dev-Screen-Tickets — A2–A7 sind das gemeinsame Bau-Kit, das Subframe-Adapter-Routen rendern
- **Subframe:** Pflicht je Route. Dieses Ticket **liefert** das Archetypen-Kit selbst (kein Fach-Screen), aus dem alle Folge-Phasen komponieren.
## Was wir bauen
Das **Archetypen-Kit A2–A7 + Zustands-Kit + Basis-Primitives** — das einmal designte, überall komponierbare Baustein-Set. Damit ist jeder Folge-Screen ein Compose aus diesen Teilen statt Neubau. Kein fachlicher Screen.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **Archetypen-Kit A2–A7** [keine Route] | A2 List-View-Kit (Daten-Tabelle sortierbar/paginiert + Karten-Alternative + Filter-Bar + Bulk-Action-Bar + Spalten-Konfig + CSV-Export + Archiviert-Toggle + Leerzustand-mit-CTA) · A3 Detail-View-Kit (Inline-Edit-Feld + Related-Panels + **Activity-Timeline** mit Actor-Kind-Marker user/system/automation/ki + Custom-Felder-Sektion + Tags-Zeile + Sub-Tabs) · A4 Form/Input-Kit (**12 Feldtypen** + Validierung/Klartext-Fehler + Auto-Complete-Picker + Pflichtfeld-Markierung) · A5 Modal/Wizard-Kit (Progress + Bestätigungs-Dialog mit Confirm-Phrase-Variante + Side-Panel/Drawer) · A6 Settings/Connection-Kit (Settings-Sektion + Toggle-Zeile mit Klartext + Connection-Card mit Status-Ampel + Key/Secret-Reveal) · A7 **Zustands-Kit** (leer / laden-Skeleton / Fehler-mit-Lösungs-Knopf / keine-Berechtigung / offline 📱) | A2–A7 |
| **Basis-Primitives** [keine Route] | Buttons (primär/sekundär/destruktiv/ghost), Badges/Status-Pills, farbige Tags, Avatare + Avatar-Stapel, Tabs, Dropdown, Date/Time-Picker, Tooltip, KPI-Kachel, Chart-Basis (Linie/Balken/Donut), Drawer, Markdown-Editor + -Renderer, Datei-Dropzone mit Progress, **Unterschriften-Feld (Touch)** 📱, Emoji-Picker, Mention-Highlight | Primitives |
*(App-Shell A1 + Tokens → `D-D0a`. Walking-Skeleton-Beispielroute = Dev-seitig. Fach-Screens ab P2.)*
## Features (muss abgedeckt sein)
- [ ] A2 List · A3 Detail (inkl. Activity-Stream-Komponente) · A4 Form (12 Feldtypen) · A5 Modal/Wizard · A6 Settings/Connection · A7 Zustände (4+ Zustände)
- [ ] Basis-Primitives (Buttons in 4 Varianten, Badges/Pills, Tags, Avatare+Stapel, Tabs, Dropdown, Date/Time-Picker, Tooltip, KPI-Kachel, Charts, Drawer, Markdown, Datei-Dropzone, Touch-Unterschriften-Feld, Emoji-Picker, Mention-Highlight)
- [ ] Activity-Timeline mit Actor-Kind-Marker (user/system/automation/ki)
- [ ] Zustands-Kit durchgängig (leer/laden/Fehler-mit-Lösungs-Knopf/keine-Berechtigung/offline)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Daten-Tabelle (sortierbar/paginiert) + Karten-Alternative + Filter-Bar + Bulk-Action-Bar + Spalten-Konfig + CSV-Export-Button + Archiviert-Toggle + Leerzustand-mit-CTA (A2); Detail-Panel mit Inline-Edit-Feld + Related-Panels + Activity-Timeline (Actor-Kind-Marker) + Custom-Felder-Sektion + Tags-Zeile + Sub-Tabs (A3); Form-Kit mit allen 12 Feldtypen + Validierungs-/Klartext-Fehler-Zuständen + Auto-Complete-Picker + Pflichtfeld-Markierung (A4); Modal/Wizard mit Progress + Bestätigungs-Dialog mit Confirm-Phrase-Variante + Side-Panel/Drawer (A5); Settings-Sektions-Layout + Toggle-Zeile mit Klartext + Connection-Card mit Status-Ampel + Key/Secret-Reveal (A6); Zustands-Kit (leer/laden-Skeleton/Fehler-mit-Lösungs-Knopf/keine-Berechtigung/offline 📱) (A7); Basis-Primitives (Buttons 4 Varianten, Badges/Status-Pills, farbige Tags, Avatare+Stapel, Tabs, Dropdown, Date/Time-Picker, Tooltip, KPI-Kachel, Chart-Basis, Drawer, Markdown-Editor+Renderer, Datei-Dropzone mit Progress, Touch-Unterschriften-Feld, Emoji-Picker, Mention-Highlight).
## Quellen (granular)
- `designer-briefs/P01-fundament-walking-skeleton.md` → §Benötigte Screens „Archetypen-Kit A2–A7" + „Basis-Primitives" + §Features (Archetypen + Primitives) + §UI-Elemente (A2–A7 + Primitives)
- `SCREEN-MAP.md` → §0.2/0.3
- `DESIGNER-FIRST-PLAYBOOK.md` → §2 Archetypen
- `ROADMAP.md` → Phase 1 · Querschnitt-Block (M00)
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,55 @@
# D-DASH · Dashboard (3 Rollen-Layouts) + Cmd+K
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Die **„KI"-Widget-Quelle entfällt** aus dem Widget-Katalog (kein KI-Layer in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]). Die Widget-Registry/-Katalog bleibt; nur KI-Widgets fallen weg.
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P11 — Globale Suche & Dashboard (bedient `R-P11a`/`R-P11b`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-07-01 → fällig 2026-07-03 |
| **Status** | geplant |
> 🟦 **Bespoke + Compose:** Das **Cmd+K-Such-Modal ist BESPOKE** (klein); das **Dashboard** ist KPI+Widget-Compose; die Vollbild-Such-View aus A2. Deckt alle P11-Screens (Suche + Dashboard).
> 🟢 **Kein Pivot-Sonderfall** (P11 nicht Teil der projekt-zentrischen Kern-Kette). Aber: Such-Index + Dashboard-Widgets greifen auf den **`Projekt`-Kern** zu (EIN `Projekt`-Entity-Typ, kein separater Index-Typ je Pipeline). **v1 = nur 3 feste Rollen-Layouts (GF/Büro/Monteur)** ohne Drag&Drop (Layout-Persistenz + Custom-Widgets + Export → v2). Such-Backend v1 = **Meilisearch-Keyword** (pgvector/Hybrid → v2).
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, KPI-Kacheln, Charts, A5 Modal für Cmd+K)
- **Blockt:** `D-POLISH` (Politur baut u. a. auf Dashboard auf)
- **Bedient (Dev):** `R-P11a`/`R-P11b` (M24 Globale Suche + M20 Dashboard)
- **Subframe:** Pflicht je Route. Cmd+K-Modal **BESPOKE** (klein); Dashboard = KPI+Widget-Compose; Vollbild-Suche aus A2.
## Was wir bauen
Das **Cmd+K-Such-Modal** (global, gruppierte Treffer mit Match-Highlight), die **Vollbild-Such-View** mit Filtern und das **Dashboard mit 3 festen Rollen-Layouts** (GF/Büro/Monteur) inkl. Dashboard-Switcher.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **Cmd+K-Such-Modal** [global] | Auto-fokussiertes Such-Eingabefeld, Live-Suche (300ms debounce) · Trefferliste **gruppiert nach Entity-Typ** mit Icon, Titel, Subtitle, **Match-Highlight-Snippet**, letzte-Aktivität (relativ) · Filter-Chips für Entity-Typ (Multi-Select: Kontakte/Projekte/Files/Tasks/Leads …) · Tastatur-Navigation (↑↓ + Enter öffnen, Cmd+Enter neuer Tab, Esc schließen) + Shortcut-Anzeige · Leer-Zustand: **RecentSearches** + Tipps · „Alle {n} Treffer zeigen" → Vollbild-Suche · Loading-Indikator | **BESPOKE** (klein) |
| Vollbild-Such-View [`/search`] | Such-Feld (aus URL-Param), volle Trefferliste (cursor-paginiert 50/Page) mit erweiterten Metadaten (Erstellt, Verantwortlicher, Tags) · **Filter-Sidebar** (Entity-Typ, Erstellt-Range, Verantwortlicher, Tags, modul-spezifisch z.B. Pipeline-Status, Toggle „Archivierte einbeziehen") · Trefferanzahl-Klartext („1.247 Treffer in 0,3 s") · Sortierung (Relevanz/Letzte Aktivität/Erstellt) · Klick → Ziel-Route | A2 |
| **Dashboard** [`/dashboard` bzw. `/`] | **3 feste Rollen-Layouts (kein Drag&Drop v1):** **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 · Live-Update (SSE/WebSocket) + „Live-Updates pausieren" · Edit = **nur Widget-Filter/Zeitraum** · „Daten zuletzt aktualisiert vor X Min" bei veralteten Aggregaten | KPI + Widget-Compose |
| Dashboard-Switcher [im Dashboard-Header] | Verfügbare Dashboards (rollen-gematcht) auswählbar · Default-Routing nach Rolle | (Teil des Dashboard) |
*(Flow-Editor/Booking/Kalender/Signatur aus SCREEN-MAP §5 gehören zu P12/P16, nicht hierher. Custom-Widgets/Export + Drag&Drop-Grid = v2. Forecast/KPI-Datenquellen kommen aus P8.)*
## Features (muss abgedeckt sein)
- [ ] Cmd+K-Modal (global Hotkey, debounced, gruppierte Treffer, Match-Highlight, Tastatur-Navigation, RecentSearches) + Wechsel in Vollbild-Such-View mit Filtern
- [ ] Meilisearch-Keyword-Suche permission-aware (SearchAdapter je Modul); Server-side Permission-Filter (Trefferanzahl = erlaubte Treffer; Klartext „weitere Treffer, die du nicht siehst")
- [ ] 3 feste Rollen-Dashboards (GF/Büro/Monteur, SHK-Default geseedet) aus Widget-Katalog (Sales/Projekte/Tasks/HR/Activity/Comms/~~KI~~ → KI entfällt [[AD-26]])
- [ ] Dashboard-Widgets live (SSE/WebSocket) mit Aggregat-Cache + Lazy-Load/Skeleton; permission-gegated; Monteur-Dashboard mobile-first
- [ ] Edit nur Widget-Filter/Zeitraum (kein Grid-Editor v1); „zuletzt aktualisiert"-Hinweis
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Such-Eingabefeld mit Auto-Fokus + Debounce; Trefferliste gruppiert nach Entity-Typ mit Typ-Icon; Match-Highlight-Snippet; Relativ-Zeit; Entity-Typ-Filter-Chips (Multi-Select); Tastatur-Navigations-Highlight + Shortcut-Leiste; RecentSearches-Liste (Einzel-/Alle-Löschen); „Alle Treffer zeigen"-Link; Filter-Sidebar (Entity-Typ/Date-Range/Verantwortlicher/Tags/modul-spezifisch + Archiviert-Toggle); Sortier-Auswahl; Trefferanzahl-Klartext; Pagination; KPI-Kachel (Wert/Label/Trend-Pfeil/Vergleich); Listen-Widget; Trend-Chart (Linie/Balken/Donut); Begrüßungs-Widget; Dashboard-Switcher; Widget-Filter-/Zeitraum-Konfig (kein Grid-Editor v1); „Live-Updates pausieren"-Toggle; „zuletzt aktualisiert"-Hinweis; Skeleton-Loading; Empty-/Keine-Treffer-/Fehler-/Permission-Denied-States (Klartext).
## Quellen (granular)
- `designer-briefs/P11-suche-dashboard.md` (vollständiger Brief — Suche + Dashboard, diese Doc ist sein Ticket-Destillat)
- `ENTITY-MODEL.md` → Domäne 6 (Suche & Dashboard; Projekt-Kern als EIN Index-/Widget-Typ)
- `SCREEN-MAP.md` → §5 Dashboard/Cmd+K · `ROADMAP.md` → Phase 11 · `_bmad-output/specs/M24-globale-suche.md`, `M20-dashboard.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,56 @@
# D-FLOW · Flow-/Node-Editor (Bespoke, Langläufer)
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der eingebettete „Sprach-zu-Automation"-/KI-Einstieg **entfällt** (kein LLM in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]). D-FLOW ist ein **reiner visueller Flow-/Node-Editor** (Canvas + Dry-Run-Vorschau + Loop-/Rate-Warnmodal). Alle Sprach-/KI-Stellen unten sind durchgestrichen; die KI-Pipeline P13 (R-P13) ist gelöscht.
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P12 — Automation-Engine (bedient `R-P12a`/`R-P12b`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · **Langläufer ab 2026-06-18** → fällig 2026-07-03 |
| **Status** | geplant |
> 🟦 **Bespoke-Abgrenzung:** Dieses Ticket deckt **NUR den Flow-/Node-Editor** (~~inkl. eingebettetem Sprach-zu-Automation-Einstieg~~ → entfällt [[AD-26]]; Dry-Run-Vorschau und Loop-/Rate-Schutz-Warnmodal — alles Bespoke-Teile des Editors). Die übrigen P12-Screens (Automation-Liste, Execution-Detail/-Liste, Template-Katalog) sind Compose aus A2/A3 → P12-Compose-Anteil.
> 🔴 **Schwerste UI der App (AD-16, ab 22.06. täglich 1h).** Erste USP-Säule, vollständig bespoke. Klartext-First überall: Knoten-Labels, Dry-Run-Ausgaben, Loop-/Rate-Warnungen und Logs in **verständlichem Deutsch**.
> 🟡 **v1-Grenze:** KWP-Push-Action nur als erweiterbarer Registry-Eintrag (kein KWP-Konfig-UI in v1). ~~Sprach-zu-Automation rendert hier den Flow-Vorschlag; die KI-Pipeline selbst liegt in P13.~~ → **entfällt ([[AD-26]]).**
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, A5 Modal)
- **Blockt:** `R-P12b` (der Editor ist die kritische UI, an der die Automation-Engine andockt)
- **Subframe:** Pflicht je Route. Archetypen aus D0; Flow-Editor selbst ist **BESPOKE — schwerste UI**.
## Was wir bauen
**Nur den visuellen Flow-/Node-Editor**: Graph-Canvas mit Knoten-Katalog, Klartext-Konfig, Mini-Map, Toolbar, Inline-Validation — plus die bespoke Editor-Teile ~~Sprach-zu-Automation-Einstieg~~ (entfällt [[AD-26]]), Dry-Run-Vorschau und Loop-/Rate-Schutz-Warnmodal.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **Flow-/Node-Editor** [`/automations/:id/edit`] | Graph-Canvas (Knoten + Kanten) · Knoten-Katalog-Sidebar (filterbar nach Modul-Quelle, Drag-&-Drop oder Klick-Hinzufügen) · Knoten-Konfig-Panel mit **Klartext-Label** · Mini-Map · Toolbar (Zoom/Pan/Undo/Redo/Zentrieren/Auto-Layout) · Validation-Hinweise inline (unverbundener Knoten, Cycle-Warnung, fehlendes Pflichtfeld) · Save/Aktivieren/Deaktivieren · **Dry-Run-Auslöser** | **BESPOKE — schwerste UI** |
| ~~**Sprach-zu-Automation-Einstieg** [im Editor]~~ → **entfällt ([[AD-26]])** | ~~Text-/Spracheingabe-Feld · Live-Streaming-Antwort · KI-Flow-Vorschau im Canvas + Klartext-Beschreibung · Rückfragen bei Mehrdeutigkeit · Risiko-Hinweise · Bestätigungs-/Anpassungs-Schritt (nie Auto-Aktivierung!) · Beispiel-Prompts~~ | ~~Bespoke-Teil des Editors~~ |
| **Dry-Run-Vorschau** [Modal im Editor] | „Trifft X Datensätze" + erste 5 Beispiele · Schritt-für-Schritt-Simulation mit Klartext je Step (z. B. „Email würde an … gehen") · **Bestätigungs-Pflicht** ab >100 Datensätzen/Schritt (Schwelle tenant-konfigurierbar) | A5 + Simulations-Liste |
| Loop-/Rate-Schutz-Warnmodal [im Editor] | Schleifen-Erkennung mit **Abhängigkeits-Graph-Visualisierung** + „Beheben" · Anomalie-Pause-Hinweis (Klartext: „2.000-mal in 5 Min, typisch 5-10/Tag — pausiert") | A5 + Mini-Graph |
*(Automation-Liste, Execution-Detail/-Liste, Template-Katalog = P12-Compose. Trigger-/Action-Library = Daten im Knoten-Katalog, kein eigener Screen. KWP-Push-Konfig → v2.)*
## Features (muss abgedeckt sein)
- [ ] Graph-Editor: Knoten hinzufügen/konfigurieren/löschen/duplizieren, Kanten erstellen/löschen, verschieben, Auto-Layout, Undo/Redo, Mini-Map
- [ ] Knoten-Katalog mit voller Trigger-Library (CRM/Lead/Sales/Projekte/Email/Forms/Booking/Kalender/Zeit/Webhook) + Action-Library (CRM/Notification/HTTP/Task/If-Else/Delay/Loop; KWP-Push erweiterbar)
- [ ] Klartext-Knoten-Labels + Klartext-Validation-Hinweise (unverbunden, Cycle, unvollständig)
- [ ] ~~Sprach-zu-Automation: Satz → Flow-Vorschlag mit Rückfragen, Risiko-Hinweisen, **Bestätigungs-Pflicht (nie Auto-Aktivierung)**~~ → **entfällt ([[AD-26]])**
- [ ] Dry-Run mit Klartext-Wirkungsvorschau + Pflicht-Bestätigung ab Schwelle
- [ ] Schutz: Loop-Guard (Abhängigkeits-Graph-Warnung), Rate-Limit + Anomalie-Pause
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Graph-Canvas (Knoten + Kanten, Pan/Zoom); Knoten-Katalog-Panel (gruppiert/filterbar nach Modul); Knoten-Konfig-Panel (typ-abhängige Felder); Klartext-Knoten-Label-Renderer; Verbindungs-Erstell-Interaktion; Mini-Map; Editor-Toolbar (Zoom/Undo/Redo/Auto-Layout/Zentrieren); Inline-Validation-Badges/Hinweise; ~~Sprach-/Text-Eingabefeld mit Streaming-Antwort; Beispiel-Prompt-Chips;~~ (entfällt [[AD-26]]) Dry-Run-Vorschau-Liste (getroffene Datensätze + Beispiele); Bestätigungs-Modal (Confirm-Phrase-Variante); Abhängigkeits-Graph-Mini-Visualisierung (Loop-Guard); Status-Pills (aktiv/pausiert/Entwurf/fehlgeschlagen/übersprungen); Empty-/Loading-/Permission-Denied-States (Klartext).
## Quellen (granular)
- `designer-briefs/P12-automation-engine.md` → §Benötigte Screens „Flow-/Node-Editor" ~~+ „Sprach-zu-Automation-Einstieg"~~ (entfällt [[AD-26]]) + „Dry-Run-Vorschau" + „Loop-/Rate-Schutz-Warnmodal" (NUR diese) + zugehörige Features/UI-Elemente
- `ENTITY-MODEL.md` → Domäne 7 (Automation ~~& KI~~: AutomationRule/Step/Execution/Credential — KI entfällt [[AD-26]])
- `SCREEN-MAP.md` → §5 Flow-Editor · `DESIGNER-FIRST-PLAYBOOK.md` → §3 Rang 1 · `ROADMAP.md` → Phase 12 · `_bmad-output/specs/M17-automation-engine.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,51 @@
# D-FORM · Form-Builder-Canvas + öffentliches Formular (Bespoke)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P16 — Kalender, Booking, Forms & Signatur (bedient `AK-P16a`–`AK-P16d`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-24 → fällig 2026-06-26 |
| **Status** | geplant |
> 🟦 **Bespoke-Abgrenzung:** Dieses Ticket deckt **NUR den Form-Builder-Canvas + das öffentliche Formular** (P16). Die **Booking-Page + Kalender-View** (P16) → **`D-BOOK`**. Die übrigen P16-Screens (Forms-Liste, Submissions, Buchungs-/Booking-Compose, Signatur-Wizard) sind Compose aus A2/A3/A6 → P16-Compose-Anteil (Signatur-Wizard → `D-REST`).
> 🟡 **v1-Schnitte:** Form-Sharing = **URL + QR + iFrame** (personalisierte Links / JS-Snippet → v2). Der hier gebaute M05-Form-Renderer wird in HR (P17) wiederverwendet — robust und einbettbar designen.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, 12 Feldtypen aus A4, Drag&Drop-Primitive)
- **Blockt:** — (de-facto Vorlage für HR-Form-Renderer in `D-HR`/P17)
- **Bedient (Dev):** `AK-P16a`–`AK-P16d` (M05 Form-Builder)
- **Subframe:** Pflicht je Route. Form-Builder-Canvas + öffentliches Formular sind **BESPOKE** (Canvas = schwerste UI nach Flow-Editor).
## Was wir bauen
**Nur den Form-Builder-Canvas** (Feld-Palette, Drag&Drop-Canvas, Conditional-Logic-Editor, Post-Submit-Actions) und das **öffentliche Formular** (gerenderte Felder, Conditional Logic live, mCaptcha, Tenant-Logo).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **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) |
| 🌐 Öffentliches Formular [`/f/{tenant}/{slug}`] | Gerenderte Felder, Conditional Logic live, mCaptcha, Submit → Erfolgs-Text oder Redirect · Tenant-Logo · 4 Zustände | BESPOKE-Public |
*(Booking-Page + Kalender → `D-BOOK`. Forms-Liste, Submissions, Signatur-Wizard = P16-Compose. Task-Komponente aus P4 wird eingebettet, nicht neu gebaut.)*
## Features (muss abgedeckt sein)
- [ ] Form-Builder mit Drag-&-Drop, **12 Feld-Typen**, **Conditional Logic**, Validierung pro Feld, SHK-Form-Templates geseedet
- [ ] Sharing: iFrame-Embed + QR + öffentliche URL (personalisierte Links → v2)
- [ ] Post-Submit-Actions mit Field-Mapping + ActionLog (Lead/Kontakt/Projekt/Task anlegen, Email an Submitter/Team, Webhook, Automation-Trigger, Auto-Match)
- [ ] Öffentliches Formular: Conditional Logic live, mCaptcha, Submit → Erfolgs-Text/Redirect, Tenant-Logo, 4 Zustände
- [ ] Form-Renderer robust/einbettbar (Reuse in HR P17, Booking-Intake, Urlaub/Krank/Requests)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
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); Tenant-Logo/Branding; Erfolgs-/Redirect-Zustand; Empty-/Loading-/Fehler-/Permission-Denied-States (Klartext mit Lösungs-Knopf).
## Quellen (granular)
- `designer-briefs/P16-kalender-booking-forms-signatur.md` → §Benötigte Screens „Form-Builder-Canvas" + „Öffentliches Formular" (NUR diese) + zugehörige Features/UI-Elemente
- `ENTITY-MODEL.md` → Domäne 9 (Forms)
- `SCREEN-MAP.md` → §3 Form-Builder · `DESIGNER-FIRST-PLAYBOOK.md` → §3 Rang 2 · `ROADMAP.md` → Phase 16 · `_bmad-output/specs/M05-form-builder.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,65 @@
# D-HR · HR-Compose-Screens
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P17 — HR-Hub (bedient `AK-P17a`/`AK-P17b`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-25 → fällig 2026-06-26 |
| **Status** | geplant |
> 🟩 **Compose-Ticket:** deckt **alle HR-Screens** (P17). Reines Compose aus A2/A3/A4/A5/A6/A7 — kein Bespoke. **Wiederverwenden statt neu bauen:** M05-Form-Renderer aus P16 (Urlaub/Krank/Requests), KPI-Kacheln + Charts.
> 🟡 **Sehr breites Modul, sensible Daten — strenge Permission-Gates.** Quiply-Komplett-Ablösung. Trennung beachten: **MA-Sicht** (eigener Bereich, eigene Daten) vs. **HR-Admin-Sicht** (`/admin/hr/...`, alle MA). Sensible Tabellen (Lohnabrechnung, Krank-AU, Passwort-Safe, Personaldokumente) haben **zusätzlich** zum RLS einen App-Permission-Layer — Werte nie automatisch angezeigt (Reveal + Audit-Log). Surveys bleiben v1; Memberspot/Boobora-Onboarding-Drittanbieter → v2.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, KPI-Kacheln, Charts)
- **Blockt:** —
- **Bedient (Dev):** `AK-P17a`/`AK-P17b` (M14 HR-Hub)
- **Subframe:** Pflicht je Route. Archetypen aus D0; M05-Form-Renderer aus P16 einbetten (nicht neu bauen).
## Was wir bauen
Den **kompletten HR-Hub**: persönlicher MA-Bereich + Announcements, Urlaubs-/Krankmeldungs-Workflow, Lohnabrechnungen, MA-Anträge, verschlüsselter Passwort-Safe, Surveys, MA-Verzeichnis + Standorte, eigene Dokumente — plus die HR-Admin-Flächen (`/admin/hr/...`).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| HR-Hub-Start [`/hr`] | Angepinnte Announcements, offene Bestätigungs-/Upload-Pflichten, eigene pendente Anträge, Team heute (Urlaub/krank, gegated), Geburtstage, letzte Lohnabrechnung-Hinweis, Quick-Links · prominente Aktionen „Krank melden / Urlaub beantragen / Antrag stellen" | Compose aus KPI + Listen |
| Announcements + Detail [`/hr/announcements`, `/:id`] | Feed mit Pinned-Sektion + Ungelesen-Filter · Detail: Markdown, Anhänge, Reaktionen (gruppiert), 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, vorhandener Urlaub) · Krankmeldung: Start, erwartete Rückkehr, **AU-Upload (verschlüsselt)** · Admin-Monatskalender + KPI-Kacheln | A2 + A4 + A5 |
| Lohnabrechnungen [`/hr/payslips`, `/admin/hr/payslips`] | Eigene: Liste nach Periode + PDF-Viewer (Öffnen setzt gelesen) · Admin: alle MA + Einzel-/Bulk-Upload mit **Auto-Match-Vorschau** (hart/weich/kein Match, Farb-Konfidenz) | A2 |
| MA-Anträge [`/hr/requests`] | Template-Wahl (Spesen, Hardware, Schulung, Zeugnis, sonstiges), M05-Form, Genehmiger-Vorauswahl, Priorität, Anhänge · Detail: Kommentar-Stream (interne Notizen verborgen für Requester), Entscheidung | A2 / A3 |
| Passwort-Safe [`/hr/password-safe`] | Vault-Liste (nur mit Access) → Eintrags-Liste (Titel, Tags — **keine Werte!**) → Eintrags-Detail: **Reveal-Button je Wert** (audit-geloggt), Copy mit 30s-Auto-Clear, Access-Verwaltung (nur Vault-Admin), Audit-Log-Anzeige | A2 / A3 + Reveal |
| Surveys [`/hr/surveys`] | Teilnahme: Items (Text/Rating/NPS/Choice/Boolean/Datum) · Auswertung (`/results`, gegated): Häufigkeits-Charts, Durchschnitte, Textantworten · Admin-Editor mit Audience + Sichtbarkeit + Anonymität | A4 + Charts |
| MA-Verzeichnis + MA-Detail [`/hr/directory`, `/:userId`] | Karten/Tabelle: Avatar, Name, Position, Team, Standort · Click-to-Call/Mail/Chat · Detail: Stammdaten, Notfallkontakt (nur self/HR), Inline-Edit der selbst-pflegbaren Felder, eigene Dokumente | A2 / A3 |
| Standorte + Detail [`/hr/locations`, `/:id`] | Karten/Tabelle: Name, Adresse, Telefon, Map-Vorschau, MA-Anzahl, Beschreibung, Bild · Admin: anlegen/bearbeiten/Default/Bulk-Reassign | A2 / A3 |
| Eigene Dokumente [`/hr/my-documents`] | Liste (Titel, Art, Datum, Gültigkeit) + Filter, Upload eigener Dokumente, File-Viewer; vom Büro hochgeladene = read-only | A2 |
| Upload-Erinnerungen-Verwaltung [`/admin/hr/upload-reminders`] | Reminder-Liste (Titel, Cadence, Audience, pendend/überfällig) · Editor (Dokumentart, Cadence, Mandatory, Linked-Form) · Detail mit Dispatch-Liste | A2 + A6 |
| Request-Templates [`/admin/hr/request-templates`] | Template-Liste · Editor: Name, Kind, Default-Approver-Logik, Linked-Form, Instructions, Audience · SHK-Defaults geseedet | A2 + A6 |
| Announcement-Verwaltung [`/admin/hr/announcements`] | Alle (inkl. Draft/archiviert) · Editor: Titel, Markdown-Body, Audience-Wahl, Acknowledgement-Toggle, Reactions/Comments-Toggle, Anhänge, Pin, geplante Veröffentlichung, Ablauf | A2 + A4 |
| Passwort-Safe-Verwaltung [`/admin/hr/password-safe`] | Tenant-weite Vault-Sicht (auch ohne Inhalts-Access), Vault-Anlage/Archiv/Delete, Access-Verwaltung, Audit-Log-Übersicht (Reveals nach User/Vault) | A2 + A6 |
*(Mitarbeiter-Einladung/Rollen → P2-Admin. Plantafel → P9 (`D-PLAN`). Dashboard-HR-Widgets → P11 (`D-DASH`). Click-to-Call/Chat-Start → P15.)*
## Features (muss abgedeckt sein)
- [ ] HR-Daten AES-256-GCM-verschlüsselt; sensible Felder KMS-backed Envelope-Encryption (AD-8)
- [ ] MA-Bereich vs. HR-Admin-Bereich strikt getrennt; sensible Tabellen zusätzlich App-Permission-gegated (Standard-MA sieht „krank von X bis Y" — keine Diagnose/AU-Inhalte)
- [ ] Verschlüsselter Passwort-Safe mit Audit-Trail (Reveal/Copy on-demand + Audit; Werte nie in Liste; Copy 30s-Auto-Clear; DSGVO-Export)
- [ ] Urlaubs-Approval-Workflow + Krankmeldungs-Erfassung → speisen Abwesenheits-Kalender (M25) + Plantafel-Konflikte (M04)
- [ ] Lohnabrechnungs-Bulk-Upload mit Pattern-Auto-Match (Konfidenz), Read-Tracking, Audit pro Read
- [ ] Upload-Erinnerungen mit Cadence + Eskalation; Announcements mit Acknowledgement + Read-Receipt + Reaktionen/Kommentare; Surveys (anonym möglich)
- [ ] Anträge laufen als M05-Form-Submissions (Form-Renderer aus P16 wiederverwenden); Mobile-Default-Tab für Monteure
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
KPI-Kacheln (heute krank / im Urlaub / pendente Genehmigungen / offene AU); Card-/Widget-Hub mit Tab-Navigation (nur sichtbare Tabs je Permission); Announcement-Feed mit Pinned-Sektion; Markdown-Renderer + -Editor; Reaktions-Picker (Emoji); Kommentar-Liste mit Reply; Read-Receipt-Tabelle (gegated); Acknowledgement-Button mit Counter; M05-Form-Renderer (eingebettet); Genehmiger-Aktions-Buttons (Approve/Reject/Rückfrage) mit Konflikt-Hinweis-Banner; verschlüsselter File-Upload mit Vertraulichkeits-Marker; Monatskalender-Abwesenheits-Sicht; PDF-Viewer + Download; Bulk-Upload-Dropzone mit Match-Vorschau-Tabelle (Farb-Konfidenz); Vault-Liste/Kacheln; Eintrags-Liste ohne Werte; Reveal-Button je Wert; Copy-mit-Auto-Clear; Audit-Log-Tabelle; Template-Editor mit Approver-Logik-Selector; Survey-Item-Renderer + Auswertungs-Charts; MA-Karten/Tabelle mit Click-to-Call/Mail/Chat; Standort-Karte mit Map-Vorschau; Dispatch-Status-Liste; Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext mit Lösungs-Knopf).
## Quellen (granular)
- `designer-briefs/P17-hr-hub.md` (vollständiger Brief — alle HR-Screens, diese Doc ist sein Ticket-Destillat)
- `ENTITY-MODEL.md` → Domäne 10 (HR-Hub)
- `SCREEN-MAP.md` → §3 HR · `ROADMAP.md` → Phase 17 · `_bmad-output/specs/M14-hr-hub.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,52 @@
# D-KAMP · Kampagnen-Editor + Segmente (Bespoke)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P14 — Email & Marketing (bedient `AK-P14a`/`AK-P14b`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-25 → fällig 2026-06-26 |
| **Status** | geplant |
> 🟦 **Bespoke-Abgrenzung:** Dieses Ticket deckt **NUR den Kampagnen-Editor + die Segmente** (Segment-Builder). Die übrigen P14-Screens (Sende-Domain, Kampagnen-Liste/-Detail, Sender + Suppression, Templates, öffentliche Unsubscribe-Page) sind Compose aus A2/A3/A6/A4-Public → P14-Compose-Anteil (Akeshan-Routen; Unsubscribe-Page Bespoke-Public separat).
> 🔴 **DSGVO-First:** Double-Opt-In, Suppression-Check vor jedem Versand, One-Click-Unsubscribe, Pflicht-Footer (Impressum + Unsubscribe), Pflicht-Checkliste vor Versand — Versand wird bei rotem Check **blockiert**.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, Wizard A5, Filter-Builder-Primitive)
- **Blockt:** —
- **Bedient (Dev):** `AK-P14a`/`AK-P14b` (M10 Marketing — Kampagnen-Versand + Segment-Engine)
- **Subframe:** Pflicht je Route. Archetypen aus D0; Kampagnen-Editor ist **BESPOKE**.
## Was wir bauen
**Nur den mehrstufigen Kampagnen-Editor** (Basis → Inhalt → Empfänger → Test → Zeit → Bestätigung, DSGVO-gegated) und den **Segment-Builder** (verschachtelter AND/OR-Filter-Baum mit Live-Empfänger-Anzahl + Auto-Exclusion).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **Kampagnen-Editor** [`/email-marketing/campaigns/new`] | Mehrstufiger Wizard: Basis (Name/Sender/Subject/Preheader) → **Inhalt** (Rich-Text + HTML-Toggle, Personalisierungs-Tokens, Bild-Upload, Pflicht-Footer Impressum+Unsubscribe, Desktop-/Mobile-Vorschau) → Empfänger (Segment-Wahl/ad-hoc-Filter, Vorschau mit **Ausschluss-Aufschlüsselung** Abgemeldet/Bounce/Suppression) → Test-Versand (max. 5 Adressen, Sample-Tokens) → Zeitpunkt (sofort/geplant/Entwurf) → **Bestätigung mit Klartext-Checkliste** (Domain verifiziert? Unsubscribe? Impressum?) — Versand bei rotem Check blockiert | **BESPOKE** |
| Segmente [`/email-marketing/segments`] | **Filter-Baum lesbar** (verschachtelte AND/OR), Tags/Custom-Felder/Verantwortlicher/Datum/aktiver-Deal/Sprache · Live-Empfänger-Anzahl · Auto-Exclusion-Aufschlüsselung · Sample-Vorschau (max. 50) · dynamisch/statischer Snapshot | A2 + Filter-Builder |
*(Sende-Domain, Kampagnen-Liste/-Detail, Sender + Suppression, Templates, Unsubscribe-Page = P14-Compose → Akeshan-Routen. Inbox/Mail-Detail/Compose/Mailbox-OAuth → v2/P23.)*
## Features (muss abgedeckt sein)
- [ ] Kampagnen-Builder 6-stufig mit Personalisierungs-Tokens (auch Custom-Felder), Pflicht-Footer-Auto-Injektion, Desktop-/Mobile-Vorschau
- [ ] Pflicht-Validierungen vor Versand (verifizierte Domain, Unsubscribe-Link, Impressum, Subject, >0 Empfänger, Daily-Cap) — Block + Fix-Link bei rotem Check
- [ ] Ausschluss-Aufschlüsselung (Abgemeldet/Bounce/Suppression) in Empfänger-Vorschau
- [ ] Segmente: verschachtelter AND/OR-Filter-Baum, Live-Auflösung, Auto-Exclusion (Unsubscribe/Suppression/kein Opt-In/archiviert/keine Email), dynamisch vs. statischer Snapshot
- [ ] Test-Versand (max. 5 Adressen, Sample-Tokens); geplanter Versand (timezone-aware)
- [ ] (Stats: Klick-Map + A/B-Vergleich leben im Kampagnen-Detail = P14-Compose — hier nur der Editor/Builder)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Mehrstufiger Wizard mit Progress; Rich-Text-/HTML-Editor mit Token-Einfügen; Bild-Dropzone; Desktop-/Mobile-Vorschau-Umschalter; Pflicht-Footer-Hinweis; Segment-Picker; verschachtelter AND/OR-Filter-Builder; Empfänger-Vorschau-Liste mit Auto-Exclusion-Aufschlüsselung; Test-Versand-Eingabe (max. 5); Date-Time-Picker (timezone-aware); Pflicht-Checkliste mit grün/rot-Status + Fix-Links; Versand-Blockade-Hinweis; Live-Empfänger-Anzahl; Sample-Vorschau-Liste; Empty-/Loading-/Permission-Denied-States (Klartext).
## Quellen (granular)
- `designer-briefs/P14-email-marketing.md` → §Benötigte Screens „Kampagnen-Editor" + „Segmente" (NUR diese) + zugehörige Features/UI-Elemente
- `ENTITY-MODEL.md` → Domäne 8 (Kommunikation: Campaign/OutboundEmail/RecipientSegment/Unsubscribe/EmailSuppressionList)
- `SCREEN-MAP.md` → §3 Kampagnen · `ROADMAP.md` → Phase 14 · `_bmad-output/specs/M10-email-marketing.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,50 @@
# D-KANBAN · Pipeline-Kanban (Bespoke, konfigurierbar)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P8 — Projekt & Pipelines (Kern + Pipeline-Engine) (bedient `R-P8a`/`R-P8b`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-24 → fällig 2026-06-26 |
| **Status** | geplant |
> 🟦 **Bespoke-Abgrenzung:** Dieses Ticket deckt **NUR den Pipeline-Kanban** (das EINE konfigurierbare Board). Die übrigen P8-Screens (Projekt-Liste, **Projekt-Detail**, Pipeline-Config-Admin, Lost-Reasons) sind Compose aus A2/A3/A6 → gehören in den P8-Compose-Anteil von **`D-CRM`** bzw. das Projekt-Detail wird in P9 von **`D-PLAN`/`D-ABN`** um Sub-Areas erweitert. Forecast/KPI-Widgets → `D-DASH` (P11).
> 🔴 **Pivot-Vorrang (AD-20):** Es gibt **EINEN `Projekt`-Kern** und **konfigurierbare Pipeline-Views**. „Deal" und „Auftrag" sind **Pipeline-Typen** (`Pipeline.typ_hint = sales/auftrag/custom`), KEINE eigenen Entitäten. **EIN konfigurierbarer Kanban** statt getrenntem Sales- + Projekt-Kanban (SCREEN-MAP §3 „Sales-Kanban [/deals]" ist überholt). **Kein Won-Handoff**, kein zweiter Datensatz — ein Projekt wechselt nur die Pipeline. **`Status` ist immer pipeline-intern** (`PipelineStage.stage_kind = offen/gewonnen/verloren`).
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, KPI-Kit), `R-REFIT` (Datenmodell-Refit)
- **Blockt:** —
- **Bedient (Dev):** `R-P8a`/`R-P8b` (Projekt-Kern + Pipeline-Engine: der Kanban ist die Haupt-Interaktion auf der Engine)
- **Subframe:** Pflicht je Route. Archetypen aus D0; der Pipeline-Kanban ist **BESPOKE** (ein Board für ALLE Pipeline-Typen).
## Was wir bauen
**Genau den einen konfigurierbaren Pipeline-Kanban** — ein Board, das je gewählter Pipeline (sales/auftrag/custom) die Stages als Spalten zeigt, mit Drag&Drop-Stage-Wechsel, Won/Lost-Drop-Dialogen und permission-gegateten Volumen-Aggregaten.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **Pipeline-Kanban (konfigurierbar)** [`/projects` bzw. `/projects/pipelines/:id`] | Spalten = Stages der gewählten Pipeline (in Reihenfolge): Stage-Name, Projekt-Anzahl, Aggregat-Volumen (gegated), Win-% · Projekt-Karten: Titel, Volumen (gegated über PipelineFieldConfig + Field-Level-Perms), Verantwortlicher-Avatar, Close-/Zeitraum-Datum, max. 3 Tags, Stuck-/Überzogen-Marker · **Drag&Drop** Stage-Wechsel mit Validation · Drop in `gewonnen`-Stage → Bestätigung · Drop in `verloren`-Stage → **Lost-Reason-Pflicht** · **Pipeline-Switcher** (sales/auftrag/custom) · Filter (Verantwortlicher/Tags/Volumen-Range/Datum) + „nur meine" · Bulk-Select · Pagination pro Spalte (100+) · Real-Time (SSE) | **BESPOKE** (ein Board für ALLE Pipeline-Typen) |
*(Projekt-Liste, Projekt-Detail, Pipeline-Config-Admin, Lost-Reasons-CRUD = P8-Compose → `D-CRM`. Sub-Areas am Projekt-Detail → `D-PLAN`/`D-ABN` (P9). Forecast/KPI-Widgets → `D-DASH` (P11).)*
## Features (muss abgedeckt sein)
- [ ] EIN konfigurierbarer Kanban (Drag&Drop, Stage-Wechsel-Validation, gewonnen/verloren-Workflow, Real-Time SSE)
- [ ] Won/Lost-Drop-Dialoge (Bestätigung gewonnen; Lost-Reason-Pflicht verloren)
- [ ] Volumen permission-gegated (über PipelineFieldConfig primär, `deals.read_volume_*`/`read_aggregates` als Backstop — ohne Recht „—")
- [ ] Pipeline-Switcher zwischen sales/auftrag/custom-Pipelines
- [ ] Filter (Verantwortlicher/Tags/Volumen-Range/Datum) + „nur meine"-Quick-Filter, Bulk-Select, Pagination pro Spalte
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Kanban-Board (Spalten = Stages, horizontal scrollbar/responsive); Drag&Drop-Karten; Stage-Spalten-Header mit Aggregat (Count + Volumen + Win-%); Projekt-Karte (Titel, gegatetes Volumen, Avatar, Datum, Tag-Chips, Stuck-Marker); Pipeline-Switcher; Filter-Bar + „nur meine"-Quick-Filter; Bulk-Action-Toolbar; gewonnen/verloren-Bestätigungs-Dialog (Lost-Reason-Pflicht); 24h-Rückgängig-Banner; „Volumen verborgen (—)"-Zustand; Empty-/Loading-/Fehler-/Permission-Denied-States (Klartext).
## Quellen (granular)
- `designer-briefs/P08-projekt-pipelines-kern.md` → §Benötigte Screens „Pipeline-Kanban (konfigurierbar)" (NUR dieser Screen) + zugehörige Features/UI-Elemente
- `ENTITY-MODEL.md` → **Domäne 5** (Projekt-Kern + Pipeline/Stage/PipelineFieldConfig/PipelineAccess; Pivot: typ_hint, stage_kind, EIN Board) — **Pivot-Vorrang**
- `SCREEN-MAP.md` → §3 Kanban · `ROADMAP.md` → Phase 8 · `_bmad-output/specs/M03-sales-pipeline.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,62 @@
# D-P12 · Screens P12 — Automation-Engine (ohne Flow-/Node-Editor)
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der „Sprach-zu-Automation"-/KI-Andock **entfällt** (kein LLM in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]); R-P13 ist gelöscht. P12 bleibt ein **reiner visueller Flow-Editor** (Canvas via D-FLOW) + die Nicht-Canvas-Flächen hier. Alle Sprach-/KI-Stellen unten sind durchgestrichen.
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P12 — Automation-Engine (bedient `R-P12a`/`R-P12b`) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-06 → 2026-07-07 · Gate W4 |
| **Status** | geplant (NEU — schließt P12-Screen-Lücke außerhalb des Flow-Editors) |
> **Ergänzt das Bespoke-Ticket `D-FLOW`** (visueller Flow-/Node-Editor ~~inkl. Sprach-zu-Automation-Einstieg~~ (entfällt [[AD-26]]), Dry-Run-Vorschau, Loop-/Rate-Schutz-Warnmodal — die schwerste UI der App, Langläufer ab 18.06.). **Dieses Ticket deckt die übrigen P12-Screens**: Automation-Liste, Run-History/Logs (Execution-Liste + -Detail), Template-Katalog und die Trigger-/Aktion-Konfiguration (als Knoten-Konfig-Panel-Inhalte, die der Editor einbettet). Der Graph-Canvas/Node-Editor ist **NICHT** Teil von D-P12.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail + Timeline, A5 Modal, A6 Settings)
- **Bedient (Dev):** `R-P12a` (Automation-Kern + Schutz-Mechanismen), `R-P12b` (visueller Flow-Editor + Dry-Run + 24h-Undo ~~+ Sprach-Andock~~ → Sprach-Andock entfällt [[AD-26]])
- **Parallel/Geschwister:** `D-FLOW` (BESPOKE Graph-Editor) — D-P12 liefert die List-/History-/Template-Flächen + Konfig-Panel-Inhalte, D-FLOW den Canvas
- **Subframe:** Pflicht je Route (A2 Liste, A3 Execution-Detail mit Timeline, A5 Modal, A6 Settings)
## Was wir bauen
Die **Nicht-Canvas-Flächen der Automation-Engine**: Übersichtsliste aller Automationen, Run-History (Execution-Liste + Step-by-Step-Execution-Detail mit Klartext-Diagnostik + 24h-Rückgängig), Template-Katalog (SHK + Tenant) und die **Trigger-/Aktion-Konfiguration** als typ-abhängige Knoten-Konfig-Panel-Inhalte (vom Flow-Editor eingebettet).
> 🔴 **Klartext-First überall:** Knoten-Labels, Dry-Run-Ausgaben, Loop-/Rate-Warnungen und Execution-Logs in verständlichem Deutsch, nicht technisch.
> 🟡 **v1-Grenze:** KWP-Push-Action nur als erweiterbarer Registry-Eintrag (zieht v2 nach) — kein KWP-spezifisches Konfig-UI in v1. ~~Sprach-zu-Automation rendert im Flow-Editor (D-FLOW); die KI-Pipeline selbst liegt in P13.~~ → **entfällt ([[AD-26]]).**
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Automation-Liste [`/automations`] | Name, Trigger, Status (aktiv/pausiert/Entwurf), Läufe (30d), letzte Ausführung · „nur meine"-Filter | A2 |
| **Execution-Detail** [`/automations/:id/executions/:exec_id`] | `summary_text` · Trigger-Payload user-lesbar · **Step-by-Step-Verlauf mit Klartext je Schritt** (Status, Input/Output, Dauer) · Dry-Run-Marker · **24h-Rückgängig-Button mit Restzeit-Anzeige** · Manuell-Retry · Resume-ab-Schritt | A3 + Timeline |
| Execution-Liste [`/automations/:id/executions`] | Letzte N Läufe · Filter (Status/Datum/Trigger-Typ) · Klick → Detail | A2 |
| Template-Katalog [`/automations/templates`] | SHK-Vorlagen + Tenant-Vorlagen nach Kategorie · je Template Beschreibung + Use-Case + Nutzungs-Anzahl · „Verwenden"-Button · „Eigenes Template aus Rule anlegen" | A2 |
| Trigger-/Aktion-Konfiguration [Knoten-Konfig-Panel-Inhalte] | Typ-abhängige Konfig-Felder je Trigger (CRM/Lead/Sales/Projekte/Email/Forms/Booking/Kalender/Zeit/Webhook) und je Action (CRM/Notification/HTTP/Task/If-Else/Delay/Loop) mit **Klartext-Labels** + Validation-Hinweisen (Pflichtfeld fehlt, unverbunden) · KWP-Push als registriert-erweiterbarer Eintrag (kein eigenes UI v1) · **werden vom Flow-Editor (D-FLOW) als Konfig-Panel eingebettet** | Compose (in D-FLOW-Panel) |
*(Flow-/Node-Editor ~~+ Sprach-zu-Automation-Einstieg~~ (entfällt [[AD-26]]) + Dry-Run-Vorschau-Modal + Loop-/Rate-Schutz-Warnmodal = **D-FLOW**. Trigger-/Action-Library selbst sind Daten im Knoten-Katalog, kein eigener Screen. KWP-Push-Konfig → v2.)*
## Features (muss abgedeckt sein)
- [ ] Automation-Liste (Name/Trigger/Status/Läufe/letzte Ausführung, „nur meine"-Filter)
- [ ] Execution-Liste mit Filter (Status/Datum/Trigger-Typ)
- [ ] Execution-Detail mit Step-by-Step-Timeline (Klartext je Schritt, Status/Input/Output/Dauer) + Dry-Run-Marker
- [ ] 24h-Reverse-Window-UX (Countdown-Button) + Manuell-Retry + Resume-ab-Schritt
- [ ] Template-Katalog (SHK + Tenant nach Kategorie, „Verwenden" + „aus Rule erstellen")
- [ ] Trigger-/Aktion-Konfig-Panel-Inhalte (typ-abhängige Felder, Klartext-Labels, Validation-Hinweise) — einbettbar in D-FLOW
- [ ] Status-Pills (aktiv/pausiert/Entwurf/fehlgeschlagen/übersprungen)
- [ ] Empty/Loading/Permission-Denied-States (Klartext)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Daten-Tabelle (sortierbar, paginiert) für Automation-/Execution-Liste; Status-Pills (aktiv/pausiert/Entwurf/fehlgeschlagen/übersprungen); „nur meine"-Quick-Filter + Filter-Bar (Status/Datum/Trigger-Typ); Step-by-Step-Timeline mit Status-Markern (Klartext je Schritt, Input/Output, Dauer); user-lesbarer Trigger-Payload-Renderer; Dry-Run-Marker-Badge; **24h-Reverse-Button mit Countdown**; Retry-/Resume-Buttons; Template-Karten mit Use-Case-Beschreibung + Nutzungs-Anzahl + „Verwenden"-Button + „aus Rule erstellen"; **Knoten-Konfig-Panel** (typ-abhängige Felder je Trigger/Action) mit Klartext-Knoten-Label-Renderer + Inline-Validation-Badges/Hinweise (unverbunden/Cycle/Pflichtfeld fehlt); Empty-/Loading-/Permission-Denied-States.
## Quellen (granular)
- `designer-briefs/P12-automation-engine.md` (vollständiger Brief MINUS Flow-Editor/~~Sprach-Einstieg~~ (entfällt [[AD-26]])/Dry-Run-Modal/Loop-Schutz-Modal)
- `ENTITY-MODEL.md` → **Domäne 7** (Automation ~~& KI~~: AutomationRule/Step/Execution/StepExecution/Credential/Template — KI entfällt [[AD-26]])
- `ROADMAP.md` → Phase 12 · `REQUIREMENTS.md` → Modul 17 · `PHASE-SOURCES.md` → P12
- `_bmad-output/specs/M17-automation-engine.md`
- Geschwister-Ticket (Editor): `D-FLOW` · Dev-Pendant: `ticket-docs/R-P12a.md`, `ticket-docs/R-P12b.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,59 @@
# D-P14 · Screens P14 — Email & Marketing (ohne Kampagnen-Editor)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P14 — Email & Marketing (bedient `AK-P14a`/`AK-P14b`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-27 → 2026-06-29 · Gate W3 |
| **Status** | geplant (NEU — schließt P14-Screen-Lücke außerhalb des Kampagnen-Editors) |
> **Ergänzt das Bespoke-Ticket `D-KAMP`** (Kampagnen-Editor + Segmente, BESPOKE). **Dieses Ticket deckt die übrigen P14-Screens**: Sende-Domain (DNS/BCC-Settings), Kampagnen-Liste + -Detail (Tracking/Reporting), Sender + Suppression, Templates und die öffentliche Unsubscribe-Page. Der mehrstufige Kampagnen-Editor-Wizard und der Segment-Filter-Builder sind **NICHT** Teil von D-P14 (→ D-KAMP).
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail, A6 Settings, A4 Public, KPI-Kit), `D-P5` (Connection-Card-Stil für DNS-/Status-Ampel)
- **Bedient (Dev):** `AK-P14a` (Sende-Domain + BCC-Brücke + Tracking), `AK-P14b` (Email-Marketing Kampagnen + A/B)
- **Parallel/Geschwister:** `D-KAMP` (Kampagnen-Editor + Segmente, BESPOKE) — D-P14 liefert Domain/Listen/Detail/Suppression/Templates/Unsubscribe, D-KAMP den Compose-Wizard + Segment-Builder
- **Subframe:** Pflicht je Route (A2/A3 + KPI, A6 Settings, A4-Public/Bespoke-Public für Unsubscribe)
## Was wir bauen
Die **Nicht-Kampagnen-Editor-Flächen von Email & Marketing**: die Sende-Domain-Verifikation (DKIM/SPF/DMARC + BCC-Logging-Toggle), Kampagnen-Liste + -Detail mit Tracking/Reporting (KPIs, Klick-Map, Pro-Empfänger-Tabelle), Sender + Suppression-Verwaltung, Templates und die öffentliche Unsubscribe-Page.
> 🟡 **v1-Grenze:** **Postfach-Sync ist v2** (→ P23) — kein OAuth-Mailbox-Connect, keine Inbox-View, keine Compose-Oberfläche, kein Thread-View. Aus M09 bleiben v1: Sende-Domain-Verifikation, Tenant-Inbound-Adresse, BCC-Logging-Brücke. (Compose im Sinne des Kampagnen-Inhalts-Editors lebt in **D-KAMP** als Bespoke.)
> 🔴 **DSGVO-First:** Double-Opt-In, Suppression-Check vor Versand, One-Click-Unsubscribe, Pflicht-Footer, Pflicht-Checkliste — Versand bei rotem Check **blockiert** (die Checkliste selbst gehört zum Versand-Schritt in D-KAMP; das Suppression-/Unsubscribe-/Sender-Fundament liefert D-P14).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **Sende-Domain** [`/settings/integrations/email`] | Domain-Eingabe · **DNS-Records (DKIM/SPF/DMARC) mit Copy-Button** · Verifikations-Status-Ampel (pending/verifying/verified/failed) · 5-Min-Prüf-Indikator + Klartext bei 7-Tage-Fehlschlag · **BCC-Logging-Toggle** + angezeigte BCC-Adresse + Klartext „Mails erscheinen am Kontakt" + Tenant-Inbound-Adresse-Hinweis | A6 |
| Kampagnen-Liste + -Detail [`/email-marketing/campaigns`] | Liste: Name, Status, Empfänger, Versanddatum, Stats · Detail: KPI-Header (Zugestellt/Geöffnet/Geklickt/Bounces/Abmeldungen in %) · **Klick-Map** (URLs + Counts) · Pro-Empfänger-Tabelle · (A/B-Vergleich falls vorhanden) | A2/A3 + KPI |
| Sender + Suppression [`/email-marketing/senders`] | Sender: From-Name/-Email, Domain-DKIM-Status, Default-Marker · Suppression-Liste: Adresse, Grund (Bounce/Beschwerde/manuell) | A2/A6 |
| Templates [`/email-marketing/templates`] | Template-Liste, Vorschau, als Ausgangspunkt verwenden | A2 |
| 🌐 **Unsubscribe-Page** [`/unsubscribe/{token}`] | Klartext, Bestätigungs-Button, optionale Grund-Auswahl, Erfolgs-Meldung · Tenant-Branding | A4-Public / **Bespoke-Public** |
*(Kampagnen-Editor-Wizard (Basis→Inhalt→Empfänger→Test→Zeitpunkt→Bestätigung) + Segmente-Filter-Builder = **D-KAMP**. Inbox-Liste/Mail-Detail/Compose/Mailbox-Connect-OAuth → v2/P23.)*
## Features (muss abgedeckt sein)
- [ ] Sende-Domain pro Mandant: DKIM/SPF/DMARC-Records mit Copy, 5-Min-Auto-Probe, Status-Ampel, Klartext-Fehler nach 7 Tagen
- [ ] BCC-Logging-Brücke: Toggle + Anzeige der BCC-Adresse (Activity am Kontakt, kein OAuth); Tenant-Inbound-Adresse-Hinweis
- [ ] Kampagnen-Liste + -Detail mit Tracking/Reporting (KPI-Header, Klick-Map, Pro-Empfänger-Tabelle)
- [ ] Sender-Verwaltung (From-Name/-Email, DKIM-Status, Default) + Suppression-Liste mit Grund-Badge
- [ ] Templates-Liste (Vorschau, als Ausgangspunkt verwenden)
- [ ] Öffentliche Unsubscribe-Page (One-Click, optionale Grund-Auswahl, Tenant-Branding, Erfolg/Fehler)
- [ ] Empty/Loading/Permission-Denied-States (Klartext)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
DNS-Record-Karten mit Copy-Button + Status-Ampel (Connection-Card-Stil aus D-P5); Toggle-Zeile mit Klartext (BCC) + BCC-/Inbound-Adress-Anzeige; KPI-Kacheln + Prozent-Anzeigen (Zugestellt/Geöffnet/Geklickt/Bounces/Abmeldungen); **Klick-Map-Tabelle** (URLs + Counts); Pro-Empfänger-Tabelle; Sender-Liste (From/DKIM-Status/Default-Marker); Suppression-Liste mit Grund-Badge (Bounce/Beschwerde/manuell); Template-Liste mit Vorschau + „als Ausgangspunkt verwenden"; **öffentliche Unsubscribe-Bestätigung** mit Branding (Bestätigungs-Button, optionale Grund-Auswahl, Erfolgs-Meldung); Daten-Tabelle (sortierbar/paginiert); Empty-/Loading-/Permission-Denied-States.
## Quellen (granular)
- `designer-briefs/P14-email-marketing.md` (vollständiger Brief MINUS Kampagnen-Editor & Segmente)
- `ENTITY-MODEL.md` → **Domäne 8: Kommunikation** (TenantSendingDomain, TenantInboundAddress, Email, Campaign, OutboundEmail (+Open/Click), EmailTemplate/Sender, RecipientSegment, Unsubscribe, EmailSuppressionList)
- `ROADMAP.md` → Phase 14 · `REQUIREMENTS.md` → Modul 9/10 · `PHASE-SOURCES.md` → P14
- `_bmad-output/specs/M09-email-inbox.md` (nur Sende-Domain/Inbound/BCC — Rest v2), `M10-email-marketing.md`
- Geschwister-Ticket (Editor): `D-KAMP` · Dev-Pendant: `ticket-docs/AK-P14a.md`, `ticket-docs/AK-P14b.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,56 @@
# D-P15 · Screens P15 — Telefonie (ohne Chat-UI)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P15 — Telefonie & Team-Chat (bedient `AK-P15a`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-30 → 2026-07-02 · Gate W3 |
| **Status** | geplant (NEU — schließt P15-Telefonie-Screen-Lücke außerhalb der Chat-UI) |
> **Ergänzt das Bespoke-Ticket `D-CHAT`** (Real-Time-Chat-UI: Chat-Index, Channel-/Thread-Detail, Pinned/Mentions/Suche, Admin-Chat-Übersicht). **Dieses Ticket deckt den Telefonie-Teil von P15**: AirCall-Setup (Telefonie-Panel), Call-Log (Anruf-Liste), Click-to-Call und Anruf-Detail. Die Team-Chat-Screens sind **NICHT** Teil von D-P15 (→ D-CHAT).
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail, A5 Modal, A6 Connection), `D-P5` (Connection-Card-Stil für AirCall-Setup)
- **Bedient (Dev):** `AK-P15a` (Telefonie / AirCall) — der Team-Chat-Teil (`AK-P15b`) wird von `D-CHAT` bedient
- **Parallel/Geschwister:** `D-CHAT` (BESPOKE Chat-UI) — D-P15 liefert den Telefonie-Teil
- **Subframe:** Pflicht je Route (A6 Connection für Setup, A2/A3 für Call-Log/Detail, A5 Modal für Nummer-Auswahl)
## Was wir bauen
Die **Telefonie-Flächen von P15**: das AirCall-Setup (Connect-Card + User-Binding-Liste), die Anruf-Liste mit gematchtem Kontakt, Click-to-Call (inkl. Nummer-Auswahl-Modal + eingehender-Anruf-Notification) und das Anruf-Detail mit Match-Override + Markdown-Notiz.
> 🟡 **v1-Grenze:** **HalloPetra (M105) ist v2** (→ P33) — v1 baut nur den AirCall-Adapter hinter dem `TelephonyProviderInterface`. Whisper-Notiz-Diktat = v2 (Notiz-Editor = Markdown-Tippen in v1).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **AirCall-Setup** [`/settings/integrations/telephony`] | Connect-Card (Status-Ampel connecting/active/error/revoked + Klartext) · **User-Binding-Liste** (AirCall-User ↔ HiveGrid-User mit Email-Auto-Match-Vorschlag + manuelle Korrektur) · „Verbindung testen" · Trennen mit Bestätigung | A6 (Connection) |
| Anruf-Liste + -Detail [`/calls`] | Liste: Nummer, Richtung, Dauer, **gematchter Kontakt** (mit Confidence-Hinweis bei Soft-Match), Notiz-Snippet, verpasst-Marker · Detail: **Match-Override**, Markdown-Notiz-Editor, Aufnahme-Link · Click-to-Call-Button + eingehender-Anruf-Notification | A6 + A2/A3 |
**Eingebettet (kein eigener Screen, aber zu designen):** Click-to-Call-Buttons leben außerdem in Kontakt-/Lead-/Deal-Detail (aus D-CRM/D-P7/D-P8) — Mehrfach-Nummern → Auswahl-Modal; `tel:`-Fallback ohne Connection.
*(Chat-Index/Channel-/Thread-Detail/Pinned/Mentions/Suche/Neuer-Channel/Channel-Settings/Admin-Chat-Übersicht = **D-CHAT**. HalloPetra-Adapter-UI, Whisper-Diktat-Aufnahme → v2.)*
## Features (muss abgedeckt sein)
- [ ] AirCall-Connect (OAuth, Status-Diagnose) als Connection-Card mit Klartext-Status
- [ ] User-Bindings mit Email-Auto-Match-Vorschlag + manuelle Zuordnung + „Verbindung testen"
- [ ] Click-to-Call aus Kontakt-/Lead-/Deal-Detail; Mehrfach-Nummern → Auswahl-Modal; Klartext-Edge-Cases (kein Binding / keine Connection / API-Fehler / ungültige Nummer); `tel:`-Fallback
- [ ] Inbound-Anruf-Notification beim Klingeln; Auto-Match-Anzeige (Hard/Soft mit Confidence), unbekannte Nummer → Auto-Lead-Hinweis
- [ ] Anruf-Liste + -Detail (Richtung/Dauer/verpasst), Markdown-Notiz-Editor nach Anruf, Recording-Player-Link, Match-Override
- [ ] Empty/Loading/Permission-Denied/Offline-States (Klartext)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Connection-Card (Status-Ampel connecting/active/error/revoked + Klartext, „Verbindung testen", Trennen-Bestätigung); **User-Binding-Mapping-Liste** mit Auto-Match-Vorschlag + manueller Korrektur; **Click-to-Call-Button** + Nummer-Auswahl-Modal (Mehrfach-Nummern); eingehender-Anruf-Notification; Anruf-Liste (Nummer/Richtung/Dauer/Match-Confidence/verpasst-Marker/Notiz-Snippet); **Match-Override-Picker**; Markdown-Notiz-Editor; Recording-Player-Link; Klartext-Edge-Case-Hinweise (kein Binding / keine Connection / API-Fehler / ungültige Nummer / `tel:`-Fallback); Empty-/Loading-/Permission-Denied-/Offline-States.
## Quellen (granular)
- `designer-briefs/P15-telefonie-chat.md` (Telefonie-Teil; Chat-Teil → D-CHAT)
- `ENTITY-MODEL.md` → **Domäne 8: Kommunikation** (TelephonyConnection/UserBinding/CallSession/WebhookEvent)
- `ROADMAP.md` → Phase 15 · `REQUIREMENTS.md` → Modul 12 · `PHASE-SOURCES.md` → P15
- `_bmad-output/specs/M12-telefonie.md`
- Geschwister-Ticket (Chat): `D-CHAT` · Dev-Pendant: `ticket-docs/AK-P15a.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,62 @@
# 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 PandaDoc)
- **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 **PandaDoc**. **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) → Provider (PandaDoc, Default) → Senden · Status-Tracking je Unterzeichner (entwurf/gesendet/angesehen/signiert/abgelehnt) + Erinnerung + Widerruf · Original- + Signed-PDF-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 → PandaDoc → Senden) + Status-Tracking je Unterzeichner + Erinnerung/Widerruf + Original-/Signed-PDF-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; **Status-Tracker je Unterzeichner** (entwurf/gesendet/angesehen/signiert/abgelehnt); PDF-Download-Buttons (Original/Signed); 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 · `PHASE-SOURCES.md` → P16
- `_bmad-output/specs/M25-calendar-sync.md`, `M06-booking.md`, `M05-form-builder.md`, `M07-angebot-signatur.md`
- 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:
@@ -0,0 +1,58 @@
# D-P2 · Screens P2 — Identität & Mandantentrennung
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P2 — Identität & Mandantentrennung (bedient `R-P2a`/`R-P2b`) |
| **Cycle/Fenster** | W1 · fällig 2026-06-21 (mit D0-Baseline) |
| **Status** | geplant (NEU — schließt P2-Screen-Lücke) |
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2–A7) — die Auth-Screens komponieren aus den D0-Archetypen
- **Bedient (Dev):** `R-P2a` (Auth/Sessions/TOTP), `R-P2b` (RLS/RBAC/Lifecycle)
- **Läuft parallel zu:** Davids `D-D0b` (Archetypen) — gleiche W1; baut direkt darauf auf
- **Subframe:** Pflicht je Route (Archetypen A4 Form, A5 Modal/Wizard, A6 Settings, A2 Liste)
## Was wir bauen
Die **11 Identitäts-/Auth-Screens**: Self-Service-Signup, sicheres Login (E-Mail+PW+2FA), Session-/Geräte-Verwaltung, Profil, sowie die Admin-Flächen für Rollen, Gruppen, Mitarbeiter und Konto-Löschung. Erster Eindruck + DSGVO-kritische Flows.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Signup [`/signup`] | E-Mail, PW (Stärke + Breach-Hinweis), Firmenname, Name, Telefon, USt-ID, AGB/DSGVO/AVV → Tenant + Auto-SHK-Seed | A4 |
| Login [`/login`] | E-Mail, PW, mCaptcha ab 3. Fehlversuch, Magic-Link-Alternative | A4 |
| 2FA-Eingabe | 6-stelliger TOTP-Code, Trust-Device | A4/A5 |
| Passwort vergessen [`/forgot-password`] | E-Mail → Magic-Link | A4 |
| Tenant-Auswahl | Tenant-Liste (zuletzt genutzt, Suche) + „ohne Tenant"-Screen (Workspace anlegen / auf Einladung warten) | A2 |
| Session-Verwaltung [`/settings/security`] | Aktive Sessions (Gerät/Browser/IP/Standort) + Abmelden je Session + „überall abmelden" + Trust-Device-Revoke | A2/A6 |
| Profil [`/settings/profile`] | Name, Avatar, Telefon, PW ändern, 2FA (QR), Hell/Dunkel (Sprache fest DE — kein Wechsler v1) | A6 |
| Rollen-Editor [`/admin/roles`] | Rollen-Liste + Editor (Permission-Bundles + Advanced-Einzelrechte), 6 SHK-Rollen geseedet, Löschen mit Reassign | A2+A6 |
| Gruppen [`/admin/groups`] | Gruppen-Liste, Bulk-Add/Remove | A2 |
| Mitarbeiter [`/admin/users`] | User-Liste + Einladungs-Modal + **Deaktivieren mit Reassign-Workflow** | A2+A5 |
| Konto löschen [`/settings/account`] | Multi-Step: Erklärung → Export → PW+2FA → Countdown · Block bei einzigem Admin | A5 |
*(API-Keys → v2. Audit/Notif/Files/Tasks-Oberflächen → P3/P4. Plattform-Admin-Welt → P19.)*
## Features (muss abgedeckt sein)
- [ ] Self-Service-Signup (Auto-Slug, Reserved-Words geblockt, Auto-SHK-Seed)
- [ ] Login E-Mail+PW (NIST/HIBP-Breach-Block) + mCaptcha ab 3. Fehlversuch + Magic-Link
- [ ] TOTP-2FA (QR-Setup + Trust-Device)
- [ ] Session-Verwaltung (Geräte-Liste, Revoke einzeln / überall)
- [ ] Rollen-/Gruppen-Verwaltung (Bundles + Advanced), 6 SHK-Rollen, Reassign beim Deaktivieren
- [ ] Konto-Löschung (DSGVO, mehrstufig, Einzig-Admin-Edge-Case)
- [ ] „keine-Berechtigung"-Zustände der UI (RLS prägt die Empty/Denied-States)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Auth-Formulare (E-Mail/PW, Stärke-Anzeige, Breach-Klartext-Block, AGB/DSGVO/AVV-Checkboxen); mCaptcha-Slot; TOTP-Eingabe + QR; Magic-Link-Trigger; Tenant-Auswahl-Liste + „ohne Tenant"-Screen; Session-Tabelle (Gerät/Browser/IP/Standort) + Revoke-Buttons; Profil-Settings (Avatar-Upload, Inline-Edit, PW-Block, 2FA-Block, Theme-Toggle); Rollen-Editor (Bundle-Auswahl + ausklappbare Einzelrechte); Rollen-Lösch-Dialog (Ersatz-Rollen-Picker); Gruppen-Liste; User-Liste (Status-/2FA-Badges); Einladungs-Modal; Deaktivierungs-Panel (offene Verknüpfungen + Bulk-Übertragung); Konto-Lösch-Wizard (Export-Schritt, PW+2FA-Gate, Countdown); Klartext-Fehler/Empty/Loading/Permission-Denied-States.
## Quellen (granular)
- `designer-briefs/P02-identitaet-mandantentrennung.md` (vollständiger Brief — diese Doc ist sein Ticket-Destillat)
- `ENTITY-MODEL.md` → **Domäne 1: Identität & Mandanten** (Tenant/User/TenantUser/TenantRole/Permission/Group/Session)
- `ROADMAP.md` → Phase 2 · `REQUIREMENTS.md` → Modul 27 · `_bmad-output/specs/M27-auth-multi-tenancy.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,66 @@
# D-P20 · Screens P20 — Billing, Onboarding & Branding
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der **AI-Credits-Screen + AI-Token-Quota entfallen** (kein LLM-Gateway in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]). Die Verbrauchs-Übersicht bleibt für Automation-Läufe + Speicher. Alle AI-Credits/AI-Token-Stellen unten sind durchgestrichen.
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P20 — Billing, Onboarding & Branding (bedient `AK-P20`) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-08 · Gate W4 |
| **Status** | geplant (NEU — ex-Teil von D-REST, jetzt eigenes P20-Ticket) |
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell + A1-Status-Banner-System), `D-D0b` (Archetypen A2 Liste, A6 Settings, KPI/Charts, A5 Modal)
- **Bedient (Dev):** `AK-P20` (Billing Stripe Abo-Baukasten + Onboarding + Branding)
- **Compose-Paket:** Status-Banner-System integriert in die A1-Shell (D0); Hell/Dunkel-Toggle lebt im Profil/User-Menü (P2/D-P2); ~~AI-Credits-Detail teilt Charts-Bausteine mit D-P13~~ → **AI-Credits-Detail entfällt ([[AD-26]]; D-P13 gelöscht)**
- **Subframe:** Pflicht je Route (A6 Settings, KPI/Charts, A5 Modal, Banner in A1-Shell)
## Was wir bauen
Die **Billing-/Onboarding-/Branding-Flächen (alle v1)**: read-only Abo-Übersicht (Abo-Baukasten), Verbrauchs-Übersicht ~~/AI-Credits-Übersicht~~ (AI-Credits entfällt — [[AD-26]]), Stripe-Customer-Portal-Embed, Demo-Daten-Verwaltung, Erste-Schritte-Checkliste, das Tenant-Status-Banner-System und den Hell/Dunkel-Toggle.
> 🟡 **v1-Schnitte (verbindlich):**
> - **Billing = Abo-Baukasten (M154-Recut):** Basis-Preis pro Nutzer + Feature-Module als daten-getriebene Positionen. **KEINE Seat-Typen.** In-App **keine** Pricing-/Upgrade-/Plan-Wechsel-UI (Apple-Compliance LP-8) — nur Read-Only-Übersicht + externer Verweis (`hivegrid.de`/Account-Manager). Pause/Kündigen erlaubt.
> - **Onboarding:** v1 = Auto-SHK-Provisionierung beim Signup (ohne Wizard). **Kein** mehrstufiger Setup-Wizard, **kein** KI-Walkthrough (→ v2). v1-Screens: Demo-Daten-Verwaltung + Erste-Schritte-Checkliste.
> - **Branding:** v1 = nur **Hell/Dunkel-Toggle** (bewusst 2 Optionen, **kein** System-Modus). Logo/Farben/White-Label → v2; keine `/admin/branding`-Route v1.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Abo-Übersicht [`/admin/subscription`] | Basis-Plan + **gebuchte Feature-Module als Positionsliste mit Preisen** · Status/Trial-Countdown · **KEIN Upgrade-Button** (Hinweis-Box „Plan-Wechsel über Account-Manager / hivegrid.de", extern) · Pausieren (Frozen) + Kündigen-Button | A6 + KPI |
| Verbrauchs-Übersicht [`/admin/usage`] | Quota-Balken je Metrik: Automation-Läufe, ~~AI-Tokens~~ (entfällt [[AD-26]]), Speicher · aktueller Verbrauch vs. inklusiv · Klartext bei Limit-Erreichen | KPI + Charts |
| ~~AI-Credits-Detail [`/admin/usage/ai-credits`]~~ → **entfällt ([[AD-26]])** | ~~Saldo, Verbrauch je Use-Case (Donut), Verlauf, 80%-Warnbanner, Hochrechnung, Aufgebraucht-Klartext (Verweis extern)~~ | ~~KPI + Charts~~ |
| Rechnungen/Zahlung [`/admin/billing`] | **Stripe-Customer-Portal-Embed** (Rechnungs-History/PDF, Zahlungsmethode, Steuer-/USt-Daten) | A6 |
| 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 (Multi-Step-Confirm) · „Demo ausblenden"-Filter erscheint in allen Listen *(kein Wizard, kein KI-Walkthrough — v2)* | A6 |
| Erste-Schritte-Checkliste [`/onboarding/checklist`] | Items mit Status-Häkchen (auto-erkannt), Klartext + Beschreibung, CTA-Link je Item, manuell abhakbar, dauerhaft ausblendbar, Glückwunsch bei 100% (KWP-Item ausgeblendet — v2) · auch als Dashboard-Widget (P11) | A2 |
| Status-Banner-System (Shell) | Tenant-Status-Banner: Trial-Ende-3-Tage / `past_due` (Zahlung fehlgeschlagen + „Zahlungsmethode aktualisieren") / `frozen` (pausiert + „Reaktivieren") / `deletion_pending` — je eigener Klartext + Action-Button · Read-Only-Toast bei blockiertem Schreib-Button | in A1-Shell (D0) |
| Hell/Dunkel-Toggle [im Profil / User-Menü] | Zwei Optionen Hell / Dunkel, sofortige Anwendung ohne Reload, flash-frei (SSR-Cookie) *(kein System-Modus v1)* | A6 (Teil von Profil-Settings P2) |
*(Signup-Formular → P2/D-P2. Kein Onboarding-Setup-Wizard v1. Stripe-Checkout läuft extern über Marketing-Site.)*
## Features (muss abgedeckt sein)
- [ ] Abo-Übersicht read-only (Abo-Baukasten: Basis + Feature-Module als Positionen, **keine Seat-Typen**); **kein** In-App-Upgrade/Plan-Wechsel (LP-8) — externer Verweis; Pause/Kündigen erlaubt
- [ ] Verbrauchs-Übersicht (Quota-Balken Automation-Läufe/~~AI-Tokens~~ (entfällt [[AD-26]])/Speicher, Klartext bei Limit)
- [ ] ~~AI-Credits-Detail (Saldo, Donut je Use-Case, Verlauf, 80%-Warnbanner, Hochrechnung)~~ → **entfällt ([[AD-26]])**
- [ ] Stripe-Customer-Portal-Embed (Rechnungs-History/PDF, Zahlungsmethode, Steuer-/USt-Daten)
- [ ] Demo-Daten-Verwaltung (Anlege-Knopf mit Klartext-Inhaltsliste, Zähler + Lösch-Funktion, „Demo ausblenden"-Filter)
- [ ] Erste-Schritte-Checkliste (auto-erkannter Status, CTA-Links, manuell abhakbar/ausblendbar, Dashboard-Widget)
- [ ] Status-Banner-System (trial/past_due/frozen/deletion_pending je Klartext + Action) + Read-Only-Toast
- [ ] Hell/Dunkel-Toggle (2 Optionen, flash-frei, kein System-Modus)
- [ ] Empty/Loading/Fehler/Permission-Denied-States (Klartext + Lösungs-Knopf)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Plan-Positionsliste (Basis + Feature-Module mit Preisen, read-only); Trial-Countdown-Badge; KPI-/Quota-Balken (Verbrauch vs. inklusiv); ~~Donut-Chart (AI-Verbrauch je Use-Case)~~ (entfällt [[AD-26]]); 80%-Warnbanner; externer Verweis-Box („Plan-Wechsel über hivegrid.de", neuer Tab); Pause-Button + Kündigen-Button mit Bestätigungs-Modal; **Stripe-Customer-Portal-Embed** (iFrame/Redirect); Demo-Daten-Anlege-Knopf mit Klartext-Inhaltsliste; Demo-Zähler + Lösch-Button mit Multi-Step-Confirm; „Demo ausblenden"-Filter-Toggle; Checklisten-Items mit Status-Icon + CTA-Link + manuell-abhaken + ausblenden; **Status-Banner-Stack** (trial/past_due/frozen/deletion_pending) mit Action-Button; Read-Only-Toast bei blockiertem Schreib-Button; **Hell/Dunkel-Toggle** (2 Optionen); Empty-/Loading-/Fehler-/Permission-Denied-States.
## Quellen (granular)
- `designer-briefs/P20-billing-onboarding-branding.md` (vollständiger Brief — alle v1-Screens)
- `ENTITY-MODEL.md` → **Domäne 12** (Billing/Abo-Baukasten) + **Domäne 13** (Onboarding, Branding)
- `ROADMAP.md` → Phase 20 · `REQUIREMENTS.md` → Modul 28/29/31 · `PHASE-SOURCES.md` → P20
- `_bmad-output/specs/M28-subscriptions-billing.md` (⚠ M154-Recut — keine Seat-Typen), `M29-onboarding.md` (Wizard-UI → v2), `M31-branding.md`
- Legacy-Referenz: `archive/hivegrid-cloud/app/config/pricing-plans.ts` · Dev-Pendant: `ticket-docs/AK-P20.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,64 @@
# D-P21 · Screens P21 — DSGVO & Launch-Reife
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P21 — DSGVO & Launch-Reife (bedient `AK-P21`) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-09 · Gate W4 (letzte v1-Phase) |
| **Status** | geplant (NEU — ex-Teil von D-REST, jetzt eigenes P21-Ticket) |
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A5 Modal/Wizard, A6 Settings, A7 Zustände)
- **Bedient (Dev):** `AK-P21` (DSGVO Export + Lösch-Workflow + Feedback-Widget)
- **Letzte v1-Phase:** macht den Big-Bang-Launch (AD-19) auslösbar; Feedback-Widget speist die Admin-Support-Inbox (P19); alle neuen Screens auch mobil tauglich (PWA-only, AD-17)
- **Subframe:** Pflicht je Route (A6 Settings, A5 Lösch-Wizard, A2 Listen, A7 Zustände, A5-klein Feedback)
## Was wir bauen
Die **DSGVO-Lebenszyklus- und Launch-Reife-Screens (alle v1)**: Privacy-Hub, Tenant-/User-Daten-Export, Tenant-/Account-Lösch-Workflow (Crypto-Shredding, Grace-Period, Slug-Confirm-Phrase), Subprozessoren-/AVV-Sichtbarkeit, das In-App-Feedback-Widget und die Minimal-FAQ-Seite.
> 🟡 **v1-Schnitte (verbindlich):**
> - **DSGVO-Auskunft = manuelles Playbook v1** (Suche → Kontakt-Detail-Activity-Stream → CSV-Export → Anwalts-Vorlage → Frist-Task +25 Tage). **KEIN** automatisches Auskunfts-/Voll-Export-Tooling pro betroffener Person (→ v2). **Keinen** Auskunfts-Wizard designen — das Playbook nutzt bestehende Screens (Cmd+K, Kontakt-Detail, CSV).
> - **v1 baut:** DSGVO-ZIP-Export (User-Self + Tenant-Full, 72h-signed-URL), Tenant-Lösch-Workflow (Crypto-Shredding, 30-Tage-Grace, Slug-Confirm-Phrase), Feedback-Widget, Minimal-FAQ. AVV/Subprozessoren-Anzeige im Privacy-Hub.
> - **PWA-only (AD-17):** alle neuen Screens mobil tauglich; **kein** App-Store-/Native-Screen (PWA-Installierbarkeit/Web-Push → v2).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Privacy-Hub [`/admin/privacy`] | Übersicht: Export, Löschung, Subprozessoren, AVV, Privacy-Manifest-Link · Einstieg in die Sub-Bereiche | A6 + KPI |
| Tenant-Daten-Export [`/admin/privacy/export`, `/new`, `/:jobId`] | Job-Liste mit Status/Progress/Download (72h-Link) · Anstoßen mit Klartext (was, geschätzte Größe/Dauer, 7-Tage-Window) · Job-Status mit Progress | A2 + A5 |
| **Tenant-Löschung** [`/admin/privacy/deletion`, `/:requestId`] | Multi-Step: Erklärung (30-Tage-Grace, Read-Only, Hard-Delete) → Export-Angebot → Stripe-Hinweis (Pro-rata) → Passwort + 2FA → **Slug als Confirm-Phrase** · Grace-Countdown mit Abbruch-Button | A5 (Wizard) |
| Subprozessoren [`/admin/privacy/subprocessors`] | Tabelle: Name, Land, EU/EEA-Marker, Zweck, Datenkategorien, DPA-Link, „aktiv seit" · Filter (EU/alle, Kategorie) · Export CSV/PDF | A2 |
| AVV [`/admin/privacy/avv`] | Aktuelle Version als PDF-Download + Akzeptanz-History (Version, Datum, Signer) · Re-Akzeptanz-Modal bei Update (Klartext-Änderungen) | A2 + A5 |
| User-Daten-Export [`/settings/account/data-export`, `/:jobId`] | Klartext was exportiert wird, Start-Button, Rate-Limit-Hinweis, Job-Status mit Download (signed-URL) | A6 |
| Account-Löschung [`/settings/account/delete`] | Multi-Step: Erklärung → optional Daten-Export-Angebot → Passwort + 2FA → Countdown-Bestätigung (24h-Reverse-Window) · *(Detail-Logik M27 D.3)* | A5 (Wizard) |
| **Feedback-Widget** [global, klein] | Schwebender Button → Mini-Form (Kategorie Bug/Feature/Frage, Text, Screenshot-Häkchen, Rate-Limit) → landet in Admin-Support-Inbox (P19) · Erfolgs-/Fehler-Zustand | A5-klein |
| Minimal-FAQ [`/help` o. ä.] | Statische FAQ-Seite mit gruppierten Fragen/Antworten (Markdown), Suchfeld optional · kein Help-Center-Ausbau (→ v2) | A6 / statisch |
*(Kein DSGVO-Auskunfts-Wizard v1 — Playbook nutzt Cmd+K-Suche + Kontakt-Detail-Activity-Stream + CSV-Export + Task aus P6/P4/P11. Admin-Support-Inbox + Subprozessor-/AVV-Verwaltung → P19. Privacy-Manifest-Inhalt = Marketing-Site.)*
## Features (muss abgedeckt sein)
- [ ] DSGVO-ZIP-Export (User-Self **und** Tenant-Full) mit Progress + 72h-signed-URL + Rate-Limit-Hinweis
- [ ] Tenant-Löschung (Multi-Step-Wizard, 30-Tage-Grace + Read-Only + Abbruch, **Slug als Confirm-Phrase**, Passwort + 2FA, Stripe-Pro-rata-Hinweis)
- [ ] Account-Löschung (Multi-Step, optionales Export-Angebot, Passwort + 2FA, 24h-Reverse-Countdown)
- [ ] Subprozessoren-Liste (EU/Drittland-Marker, DPA-Link, CSV/PDF-Export) + AVV-Download + Akzeptanz-History + Re-Akzeptanz-Flow
- [ ] In-App-Feedback-Widget (Bug/Feature/Frage, Screenshot-Häkchen, Rate-Limit) → Admin-Support-Inbox (P19)
- [ ] Minimal-FAQ-Seite (statisch, gruppiert, optionales Suchfeld)
- [ ] Alle neuen Screens mobil tauglich (PWA-only, AD-17)
- [ ] Empty/Loading/Fehler/Permission-Denied/Offline-States (Klartext + Lösungs-Knopf)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Export-Job-Liste mit Progress-Balken + Status-Badge + Download-Button (signed-URL, Ablauf-Hinweis); Export-Anstoß-Dialog mit Klartext-Größen-/Dauer-Schätzung; **Multi-Step-Lösch-Wizard** mit Progress; **Slug-Confirm-Phrase-Eingabe** (Tippen statt Knopf); Grace-Countdown-Banner mit Abbruch-Button; Passwort-+2FA-Bestätigungsschritt; **Subprozessor-Tabelle** mit EU/Drittland-Marker + DPA-Link + CSV/PDF-Export; AVV-PDF-Download + Akzeptanz-History-Liste + Re-Akzeptanz-Modal mit Änderungs-Klartext; Drittland-Warn-Badge; **schwebender Feedback-Button** + Mini-Form (Kategorie-Select, Textarea, Screenshot-Häkchen) mit Rate-Limit-Hinweis; **FAQ-Akkordeon** (gruppierte Fragen/Antworten, Markdown) + optionales Suchfeld; Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States; mobile-first-Varianten aller Screens.
## Quellen (granular)
- `designer-briefs/P21-dsgvo-launch.md` (vollständiger Brief — alle v1-Screens)
- `ENTITY-MODEL.md` → **Domäne 13** (Onboarding/Branding/DSGVO)
- `ROADMAP.md` → Phase 21 · `REQUIREMENTS.md` → Modul 35 (+ M27 D.3 User-Lösch-Verweis) · `PHASE-SOURCES.md` → P21
- `_bmad-output/specs/M35-dsgvo-export.md`
- Dev-Pendant: `ticket-docs/AK-P21.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,57 @@
# D-P3 · Screens P3 — Querschnitts-Oberflächen (Audit / Notif / Sprache DE)
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der Audit-Actor-Kind **„KI" wird zu „MCP/Agent" umgedeutet** — er kennzeichnet künftig externe KI-Clients, die über den MCP-Server ([[VR-MCP]]) auf HiveGrid zugreifen (kein eigenes LLM in v1). Marker-Liste = User / Automation / **MCP/Agent** / Admin.
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P3 — Querschnitts-Oberflächen (bedient `AK-P3`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-21 · Gate W2 (Noah-Demo #1) |
| **Status** | geplant (NEU — schließt P3-Screen-Lücke) |
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell + Topbar inkl. Notification-Bell-Slot), `D-D0b` (Archetypen A2 Liste + Drawer, A6 Settings) — die P3-Screens komponieren aus den D0-Archetypen
- **Bedient (Dev):** `AK-P3` (Audit-Viewer/Export, Notification-Center/Settings, Sprach-Settings DE)
- **Läuft parallel zu:** Akeshans `AK-P3` (gleiches Fenster); Service-Kerne (Hash-Kette, `notify()`, i18n-Engine) liegen schon in P1 — P3 liefert nur die Bedien-Oberflächen
- **Subframe:** Pflicht je Route (A2 Liste + Diff-Drawer, A6 Settings, Notification-Drawer aus Topbar)
## Was wir bauen
Die **Bedien-Oberflächen der in P1 gebauten Plattformdienste**: Audit-Viewer (gefilterter, permission-gegateter Trail mit deutschem Summary-Text, Actor-Kind-Marker, Diff-Detail-Drawer, NDJSON/CSV-Export ins Hetzner-Object-Storage mit Zweck-Pflichtfeld + Export-Job-Liste), Notification-Center (In-App via SSE, Read-Status, Deeplink, Tabs Alle/Ungelesen, Bulk-Clear), Notification-Settings (Event-Typen je Modul, In-App/Email-Toggle, Master „alle Emails aus") sowie der DE-Sprach-Hinweis (v1 DE-only).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Audit-Viewer [`/admin/audit`] | Zeit, Actor (+Kind-Marker User/Automation/~~KI~~ **MCP/Agent** ([[AD-26]])/Admin visuell unterscheidbar), Aktion, Subjekt, **deutscher Summary-Text** · Filter (Zeitraum Default 30 T / max 24 Mon ohne Export, Actor, Kategorie, Subjekt-Typ) · Quick-Filter (Klick auf Actor/Subject/Action) · **Detail-Drawer mit Feld-für-Feld-Diff** (Vorher/Nachher, sensible Diffs nur „Wert geändert") + „Verlauf dieses Objekts"/„Ähnliche Einträge" · Export-Button (CSV/NDJSON, Zweck-Pflichtfeld) | A2 + Drawer |
| Audit-Export-Jobs [`/admin/audit/exports` + `/new` + `/:id`] | Export-Job-Liste · Anlage (Filter-Kriterien wie Listen-View, Format, Zweck-Pflichtfeld) · Job-Status + Download (signed-URL) | A2 |
| Notification-Center [Topbar-Drawer + `/notifications`] | Einträge: Titel, Body, Actor, Zeit, Read-Status, Prioritäts-Marker · Tabs Alle/Ungelesen · Mark-read/unread, Klick→Deeplink · Bulk-Clear · Klartext bei pausierten Emails (Bounce: „Emails an dich kommen aktuell nicht an") | A2 + Drawer |
| Notification-Settings [`/settings/notifications`] | Event-Typen nach Modul gruppiert, je **In-App/Email-Toggle** + Priority-Selektor · Master-Toggle „alle Emails aus" (Klartext: betrifft auch zukünftige Event-Typen) | A6 |
**Eingebettete Oberflächen (kein eigener Screen, aber zu designen):** Per-Subject-Audit-Drawer (wiederverwendbar in jeder Detail-View, filtert auf `subject_type+subject_id`, `audit.read`) · Per-User-Audit-Drawer in `/admin/users/:id` · DE-Sprach-Hinweis „fest DE" im Profil-Screen (P2/D-P2).
*(Quiet-Hours / Bündelung / Push-Devices-Liste / Retention-Editor / Legal-Hold / Saved-Views / Sprach-Wechsler → v2.)*
## Features (muss abgedeckt sein)
- [ ] Audit-Viewer permission-gegated (`audit.read`), server-side-Filter zwingend, deutscher Summary-Text, Actor-Kind-Marker
- [ ] Diff-Detail-Drawer (Feld-für-Feld Vorher/Nachher; Maskierung bei sensiblen Werten) + „Verlauf dieses Objekts"/„Ähnliche Einträge"
- [ ] Compliance-Export (NDJSON/CSV) mit Zweck-Pflichtfeld + Export-Job-Status/Download; fixe Default-Retention (kein Editor v1)
- [ ] Notification-Center (SSE, Read-Status, Deeplink, Tabs Alle/Ungelesen, Bulk-Clear, Bounce-Klartext)
- [ ] Notification-Präferenzen pro User (Event-Typen je Modul, In-App/Email-Toggle, Priority-Threshold, Master „alle Emails aus")
- [ ] DE-Sprach-Hinweis (v1 fest DE — kein Wechsler); alle Oberflächen-Strings durch `t()`
- [ ] Empty/Loading/Permission-Denied/Fehler-States (Klartext, z. B. leerer Center „Keine Benachrichtigungen …")
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Audit-Daten-Tabelle (server-paginiert) mit Actor-Kind-Marker (User/Automation/~~KI~~ **MCP/Agent** ([[AD-26]])/Admin visuell unterscheidbar), deutschem Summary-Text, Subjekt-Verlinkung; Filter-Bar (Datum-Range-Selektor mit Presets, Actor-/Kategorie-/Subjekt-Typ-Filter) mit Quick-Filter-Klick auf Tabellenwerte; Detail-Drawer mit Feld-für-Feld-Diff-Visualisierung (Hinzufügung/Löschung/Änderung farblich, JSON-Strukturdiff, Maskierungs-Hinweis) + „Verlauf dieses Objekts"/„Ähnliche Einträge"-Aktionen; Export-Button → Export-Job-Anlage-Dialog (Format CSV/NDJSON + Zweck-Pflichtfeld); Export-Job-Liste mit Status-Badge + Download-Link; wiederverwendbarer Per-Subject-/Per-User-Audit-Drawer; Notification-Liste/-Drawer (Titel/Body/Actor/Zeit/Read-Status/Prioritäts-Marker, Tabs Alle/Ungelesen, Mark-read/unread, Deeplink-Klick, Bulk-Clear, Bounce-Klartext); Notification-Bell-Anbindung (Badge liegt in D0-Topbar); Notification-Präferenzen-Editor (Event-Typen je Modul gruppiert, je Zeile In-App-/Email-Toggle + Priority-Selektor, Master-„alle-Emails-aus"-Toggle mit Klartext); DE-Sprach-Hinweis-Element; Empty-/Loading-/Permission-Denied-/Fehler-States (Klartext).
## Quellen (granular)
- `designer-briefs/P03-querschnitts-oberflaechen.md` (vollständiger Brief — diese Doc ist sein Ticket-Destillat)
- `ENTITY-MODEL.md` → **Domäne 2: Querschnitt** (AuditEntry, Notification, NotificationPreference, NotificationDevice; i18n = Felder, keine Tabelle)
- `ROADMAP.md` → Phase 3 · `REQUIREMENTS.md` → Modul 21/22/30 (`REQ-audit-retention-export`, `-audit-permissions`, `-notification-versand-pipeline`, `-i18n-outbound`) · `PHASE-SOURCES.md` → Phase 3
- `_bmad-output/specs/M21-audit-log.md`, `M22-notifications.md`, `M30-i18n.md` (Oberflächen-Teile; Service-Kerne liegen in P1)
- Dev-Pendant: `ticket-docs/AK-P3.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,58 @@
# D-P4 · Screens P4 — Files & Tasks
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P4 — Files & Tasks (bedient `AK-P4a`/`AK-P4b`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-21 (Dev-Fenster 2026-06-18 → 19) · Gate W2 |
| **Status** | geplant (NEU — schließt P4-Screen-Lücke) |
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail, A4 Form + Dropzone, A5 Modal, Zustands-Kit)
- **Bedient (Dev):** `AK-P4a` (Files — chunked Upload, HEIC→JPG, ClamAV), `AK-P4b` (Tasks + polymorphe EntityLink-Tabelle)
- **Liefert wiederverwendbare Komponenten:** Task-Liste + Files-Browser-Sub-Sektion werden ab P12/P14/P16 und in **allen** Entity-Detail-Views (Kontakt/Firma/Lead/Projekt) eingebettet — **einmal bauen, überall einbetten**
- **Subframe:** Pflicht je Route (A2 Liste, A3 Detail, A4 Form/Dropzone, A5 Modal)
## Was wir bauen
Die **nutzerseitigen Plattform-Primitive**: Files (chunked Upload mit Multi-Datei-Queue, Preview inkl. **HEIC→JPG Pflicht**, Anhängen an jede Entität über `FileEntityLink`, Tags, Archiv, Bulk-ZIP) und Tasks (leichtgewichtiges querliegendes Aufgaben-Modul mit Status/Priorität/Fälligkeit, Entitäts-Verknüpfung, Person-/Gruppen-Zuweisung, Watcher, Quelle-Marker). Die **Task-Liste ist als wiederverwendbare Komponente** zu bauen.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| 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) · Inline-Schnell-Vorschau (Hover/Single-Klick) · Archiviert-Toggle (keine Versions-Spalte v1) | A2 |
| Upload-View + Datei-Dropzone [`/files/upload`] | Drag&Drop, Multi-Datei-Queue mit Per-Datei-Fortschritt, Fehler+Retry · **HEIC-Hinweis „wird zu JPG konvertiert"** | A4 |
| File-Detail [`/files/:id`] | Stammdaten · **Vorschau (Bild mit Zoom / PDF; HEIC→JPG)** mit Fallback-Klartext + Download bei `not_supported` · Tags · Notizen · verknüpfte Entitäten mit Rolle · Activity (Upload/Verknüpfungs-Änderungen/Downloads) · Aktionen Download/Ersetzen/Archiv/„Vorschau neu generieren" bei `failed` (kein Versionsverlauf v1) | A3 |
| Task-Liste [`/tasks`] | Titel, Prioritäts-Marker, Fälligkeit (überfällig rot, relativ ≤7 T), verknüpfte Entität, Assignee (Person/Gruppe), Status, Quelle-Hinweis · Presets Meine/Erstellt/Alle (Alle nur mit `tasks.read_all`) · Such-Funktion · Filter (Status/Priorität/Deadline-Range/Verknüpfungs-Typ/Quelle) · Archiviert-Toggle · Bulk · Inline-Quick-Actions (done/Priorität/Deadline) | A2 — **wiederverwendbare Komponente** |
| Task-Detail + Anlage-Modal [`/tasks/:id`, `/tasks/new`] | Titel, Beschreibung (Markdown), Status/Priorität/Fälligkeit inline, Assignee-Picker (Person↔Gruppe), Verknüpfungs-Picker (Auto-Complete Contact/Company/Lead/Deal/Project), Watcher, Quelle (manuell/Chat/Form/Automation mit Link), Activity-Stream, Aktionen (Erledigen/Wieder-öffnen/Duplizieren/Löschen) · Klartext-Banner (überfällig / Assignee deaktiviert / „wird in 30 Tagen archiviert") | A3 + A5 |
**Eingebettet (kein eigener Screen, aber zu designen):** Files-Browser vorgefiltert als Sub-Sektion in Entity-Detail-Views · Tasks-Tab/Section mit verknüpften Tasks + „Aufgabe anlegen" (Pre-Fill) in jeder Entity-Detail-View.
*(FileVersion/Versions-Verlauf, Office-/Video-Previews, Resume-Upload, OCR → v2. HEIC→JPG bleibt v1-Pflicht.)*
## Features (muss abgedeckt sein)
- [ ] Multi-Datei-Upload-Queue mit Per-Datei-Progress + Retry (chunked TUS, RLS auf Storage-Pfaden)
- [ ] Preview PDF→PNG, Bild→WebP, **HEIC→JPG (Pflicht)** mit Status (pending/generating/ready/failed/not_supported) + Klartext-Fallback
- [ ] Datei-Anhängen über `FileEntityLink` (polymorph) + Rollen-Label; Tags; Archiv-Flag; Bulk-ZIP
- [ ] Files-Browser server-side-Filter (Entität/MIME-Gruppe/Tags/Verantwortlicher), Tabelle/Grid-Umschalter, Inline-Schnell-Vorschau
- [ ] Tasks (Status/Priorität/Fälligkeit, Entitäts-Verknüpfung, Person-ODER-Gruppen-Zuweisung [genau eines], Watcher)
- [ ] Task-Quellen-Marker: manuell / Chat / Form-Submission / Automation-Action — je mit Link
- [ ] Reminder-Banner-UX (24h vor / bei / 24h nach Deadline) + Auto-Archivierungs-Hinweis (30 Tage)
- [ ] Permission-aware Action-Buttons (`tasks.*`); fremde Tasks 404 statt 403
- [ ] Empty/Loading/Permission-Denied/Fehler-States (Klartext, z. B. „Keine offenen Aufgaben — schöne Sache")
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Daten-Tabelle mit Tabelle/Grid-Umschalter, Vorschau-Thumbnail, sortierbaren Spalten, Filter-Bar (Entität/MIME-Gruppe/Tags/Verantwortlicher), Bulk-Action-Bar (Tag/Verknüpfen/Archiv/ZIP), Archiviert-Toggle, Inline-Schnell-Vorschau; Datei-Dropzone mit Drag&Drop + Multi-Datei-Upload-Queue (Per-Datei-Fortschrittsbalken, Fehler-Zustand + Retry, HEIC→JPG-Klartext-Hinweis); Vorschau-Komponente (Bild-Viewer mit Zoom, PDF-Viewer) mit `not_supported`-Fallback (Klartext + Download) + „Vorschau neu generieren" bei `failed`; File-Detail-Panel (Stammdaten, Tags-Zeile, Notiz-Feld, verknüpfte-Entitäten-Liste mit Rollen-Label, Activity-Timeline, Aktions-Buttons); Task-Liste (wiederverwendbar/embeddable) mit Prioritäts-Marker, Fälligkeits-Anzeige (relativ/absolut, überfällig rot), Quelle-Marker, Scope-Preset-Switcher (Meine/Erstellt/Alle), Such-Feld, Filter (Status/Priorität/Deadline-Range-Presets/Verknüpfungs-Typ/Quelle), Bulk-Auswahl + Bulk-Actions, Inline-Quick-Actions (done/Priorität/Deadline); Task-Detail/-Anlage (Markdown-Editor, Status-Wechsler, Date-Picker, Assignee-Picker Person↔Gruppe umschaltbar, Verknüpfungs-Auto-Complete-Picker, Watcher-Verwaltung, Quelle-Anzeige mit Link, Activity-Stream, Aktions-Buttons mit Klartext-Warnung); Klartext-Banner (überfällig / Assignee deaktiviert / Auto-Archivierungs-Hinweis / gelöschte Verknüpfung); Empty-/Loading-/Permission-Denied-/Fehler-States.
## Quellen (granular)
- `designer-briefs/P04-files-tasks.md` (vollständiger Brief — diese Doc ist sein Ticket-Destillat)
- `ENTITY-MODEL.md` → **Domäne 3** (File, FileChunk, FileUploadProgress, FileEntityLink, Task, TaskWatcher)
- `ROADMAP.md` → Phase 4 · `REQUIREMENTS.md` → Modul 23/26 (`REQ-files-datenmodell`, `-upload-preview`, `-tasks-datenmodell`, `-tasks-reminder-archivierung`) · `PHASE-SOURCES.md` → Phase 4
- `_bmad-output/specs/M23-files.md`, `M26-tasks.md`
- Dev-Pendant: `ticket-docs/AK-P4a.md`, `ticket-docs/AK-P4b.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,56 @@
# D-P5 · Screens P5 — Apps-Engine & Integrations-Framework
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Die **KI-Kategorie im App-Katalog bleibt** — sie ist jetzt der Andockpunkt für MCP-Server/künftige KI-Provider als reguläre `DataConnection` (HiveGrid hostet kein eigenes LLM, sondern wird MCP-Server, [[VR-MCP]]). Katalog-/Wizard-/Sync-UI unverändert.
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P5 — Apps-Engine & Integrations-Framework (bedient `R-P5`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-21 (Dev-Fenster 2026-06-20 → 21) · Gate W2 |
| **Status** | geplant (NEU — schließt P5-Screen-Lücke) |
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A6 Settings + Connection-Kit + Connection-Card, A5 Modal/Wizard, A2 Liste)
- **Bedient (Dev):** `R-P5` (Apps-Engine / Adapter-Layer)
- **Liefert wiederverwendbare Komponenten:** **Connection-Card** + **Setup-Wizard** + **Sync-History** sind das generische Framework, gegen das alle späteren App-Connections (P14 Email, P15 Telefonie, P16 Kalender/Signatur, P20 Stripe) registrieren — App-spezifische Setup-Teile kommen in den Modul-Phasen
- **Subframe:** Pflicht je Route (A6 Settings/Connection-Kit, A5 Wizard, A2 Liste)
## Was wir bauen
Die **generische Katalog-/Wizard-/Sync-UI** des einen typsicheren Integrations-Frameworks: App-Katalog, Connection-Verwaltung (mehrere Connections pro App pro Tenant), Connect-Wizard (OAuth2-Redirect **und** API-Key-Eingabe), Connection-Health-Monitoring mit Klartext-Diagnostik und Sync-History/-Detail. **Recut-Hinweis:** KWP = `DataConnection type='rest-api'` (API-Key) — **kein `kwpsync.exe`-Windows-Client-Flow** (v1-Connect-Typen in der UI: OAuth2 + API-Key; `windows_client` bleibt im Modell ohne UI).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Integrations-Katalog [`/admin/integrations`] | App-Karten nach Kategorie (ERP / Kommunikation / Kalender / Signatur / Payment / KI) · je App Logo, Beschreibung, Status-Ampel, Anzahl aktive Connections · Suche + Filter (Kategorie/Status/Phase) | A6 |
| App-Detail / Connection-Verwaltung [`/admin/integrations/:app`] | Pro DataConnection: Status-Indikator (grün active / gelb degraded / rot broken / grau revoked|pending), Klartext-Status-Hinweis, letzter Sync-Zeitpunkt, Re-Sync, Reconnect (bei degraded/broken), Disconnect, Sync-History-Liste (AppSyncRun mit Klartext-Summary) · **mehrere Connections pro App** (z. B. drei Gmail-Mailboxen, mit User-Label) | A6 + A2 |
| Connection-Setup-Wizard [Modal/Flow] | Voraussetzungen-Check → Credential-Formular (**auto-generiert aus `connection_schema`/JSON-Schema**) → Validation/Health-Check → Initial-Sync-Option · **OAuth2-Redirect-Variante** + **API-Key-Eingabe-Variante (mit Reveal-Toggle)** | A5 + A6 |
| Sync-History / Sync-Run-Detail [`…/syncs`, `…/syncs/:id`] | Liste der AppSyncRuns (Datum, kind pull/push/webhook/manual, Status, items_total/succeeded/failed, Klartext-Summary) · Filter (Datum/Status/Operation) · Run-Detail mit AppSyncItem-Liste (entity↔external_id, operation, Status, Klartext-Fehler) + AppSyncRunLog (Severity) | A2 / A3 |
*(Konkrete App-spezifische Setup-Komponenten → Modul-Phasen P14/P15/P16/P20. KWP-Sync-UI = v2/P32.)*
## Features (muss abgedeckt sein)
- [ ] DataConnection per OAuth2-Connect ODER API-Key-Connect in der Settings-UI herstellbar
- [ ] Connection-Health-Monitoring: Status active/degraded/broken/revoked/pending mit Klartext + Lösungs-Hinweisen
- [ ] Sync-Protokollierung (AppSyncRun/AppSyncItem/AppSyncRunLog) mit Klartext-Summary („Sync mit KWP — 14 Aufträge gepullt, 2 fehlgeschlagen …")
- [ ] Connect-Wizard (Voraussetzungen → auto-generiertes Credential-Formular → Validation → Initial-Sync); Reconnect (gleiche Connection-ID); Disconnect (Multi-Step-Confirm + Cleanup, Status revoked statt Hard-Delete)
- [ ] Mehrere DataConnections pro App pro Tenant mit User-Label
- [ ] Manueller Re-Sync mit Klartext-Progress; Schema-Drift/degraded/broken → Klartext-Banner mit Lösungs-Knopf
- [ ] Permission-aware (integrations.read/.connect/.disconnect/.manual_sync/.view_logs/.admin)
- [ ] Empty/Loading/Permission-Denied/Fehler-States (Klartext)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
App-Katalog als Karten-Grid gruppiert nach Kategorie (je Karte App-Logo + Beschreibung + Status-Ampel + Anzahl-aktive-Connections), Such-Feld + Filter (Kategorie/Status/Phase); **wiederverwendbare Connection-Card** (App-Logo, Status-Ampel grün/gelb/rot/grau, Klartext-Status-Hinweis, letzte-Sync-Zeit, Buttons Verbinden/Re-Sync/Reconnect/Trennen) für mehrere Connections pro App; **Setup-Wizard** (mehrstufig, Progress) mit Voraussetzungen-Check-Schritt, auto-generiertem Credential-Formular aus JSON-Schema (Text-/Key-/Secret-Felder mit Reveal-Toggle), OAuth2-Redirect-Trigger-Variante, Validation-/Health-Check-Schritt, optionalem Initial-Sync-Schritt; Disconnect-Bestätigungs-Dialog (Multi-Step, Klartext „Beim Trennen werden alle Sync-Jobs gestoppt …"); Sync-History-Liste (Datum/kind/Status/items-Zähler/Klartext-Summary) mit Filter; Sync-Run-Detail mit AppSyncItem-Tabelle (entity↔external_id, operation, Status, Klartext-Fehler) + Log-Einträgen mit Severity; manueller Re-Sync-Trigger mit Klartext-Progress; Status-/Klartext-Banner für degraded/broken/Schema-Drift mit Lösungs-Knopf; Empty-/Loading-/Permission-Denied-/Fehler-States.
## Quellen (granular)
- `designer-briefs/P05-apps-engine-integrations-framework.md` (vollständiger Brief — Recut KWP→v2)
- `ENTITY-MODEL.md` → **Domäne 4** (App, DataConnection, AppSyncRun, AppSyncRunLog, AppSyncItem)
- `ROADMAP.md` → Phase 5 · `REQUIREMENTS.md` → Modul 33a (`REQ-apps-engine-datenmodell`, `-apps-engine-lifecycle`) · `PHASE-SOURCES.md` → Phase 5
- `_bmad-output/specs/M33a-apps-engine.md` (⚠ Drei-Komponenten-/`kwpsync.exe`-Architektur ist NICHT zu bauen — Scope-Schnitt #12)
- Dev-Pendant: `ticket-docs/R-P5.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,59 @@
# D-P7 · Screens P7 — Lead-Inbox
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P7 — Lead-Inbox (bedient `R-P7`) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · 2026-06-25 → 2026-06-26 · Gate W2 (Noah-Demo #1) |
| **Status** | geplant (NEU — schließt P7-Screen-Lücke) |
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail, A4 Form, A5 Modal, A6 Settings, KPI-Kit)
- **Bedient (Dev):** `R-P7` (Lead-Inbox, Lead→Projekt, Anti-Spam, Statistiken)
- **Läuft parallel zu:** `D-CRM`-Cluster (Kontakt-/Firmen-Listen aus P6) — Lead-Cluster gehört ins selbe Designer-Paket (Noah-Demo #1); embedded Task-Liste/Files-Sub-Sektion kommen aus `D-P4`
- **Subframe:** Pflicht je Route (A2 Triage-Liste, A3 Detail, A5 Lead→Projekt-Flow, A6 Settings, KPI-Kit)
## Was wir bauen
Den **Lead-Triage-Arbeitsplatz**: eingehende Leads aus allen Quellen (Form, eingehende E-Mail, AirCall-Inbound, manueller Eintrag, Custom-Quellen) landen automatisch angelegt in einer Inbox, sind spam-geschützt, auswertbar und per Workflow weiterverarbeitbar.
> 🔴 **Pivot-Vorrang (AD-20):** Es gilt das `ENTITY-MODEL.md`, nicht die pre-Pivot-SCREEN-MAP. Das **Lead-Promotion-Modal (4-Optionen) entfällt** — es wird **Lead → Projekt**. Ein Lead trägt **`weiterverarbeitung_freigabe` (ja/nein/unklar)**; bei „ja" entsteht ein `Projekt` (kein Contact-Promotion), Lead-Daten werden vererbt (`konvertiert_projekt_id`), der **Kontakt wird separat verknüpft** (`verknuepfter_kontakt_id` — neu oder bestehend). Status-Enum bleibt `new/qualified/converted/lost/spam`.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **Lead-Inbox** [`/leads`] | Tabelle/Karten: Identität (Name, sonst Email/Telefon, sonst Quelle+Datum), Quelle, Status, Verantwortlicher, Eingegangen (relativ <7 T), letzte Activity, 80-Zeichen-Message-Vorschau · Marker „Mögliches Duplikat"/„Spam-Verdacht"/„Auto-promoviert" · Filter (Status [Default new+qualified], Quelle, Verantwortlicher inkl. „Nicht zugewiesen", Eingegangen-Range, Tags, Lead-Custom-Felder) · Toggles „Spam ausblenden" (Default ein) + „Konvertierte einblenden" (Default aus) · Inline-Quick-Actions (Zuweisen, Status, **Zu Projekt machen**, Spam) · Bulk · Real-time-Refresh | A2 + Triage-Akzente |
| **Lead-Detail** [`/leads/:id`] | Stammdaten inline-editierbar · Quellen-Detail (Form-Name/Submission-ID/IP bzw. Email-Header bzw. Anruf-Aufzeichnungs-Link) · **Weiterverarbeitungsfreigabe (ja/nein/unklar)** · Spam-Score + Klartext-Begründung · **Match-Hinweise** (existierende Kontakte gleiche Email/Telefon, Soft-Match Name+Adresse) mit Direkt-Übergängen · Re-Submission-Verlauf · Status-Wechsler · DSGVO-Auto-Lösch-Hinweis mit Datum · Triage-Quick-Actions (Annehmen/Antworten/Anrufen/Notiz/Task/Termin) · Sub-Sektionen Übersicht/Konversation/Activity/Custom-Felder | A3 |
| **Lead → Projekt** [bei Freigabe, kein Modal-Zwang] | Bei `weiterverarbeitung_freigabe=ja`: Projekt aus Lead anlegen · **Daten-Vererbungs-Vorschau** (welche Lead-Felder ins Projekt fließen) · Ziel-Pipeline + Start-Status wählen · **Kontakt separat verknüpfen** (neu ODER bestehend, Auto-Match-Hinweis) · Mängel-Banner bei fehlenden Pflichtdaten (z. B. Name) | A5 — **Kern-Moment der Kette** (ersetzt das alte 4-Optionen-Promotion-Modal) |
| Lead-Statistiken [`/leads/statistics`] | KPI-Kacheln (Eingegangen, Konversion Lead→Projekt, Lead→Won, Reaktionszeit, Spam-Quote, Open-Leads >24h) · Aufschlüsselung nach Quelle/Verantwortlichem/Tag/Wochentag/Status · Trend-Charts mit Vorperioden-Vergleich · Date-Range-Selektor + Vergleichs-Toggle · Drill-Down → vorgefilterte Inbox · permission-aware (Verantwortlichen-Aufschlüsselung nur mit `leads.read_all`) | A2 + KPI-Kit |
| Quellen-Verwaltung [`/admin/lead-sources`] | Quellen-Liste (Name, Typ System/Custom, 30-Tage-Lead-Count, Status) · Custom-Quelle anlegen (Name, Display-Label, optional Default-Verantwortlicher/Default-Tags) · Edit/Archivieren · **Webhook-URL mit Token** (Fremd-Website-Leads) | A2 / A6 |
| Anti-Spam-Settings [`/admin/lead-anti-spam`] | Hard-Limit pro Quelle/Stunde + pro IP/Stunde · Anomalie-Detection (10×-Spike → Auto-Pause) · Auto-Mark-as-Spam-Heuristiken als Toggles (IP-Blocklist, Disposable-Domain, Honeypot, <3s-Submit) · Quarantäne- vs. Vollständig-Spam-Modus · `lost`-Auto-Lösch-Frist (0 = nie) | A6 |
| Manueller Lead-Eintrag [`/leads/new`] | Vor-/Nachname, Email, Telefon, Message, Quelle (Default manual), Verantwortlicher (Default Self), Tags · Inline-Match-Check beim Tippen | A4 |
*(Lead-Promotion-Modal entfällt — ersetzt durch „Lead → Projekt". Kontakt-/Firmen-Listen, Custom-Felder-/Tag-/Duplikat-Admin → P6/D-CRM.)*
## Features (muss abgedeckt sein)
- [ ] Lead-Inbox als Arbeitsplatz (Status-Filter, Triage-Quick-Actions, Bulk, Real-time-Refresh)
- [ ] **Lead → Projekt bei Weiterverarbeitungsfreigabe** (kein Contact-Promotion-Modal); Vererbung + separater Kontakt-Verknüpfung
- [ ] Multi-Quellen-Marker (Form/Email/AirCall-Inbound/manuell/Custom)
- [ ] Status-Workflow (new/qualified/converted/lost/spam) + DSGVO-Auto-Lösch-Hinweis (spam 30 T, lost konfigurierbar)
- [ ] Anti-Spam-Settings (Rate-Limits, Anomalie-Pause, Quarantäne, Auto-Mark-Heuristiken)
- [ ] Statistiken-Page (KPI-Kacheln, Quellen-Aufschlüsselung, Trends) — permission-aware
- [ ] Permission-aware UI (`leads.*`); nicht-eigene Leads bei `read_own` unsichtbar (404 statt 403)
- [ ] Empty/Loading/Fehler/Permission-Denied-States (Klartext + Lösungs-Knopf)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Triage-Daten-Tabelle/Karten-Umschalter (sortierbar, cursor-paginiert 50/Page), Filter-Bar (Multi-Select Status/Quelle/Verantwortlicher, Date-Range, Tags, Custom-Feld-Filter), Toggle-Chips (Spam ausblenden / Konvertierte einblenden), Hinweis-Marker (Duplikat/Spam/Auto-promoviert), Inline-Quick-Action-Picker (Zuweisen/Status), Bulk-Action-Toolbar mit Klartext-Bestätigungen, Detail-Panel mit Inline-Edit, Weiterverarbeitungsfreigabe-Auswahl (ja/nein/unklar), Spam-Score-Anzeige mit Begründung, Match-Hinweis-Liste mit Sprung-Links, Re-Submission-Verlauf, DSGVO-Lösch-Countdown-Hinweis, Status-Wechsler, **„Lead → Projekt"-Flow** (Daten-Vererbungs-Vorschau + Pipeline-/Status-Wahl + separater Kontakt-Verknüpfungs-Picker mit Match), KPI-Kacheln, Bar-/Line-Charts mit Vorperioden-Delta, Drill-Down-Verlinkung, Webhook-URL-Feld mit Copy + Token, Anti-Spam-Toggle-Zeilen, Empty-/Loading-/Fehler-/Permission-Denied-States.
## Quellen (granular)
- `designer-briefs/P07-lead-inbox.md` (vollständiger Brief — 🔴 Pivot-Vorrang AD-20)
- `ENTITY-MODEL.md` → **Domäne 5: Projekt-zentrischer CRM-Kern** (Lead-Zeile + Lead→Projekt) — 🔴 **Pivot-Vorrang (AD-20)**: kein Promotion-Modal, `weiterverarbeitung_freigabe`, `konvertiert_projekt_id`/`verknuepfter_kontakt_id`
- `ROADMAP.md` → Phase 7 (+ Pivot-Note) · `REQUIREMENTS.md` → `REQ-lead-*` · `PHASE-SOURCES.md` → P7
- `_bmad-output/specs/M02-lead-inbox.md` (⚠ teils pre-pivot: „promovieren zu Contact"/4-Optionen-Modal überholt — ENTITY-MODEL hat Vorrang)
- Dev-Pendant: `ticket-docs/R-P7.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,59 @@
# D-P8 · Screens P8 — Projekt & Pipelines (Kern, ohne Kanban)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P8 — Projekt & Pipelines Kern (bedient `R-P8a`/`R-P8b`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-27 → 2026-06-28 · Gate W3 |
| **Status** | geplant (NEU — schließt P8-Screen-Lücke außerhalb des Kanban) |
> **Ergänzt das Bespoke-Ticket `D-KANBAN`** (Pipeline-Kanban, konfigurierbar). **Dieses Ticket deckt die übrigen P8-Screens** (Projekt-Detail-Basis, Listen-View, Pipeline-Config-Editor, Forecast/Reporting). Der Kanban-Screen ist **NICHT** Teil von D-P8.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail, A6 Settings, KPI-Kit)
- **Bedient (Dev):** `R-P8a` (Projekt-Kern + Pipeline-Engine), `R-P8b` (konfigurierbarer Kanban + Forecast/Reporting)
- **Parallel/Geschwister:** `D-KANBAN` (BESPOKE, das eine Board für ALLE Pipeline-Typen) — D-P8 liefert Detail/Liste/Config/KPI, D-KANBAN das Board; embedded Task-Liste/Files/Audit-Drawer aus `D-P4`/`D-P3`
- **Subframe:** Pflicht je Route (A2 Liste, A3 Muster-Detail-View, A6 Settings)
## Was wir bauen
Die **Nicht-Kanban-Flächen des `Projekt`-Kerns + der Pipeline-Engine**: die Muster-Projekt-Detail-View, die Cross-Pipeline-Listen-View, den Pipeline-Config-Admin (Stages, Access, FieldConfig, Lost-Reasons) und die Datenquellen/KPIs für Forecast & Reporting.
> 🔴 **Pivot-Vorrang (AD-20):** Es gilt das `ENTITY-MODEL.md`. Es gibt **EINEN `Projekt`-Kern** (typisierte Superset-Tabelle) und **konfigurierbare Pipeline-Views**. „Deal" und „Auftrag" sind **Pipeline-Typen** (`Pipeline.typ_hint = sales/auftrag/custom`), **keine** eigenen Entitäten. **Kein Won-Handoff**, kein zweiter Datensatz — ein Projekt wechselt nur die Pipeline. **`Status` ist immer pipeline-intern** (`PipelineStage.stage_kind = offen/gewonnen/verloren`); kein globaler Projektstatus. Field-Level-Sichtbarkeit (z. B. Volumen nur Vertrieb) läuft über **`PipelineFieldConfig`** + **`PipelineAccess`** (kein Deal-/Promotion-Modal).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| **Projekt-Detail** [`/projects/:id`] | Stammdaten inline-editierbar (Nummer, Name, Beschreibung, Volumen/potenzieller Wert, Pipeline, Stage, Zeitraum, Adressen-Slots) · verknüpfte Kontakte mit Rolle (auftraggeber/bauherr/rechnungsempfaenger/ansprechpartner) · **Lead-Herkunft-Hinweis** (`konvertiert_aus_lead_id`) · **klickbare Stage-Bar** (pipeline-intern) + Stage-Historie mit Verweildauer · Gewonnen/Verloren-Banner mit 24h-Rückgängig · Tags · Custom-Felder (pro Pipeline via PipelineFieldConfig geschaltet) · Activity-Stream · Quick-Actions (Anrufen/Email/Termin/Task/Notiz) · Sub-Area-Tabs (Termine/Aufgaben/Aktivitäten/Dokumente — Rechnungen/Checklisten/Abnahme in P9) | A3 (**Muster-Detail-View**) |
| Projekt-Liste [`/projects/list`] | Projekt-Nummer, Titel, Pipeline, Status (Stage), Volumen (gegated), verknüpfter Kontakt/Firma, Zeitraum/Close-Datum, letzte Activity · Cross-Pipeline-Sicht mit Pipeline-Spalte + -Filter · sortierbare Header, Spalten-Konfig, Bulk, CSV-Export, Pagination | A2 |
| **Pipeline-Config-Admin** [`/admin/pipelines` bzw. `/:id`] | Pipelines-Liste (Name, typ_hint, Stage-Anzahl, aktive Projekte, Status) · Editor: Stages mit Drag&Drop je Name/`stage_kind` (offen/gewonnen/verloren)/Win-%/Farbe · **PipelineAccess** (wer darf sehen/bearbeiten: Rolle/User/Gruppe — kann_sehen/kann_bearbeiten) · **PipelineFieldConfig** (pro Feld — System ODER `custom:<id>` — Sichtbarkeit + Pflicht + Reihenfolge, optional je Status) · Validation min. 1 gewonnen + 1 verloren · neue Pipeline anlegen/duplizieren/archivieren | A2 + A6 |
| Lost-Reasons [`/admin/pipelines/lost-reasons`] | Liste (Name, Anzahl verknüpfter Projekte, Status) · Add/Edit/Archive (kein Hard-Delete — Reporting) · SHK-Default 5 Reasons geseedet | A2 |
| Forecast/KPI-Quellen (Widgets in P11) | Datenquellen/Berechnungen: Pipeline-Forecast (Volumen × Win-%), realisierter Umsatz, KPIs pro Verantwortlichem, Stage-Conversion-Rates, Lost-Reason-Verteilung · Aggregat-Cache · (kein eigener Screen — Widgets leben in P11/D-DASH; hier: Datenform + Charts-Bausteine) | KPI-Kit/Charts |
*(Pipeline-Kanban = **D-KANBAN** (BESPOKE). Plantafel + Rechnungen/Checklisten/Abnahme-Sub-Areas → P9. „Deal-Liste/Deal-Detail" aus SCREEN-MAP entfällt — projekt-zentrische Routen oben.)*
## Features (muss abgedeckt sein)
- [ ] EIN `Projekt`-Kern (typisierte Superset-Tabelle) mit fortlaufenden Projekt-Nummern (HiveNumberSeq)
- [ ] Pipeline-Engine-Verwaltung (anlegen/benennen/duplizieren/archivieren; `typ_hint` sales/auftrag/custom; min. 1 gewonnen + 1 verloren)
- [ ] PipelineAccess (Sichtbarkeit/Bearbeitung je Rolle/User/Gruppe) + PipelineFieldConfig (Feld-Sichtbarkeit + Pflicht + Reihenfolge je Pipeline/Status)
- [ ] Listen-View mit Filter/Bulk/CSV (Cross-Pipeline)
- [ ] Projekt-Detail mit klickbarer Stage-Bar, Stage-Historie, Lead-Herkunft-Hinweis, Gewonnen/Verloren-Banner (24h-Rückgängig)
- [ ] Field-Level-Sichtbarkeit primär über PipelineFieldConfig; Volumen ohne Recht zeigt „—"
- [ ] Forecast/KPI-Datenform + Charts-Bausteine (Forecast/Conversion/Lost-Verteilung)
- [ ] Empty/Loading/Fehler/Permission-Denied-States (Klartext)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Daten-Tabelle (sortierbar, paginiert, Spalten-Konfig, CSV), Pipeline-Spalte + -Filter; Detail-Panel mit Inline-Edit; **klickbare Status-/Stage-Bar**; Stage-Historie mit Verweildauer; Lead-Herkunft-Hinweis; Relations-Liste mit Rollen-Badge (auftraggeber/bauherr/rechnungsempfaenger/ansprechpartner); Custom-Feld-Renderer je Typ; Tag-Chips; Activity-Timeline; Quick-Action-Buttons; gewonnen/verloren-Bestätigungs-Dialog (Lost-Reason-Pflicht) + 24h-Rückgängig-Banner; **Pipeline-Editor** (Stage-Drag&Drop, `stage_kind`/Win-%/Farbe); **PipelineAccess-Matrix** (Principal × sehen/bearbeiten); **PipelineFieldConfig-Liste** (Feld × sichtbar/pflicht/Reihenfolge je Status); Lost-Reasons-CRUD-Liste; KPI-Kacheln/Charts (Forecast/Conversion/Lost-Verteilung); „Volumen verborgen (—)"-Zustand; Empty-/Loading-/Fehler-/Permission-Denied-States.
## Quellen (granular)
- `designer-briefs/P08-projekt-pipelines-kern.md` (vollständiger Brief MINUS Kanban — 🔴 Pivot-Vorrang AD-20)
- `ENTITY-MODEL.md` → **Domäne 5** (Projekt-Kern + Pipeline/Stage/FieldConfig/Access) + Kern-Ketten-Diagramm + Modellierungs-Fragen 3/4 — 🔴 **Pivot-Vorrang (AD-20)**
- `ROADMAP.md` → Phase 8 (+ Pivot-Note) · `REQUIREMENTS.md` → `REQ-projekt-kern-datenmodell` / `REQ-pipeline-rechte-config` / `REQ-projekt-kanban-listen-view` / `REQ-projekt-forecast-kpis` · `PHASE-SOURCES.md` → P8
- `_bmad-output/specs/M03-sales-pipeline.md` (⚠ „Deal"/„won_handoff_project_id" = Projekt-Kern bzw. Pipeline-Wechsel)
- Geschwister-Ticket (Kanban): `D-KANBAN` · Dev-Pendant: `ticket-docs/R-P8a.md`, `ticket-docs/R-P8b.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,59 @@
# D-P9 · Screens P9 — Projekt & Pipelines (Auftrags-Sub-Areas, ohne Plantafel & Abnahme-Workflow)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P9 — Projekt & Pipelines Auftrag (bedient `R-P9a`/`R-P9b`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-30 → 2026-07-01 · Gate W3 |
| **Status** | geplant (NEU — schließt P9-Screen-Lücke außerhalb Plantafel/Abnahme) |
> **Ergänzt die Bespoke-Tickets `D-PLAN` (Plantafel) und `D-ABN` (Abnahme-Workflow + Abnahme-Liste).** **Dieses Ticket deckt die übrigen P9-Screens**: Projekt-Detail-Auftrags-Sub-Areas, Rechnung-Sub-Entity, Pipeline-Config-Auftragsteil, Acceptance-Form-Templates und Project-Templates. Plantafel-Raster und der Abnahme-Workflow/-Liste sind **NICHT** Teil von D-P9.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A3 Detail + Sub-Area-Tabs, A2 Liste, A5 Modal, A6 Settings)
- **Bedient (Dev):** `R-P9a` (Sub-Areas am Projekt + Rechnung), `R-P9b` (Plantafel offline + Abnahme-Protokoll offline)
- **Parallel/Geschwister:** `D-PLAN` (Plantafel, BESPOKE-Mobile/offline) und `D-ABN` (Abnahme-Workflow + Abnahme-Liste, BESPOKE-Mobile) — D-P9 liefert die A3-Sub-Area-Flächen drumherum; baut auf der P8-Projekt-Detail-Basis auf (`D-P8`); embedded Task-Liste/Files aus `D-P4`
- **Subframe:** Pflicht je Route (A3 + 📱-Variante für Mobil-Modus, A2/A5 Rechnung, A6 Settings/Templates)
## Was wir bauen
Die **auftragsspezifischen Sub-Area-Flächen auf dem `Projekt`-Kern** (ohne Plantafel/Abnahme-Workflow): Erweiterung der Projekt-Detail-View um Auftrags-Sub-Areas, das neue Rechnung-Sub-Entity (v1), den auftrags-spezifischen Pipeline-Config-Teil, die Acceptance-Form-Templates-Verwaltung und Project-Templates.
> 🔴 **Pivot-Vorrang (AD-20):** Es gilt das `ENTITY-MODEL.md`. **Kein separates Project-Objekt** — die Auftrags-Welt ist eine **Pipeline-View auf denselben `Projekt`-Kern** (P8). Kein Won-Handoff, kein zweiter Datensatz, **keine read-only „Sales-Verlauf-Sektion"** — die Historie steckt im selben Projekt-Activity-Stream. **Rechnung ist NEUES Sub-Entity (v1, E3)** am Projekt. Material-Ausgang/Lagerist-Sicht, Zeiterfassung, Leistungspositionen, Baustelle, Supporttickets → v2 (Material-Listen am Auftrag bleiben v1). **KWP komplett v2** — `ProjektExternesFeld` ist in v1 NICHT vorhanden (kein Feld-Halter, erst ab v2; Entscheidung 16.06.).
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| 📱 **Projekt-Detail — Auftrags-Sub-Areas** [`/projects/:id`] | Erweitert die P8-Detail-View (D-P8) um Sub-Area-Tabs/Sektionen: **ProjektMitglieder** (Monteure/PL/zuständig/Beobachter mit Rolle, Multi-Add aus Group), **Termine**, **Rechnungen [v1 NEU]**, **Checklisten** (inkl. Mängel `typ=maengel`), **Aufgaben**, **Dateien/Dokumente**, **Abnahmen** (Einstieg → D-ABN) *(KWP-/Externe-Felder erst ab v2 — in v1 nicht)* · Baustellen-/Rechnungs-/Bauherr-Adress-Slots · Offene-Mängel-Banner · **Mobil-Modus: Stammdaten + heutige Tasks + Abnahme-Button + One-Tap-Foto-Upload** | A3 + 📱-Variante |
| Rechnung-Sub-Entity [im Projekt-Detail, Sub-Area] | Rechnung anlegen/anzeigen: Rechnungsnummer (HiveNumberSeq), Betrag, Status (entwurf/gestellt/bezahlt/storniert), Datum, fällig_am, verknüpfte Datei, Quelle (manuell/kwp) · einfaches Sub-Entity am Projekt (v1 NEU, E3) | A2/A5 (in Sub-Area) |
| Pipeline-Config-Auftragsteil [`/admin/pipelines/:id`] | Auftrags-spezifische Stage-Optionen: `requires_acceptance_protocol` je Stage (Block beim Wechsel ohne Abnahme), Acceptance-Form-Template-Zuweisung, `auto_archive_after_days` · (Basis-Pipeline-Editor = P8/D-P8) | A6 |
| Acceptance-Form-Templates [`/admin/projects/acceptance-forms`] | Form-Builder-basiert (M05, Subtyp acceptance_form), SHK-Default geseedet · Verwaltung/Zuweisung | A6 |
| Project-Templates [`/admin/projects/templates`] | Vorlagen mit Default-Pipeline/Stage/Mitgliedern/Tasks/ScheduleEntries/Custom-Feldern | A2 |
*(Plantafel → **D-PLAN**. Abnahme-Workflow + Abnahme-Liste → **D-ABN**. Projekt-Kanban/Listen/Detail-Basis/Pipeline-Engine = P8/D-P8 + D-KANBAN. Material-Ausgang/Lagerist/Zeiterfassung/Leistungspositionen → v2.)*
## Features (muss abgedeckt sein)
- [ ] Sub-Areas am Projekt: Termine, **Rechnungen [v1 NEU]**, Checklisten (inkl. Mängel `typ=maengel`), Aufgaben, Aktivitäten, Dokumente, ProjektMitglieder *(KWP-/Externe-Felder erst ab v2)*
- [ ] Rechnung-Sub-Entity (Nummer/Betrag/Status/Datum/Fälligkeit/Datei/Quelle) anlegen + anzeigen
- [ ] Pipeline-Config-Auftragsteil (`requires_acceptance_protocol`, Acceptance-Template-Zuweisung, `auto_archive_after_days`)
- [ ] Acceptance-Form-Templates-Verwaltung + Zuweisung (SHK-Default)
- [ ] Project-Templates (Default-Pipeline/Stage/Mitglieder/Tasks/ScheduleEntries/Custom-Felder)
- [ ] Offene-Mängel-Banner am Projekt-Detail; Abnahme-Button als Einstieg in D-ABN
- [ ] Mobil-Modus der Projekt-Detail (Stammdaten + heutige Tasks + Abnahme-Button + One-Tap-Foto-Upload)
- [ ] Empty/Loading/Fehler/Permission-Denied/Offline-States (Klartext)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Sub-Area-Tabs/Sektionen am Projekt-Detail; ProjektMitglieder-Liste mit Rollen-Badge (Monteur/PL/zuständig/Beobachter) + Multi-Add aus Group; Rechnungs-Sub-Liste (Nummer/Betrag/Status/Fälligkeit/Quelle/Datei) + Anlage-Form; Checklisten-/ChecklistItem-Liste mit Status + Mängel-Klasse + Foto; KWP-Externe-Felder-Anzeige (read-only); Acceptance-Form-Template-Picker; Project-Template-Auswahl; Stage-Option-Editor (`requires_acceptance_protocol` / Template-Zuweisung / `auto_archive_after_days`); Offene-Mängel-roter-Banner; Abnahme-Button-Einstieg (→ D-ABN); 📱 Mobil-Detail-Variante (Stammdaten + heutige Tasks + One-Tap-Foto-Upload); Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext + Lösungs-Knopf).
## Quellen (granular)
- `designer-briefs/P09-projekt-pipelines-auftrag.md` (vollständiger Brief MINUS Plantafel & Abnahme-Workflow/Liste — 🔴 Pivot-Vorrang AD-20)
- `ENTITY-MODEL.md` → **Domäne 5** (Sub-Areas am Projekt: Rechnung/Termin/Checkliste/AbnahmeProtokoll/AbnahmeSignatur/ProjektMitglied/ProjektExternesFeld) + Kern-Ketten-Diagramm — 🔴 **Pivot-Vorrang (AD-20)**
- `ROADMAP.md` → Phase 9 (+ Pivot-Note) · `REQUIREMENTS.md` → `REQ-projekt-*` · `PHASE-SOURCES.md` → P9
- `_bmad-output/specs/M04-auftragspipeline.md` (⚠ „AcceptanceProtocol/ProjectPipeline/source_deal_id-Snapshot" = Sub-Area am gemeinsamen `Projekt`-Kern)
- Geschwister-Tickets: `D-PLAN` (Plantafel), `D-ABN` (Abnahme) · Basis: `D-P8` · Dev-Pendant: `ticket-docs/R-P9a.md`, `ticket-docs/R-P9b.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,50 @@
# D-PLAN · Plantafel (Bespoke-Mobile, offline)
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | P9 — Projekt & Pipelines (Auftrags-Features + Sub-Areas) (bedient `R-P9a`/`R-P9b`) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-29 → fällig 2026-07-01 |
| **Status** | geplant |
> 🟦 **Bespoke-Abgrenzung:** Dieses Ticket deckt **NUR die Plantafel** (Desktop-Scheduling-Grid + Monteur-Mobil-Modus). Der **Abnahme-Workflow + Abnahme-Liste** (P9) → **`D-ABN`**. Die übrigen P9-Screens (Projekt-Detail-Sub-Areas, Rechnung-Sub-Entity, Pipeline-Config-Auftragsteil, Acceptance-Form-Templates, Project-Templates) sind Compose aus A3/A6 → P9-Compose-Anteil (Davids Compose-Tickets / Projekt-Detail aus `D-CRM`+`D-ABN`).
> 🔴 **Pivot-Vorrang (AD-20):** **Kein separates Project-Objekt** — die Auftrags-Welt ist eine Pipeline-View auf denselben `Projekt`-Kern (P8). ScheduleEntry-Status pipeline-/eigenständig; Konflikte speisen sich aus HR (M14) + Kalender (M25).
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-D0b` (Archetypen, Zustands-Kit inkl. offline)
- **Blockt:** —
- **Bedient (Dev):** `R-P9a`/`R-P9b` (Auftrags-Features auf dem Projekt-Kern — Plantafel ist `plantafel.*`)
- **Subframe:** Pflicht je Route. Plantafel ist **BESPOKE** (📱 mobile-first + offline).
## Was wir bauen
**Nur die Plantafel**: das Desktop-Scheduling-Grid (Mitarbeiter × Zeit, Drag&Drop, Konflikt-Indikatoren) und den **offline-fähigen Monteur-Mobil-Modus** „Meine Termine heute"/„Meine Woche". Höchste Bespoke-Priorität nach dem Flow-Editor.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| 📱 **Plantafel** [`/projects/plantafel`] | Desktop: Y = Mitarbeiter, X = Zeit (Tag/Woche/Monat-Switcher) · Einträge je Person×Slot: Projekt-Titel, Status-Farbe (pipeline-basiert), Adresse-Kurzform · **Drag&Drop verschieben/resizen** · neue ScheduleEntry per Klick auf leeren Slot · **Konflikt-Indikatoren** (Doppelbelegung; Urlaub/krank aus HR M14; außerhalb Verfügbarkeit/Arbeitszeit) mit Klartext-„Trotzdem?" · MA-Filter (Rolle/Group/Verfügbarkeit) + Projekt-Filter · Status-Wechsel (planned→confirmed→in_progress→done/cancelled) · Bulk-Reassign · Calendar-Sync-Indikator · **Monteur-Mobil-Modus: „Meine Termine heute"** (Liste mit Adresse + Navigations-Link, Tap-Statuswechsel) + „Meine Woche", **offline-fähig** | **BESPOKE** (höchste Priorität nach Flow-Editor) |
*(Abnahme-Workflow + Abnahme-Liste → `D-ABN`. Projekt-Detail-Sub-Areas / Rechnung-Sub-Entity / Pipeline-Config-Auftragsteil / Acceptance-Form-Templates / Project-Templates = P9-Compose. Material-Ausgang/Lagerist/Zeiterfassung/Leistungspositionen → v2.)*
## Features (muss abgedeckt sein)
- [ ] Desktop-Grid (Mitarbeiter × Zeit) mit Drag&Drop verschieben/resizen + Konflikt-Indikatoren
- [ ] neue ScheduleEntry per Klick auf leeren Slot; Status-Workflow planned→confirmed→in_progress→done/cancelled; Bulk-Reassign
- [ ] Konflikt-Detection (Doppelbelegung, Urlaub/krank aus HR M14, Verfügbarkeits-Regeln) mit Klartext-„Trotzdem zuweisen?"
- [ ] Calendar-Sync-Indikator (M25) der ScheduleEntries
- [ ] **Monteur-Mobil-Modus „Meine Termine heute"/„Meine Woche"** mit Adresse + Navigations-Link + Tap-Statuswechsel, **offline-fähig** (offline-State aus A7)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Plantafel-Raster (Y=MA, X=Zeit, Zeitraum-Switcher Tag/Woche/Monat); Drag&Drop-/Resize-ScheduleEntry-Blöcke; leerer-Slot-Klick-Anlage; Konflikt-Indikatoren + „Trotzdem?"-Dialog; MA-/Projekt-Filter; Status-Wechsler je Eintrag; Bulk-Reassign-Funktion; Calendar-Sync-Indikator; Monteur-Mobil-Tagesliste mit Adresse/Navigations-Link + Tap-Statuswechsel + Offline-Hinweis; Empty-/Loading-/Fehler-/Permission-Denied-/Offline-States (Klartext + Lösungs-Knopf).
## Quellen (granular)
- `designer-briefs/P09-projekt-pipelines-auftrag.md` → §Benötigte Screens „📱 Plantafel" (NUR dieser Screen) + zugehörige Features/UI-Elemente
- `ENTITY-MODEL.md` → **Domäne 5** (ScheduleEntry/ProjektMitglied am Projekt-Kern; Pivot: kein separates Project-Objekt) — **Pivot-Vorrang**
- `SCREEN-MAP.md` → §4 Plantafel · `DESIGNER-FIRST-PLAYBOOK.md` → §3 Rang 3 · `ROADMAP.md` → Phase 9 · `_bmad-output/specs/M04-auftragspipeline.md`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,50 @@
# D-POLISH · Politur extern sichtbarer Flächen + Visual-Reg-Baselines
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | Härtung & Launch (kein Phasen-Brief — Quer-Politur; Quelle = Snapshot-DoD) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-06 → fällig 2026-07-09 |
| **Status** | geplant |
> ℹ️ **Kein Designer-Phasen-Brief:** Querschnitts-Politur kurz vor Freeze. Quelle ist der Snapshot-DoD und `DESIGNER-FIRST-PLAYBOOK.md` §6c (CI-Gates). Kein neuer Screen — finaler Schliff der bereits gebauten, extern sichtbaren Flächen + die verbindlichen **Visual-Regression-Baselines**.
## Abhängigkeiten & Parallelität
- **Blocked by:** `D-BOOK` (öffentliche Booking-Page), `D-DASH` (Dashboard) — die zu politurenden Flächen müssen erst stehen
- **Blockt:** `FREEZE` (Code-/Design-Freeze vor Launch)
- **Bedient (Dev):** alle extern sichtbaren Routen (Booking/Forms/Marketing-Mails) + die Visual-Reg-CI-Gates
- **Subframe:** Pflicht je Route — Politur erfolgt an den bestehenden Subframe-Designs (kein Roh-Code).
## Was wir bauen
Die **finale Politur der extern sichtbaren Flächen** (öffentliche Booking-Page, öffentliche Formulare, Marketing-Mails) und das Einfrieren der **Visual-Regression-Baselines** als CI-Gate vor dem Freeze. Letzter Design-Schritt vor Launch.
## Benötigte Screens
| Fläche | Politur-Fokus | Quelle |
|---|---|---|
| Öffentliche Booking-Page [`/b/{tenant}/{slug}`] | höchster Polish (Branding, 4 Zustände, Responsive, Micro-Interactions) | `D-BOOK` (P16) |
| Öffentliche Formulare [`/f/{tenant}/{slug}`] | Polish + Tenant-Branding + Zustände | `D-FORM` (P16) |
| Marketing-Mails (Templates/Footer) | Rendering Desktop/Mobile, Pflicht-Footer, Branding | `D-KAMP` (P14) |
| Visual-Regression-Baselines | finale Screenshot-Baselines aller extern sichtbaren Routen (vor Freeze) | `DESIGNER-FIRST-PLAYBOOK.md` §6c |
*(Kein neuer Screen — reine Politur + Baseline-Erstellung. Interne Flächen wurden in ihren Phasen-Tickets poliert.)*
## Features (muss abgedeckt sein)
- [ ] Booking/Forms/Marketing-Mails poliert (Branding, Zustände, Responsive, Micro-Interactions)
- [ ] Visual-Regression-Baselines final eingefroren (vor Freeze) als CI-Gate
- [ ] Konsistenz-Check der Brand-Tokens über alle extern sichtbaren Flächen (Drift gegen `D-WEB`/`D-D0a` ausgeräumt)
- [ ] Hell/Dunkel + Mobile-Varianten der Public-Flächen final
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Politur-Pässe an bestehenden Komponenten (Spacing/Typo/Farb-Feinschliff); konsistente Zustands-Darstellung (Empty/Loading/Fehler/Erfolg) auf Public-Flächen; finale Branding-Anwendung (Logo/Farben/Footer); Visual-Regression-Snapshot-Set je Public-Route (Desktop + Mobile, Hell + Dunkel).
## Quellen (granular)
- Plane-Snapshot `D-POLISH` → DoD: „Booking/Forms/Marketing-Mails poliert" + „Visual-Regression-Baselines final (vor Freeze)"
- `DESIGNER-FIRST-PLAYBOOK.md` → §6c CI-Gates
- Vorgänger-Flächen: `D-BOOK` (P16), `D-FORM` (P16), `D-KAMP` (P14), `D-DASH` (P11); Token-Anker `D-WEB`/`D-D0a`
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev:
@@ -0,0 +1,54 @@
# D-WEB · Website-Screens + Brand-Tokens
| | |
|---|---|
| **Typ** | Screen (Design) |
| **Owner** | David |
| **Phase** | Website (kein Phasen-Brief — globaler Brand-/Web-Layer; Quelle = Snapshot-DoD) |
| **Cycle/Fenster** | W1 — Fundament & Identität · 2026-06-16 → fällig 2026-06-16 |
| **Status** | geplant |
> ℹ️ **Kein Designer-Phasen-Brief:** Dieses Ticket sitzt nicht auf einem `PXX.md`, sondern liefert die **Marketing-Website-Screens + die Brand-/Design-Tokens** für Web **und** App. Quellen sind der Snapshot-DoD, `SCREEN-MAP.md` (Website) und das `HANDOUT-DAVID.md` (Website). Die Tokens müssen mit `D-D0a` (App-Tokens) konsistent gehalten werden.
## Abhängigkeiten & Parallelität
- **Blocked by:** — (Fundament, kein Vorgänger; sehr früh fällig)
- **Blockt:** `J-STRUKTUR` (Website-Aufbau durch Dejan), `H-PITCH` (nutzt Tokens)
- **Läuft parallel zu:** `D-D0a` (App-Shell + App-Tokens, gleiche W1) — Brand-Tokens müssen Web + App teilen
- **Bedient (Dev/Website):** Website-Track (`J-*`, Dejan LIVE 17./18.06.) + alle App-Screens (gemeinsame Tokens)
- **Subframe:** Pflicht je Route (Website-Screens als Subframe-Designs).
## Was wir bauen
Die **öffentliche Marketing-Website** (Landing, Features, Pricing-Teaser, Demo-Formular) und das verbindliche **Brand-/Design-Token-Set** für Web + App (Single Source of Truth der Marke). Erster extern sichtbarer Auftritt — feiert die Website LIVE-Frist 17./18.06.
## Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
| Landing [`/`] | Hero, Value-Proposition, Social-Proof-Slots, primärer CTA (Demo/Signup) | Web-Bespoke |
| Features [`/features`] | Feature-Sektionen (CRM/Projekte/Automation/Kommunikation …), Screenshots/Illustrationen | Web-Bespoke |
| Pricing-Teaser [`/pricing`] | Abo-Baukasten-Teaser (Plan-Tiers/Module-Konnektoren), Preis-Hinweis, CTA · (volle Self-Service-Billing → v2) | Web-Bespoke |
| Demo-Formular [`/demo`] | Lead-Erfassungs-Formular (Name/Firma/Email/Telefon/Anliegen), mCaptcha → Lead-Eingang | Web-Form |
| **Brand-/Design-Tokens** [global, kein Pfad] | Farben/Typografie/Spacing/Logo-Set für **Web + App** — geteilt mit `D-D0a` | Tokens |
*(App-Shell + App-interne Tokens-Anwendung → `D-D0a`. Rechtstexte/Impressum/Datenschutz = Website-Track `J-LAW`.)*
## Features (muss abgedeckt sein)
- [ ] Landing/Features/Pricing-Teaser/Demo-Formular (extern sichtbar, Launch-Polish)
- [ ] Brand-/Design-Tokens (Web + App) als geteilte Single Source of Truth
- [ ] Demo-Formular speist Lead-Eingang (mCaptcha-Schutz)
- [ ] Tokens konsistent mit `D-D0a` (App-Shell) — kein Drift Web ↔ App
- [ ] Hell/Dunkel + Responsive (Mobile-First-Tauglichkeit der Website)
## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Hero-Sektion mit CTA; Feature-Sektions-Bausteine (Text + Bild/Illustration); Social-Proof-/Logo-Leiste; Pricing-/Abo-Baukasten-Teaser-Karten; Demo-Lead-Formular mit mCaptcha-Slot; Footer mit Rechts-Links; Navigations-Header (Web); Brand-Token-Set (Farben/Typografie/Spacing/Logo); Responsive-Varianten; Empty-/Erfolgs-/Fehler-Zustände des Demo-Formulars.
## Quellen (granular)
- Plane-Snapshot `D-WEB` → DoD: „Landing/Features/Pricing-Teaser/Demo-Formular" + „Brand-/Design-Tokens (Web + App)"
- `SCREEN-MAP.md` → Website
- `handouts/david/HANDOUT-DAVID.md` → Website
- Konsistenz-Anker: `D-D0a` (App-Tokens)
## Davids Delta (David füllt aus)
- [ ] Überschriebene/geänderte Spec-Punkte:
- [ ] Neue UI/UX-Entscheidungen:
- [ ] Subframe-Screen-Link(s):
- [ ] Offene Fragen an Dev/Website:
@@ -0,0 +1,34 @@
# EXT-02 · Mailjet Sende-Domain (SPF/DKIM/DMARC) + Warm-up
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-16 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
- Mailjet-Konto + API-Keys anlegen (Boilerplate ist bereits verdrahtet: `MAILJET_*`).
- Sende-Domain einrichten: **SPF**, **DKIM** und **DMARC** im Cloudflare-DNS (`hivegrid.de`-Zone) setzen.
- Mailjet-Auto-Probe abwarten, bis alle DNS-Einträge grün verifiziert sind.
- **Domain-Warm-up** starten — Reputation braucht Laufzeit, je früher desto besser für Zustellbarkeit.
- AD-6 (EU-Email-Provider = Mailjet) im ADR formal auf `Accepted` locken.
## Warum / was es blockt
Ohne verifizierte, aufgewärmte Sende-Domain landen Mails im Spam.
- **Blocks:** P2 (Einladungs-Mails), P14 (Marketing-Zustellbarkeit)
## Abhängigkeiten
- **blocked-by:** —
- **blocks:** P2, P14
## Definition of Done
- [x] SPF/DKIM/DMARC gesetzt & verifiziert (Mailjet-Auto-Probe grün)
- [x] Domain-Warm-up gestartet (Shared-IP, automatisch mit Volumen)
- [x] AD-6 im ADR auf `Accepted`
## Umsetzung (2026-06-16)
- Sende-Domain `hivegrid.de` bei Mailjet verifiziert — Mailjet-API `/v3/REST/dns` meldet SPFStatus + DKIMStatus = **OK**, Sender `*@hivegrid.de` aktiv. DNS live im Cloudflare-DNS (SPF `include:spf.mailjet.com`, DKIM-Selector `mailjet`, DMARC `p=none`).
- AD-6 auf `Accepted` gelockt (Mailjet als EU-Provider, MailerSend verworfen) — Commit `b5502f28`.
- Plane: Kommentar gesetzt, Ticket auf Done.
- Follow-up (nicht blockierend): MailerSend-`include` aus SPF entfernen; DMARC nach Warm-up auf `quarantine`.
@@ -0,0 +1,26 @@
# EXT-03 · Anwalt: AVV + DSGVO-Auskunft + Website-Rechtstexte
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Dejan |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-19 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
- **AVV-Vertragsvorlage** (Auftragsverarbeitung nach Art. 28 DSGVO) beim Anwalt beauftragen — Launch-Pflicht für jeden Mandanten.
- **DSGVO-Auskunfts-Vorlage** (Betroffenenrechte) erstellen lassen.
- **Impressum + Datenschutzerklärung** für die Website bereitstellen (für den Live-Gang 17./18.06.).
## Warum / was es blockt
Ohne Rechtstexte darf die Website nicht live gehen und kein Mandant kann rechtskonform onboarden.
- **Blocks:** Website-LIVE (Rechtstexte), P21 / Launch
## Abhängigkeiten
- **blocked-by:** —
- **blocks:** Website-LIVE, P21 / Launch
## Definition of Done
- [ ] AVV-Vorlage (Art. 28) beauftragt
- [ ] DSGVO-Auskunfts-Vorlage
- [ ] Impressum/Datenschutz für Website
@@ -0,0 +1,34 @@
# EXT-04 · KWP: Callback-URLs melden + bnWin.net 8.1 N3
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
- Beide **OAuth-Callback-URLs** (PKCE) an KWP melden:
- `https://app.hivegrid.de/integrations/kwp/oauth/callback`
- `https://staging-app.hivegrid.de/integrations/kwp/oauth/callback`
- **kwp-bnWin.net auf Version 8.1 N3** bei Geerkens-IT aktualisieren lassen (Voraussetzung für die offizielle KWP-API).
- KWP-Antwort-Mail in dieser Woche abwarten (Zugang verfügbar ~19.07., nach Launch).
## Warum / was es blockt
KWP ist das erste v2-Modul; die API-Anbindung in v2-P10 braucht registrierte Callback-URLs und die aktuelle bnWin.net-Version.
- **Blocks:** v2-P10 (KWP-Integration)
## Abhängigkeiten
- **blocked-by:** N-KWP (Noah / Geerkens-IT)
- **blocks:** v2-P10 (KWP-Integration)
## Definition of Done
- [x] Beide Callback-URLs an KWP gemeldet (app + staging, PKCE)
- [x] bnWin.net-Update 8.1 N3 bei Geerkens-IT angestoßen
## Umsetzung (2026-06-21, Owner Raffael)
- Mail an Noah/Geerkens-IT raus: beide OAuth-Callback-URLs (`app.` + `staging-app.hivegrid.de/integrations/kwp/oauth/callback`, Auth-Code + PKCE, Tenant im `state`) gemeldet, bnWin.net-Update auf 8.1 N3 angestoßen.
- Pfad auf `/integrations/kwp/...` aktualisiert (INTEGRATION-CONTRACTS §3, abgelöstes `/api/apps/kwp/...`).
- **Außerhalb dieses Tickets:** der eigentliche KWP-API-Zugang (Hersteller ~19.07.) + die Anbindung laufen im v2-Modul → [[VEXT-1]] / [[VR-P32a]]. KWP-Bestätigung wird dort nachgehalten.
**Status:** **DoD 2/2 erfüllt — 100 %, Done.** Beide selbst-machbaren Punkte (melden + anstoßen) erledigt. Selbst machbar offen: 0.
@@ -0,0 +1,28 @@
# EXT-05 · Noah: 4 Gate-Freitags-Slots blocken
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-16 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
- Mit Noah **4 feste Freitags-Slots** für die Gate-Demos terminieren:
- W1 (19.06.) — CRM-Vorschau
- W2 (26.06.) — CRM (Demo 1)
- W3 (03.07.) — Kern-Kette (Demo 2)
- W4 (10.07.) — Voll-Walkthrough
- Termine von Noah bestätigen lassen.
## Warum / was es blockt
Die wöchentlichen Gate-Demos sind der Fortschritts-Beweis gegenüber Noah/Geerkens; ohne fixe Slots reißt der Demo-Rhythmus.
- **Blocks:** alle Noah-Demos (19./26.06., 03./10.07.)
## Abhängigkeiten
- **blocked-by:** —
- **blocks:** alle Noah-Demos
## Definition of Done
- [ ] 4 Slots terminiert
- [ ] von Noah bestätigt
@@ -0,0 +1,42 @@
# EXT-06 · Hetzner-Projekt HiveGrid: S3+Token + DEK-Master-Key
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
- **Hetzner-Projekt `HiveGrid`** anlegen (Infra-ADR-009): S3-Object-Storage-Bucket + Token, Storage Box für Backups.
- **DEK-Master-Key** in den Coolify-Secrets hinterlegen (AD-8 revidiert: app-seitige Envelope-Encryption, kein Cloud-KMS).
- Die `SCALEWAY_*`-Env-Vars der Boilerplate auf den **Hetzner-S3-Endpoint** umziehen (S3-API ist identisch).
- Muster aus dem Infra-Repo übernehmen.
## Warum / was es blockt
Storage und Verschlüsselungs-Key sind Fundament für Datei-Uploads und Feld-Verschlüsselung; ohne sie steht das Infra-Live-Setup.
- **Blocks:** P4 (Storage), P5/P17 (DEK), AK-INFRA1 (Infra-Live)
## Abhängigkeiten
- **blocked-by:** —
- **blocks:** P4, P5/P17, AK-INFRA1
## Definition of Done
- [x] S3-Bucket + Token (Staging) — eigenes HiveGrid-Object-Storage-Projekt + Prod-Bucket = Folge
- [x] DEK-Master-Key in Coolify-Secrets (app-seitig via `CRYPTO_SECRET`, AD-8)
- [x] `SCALEWAY_*`-Env → Hetzner-Endpoint (korrigiert: generisches `STORAGE_*`)
## Umsetzung (2026-06-17)
- Staging-Bucket `hivegrid-staging-media` auf Hetzner Object Storage (fsn1) angelegt — über die bestehenden Staging-Object-Storage-Creds (geteiltes Projekt mit `mitapp-staging`). Put/List/Delete-Roundtrip grün.
- `STORAGE_*` (Endpoint/Region/Bucket/Access/Secret/`FORCE_PATH_STYLE=true`) auf web + api + worker-general/-mail/-import gesetzt (je 201). Bucket **privat** → signierte URLs.
- DEK/Verschlüsselung: `CRYPTO_SECRET` (app-seitiger AES-Master, AD-8) bereits gesetzt; kein separates DEK-Env im Katalog.
- „Scaleway→Hetzner" war ein Doc-Irrtum: Storage ist generisch `STORAGE_*`; `.env.example` auf Hetzner-Endpoint dokumentiert (Commit `b5502f28`).
- **Media-Auslieferung:** Weg B beschlossen (privater Bucket + authentifizierter App-Proxy, kein public-read) → **AD-23**, Umsetzung in P4 (`AK-P4a/b`). Kein `STORAGE_PUBLIC_BASE_URL`/CNAME für authentifizierte Medien nötig.
## Prod erledigt (2026-06-20, verifiziert)
- **Prod-Bucket `hivegrid-prod`** auf Hetzner Object Storage (fsn1, `https://fsn1.your-objectstorage.com`) — liegt im **separaten Prod-Hetzner-Account** (ADR-016, harte Account-Isolation), nicht im geteilten Staging-Projekt.
- `STORAGE_*` (Endpoint/Region/Bucket/Access-Key/Secret/`FORCE_PATH_STYLE`) auf **web + api + worker** als Build- + Runtime-Env gesetzt (Coolify-Prod).
- **Roundtrip verifiziert:** List + Put + Get + Delete grün gegen den echten Bucket (aktuell 0 Objekte, Prod frisch live). Bucket privat → signierte URLs (Weg B / AD-23).
- Creds lokal nachgetragen in `~/.cli-tokens/hivegrid-prod-services` (mode 600, nicht im Repo).
- Bucket-Name weicht vom ursprünglich geplanten `hivegrid-media` ab → real `hivegrid-prod` (im dedizierten Account konsistent zur Namens-Konvention). `media.hivegrid.de` erst relevant, falls P4 einen `public/`-Prefix für genuin öffentliche Assets braucht.
**Status:** **DoD 3/3 erfüllt — 100 %.** Staging-Bucket (17.06.) + Prod-Bucket (20.06., verifiziert) beide live, `CRYPTO_SECRET` gesetzt, Storage generisch `STORAGE_*`. Selbst machbar offen: 0. Ticket auf **Done**. Owner: Raffael.
@@ -0,0 +1,32 @@
# EXT-07 · Stripe-Konto + Live-Verifizierung
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-26 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
- **Stripe-Konto** anlegen, Geschäftsdaten + Bankkonto hinterlegen (ggf. Webseite-Anforderungen erfüllen).
- **Test-Mode** für die Entwicklung aktivieren (eigene Keys je Umgebung, Staging = Test-Mode).
- **Live-Verifizierung** einreichen — Bearbeitung dauert Tage, daher früh starten (Go-Live braucht Live-Keys).
## Warum / was es blockt
Billing/Abo-Baukasten kann ohne verifiziertes Stripe-Live-Konto nicht produktiv schalten.
- **Blocks:** P20 (Billing-Go-Live)
## Abhängigkeiten
- **blocked-by:** —
- **blocks:** P20
## Definition of Done
- [x] Test-Mode für Dev aktiv — Stripe-Konto vorhanden, Test-Keys (`sk_test`/`pk_test`/`whsec`) in Coolify-Staging (`STRIPE_SK`, `STRIPE_WEBHOOK_SIGNING_SECRET`) + lokal `~/.cli-tokens/stripe-staging-env`
- [→] Konto + Geschäftsdaten + Bankkonto — **Live-Teil ausgelagert nach [[EXT-16]]** (braucht Firmengründung)
- [→] Live-Verifizierung eingereicht — **ausgelagert nach [[EXT-16]]**
## Umsetzung (2026-06-21, Owner Raffael)
- Stripe-Test-Mode-Setup für Staging steht: Konto angelegt, Test-Keys in Coolify-Staging-Env verdrahtet (`STRIPE_SK`, `STRIPE_WEBHOOK_SIGNING_SECRET`) + lokal gesichert. Billing/Abo-Baukasten lässt sich gegen Test-Mode entwickeln.
- **Live-Aktivierung (Geschäftsdaten + Bankkonto + Verifizierung + Live-Keys) nach [[EXT-16]] ausgelagert** — erst nach HiveGrid-Firmengründung machbar.
**Status:** **Staging-Scope (Test-Mode) erfüllt — Done.** Live-Betrieb läuft als [[EXT-16]] (Backlog) weiter. Selbst machbar offen: 0.
@@ -0,0 +1,39 @@
# EXT-08 · AirCall-Konto + API + Webhooks (kein Sandbox — an P15 gekoppelt)
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | direkt vor **P15-Bau** (AK-P15a, start 2026-06-30) · fällig 2026-06-30 |
| **Status** | geplant (erst kurz vor P15 ausführen) |
## Wichtig: AirCall hat KEINE Sandbox (geprüft 2026-06-21)
Offizielle AirCall-Doku: *„Currently, Aircall does not offer a dedicated sandbox environment for testing."*
Anders als Stripe/Google/PandaDoc gibt es **kein gratis Sandbox-Testen**:
- Getestet wird im **echten/Trial-Account** mit **Test-Usern + Test-Nummern** (als „TEST" labeln, danach löschen).
- **Test-Nummern + Seats kosten ggf. Geld** → mit AirCall-Account-Manager Konditionen klären.
- AirCall-Trial = nur **7 Tage** → läuft lange vor P15 ab, wenn man jetzt auf Vorrat anlegt.
→ **Konsequenz: NICHT jetzt auf Vorrat aufsetzen.** Konto + Test-Nummern + API-Key + Webhooks **direkt vor dem
P15-Bau** (AK-P15a, ab 2026-06-30) anlegen, damit keine ungenutzten Nummern bezahlt werden.
## Was zu tun ist (kurz vor P15)
- **AirCall-Konto** (Trial oder bezahlt) anlegen; falls nötig Test-Nummer(n) buchen (kostenpflichtig).
- **API-Key** (`api_id`/`api_token`, Basic-Auth) erzeugen, in Coolify-Env (staging/prod) hinterlegen.
- **Webhooks** konfigurieren (Call-Events/Click-to-Dial) auf `staging-api`/`api`, HMAC-Signaturprüfung + Rate-Limit.
## Warum / was es blockt
Telefonie-Integration (Call-Events, Click-to-Dial) braucht API-Zugang + Webhooks.
- **Blocks:** P15 (Telefonie, **AK-P15a**)
## Abhängigkeiten
- **blocked-by:** — (aber bewusst an P15-Timing gekoppelt; kostenpflichtig, daher Just-in-time)
- **blocks:** P15 (AK-P15a)
## Definition of Done
- [ ] AirCall-Konto + (ggf. kostenpflichtige) Test-Nummer(n)
- [ ] API-Key in Coolify-Env (staging/prod)
- [ ] Webhooks konfiguriert (HMAC + Rate-Limit)
## Hinweis
„Sandbox" aus dem alten Ticket-Titel gestrichen — existiert bei AirCall nicht. Quelle: AirCall Help Center „Aircall Sandbox" + developer.aircall.io.
@@ -0,0 +1,50 @@
# EXT-09 · E-Signatur: gehärtete SES-Eigenbau (kein externer Provider)
| | |
|---|---|
| **Typ** | Architektur-Entscheidung / Setup |
| **Owner** | Raffael |
| **Cycle/Fenster** | v1 — Umsetzung in P16 (AK-P16d) |
| **Status** | In Progress |
## Entscheidung (2026-06-21) — siehe [[AD-25]]
Default = HiveGrid baut die Signatur (Angebote/Aufträge/Abnahmen) **selbst als gehärtete SES** — souverän, günstig,
rechtlich ausreichend. **PandaDoc bleibt als optionale BYOK-Anbindung** ([[EXT-17]]): Tenant mit eigenem Account
trägt seinen Key ein (Opt-in). Abweichung vom Pflichtenheft (V.4.4 nannte PandaDoc als *den* Provider) → [[AD-25]].
**Yousign/Skribble/DocuSeal fallen weg; PandaDoc nur noch als Opt-in-Adapter, nicht als Default.**
**Warum (Kurzfassung, Details in AD-25):**
- **Rechtlich:** SHK-Dokumente formfrei/Textform → SES genügt (auch Verbraucherbauvertrag §650i = Textform). Einziger QES-Pflichtfall: Bauvertragskündigung §650h (selten → EXT-17/v2).
- **Praxis:** Marktstandard = SES-Touch vor Ort + Fern-Link; alle Handwerker-Tools machen SES, kein AES/QES-Druck.
- **Souveränität:** US-Provider = CLOUD Act (bricht „100 % EU"); EU-Provider/OSS geprüft → Eigenbau gewinnt.
## Was zu bauen ist (gehärtete SES — praktisch auf AES-Beweisniveau)
1. **Touch-Signatur vor Ort** (Canvas → ins Angebots-/Abnahme-PDF) + **Fern-Link-Signatur** (remote annehmen)
2. **OTP-Identifizierung** (E-Mail; SMS als stärkere Zwei-Kanal-Option)
3. **PDF-Versiegelung** (PAdES mit HiveGrid-Organisations-Zertifikat → Änderung bricht Signatur)
4. **Zeitstempel** (TSA, RFC 3161; nicht-qualifiziert genügt)
5. **Audit-Trail** über M001 (Link/Öffnen/OTP/Signatur: wer, wann, IP, Gerät, Geo, PDF-Hash; append-only)
6. **Completion-Certificate** als PDF-Anhang (sichtbare Beweis-Doku)
7. **Einmal-Link** (personengebunden) + expliziter **„Intent to sign"**
## Architektur
- Signatur über **`defineAdapter`** (Apps-Engine, provider-agnostisch). v1-Adapter: **`ses-selfhosted`** (Default) + **`pandadoc-byok`** (optional, Tenant-Key → [[EXT-17]]).
- Spätere Stufen ohne Fachcode-Umbau: **AES** (Yousign managed oder EU-DSS-Library/Java-Sidecar self-hosted), **QES** (D-Trust sign-me, Hash-only) für § 650h.
- **Schon vorhanden** (Bausteine): Auth/Identität (P2-Kette), M001-Audit-Log, PDF-Erzeugung (P16), E-Mail (MailerSend), Datenmodell `ProjektSignatureDocument`/`Signer`.
- **Neu zu bauen:** Touch/Link-Signatur-UI (P16-Wizard), OTP-SMS, Org-Signing-Zertifikat + PAdES-Versiegelung, TSA-Anbindung, Completion-Certificate.
## Warum / was es blockt
- **Blocks:** P16 (Angebot/Signatur, AK-P16d) — dort wird die SES gebaut.
## Abhängigkeiten
- **blocked-by:** — (kein externer Account mehr nötig)
- **blocks:** P16 (AK-P16d)
## Definition of Done
- [x] Signatur-Provider-Frage entschieden: **gehärtete SES-Eigenbau, kein externer Provider** ([[AD-25]])
- [x] Modell + Architektur festgelegt (7-Punkte-Härtung, `defineAdapter`, AES/QES-Pfad offen)
- [ ] Umsetzung in P16 (AK-P16d) — Touch + Fern-Link + OTP + PAdES-Versiegelung + Audit + Completion-Cert
- [ ] (vor Go-Live) anwaltliche Bestätigung der Beweis-/Form-Einordnung (SES genügt, §650h→QES)
## Hinweis
QES-Add-on (Bauvertragskündigung §650h) ist nach [[EXT-17]] ausgelagert (v2, via D-Trust). AES nur bei Bedarf später (Adapter).
@@ -0,0 +1,53 @@
# EXT-10 · Google-Cloud OAuth + Calendar-Scope-Antrag
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-18 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
- **Google-Cloud-Projekt + OAuth-App** anlegen, Consent-Screen konfigurieren.
- **Scopes:** `calendar.events` (sensitiv, der eigentliche Zugriff) + `userinfo.email` + `openid`
(nicht-sensitiv, zur Konto-Zuordnung) — **kein** Gmail, **kein** `userinfo.profile` (Postfach-Sync → v2).
- **Modell: pro Person** (User-OAuth, jeder verbindet sein eigenes Konto, auch privates Gmail). Org-weite
Variante (Domain-wide Delegation) ist bewusst v2 → siehe [[VR-P16]].
- **Redirect-URIs** (Konvention `app.<domain>/integrations/<provider>/oauth/callback`, Tenant im OAuth-`state`):
- `https://app.hivegrid.de/integrations/google/oauth/callback`
- `https://staging-app.hivegrid.de/integrations/google/oauth/callback`
- **Lokale Dev-URI erst beim P16-Bau nachtragen:** lokal läuft die App unter `app.localhost:3000` (Subdomain,
Multi-Tenant), nicht `localhost:3000`. Google akzeptiert `*.localhost` nicht zuverlässig → voraussichtlich die
**Cloudflare-Tunnel-HTTPS-URL** registrieren (pro Dev, nutzen wir ohnehin). Google erlaubt Nachtragen jederzeit.
- **Scope-Verifizierung** bei Google beantragen (Review dauert Tage bis Wochen) — setzt eine öffentlich
erreichbare Datenschutzerklärung (`hivegrid.de/datenschutz`) voraus.
- **Testmodus-Brücke** mit Test-Usern (eigene + Geerkens-Konten) einrichten, bis die Verifizierung durch ist.
- Nach Anlage: **Client-ID + Secret** in Coolify-Prod-Env (web/api/worker) + `~/.cli-tokens/hivegrid-prod-services`.
## Warum / was es blockt
Die Google-Kalender-Integration (nur Google in v1; Outlook → v2) braucht eine verifizierte OAuth-App mit Calendar-Scope.
- **Blocks:** P16 (Kalender, nur Google)
## Abhängigkeiten
- **blocked-by:** —
- **blocks:** P16
## Definition of Done
- [x] OAuth-App + Calendar-Scope (`calendar.events` sensitiv + `userinfo.email`/`openid` zur Konto-Zuordnung)
- [→] Verifizierung beantragt — **ausgelagert nach [[EXT-15]]** (eigener Review-Zyklus, blockiert auf `hivegrid.de/datenschutz` live)
- [x] Testmodus-Brücke mit Test-Usern (eigene + Geerkens-Konten eintragbar)
## Umsetzungsstand (2026-06-21, Owner Raffael)
- Google-Cloud-Projekt `HiveGrid` + Calendar API aktiviert. OAuth-Consent (External, Test-Modus) konfiguriert.
- Scopes: `calendar.events` (vertraulich) + `userinfo.email` + `openid` (nicht-vertraulich). Kein Gmail/`profile`.
- OAuth-Client (Webanwendung) erstellt, Redirect-URIs `app.` + `staging-app.hivegrid.de/integrations/google/oauth/callback`.
- Test-User eingetragen (Brücke bis Verifizierung).
- **Client-ID + Secret** eingetragen als `GOOGLE_OAUTH_CLIENT_ID`/`_CLIENT_SECRET`/`_REDIRECT_URI`:
- **Prod-Coolify** (web/api/worker-general), `REDIRECT_URI=app.hivegrid.de/...`
- **Staging-Coolify** (web/api/worker-general), `REDIRECT_URI=staging-app.hivegrid.de/...` (gleiche Client-ID/Secret, eine Google-App deckt beide Redirect-URIs ab). Gesetzt via control:localhost:8000, da die saas-ctrl.com-CF-WAF die OAuth-Werte im API-Body blockte.
- lokal `~/.cli-tokens/hivegrid-prod-services` (mode 600).
- **Offen:** (1) Verifizierung beantragen, sobald `hivegrid.de/datenschutz` live ist; (2) lokale Dev-Redirect-URI + Code-Flow beim P16-Bau (Connector unter `/integrations/google/...`, siehe INTEGRATION-CONTRACTS §3).
**Status:** **Eigener Scope (OAuth-App-Anlage + Creds) erfüllt — DONE (Plane, 2026-06-21).** OAuth-App + Scopes + Test-User
live, Client-ID/Secret auf Prod + Staging + lokal verdrahtet. Die Verifizierung ist nach [[EXT-15]] ausgelagert
(Backlog, blockiert auf Live-Website) und kein Teil mehr von EXT-10. Selbst machbar offen: 0.
@@ -0,0 +1,32 @@
# EXT-12 · Geo-IP + HIBP prüfen/anbinden
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-19 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
- **Geo-IP-Dienst** (ipapi.is / ipstack) API-Key besorgen — bereits in der Boilerplate vorgesehen.
- **EU-Konformität** des Geo-IP-Dienstes kurz prüfen; bei Zweifel Feature stubben statt anbinden.
- **HaveIBeenPwned k-Anonymity**-Endpoint anbinden (kostenlos, kein API-Key nötig) für den Breach-Check.
## Warum / was es blockt
Session-Standortanzeige und Passwort-Breach-Check im Login/Session-Flow.
- **Blocks:** P2 (Session-Standort + Breach-Check)
## Abhängigkeiten
- **blocked-by:** —
- **blocks:** P2
## Definition of Done
- [x] Geo-IP EU-Konformität geprüft — lokale EU-Lösung statt Stub (AD-22)
- [x] HIBP k-Anonymity angebunden (war bereits implementiert)
## Umsetzung (2026-06-16 · Deploy 2026-06-17)
- **AD-22**: statt Geo-IP zu stubben → lokale Land-Auflösung via DB-IP Lite (kein externer Transfer) + IP-Pseudonymisierung (HMAC-SHA256 + Pepper), nur Land persistiert. HIBP-k-Anonymity war schon in `password-policy.server.ts` aktiv.
- Code: `modules/ipAddress/services/geoip.server.ts` (+Test), `IpAddressService` umgebaut, Config (`IP_HASH_PEPPER`/`GEOIP_DB_PATH`), `core.prisma`-Privacy-Kommentare, Dockerfile (DB-Backen), `scripts/update-geoip-db.sh`. Commits `b5502f28` (docs/AD-22) + `63704bfc` (feat).
- Proof lokal: echter DB-IP-Lookup (8.8.8.8→US, 217.0.0.1→DE, 1.1.1.1→AU, IPv6→CA, 127.0.0.1→null), `hashIp` ohne Klartext; Tests 10/10 + Auth-Konsumenten 43/43 + Config 101/101; Web-Typecheck 0; ESLint 0.
- Staging: Build/Deploy-Run **#18962 success**; `IP_HASH_PEPPER` als Secret gesetzt; GeoIP-DB im Web-Image gebacken (GET-Download funktioniert → kein Stub).
- Folge-Arbeit (in AD-22 notiert, nicht EXT-12-Scope): BullMQ-Monats-Cron, `IpAddress`-Spalten-Eindampfung, Altbestand-Backfill.
@@ -0,0 +1,26 @@
# EXT-13 · v2-Vorlauf-Externals (Gmail-Scope/Entra)
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · fällig 2026-06-29 · Gate W3 |
| **Status** | geplant |
## Was zu tun ist
- **Gmail-Restricted-Scope-Antrag** bei Google früh stellen (Wochen Vorlauf!) — für Postfach-Sync in v2.
- **Microsoft-Entra-App** für Outlook/Graph anlegen (Outlook-Kalender + Postfach-Sync → v2).
- **Kein** Google-Play- und **kein** FCM/APNs-Konto anlegen — PWA-only (AD-17), kein App-Store; Push = Web-Push (VAPID, eigene Keys selbst generieren).
## Warum / was es blockt
Diese Anträge brauchen Wochen Vorlauf, daher schon in W3 anstoßen, obwohl sie erst v2 (Postfach-Sync) bedienen.
- **Blocks:** v2 (Postfach-Sync)
## Abhängigkeiten
- **blocked-by:** —
- **blocks:** v2 (Postfach-Sync)
## Definition of Done
- [ ] Gmail-Restricted-Scope-Antrag gestellt (Wochen Vorlauf!)
- [ ] MS-Entra-App (Outlook/Graph → v2)
- [ ] Google Play + FCM/APNs entfallen bestätigt — PWA-only, Push = Web-Push (VAPID, eigene Keys)
@@ -0,0 +1,26 @@
# EXT-14 · Kostenmatrix/Preise mit Partner fixieren
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-25 · Gate W2 |
| **Status** | geplant |
## Was zu tun ist
- **Kostenmatrix** mit dem Partner durchrechnen (Infrastruktur-/Drittanbieter-Kosten je Tier).
- **Preise und Tier-Zuschnitt fixieren** für den Abo-Baukasten (Core/Swarm/Colony).
- Fixierte Preise an **Haris** (Vertrieb) übergeben — vor dem Preis-Stichtag (Preise fix bis 25.06.).
## Warum / was es blockt
Härtester Business-Blocker (TIMELINE Risiko 1): ohne fixe Preise keine Pricing-Seite, kein Payment-Link, kein SEO-Pricing.
- **Blocks:** H-FOUND, H-PAYLINK, J-SEO (Pricing-Seite)
## Abhängigkeiten
- **blocked-by:** —
- **blocks:** H-FOUND, H-PAYLINK, J-SEO
## Definition of Done
- [ ] Kostenmatrix mit Partner durchgerechnet
- [ ] Preise/Tier-Zuschnitt fixiert (Abo-Baukasten)
- [ ] an Haris übergeben
@@ -0,0 +1,36 @@
# EXT-15 · Google OAuth-App-Verifizierung (Calendar-Scope)
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | Backlog — vor breitem P16-Launch nötig, blockiert auf Website |
| **Status** | Backlog |
## Was zu tun ist
- Google-OAuth-Consent-Screen von **Test** auf **Produktion** setzen und die **App-Verifizierung** beantragen.
- **Scope-Begründung** einreichen (für `calendar.events`) — Textbaustein liegt fertig in [[EXT-10]] („Baustein A").
- Brand-Review-Voraussetzungen erfüllen: App-Logo, **verifizierte Domain** `hivegrid.de`, öffentlich erreichbare
**Datenschutzerklärung** (`hivegrid.de/datenschutz`), App-Startseite; ggf. von Google angefordertes **Demo-Video**.
- Google-Review abwarten (Tage bis wenige Wochen) und Rückfragen beantworten, bis der „unverified app"-Hinweis weg ist.
## Warum / was es blockt
`calendar.events` ist ein **sensibler** Scope. Ohne bestandene Verifizierung zeigt Google die Warnung
„Google hat diese App nicht überprüft" und limitiert auf ~100 Nutzer → kein breiter, sauberer Launch der
Kalender-Integration. Mit Verifizierung: kein Warnhinweis, unbegrenzte Nutzer.
- **Blocks:** P16 (Google-Kalender breit/produktiv nutzbar)
## Abhängigkeiten
- **blocked-by:** `hivegrid.de/datenschutz` öffentlich live (Dejan-Website) — Pflicht für die Brand-Review; [[EXT-10]] (OAuth-App + Scope müssen existieren — ✅ erledigt)
- **blocks:** P16 (Kalender für echte Kunden ohne Warnung)
## Definition of Done
- [ ] Consent-Screen auf „Produktion" gesetzt
- [ ] Verifizierung bei Google beantragt (Scope-Begründung + Datenschutz-URL + verifizierte Domain)
- [ ] Review bestanden — kein „unverified app"-Hinweis mehr, Nutzer-Limit aufgehoben
## Kontext
Ausgelagert aus [[EXT-10]] (Google-OAuth-App-Anlage), weil die Verifizierung extern an der Live-Website
(`hivegrid.de/datenschutz`) hängt und einen eigenen Review-Zyklus hat. Die OAuth-App selbst (Projekt, Scopes,
Client-ID/Secret, Test-User, Redirect-URIs `/integrations/google/oauth/callback`) ist bereits live und auf Prod +
Staging verdrahtet. Verwandt: [[VR-P16]] (Workspace-Variante, v2).
@@ -0,0 +1,35 @@
# EXT-16 · Stripe Prod / Live-Aktivierung
| | |
|---|---|
| **Typ** | Setup (External) |
| **Owner** | Raffael |
| **Cycle/Fenster** | Backlog — erst nach HiveGrid-Firmengründung machbar |
| **Status** | Backlog |
## Was zu tun ist
- **Stripe-Konto auf Live aktivieren:** Geschäftsdaten der gegründeten HiveGrid-Firma + Bankkonto hinterlegen,
ggf. Webseite-/Impressum-Anforderungen erfüllen.
- **Live-Verifizierung** bei Stripe einreichen (Bearbeitung dauert Tage → früh nach Gründung starten).
- **Live-Keys** (`sk_live_…`, `pk_live_…`, Live-`whsec_…`) auf **Prod-Coolify** (web/api/worker-general) + lokal
`~/.cli-tokens/` hinterlegen.
- **Live-Webhook-Endpoint** in Stripe registrieren (Prod-URL) + Signing-Secret setzen.
## Warum / was es blockt
Billing/Abo-Baukasten kann ohne verifiziertes Stripe-**Live**-Konto nicht produktiv schalten. Die Live-Aktivierung
verlangt echte Geschäftsdaten + Bankkonto → erst nach der Firmengründung möglich.
- **Blocks:** P20 (Billing-Go-Live)
## Abhängigkeiten
- **blocked-by:** HiveGrid-Firmengründung (Geschäftsdaten + Bankkonto); [[EXT-07]] (Stripe-Konto + Test-Mode, erledigt)
- **blocks:** P20
## Definition of Done
- [ ] Stripe-Live-Konto verifiziert (Geschäftsdaten + Bankkonto)
- [ ] Live-Keys auf Prod-Coolify (web/api/worker-general) + lokal hinterlegt
- [ ] Live-Webhook-Endpoint registriert + Signing-Secret gesetzt
## Kontext
Ausgelagert aus [[EXT-07]] (Stripe-Konto + Test-Mode für Staging, erledigt). Der Staging-/Dev-Pfad läuft im
Test-Mode (Keys in Coolify-Staging). Dieses Ticket schaltet ausschließlich den produktiven Live-Betrieb frei,
sobald die Firma gegründet ist.
@@ -0,0 +1,68 @@
# EXT-17 · PandaDoc-BYOK-Adapter (optionale Signatur-Anbindung)
| | |
|---|---|
| **Typ** | Feature / Integration (Apps-Engine-Adapter) |
| **Owner** | Raffael |
| **Cycle/Fenster** | optional zu P16 — Adapter neben dem SES-Default ([[AD-25]]) |
| **Status** | In Progress (BYOK-Beispiel wird mit Kunden-Account durchgespielt) |
## Was zu tun ist
Optionaler **`pandadoc-byok`**-Adapter (Apps-Engine, `defineAdapter`) **neben** dem SES-Eigenbau-Default ([[EXT-09]], [[AD-25]]).
Tenants mit eigenem PandaDoc-Account tragen ihren **eigenen API-Key** ein; HiveGrid erstellt/sendet Angebots-Dokumente
über *deren* Account und holt den Signatur-Status zurück. CLOUD-Act-/DSGVO-Verantwortung liegt durch das Opt-in beim Tenant.
## Anbindungs-Spec (recherchiert 2026-06-21)
**Base-URL:** `https://api.pandadoc.com/public/v1` · **Auth-Header:** `Authorization: API-Key <key>` (NICHT `Bearer`).
| Schritt | Endpoint | Notiz |
|---|---|---|
| Dokument aus PDF | `POST /documents?upload` (multipart: `file` + `data`) | PDF max 50 MB; Feld-Positionen via **Field-Tags** im PDF (`[signature:kunde]`, `[textfield:kunde:angebotsnr___]`) oder `parse_form_fields:true` |
| (alt.) aus Template | `POST /documents` (JSON: `name`,`template_uuid`,`recipients`,`tokens`,`fields`) | |
| Verarbeitung abwarten | Status `uploaded` → `draft` (~3-5 s) | per Webhook `document_state_changed` statt pollen |
| Senden | `POST /documents/{id}/send` | nur aus `draft`; Status → `sent`→`viewed`→`completed` |
| Status (Pull) | `GET /documents/{id}` | bis 600 req/min |
| Webhook (Push) | `POST /webhook-subscriptions` (`url`,`triggers`,`payload:[metadata]`,`shared_key`) | Events: `document_state_changed`, `document_completed_pdf_ready`, `recipient_completed` |
| Signiertes PDF | `GET /documents/{id}/download-protected` | rechtsverbindlich versiegelt; **nur Production-Key** (Sandbox→401) |
**Webhook-Verifizierung:** HMAC-**SHA256** über den **rohen Body** mit dem Subscription-**Shared-Key**; Signatur kommt als Query-Param `?signature=…` → timing-safe vergleichen.
## BYOK / Multi-Tenant
- **Tenant richtet ein:** Dev Center → API-Key generieren (stabiler User!); Production-API braucht **Enterprise-Plan + Sales-Approval**, Sandbox geht ab Business/Dev-Center.
- **Adapter speichert pro Tenant:** API-Key (Sandbox+Prod, DEK-verschlüsselt im Credential-Store/`core.prisma`), Webhook-Subscription-ID + Shared-Key, Env-Flag (Sandbox/Prod), Mapping `pandadoc_document_id ↔ {tenant, projekt_id, angebot_id}`.
- **Tenant-Zuordnung der Webhooks:** pro-Tenant-URL (`…/webhooks/pandadoc/{tenantId}`) **+** `metadata.hivegrid_tenant_id`/`projekt_id` am Dokument (kommt im Payload zurück, wenn `payload:[metadata]` abonniert).
- **Rate-Limits:** Prod 60 req/min (endpoint-spezifisch höher), **Sandbox nur 10 req/min** → Backoff bei 429.
## Offene Punkte (beim Bau verifizieren)
- Kommt der `shared_key` in der Create-Subscription-Response zurück (→ vollautomatisches Provisioning) oder nur aus dem Dashboard? (entscheidet, ob der Tenant manuell kopieren muss)
- Exaktes `data`-Schema beim Multipart-Upload gegen offizielles SDK/Postman gegenchecken.
- Production-Approval-Vorlauf im Adapter-UI als Voraussetzung kommunizieren.
## Warum / was es blockt
- **Blocks:** P16 (AK-P16d) — optionaler Adapter; Default bleibt SES.
## Abhängigkeiten
- **blocked-by:** Tenant mit eigenem PandaDoc-Account + API-Key (für BYOK-Durchlauf: Kunden-Sandbox-Key)
- **blocks:** P16 (AK-P16d, optionaler Pfad)
## POC-Ergebnis (2026-06-21, Geerkens-Sandbox-Key)
End-to-end gegen die echte PandaDoc-Sandbox durchgespielt + validiert:
- ✅ **Auth** (`Authorization: API-Key`), **Create-from-PDF**, **Draft**-Übergang, **Tags**.
- ✅ **Metadata-Mandanten-Trennung**: `hivegrid_tenant_id`/`projekt_id` kommen am Dokument zurück → BYOK-Tenant-Zuordnung funktioniert.
- ✅ **Send**: an org-interne Adresse (`entwicklung@geerkens.de`) → `document.sent`, **Mail kam beim Empfänger an**.
**Account-bedingte Befunde (kein Code-Problem, aber wichtig für den Adapter):**
- **Send nur org-intern** in der Sandbox → 403 „send outside organization" (Account-Policy; in Prod erlaubt der Tenant externen Versand ohnehin, sonst könnte er keine Kunden anschreiben).
- **PDF-Field-Tags werden nicht geparst** (Empfänger fällt auf CC, `fields: 0`) — Geerkens' Account ist **Template-basiert**. → **Der `pandadoc-byok`-Adapter sollte für PandaDoc den Template-Weg nutzen** (`template_uuid` + `fields`/`tokens`), nicht PDF-Field-Tags.
- Test-Dokumente nach dem Durchlauf wieder gelöscht (Account sauber).
## Definition of Done
- [x] Anbindungs-Spec recherchiert + dokumentiert (Auth, Create, Send, Webhook, Download, BYOK)
- [x] BYOK-Beispiel mit echtem Kunden-Account (Geerkens-Sandbox) durchgespielt — Auth → Create → Draft → Metadata → Send → Mail ✅
- [→] `pandadoc-byok`-Adapter bauen → **P16 / [[AK-P16d]]** (Dev-Arbeit, Template-Weg; Credential-Store, Webhook-Verify HMAC-SHA256)
- [→] Tenant-Settings-UI „PandaDoc verbinden" → **P16 / [[AK-P16d]]**
**Status:** **Externals-/Vorarbeits-Scope erfüllt — abschlussreif (Done).** Spec dokumentiert + BYOK real validiert (POC oben). Der eigentliche Adapter-Bau + UI sind P16-Dev-Arbeit ([[AK-P16d]], Spec dort verlinkt). Selbst als Externals offen: 0.
## Quellen
developers.pandadoc.com: [Auth](https://developers.pandadoc.com/reference/api-key-authentication-process) · [Create from Upload](https://developers.pandadoc.com/reference/create-document-from-upload) · [Field-Tags](https://developers.pandadoc.com/docs/field-tags) · [Send](https://developers.pandadoc.com/reference/send-document) · [Webhooks](https://developers.pandadoc.com/docs/webhook-events) · [Webhook-Verify](https://developers.pandadoc.com/docs/webhook-verification) · [Download-protected](https://developers.pandadoc.com/reference/download-protected-document) · [Limits](https://developers.pandadoc.com/reference/limits)
@@ -0,0 +1,23 @@
# H-CALLS · Erste Discovery-Calls
| | |
|---|---|
| **Typ** | Vertrieb |
| **Owner** | Haris |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-26 · Gate W2 |
| **Status** | geplant |
## Was zu tun ist
Ab Di 23.06. täglich Discovery-/Qualifizierungs-Calls mit der Zielkundenliste führen. Abfragen: Painpoints, **KWP-Nutzung (ja/nein/Version)**, Team-Größe, aktuelle Tools. Noch **keine Live-Demo** (Produkt im Bau) — Screens + Pitch reichen. Notizen strukturiert ins Lead-Sheet. Markt-Feedback (Einwände, fehlende Features, Preis-Reaktionen) laufend an Raffael.
## Warum / Ziel
Pipeline qualifizieren und vorbereiten, damit ab dem 25.06. (Preise stehen) sofort verkauft werden kann. Liefert zugleich Produkt-/Preis-Feedback an die Entwicklung.
## Abhängigkeiten
- **Blocked by:** `H-LISTE` (Zielkundenliste), `H-PITCH` (Pitch + Skript)
- **Blocks:** `H-FOUND` (Founding-Member-Angebot)
## Definition of Done
- [ ] Tägliche Discovery-Calls laufen
- [ ] Je Lead: Pain, KWP-Nutzung, Team-Größe, Tools strukturiert im Lead-Sheet erfasst
- [ ] Markt-Feedback laufend an Raffael
@@ -0,0 +1,23 @@
# H-DEMO · Klick-Demos + echte Produkt-Demos
| | |
|---|---|
| **Typ** | Vertrieb |
| **Owner** | Haris (Demo-Tenant von Akeshan) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · fällig 2026-07-03 · Gate W3 |
| **Status** | geplant |
## Was zu tun ist
Zwei Stufen: Ab **30.06.** Klick-Demos auf dem Demo-1-Stand (CRM, Stand der Noah-Demo) für den Founding-Deal-Abschluss. Ab **03.07.** echte Produkt-Demos, sobald die Kern-Kette **Lead → Sales → Auftrag** E2E läuft. Demo-Tenant auf Staging kommt von Akeshan. Demo-Termine bewusst nach den Gate-Freitagen ansetzen (dann ist mehr sichtbar).
## Warum / Ziel
Demos sind der Conversion-Hebel vom qualifizierten Lead zum zahlenden Kunden. Die echte E2E-Demo macht das Produktversprechen greifbar.
## Abhängigkeiten
- **Blocked by:** `AK-DEMO1` (Demo-Tenant auf Staging)
- **Blocks:** `H-FOLLOW` (Trial-Follow-ups + Bilanz)
## Definition of Done
- [ ] Klick-Demos (Demo-1-Stand) ab 30.06. einsatzbereit
- [ ] Echte Produkt-Demos (Kette Lead → Sales → Auftrag E2E) ab 03.07.
- [ ] Demo-Tenant auf Staging genutzt
@@ -0,0 +1,23 @@
# H-FOLLOW · Trial-Follow-ups + Bilanz
| | |
|---|---|
| **Typ** | Vertrieb |
| **Owner** | Haris (Onboarding-Liste an Raffael) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-10 · Gate W4 |
| **Status** | geplant |
## Was zu tun ist
Conversion-Endspurt bis 31.07.: Ab Fr 24.07. Trial-Follow-ups (14 Tage nach den Launch-Onboardings) führen und Richtung Kauf konvertieren. Onboarding-Liste (wer hat gekauft, braucht ein Abo im Admin) an Raffael. Am 31.07. Bilanz ziehen: Founding-Deals + Onboardings + Trial-Konversionen = **erste Gelder**.
## Warum / Ziel
Trials werden nur durch aktives Nachfassen zu Zahlern. Die Bilanz macht das Kern-Ziel "erste Gelder bis Ende Juli" messbar.
## Abhängigkeiten
- **Blocked by:** `H-DEMO` (Demos/Onboardings als Grundlage)
- **Blocks:** —
## Definition of Done
- [ ] Trial-Follow-ups geführt (14 Tage nach Onboarding)
- [ ] Onboarding-Liste der Käufer an Raffael (Abo-Anlage im Admin)
- [ ] Bilanz gezogen: erste Gelder bestätigt
@@ -0,0 +1,23 @@
# H-FOUND · Founding-Member-Angebot strukturieren
| | |
|---|---|
| **Typ** | Vertrieb |
| **Owner** | Haris (Abnahme Noah; Preise von Raffael) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-26 · Gate W2 |
| **Status** | geplant |
## Was zu tun ist
Sobald die Preise aus Raffaels Partner-Gespräch vorliegen (25.06.), das Founding-Member-Angebot strukturieren: **Early-Bird-Jahresdeal mit begrenzten Plätzen**. Konditionen, Leistungsumfang (v1-Scope ehrlich), Laufzeit und Verknappung sauber formulieren und von Noah abnehmen lassen. Vorlage für den Stripe Payment Link (`H-PAYLINK`).
## Warum / Ziel
Der Founding-Deal ermöglicht Geld **vor** dem Launch. Der 25.06. (Preise) ist der härteste Abhängigkeits-Termin — vorher nur qualifizieren, danach abschließen.
## Abhängigkeiten
- **Blocked by:** `H-CALLS` (qualifizierte Pipeline), `EXT-14` (Preise/Stripe-Setup-Vorbereitung)
- **Blocks:** `H-PAYLINK` (Payment Link)
## Definition of Done
- [ ] Early-Bird-Jahresdeal strukturiert (Konditionen, begrenzte Plätze, Laufzeit)
- [ ] Leistungsumfang ehrlich am v1-Scope (keine v2-Versprechen)
- [ ] Von Noah abgenommen
@@ -0,0 +1,23 @@
# H-INBOUND · Lead-Sheet + Inbound-Prozess (<24h)
| | |
|---|---|
| **Typ** | Vertrieb |
| **Owner** | Haris (mit Dejan für Routing) |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-19 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
Sobald die Website live ist (17./18.06.), ein Lead-Sheet aufsetzen und den Inbound-Prozess definieren: jede Website-Anfrage landet sofort bei Haris, Erst-Antwort in **unter 24 Stunden**. Benachrichtigungs-Routing mit Dejan testen. Übergangslösung, bis die HiveGrid-Lead-Inbox steht — dann Umstieg aufs eigene Produkt (Dogfooding).
## Warum / Ziel
Kein eingehender Lead darf verloren gehen oder kalt werden. Schnelle Reaktion ist der wichtigste Conversion-Hebel in der Frühphase.
## Abhängigkeiten
- **Blocked by:** `J-LIVE` (Website live von Dejan)
- **Blocks:** —
## Definition of Done
- [ ] Lead-Sheet aufgesetzt
- [ ] Benachrichtigungs-Routing mit Dejan getestet (Anfrage landet sofort bei Haris)
- [ ] Prozess steht: jede Anfrage < 24h beantwortet
@@ -0,0 +1,23 @@
# H-LISTE · Zielkundenliste SHK (KWP-Nutzer-Fokus)
| | |
|---|---|
| **Typ** | Vertrieb |
| **Owner** | Haris |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
SHK-Zielkundenliste aufbauen — **A-Leads = KWP-Nutzer** (denn der KWP-Sync-USP zieht ab Ende Juli genau bei diesen Betrieben). Pro Eintrag: Betrieb, Ansprechpartner, Team-Größe, eingesetzte Tools/CRM, KWP-Nutzung (ja/nein/Version), Kontaktkanal. Liste füttert die Discovery-Calls (`H-CALLS`) ab dem 23.06.
## Warum / Ziel
Ohne qualifizierte Pipeline kein Abschluss. Die Liste ist der Rohstoff für alle Calls und für den Founding-Member-Verkauf. KWP-Nutzer werden bewusst priorisiert, weil sie das Alleinstellungsmerkmal bekommen, das kein Wettbewerber bietet.
## Abhängigkeiten
- **Blocked by:** —
- **Blocks:** `H-CALLS` (Discovery-Calls brauchen die Liste)
## Definition of Done
- [ ] SHK-Zielkundenliste angelegt, Fokus KWP-Nutzer (A-Leads markiert)
- [ ] Je Eintrag: Betrieb, Ansprechpartner, Team-Größe, Tools/CRM, KWP-Nutzung, Kontaktkanal
- [ ] Liste bereit für Discovery-Calls (`H-CALLS`)
@@ -0,0 +1,22 @@
# H-PAIN · Painpoint-Gespräch mit Noah
| | |
|---|---|
| **Typ** | Vertrieb |
| **Owner** | Haris (mit Noah) |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
Exklusiv-Gespräch mit Noah (erster Kunde aus der Praxis) über die SHK-Alltags-Painpoints: Zettelwirtschaft, HubSpot-Frust, Doppelerfassung, Monteur-Kommunikation. Erkenntnisse strukturiert festhalten — sie sind der Rohstoff für Website-Texte (`H-TXT`) und Pitch (`H-PITCH`).
## Warum / Ziel
Echte Praxis-Painpoints statt Marketing-Floskeln. Nur so treffen Website und Pitch den Nerv der Zielgruppe. Noah ist zugleich die Abnahme-Instanz für jeden Außen-Text.
## Abhängigkeiten
- **Blocked by:** `EXT-05`
- **Blocks:** `H-TXT` (Website-Texte), `H-PITCH` (Pitch-Deck)
## Definition of Done
- [ ] Exklusiv-Gespräch mit Noah zu SHK-Painpoints geführt (Zettelwirtschaft/HubSpot/Doppelerfassung/Monteur-Komm.)
- [ ] Erkenntnisse strukturiert dokumentiert als Basis für Texte + Pitch
@@ -0,0 +1,23 @@
# H-PAYLINK · Stripe Payment Link (Founding-Deal)
| | |
|---|---|
| **Typ** | Vertrieb |
| **Owner** | Haris (Stripe-Link von Raffael) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-26 · Gate W2 |
| **Status** | geplant |
## Was zu tun ist
Den Stripe Payment Link für den Founding-Deal (von Raffael bereitgestellt, 26.06.) in den Verkaufsprozess einbinden: Link auf das abgenommene Angebot (`H-FOUND`) abstimmen, testen und so bereitstellen, dass ein Interessent ab Mo 30.06. direkt bezahlen kann — **Geld fließt vor dem Launch**.
## Warum / Ziel
Der Payment Link ist der konkrete Kassenknopf für den Founding-Deal. Ohne ihn keine Zahlung vor Launch — das Kern-Ziel "erste Gelder so früh wie möglich".
## Abhängigkeiten
- **Blocked by:** `EXT-07` (Stripe-Setup), `EXT-14` (Preise/Produkt-Anlage)
- **Blocks:** `H-DEMO` (Klick-Demos + Abschluss)
## Definition of Done
- [ ] Founding-Deal-Payment-Link live und getestet
- [ ] Link auf das von Noah abgenommene Angebot abgestimmt
- [ ] Zahlung VOR Launch möglich (ab 30.06.)
@@ -0,0 +1,23 @@
# H-PITCH · Pitch-Deck + Gesprächsskript
| | |
|---|---|
| **Typ** | Vertrieb |
| **Owner** | Haris (Abnahme Noah; Screens von David) |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-19 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
Pitch-Deck bauen — mit Davids D0-/Auth-Screens bestückt — und ein Gesprächsskript für die Discovery-Calls schreiben. Beides von Noah abnehmen lassen. Skript deckt Einstieg, Painpoint-Aufhänger, Nutzen, Einwand-Behandlung und nächsten Schritt ab.
## Warum / Ziel
Pitch-Deck + Skript sind das Verkaufswerkzeug für die ersten Calls ab 23.06. Solange das Produkt im Bau ist, ersetzen Screens + Pitch die Live-Demo.
## Abhängigkeiten
- **Blocked by:** `D-D0a` (D0-/Auth-Screens von David)
- **Blocks:** `H-CALLS` (Discovery-Calls)
## Definition of Done
- [ ] Pitch-Deck mit D0-/Auth-Screens fertig
- [ ] Gesprächsskript für Discovery/Qualifizierung geschrieben
- [ ] Beides von Noah abgenommen
@@ -0,0 +1,24 @@
# H-TXT · Website-Texte schreiben
| | |
|---|---|
| **Typ** | Vertrieb |
| **Owner** | Haris (Abnahme Noah, Übergabe Dejan) |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
Aus den Painpoints (`H-PAIN`) die Website-Texte schreiben: Landing-Headline, Nutzenversprechen, Feature-Beschreibungen. Von Noah abnehmen lassen und früh an Dejan übergeben, damit er sie einbaut (Website geht 17./18.06. live). Ehrlich verkaufen: nichts versprechen, was nicht in v1 ist — KWP-Sync/Portal/Postfach-Sync/Mobile-PWA-Ausbau sind "kommt im August".
## Warum / Ziel
Die Website ist der erste Inbound-Kanal. Treffende, von Noah abgenommene Texte entscheiden, ob SHK-Betriebe konvertieren. Termin ist hart, weil Dejan die Texte Montag früh zum Einbau braucht.
## Abhängigkeiten
- **Blocked by:** `H-PAIN`, `N-PAIN`
- **Blocks:** `N-TXTABN` (Text-Abnahme Noah), `J-CONTENT` (Dejan/Website-Content)
## Definition of Done
- [ ] Headline, Nutzenversprechen und Feature-Texte geschrieben
- [ ] Von Noah abgenommen (kein Außen-Text ohne Abnahme)
- [ ] Keine v1-fremden Versprechen (KWP-Sync etc. als "ab August" formuliert)
- [ ] Texte an Dejan übergeben
@@ -0,0 +1,23 @@
# H-WEBINAR · Webinar-Einladungen + Moderation
| | |
|---|---|
| **Typ** | Vertrieb |
| **Owner** | Haris (Landing von Dejan, Live-Demo Raffael) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-10 · Gate W4 |
| **Status** | geplant |
## Was zu tun ist
Ab Mo 06.07. Webinar-Einladungen rausschicken (mit Dejan; Webinar-Landing von Dejan). **Kleine Liste** — die Mail-Domain ist erst ~3 Wochen gewärmt, bei Masse droht Spam-Einstufung. Webinar-Inhalt (Agenda, Folien) bis 02.07. an Dejan. Am 14./15.07. Webinar Nr. 1 moderieren — Raffael macht die Live-Demo, Haris führt durchs Gespräch und sammelt Trial-/Kauf-Conversions.
## Warum / Ziel
Das Webinar ist der skalierbare Conversion-Kanal nach dem Launch (10.07.). Bewusst klein gehalten, um die Domain-Reputation nicht zu verbrennen.
## Abhängigkeiten
- **Blocked by:** `J-WEBINAR` (Webinar-Landing von Dejan)
- **Blocks:** —
## Definition of Done
- [ ] Einladungen raus (kleine Liste — Spam-Risiko beachtet)
- [ ] Webinar-Inhalt (Agenda/Folien) an Dejan
- [ ] Webinar Nr. 1 moderiert (14./15.07.)
@@ -0,0 +1,24 @@
# J-CONTENT · Content/Texte einbauen
| | |
|---|---|
| Typ | Website |
| Owner | Dejan |
| Cycle/Fenster | W1 — Fundament & Identität · 2026-06-17 → fällig 2026-06-17 |
| Status | geplant |
## Was zu tun ist
- Texte (von Haris erstellt, von Noah abgenommen) in die Seitenstruktur einpflegen.
- EU-konforme Webinar-Plattform auswählen.
## Warum / Ziel
Die Website bekommt ihre finalen Inhalte. Ohne abgenommene Texte kein freigabefähiger LIVE-Stand.
## Abhängigkeiten
- Blocked by: J-STRUKTUR, H-TXT (Texte Haris), N-TXTABN (Text-Abnahme Noah)
- Blockt: J-LIVE
- Quelle: HANDOUT-DEJAN.md — AP-1
## Definition of Done
- [ ] Texte (Haris, Noah-abgenommen) eingepflegt
- [ ] Webinar-Plattform gewählt (EU-konform)
@@ -0,0 +1,24 @@
# J-LAUNCHUPD · Launch-Update Website
| | |
|---|---|
| Typ | Website |
| Owner | Dejan |
| Cycle/Fenster | W4 — USP, Härtung & Launch · 2026-07-06 → fällig 2026-07-10 |
| Status | geplant |
## Was zu tun ist
- Finale Feature-Seiten und Pricing live stellen.
- Launch-Ankündigung veröffentlichen.
## Warum / Ziel
Website-seitiger Abschluss des v1-Launch: vollständige Feature-Darstellung, finale Preise und öffentliche Launch-Kommunikation.
## Abhängigkeiten
- Blocked by: J-LIVE, J-SEO
- Blockt: —
- Quelle: HANDOUT-DEJAN.md — AP-4
## Definition of Done
- [ ] finale Feature-Seiten + Pricing live
- [ ] Launch-Ankündigung veröffentlicht
@@ -0,0 +1,22 @@
# J-LAW · Rechtstexte einbauen (Anwalt)
| | |
|---|---|
| Typ | Website |
| Owner | Dejan |
| Cycle/Fenster | W1 — Fundament & Identität · 2026-06-17 → fällig 2026-06-18 |
| Status | geplant |
## Was zu tun ist
- Vom Anwalt gelieferte Rechtstexte einbauen: Impressum, Datenschutz, AVV-Link.
## Warum / Ziel
Rechtssicherer LIVE-Gang. Ohne Impressum/Datenschutz darf die Website nicht öffentlich gehen.
## Abhängigkeiten
- Blocked by: EXT-03 (Rechtstexte vom Anwalt)
- Blockt: J-LIVE
- Quelle: EXTERNALS-CHECKLISTE.md — E6
## Definition of Done
- [ ] Impressum/Datenschutz/AVV-Link eingebaut
@@ -0,0 +1,24 @@
# J-LIVE · WEBSITE LIVE
| | |
|---|---|
| Typ | Website |
| Owner | Dejan |
| Cycle/Fenster | W1 — Fundament & Identität · 2026-06-18 → fällig 2026-06-18 |
| Status | geplant |
## Was zu tun ist
- Website live schalten auf hivegrid.de.
- EU-konformes Analytics einrichten + Search Console anbinden.
## Warum / Ziel
Erster öffentlich sichtbarer Auftritt von HiveGrid. Fixer LIVE-Termin 17./18.06. — eröffnet den Inbound-Kanal (H-INBOUND).
## Abhängigkeiten
- Blocked by: J-QA, J-LAW
- Blockt: H-INBOUND
- Quelle: TIMELINE.md (Dejan / LIVE 17./18.), HANDOUT-DEJAN.md — AP-1
## Definition of Done
- [ ] live auf hivegrid.de
- [ ] EU-konformes Analytics + Search Console aktiv
@@ -0,0 +1,24 @@
# J-QA · QA + Lead-Routing-Test
| | |
|---|---|
| Typ | Website |
| Owner | Dejan |
| Cycle/Fenster | W1 — Fundament & Identität · 2026-06-17 → fällig 2026-06-18 |
| Status | geplant |
## Was zu tun ist
- Responsive QA über alle Seiten und Breakpoints.
- Demo-Formular testen: Lead-Routing an Haris funktioniert end-to-end.
## Warum / Ziel
Qualitätssicherung vor LIVE. Defekte Darstellung oder verlorene Leads beim Launch sind nicht akzeptabel.
## Abhängigkeiten
- Blocked by: J-CONTENT
- Blockt: J-LIVE
- Quelle: HANDOUT-DEJAN.md — AP-1
## Definition of Done
- [ ] responsive QA durchgeführt
- [ ] Formular → Lead-Routing an Haris getestet
@@ -0,0 +1,25 @@
# J-SEO · SEO + Conversion + Pricing-Seite vorbereiten
| | |
|---|---|
| Typ | Website |
| Owner | Dejan |
| Cycle/Fenster | W2 — Plattform & CRM (Demo 1) · 2026-06-20 → fällig 2026-06-26 |
| Status | geplant |
## Was zu tun ist
- SEO-Basics setzen (Meta, Sitemap, strukturierte Daten, Performance).
- Conversion-Feinschliff der bestehenden Seiten.
- Pricing-Seite vorbereiten (Preise fix 25.06.) inkl. Founding-Sektion und Payment-Link.
## Warum / Ziel
Nach LIVE die Auffindbarkeit und Conversion verbessern und die Pricing-Seite startklar machen, damit ab 25.06. Preise und erste Zahlungen laufen können.
## Abhängigkeiten
- Blocked by: J-LIVE
- Blockt: —
- Quelle: HANDOUT-DEJAN.md — AP-2
## Definition of Done
- [ ] SEO-Basics + Conversion-Feinschliff umgesetzt
- [ ] Pricing-Seite vorbereitet (Preise 25.06.) + Founding-Sektion + Payment-Link
@@ -0,0 +1,25 @@
# J-SETUP · Domain/Hosting/Stack + Setup
| | |
|---|---|
| Typ | Website |
| Owner | Dejan |
| Cycle/Fenster | W1 — Fundament & Identität · 2026-06-16 → fällig 2026-06-16 |
| Status | geplant |
## Was zu tun ist
- Stack, Hosting und Domain (hivegrid.de) klären und einrichten.
- Repo-Setup für die Marketing-Website (separates Repo) anlegen.
- Erstes Seitengerüst aufbauen, auf dem die Folge-Tickets bauen.
## Warum / Ziel
Fundament für die Website. Ohne lauffähigen Stack und Repo kann Davids Design (J-STRUKTUR) nicht eingebaut werden und der LIVE-Termin 17./18.06. ist nicht zu halten.
## Abhängigkeiten
- Blocked by: — (Fundament, kein Vorgänger)
- Blockt: J-STRUKTUR
- Quelle: HANDOUT-DEJAN.md — AP-1
## Definition of Done
- [ ] Stack/Hosting/Domain geklärt
- [ ] Repo-Setup + Seitengerüst steht
@@ -0,0 +1,24 @@
# J-STRUKTUR · Seitenstruktur + Davids Screens einbauen
| | |
|---|---|
| Typ | Website |
| Owner | Dejan |
| Cycle/Fenster | W1 — Fundament & Identität · 2026-06-16 → fällig 2026-06-17 |
| Status | geplant |
## Was zu tun ist
- Seitenstruktur anlegen: Landing, Features, Pricing-Teaser, Demo-Formular, Webinar-Warteliste.
- Davids Designs (D-WEB) als Screens umsetzen — Brand-/Design-Tokens übernehmen.
## Warum / Ziel
Die Website bekommt ihr Gerüst und ihren markenkonformen Auftritt. Grundlage für Content (J-CONTENT) und letztlich den LIVE-Gang.
## Abhängigkeiten
- Blocked by: J-SETUP, D-WEB (Davids Website-Screens + Brand-Tokens)
- Blockt: J-CONTENT
- Quelle: HANDOUT-DEJAN.md — AP-1
## Definition of Done
- [ ] Seitenstruktur (Landing/Features/Pricing-Teaser/Demo-Formular/Webinar-Warteliste) steht
- [ ] Davids Designs umgesetzt
@@ -0,0 +1,24 @@
# J-WEBINAR · Webinar-Landing + Anmelde-Flow
| | |
|---|---|
| Typ | Website |
| Owner | Dejan |
| Cycle/Fenster | W3 — Kern-Kette & Kommunikation (Demo 2) · 2026-06-29 → fällig 2026-07-03 |
| Status | geplant |
## Was zu tun ist
- Webinar-Landingpage mit Anmelde-Flow bauen.
- Bestätigungs- und Erinnerungs-Mails einrichten.
## Warum / Ziel
Anmeldungen für das Webinar (14./15.07.) sammeln und Teilnehmer zuverlässig erinnern. Speist die Vertriebs-/Webinar-Aktivität (H-WEBINAR).
## Abhängigkeiten
- Blocked by: J-LIVE
- Blockt: H-WEBINAR
- Quelle: HANDOUT-DEJAN.md — AP-3
## Definition of Done
- [ ] Landing + Anmelde-Flow live
- [ ] Bestätigungs-/Erinnerungs-Mails aktiv
@@ -0,0 +1,24 @@
# J-WEBTECH · Webinar-Technik (Plattform/Aufzeichnung)
| | |
|---|---|
| Typ | Website |
| Owner | Dejan |
| Cycle/Fenster | W4 — USP, Härtung & Launch · 2026-07-04 → fällig 2026-07-10 |
| Status | geplant |
## Was zu tun ist
- Webinar-Plattform aufsetzen (Livestorm/Zoom) und Generalprobe durchführen.
- Aufzeichnung einrichten + Follow-up-Seite bauen (Webinar 14./15.07.).
## Warum / Ziel
Technisch reibungsloser Webinar-Ablauf und nachträgliche Verwertung über Aufzeichnung/Follow-up.
## Abhängigkeiten
- Blocked by: J-WEBINAR
- Blockt: —
- Quelle: HANDOUT-DEJAN.md — AP-5
## Definition of Done
- [ ] Plattform-Setup (Livestorm/Zoom) + Generalprobe erledigt
- [ ] Aufzeichnung + Follow-up-Seite live (Webinar 14./15.07.)
@@ -0,0 +1,22 @@
# N-DATEN · SHK-Beispieldaten liefern
| | |
|---|---|
| **Typ** | Noah-Zulieferung |
| **Owner** | Dejan/Haris (Noah liefert zu) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-26 · Gate W2 |
| **Status** | geplant |
## Was zu tun ist
Noah liefert aufbereitete **echte Geerkens-SHK-Beispieldaten** als Grundlage für die Demo-Seeds: echte Pipelines, Custom-Felder und Rollen (Kontakte/Organisationen, Leads, Projekte in Sales- und Auftrags-Pipeline). Diese Daten werden von Akeshan (AK-DEMO1) als SHK-Seeds in den Demo-Tenant eingespielt.
## Warum / Ziel
Demo 1 (Gate W2) braucht einen realistischen, klickbaren CRM-Stand mit echten SHK-Strukturen — generische Dummy-Daten überzeugen weder Noah noch den Vertrieb. Die gelieferten Pipelines/Felder/Rollen definieren zugleich die echte SHK-Konfiguration. Diese Zulieferung entblockt AK-DEMO1 (Demo-Tenant + Seeds).
## Abhängigkeiten
- **Blocked by:** —
- **Blocks:** AK-DEMO1 (Demo-Tenant + SHK-Seeds)
- Quellen: EXTERNALS-CHECKLISTE.md (E3), HANDOUT-NOAH.md (Daten)
## Definition of Done
- [ ] echte Pipelines + Custom-Felder + Rollen geliefert (für Seeds)
@@ -0,0 +1,22 @@
# N-DEMO1 · Demo 1 abnehmen (CRM klickbar)
| | |
|---|---|
| **Typ** | Noah-Zulieferung |
| **Owner** | Dejan/Haris (Noah liefert zu) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-26 · Gate W2 |
| **Status** | geplant |
## Was zu tun ist
Noah nimmt im Gate-W2-Termin (Fr 26.06.) die **Demo 1** ab: Der klickbare CRM-Stand auf dem Demo-Tenant wird mit der Geerkens-Praxisbrille durchgegangen und validiert (Kontakte, Leads, Pipelines, Aktivitäten). Gate-Abnahme = Demo 1.
## Warum / Ziel
Demo 1 ist das erste Wochen-Gate und der Beweis, dass das CRM mit echten SHK-Daten praxistauglich und klickbar ist. Nur die Abnahme durch den Erstkunden bestätigt, dass die Plattform-/CRM-Grundlage trägt, bevor in W3 die E2E-Kette folgt.
## Abhängigkeiten
- **Blocked by:** AK-DEMO1 (Demo-Tenant + Seeds), R-P7, D-CRM, N-SLOTS
- **Blocks:** —
- Quellen: TIMELINE.md (Gate W2 / Demo 1)
## Definition of Done
- [ ] CRM klickbar validiert (Geerkens-Praxisbrille)
@@ -0,0 +1,22 @@
# N-DEMO2 · Demo 2 abnehmen (Kette E2E)
| | |
|---|---|
| **Typ** | Noah-Zulieferung |
| **Owner** | Dejan/Haris (Noah liefert zu) |
| **Cycle/Fenster** | W3 — Kern-Kette & Kommunikation (Demo 2) · fällig 2026-07-03 · Gate W3 |
| **Status** | geplant |
## Was zu tun ist
Noah nimmt im Gate-W3-Termin (Fr 03.07.) die **Demo 2** ab: die durchgängige Kern-Kette **Lead → Sales → Auftrag** wird End-to-End auf dem System durchgespielt und mit der Geerkens-Praxisbrille validiert. Gate-Abnahme = Demo 2.
## Warum / Ziel
Demo 2 ist das zweite Wochen-Gate und beweist, dass die zentrale Wertschöpfungskette (Lead bis Auftrag) nicht nur einzelne Screens, sondern den vollständigen Durchlauf abdeckt. Diese E2E-Abnahme ist Voraussetzung für die Launch-Entscheidung in W4.
## Abhängigkeiten
- **Blocked by:** R-P9b, N-SLOTS
- **Blocks:** —
- Quellen: TIMELINE.md (Gate W3 / Demo 2)
## Definition of Done
- [ ] Kette Lead→Sales→Auftrag E2E validiert
@@ -0,0 +1,25 @@
# N-GONOGO · Voll-Walkthrough + Go/No-Go
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** `blocked-by R-P13` **entfernt** (R-P13 gelöscht — kein KI-Layer in v1; HiveGrid wird MCP-Server, [[VR-MCP]]). Neues letztes v1-Code-Glied von Raffaels Kern-Kette ist **R-P12b**. Blocked-by bleibt **AK-P21, N-SLOTS**.
| | |
|---|---|
| **Typ** | Noah-Zulieferung |
| **Owner** | Dejan/Haris (Noah liefert zu) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · fällig 2026-07-10 · Gate W4 |
| **Status** | geplant |
## Was zu tun ist
Noah führt im Gate-W4-Termin (Fr 10.07.) einen **Voll-Walkthrough** durch das gesamte v1-System durch und trifft mit dem Team die **Go/No-Go-Entscheidung** für den Big-Bang-Launch.
## Warum / Ziel
Das W4-Gate ist die finale Freigabe-Instanz vor dem Launch. Nur ein vollständiger Walkthrough mit dem Erstkunden klärt, ob v1 launchreif ist (Go) oder ob nachgebessert werden muss (No-Go). Die Entscheidung gibt den Big-Bang-Launch frei.
## Abhängigkeiten
- **Blocked by:** ~~R-P13~~ (entfällt — [[AD-26]]), AK-P21, N-SLOTS
- **Blocks:** [LAUNCH]
- Quellen: TIMELINE.md (Gate W4 / Launch)
## Definition of Done
- [ ] Voll-Walkthrough durchgeführt
- [ ] Go/No-Go-Entscheidung zum Big-Bang-Launch getroffen
@@ -0,0 +1,23 @@
# N-KWP · KWP-Mail freigeben + bnWin.net 8.1 N3 anstoßen
| | |
|---|---|
| **Typ** | Noah-Zulieferung |
| **Owner** | Dejan/Haris (Noah liefert zu) |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
Noah gibt bei Geerkens die ausstehende KWP-Mail-Antwort frei bzw. leitet sie weiter und stößt parallel das bnWin.net-Update auf Version **8.1 N3** bei der Geerkens-IT an. Beides läuft über Noah als Kontaktperson; Dejan/Haris koordinieren die Rückmeldung.
## Warum / Ziel
Die KWP-API-Anbindung (erstes v2-Modul) setzt voraus, dass die Geerkens-Instanz auf bnWin.net 8.1 N3 läuft und die offizielle API-Freigabe vorliegt. Ohne diese Vorklärung ist die v2-KWP-Verprobung (VN-1/VN-2) nicht möglich. Diese Zulieferung entblockt den externen API-Pfad (EXT-04).
## Abhängigkeiten
- **Blocked by:** —
- **Blocks:** EXT-04 (externer KWP-API-Zugang)
- Quellen: EXTERNALS-CHECKLISTE.md (A1), HANDOUT-NOAH.md (KWP)
## Definition of Done
- [ ] KWP-Mail-Antwort freigegeben/weitergeleitet
- [ ] bnWin.net-Update 8.1 N3 bei Geerkens-IT angestoßen
@@ -0,0 +1,22 @@
# N-LAGER · Lagerist-Frage beantworten (M070-Scope)
| | |
|---|---|
| **Typ** | Noah-Zulieferung |
| **Owner** | Dejan/Haris (Noah liefert zu) |
| **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-26 · Gate W2 |
| **Status** | geplant |
## Was zu tun ist
Noah beantwortet die Scope-Frage zu M070: Gehört ein dedizierter **Lagerist-Arbeitsplatz** zum Validierungs-Versprechen gegenüber Geerkens? Die Antwort entscheidet, ob M070 in v1 ausgedünnt oder voll umgesetzt wird.
## Warum / Ziel
M070 ist ein Kandidat für die Scope-Dünnung. Ob der Lagerist-Arbeitsplatz Teil des zugesagten Funktionsumfangs ist, kann nur der Erstkunde beantworten — die Antwort steuert die Priorisierung im engen 4-Wochen-Fenster.
## Abhängigkeiten
- **Blocked by:** —
- **Blocks:** — (entscheidet M070-Dünnung)
- Quellen: EXTERNALS-CHECKLISTE.md (E2)
## Definition of Done
- [ ] Antwort geklärt: gehört Lagerist-Arbeitsplatz zum Validierungs-Versprechen? (entscheidet M070-Dünnung)
@@ -0,0 +1,22 @@
# N-PAIN · Painpoint-Input liefern (mit Haris)
| | |
|---|---|
| **Typ** | Noah-Zulieferung |
| **Owner** | Dejan/Haris (Noah liefert zu) |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
Noah liefert im Gespräch mit Haris die konkreten **SHK-Alltag-Painpoints** aus der Geerkens-Praxis (Tagesablauf, wiederkehrende Reibungspunkte, manuelle Workarounds), die als Grundlage für die Außen-Texte und die Produktargumentation dienen.
## Warum / Ziel
Echte Painpoints aus dem SHK-Betrieb sind die Substanz für glaubwürdige Website-Texte und Vertriebsargumente. Ohne diesen Input bleibt die Außendarstellung generisch. Diese Zulieferung entblockt H-TXT (Website-Texte).
## Abhängigkeiten
- **Blocked by:** —
- **Blocks:** H-TXT (Website-Texte)
- Quellen: HANDOUT-NOAH.md (Painpoint)
## Definition of Done
- [ ] SHK-Alltag-Painpoints im Gespräch geliefert
@@ -0,0 +1,22 @@
# N-SLOTS · 4 Gate-Freitags-Slots bestätigen
| | |
|---|---|
| **Typ** | Noah-Zulieferung |
| **Owner** | Dejan/Haris (Noah liefert zu) |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-16 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
Noah bestätigt verbindlich die vier Gate-Freitags-Termine bei Geerkens: **19.06.**, **26.06.**, **03.07.** und **10.07.** Diese Slots sind die festen Termine für die Demo- und Go/No-Go-Abnahmen über die vier Wochen.
## Warum / Ziel
Die vier Wochen-Gates (Demo 1, Demo 2, Go/No-Go-Launch) hängen an festen Abnahmeterminen mit Noah. Ohne bestätigte Slots lassen sich die Gate-Abnahmen nicht planen. Diese Zulieferung entblockt N-DEMO1, N-DEMO2 und N-GONOGO.
## Abhängigkeiten
- **Blocked by:** EXT-05
- **Blocks:** N-DEMO1, N-DEMO2, N-GONOGO
- Quellen: HANDOUT-NOAH.md (Slots)
## Definition of Done
- [ ] Slots 19./26.06. + 03./10.07. bestätigt
@@ -0,0 +1,22 @@
# N-TXTABN · Website-Texte abnehmen
| | |
|---|---|
| **Typ** | Noah-Zulieferung |
| **Owner** | Dejan/Haris (Noah liefert zu) |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Was zu tun ist
Noah nimmt die fertig getexteten **Website-/Außen-Texte** (aus H-TXT, gespeist von N-PAIN) ab. Alle nach außen sichtbaren Texte gehen final über Noah — er gibt sie frei oder fordert Korrekturen an.
## Warum / Ziel
Die Website geht am 17./18.06. live; alle Außen-Texte müssen vorher fachlich und vom Erstkunden abgenommen sein. Noah ist die SHK-Praxisbrille und finale Freigabeinstanz für alle externen Texte. Diese Zulieferung entblockt J-CONTENT (Content-Einpflege).
## Abhängigkeiten
- **Blocked by:** H-TXT (Website-Texte)
- **Blocks:** J-CONTENT
- Quellen: HANDOUT-NOAH.md (Abnahme)
## Definition of Done
- [ ] Website-Texte abgenommen (alle Außen-Texte = Noah)
@@ -0,0 +1,56 @@
# R-P11a · P11 Globale Suche (Meilisearch, Cmd+K)
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Die pgvector-`embedding`-Spalte und der `EmbeddingProviderJob` **ruhen** (RAG entfällt — HiveGrid hostet kein Embedding/LLM mehr, sondern wird MCP-Server, [[VR-MCP]]). v1 bleibt **unverändert reine Meilisearch-Keyword-Suche**; die früher als „v2-Andock-Halter" geführten Embedding-Teile werden in v2 **nicht** befüllt.
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P11 — Globale Suche & Dashboard |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-03 → 2026-07-04 · Gate W4 |
| **Status** | geplant |
> 🟢 **Kein Pivot-Sonderfall** (P11 ist nicht Teil der projekt-zentrischen Kern-Kette). Aber: Der Such-Index greift auf den **`Projekt`-Kern** zu — in der M24-Spec stehen `deal | project | order` als Typen; im Pivot-Modell ist das **EIN `Projekt`-Entity-Typ** (Pipeline-Typ = View, kein separater Index-Typ je Pipeline). v1 = **Meilisearch-Keyword-Suche**; ~~pgvector/Hybrid → v2 (AD-5 sequenziert) — embedding-Spalte/EmbeddingProviderJob sind nur Andock-Halter.~~ → **pgvector/Hybrid ruht ([[AD-26]]: RAG entfällt); embedding-Spalte/EmbeddingProviderJob bleiben ungenutzt.**
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P9b` (Kern-Kette abgeschlossen — Projekt/Sub-Areas indexierbar), `AK-INFRA2` (Meilisearch zentral bereitgestellt)
- **Blocks:** `R-P11b` (Dashboard danach)
- **Sequenz (Raffaels Kern-Kette):** nach abgeschlossener Kern-Kette (P6–P9). P11/P12/P13 folgen sequenziell.
- **Läuft parallel zu:** Akeshans Module W4 (`AK-P20`/`AK-P21` Billing/DSGVO u.a.). Schema-Trennung nach **AD-21**.
## Was wir bauen
Eine **permission-aware Keyword-Suche** über alle Entitäten via **Meilisearch** (SearchAdapter pro Modul, Outbox-Index-Updates), bedienbar per **Cmd+K-Modal** (global, debounced, gruppierte Treffer, Match-Highlight, RecentSearches) und als **Vollbild-Such-View** mit Filtern. Server-side Permission-Filter sorgt dafür, dass nie Treffer durchsickern.
## Benötigte Screens (Backend bedient — Design liefert `D-DASH`-Paket)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Cmd+K-Such-Modal [global] | Auto-Fokus + Live-Suche (300 ms debounce); Treffer **gruppiert nach Entity-Typ** (Icon/Titel/Subtitle/Match-Highlight/relative letzte Aktivität); Entity-Typ-Filter-Chips (Multi-Select); Tastatur-Navigation (↑↓/Enter/Cmd+Enter/Esc) + Shortcut-Anzeige; Leer-Zustand: **RecentSearches** + Tipps; „Alle {n} Treffer zeigen" → Vollbild |
| Vollbild-Such-View [`/search`] | Such-Feld (URL-Param), volle Trefferliste (cursor-paginiert 50/Page) mit Metadaten; **Filter-Sidebar** (Entity-Typ/Erstellt-Range/Verantwortlicher/Tags/modul-spezifisch + Archiviert-Toggle); Trefferanzahl-Klartext; Sortierung (Relevanz/Letzte Aktivität/Erstellt) |
## Definition of Done
- [ ] **Meilisearch-Keyword-Suche permission-aware** über **SearchAdapter** (Modul-Registrierung: Kontakt/Firma/Lead/**Projekt**/File/Task/User); ~~pgvector/Hybrid → v2~~ → ruht ([[AD-26]])
- [ ] Entity-Mutationen aktualisieren den Index über **Outbox-Index-Pattern**; `SearchIndexEntry` + `RecentSearch` befüllt (5–10 s Index-Latenz mit Klartext-Hinweis)
- [ ] **Cmd+K-Modal** (global Hotkey, debounced, gruppierte Treffer, Match-Highlight, Tastatur-Navigation, RecentSearches) + Wechsel in **Vollbild-Such-View** mit Filtern
- [ ] **Server-side Permission-Filter** (nie durchsickern; Trefferanzahl = erlaubte Treffer; Klartext „weitere Treffer, die du nicht siehst")
- [ ] Konnektor `tenantHasModule('search')` (Suche gated)
- [ ] Permissions: `search.use`/`search.admin` (Suche leichtgewichtig — Sichtbarkeit über Modul-Permissions)
## Technische Bausteine
- **Entities** (eigene `prisma/schema/search.prisma`): `SearchIndexEntry` (entity_type/id, title, body_text, tsvector_de, **~~embedding [pgvector → v2-Andock-Halter]~~ → ruht, ungenutzt ([[AD-26]])**, permission_subject, is_archived), `RecentSearch` (query_text/applied_filters/result_count), ~~`EmbeddingProviderJob` (async, Inhalt v2)~~ → ruht ([[AD-26]]). Modul-`.prisma`s nur über polymorphe Referenz (AD-21).
- **RLS** auf SearchIndexEntry/RecentSearch (AD-1); Permission-Filter zusätzlich server-seitig via `permission_subject` vor Meilisearch-Query.
- **Outbox-Pattern:** Entity-Mutation → Outbox-Event → Index-Job (SearchAdapter pro Modul) → Meilisearch upsert/delete.
- **SearchAdapter-Interface** (INTEGRATION-CONTRACTS §8) je Modul registriert.
- **Konnektor** `tenantHasModule('search')` gated.
- `is_demo_data`-Flag respektiert (Demo-Treffer bei Echt-Start-Bereinigung entfernt).
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 6: Suche & Dashboard** (SearchIndexEntry/RecentSearch/EmbeddingProviderJob) — Hinweis: ein `Projekt`-Entity-Typ statt deal/project/order
- `REQUIREMENTS.md` → `REQ-suche-datenmodell`, `REQ-suche-hybrid` (Meilisearch/SearchAdapter), `REQ-suche-ui` (Phase 11)
- `ROADMAP.md` → Phase 11 · `PHASE-SOURCES.md` → P11
- `designer-briefs/P11-suche-dashboard.md` (Cmd+K BESPOKE; kein Pivot-Sonderfall, aber Projekt-Kern-Hinweis)
- `_bmad-output/specs/M24-globale-suche.md` (⚠ Entity-Typen deal/project/order → im Pivot EIN Projekt-Typ; pgvector → v2)
## Dev-Nachzug (nach Davids `D-DASH`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P11a` aktualisiert
@@ -0,0 +1,55 @@
# R-P11b · P11 Dashboard (3 Rollen-Layouts)
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Die **„KI"-Widget-Quelle entfällt** aus dem Widget-Katalog (kein LLM/KI-Layer in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]). Die **Widget-Registry bleibt** voll gebaut und erweiterbar; nur die KI-Widgets fallen weg.
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P11 — Globale Suche & Dashboard |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-04 → 2026-07-05 · Gate W4 |
| **Status** | geplant |
> 🟢 **Kein Pivot-Sonderfall.** Aber: Dashboard-Widgets greifen auf den **`Projekt`-Kern** zu (nicht getrennte Deal-/Project-Entitäten). **v1 = nur 3 feste Rollen-Layouts (GF/Büro/Monteur) ohne Drag&Drop** (Scope-Schnitt 12.06.; User-Layout-Persistenz + Custom-Widgets + Export → v2). Die **Widget-Registry wird voll gebaut** (Inversion M064→M147).
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P11a` (Suche/Index), `R-P8b` (Sales-Aggregate für Widgets)
- **Blocks:** `R-P12a` (Automation danach)
- **Sequenz (Raffaels Kern-Kette):** sequenziell nach P11a (`R-P11a → R-P11b → R-P12a …`).
- **Läuft parallel zu:** Akeshans Module W4. Schema-Trennung nach **AD-21**.
## Was wir bauen
**3 feste Rollen-Dashboards** (GF/Büro/Monteur, SHK-Default geseedet) aus einem **Widget-Katalog** (Sales/Projekte/Tasks/HR/~~KI~~ (entfällt [[AD-26]])/Activity/Comms), **live aktualisiert** (SSE/WebSocket, Aggregat-Cache). Edit in v1 = nur Widget-Filter/Zeitraum (kein Drag&Drop-Grid).
## Benötigte Screens (Backend bedient — Design liefert `D-DASH`-Paket)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Dashboard [`/dashboard` bzw. `/`] | **3 feste Rollen-Layouts (kein Drag&Drop v1):** **GF** (Begrüßung, Sales-KPIs, Umsatz-Forecast, 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; **Live-Update** (SSE/WebSocket) + „Live-Updates pausieren"; Edit = **nur Widget-Filter/Zeitraum**; „Daten zuletzt aktualisiert vor X Min" |
| Dashboard-Switcher [im Header] | Verfügbare Dashboards (rollen-gematcht) + Default-Routing nach Rolle |
## Definition of Done
- [ ] **3 feste Rollen-Layouts** (GF/Büro/Monteur, SHK-Default **geseedet**) aus Widget-Katalog
- [ ] **Widgets** aus Sales/Projekte/Tasks/HR/~~KI~~ (entfällt [[AD-26]])/Activity/Comms; **Widget-Registry voll gebaut** (Custom-Widgets/Drag&Drop → v2)
- [ ] **Live-Update** (WebSocket/SSE) mit **Aggregat-Cache** + Lazy-Load/Skeleton; Widgets permission-gegated (Quellen-Modul-Permission); Monteur-Dashboard mobile-first
- [ ] Dashboard-Switcher + rollenbasiertes Default-Routing
- [ ] Konnektor `tenantHasModule('dashboard')` (Dashboard gated)
- [ ] Permissions: `dashboard.read/customize` (v1: nur Filter/Zeitraum; Drag&Drop-Customize → v2)
## Technische Bausteine
- **Entities** (eigene `prisma/schema/dashboard.prisma`): `Dashboard` (name, is_default_for_role gf/office/monteur, is_shared), `DashboardLayout` (dashboard_id, user_id NULL=shared, widgets[], layout_data — 3 feste Rollen-Layouts v1), `WidgetInstance` (widget_catalog_key, config, position, size — Custom/Drag&Drop v2). Aggregat-Cache auf Quell-Module über deren `.prisma` nur lesend (AD-21).
- **RLS** auf Dashboard/Layout/Widget (AD-1); Widget-Daten zusätzlich über Quellen-Modul-Permission gegated.
- **Live-Update:** SSE/WebSocket-Push bei Aggregat-Änderung; Aggregat-Cache (aus R-P8b für Sales) wiederverwendet.
- **Konnektor** `tenantHasModule('dashboard')` gated.
- `is_demo_data`-Flag auf SHK-Default-Layouts/Demo-Widgets.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 6: Suche & Dashboard** (Dashboard/DashboardLayout/WidgetInstance) — Projekt-Kern als Widget-Quelle
- `REQUIREMENTS.md` → `REQ-dashboard-datenmodell` (3 feste Rollen-Layouts), `REQ-dashboard-widgets` (Phase 11)
- `ROADMAP.md` → Phase 11 · `PHASE-SOURCES.md` → P11
- `designer-briefs/P11-suche-dashboard.md` (3 Rollen-Layouts, kein Drag&Drop v1)
- `_bmad-output/specs/M20-dashboard.md` (⚠ 7 Rollen-Dashboards → v1 nur 3; Drag&Drop/Custom-Widgets → v2)
## Dev-Nachzug (nach Davids `D-DASH`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P11b` aktualisiert
@@ -0,0 +1,59 @@
# R-P12a · P12 Automation-Engine + Trigger/Action-Registry + Guards
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P12 — Automation-Engine (USP-Säule 1) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-06 → 2026-07-07 · Gate W4 |
| **Status** | geplant |
> 🟢 **Kein Pivot-Sonderfall** (P12 ist USP, nicht Teil der projekt-zentrischen Kern-Kette) — aber Trigger/Actions arbeiten auf dem `Projekt`-Kern. 🟡 **v1-Grenze:** KWP-Push-Action ist nur ein **erweiterbarer Registry-Eintrag** (zieht mit v2 nach) — kein KWP-Konfig-UI in v1.
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P11b` (Dashboard fertig — Automation baut auf vollem Modul-Set auf)
- **Blocks:** `R-P12b` (Flow-Editor verbraucht Engine + Registry) ~~, `R-P13` (KI-Actions docken an)~~ → **R-P13 entfällt ([[AD-26]]: KI→MCP)**
- **Sequenz (Raffaels Kern-Kette):** sequenziell (`R-P11b → R-P12a → R-P12b`) ~~`→ R-P13`~~ — **R-P12b ist Ketten-Ende ([[AD-26]]).**
- **Läuft parallel zu:** Akeshans Module W4. Schema-Trennung nach **AD-21**.
## Was wir bauen
Den **Engine-Unterbau** der ersten USP-Säule: eine **vollständige Trigger-Library** (CRM, Lead, Sales, Projekte, Email, Forms, Booking, Kalender, Zeit, Webhooks) und eine **erweiterbare Action-Library** (CRM, Notification, HTTP, Task, If/Else, Delay, Loop; KWP-Push + KI-Actions docken nach), plus die **Schutz-Mechanismen** (Loop-Guard, Rate-Limit, Idempotenz, Metering, Resume). Flows sind als JSON-Graph persistiert. Der visuelle Editor folgt in P12b.
## Benötigte Screens (Backend bedient — Design liefert `D-FLOW` + `D-P12`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Automation-Liste [`/automations`] | Name, Trigger, Status (aktiv/pausiert/Entwurf), Läufe (30d), letzte Ausführung, „nur meine"-Filter |
| Execution-Liste [`/automations/:id/executions`] | Letzte N Läufe, Filter (Status/Datum/Trigger-Typ), Klick → Detail |
| Execution-Detail [`/automations/:id/executions/:exec_id`] | `summary_text`, Trigger-Payload user-lesbar, **Step-by-Step-Verlauf mit Klartext je Schritt** (Status/Input/Output/Dauer), Dry-Run-Marker, **24h-Rückgängig-Button mit Restzeit**, Manuell-Retry, Resume-ab-Schritt |
| Loop-/Rate-Schutz-Warnmodal | Schleifen-Erkennung mit **Abhängigkeits-Graph-Visualisierung** + „Beheben"; Anomalie-Pause-Hinweis Klartext (z.B. „2.000-mal in 5 Min, typisch 5-10/Tag — pausiert") |
*(Trigger-/Action-Library = Daten im Knoten-Katalog, kein eigener Screen. Flow-Editor selbst → R-P12b.)*
## Definition of Done
- [ ] **Vollständige Trigger-Library** über alle Module (CRM, Lead, Sales, Projekte, Email, Forms, Booking, Kalender, Zeit, Webhook) im Knoten-Katalog gruppiert
- [ ] **Erweiterbare Action-Library** (CRM, Notification, HTTP, Task, If/Else, Delay, Loop) + Registry — **KWP-Push + KI-Actions docken später an** (kein v1-Konfig-UI)
- [ ] **Schutz:** Loop-Guard (Abhängigkeits-Graph-Warnung), Rate-Limit + Anomalie-Pause, Idempotenz-Key, **Trigger-Volumen-Metering pro Tenant**, Resume-ab-Schritt mit Auto-Retry
- [ ] Klartext-Diagnostik in allen Execution-Logs (Step-Status, Dauer, Input/Output)
- [ ] Datenmodell persistiert: **`AutomationRule`/`AutomationRuleStep`/`AutomationExecution`/`AutomationStepExecution`** (+ Credential/Template)
- [ ] Plattform- + Tenant-Templates mit Katalog und „aus Rule erstellen" (Backend)
- [ ] Konnektor `tenantHasModule('automation')` (Engine/Routes/Actions gated)
## Technische Bausteine
- **Entities** (eigene `prisma/schema/automation.prisma`): `AutomationRule` (name, flow_data JSON, enabled, created_via), `AutomationRuleStep` (step_kind trigger|condition|action|flow_control, node_type, config, parent_step_ids[] — Graph-Knoten), `AutomationExecution` (trigger_payload, status, dry_run, idempotency_key, **reverse_window_expires_at**), `AutomationStepExecution` (input/output, summary_text), `AutomationCredential` (**[verschlüsselt]**), `AutomationTemplate` (flow_data, category, is_published — SHK-Vorlagen). Andere Modul-`.prisma`s nur über Trigger/Action-Adapter (AD-21).
- **RLS** auf Rule/Execution/Template (AD-1); `[Soft-Delete]` auf Rule; **`AutomationCredential` AES-verschlüsselt**.
- **Trigger-Bus:** Modul-Events (z.B. `lead.qualified`, `deal.won`) → Trigger-Matching → Execution; **Idempotenz-Key** verhindert Doppel-Läufe.
- **Loop-Guard/Rate-Limit/Metering** server-seitig; Anomalie-Pause bei Spike (Klartext-Notification).
- **Konnektor** `tenantHasModule('automation')` gated.
- `is_demo_data`-Flag auf SHK-Templates/Demo-Rules.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 7: Automation & KI** (AutomationRule/RuleStep/Execution/StepExecution/Credential/Template)
- `REQUIREMENTS.md` → `REQ-automation-datenmodell`, `REQ-automation-trigger-library`, `REQ-automation-action-library`, `REQ-automation-schutz` (Phase 12)
- `ROADMAP.md` → Phase 12 · `PHASE-SOURCES.md` → P12
- `designer-briefs/P12-automation-engine.md` (Flow-Editor BESPOKE — schwerste UI; v1-Grenze KWP-Push)
- `_bmad-output/specs/M17-automation-engine.md`
## Dev-Nachzug (nach Davids `D-FLOW`/`D-P12`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P12a` aktualisiert
@@ -0,0 +1,61 @@
# R-P12b · P12 Visueller Flow-Editor + Dry-Run + 24h-Undo ~~+ Sprach-Andock~~
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Der „Sprach-zu-Automation"-/KI-Andock **entfällt** (kein LLM in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]). R-P12b ist ein **reiner visueller Flow-Editor** (Graph + Dry-Run + 24h-Undo + Templates). Das `blocks: R-P13` entfällt (R-P13 gelöscht) → R-P12b ist das **neue letzte v1-Glied** der Kern-Kette. Alle Sprach-/KI-Stellen unten sind durchgestrichen.
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P12 — Automation-Engine (USP-Säule 1) |
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-07 → 2026-07-08 · Gate W4 |
| **Status** | geplant |
> 🔴 **Schwerste UI der App (AD-16, ab 22.06. täglich 1h).** Der visuelle Flow-/Node-Editor ist die erste USP-Säule und vollständig **bespoke**. Klartext-First überall (Knoten-Labels, Dry-Run-Ausgaben, Loop-/Rate-Warnungen, Logs in verständlichem Deutsch). ~~🟡 Sprach-zu-Automation rendert hier den Flow-Vorschlag — die KI-Pipeline selbst liegt in P13 (R-P13 liefert das Gateway dahinter).~~ → **entfällt ([[AD-26]]).**
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P12a` (Engine + Trigger/Action-Registry + Guards), `D-FLOW` (Flow-Editor-Design)
- **Blocks:** ~~`R-P13` (KI-Layer / Sprach-zu-Automation-Gateway)~~ → **entfällt ([[AD-26]]: R-P13 gelöscht); R-P12b ist letztes v1-Glied.**
- **Sequenz (Raffaels Kern-Kette):** sequenziell (`R-P12a → R-P12b`) ~~`→ R-P13`~~ — **R-P12b ist das Ketten-Ende ([[AD-26]]).**
- **Läuft parallel zu:** Akeshans Module W4. Schema-Trennung nach **AD-21**.
## Was wir bauen
Den **visuellen Graph-/Node-Editor** über der Engine aus P12a: Knoten aus Trigger/Action-Library hinzufügen/konfigurieren/löschen/duplizieren, Kanten, Auto-Layout, Undo/Redo, Mini-Map, Klartext-Validation. Dazu **Dry-Run** (Klartext-Wirkungsvorschau + Pflicht-Bestätigung ab Schwelle) und **24h-Reverse-Window**. ~~und den **Sprach-zu-Automation-Andock** (Satz → Flow-Vorschlag, **nie Auto-Aktivierung**)~~ → **Sprach-Andock entfällt ([[AD-26]]).**
## Benötigte Screens (Backend bedient — Design liefert `D-FLOW` + `D-P12`, Editor BESPOKE)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Flow-/Node-Editor [`/automations/:id/edit`] | Graph-Canvas (Knoten + Kanten); Knoten-Katalog-Sidebar (filterbar nach Modul-Quelle, Drag/Klick); Knoten-Konfig-Panel mit **Klartext-Label**; Mini-Map; Toolbar (Zoom/Pan/Undo/Redo/Zentrieren/Auto-Layout); inline Validation (unverbunden/Cycle/fehlendes Pflichtfeld); Save/Aktivieren/Deaktivieren; **Dry-Run-Auslöser** |
| ~~Sprach-zu-Automation-Einstieg [im Editor]~~ → **entfällt ([[AD-26]])** | ~~Text-/Spracheingabe; Live-Streaming-Antwort; KI-Flow-Vorschau im Canvas + Klartext-Beschreibung; Rückfragen bei Mehrdeutigkeit; Risiko-Hinweise; Bestätigungs-/Anpassungs-Schritt (nie Auto-Aktivierung!); Beispiel-Prompts~~ |
| Dry-Run-Vorschau [Modal im Editor] | „Trifft X Datensätze" + erste 5 Beispiele; Schritt-für-Schritt-Simulation Klartext je Step; **Bestätigungs-Pflicht** ab >100 Datensätzen/Schritt (Schwelle tenant-konfigurierbar) |
| Template-Katalog [`/automations/templates`] | SHK- + Tenant-Vorlagen nach Kategorie; je Template Beschreibung/Use-Case/Nutzungs-Anzahl; „Verwenden" + „Eigenes Template aus Rule anlegen" |
## Definition of Done
- [ ] **Graph-Editor** aus Trigger/Action-Library: Knoten hinzufügen/konfigurieren/löschen/duplizieren, Kanten erstellen/löschen, verschieben, **Auto-Layout, Undo/Redo, Mini-Map**
- [ ] **Klartext-Knoten-Labels** + Klartext-Validation (unverbunden, Cycle, unvollständig)
- [ ] **Dry-Run-Vorschau** (Klartext-Wirkungsvorschau, getroffene Datensätze + Beispiele) + **Bestätigungs-Pflicht ab Schwelle**
- [ ] **24h-Undo-Fenster:** angelegte Entitäten löschen / Status zurücksetzen / Tags rückgängig, Mail-Empfängerliste anzeigen (nicht zurückziehbar), Multi-Step-Confirm + Audit
- [ ] ~~**Sprach-zu-Automation-Andock:** Satz → Flow-Vorschlag mit Rückfragen/Existenz-Prüfung/Risiko-Hinweisen, **Bestätigungs-Pflicht (Action-Boundary, nie Auto-Aktivierung)** — KI-Pipeline = R-P13~~ → **entfällt ([[AD-26]]: kein LLM in v1)**
- [ ] Template-Katalog mit „aus Rule erstellen"
- [ ] Konnektor `tenantHasModule('automation')` (Editor/Routes gated)
## Technische Bausteine
- **Erweitert `prisma/schema/automation.prisma`** (keine neuen Kern-Entities — Editor persistiert `flow_data` JSON + `AutomationRuleStep`-Graph aus R-P12a; Template-CRUD).
- **Graph-Persistenz:** Flow als JSON-Graph (`AutomationRule.flow_data`) + normalisierte Steps; serverseitige Cycle-/Vollständigkeits-Validation gespiegelt zur Client-Validation.
- **Dry-Run:** Simulations-Lauf ohne Seiteneffekte; Schwelle (>100/Schritt, tenant-konfigurierbar) → Confirm-Phrase.
- **24h-Reverse-Window:** `AutomationExecution.reverse_window_expires_at` (aus R-P12a) + Reverse-Aktionen (delete/revert/untag) mit Audit (Domäne 2).
- ~~**Sprach-Andock:** Editor ruft KI-Gateway (R-P13) → `GeneratedObject` Flow-Vorschlag → Canvas-Render; **kein Auto-Aktivieren**.~~ → **entfällt ([[AD-26]]: kein KI-Gateway/GeneratedObject).**
- **RLS** durchgängig (AD-1).
- **Konnektor** `tenantHasModule('automation')` gated.
- `is_demo_data`-Flag auf Demo-Flows/SHK-Templates.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 7: Automation** (AutomationRule.flow_data/RuleStep-Graph/Execution.reverse_window) — ~~GeneratedObject~~ entfällt ([[AD-26]])
- `REQUIREMENTS.md` → `REQ-automation-flow-editor` (Graph-Editor ~~+ KI-Sprache~~ → KI-Sprache entfällt [[AD-26]] + Dry-Run + 24h-Undo), `REQ-automation-schutz` (Phase 12)
- `ROADMAP.md` → Phase 12 · `PHASE-SOURCES.md` → P12
- `designer-briefs/P12-automation-engine.md` (Flow-Editor BESPOKE — schwerste UI; ~~Sprach-Vorschlag rendert hier, KI-Pipeline P13~~ → Sprach-Andock entfällt [[AD-26]])
- `_bmad-output/specs/M17-automation-engine.md`
## Dev-Nachzug (nach Davids `D-FLOW`/`D-P12`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P12b` aktualisiert
@@ -0,0 +1,68 @@
# R-P1a · P1 EU-Sterilisation + Contracts + URL-Schemata
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P1 — Fundament & Walking-Skeleton |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** — (allererstes Dev-Ticket)
- **Blocks:** `R-P1b` + gesamtes Fundament (alle Folge-Phasen sitzen auf den Contracts)
- **Läuft parallel zu:** `AK-INFRA1`/`AK-INFRA2` (Akeshan, reines Ops — kein Code-Konflikt). **P1 läuft Raffael SOLO** (R-P1a→R-P1b→R-P1c), Akeshan parallel auf der Infra-Schiene.
- **Konflikt-Risiko:** keines — diese Phase ist Repo-Säuberung + Contract-Dokumente, kein Schema-Konflikt. (AD-21: jedes Modul später eigene `prisma/schema/<modul>.prisma`.)
## Was wir bauen
Macht das Repo zu einer **lauffähigen, EU-sterilen Codebasis**: alle US-/OAuth-Altlasten aus der Boilerplate raus (GitHub/Google-OAuth-Reste, `User.githubId/googleId`, kein US-Kern im Auth-Pfad), GA + ConvertKit entfernt (Externals D3). Dazu die **verbindlichen URL-Schemata** als Bau-Vertrag, gegen den alle Folge-Phasen ihre Routen registrieren (App / Admin / Portal / Forms / Booking / Help / API).
## Benötigte Screens (Backend bedient — Design liefert `D-D0a`/`D-D0b`)
Kein fachlicher Screen. P1 ist Plattform-Fundament; der UI-Anteil liegt komplett in `D-D0a` (App-Shell A1) + `D-D0b` (Archetypen A2–A7 + Primitives) und wird über R-P1c (Walking-Skeleton) erstmals angedockt. Dieses Ticket liefert die **URL-Schemata**, gegen die David seine Routen-Hierarchie ausrichtet.
## Definition of Done
- [x] GitHub/Google-OAuth-Reste entfernt; `User.githubId`/`User.googleId` aus Schema raus *(war bereits via Migration `20260605120000_drop_oauth_identity_fields` raus)*
- [x] GA + ConvertKit-Einbindungen entfernt (Externals D3) *(inkl. Drop der verwaisten GA-Spalte, s.u.)*
- [x] Kein US-Kern im Auth-Pfad (EU-Sterilität nachweisbar)
- [x] URL-Schemata dokumentiert in `docs/INTEGRATION-CONTRACTS.md`: App, Admin (`admin.hivegrid.de`), Portal, Forms, Booking, Help, API
- [x] Repo baut lokal durch; upstream-Remote bleibt mergebar (AD-10)
## Technische Bausteine
- **Keine neuen Entities** — nur Felder entfernen (`User.githubId/googleId` aus `accounts.prisma`/`core.prisma`). Schema-Eingriffe minimal; **db push auf Branch, Migration erst beim Merge** (AD-21).
- EU-Sterilisation berührt Auth-Service-Pfad (`apps/web/app/services/auth/`) — OAuth-Provider-Reste deaktivieren/entfernen, nicht App-Logik umbauen.
- URL-Schemata als verbindlicher **Integration-Contract** (Multi-Host: App/Admin/Portal getrennte Subdomains).
- `is_demo_data`-Konvention: hier nur als Vorgabe dokumentiert (greift ab Seed-Tickets).
## Quellen (granular)
- `ROADMAP.md` → Phase 1 (Goal: EU-sterile lauffähige Codebasis)
- `PHASE-SOURCES.md` → Phase 1, Milestone `M012-workspace-topologie`
- `REQUIREMENTS.md` → `REQ-integration-routes`
- `docs/INTEGRATION-CONTRACTS.md` (URL-Schemata — Ziel-Dokument)
- `EXTERNALS-CHECKLISTE.md` → D3 (GA/ConvertKit raus)
- `designer-briefs/P01-fundament-walking-skeleton.md` (§EU-Sterilisation + URL-Schemata)
## Dev-Nachzug (nach Davids `D-D0a`/`D-D0b`-Delta)
- [ ] URL-Schemata an Davids Routen-Hierarchie-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P1a` aktualisiert
## Umsetzungsstand (Claude, 2026-06-17 — noch nicht final abgenommen)
> Branch `p1-fundament-rp1abc`. Diese Notiz dokumentiert den Stand; den finalen DoD-Abhaken/Done macht Raffael.
**Ausgangslage:** Repo war bereits ~95% EU-steril. OAuth (GitHub/Google) + `User.githubId/googleId` waren schon raus (Migration `20260605120000_drop_oauth_identity_fields`); die URL-Schemata standen bereits vollständig in `docs/INTEGRATION-CONTRACTS.md` (App/Admin/Portal/Forms/Booking/Help/API §3). Verifiziert per Grep: keine OAuth-Reste, keine US-AI-Imports.
**Tatsächliche Arbeit = GA + ConvertKit-Einbindung entfernen (Externals D3):**
- **Google Analytics (App-Ebene):** `ScriptAnalytics.tsx` gtag.js-Block, `AnalyticsHelper.ts` `window.gtag`-Calls, `appConfiguration.db.server.ts`-Plumbing, Admin-Settings-Feld (`admin/settings/analytics.tsx` + Validierung), `packages/config` (`web.ts`/`types.ts`/`catalog.ts` + `ANALYTICS_GA_TRACKING_ID` aus allen `.env.*`-Beispielen). **SimpleAnalytics + Plausible (EU, datenschutzfreundlich) bleiben** erhalten.
- **ConvertKit (US-Newsletter):** Provider-Integration aus `CrmService.ts` (subscribe-Branch + Subscriber-Fetch/Sync), `packages/config` + `CONVERTKIT_*` aus `.env.*`, Admin-CRM-Sync-Badge (`admin/crm/sync.tsx`). **CRM-Kern (Contacts/Companies/Opportunities/Submissions) bleibt**; Newsletter läuft nur noch über das eigene CRM.
- **Baseline-Fix:** `runtime-node-env-boundary.test.ts` war auf `main` rot (Regression aus EXT-12: `IpAddressService` delegiert Env-Config an `geoip.server.ts`). Boundary-Test auf die tatsächlich config-lesende Datei nachgezogen.
**Spalten-Drop (nachgezogen 2026-06-17):**
- `AppConfiguration.analyticsGoogleAnalyticsTrackingId` **gedroppt** — Migration `20260617121403_drop_app_config_ga_tracking_id` (forward-only DROP COLUMN + Inverse-SQL-Kommentar, DoD 28). Generiert + validiert gegen eine lokale Wegwerf-Postgres (alle 154 Migrationen `migrate deploy` grün, `migrate status` „up to date", `validate` ok), Prisma-Client neu generiert. Commit `fe428e1b`, nach `main` gemerged, **auf Staging deployt + live** (Migration sauber gelaufen).
- **Portal-Ebene per-Tenant-GA** (`Portal.analyticsGoogleAnalyticsTrackingId`) bleibt bewusst erhalten: mandanten-konfigurierbares Portal-Feature (Portals-Modul-Scope), nicht P1 — wird weiterhin von `portals.db.server.ts`/`PortalDto`/Portal-Settings gelesen/geschrieben.
**Staging-Deploy & Gegencheck (Deploy-Run 8343, fe428e1b):**
- `staging-web.hivegrid.de/healthz` → revision `fe428e1b`; `/healthcheck` → 200 (DB erreichbar, DROP COLUMN hat nichts gebrochen); `/` → 302 (rootData lädt `AppConfiguration` ohne die Spalte fehlerfrei → Schema/Code konsistent).
- **Infra-Lernpunkt:** Der erste Deploy-Versuch von `fe428e1b` schlug fehl — **nicht** wegen Code/Migration, sondern transientes `429 Too Many Requests` der Gitea-Docker-Registry beim Layer-Push (Build-Cache). Migration lief dabei gar nicht erst (Build brach davor ab), Staging blieb stabil auf `c2a31a2b`. Ein **Rerun** löste es. Gleiches Muster traf zuvor `2f740f2a`. Wiederkehrend → Registry-Rate-Limit/Build-Cache ist ein Infra-Thema (Akeshan), kein App-/P1-Code-Problem.
**Proof:** `@toolctrl/config` 101/101 grün · Web-Typecheck grün · ESLint `--max-warnings=0` grün · alle betroffenen Tests grün · volle Suite 3698 grün · **Staging live auf `fe428e1b`, healthcheck 200**.
@@ -0,0 +1,68 @@
# R-P1b · P1 Service-Kerne (Audit/notify/i18n/Flags) + Konnektor-Muster
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael |
| **Phase** | P1 — Fundament & Walking-Skeleton |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-18 · Gate W1 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P1a` (EU-Sterilisation + Contracts)
- **Blocks:** `R-P2a`, `AK-P3`, **alle Module** (Konnektor `tenantHasModule()` ist Pflicht-Gate jeder Folge-Phase)
- **Läuft parallel zu:** `AK-INFRA1`/`AK-INFRA2` (Ops, kein Code-Konflikt). **P1 = Raffael SOLO.**
- **Konflikt-Risiko:** keines — Service-Kerne sind Querschnitt (eigene Packages/Middleware). Schema-Berührung nur an Cross-Cutting (`AuditEntry`, `Notification`) — eigene `prisma/schema/*.prisma`, db push auf Branch (AD-21).
## Was wir bauen
Die **Querschnittsdienste**, auf denen jedes Folge-Modul aufsetzt: `logActivity()` (append-only Activity-Stream), Search-Registry, Subframe-Adapter, Mass-Action-Schutz, **Audit-Event mit SHA-256-Hash-Kette** (Prisma-Middleware, default-on), `notify()` mit Kanal-Abstraktion (In-App/Email; Push-Stub bis v2), `packages/i18n` (Resolution User → Tenant → DE, Build-Lint gegen Hard-Strings) und die **Feature-Flag-Engine mit Entitlement-Gate** (`tenantHasFlag()` + `tenantHasModule()` — das Konnektor-Prinzip). Liefert das Konnektor-Muster exemplarisch am Skeleton (wird in R-P1c angedockt).
## Benötigte Screens (Backend bedient — Design liefert `D-D0a`/`D-D0b`)
Kein fachlicher Screen — reine Service-Kerne (Backend). Die Bedien-Oberflächen dieser Dienste kommen in **P3** (`AK-P3`: Audit-Viewer + Notification-Center + Sprach-Settings). David liefert hier nur die Archetypen-Baseline (`D-D0a`/`D-D0b`), inkl. Activity-Stream-Komponente (A3) für spätere Detail-Views.
## Definition of Done
- [x] `AuditEvent` mit **SHA-256-Hash-Kette** *(vorhanden+getestet; Auto-Audit-Prisma-Middleware bewusst aufgeschoben, manueller `auditEvent`-Pfad ist der unterstützte Weg — s.u.)*
- [x] `notify()` Kanal-Abstraktion (In-App / Email; Push-Stub bis v2)
- [x] `packages/i18n` + `verify:i18n`-CI-Gate (Resolution User→Tenant→DE, Build-Lint Hard-Strings)
- [x] `tenantHasFlag()` + `tenantHasModule()`-Muster (Cache; in R-P1c am Skeleton angedockt)
- [x] `logActivity()` (polymorph `subject_type/id`, `actor_kind`) + Search-Registry + Subframe-Adapter + Mass-Action-Schutz aufrufbar
## Technische Bausteine
- **Entities** (eigene `prisma/schema/*.prisma`): `AuditEntry` (append-only, `before/after_diff`, `summary_text` DE, Hash-Kette), `Notification`/`NotificationPreference`/`NotificationDevice` (Push-Kanal ruht v1), `Activity` (Cross-Cutting, polymorph `subject_type+subject_id`, `actor_kind` user/system/automation/ki_agent). i18n = **keine Tabelle** (JSON-Files + Felder `User.language`/`Tenant.default_language`).
- **Konnektor** `tenantHasModule()`: prüft `SubscriptionFeature.code` im Abo des Tenants (Brücke Billing↔Feature-Gate); Redis-Cache.
- **RLS** auf `AuditEntry`/`Notification` (tenant-bezogen, AD-1).
- `is_demo_data`-Flag-Konvention für seedbare Definitions-Tabellen.
## Quellen (granular)
- `ENTITY-MODEL.md` → **Domäne 2: Querschnitt** (AuditEntry/Notification/NotificationPreference/Device) + **Cross-Cutting** (Activity, Konnektor via SubscriptionFeature.code)
- `REQUIREMENTS.md` → `REQ-audit-datenmodell`, `REQ-notification-datenmodell`, `REQ-i18n-architektur`, `REQ-feature-flags-system`, `REQ-integration-activity-wiring`/`-audit-wiring`/`-notification-wiring`
- `ROADMAP.md` → Phase 1 · `PHASE-SOURCES.md` → Phase 1 (M001/M003/M006/M011 + M005/M007)
- `designer-briefs/P01-fundament-walking-skeleton.md` (Service-Kerne)
- `_bmad-output/specs/M21-audit-log.md`, `M22-notifications.md`, `M30-i18n.md`, `M32-feature-flags.md`
## Dev-Nachzug (nach Davids `D-D0a`/`D-D0b`-Delta)
- [ ] Activity-Stream-/Konnektor-Wiring an Davids Komponenten-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P1b` aktualisiert
## Umsetzungsstand (Claude, 2026-06-17 — noch nicht final abgenommen)
> Branch `p1-fundament-rp1abc`. Den finalen DoD-Abhaken/Done macht Raffael.
**Ausgangslage:** Die meisten Querschnitt-Service-Kerne lagen schon in der Boilerplate vor und wurden als aufrufbar verifiziert:
- **Audit + SHA-256-Hash-Kette:** `packages/db/audit-hash.ts` (`computeAuditHash`/`verifyAuditChain`/`canonicalizeAuditPayload`) + `audit-events.server.ts` (`createAuditEvent`/`publishAuditEventViaOutbox`), getestet (`audit-hash.test.ts`, `audit-events.server.test.ts`).
- **`notify()`** Kanal-Abstraktion (In-App/Email, Push-Stub) in `packages/foundation/notifications.ts`.
- **i18n + `verify:i18n`-Gate:** `packages/i18n` + `pnpm run verify:i18n` (i18n-check + hardcoded-strings + eslint auf ui-Paketen), grün.
- **`logActivity()`** (`@toolctrl/activity`), **Search-Registry** (`indexedEntities`/`listIndexedEntities`, `@toolctrl/search`), **Subframe-Adapter** (`defineAdapter`, `@toolctrl/ui-app`), **Mass-Action-Schutz** (`previewMassAction`/`assertMassActionAllowed`, `@toolctrl/foundation`) — alle exportiert/callable.
**Neu gebaut = der Konnektor (die eigentliche Lücke):**
- `apps/web/app/utils/connector/tenantConnector.server.ts` mit dem kanonischen Pflicht-Gate:
- **`tenantHasModule({tenantId, userId, moduleKey})`** → bool. Brücke Billing↔Feature-Gate: nutzt `resolveTenantProductAccess` (Abo/`SubscriptionFeature` via `getActiveTenantSubscriptions`, Blueprint, Tenant-Override, Rollen-Permission). Modul-Entscheidung Connector-seitig gecacht (`cachified`) + `invalidateTenantModuleAccessCache(tenantId)`.
- **`tenantHasFlag({flagKey, tenantId?, userId?})`** → bool. Delegiert an den v2-`evaluateFlagForContext` (bringt eigenen Eval-Cache mit).
- 6 Unit-Tests (`tenantConnector.server.test.ts`).
- Cache-Backing = App-Cache (`~/utils/cache.server`, LRU heute, per `redisCacheAdapter` Redis-swappbar — Infra-Schalter; die genutzten Resolver `getActiveTenantSubscriptions`/`evaluateFlagForContext` cachen bereits cross-replica).
**Bewusst aufgeschoben (begründet):**
- **Default-on Auto-Audit-Prisma-Middleware:** Die Hash-Kette + explizites `auditEvent`/`createAuditEvent` sind vorhanden und der **richtige** Pfad. Eine auto-Middleware am geteilten Prisma-Client ohne request-scoped Actor-Kontext (AsyncLocalStorage) erzeugt actor-lose Events (schlechter als die expliziten Aufrufe mit vollem Kontext) und ist ohne lokalen DB-Zugriff nicht validierbar. Querschnitt-Tabelle erlaubt explizit „auto via Middleware **oder** manuell auditEvent". → ALS/Auto-Audit als separater Infra-Schritt.
**Proof:** Konnektor 6/6 · Web-Typecheck grün · `verify:i18n` Exit 0 · volle Suite grün (siehe R-P1c-Abschluss).
@@ -0,0 +1,80 @@
# R-P1c · P1 Hot-Swap-Maschine + Walking-Skeleton + PWA
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Raffael *(NEU — übernommen von Akeshan; ex-AK-P1c, Umverteilung 16.06.)* |
| **Phase** | P1 — Fundament & Walking-Skeleton |
| **Cycle/Fenster** | W1 — Fundament & Identität · fällig 2026-06-17 · Gate W1 |
| **Status** | geplant |
## Abhängigkeiten & Parallelität
- **Blocked by:** `R-P1a` (URL-Schemata/Contracts), `R-P1b` (Service-Kerne + `tenantHasModule()`-Muster) — *abweichend vom AK-P1c-Snapshot („blocked-by: —"), da R-P1c das Konnektor-Gate + die VM-Konvention erst andocken kann, wenn R-P1a/b stehen; P1 läuft Raffael sequentiell.*
- **Blocks:** alle Screen-Andock-Tickets, Gate W1 (Walking-Skeleton = grüner Smoke-Test-Anker)
- **Läuft parallel zu:** `D-D0a`/`D-D0b` (David Archetypen-Baseline, gleiche W1) — baut direkt darauf auf; `AK-INFRA1/2` (Ops).
- **Konflikt-Risiko:** keines — Konvention/Adapter/Beispielroute, kein Fach-Schema. db push auf Branch (AD-21).
## Was wir bauen
Die **Hot-Swap-Maschine** (VM-Konvention + Action-Callback-Contract + Subframe-Adapter, damit Davids Subframe-Designs ohne Logik-Bruch in die App geswapt werden können), das **Visual-Regression-Gate** + den Hot-Swap-Drill (grüner Smoke-Test gegen `packages/ui-mock`) und die **Walking-Skeleton-Route**: eine in der Sidebar registrierte Beispielroute, die das View-Model-im-Loader-Muster + das Konnektor-Gating (`tenantHasModule()`) exemplarisch zeigt. Dazu das **PWA-Manifest** (PWA-only v1, AD-17/Cut #14 — kein Expo/native).
## Benötigte Screens (Backend bedient — Design liefert `D-D0a`/`D-D0b`)
| Screen [Route] | Kern-Inhalt | Liefert (Design) |
|---|---|---|
| App-Shell-Andock [global] | Sidebar mit Konnektor-Gating-Zustand (aktiv/ausgeblendet/gesperrt je `tenantHasModule()`), Topbar, Status-Banner-System | `D-D0a` (A1) |
| Walking-Skeleton-Route [Beispiel-Modul-Route] | minimal aus A2 komponiert; Loader gibt View-Model zurück, Konnektor-Gate exemplarisch, grüner Smoke-Test | `D-D0b` (A2 minimal) |
## Definition of Done
- [x] **VM-Konvention** (View-Model im Loader) + **Action-Callback-Contract** + **Subframe-Adapter** stehen
- [x] `packages/ui-mock` + **Visual-Regression-Gate** + Hot-Swap-Drill (grün)
- [x] **Walking-Skeleton-Route** in Sidebar registriert, Konnektor-Gate `tenantHasModule()` exemplarisch angewandt
- [x] **PWA-Manifest** (installierbar; PWA-only v1, AD-17 — kein native/Store)
- [x] Smoke-Test grün gegen `ui-mock`
## Technische Bausteine
- **Keine Fach-Entities** — nutzt das `tenantHasModule()`-Muster aus R-P1b und die Contracts aus R-P1a.
- Subframe-Adapter = Brücke Davids Subframe-Output → App-Komponenten (Hot-Swap ohne Logik-Umschrieb); VM-Konvention macht Loader testbar gegen `ui-mock`.
- Sidebar-Registrierung demonstriert die drei Konnektor-Zustände (aktiv/ausgeblendet/gesperrt).
- PWA-Manifest minimal (Installierbarkeit) — voller PWA-Ausbau (Service-Worker/Offline/Push) → v2 (`VA-P27a/b`).
## Quellen (granular)
- `ROADMAP.md` → Phase 1 · `PHASE-SOURCES.md` → Phase 1, Milestones `M013-view-model-konvention`, `M014-action-callback-contract`, `M015-subframe-adapter-layer`, `M016-visual-regression-gate`, `M017-hot-swap-drill`
- `REQUIREMENTS.md` → `REQ-integration-view-model-pflicht`, `REQ-integration-sidebar`, `REQ-integration-smoke-tests`
- `designer-briefs/P01-fundament-walking-skeleton.md` (Walking-Skeleton + App-Shell-Andock)
- `DESIGNER-FIRST-PLAYBOOK.md` → §1 Fundamente (Hot-Swap-Prinzip)
- `docs/ARCHITECTURE-DECISIONS.md` → AD-17 (PWA-only)
## Dev-Nachzug (nach Davids `D-D0a`/`D-D0b`-Delta)
- [ ] Subframe-Adapter/Skeleton an Davids App-Shell- + Archetypen-Output angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `R-P1c` aktualisiert (Owner→Raffael bestätigt)
## Umsetzungsstand (Claude, 2026-06-17 — noch nicht final abgenommen)
> Branch `p1-fundament-rp1abc`. Den finalen DoD-Abhaken/Done macht Raffael. Designer-first: die
> finale Optik folgt Davids `D-D0a`/`D-D0b`-Delta (Dev-Nachzug oben); R-P1c liefert das **Muster**
> (dünne Ende-zu-Ende-Scheibe), nicht das polierte UI.
**Ausgangslage:** Hot-Swap-Maschine + ui-mock + Visual-Regression-Gate lagen schon vor und sind grün
(`pnpm run test:hot-swap` → „UI hot-swap drill verified", `pnpm run verify:ui-visual` → 7 passed).
VM-/Action-Callback-/Subframe-Adapter-Typen existieren in `@toolctrl/view-models` + `defineAdapter` in `@toolctrl/ui-app`.
**Neu gebaut:**
- **VM-Konvention exemplarisch (M013):** `packages/view-models/src/walking-skeleton/walking-skeleton.vm.ts` — reine `buildWalkingSkeletonVM()`, `*.vm.ts`, `VMState`, nur i18n-Keys (kein Klartext). + Tests.
- **Konnektor→Sidebar-3-Zustände:** `apps/web/app/utils/connector/connectorNavState.ts` (`resolveConnectorNavState` → `active`/`locked`/`hidden`) + Tests für alle drei.
- **Walking-Skeleton-Route:** `apps/web/app/routes/app.$tenant/walking-skeleton.tsx` — Loader baut das VM **im Loader** und wendet das Konnektor-Pflicht-Gate `tenantHasModule()` (aus R-P1b) exemplarisch an; Component rendert minimal je Zustand (`data-ui-id="ui.walkingSkeleton.page"`, `data-connector-state`). + Loader-/Component-Tests.
- **Sidebar-Registrierung:** `AppSidebar.tsx`-Eintrag, gegated über `resolveConnectorNavState` auf Basis der productAccess-Entscheidung; `appData.ts` wertet das Demo-Modul `walking-skeleton` mit aus. Für reale Tenants `blueprint-disabled` → Zustand **hidden** (kein Clutter), bis das Modul bewusst einem Blueprint zugeordnet wird.
- **PWA-Manifest:** `apps/web/public/manifest.webmanifest` von „Toolctrl Boilerplate" auf **HiveGrid** umgebrandet (`lang: de`), installierbar (PWA-only v1, AD-17).
- **Smoke gegen ui-mock:** `apps/web/app/modules/walkingSkeleton/walkingSkeleton.hot-swap.test.ts` (VM als ui-mock-Drop-in via `generateMockArtifacts` — beweist Hot-Swap-Tauglichkeit). + e2e-Smoke `tests/e2e/walking-skeleton.spec.ts` (Login→Route→Seite, skippt ohne E2E-Creds; läuft im CI/Staging-e2e-Job, lokal kein Playwright-Server).
- **i18n:** `walkingSkeleton.*`-Keys in `de` + `en` (Parität, `verify:i18n` grün).
**Nebenbei gefixt — Test-Isolations-Flake (Suite verlässlich grün):** Die zusätzlichen Test-Dateien
kippten die Parallelität über eine Schwelle, die einen latenten Race exponierte:
`verify-email-marketing-` und `verify-kb-widgets-workflow-marketing-decision-report.test.mjs`
mutierten die **geteilte** `docs/feature-manifests/plugin-candidates.json` in-place (von Geschwister-
Verifiern gelesen → cross-file Race). Beide auf das bereits bewährte Temp-Fixture-Muster von
`verify-portals-sites-decision-report.test.mjs` umgestellt (Verifier-Root via `process.argv[2]`,
Mutation nur in `node_modules/.tmp`). Der neue isolierte Test deckte zudem auf, dass ein früher
abgebrochener Lauf die echte `plugin-candidates.json` dirty hinterlassen hatte → aus git
wiederhergestellt. Danach 2× grün + Datei bleibt sauber.
**Proof:** view-models + web Typecheck grün · `test:hot-swap` + `verify:ui-visual` grün · `verify:i18n` grün · ESLint grün · neue Tests grün · volle Suite **3698 grün** (Flake behoben, s.o.) · Commit `c2a31a2b` nach `main`, **auf Staging deployt** (Deploy-Run, revision live + healthcheck 200). Finaler P1-Stand inkl. Spalten-Drop = `fe428e1b` (Deploy-Details siehe `R-P1a.md` §Staging-Deploy).
Loaded 100 of 5784 files, more files were not shown because too many files have changed in this diff. Show more