Initial commit: everythingbutwork MVP
ci / quality (push) Has been cancelled
ci / build (push) Has been cancelled

Internes Project-Management-Tool für ToolCTRL — ergänzend zu Plane (Tickets)
und Outline (Doku). Umfasst Puls-Übersicht, Tagesrhythmus (Lock-in + Reflexion),
Bereichs-Detail-Views (Entwicklung/Vertrieb/Marketing), Pflicht-Minimum-Check
und Blocker-Lifecycle gemäß Projektmanagement-Leitfaden v3.0.

Stack: pnpm-Monorepo · Vite + React 18 + Tailwind · Fastify + tRPC v11 +
Drizzle ORM · Postgres 16 · Authentik OIDC (Phase 2, Dev-Auto-Login aktiv).

Planungs-Artefakte unter _bmad-output/planning-artifacts/.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
dejanandClaude Opus 4.7 committed 2026-05-25 22:47:26 +02:00
commit 4f33509a0f
131 files changed
+34339

No files matched your search

@@ -0,0 +1,160 @@
# Entscheidungs-Log – PRD projectmanagement
> Kanonisches Gedächtnis und Audit-Trail dieses PRD-Laufs. Jede Entscheidung, Änderung
> und jeder Override (auch headless) wird hier festgehalten, während das Gespräch läuft.
## Eintraege
- **2026-05-25** – Lauf gestartet. Intent: *Create*. Workspace: `prd-projectmanagement-2026-05-25/`.
Sprache: Deutsch (communication & document_output). Facilitator: Claude (bmad-prd).
- **2026-05-25** – Inputs eingelesen: `inputs/unternehmens-cockpit.html` (HTML-Prototyp,
1214 Zeilen, von Nicht-Techniker als Vibe-Code-Ausgangspunkt erstellt). Extract liegt in
`extract-prototype-html.md`. ToolCTRL Brand Identity referenziert (Pfad ausserhalb Repo,
nur als Referenz; konkrete Werte werden in der UX-Phase festgezogen).
- **2026-05-25** – Working Mode: **Fast Path**. Verbleibende Gaps werden gebündelt
abgefragt, dann Draft mit `[ASSUMPTION]`-Tags. User reviewt und iteriert.
- **2026-05-25** – Team-Skalierung: **6-15 Mitarbeiter** (gesamtes ToolCTRL-Team).
- **2026-05-25** – Auth-Strategie: **Authentik (auth.tool-ctrl.de) via OIDC**. Wird als
weitere App im bestehenden SSO-Setup registriert. Konsistent mit Plane, Outline, Gitea,
Kimai, Nextcloud, Element, Jitsi etc., die alle schon hinter Authentik laufen.
- **2026-05-25** – Plane/Outline-Integration: **Phase 2, nicht MVP**. Im MVP nur freie
URL-Links als Strings im Feld `Bezug`. Später API-Sync möglich (auch unter Authentik).
- **2026-05-25** – Tech-Stack-Default für PRD: **React (Frontend) + Postgres (Datenhaltung)**;
Backend-Wahl bleibt der Architektur-Phase überlassen. Tech-Details landen in
`addendum.md`, das PRD selbst bleibt Capability-orientiert.
- **2026-05-25** – Areas-Scope MVP: **nur 3 Detail-Areas** (Entwicklung, Vertrieb,
Marketing). Buchhaltung & Design können Tagesupdates mit Bezug "allgemein" schreiben
und erscheinen im Puls als Update-Quote / Streak, bekommen aber keine eigene Detail-View.
Erweiterung in Phase 2.
- **2026-05-25** – Kern-Mechanik gegen Versandung: **kombinierter Ansatz** —
(a) Daily-Update-Pflicht mit öffentlicher "fehlt heute"-Liste & Streak,
(b) Deadline-/Meilenstein-Verfall als Bar-Visualisierung pro Projekt,
(c) bereichsübergreifende Blocker-Liste im Puls. Diese drei zusammen sind das "Warum
jetzt"-Kernversprechen des Produkts.
- **2026-05-25** – **Major Update: Leitfaden v3.0 als bindender Frame nachgereicht**
(`inputs/ToolCTRL_Projektmanagement-Leitfaden_v3.0.pdf`, Mai 2026).
Konsequenzen, die im PRD und Addendum eingepflegt sind:
- PRD-Frontmatter `binding_frame` gesetzt.
- Tool-Aufteilung verschärft: Plane=Arbeit, Outline=Gedächtnis, Cockpit=Übersicht
(Anti-Ziele A3, A4, A5 ergänzt).
- Ampel-Definitionen exakt aus Leitfaden §5: Grün/Gelb/Rot mit klarer
Semantik, plus Trend (besser/gleich/schlechter) + Freitext max 1000 Zeichen.
- **Neues Major-Feature**: Feature-Gruppe G "Pflicht-Minimum-Check" (FR-30/30a/30b)
leitet sich direkt aus Leitfaden §9 ab; im Puls (FR-7) sichtbar.
- Erfolgsmetrik M6 ergänzt (≥90% Projekte erfüllen alle 6 Pflicht-Punkte).
- Rollen umstrukturiert: §4.1 Leitfaden-Rollen (P1-P4) + §4.2 Querschnittsrollen
(Q1-Q5). Konsistent mit Leitfaden §7.
- Projektarten umbenannt: Kundenprojekt / Internes Projekt (statt
Umsatz/Intern aus Prototyp). Konsistent mit Leitfaden §1.
- Datenmodell-Skizze erweitert: `Project.kind`, `arbeitsmodus`, `dod_text`,
URL-Felder, `pflicht_minimum_state`, `Deal.probability`,
`Deal.won_at/won_value_eur`, neue `LeadHandover`-Entität.
- Addendum §7 "Leitfaden-Bezüge"-Tabelle ergänzt.
- **2026-05-25** – Reconciliation-Subagent Findings eingearbeitet:
- FR-13: `probability` ergänzt; FR-14: gewichteter Pipeline-Wert + Won-Deals-KPI;
- FR-19: Crosslink-Banner Marketing↔Vertrieb;
- NFR-12/13: neue Sektion **Voice & Tone** mit Prototyp-Anker-Phrasen;
- Vokabular im Addendum §6 um "Update-Serie", "Crosslink",
"Bereichsübergreifend offen", "Trend" erweitert.
- **2026-05-25** – Rubric-Walker Verdict: **good** (0 Critical, 0 High,
3 Medium, 5 Low). Findings teilweise sofort eingearbeitet:
- FR-1a: Ampel-Aggregations-Algorithmus pro Area expliziert.
- FR-5: Key-Metrics als verbindlicher Katalog pro Area (nicht mehr Beispiele).
- §5 UJ: Persona-Linkage via P1-P4 / Q1-Q5-IDs.
- FR-23: Sortierung neueste oben + Pagination 50/Seite.
- NFR-16: Bound "max. 2-stündige Migration".
- §10: Annahmen-Index ergänzt (A-1 bis A-6).
- OQ-4 als Phase-Blocker markiert.
Rest (OQ-3 Bestätigung, OQ-7 Pflicht/Optional Trend, "Bereich/Area"-Synonymie) →
Triage mit User.
- **2026-05-25** – Vorläufige Defaults für offene Fragen im PRD eingetragen:
OQ-3 Default = "rückwirkende Updates gesperrt"; OQ-4 Default = "jeder darf
Blocker als gelöst markieren"; OQ-6 Default = "manuelle Checkbox im MVP";
OQ-7 Default = "Trend optional". Alle bestätigungsbedürftig in Triage.
- **2026-05-25** – **Major Konzept-Erweiterung: Morgen-ToDos + Abend-Reflexion.**
User hat in der Triage einen bisher nicht erwähnten Kern-Workflow nachgereicht:
Tagesupdate ist nun ein zweistufiger Vorgang — morgens stempelt die Person sich
ein und trägt ihre ToDos für den Tag ein; abends ruft sie die Liste auf, hakt ab,
schreibt eine Reflexion, setzt Ampel + Trend. Kollegen sehen den konsolidierten
Eintrag erst am nächsten Werktagsmorgen. Innerhalb des laufenden Tages sehen
Kollegen nur binäre Anwesenheit, keine ToDo-Inhalte.
Konsequenzen im PRD:
- UJ-1 komplett umgeschrieben (Morgen/Abend/Nächster Morgen).
- Feature-Gruppe E umgebaut: 6.5.1 Morgen (FR-21-25), 6.5.2 Abend (FR-26-28),
6.5.3 Konsolidierung (FR-29-33). FRs danach von 26-39 auf 34-49 renumbered.
- Tages-Status pro Person (voll/halb/nicht angefangen/abwesend) (FR-33).
- Streak-Definition geändert: zählt nur volle Tage (FR-34).
- CM1 aufgesplittet in CM1a (Morgen ≤60s), CM1b (Abend ≤90s), CM1 (Gesamt ≤3 min).
- Sichtbarkeitsmodell: `published_at` = nächster Werktagsmorgen.
- Addendum: neues Datenmodell `DayEntry` ersetzt `Update`, neue Entität `Todo`,
Vokabular um Einstempeln/Reflexion/„Mein heute"/Konsolidierter Vortagseintrag
erweitert.
- Beschlossene OQs aus Triage: OQ-3 (1 Werktag zurück), OQ-4 (nur P1),
OQ-6 (manuelle Checkbox), OQ-7 (Trend Pflicht bei Projekt-Bezug).
- Neue OQs offen: OQ-8 (Erinnerungs-Zeit Reflexion, Default 17:00),
OQ-9 (≥1 ToDo Pflicht beim Einstempeln), OQ-10 (ToDos nach Reflexion noch
nachtragbar — Default: nein).
- **2026-05-25** – Polish-Pass durchgeführt durch zwei parallele Subagenten
(Struktur + Prosa) auf prd.md und addendum.md. Wichtigste Änderungen:
Vereinheitlichung „Area" → „Bereich"; CM-Tabelle nach Gesamtzeit zuerst,
dann Teilzeiten sortiert; Tippfehler bereinigt; Vokabular synchronisiert
(„Tagesupdate" durchgängig). Keine FRs/Anti-Ziele/Metriken inhaltlich
geändert. PRD: 29 206 → 28 633 Zeichen (–2%). Addendum: 9 500 → 9 350
Zeichen (–1,5%).
- **2026-05-25** – **Finalize abgeschlossen.** Frontmatter `status: final` in
prd.md und addendum.md gesetzt. Phase-Blocker-OQs (OQ-1 Authentik-Mapping,
OQ-2 Brand-Tokens, OQ-4 Blocker-Auflöser) sind im PRD entschieden oder an
konkrete Folge-Phase deferiert. Externe Handoffs (Confluence/Notion) sind im
Skill-Config leer — entfallen. Empfehlung für nächsten Schritt: parallel
bmad-create-architecture (technische Schnitt klar, Datenmodell skizziert)
und bmad-create-ux-design (Brand-Tokens, „Mein heute"-Konzept, Voice & Tone).
bmad-create-epics-and-stories danach.
- **2026-05-25** – **Architektur-Phase abgeschlossen.** Dokument liegt unter
`_bmad-output/planning-artifacts/architecture.md` (8 von 8 Schritten erledigt,
Status complete). Wichtigste Pivots:
- **Stack ist Vite + React (SPA), nicht Next.js** — auf Team-Wunsch
(T3-Stack-Vorschlag aus Step 3 verworfen).
- Monorepo (pnpm workspaces): `apps/web`, `apps/api`, `packages/db`, `packages/shared`.
- Backend: Fastify 5+ mit tRPC v11, `openid-client` v6+ für Authentik OIDC,
Drizzle ORM auf Postgres 16+, Session-Cookies (HttpOnly+SameSite=Lax) statt JWT.
- Background-Jobs: System-Cron → authentifizierter Fastify-Endpoint
(`/internal/cron/*` mit Bearer-Token), 4 Jobs definiert.
- Hosting: bestehende ToolCTRL-Infrastruktur, Caddy 2.x als Reverse-Proxy.
- 4 tRPC-Procedure-Typen: `public`, `protected`, `dayEntryVisible`, `projectOwner`.
- OQ-5 (Archivierungs-Policy) in der Architektur fixiert: Soft-Delete via
`archiviert`-Flag, kein automatisches Löschen.
- Verdict der Validierung: **READY FOR IMPLEMENTATION** (16/16 Checklist,
0 Critical, 3 Important nicht-blockierende Gaps).
- Folgeskill: `bmad-create-ux-design` (OQ-2 Brand-Tokens, „Mein heute"-Layout,
Voice & Tone), danach `bmad-create-epics-and-stories`.
- **2026-05-25** – **UX-Design-Phase abgeschlossen.** Dokument liegt unter
`_bmad-output/planning-artifacts/ux-design-specification.md` (14 von 14 Schritten
erledigt, status: complete). Hauptentscheidungen:
- **Brand-Tokens fixiert (OQ-2 geschlossen):** Weiß-Schwarz-Monochrom mit drei
Ampel-Akzentfarben für Status; konkrete Hex-Werte und Typo-Scale dokumentiert.
- **Typografie:** Inter (UI) + JetBrains Mono (Werte), selbst-gehostet via
`@fontsource`. Konsistent mit Brand-Marketing-Style.
- **Component-Library:** Tailwind + Radix UI Primitives + 15 hauseigene Brand-
konforme Komponenten in `components/ui/`. Kein shadcn-Bulk, kein Material UI.
- **Design-Richtung:** „Office Minimal" — ruhiges, typografie-getragenes Layout,
Brand-Reduktion als Feature. Drei Sichtebenen: Desktop (Volllayout), Tablet
(2-Spalten), Mobile (lesbar, schreiben auf Desktop empfohlen).
- **Voice & Tone konkretisiert:** „Stark.", „Wie läuft es?", „Du hast heute noch
nicht gepingt." als Mikrocopy-Anker; keine Emojis, kein Corporate-Sprech,
deutsch durchgängig.
- **Brand-Element `^`:** Das macOS-Ctrl-Caret als wiederkehrendes Element
(Logo-Lockup `cockpit ^`, Streak-Badges, Toast-Bestätigungen).
- **Mermaid-Diagramme** für UJ-1 bis UJ-5 in der Spec.
- **A11y-Strategie:** WCAG 2.1 AA, Keyboard-First, axe-core-Tests, Lighthouse-
Ziel ≥ 95.
- Folgeskill: **`bmad-create-epics-and-stories`** — übersetzt PRD + Architektur
+ UX-Spec in epische User-Stories mit Akzeptanzkriterien.
- **2026-05-25** – **Epics & Stories-Phase abgeschlossen.** Dokument liegt unter
`_bmad-output/planning-artifacts/epics.md` (4 von 4 Schritten erledigt,
status: complete). User-Direktive: „verkünstel dich nicht zu sehr in der
Planung — wir müssen mit dem Bauen anfangen." Daher schlanke Struktur:
**6 Epics** entlang der Architektur-Implementation-Sequence, **32 Stories**
insgesamt mit Given/When/Then-AKs. Schema wird inkrementell pro Story-Bedarf
migriert (kein Big-Bang). Coverage: 48/49 FRs, alle NFRs/AR/UX-DRs abgedeckt;
FR-49 (Volltextsuche) explizit Phase 2. **Verdict: READY FOR DEVELOPMENT —
bauen startet mit Story 1.1 (Repo-Bootstrap).**
@@ -0,0 +1,273 @@
---
title: Addendum – ToolCTRL Unternehmens-Cockpit
status: final
created: 2026-05-25
updated: 2026-05-25
binding_frame: ToolCTRL Projektmanagement-Leitfaden v3.0 (Mai 2026)
---
# Addendum zum PRD – ToolCTRL Unternehmens-Cockpit
> Inhalte, die im Hauptdokument den Lesefluss stören würden, aber für Architektur, UX-Design und das spätere Verständnis von Entscheidungen wichtig sind.
---
## 1. Technische Orientierung (vorläufig)
### 1.1 Stack-Default
- **Frontend:** React.
- **Datenhaltung:** Postgres.
- **Backend:** offen — Node/Express oder Fastify (passt zur React-Welt), Python/FastAPI, oder .NET. Entscheidung in Architektur-Phase.
- **Auth:** Authentik (auth.tool-ctrl.de) via OIDC. Cockpit als weitere App im Authentik-Provider; Token-Validierung im Backend.
- **Hosting:** wahrscheinlich gleiche interne Infrastruktur wie Plane/Outline/Gitea.
### 1.2 Datenmodell-Skizze (nicht normativ)
```
User
id, authentik_sub, name, email, default_area_id, active, abwesend_bis
Area
id, name, kind (dev|sales|marketing|allgemein), order
Project
id, area_id, name,
kind (kundenprojekt|internes_projekt) # Leitfaden §1
verantwortliche_user_id # Leitfaden §7 (P1)
arbeitsmodus (cycle|kanban) # Leitfaden §5
outline_steckbrief_url
steckbrief_freigegeben (bool, manuell)
plane_project_url
risikoliste_url (nullable)
dod_text (nullable, Freitext) # Leitfaden §4
start, deadline,
status_cache (green|amber|red|null)
trend_cache (besser|gleich|schlechter|null)
pflicht_minimum_state (jsonb mit 6 booleans) # Leitfaden §9
archiviert (bool), archiviert_am, lessons_learned_url (nullable)
created_by, created_at
Milestone
id, project_id, title, due, status (open|done|overdue), description
Deal
id, area_id (=sales), name, owner_id, value_eur,
probability (0-100), # für gewichtete Pipeline
stage (lead|erstgespraech|demo|angebot|abschluss),
entered_stage_at,
won_at (nullable), won_value_eur (nullable)
GtmStep
id, product, title, owner_id, status (open|in_progress|done), order
Campaign
id, area_id (=marketing), name, status (active|paused|done),
reach, owner_id
LeadHandover # Crosslink Marketing → Sales
id, campaign_id, dealkette_deal_ids (array),
übergeben_am, übergeben_von
DayEntry # ersetzt das alte "Update"
id, user_id, date,
status (begun|full|absent), # begun = nur Einstempeln; full = Einstempeln + Reflexion
checked_in_at, # Zeitstempel Morgen-Einstempeln
reflected_at (nullable), # Zeitstempel Abend-Reflexion
reflection_text (nullable, max 1000 Zeichen),
ampel (green|amber|red|null),
trend (besser|gleich|schlechter|null),
url (nullable),
blocker_id (nullable),
edit_locked_at (nullable), # 30 Min nach Reflexion
published_at # nächster Werktag 00:00 — ab dann für Kollegen sichtbar
Todo
id, day_entry_id, user_id, date,
title (max 200), order,
bezug_kind (project|deal|campaign|allgemein|null),
bezug_id (nullable),
status (open|done|dropped),
drop_reason (nullable, Freitext),
created_at, completed_at, dropped_at
# Hinweis: ein Tagesupdate (DayEntry) hat 0..N Todos plus einen einzigen
# Reflexionsblock. Vor `published_at` sehen nur die Person selbst und
# Projektverantwortliche (für Todos mit Projekt-Bezug) die Inhalte.
Blocker
id, title, description, area_id, project_id (nullable),
owner_id, opened_by, opened_at,
resolved_by, resolved_at, resolution_text
AbsenceDay
id, user_id, date, reason (urlaub|krank|sonstiges)
AuditEvent
id, actor_user_id, action, entity_kind, entity_id, payload_jsonb, created_at
```
### 1.3 Auth-Flow
1. User öffnet `cockpit.tool-ctrl.de`.
2. Backend prüft Session-Cookie; bei Fehlen Redirect auf Authentik-Authorize-Endpoint.
3. Authentik liefert OIDC-Code, Cockpit-Backend tauscht ihn gegen Token (Authorization Code Flow + PKCE).
4. Backend legt User in eigener Tabelle an, falls erstmaliger Login (Mapping per `sub`).
5. Default-Area wird aus Authentik-Group-Claim gemappt.
### 1.4 Phase 2 – Plane/Outline-Integration (Skizze)
- **Plane:** API-Token; bei Eingabe einer Plane-URL holt das Backend Titel, Status und Owner und cached sie. Pflicht-Minimum-Punkt 3 (Plane-Board) wird damit automatisch validiert.
- **Outline:** bei Eingabe einer Steckbrief-URL prüft das Backend per Outline-API, ob das Dokument existiert und welchen Status es hat (Draft/Published). Pflicht-Minimum-Punkt 1 wird damit automatisch validiert.
- **Lessons-Learned-Vorlage:** beim Projekt-Abschluss erzeugt das Cockpit eine vorbefüllte Outline-Seite gemäß Leitfaden-Vorlage.
---
## 2. Verworfene Alternativen
### 2.1 „Bleiben wir bei Plane allein, sparen uns das Cockpit"
- **Verworfen, weil:** Plane ist ein Tickets-Tool. Es zwingt nicht zu täglichen Updates und aggregiert nicht über Bereiche hinweg. Der Schmerz „wir sehen nicht, was läuft" bleibt ungelöst. Das Cockpit ist im Leitfaden §5 zudem explizit vorgesehen.
### 2.2 „Zurück zu Jira+Confluence"
- **Verworfen, weil:** schon einmal aufgegeben. Plane/Outline sind die strategisch gewollten Nachfolger.
### 2.3 „Slack/Element-Channel mit Daily-Standup-Bot"
- **Verworfen, weil:** Chat skaliert nicht zu Übersicht. Visualisierung (Puls, Funnel, Kanban) und Aggregation fehlen; Suche und Filter sind schwach.
### 2.4 „SaaS-Lösung kaufen (Range, Geekbot, Standuply, etc.)"
- **Verworfen, weil:** externe SaaS bedeutet weiteren Anbieter, Datenabfluss und Auth-Insel. ToolCTRL bevorzugt Self-Hosting hinter Authentik. Keine der untersuchten Lösungen trifft die ToolCTRL-Spezifika (Pflicht-Minimum-Check aus Leitfaden, Crosslinks, GTM-Schritte).
### 2.5 „localStorage / Single-Page, kein Backend"
- **Verworfen, weil:** Multi-User braucht Server-Persistenz.
### 2.6 „Alle 5 Bereiche mit Detail-Views im MVP"
- **Verworfen, weil:** Buchhaltung und Design haben keine etablierten KPI-Strukturen. Detail-Views wären leere Skelette. Phase 2 nach Definition.
### 2.7 „Steckbrief-Editor ins Cockpit holen — One-Stop-Shop"
- **Verworfen, weil:** Leitfaden §8 ist explizit: „Wir führen kein zusätzliches Projektmanagement-Tool ein." Outline ist das Gedächtnis. Doppel-Storage erodiert die Tool-Aufteilung.
### 2.8 „Plane-Issues spiegeln, damit man im Cockpit Tickets sieht"
- **Verworfen, weil:** Plane ist „jederzeit die Wahrheit" (Leitfaden §5). Ein Spiegel driftet auseinander. Wir verlinken auf Plane.
### 2.9 „CRUD für Projekte komplett aus dem Cockpit raus, nur API-Sync"
- **Verworfen, weil:** im MVP gibt es noch keinen API-Sync. Pragmatik vor Reinheit: das Cockpit pflegt eine reduzierte Sicht (Name, Verantwortliche/r, URLs, grobe Meilensteine), bis Phase 2 kommt. Die Doppelpflege wird offen kommuniziert und gemessen (CM4).
---
## 3. In-Depth-Personas (für UX-Phase)
### 3.1 Lukas, Entwickler, 28
- Macht morgens Code, will das Cockpit in unter 30 s pro Tag bedienen.
- Wechselt häufig zwischen 2–3 Projekten am Tag.
- Lästert intern, wenn das Tool ihn „checken" lässt. Sichtbar zu machen, dass Kollege X seit 5 Tagen blockt, empfindet er als hilfreich.
### 3.2 Dejan, Owner / Auftraggeber (P4), oft auch P1, 35
- Will im Jourfixe nicht mehr fragen „wie sieht's bei X aus" — sondern direkt klicken.
- Liest den Puls 2× täglich, schreibt selbst 1× Tagesupdate mit Bezug „Allgemein" oder zu einem Projekt.
- Größte Sorge: dass das Cockpit-Projekt das gleiche Schicksal erleidet wie Jira/Confluence zuvor.
### 3.3 Sales-Kollege (Q2), 30+
- Lebt im Kanban-Tab; bewegt 5–10 Karten pro Woche.
- Schreibt Tagesupdates ungern, wenn das Schreiben träge ist — daher CM1-Schwellwert (≤ 60 s Median).
- Will den eigenen Funnel-Snapshot stolz zeigen können — Marketing-Crosslink (FR-19) ist UI-relevant.
### 3.4 Marketing-Kollege (Q3)
- Aktualisiert wöchentlich Kampagnen, weniger täglich.
- Die tägliche Update-Pflicht ist die ungewohnteste Anforderung — UX muss kurze „heute kein Fortschritt, aber dran"-Updates erlauben.
### 3.5 Designerin / Buchhaltung (Q4, Q5)
- Schreiben Tagesupdates mit Bezug „Allgemein". Die UI darf sie nicht zwingen, ein Projekt zu wählen.
- Bereich = ihr eigener (Authentik-Group), Bezug-Default = „Allgemein".
---
## 4. Mechanik-Detail: Wie wir „Versandung" wirklich messen
Vier Indikatoren zusammen:
1. **Update-Quote pro Person/Tag** — direkter Disziplin-Indikator. Sinkt sie unter 70 %, ist die Cockpit-Kultur erodiert.
2. **Median-Update-Alter pro Projekt** — steigt der Median über 7 Werktage, hat das Projekt aufgehört zu leben.
3. **Anteil Meilensteine mit Status `overdue`** — steigt er über 30 %, sind Planung und Realität auseinandergedriftet.
4. **Pflicht-Minimum-Erfüllungsquote** (M6) — die Leitfaden-Brücke. Sinkt sie, geht es nicht nur am Status, sondern an der Methodik selbst.
Diese vier werden im Puls aggregiert und in der 4-Wochen-Retro besprochen.
---
## 5. Off-Brand-Risiken des Prototyps
Der HTML-Prototyp (`inputs/unternehmens-cockpit.html`) zeigt das gewünschte Konzept gut, trifft aber visuell nicht die Markenrichtung:
- Hintergrund: Hellgrau (`#eceef3`) — soll weiß sein.
- Header: dunkles Navy — passt nicht zu „weiß primär, schwarz sekundär".
- Akzentfarbe: Indigo (`#4f46e5`) — durch ToolCTRL-Brand-Akzent ersetzen.
- Ampelfarben (Grün/Amber/Rot): inhaltlich nötig, an die Brand-Palette adaptieren, ohne Funktion zu verlieren.
Die UX-Phase muss das Re-Skinning explizit durchführen — der Prototyp ist Logik-Referenz, keine Visual-Referenz. Die Voice-Anker aus dem Prototyp („Stark.", „Wie läuft es?", „Welt der Übersicht", „Willkommen, [Name]") sind zu bewahren — siehe NFR-12/13 im PRD.
---
## 6. Konzept-Vokabular
| Begriff | Bedeutung im Produkt | Quelle |
|---|---|---|
| **Puls** | Startseite — Unternehmens-Übersichtspuls. | Prototyp |
| **Area / Bereich** | Fachliche Spielwiese: Entwicklung, Vertrieb, Marketing. | Prototyp + Leitfaden |
| **Tagesupdate / DayEntry** | Kombinierter Tageseintrag einer Person: Einstempeln + ToDos + Reflexion + Ampel + Trend. | Leitfaden §5 + ToolCTRL-Workflow |
| **Einstempeln** | Morgendliche Anwesenheits-Aktion plus Anlegen der ToDo-Liste für den Tag. | ToolCTRL-Workflow |
| **ToDo** | Selbstgesetzter Tagesplan-Punkt mit optionalem Bezug, abends abhakbar. | ToolCTRL-Workflow |
| **Reflexion** | Abendlicher zweiter Touchpoint: ToDos abhaken, Freitext, Ampel, Trend. | ToolCTRL-Workflow |
| **„Mein heute"** | Persönliche Tagessicht (eigene ToDos, eigener Status) — privat während des Tages. | Cockpit-Konzept |
| **Konsolidierter Vortagseintrag** | Die für Kollegen sichtbare Version eines DayEntry, publiziert am nächsten Werktagsmorgen. | Cockpit-Konzept |
| **Bezug** | Worauf sich ein Tagesupdate bezieht: Projekt / Deal / Kampagne / Allgemein. | Prototyp |
| **Ampel** | Grün (im Plan) / Amber (Abweichung, Plan greift) / Rot (Abweichung, kein Plan). | Leitfaden §5 |
| **Trend** | besser / gleich / schlechter. | Leitfaden §5 |
| **Blocker** | Strukturiertes Hindernis, bereichsübergreifend sichtbar. | Prototyp |
| **Update-Serie / Streak** | Aufeinanderfolgende Werktage mit ≥ 1 Tagesupdate. | Prototyp |
| **Jourfixe** | Wöchentliches Treffen, vom Puls aus moderiert (Default Di 11:00). | ToolCTRL |
| **Crosslink** | Lead-Übergabe-Banner Marketing → Vertrieb. | Prototyp |
| **Bereichsübergreifend offen** | Label für die aggregierte Blocker-Liste im Puls. | Prototyp |
| **Pflicht-Minimum** | Die 6 Pflichtpunkte pro Projekt. | Leitfaden §9 |
| **Projektsteckbrief** | Eckdaten-Dokument in Outline. Das Cockpit verlinkt darauf. | Leitfaden §3 |
| **Zieldreieck** | Leistung & Umfang · Zeit · Aufwand. | Leitfaden §1 |
| **Meilenstein** | Überprüfbares Zwischenergebnis am Phasen-Ende. | Leitfaden Anhang |
| **Baseline** | Freigegebener Bezugsstand (Steckbrief nach Freigabe). | Leitfaden Anhang |
| **Scope Creep** | Schleichende, unkontrollierte Umfangserweiterung. | Leitfaden Anhang |
| **Definition of Done (DoD)** | Festlegung, wann etwas wirklich „fertig" ist. | Leitfaden Anhang |
| **Module / Issue / Sub-Issue** | Plane-Hierarchie der Arbeitszerlegung. | Leitfaden §4 |
| **Cycles / Kanban** | Zwei Arbeitsmodi der Umsetzungsphase. | Leitfaden §5 |
| **Retrospektive / Lessons Learned** | Strukturierter Rückblick am Projektende. | Leitfaden §6 |
| **Deal-Stage** | Lead → Erstgespräch → Demo → Angebot → Abschluss. | Prototyp |
| **GTM-Schritt** | Go-to-Market-Aufgabe pro Produkt. | Prototyp |
| **Lead-Funnel** | Reichweite → Website → Leads → MQL → Übergabe. | Prototyp |
| **Projektart** | Kundenprojekt oder Internes Projekt. | Leitfaden §1 |
| **Projektverantwortliche/r (P1)** | Eine Person pro Projekt, führt das Zieldreieck. | Leitfaden §7 |
---
## 7. Leitfaden-Bezüge (was setzt was um)
Tabelle zur Nachvollziehbarkeit, welche PRD-Anforderung auf welchen Leitfaden-Paragraphen zurückgeht. Hilft Architektur- und Story-Phase, die Methodik-Anbindung zu prüfen.
| Leitfaden-Abschnitt | Im PRD umgesetzt durch |
|---|---|
| §1 Was ein Projekt ist · Projektarten | FR-8 (Projektart-Gruppierung); Datenmodell `Project.kind`. |
| §1 Zieldreieck | Implizit in Ampel + Trend + Meilenstein-Status (kein eigenes UI). |
| §2 Vier-Phasen-Zyklus | FR-35-37 (Abschluss-Workflow); UJ-5 (Anlegen). |
| §3 Projektsteckbrief | A4 (kein Editor); FR-10 (Verlinkung); FR-30 Pflicht-Punkt 1. |
| §3 SMART-Ziele | nicht explizit im Cockpit (lebt in Outline); im Leitfaden §3 als Pflicht-Inhalt des Steckbriefs referenziert. |
| §3 Stakeholder | nicht im MVP; bleibt im Outline-Steckbrief. |
| §4 Arbeit zerlegen | A5 (kein Spiegel des Plane-Boards); FR-30 Pflicht-Punkt 3. |
| §4 Meilensteine | FR-11 Cockpit-Sicht; FR-30 Pflicht-Punkt 4. |
| §4 Aufwand schätzen | Out of Scope — Kimai + Plane decken ab. |
| §4 Risiken | FR-10 (Risikoliste-URL verlinken); Liste bleibt in Outline. |
| §5 Arbeitsmodus (Cycles/Kanban) | Datenmodell `Project.arbeitsmodus`; angezeigt in FR-10. |
| §5 Rhythmus → tägliche Updates im Cockpit | gesamte Feature-Gruppe E (Einstempeln · ToDos · Reflexion). |
| §5 Status sichtbar machen (Ampel + Trend + 2-3 Sätze) | FR-26 Reflexions-Formular (Ampel, Trend, Freitext ≤ 1000 Zeichen). |
| §5 Mit Änderungen umgehen | Out of Scope MVP; ändert nur den Outline-Steckbrief. |
| §5 Reviews an Meilensteinen | FR-11 Meilenstein-Status; UJ-3 Verfall-Erkennung. |
| §6 Abschluss / Lessons Learned | FR-35-37; Pflicht-Punkt 6. |
| §7 Rollen | §4.1 PRD (Projektverantwortliche/r, Team, PO, Auftraggeber). |
| §8 Tool-Aufteilung | A3-A5 PRD; gesamtes Strategie-Framing. |
| §9 Pflicht-Minimum | Feature-Gruppe G (FR-30); M6; Puls-Sichtbarkeit. |
---
*Ende Addendum.*
@@ -0,0 +1,332 @@
# HTML-Prototyp Extract
Quelle: `inputs/unternehmens-cockpit.html` (1.214 Zeilen, Single-File-Vanilla-JS-Prototyp, deutsche Sprache, `TODAY="2026-05-21"` hart kodiert, Persistenz via `localStorage` Key `toolctrl_unternehmens_cockpit_v0_2`).
Titel der App: **tool-ctrl · Unternehmens-Cockpit — v0 Prototyp**
Marker im UI: `v0 PROTOTYP` Pill im Header.
---
## Top-Level-Navigation / Hauptbereiche
Im Header gibt es **zwei Top-Level-Views** (umschaltbar via `nav button`):
1. **Cockpit** (Default) — zeigt Unternehmens-Puls + Detail eines ausgewählten Bereichs.
2. **Tagesupdate** — ein Formular zum Erfassen eines neuen Tagesupdates.
Innerhalb der Cockpit-View gibt es **drei Bereiche** (Areas) als Sub-Navigation via "Area-Tiles":
- **Entwicklung**
- **Vertrieb**
- **Marketing**
Header enthält außerdem:
- Brand-Marker (Dot + Titel + v0-Pill).
- Live-Datum "Heute · Mo, 21. Mai 2026".
- Button **"Demodaten zurücksetzen"** (cleart `localStorage` + lädt `SEED_UPDATES`).
Davor: **Intro / Splash-Screen** (`#intro`) — animierter HUD-Kreis, "Willkommen, Haris", User-Pill (HA · Vertrieb & Management · grüner Online-Dot), Enter-Button (oder Enter-Taste), dann fade-out.
---
## Module / Features (gruppiert)
### Unternehmens-Puls (oberster Karten-Block im Cockpit)
- **Zweck:** schneller Überblick über alle drei Bereiche auf einen Blick + offene Querschnitts-Themen.
- **Datenfelder pro Area-Tile:** Name, Status-Dot (green/amber/red), Status-Pill ("Im Plan" / "Gefährdet" / "Blockiert"), zwei Key-Metrics (variabel pro Bereich), Updates-Heute-Counter `sub/exp` + Progress-Bar.
- **Area-Tile-Metriken:**
- Entwicklung: `Projekte im Plan` (z. B. 4/6), `Meilensteine gesamt` (% erledigt).
- Vertrieb: `Aktive Deals` (#), `Pipeline-Wert` (EUR).
- Marketing: `Kampagnen live` (#), `Leads an Vertrieb` (# letzter Funnel-Step).
- **UI-Patterns:** 3-Spalten-Grid mit Tiles (klickbar, `on`-State markiert ausgewählte Area), darunter zweigeteilte Foot-Sektion.
- **Foot-Sektion:**
- Links: "X von Y Tagesupdates sind heute eingetragen" + Big-Progress-Bar + **Jourfixe-Hinweis** ("Nächstes Jourfixe — Di, 26. Mai, 11:00 · übergeordnete Themen aller Bereiche", berechnet via `nextTuesday()`).
- Rechts: **"Bereichsübergreifend offen"** — rote Chips für alle aktuellen Blocker (dedupliziert per area+blocker-Text, abgeschnitten >52 Zeichen). Bei keiner Blockade grüner Text "Aktuell keine offenen Blocker."
- **Interaktionen:** Klick auf Area-Tile setzt `state.selected` und scrollt nach oben; Klick auf roten Blocker-Chip navigiert zur betroffenen Area.
- **Status:** fertig und voll funktional.
### Bereichs-Detail: Entwicklung
- **Zweck:** Konsolidierte Sicht aller Entwicklungsprojekte mit Meilensteinen und Tagesupdates.
- **Layout:** `dhead` (Bereichs-Kopf) + 2-Spalten-Grid: **Projekt-Rail links (262px)** + **Projekt-Detail rechts**.
- **Bereichs-Kopf (`dhead`):** Status-Dot, Bereichsname "Entwicklung", Pill, Leitung (Person), Updates-Heute, Blurb-Text ("Alle 6 Produkt- und Infrastrukturprojekte mit Status, Meilensteinen und Tagesupdates — Projekt links wählen.").
- **Bereichs-Stats (4 Tiles):** `Projekte` (6 · "3 Umsatz · 3 Intern"), `Im Plan` (X/6), `Meilensteine` (X/Y + Bar), `Updates heute` (X/Y + Bar).
- **Projekt-Rail:** gruppiert in **"Umsatz"** und **"Intern"**; jedes `pitem` zeigt: Status-Dot, Projektname, nächster Meilenstein-Name, Due-Text (`in N Tagen` / `heute fällig` / `N Tage überfällig` mit warn/over-Färbung), `done/total` Meilensteine, mini-Progress-Bar. `on`-State für selektiertes Projekt.
- **Projekt-Detail (rechte Spalte):** eigener `dhead` mit Projektname (h1), Status-Pill, Gruppe-Tag ("Umsatz"/"Intern"), Leitung. Dann 4 Stats: `Status` (Pill, "aus dem letzten Update"), `Nächster Meilenstein` (Name + Datum + due-Text), `Fortschritt` (X/Y + Bar), `Updates heute` (X/Y + "Update-Serie"-Streak-Counter).
- **Darunter 2-Spalten-Grid (1fr 290px):**
- **Tagesupdates-Feed** (links): chronologisch nach Datum gruppiert, "Heute"-Marker; jedes Update zeigt Avatar mit Initialen + Personen-Farbe, Name, Rolle, Status-Pill, Text, optional Blocker-Box (rot). "+ Update hinzufügen" Button (oben rechts) prefillt Formular mit Area+Ref.
- **Meilensteine-Liste** (rechts): Checkliste mit Box, Name, Fälligkeitsdatum; Zustände `done` (grün gefüllt, durchgestrichen), `next` (lila Outline), normal.
- **Status:** fertig.
### Bereichs-Detail: Vertrieb
- **Zweck:** Deal-Pipeline + Go-to-Market-Fortschritt je Produkt.
- **Bereichs-Stats (4):** `Aktive Deals`, `Pipeline-Wert` (EUR Summe), `Gewichtet` (Σ value × Stage-Wahrscheinlichkeit), `Gewonnen` (# + EUR).
- **Crosslink-Banner:** "X Leads hat Marketing diesen Monat in die Pipeline übergeben — Marketing-Status ansehen" (Pfeil-Icon, klickt zu Marketing).
- **Deal-Pipeline-Board (Kanban-Style):** 5 Spalten = Stages `Lead`, `Erstgespräch`, `Demo`, `Angebot`, `Abschluss`. Spaltenkopf: Stage-Label + "N Deals · €Summe". Deal-Karten: Status-Dot, Kundenname, EUR-Wert, Produkt-Tag (Caps, z. B. "HIVEGRID"), Next-Step-Text.
- **Vertriebsfortschritt je Produkt (GTM):** pro Produkt eine Karte mit Name, "X/Y Schritte", Progress-Bar, Schritt-Liste mit Box (Zustände `done`/`next`/`blocked`/`open`) + Tags ("als Nächstes" / "blockiert").
- **Tagesupdates-Feed** (gleicher Feed-Style wie Entwicklung, aber mit `upd-ref`-Badge = Referenz zu Deal/Kampagne/"(allgemein)").
- **Status:** fertig.
### Bereichs-Detail: Marketing
- **Zweck:** Lead-Funnel + Kampagnen-Übersicht.
- **Bereichs-Stats (4):** `Reichweite` (#), `Leads gesamt`, `An Vertrieb` (Übergabe-Counter), `Kampagnen live` (X von Y).
- **Crosslink-Banner:** "Die N übergebenen Leads landen im Vertrieb — aktuelle Pipeline: €X" (klickt zu Vertrieb).
- **Lead-Funnel-Visualisierung:** 5 Stufen (Reichweite → Website-Besucher → Leads → Qualifiziert (MQL) → An Vertrieb übergeben). Pro Zeile: Label + Sub-Label, horizontale gefüllte Bar (Breite relativ zum Maximum, Wert eingebrannt), Conversion-% zur Vorstufe ("X% Übergang"). Letzte Zeile = "handover" mit grünem Gradient.
- **Kampagnen-Liste:** flache Liste, pro Zeile: Name + Channel (Sub-Text), Verantwortlicher, Leads-Count, Status-Pill (`läuft`, `geplant`, `ausgewertet`, `blockiert`, `pausiert` — je eigene Farbe).
- **Tagesupdates-Feed** (gleicher Feed-Style).
- **Status:** fertig.
### Tagesupdate-Formular (View 2)
- **Zweck:** strukturierte Eingabe eines täglichen Status-Updates.
- **Layout:** 2-Spalten (Formular-Karte 1fr + Side-Nudge 300px).
- **Formular-Felder:**
- `Wann` — statisch "Heute — Mo, 21. Mai 2026" (read-only Box).
- `Wer bist du?` — `<select>` aller TEAM-Mitglieder mit "Name — Rolle".
- `Bereich` — `<select>` Entwicklung/Vertrieb/Marketing.
- `Bezug` (Projekt, Deal oder Kampagne) — dynamische `<select>` Optionen je nach Bereich; Marketing/Vertrieb haben zusätzlich `(allgemein)`.
- `Was hast du heute geschafft?` — `<textarea>` (Placeholder mit Beispiel).
- `Wie läuft es?` — 3 Status-Optionen (Cards mit Dot + Titel + Sub): **Im Plan** (grün, "läuft nach Plan") / **Gefährdet** (amber, "gerät in Verzug") / **Blockiert** (rot, "brauche Hilfe").
- `Etwas, das dich blockiert oder wobei du Hilfe brauchst?` — optionale `<textarea>`.
- Fehler-Slot (`#f-err`) + Submit-Button "Tagesupdate absenden".
- **Validierung:** Person, Bereich, Text und Status sind Pflicht; Ref defaults zu `(allgemein)`.
- **Submit-Verhalten:** pusht in `updates`-Array, persistiert in `localStorage`, springt zurück in Cockpit-View des gewählten Bereichs, zeigt Toast "Update von X erfasst · Bereich".
- **Side-Nudge-Karte (rechts):**
- "Heute noch offen" — pro fehlendem Update ein roter Chip "Person · Bereich" (Klick prefillt Formular). Wenn alle abgegeben: "Alle Tagesupdates sind da. Stark." (grün).
- Trennlinie + "Der Rhythmus" — Erklärtext zum täglichen Update + Jourfixe-Termin (Di 11:00).
- **Status:** fertig und voll funktional.
### Intro / Splash-Screen
- **Zweck:** Willkommens-Animation beim Aufruf.
- **Inhalt:** "Willkommen, Haris", User-Avatar-Pill mit Online-Dot, Enter-Button.
- **Interaktion:** Klick auf Enter-Button oder Enter-Taste blendet aus.
- **Status:** dekorativ, kosmetisch.
### Toast
- Globale Toast-Komponente (`#toast`) am unteren Bildschirmrand für Bestätigungs-Messages (Update erfasst, Demodaten zurückgesetzt). Auto-Hide nach 3,2 s.
---
## KPI-Visualisierungen
Im Prototyp verwendete Visualisierungen:
- **Status-Ampel-Dots** (`.sdot`) in green/amber/red — überall, kleinste Atom-Komponente.
- **Status-Pills** (`.pill`) mit Label "Im Plan" / "Gefährdet" / "Blockiert".
- **Progress-Bars** (mehrere Varianten):
- `.tbar` (mini, in Area-Tiles für Updates-Quote heute).
- `.bigbar` (Puls-Foot für gesamte Update-Quote).
- `.ministat-bar` (in Stat-Kacheln für Meilenstein- und Update-Progress).
- `.pi-bar` (in Projekt-Rail-Items für Meilenstein-Fortschritt).
- `.sprod-bar` (in GTM-Produkt-Karten).
- **Meilenstein-Checkliste** (`.ms` Items) mit drei Box-Zuständen: done (grün/check), next (lila Outline mit Glow), blocked (roter Outline mit Glow); normal-State leere Box.
- **Kanban-Pipeline-Board** mit 5 Spalten (Deal-Stages).
- **Horizontaler Funnel** (5 Stufen, absteigende Bar-Breite proportional zum Wert, Conversion-% zwischen Stufen).
- **Streak-Counter** (Update-Serie Tage am Stück, im Projekt-Detail).
- **Due-Date-Färbung**: warn (amber, ≤4 Tage) / over (rot, überfällig).
- **Gewichteter Pipeline-Wert** (Σ value × p) als KPI im Vertrieb.
- **Conversion-Raten** (% zwischen Funnel-Stufen).
- **Status-Rollup-Logik** (`rollup()`): aggregiert Einzel-Status zu Area-Status (≥2 rot → red, ≥1 rot oder ≥3 amber → amber, sonst green).
Explizit **NICHT vorhanden:** Burn-down-Charts, Status-Pie-Charts, Zeitreihen-Charts, Trend-Linien, prozentuale Donuts, Heatmaps. Alle "Charts" sind 1D-Bars oder Listen.
---
## UI-Patterns (mehrfach auftauchend)
- **Card** (`.card`) — weiße Box mit `border-radius:14px` + Schatten; Basis-Container für alles.
- **Section-Title** (`.sec-title`) — Header in Cards mit optionalem Counter-Badge (`.cnt`) und rechts-bündigem Action-Button.
- **Sect-Label** (Caps + letter-spacing) — kleine Sektionsüberschrift.
- **Stat-Tile** (`.stat`) — kleine Metric-Box mit Label/Wert/Sub/optional Bar; meist 4er-Grid (`.stats`).
- **Chip** (`.chip`) — runder farbiger Tag, hier in red-Variante für Blocker.
- **Status-Pill** (`.pill`) — Pille in 3 Farben (green/amber/red).
- **Group-Tag** (`.grp-tag`) — kleines neutrales Caps-Label (z. B. "UMSATZ", "INTERN").
- **Avatar mit Initialen** (`.avatar`) — runder gefärbter Kreis mit 2-Buchstaben-Initialen, Farbe pro Person.
- **Crosslink-Banner** (`.crosslink`) — gerahmte klickbare Zeile mit Pfeil-Icon für Bereich-zu-Bereich-Verweise.
- **Feed-Item** (`.upd`) — Avatar + Name/Rolle/Ref/Status + Text + optional Blocker-Box; gruppiert nach `.fdate` (Datums-Header mit "Heute"-Highlight).
- **Blocker-Box** (`.blocker`) — rote bezugnehmende Sub-Box innerhalb eines Feed-Items.
- **Rail-Item** (`.pitem`) — sidebar list item mit `on`-Indikator (linker Strich) und Hover-State.
- **Status-Option-Card** (`.sopt`) — Radio-Karten-Pattern für Status-Wahl im Formular.
**Keine Modals.** Es gibt im Prototyp keine Dialoge, Popovers, Tooltips oder Dropdowns außer nativen `<select>`-Elementen und Tabs.
---
## Interaktionen / Klick-Flows
Implementierte Mock-Interaktionen (alle via Vanilla JS / `wire()`):
1. **Top-Nav umschalten** (Cockpit ↔ Tagesupdate) via `[data-nav]`.
2. **Area-Tile-Klick** wechselt aktiven Bereich (`state.selected`), scrollt nach oben.
3. **Projekt-Rail-Item-Klick** wechselt aktives Dev-Projekt (`state.devProject`).
4. **Blocker-Chip-Klick** (Puls-Foot) → Sprung in betroffenen Bereich.
5. **Crosslink-Banner-Klick** → Sprung in verlinkten Bereich.
6. **"+ Update hinzufügen"-Button** in Feed/Projekt-Detail → prefillt Formular (Area + ggf. Ref) und fokussiert Text-Feld.
7. **"Missing"-Chip-Klick** (Side-Nudge) → prefillt Formular mit Person + Area.
8. **Status-Option-Klick** im Formular setzt `state.formStatus` (immediate render).
9. **Submit-Button**: validiert, fügt Update zu `updates`-Array hinzu, persistiert in `localStorage`, navigiert zurück + Toast.
10. **"Demodaten zurücksetzen"** im Header: bestätigt + ersetzt updates mit `SEED_UPDATES`.
11. **Intro-Splash**: Enter-Button oder Enter-Taste blendet aus.
---
## Datenmodell (impliziert)
### `TEAM` (Mitglied)
- `id` (string slug, z. B. "haris")
- `name` (string)
- `role` (string, z. B. "Vertrieb & Management", "Senior Software Engineer", "Junior Software Engineer", "Junior Infrastructure/Software Engineer", "Designer")
- `color` (hex, Avatar-Farbe)
Es gibt 5 fest hinterlegte Personen. Keine echten User-Accounts/Auth.
### `AREA` (Bereich)
- `id` (slug: "entwicklung" | "vertrieb" | "marketing")
- `name` (string)
- `lead` (TEAM-id, Bereichsleitung)
- `members` (array of TEAM-ids)
- `blurb` (string, Bereichsbeschreibung)
### `DEV_PROJECT`
- `id` (slug)
- `name` (string)
- `group` ("Umsatz" | "Intern")
- `lead` (TEAM-id)
- `members` (array of TEAM-ids)
- `milestones`: array von Objekten `{ name:string, done:boolean, due:ISO-Date }`
### `Milestone`
- `name` (string)
- `done` (boolean)
- `due` (ISO-Date)
### `STAGE` (Vertriebs-Pipeline-Stufe)
- `id` (slug)
- `label` (string: "Lead", "Erstgespräch", "Demo", "Angebot", "Abschluss")
- `p` (Abschlusswahrscheinlichkeit, float 0–1: 0.10/0.25/0.50/0.75/0.90)
### `DEAL`
- `customer` (string)
- `product` (string, derzeit "HiveGrid" oder "Asset Control")
- `stage` (STAGE-id)
- `value` (number, EUR)
- `status` ("green" | "amber" | "red")
- `next` (string, nächster Schritt / Notiz)
### `WON_DEAL`
- `customer`, `product`, `value`, `closed` (ISO-Date)
### `SALES_GTM[product]` — pro Produkt eine Liste von GTM-Schritten
- `name` (string)
- `state` ("done" | "next" | "blocked" | "open")
### `CAMPAIGN`
- `name` (string)
- `channel` (string, z. B. "LinkedIn + Google Ads", "E-Mail (monatlich)", "Event / Messe", "Lokalpresse", "Content / Website", "Google Ads")
- `status` ("laeuft" | "geplant" | "ausgewertet" | "blockiert" | "pausiert")
- `leads` (number)
- `owner` (TEAM-id)
### `FUNNEL` (5 ordered steps)
- `label` (string)
- `sub` (string, Erklärung)
- `value` (number)
Stages: Reichweite → Website-Besucher → Leads → Qualifiziert (MQL) → An Vertrieb übergeben.
### `UPDATE` (Tagesupdate, das zentrale Entity)
- `area` (AREA-id)
- `ref` (string — Bezug; Projektname, Kundenname, Kampagnenname oder "(allgemein)")
- `person` (TEAM-id)
- `date` (ISO-Date)
- `status` ("green" | "amber" | "red")
- `text` (string, freier Text "was geschafft")
- `blockers` (string, optional; leerer String wenn keiner)
Persistiert in `localStorage` Key `toolctrl_unternehmens_cockpit_v0_2`.
### State (UI)
- `view` ("cockpit" | "form")
- `selected` (AREA-id, aktive Area im Cockpit)
- `devProject` (DEV_PROJECT-id, aktives Projekt in Entwicklungs-Rail)
- `formPerson`, `formArea`, `formRef`, `formStatus`, `_text`, `_blockers` (Formular-State)
---
## Rollen / Rechte / Filter
- **Rollen** sind als freitextliche `role`-Strings hinterlegt (Vertrieb & Management, Senior/Junior Software Engineer, Junior Infrastructure/Software Engineer, Designer). **Keine** Permission-Logik, keine Rollen-Gates, kein Auth. Jeder kann sich beim Tagesupdate als beliebige Person ausgeben.
- **Tags:** Es gibt Projekt-Gruppen-Tags ("Umsatz"/"Intern"), Produkt-Tags an Deals, Channel-Texte an Kampagnen, aber **keine freien Tags** oder Tagging-System.
- **Filter:** Es gibt **keine expliziten Filter-UI-Elemente** (keine Suche, kein Datumsfilter, keine Personen-Filter). Filterung erfolgt nur implizit durch Area-Auswahl und Projekt-Auswahl.
---
## Vokabular / Begriffe
Wichtige Begriffe und ihre Verwendung:
- **Cockpit** — das Gesamtprodukt; auch Name der Default-View.
- **Unternehmens-Puls** ("Puls") — Overview-Block ganz oben mit den Area-Tiles.
- **Bereich** / **Areas** — Top-Level-Domänen (Entwicklung, Vertrieb, Marketing).
- **Tagesupdate** — täglicher Status-Eintrag pro Person/Bereich/Bezug.
- **Bezug** — die Sache, auf die sich ein Tagesupdate bezieht (Projekt, Deal, Kampagne, "(allgemein)").
- **Jourfixe** — wiederkehrendes Team-Meeting (Dienstag 11:00) für übergeordnete Themen.
- **Update-Serie** / **Streak** — aufeinanderfolgende Tage mit Updates für ein Projekt.
- **Blocker** — explizit benannte Hindernisse in Updates; werden bereichsübergreifend aggregiert.
- **Bereichsübergreifend offen** — Cross-Area-Blocker-Aggregation.
- **Ampel** (green/amber/red) — Status-System; Labels: **Im Plan** / **Gefährdet** / **Blockiert**.
- **Meilenstein** — DEV_PROJECT-Schritt mit Name + done + due-Datum.
- **Pflichtenheft** — projektspezifischer Begriff (Spec-Dokument).
- **Deal-Pipeline** — 5-stufiger Vertriebs-Funnel.
- **Stages:** Lead, Erstgespräch, Demo, Angebot, Abschluss.
- **Pipeline-Wert** / **Gewichteter Wert** — Summen-KPIs im Vertrieb.
- **GTM** / **Vertriebsfortschritt je Produkt** — Go-to-Market-Schrittliste pro Produkt.
- **Lead-Funnel** — 5-stufiger Marketing-Funnel.
- **MQL** ("Qualifiziert (MQL)") — Marketing-Qualified Lead.
- **Reichweite** — Top-of-Funnel-Metrik.
- **Übergabe / An Vertrieb übergeben** — Funnel→Pipeline-Transition.
- **Kampagne** — Marketing-Aktivität mit Channel und Status.
- **Kampagnen-Status:** läuft, geplant, ausgewertet, blockiert, pausiert.
- **Gruppen** (Projekt-Gruppen): **Umsatz** vs. **Intern**.
- **Crosslink** — Verweis zwischen Bereichen.
- **Demodaten** — die SEED-Beispieldaten.
- **Produkte (im Prototyp benannt):** **HiveGrid**, **Asset Control**, **Vereins-App**, **Server / Infrastruktur**, **ProdValid**, **PostValid**.
Hinweis: Im Code-Kommentar erwähnt: *"Das separate Entwicklungs-Cockpit (index.html) bleibt eigenstaendig bestehen; hier ist Entwicklung eine verdichtete Bereichssicht."* — deutet auf ein paralleles, detaillierteres Dev-Cockpit-Tool außerhalb dieses Prototyps hin.
---
## Lücken / Unklarheiten / Skelette
- **Keine echte Auth / Identität.** Es gibt keinen Login. Der Splash zeigt fix "Haris", aber das Formular lässt frei wählen, wer man ist. Keine Sessions, keine Audit-Trails.
- **Keine Persistenz auf Server.** Alles im `localStorage` des Browsers; multi-user-uneinsichtbar.
- **TODAY ist hart kodiert** (`"2026-05-21"`). Keine echte Zeit, keine Zeitzonen, kein Datepicker.
- **Keine Editier-/Löschfunktionen** für Updates, Projekte, Deals, Kampagnen, Meilensteine. Tagesupdates können nur hinzugefügt werden, nicht korrigiert.
- **Keine Erstellung neuer Entitäten im UI.** DEV_PROJECTS, DEALS, CAMPAIGNS, FUNNEL, SALES_GTM, TEAM, AREAS sind im JS-Code statisch hinterlegt — kein CRUD-UI.
- **Meilensteine ändern sich nicht** über Updates; `done`-Flag ist statisch im Seed-Datensatz.
- **Status pro Projekt** wird aus dem **letzten Update** abgeleitet (`devStatus(p)` nimmt `f[0].status`) — keine separate Status-Eingabe pro Projekt.
- **Keine echten Visualisierungen** außer Bars und Listen. Keine Library (Chart.js etc.).
- **Keine Integration zu Plane** (Tickets) oder **Outline** (Doku) sichtbar — der Prototyp ist standalone.
- **Plane/Outline werden nicht referenziert** in der HTML/JS — diese externen Tools sind im Prototyp gar nicht present, obwohl die User-Anfrage sie nennt.
- **Keine Kommentar- oder Reaktions-Funktion** auf Updates.
- **Keine Notifications** außer dem in-app Toast.
- **Keine Suche.**
- **Keine Filter, Sortierungen oder Datumsbereiche** auf Feeds.
- **Keine Pagination** — Feeds zeigen alle Updates.
- **Won-Deals** werden im KPI-Tile gezählt, aber **nirgendwo gelistet/detailliert** (kein Won-Deal-Board).
- **"Vereins-App", "ProdValid", "PostValid"** etc. sind als Projekte im Code, aber keine Detail-Pages außerhalb der Standard-Projekt-Detail-Ansicht.
- **"Pausiert"-Kampagnen-Status** ist im CSS und im Status-Mapping vorhanden, wird aber von keiner Beispiel-Kampagne genutzt — toter Code-Pfad.
- **"WON_DEALS"** Daten sind erfasst, aber nur als Aggregat sichtbar.
- **Side-Nudge "Der Rhythmus"** ist reiner Erklärtext — keine konfigurierbaren Rhythmen.
- **Mobile/Responsive:** das Layout ist auf 1280 px max-width + viele festgelegte Grid-Spalten ausgelegt; **keine Responsive-Anpassung** im CSS.
- **Lokalisierung:** komplett deutsch, hartkodiert (Wochentage, Monate).
- **Keine Kommentare/Threads, keine Anhänge, keine Datei-Uploads.**
- **Keine Roadmap/Timeline-Visualisierung** (Gantt o. ä.).
- **Keine Trend-Daten** über Zeit; alle KPIs sind Snapshots auf TODAY.
---
## Sektionen, die unfertig / Platzhalter sind
Im Sinne von "leere Skelette" gibt es im Prototyp eigentlich keine — alle gerenderten Bereiche sind mit Demo-Daten gefüllt. Die "Lücken" oben sind eher fehlende Konzepte / Features. Vereinzelte tote Code-Pfade:
- `cstatus.pausiert` Stil ohne Daten.
- `feed-empty` ("Noch keine Updates in diesem Bereich.") und Projekt-Feed-Empty ("Noch keine Updates für dieses Projekt.") nur bei leerem State.
- Submit-Fehler-Slot (`#f-err`) leer im Default-Render.
@@ -0,0 +1,404 @@
---
title: PRD – ToolCTRL Unternehmens-Cockpit
status: final
created: 2026-05-25
updated: 2026-05-25
owner: Dejancosic
audience: ToolCTRL (intern, alle Mitarbeiter)
binding_frame: ToolCTRL Projektmanagement-Leitfaden v3.0 (Mai 2026)
---
# PRD – ToolCTRL Unternehmens-Cockpit
> **Was das ist.** Eine interne Web-Anwendung als tägliches Übersichts-Cockpit über alle laufenden Projekte und Bereiche von ToolCTRL. Sie operationalisiert den **ToolCTRL Projektmanagement-Leitfaden v3.0** als drittes Werkzeug neben **Plane** (Arbeit) und **Outline** (Gedächtnis) — im Leitfaden §5 (Rhythmus) so vorgesehen.
>
> **Wofür dieses Dokument da ist.** Es legt fest, was das Cockpit im MVP können muss. Capability-orientiert; technische Tiefe lebt im `addendum.md`.
---
## 1. Vision & Problemkontext
### 1.1 Das echte Problem
ToolCTRL hat **kein Tool-Problem, sondern ein Durchziehen-Problem.** Dank KI-gestützter Entwicklung starten wir 10+ Projekte parallel. Die Anfangsphase ist schnell und motivierend. Sobald Reibung entsteht, versandet das Projekt: Updates bleiben aus, Meilensteine schleifen, Verantwortlichkeit löst sich auf, Markt-Releases bleiben aus.
Wir hatten Jira und Confluence im Einsatz und haben mittendrin damit aufgehört, weil wir „schneller ohne PM" sein wollten. Ergebnis: Wir bekommen nichts fertig. Wir holen die strukturierte Projektarbeit jetzt zurück — mit der **dreigeteilten Werkzeug-Logik des Leitfadens**:
| Ebene | Werkzeug | Funktion (Leitfaden §5, §8) |
|---|---|---|
| **Arbeit** | **Plane** | Module → Issues → Sub-Issues, Boards, Cycles. *„Plane ist jederzeit die Wahrheit über den aktuellen Stand."* |
| **Gedächtnis** | **Outline** | Projektsteckbrief, Risikoliste, Status-Notizen, Entscheidungen, Lessons Learned. |
| **Übersicht / Disziplin** | **Cockpit** (dieses Produkt) | Grober Überblick über alle Projekte, tägliche Updates und Check-ins, illustrierte Unternehmensbereiche. |
Das Cockpit ist die Antwort auf: *„Warum versanden unsere Projekte? Weil niemand täglich gezwungen ist, sichtbar zu machen, wo er steht — und weil das Leitfaden-Pflicht-Minimum schleichend erodiert."* Das Cockpit erzwingt Sichtbarkeit und macht Erosion früh erkennbar.
### 1.2 Vision in einem Satz
**Das Cockpit ist der Ort, an dem jeder Mitarbeiter in unter 60 Sekunden sieht, woran heute gearbeitet wird, was klemmt, welche Projekte aus dem Plan laufen und welche das Pflicht-Minimum des Leitfadens nicht (mehr) erfüllen — und an dem niemand sich tagelang wegducken kann.**
### 1.3 Warum jetzt
- „Kein PM" als Strategie ist gescheitert.
- Der Leitfaden v3.0 setzt die verbindliche Rahmen-Methodik — das Cockpit ist sein operatives Tagesgesicht.
- Plane (Tickets) und Outline (Doku) decken den *aggregierten Status* und das *tägliche Sichtbarmachen* nicht ab.
- Das Cockpit muss vor der nächsten Welle neuer Projekte stehen, damit wir nicht in dasselbe Muster fallen.
---
## 2. Ziele & Anti-Ziele
### 2.1 Ziele (was wir erreichen wollen)
- **G1** – Jeder aktive Mitarbeiter schreibt mindestens 1× pro Werktag ein Tagesupdate. Die Quote ist öffentlich sichtbar.
- **G2** – Jedes laufende Projekt hat jederzeit einen klar erkennbaren Ampelstatus (Leitfaden §5: Grün / Gelb / Rot) inkl. Trend und einen visuellen Deadline-/Meilenstein-Verlauf.
- **G3** – Bereichsübergreifende Blocker sind innerhalb von 24h für alle Beteiligten sichtbar.
- **G4** – Das Cockpit ist feste erste Anlaufstation des Jourfixe (Di 11:00) und der täglichen Routine.
- **G5** – Mehr Projekte erreichen die „Marktreife / Release"-Phase, weil Stagnation früh sichtbar wird.
- **G6** – Erfüllung des **Pflicht-Minimums** (Leitfaden §9) ist pro Projekt sofort sichtbar; nicht erfüllte Punkte sind im Puls aufgelistet.
### 2.2 Anti-Ziele (was wir explizit NICHT bauen)
- **A1** – Kein **Ticketsystem**. Tickets bleiben in Plane.
- **A2** – Keine **Doku**. Wissens-Seiten, Steckbriefe, Risikolisten, Lessons Learned bleiben in Outline.
- **A3** – **Kein zusätzliches Projektmanagement-Tool** (Leitfaden §8: „Wir führen kein zusätzliches Projektmanagement-Tool ein."). Cockpit hält sich strikt an die Tool-Aufteilung.
- **A4** – **Kein Steckbrief-Editor.** Steckbrief lebt in Outline (Leitfaden §3). Das Cockpit verlinkt und referenziert.
- **A5** – **Kein gespiegeltes Plane-Board.** Die Issue-Liste bleibt in Plane.
- **A6** – **Keine externe Kundenkommunikation** (kein CRM, kein Kundenportal).
- **A7** – **Keine Zeiterfassung** — Kimai existiert.
- **A8** – **Kein Werkzeug zum Verkauf.** Das Cockpit ist und bleibt rein intern.
- **A9** – **Kein konfigurierbares Reporting-/BI-Dashboard** im MVP. Nur die im PRD spezifizierten Aggregate.
---
## 3. Erfolgskriterien & Gegenmetriken
### 3.1 Erfolgsmetriken
| ID | Metrik | Zielwert nach 8 Wochen Live-Betrieb |
|---|---|---|
| M1 | Anteil Werktage mit ≥1 Tagesupdate pro aktiver Person | ≥ 80% |
| M2 | Mittlere Zeit von „Blocker eingetragen" bis „im Puls sichtbar" | < 5 Minuten |
| M3 | Anteil Projekte mit aktuellem Ampelstatus (Update ≤ 3 Werktage alt) | ≥ 90% |
| M4 | Anteil Jourfixes, die das Cockpit als Hauptview nutzen | 100% |
| M5 | Aktiv genutzte Bereiche (Dev / Sales / Marketing) bekommen wöchentlich Updates | 3/3 |
| M6 | Anteil aktiver Projekte, die alle 6 Leitfaden-§9-Pflicht-Punkte erfüllen | ≥ 90% |
### 3.2 Gegenmetriken (was wir nicht kaputt machen dürfen)
| ID | Gegenmetrik | Grenze |
|---|---|---|
| CM1 | Gesamt-Tageszeit im Cockpit pro Person (Median, Werktag) | ≤ 3 Minuten |
| CM1a | Zeit pro Morgen-Einstempeln + ToDos (Median) | ≤ 60 Sekunden |
| CM1b | Zeit pro Abend-Reflexion (Median) | ≤ 90 Sekunden |
| CM2 | Anteil inhaltsleerer Pflicht-Updates | qualitativ — Jourfixe-Diskussion |
| CM3 | Spannungs-/Lästergefühl durch „fehlt heute"-Anzeige | qualitativ — 4-Wochen-Retro |
| CM4 | Doppelpflege Cockpit ↔ Outline-Steckbrief | qualitativ — wenn Steckbrief-Felder im Cockpit dupliziert werden, justieren wir |
> [NOTE FOR PM] CM2/CM3/CM4 sind qualitativ und werden 4 Wochen nach Launch im Jourfixe reflektiert.
---
## 4. Nutzer & Rollen
### 4.1 Leitfaden-Rollen (§7) – pro Projekt
| Rolle | Aufgabe im Cockpit-Kontext |
|---|---|
| **Projektverantwortliche/r** (P1) | Pflegt Ampelstatus + Trend, achtet auf Pflicht-Minimum, moderiert Cockpit-Sicht im Jourfixe für ihr/sein Projekt. |
| **Team** (P2) | Schreibt Tagesupdates mit Projektbezug; setzt Blocker; aktualisiert Meilenstein-Status. |
| **Product Owner** (P3, bei Produktprojekten) | Lese-Schwerpunkt; nutzt das Cockpit zur Priorisierungs-Diskussion. |
| **Auftraggeber** (P4, intern = Geschäftsführung) | Lesender Hauptnutzer für Pflicht-Minimum und Puls. |
### 4.2 Querschnittsrollen – alle Mitarbeiter
Alle Mitarbeiter sind aktive Cockpit-Nutzer, unabhängig vom Leitfaden-Rolle-Hut:
| Querschnitt | Hauptnutzen am Cockpit |
|---|---|
| **Entwickler** (Q1) | Tägliche Updates mit Projektbezug, Meilenstein-Status, eigene Streak. |
| **Sales / Vertrieb** (Q2) | Pflegt Deal-Pipeline + GTM-Schritte, postet Vertriebs-Updates. |
| **Marketing** (Q3) | Pflegt Lead-Funnel + Kampagnen-Status, postet Marketing-Updates. |
| **Design** (Q4) | Postet allgemeine Tagesupdates, kann Projekte als Bezug wählen. |
| **Buchhaltung** (Q5) | Postet allgemeine Tagesupdates. |
Alle Rollen sehen alles (flaches internes Vertrauensmodell im MVP).
### 4.3 Identität & Authentifizierung
Login erfolgt ausschließlich über **Authentik** (auth.tool-ctrl.de) per OIDC. Default-Bereich wird aus Authentik-Group-Claim abgeleitet (Mapping in OQ-1). Projektverantwortliche/r wird pro Projekt im Cockpit als Attribut gesetzt.
---
## 5. User Journeys
### UJ-1 — Tagesrhythmus: Einstempeln, Arbeiten, Reflektieren
*Primär: Q1-Q5*
**Morgens — Einstempeln + ToDos**
1. Person öffnet das Cockpit, klickt „Einstempeln".
2. Trägt eine **ToDo-Liste für heute** ein: 1-N Items, jedes Item mit Titel und optionalem Bezug (Projekt/Deal/Kampagne/Allgemein).
3. Speichert → Person verschwindet aus „heute fehlt eingestempelt", gilt für die Streak als „heute begonnen".
**Abends — Reflexion**
4. Person ruft im Lauf des Tages oder spätestens abends ihre ToDo-Liste auf.
5. Hakt ab, was erledigt wurde.
6. Trägt im Freitext nach, was sonst noch passiert ist (max. 1.000 Zeichen).
7. Setzt **Ampel** und — falls Bezug=Projekt vorhanden — **Trend**.
8. Optional: Blocker → bereichsübergreifende Blocker-Liste im Puls.
9. Speichert → Tag gilt als „voll abgeschlossen", Streak+1.
**Nächster Morgen — Kollegen-Sichtbarkeit**
10. Ab dem nächsten Werktagsmorgen ist der konsolidierte Vortags-Eintrag (ToDos + Häkchen + Reflexion + Ampel + Trend) für alle Kollegen sichtbar.
11. Innerhalb des laufenden Tages sehen Kollegen nur die binäre Anwesenheit („eingestempelt: ja/nein"), nicht die ToDo-Inhalte. Reduziert In-Day-Surveillance.
### UJ-2 — Jourfixe-Moderation
*Primär: P1, P4 (dienstags 11:00)*
1. PM öffnet Cockpit-Puls.
2. Geht die 3 Bereiche durch — Ampel pro Bereich, Top-Projekt-Status, offene Blocker, **Pflicht-Minimum-Score**.
3. Klickt auf rote/gelbe Projekte → Detail-View mit letzten Updates, Ampel + Trend, Meilenstein-Status, Deadline-Bar.
4. Diskutiert Blocker mit Verantwortlichen.
### UJ-3 — Projekt-Verfall früh erkennen
*Primär: P1, P4*
1. Person scrollt durch den Puls.
2. Sieht in einem Bereich ein Projekt mit roter Ampel, ablaufender Deadline-Bar **oder** unerfülltem Pflicht-Minimum.
3. Klickt → Detail-View zeigt: letztes Update vor X Tagen, X von Y Meilensteinen fällig, welche Pflicht-Punkte offen sind.
4. Schreibt direkt einen Kommentar/eine Nachfrage als allgemeines Update mit Bezug=Projekt.
### UJ-4 — Onboarding eines neuen Mitarbeiters
*Primär: Q1-Q5*
1. Mitarbeiter wird in Authentik angelegt → Cockpit-Zugriff automatisch via OIDC.
2. Erster Login: leerer „Mein Status"-Bereich + Hinweis „Hier schreibst du dein erstes Tagesupdate".
3. Default-Bereich aus Authentik-Group.
4. Schreibt das erste Update, erscheint ab sofort in Anwesenheits-/Streak-Liste.
### UJ-5 — Projekt anlegen (Cockpit-Sicht)
*Primär: P1*
1. Person legt in Outline den Steckbrief an (Leitfaden §3).
2. Wechselt ins Cockpit → „Neues Projekt anlegen" — füllt Cockpit-Sichtdaten: Name, Verantwortliche/r, Projektart (Kundenprojekt/Internes Projekt), Arbeitsmodus (Cycle/Kanban), **Steckbrief-URL** (Outline), **Plane-Board-URL**, grobe Meilensteine.
3. Cockpit zeigt das neue Projekt in seinem Bereich und im Puls. Die Pflicht-Minimum-Häkchen werden initial bewertet (Steckbrief vorhanden ✓, Verantwortliche/r ✓ usw.).
> [ASSUMPTION] Authentik-Groups werden für die initiale Bereichszuweisung genutzt. Mapping legen wir in der Architektur-Phase fest.
---
## 6. Funktionale Anforderungen (Features)
> Feature-Gruppen mit global durchnummerierten FR-IDs. Stabil für Architektur- und Story-Phase.
### 6.1 Feature-Gruppe A: Unternehmens-Puls (Startseite)
**Zweck:** Eine Seite, auf der jeder in unter 60s sieht, was los ist.
- **FR-1** Übersichtsleiste aller Bereiche (MVP: Entwicklung, Vertrieb, Marketing) inkl. aggregiertem Ampelstatus und Anzahl heute-fehlender Updates pro Bereich.
- **FR-1a** **Ampel-Aggregation pro Bereich:** *Rot*, wenn ≥1 Projekt rot ist; *Gelb*, wenn ≥1 Projekt gelb und kein rotes; *Grün*, wenn alle Projekte grün; *Grau*, wenn keine Projekte aktiv. *Pflicht-Minimum-Verstöße eines Projekts heben die Ampel mindestens auf Gelb.*
- **FR-2** Bereichsübergreifende Liste aller offenen Blocker (sortiert nach Alter).
- **FR-3** Heute-Quote: „X von Y Mitarbeitern haben heute gepingt" mit Klick → Liste der fehlenden Personen.
- **FR-4** Anzeige des nächsten Jourfixe-Termins (statisch konfigurierbar; Default Di 11:00).
- **FR-5** Pro Bereich werden folgende Key-Metrics angezeigt (verbindlicher Katalog für MVP):
- **Entwicklung:** Anzahl Projekte gesamt | im Plan (grün) | gefährdet (gelb) | blockiert (rot) | überzogene Meilensteine
- **Vertrieb:** Pipeline-Wert gewichtet (Σ value × probability) | offene Deals | gewonnene Deals (Quartal, # + EUR) | offene GTM-Schritte
- **Marketing:** Reichweite (laufende Periode) | aktive Kampagnen | Leads (Periode) | MQLs (Periode) | Übergaben an Vertrieb (Periode)
- **FR-6** Klick auf Bereichs-Kachel öffnet die Bereichs-Detail-View.
- **FR-7** **Pflicht-Minimum-Übersicht** im Puls: Liste aller aktiven Projekte mit roten/gelben Pflicht-Minimum-Punkten (siehe FR-38).
### 6.2 Feature-Gruppe B: Bereichs-Detail Entwicklung
- **FR-8** Liste aller aktiven Projekte der Entwicklung, gruppiert nach **Projektart** (Kundenprojekt / Internes Projekt — Leitfaden §1).
- **FR-9** Pro Projekt-Kachel: Name, Verantwortliche/r (P1), Ampelstatus (Grün/Gelb/Rot) + Trend (↗︎ besser / → gleich / ↘︎ schlechter), Deadline-Progress-Bar (verstrichene Zeit / Gesamtzeit), Anzahl offener Meilensteine, Pflicht-Minimum-Score (z. B. „5/6").
- **FR-10** Klick → Projekt-Detail mit:
- Kopfzeile: Name, Verantwortliche/r, Projektart, Arbeitsmodus (Cycle/Kanban), Ampel + Trend
- Pflicht-Minimum-Anzeige (FR-38)
- **Verlinkungen (Pflicht-Felder):** Outline-Steckbrief-URL, Plane-Board-URL, optional Risikoliste-URL
- Optional Definition of Done (Freitext, Cockpit-Sichtfeld)
- Meilenstein-Checkliste (Cockpit-Sicht — siehe FR-11)
- Update-Feed des Projekts
- **FR-11** Meilensteine werden im Cockpit als grobe Sicht gepflegt (Titel, Fälligkeit, Status: offen/erledigt/überzogen). *Wahrheit ist der Steckbrief in Outline;* Cockpit-Meilensteine sind eine reduzierte Sichtkopie. Doppelpflege wird akzeptiert, bis Phase-2-API-Sync eingeführt wird.
### 6.3 Feature-Gruppe C: Bereichs-Detail Vertrieb
- **FR-12** 5-Spalten-Kanban: Lead → Erstgespräch → Demo → Angebot → Abschluss. Drag-and-Drop zwischen Spalten.
- **FR-13** Deal-Karten zeigen Name, Verantwortlicher, Wert (€), **Stage-Wahrscheinlichkeit (probability, 0-100%)**, Tage in aktueller Stage.
- **FR-14** **Vertriebs-Header-KPIs:** Pipeline-Wert gewichtet (Σ value × probability), gewonnene Deals (# + EUR, laufendes Quartal), aktiver Deal-Count, durchschnittliche Stage-Verweildauer.
- **FR-15** Pro Produkt eine sortierbare GTM-Schritt-Liste (Schritt, Verantwortlicher, Status).
- **FR-16** Vertrieb-Update-Feed (Filter auf Bezug=Deal oder Bezug=Vertrieb-allgemein).
### 6.4 Feature-Gruppe D: Bereichs-Detail Marketing
- **FR-17** Horizontaler Lead-Funnel mit 5 Stufen (Reichweite → Website → Leads → MQL → Übergabe) und Conversion-Prozenten zwischen den Stufen.
- **FR-18** Liste aktiver Kampagnen mit Status (Aktiv / Pausiert / Beendet), Reichweite, Verantwortlicher.
- **FR-19** **Crosslink-Banner Marketing↔Vertrieb:** Sichtbarer Banner in Marketing & Vertrieb: „Marketing hat X Leads übergeben in [Zeitraum], Vertrieb hat daraus Y Deals erzeugt (Z €)."
- **FR-20** Marketing-Update-Feed (Filter auf Bezug=Kampagne oder Bezug=Marketing-allgemein).
### 6.5 Feature-Gruppe E: Tagesrhythmus (Einstempeln · ToDos · Reflexion)
> Ein „Tagesupdate" besteht aus zwei Touchpoints am gleichen Tag: **Morgen-Einstempeln mit ToDo-Liste** und **Abend-Reflexion**. Beides zusammen wird am nächsten Werktagsmorgen als konsolidierter Vortags-Eintrag für Kollegen sichtbar.
#### 6.5.1 Morgen — Einstempeln & ToDos
- **FR-21** „Einstempeln"-Aktion auf der Puls-Seite (großer Button bei nicht eingestempelten Personen): öffnet die ToDo-Eingabe für heute.
- **FR-22** **ToDo-Liste** für den aktuellen Werktag:
- 1-N ToDo-Items
- pro Item: Titel (max. 200 Zeichen), optionaler Bezug (Projekt/Deal/Kampagne/Allgemein), optionale Bezugs-ID
- keine Ampel/Trend pro ToDo
- **FR-23** Beim Einstempeln gilt der Tag als „begonnen" — Person verschwindet aus der „heute fehlt"-Liste auf dem Puls.
- **FR-24** **Sichtbarkeit innerhalb des laufenden Tages:**
- Kollegen sehen nur „Person hat sich eingestempelt (ja/nein)" — keine ToDo-Inhalte.
- Die Person selbst sieht ihre ToDo-Liste in „Mein heute".
- Projektverantwortliche/r eines bezogenen Projekts darf die ToDos sehen, falls Bezug auf das Projekt verweist (operative Notwendigkeit).
- **FR-25** ToDos sind während des Tages bis zur Reflexion editierbar (hinzufügen / löschen / ändern).
#### 6.5.2 Abend — Reflexion
- **FR-26** **Reflexions-Formular**: Person ruft ihre ToDo-Liste auf und füllt aus:
- Pro ToDo: ☑️ erledigt / ☐ offen / ✖️ verworfen (mit optionalem Grund)
- **Reflexions-Freitext** (max. 1.000 Zeichen) — was sonst noch passiert ist
- **Status-Ampel** (Leitfaden §5 Wortlaut):
- 🟢 Grün – im Plan
- 🟡 Gelb – spürbare Abweichung, **aber** Maßnahmenplan greift
- 🔴 Rot – Abweichung **ohne** gesicherten Plan, braucht jetzt eine Entscheidung
- **Trend** (Pflicht bei Bezug=Projekt; sonst optional): ↗︎ besser / → gleich / ↘︎ schlechter
- **Blocker** (optional Freitext, erzeugt Blocker-Eintrag — siehe FR-41ff.)
- **URL** (optional, z. B. Plane-Ticket oder Outline-Seite)
- **FR-27** Nach Speichern der Reflexion ist der Tag „voll abgeschlossen". Person zählt für die Streak als voller Tag.
- **FR-28** Reflexion ist nach 30 Minuten nicht mehr editierbar. Erinnerung optional („Du hast heute noch nicht reflektiert"-Hinweis ab z. B. 17:00 Uhr — keine externe Push-Notification im MVP).
#### 6.5.3 Konsolidierung & Sichtbarkeit
- **FR-29** Am nächsten Werktagsmorgen wird der konsolidierte Vortags-Eintrag publiziert: ToDos + Häkchen + Reflexions-Freitext + Ampel + Trend werden für Kollegen sichtbar im Bereichs-Feed und im jeweiligen Bezugs-Feed.
- **FR-30** Default-Sortierung in Feeds: neueste oben. Pagination: 50 Items pro Seite oder „Mehr laden".
- **FR-31** Eine Reflexion setzt Ampelfarbe und Trend des verlinkten Projekts/Deals/Kampagne — zuletzt eingetragener Wert gewinnt (mehrere Bezüge möglich → jeder Bezug erhält die Werte).
- **FR-32** **Rückwirkende Erfassung:** Bis zu **einem Werktag zurück** dürfen Einstempeln + Reflexion nachgetragen werden. Ältere Tage sind nicht mehr erfassbar (außer als „Abwesend" markiert, siehe FR-37).
- **FR-33** **Tages-Status pro Person** (sichtbar im eigenen Profil und im Puls für andere):
- 🟢 voll (Einstempeln + Reflexion) — zählt für Streak
- 🟡 halb (nur Einstempeln, keine Reflexion) — zählt nicht für Streak, aber Person ist „nicht durchgefallen"
- ⚪ nicht angefangen (kein Einstempeln) — fällt aus Streak
- 🟣 abwesend
### 6.6 Feature-Gruppe F: Anwesenheit / Update-Serie (Streak) / Disziplin
- **FR-34** Pro Person wird die aktuelle **Update-Serie** (Streak) — aufeinanderfolgende Werktage mit Tages-Status „voll" — angezeigt. „Halbe" Tage brechen die Streak nicht, zählen aber nicht zur Serie.
- **FR-35** „Heute fehlt"-Liste auf der Puls-Seite (siehe FR-3); klickbar, zeigt Personen ohne Einstempeln am aktuellen Werktag nach 11:00 und Personen mit „halbem" Tag-Status nach 17:00.
- **FR-36** Werktage-Definition: Mo-Fr (Feiertage Phase 2).
- **FR-37** Eine Person kann sich für einen Tag (oder Zeitraum) als „Abwesend" markieren (Urlaub / Krankheit). Diese Tage zählen nicht gegen die Streak.
### 6.7 Feature-Gruppe G: **Pflicht-Minimum-Check (Leitfaden §9)**
- **FR-38** Pro aktivem Projekt zeigt das Cockpit die 6 Pflicht-Punkte des Leitfadens als sichtbare Checkliste:
1. Projektsteckbrief in Outline freigegeben → erfüllt, wenn `outline_steckbrief_url` gepflegt **und** als „freigegeben" markiert ist
2. Projektverantwortliche/r gesetzt → erfüllt, wenn P1 zugewiesen
3. Plane-Board mit zerlegter Arbeit → erfüllt, wenn `plane_project_url` gepflegt
4. Meilensteine mit groben Terminen → erfüllt, wenn ≥1 Meilenstein definiert
5. Status-Ampel aktuell → erfüllt, wenn letzte Reflexion mit Bezug=Projekt ≤ 7 Werktage alt
6. Abschluss-Retrospektive — *nur bei beendeten Projekten relevant; aktiv = n/a*
- **FR-39** Im MVP werden Pflicht-Punkte 1, 2, 3, 4 als manuelle Bestätigungs-Felder pro Projekt geführt (Cockpit-Sicht, Doppelpflege akzeptiert). Punkt 5 wird automatisch aus dem Reflexions-Zeitstempel abgeleitet. Punkt 6 wird beim Abschluss-Workflow gesetzt.
- **FR-40** Projekte mit ≥1 unerfülltem Pflicht-Punkt erscheinen prominent auf der Puls-Seite (siehe FR-7).
### 6.8 Feature-Gruppe H: Blocker
- **FR-41** Ein Blocker entsteht entweder als Feld in einer Reflexion oder separat über „Neuer Blocker"-Button.
- **FR-42** Blocker tragen: Titel, Beschreibung, Verantwortlicher (zur Lösung), Ersteller, Bereich(e), Datum offen, Status (offen / gelöst).
- **FR-43** Blocker erscheinen auf der Puls-Seite, in den betroffenen Bereichs-Detail-Views und in der Projekt-Detail-View (falls projektgebunden).
- **FR-44** Auflösung: Auflöser, Auflöse-Datum und Auflösungs-Kommentar werden persistiert. **Nur die/der Projektverantwortliche (P1) des bezogenen Projekts darf einen Blocker als gelöst markieren.** Bei Blockern ohne Projektbezug darf die/der Ersteller/in oder Verantwortliche/r des Blockers selbst auflösen.
### 6.9 Feature-Gruppe I: Projekt-Abschluss
- **FR-45** Projektverantwortliche/r kann ein Projekt im Cockpit auf „abgeschlossen" setzen.
- **FR-46** Beim Abschluss prüft das Cockpit Pflicht-Minimum-Punkt 6 (Lessons-Learned-URL) — wenn fehlend, fordert es die URL an.
- **FR-47** Abgeschlossene Projekte verschwinden aus dem Puls, bleiben aber in einer „Archiv"-Sicht pro Bereich lesbar.
### 6.10 Feature-Gruppe J: Navigation, Suche & Filter
- **FR-48** Globale Top-Navigation: Puls / Entwicklung / Vertrieb / Marketing / „Mein heute" / Eigenes Profil / Archiv.
- **FR-49** Volltextsuche über Updates → Phase 2. Im MVP genügt Filterung im Feed nach Bereich/Bezug.
---
## 7. Nicht-funktionale Anforderungen (NFRs)
### 7.1 Performance
- **NFR-1** Puls-Seite lädt vollständig in < 1,5 s bei 6-15 aktiven Nutzern und 90 Tagen Historie.
- **NFR-2** Tagesupdate-Speichern dauert < 500 ms (Server-Roundtrip).
### 7.2 Verfügbarkeit
- **NFR-3** Zielverfügbarkeit Mo-Fr 8-19 Uhr: 99% (kein 24/7-SLA).
- **NFR-4** Geplante Wartungsfenster außerhalb der Kernzeit kommunizierbar.
### 7.3 Sicherheit & Privacy
- **NFR-5** Alle Routen sind hinter Authentik-OIDC abgesichert; kein anonymer Zugriff.
- **NFR-6** Keine PII von Externen (Deal-Karten enthalten nur intern bekannte Firmennamen, keine Klar-Personendaten).
- **NFR-7** Audit-Spur: jedes mutierende Event (Update, Blocker, Meilenstein-Statuswechsel, Pflicht-Minimum-Änderung) hat `actor`, `timestamp`, `payload`.
### 7.4 Bedienbarkeit & Visual
- **NFR-8** Brand-konform: primär weiß, sekundär schwarz, gemäß ToolCTRL Brand Identity. Konkrete Design-Tokens in der UX-Phase.
- **NFR-9** Tagesupdate-Schreib-Workflow ist in ≤ 3 Klicks ab Puls erreichbar.
- **NFR-10** Desktop-first; mobile-Responsiveness ist Phase 2 (mobil-lesbar ist Pflicht, mobil-schreibbar nicht).
- **NFR-11** Sprache: Deutsch durchgängig im UI. Keine i18n im MVP.
### 7.5 Voice & Tone (Mikrocopy)
- **NFR-12** Tonalität ist **locker, direkt, deutsch, kurze Imperative.** Beispiele aus dem Prototyp als Voice-Anker:
- „Stark."
- „Wie läuft es?"
- „Du hast heute noch nicht gepingt."
- „Willkommen, [Name]"
- **NFR-13** Keine Corporate-Sprech-Phrasen („wir möchten Sie darauf hinweisen", „im Zuge der Optimierung"). Keine englischen Floskeln im Fließtext der UI (Fachbegriffe wie „Backlog", „Kanban" sind okay — sie kommen aus dem Leitfaden).
### 7.6 Datenhaltung
- **NFR-14** Persistenz in **Postgres**. Kein localStorage-only.
- **NFR-15** Tägliches Backup (Mechanik in Architektur-Phase).
### 7.7 Erweiterbarkeit
- **NFR-16** Datenmodell muss Phase-2-Erweiterungen ohne mehr als eine zweistündige Migration tragen: zusätzliche Bereiche (Design, Buchhaltung), Plane/Outline-API-Sync, Kommentare auf Updates, Mobile, Feiertags-Kalender.
---
## 8. Out of Scope (MVP) / Phase-2-Kandidaten
| Item | Begründung |
|---|---|
| Plane-API-Sync (Ticket-Status, Owner, Titel ziehen; Meilensteine auto-erkennen) | Komplexität verzögert MVP; URL-Link reicht zunächst. |
| Outline-API-Sync (Steckbrief-Status „freigegeben" auto-erkennen) | Selbe Begründung; manuelle Bestätigung reicht. |
| Outline-Embed | Verlinkung genügt. |
| Design-Bereich, Buchhaltung-Bereich (eigene Detail-Views) | Beide nutzen „Allgemein" im MVP. |
| Mobile-App / Responsive Mobile-UI (schreibend) | Desktop deckt 95% der täglichen Nutzung ab; mobil bleibt lesbar. |
| Volltextsuche über Updates | Filter im Feed reicht im MVP. |
| Reaktionen / Kommentare auf Updates | Nice-to-have, kein Kernproblem. |
| Reminders per Element/Matrix/Mail bei fehlendem Update | Cockpit-Visualisierung zuerst beweisen, dann pushen. |
| Konfigurierbare Reporting-/BI-Dashboards | Andere Werkzeuge geeigneter. |
| Zeiterfassung | Kimai existiert. |
| Mehrsprachigkeit | Nicht nötig. |
| Feiertags-Kalender (für Streak-Berechnung) | MVP: Mo-Fr ohne Feiertags-Sonderfall. |
---
## 9. Offene Fragen
| ID | Frage | Wer entscheidet | Bis wann | Phase-Blocker? |
|---|---|---|---|---|
| OQ-1 | Genaues Mapping Authentik-Groups → Cockpit-Bereiche? | Architektur-Phase | Vor MVP-Bau | ja |
| OQ-2 | Welche konkreten Brand-Tokens (Hex, Typografie, Logo-Verwendung) gelten 1:1? | UX-Phase | Vor UI-Bau | ja |
| OQ-5 | Archivierte Projekte: Historie für immer behalten oder nach X Monaten löschen? | Architektur + Product | Vor MVP-Bau | nein |
| OQ-8 | Erinnerungszeit für „du hast noch nicht reflektiert"-Hinweis (Default 17:00)? | Product (Dejan) | Vor Story-Bau | nein |
| OQ-9 | Was passiert, wenn eine Person die ToDo-Liste morgens leer lässt — ist „eingestempelt mit 0 ToDos" gültig oder muss ≥1 ToDo gesetzt sein? PRD-Default: ≥1 ToDo Pflicht. | Product (Dejan) | Vor MVP-Bau | nein |
| OQ-10 | Darf eine Person ToDos *nach* dem Abend-Reflektieren noch nachtragen (z. B. „bin um 10 noch zur Apotheke gefahren")? PRD-Default: nein, nach Reflexion ist der Tag geschlossen. | Product (Dejan) | Vor Story-Bau | nein |
**Beschlossene OQs (vorher offen, jetzt im PRD verankert):**
- ~~OQ-3~~ → Rückwirkende Erfassung **max 1 Werktag zurück** (FR-32).
- ~~OQ-4~~ → Nur P1 (oder Blocker-Ersteller/Verantwortlicher bei projektlosen Blockern) darf auflösen (FR-44).
- ~~OQ-6~~ → Pflicht-Minimum-Punkt 1 als manuelle Cockpit-Checkbox im MVP (FR-39).
- ~~OQ-7~~ → Trend **Pflicht bei Bezug=Projekt**, sonst optional (FR-26).
---
## 10. Annahmen-Index
Sammlung aller im PRD getroffenen Annahmen — zur expliziten Bestätigung im Architektur- bzw. UX-Lauf:
- **A-1** Authentik-OIDC-Integration ist technisch in < 1 Tag erledigt (Erfahrung aus Plane/Outline-Setup).
- **A-2** Authentik-Groups werden für die initiale Bereichszuweisung genutzt; Mapping wird in der Architektur-Phase festgelegt.
- **A-3** Team wächst in den nächsten 12 Monaten nicht über 30 Personen.
- **A-4** Postgres + ein leichter Backend-Layer reichen aus; konkrete Backend-Wahl in Architektur-Phase.
- **A-5** Pflicht-Minimum-Punkte 1-4 werden im MVP manuell im Cockpit bestätigt (kein Outline-/Plane-API-Sync).
- **A-6** Doppelpflege Cockpit-Meilenstein ↔ Outline-Steckbrief ist im MVP akzeptiert; wird beobachtet (CM4).
---
## 11. Risiken
| Risiko | Mitigation |
|---|---|
| Das Cockpit wird selbst zu einem „starten und abbrechen"-Projekt. | MVP-Scope hart klein halten. Erstes Release in 4 Wochen anpeilen. Selbst-Dogfooding ab Tag 1. **Das Cockpit selbst muss das Pflicht-Minimum erfüllen.** |
| Daily-Update-Pflicht erzeugt Lästergefühl. | CM2/CM3 messen; 4-Wochen-Retro; Mechanik justierbar. |
| Cockpit erodiert die Tool-Aufteilung des Leitfadens (wird Schatten-Plane oder Schatten-Outline). | A1-A5 + CM4 wachen darüber. Architektur-Phase prüft den Schnitt explizit. |
| Sales-Daten sind sensibel und sollen evtl. nicht jeder sehen. | MVP: flaches Vertrauen, alle sehen alles. Bei Bedarf in Phase 2 Rollen-Sichtbarkeit. |
| Pflicht-Minimum-Häkchen werden „durchgewinkt" und verlieren Bedeutung. | Jourfixe diskutiert Stichproben. Phase 2: Outline-/Plane-API-Validierung. |
---
## 12. Erfolgskontrolle & Review-Punkte
- **Woche 2 nach Launch** – kurzer Puls-Check im Jourfixe: M1 erreicht?
- **Woche 4 nach Launch** – Retro: CM2/CM3/CM4. Adjust falls nötig.
- **Woche 8 nach Launch** – Vollauswertung gegen M1-M6. Entscheidung: Phase 2 starten oder MVP weiter härten?
---
*Ende PRD. Begleitend: `addendum.md` (technische Tiefe, verworfene Alternativen, Leitfaden-Bezüge, In-Depth-Personas) und `.decision-log.md` (Audit-Trail).*
@@ -0,0 +1,248 @@
# Reconciliation: HTML-Prototyp ↔ PRD + Addendum
Quelle (Prototyp): `inputs/unternehmens-cockpit.html` (verdichtet in `extract-prototype-html.md`)
Geprüft gegen: `prd.md` + `addendum.md`
Datum: 2026-05-25
---
## Vollständig abgedeckt
### Hauptstruktur & Navigation
- **Cockpit als Default-View** → PRD §1.1 (Tabelle), §6.1 (Feature-Gruppe A: Puls als Startseite), FR-32 (Top-Nav inkl. "Puls")
- **Tagesupdate als zweite Top-Level-View** → FR-32 ("Neues Tagesupdate" in Top-Nav), FR-19 (Formular), UJ-1
- **Drei Areas: Entwicklung / Vertrieb / Marketing** → PRD §6.1 (FR-1), §6.2/§6.3/§6.4 (eigene Feature-Gruppen), Addendum §6 (Vokabular)
- **Live-Datum im Header** → implizit via "Heute"-Logik (FR-3, FR-25)
### Unternehmens-Puls
- **Aggregierter Ampelstatus pro Area** → FR-1
- **Bereichsübergreifend offene Blocker** → FR-2, FR-30, Risiko-Modell §10
- **Heute-Quote ("X von Y haben gepingt")** → FR-3
- **Jourfixe-Hinweis (Di 11:00)** → FR-4, Vision G4, Addendum §6
- **Key-Metrics pro Area-Tile (3-5 Metrics)** → FR-5
- **Klick auf Area-Tile öffnet Detail-View** → FR-6
### Entwicklung
- **Projekt-Liste mit Gruppierung Umsatz/Intern** → FR-7
- **Status-Pill je Projekt (abgeleitet aus letztem Update)** → FR-8, FR-23
- **Deadline/Meilenstein-Progress** → FR-8, FR-10
- **Projekt-Detail mit Meilenstein-Checkliste + Update-Feed** → FR-9
- **Meilensteine mit Titel/Fälligkeit/Status** → FR-10
- **CRUD für Projekte/Meilensteine** → FR-11 (Prototyp hatte nur Read; PRD erweitert bewusst)
### Vertrieb
- **5-Spalten Kanban (Lead → Erstgespräch → Demo → Angebot → Abschluss)** → FR-12, Addendum §6 (Deal-Stage)
- **Deal-Karten mit Name/Owner/Wert** → FR-13
- **GTM-Schritt-Liste pro Produkt** → FR-14, Addendum §6
- **Vertrieb-Update-Feed** → FR-15
- **Crosslink zu Marketing (Lead-Übergabe)** → implizit über FR-30 (Blocker bereichsübergreifend) + UJ-2, allerdings nicht prominent (siehe Gaps)
### Marketing
- **Lead-Funnel mit 5 Stufen + Conversion-Raten** → FR-16, Addendum §6
- **Kampagnen-Liste mit Status** → FR-17
- **Marketing-Update-Feed** → FR-18
### Tagesupdates
- **Formular mit Person/Bereich/Bezug/Freitext/Ampel/Blocker** → FR-19
- **Bezug = Projekt/Deal/Kampagne/Allgemein** → FR-19, Addendum §6
- **Chronologische Anzeige in Area- und Bezug-Feed** → FR-21
- **Update setzt Ampelfarbe des Referenzobjekts** → FR-23
- **Optionale URL als Zusatz-Bezug** → FR-22 (Erweiterung gegenüber Prototyp)
- **Edit-Fenster (Prototyp: kein Edit)** → FR-20 (PRD lockert bewusst auf 30min)
- **Validierung (Pflichtfelder)** → implizit in FR-19
### Disziplin / Streak
- **Streak-Counter pro Person/Projekt** → FR-24, Vokabular im Addendum
- **"Heute fehlt"-Liste / Side-Nudge** → FR-3, FR-25
- **Werktage-Definition** → FR-26
- **Abwesenheit / Urlaub-Marker** → FR-27 (Prototyp hatte das nicht — PRD erweitert)
### Blocker
- **Blocker als Feld in Update** → FR-28
- **Bereichsübergreifend sichtbar** → FR-2, FR-30
- **Standalone-Blocker-Erstellung** → FR-28 (PRD erweitert gegenüber Prototyp)
- **Blocker mit Owner/Status/Auflösung** → FR-29, FR-31
### Status-System (Ampel)
- **3 Status: Im Plan / Gefährdet / Blockiert** → FR-19, Addendum §6
- **green/amber/red Mapping** → Datenmodell-Skizze in Addendum §1.2
- **Status-Rollup auf Area** → FR-1 (aggregierter Status)
### Identität
- **Personen mit Name/Rolle** → PRD §4.1 (Rollen-Tabelle), Datenmodell User in Addendum §1.2
- **OIDC-Auth (Prototyp hatte keine Auth — bewusste Erweiterung)** → PRD §4.2, NFR-5, Addendum §1.3
### Datenmodell (impliziert)
- **TEAM/AREA/PROJECT/DEAL/CAMPAIGN/UPDATE/MILESTONE/STAGE/FUNNEL/GTM** → Addendum §1.2 mit allen wesentlichen Entitäten
---
## Bewusst weggelassen (mit Begründung im PRD)
- **localStorage-only Persistenz** → Addendum §2.5 (explizit verworfen, Postgres stattdessen, NFR-12)
- **Single-User-Modell ohne Auth** → PRD §4.2 (Authentik-OIDC), Addendum §2.5
- **Intro/Splash-Screen ("Willkommen, Haris")** → nicht in MVP-Scope; nicht explizit als Anti-Ziel formuliert, aber als kosmetische Prototypen-Animation klar nicht produktiv (vgl. Addendum §5: Prototyp = Logik-Referenz, kein Visual-Referenz)
- **"Demodaten zurücksetzen"-Button** → reines Prototypen-Feature; im MVP gegen echte Daten irrelevant
- **TODAY hartcodiert** → trivial weggelassen, MVP nutzt echtes Datum
- **Hardcoded Produkte (HiveGrid/Asset Control/etc.)** → werden zu echten DB-Datensätzen (Datenmodell Project/GtmStep)
- **Off-Brand Visuals (Indigo, Navy, Hellgrau)** → Addendum §5 explizit als Off-Brand-Risiko markiert; NFR-8 verlangt Brand-Konformität
- **Detail-Views für Design/Buchhaltung** → Addendum §2.6 (verworfen, weil keine KPIs definiert); PRD §8 Phase 2
- **Volltextsuche** → PRD §8, FR-33 als Phase 2
- **Mobile/Responsive** → PRD §8, NFR-10 (desktop-first)
- **Reaktionen/Kommentare auf Updates** → PRD §8
- **Plane-API-Sync / Outline-Embed** → PRD §8, Addendum §1.4 als Phase 2
- **Reminders per Mail/Element** → PRD §8
- **BI/Reporting-Dashboards** → PRD Anti-Ziel A6, §8
- **Zeiterfassung** → PRD Anti-Ziel A4
---
## Gaps (potenziell vergessen — Empfehlung: aufnehmen oder bewusst rejizieren)
### Mittlere Priorität
1. **Won-Deals als KPI im Vertriebs-Header**
- Prototyp: KPI-Tile "Gewonnen (# + EUR)" in Vertriebs-Bereichsstats.
- PRD: nicht erwähnt. FR-13 zeigt nur Deal-Karten, kein Won-Aggregat.
- Empfehlung: als KPI aufnehmen oder explizit rejizieren (z. B. "Won-Deals werden nicht separat geführt; abgeschlossene Deals verschwinden aus Kanban").
2. **Gewichteter Pipeline-Wert (Σ value × Stage-Wahrscheinlichkeit)**
- Prototyp: explizite KPI mit Wahrscheinlichkeiten pro Stage (0.10/0.25/0.50/0.75/0.90).
- PRD: nicht erwähnt; Stage hat keine Wahrscheinlichkeit im Datenmodell.
- Empfehlung: in FR-12/13 ergänzen oder als Phase 2 vermerken. Konsequenz für Datenmodell: Stage braucht `probability`-Feld.
3. **Crosslink-Banner Marketing↔Vertrieb (Lead-Übergabe)**
- Prototyp: prominenter Crosslink "X Leads hat Marketing diesen Monat in die Pipeline übergeben" auf Vertriebs- und Marketings-Detail-View.
- PRD: implizit via Funnel-letzte-Stufe (FR-16), aber kein expliziter Cross-Area-Link als FR.
- Empfehlung: als FR aufnehmen — der Crosslink ist eine sichtbare Verbindung, die "Areas reden miteinander" konkret macht. Vibe-relevant.
4. **Streak nicht nur pro Person, sondern pro Projekt ("Update-Serie")**
- Prototyp: Projekt-Detail zeigt eigenen Streak-Counter "Tage am Stück mit Update".
- PRD: FR-24 nennt Streak nur pro Person.
- Empfehlung: in FR-24 erweitern oder als separates FR ergänzen — Projekt-Streak ist ein gutes Versandungs-Frühwarnsystem (deckt sich mit Addendum §4 Indikator 2: "Median-Update-Alter pro Projekt").
5. **Bereichs-Stats-Kacheln in Detail-Views (4er-Grid mit "Projekte/Im Plan/Meilensteine/Updates heute")**
- Prototyp: jede Area-Detail-View hat 4 Stats-Tiles als sekundärer Übersichtskopf.
- PRD: nicht spezifiziert, nur einzeln in FR-5 (Puls). Detail-Views haben keine Stat-Tile-Anforderung.
- Empfehlung: in FR-7/12/16 als "Bereichskopf mit 4 Kennzahlen" ergänzen — sonst gehen Detail-Views in Wireframes verloren.
### Niedrigere Priorität (qualitativ / UX-Feinheiten)
6. **Due-Date-Färbung (warn = amber ≤4 Tage, over = rot überfällig)**
- Prototyp: konkretes UI-Pattern in Projekt-Rail und Meilensteinen.
- PRD: NFR-/FR-Ebene zu generisch — keine explizite Färblogik.
- Empfehlung: in UX-Phase festhalten; nicht zwingend im PRD, aber sollte als "Pattern" im Addendum §6 oder UX-Brief landen.
7. **Avatar mit Initialen + Personen-Farbe als wiederkehrendes UI-Atom**
- Prototyp: starkes Identitäts-Element, durchgängig in Feed-Items.
- PRD: nicht erwähnt — nur "Person" als Feld.
- Empfehlung: UX-Phase-Detail; jeder User braucht `color` im Datenmodell.
8. **"Bereichsübergreifend offen"-Chip-Liste als Puls-Element**
- Prototyp: explizit rechte Foot-Sektion des Puls.
- PRD: FR-2 nennt nur "Liste"; das Pattern als rote Chips mit Klick→Area ist nicht spezifiziert.
- Empfehlung: in FR-2 spezifizieren oder UX-Phase.
9. **Kampagnen-Status "pausiert"**
- Prototyp: 5 Status (läuft / geplant / ausgewertet / blockiert / pausiert).
- PRD/Addendum: FR-17 nennt nur 3 (Aktiv / Pausiert / Beendet); Addendum Datenmodell hat (active|paused|done).
- Empfehlung: Status-Set vereinheitlichen. Entweder Prototyp-Set übernehmen (granularer) oder explizit auf 3 Status reduzieren.
10. **Toast-Komponente für Bestätigungs-Feedback**
- Prototyp: explizit nach Update-Submit.
- PRD: nicht erwähnt.
- Empfehlung: UX-Phase; trivial, sollte aber bewusst entschieden sein.
11. **Side-Nudge "Der Rhythmus"-Erklärtext im Tagesupdate-Formular**
- Prototyp: rechte Spalte im Formular mit Erklärtext zum Rhythmus + Jourfixe.
- PRD: nicht spezifiziert; PRD-Tonalität ist eher knapp.
- Empfehlung: bewusst entscheiden — passt zur "Disziplin"-Vision und macht den Sinn des Updates explizit (gut für Onboarding, UJ-4).
### Konzeptionelle Lücken
12. **Vibes/Onboarding-Splash "Welt der Übersicht"**
- Prototyp: Splash-Screen mit personalisierter Begrüßung ("Willkommen, Haris").
- PRD: UJ-4 nennt nur "leerer Mein-Status-Bereich + Hinweis".
- Empfehlung: Tonalität (locker, persönlich, motivierend) bewusst entscheiden — wenn das Cockpit "Disziplin ohne Druck" sein soll, könnte ein personalisierter Empfang Wirkung haben. Im PRD nicht erwähnt.
13. **Kein expliziter "Tonalität / Voice"-Abschnitt im PRD**
- Prototyp-Texte sind eher locker-geschäftlich ("Alle Tagesupdates sind da. Stark.", "läuft nach Plan", "brauche Hilfe").
- PRD spricht nüchtern in Capability-Sprache; keine Voice-/Tonalitäts-Vorgabe.
- Empfehlung: kurzen "Voice & Tone"-Abschnitt im UX-Brief — siehe eigener Abschnitt unten.
---
## Vokabular-Konsistenz
| Begriff | Prototyp | PRD | Addendum | Status |
|---|---|---|---|---|
| **Puls / Unternehmens-Puls** | ✓ Hauptbegriff | ✓ FR-1..5 | ✓ §6 | konsistent |
| **Areas / Bereich** | ✓ beide | ✓ "Area" und "Bereich" gemischt | ✓ "Area / Bereich" | konsistent (Doppelbegriff) |
| **Ampel** | ✓ | ✓ ("Ampelstatus") | ✓ | konsistent |
| **Im Plan / Gefährdet / Blockiert** | ✓ | ✓ FR-19 | ✓ §6 | konsistent |
| **Bezug** | ✓ | ✓ FR-19 | ✓ §6 | konsistent |
| **Streak / Update-Serie** | ✓ beide nebeneinander | ✓ "Streak" (FR-24) | ✓ "Streak" | **Inkonsistenz:** "Update-Serie" als Synonym fehlt im PRD/Addendum |
| **Jourfixe** | ✓ | ✓ FR-4, G4 | ✓ §6 | konsistent |
| **Meilenstein** | ✓ | ✓ FR-8, FR-10 | ✓ §6 | konsistent |
| **Deal-Stage / Stages** | ✓ | ✓ FR-12 | ✓ "Deal-Stage" §6 | konsistent |
| **GTM / GTM-Schritt** | ✓ "GTM" und "Vertriebsfortschritt je Produkt" | ✓ FR-14 ("GTM-Schritt-Liste") | ✓ §6 | konsistent (PRD nutzt "GTM-Schritt" sauber) |
| **Lead-Funnel** | ✓ | ✓ FR-16 | ✓ §6 | konsistent |
| **MQL** | ✓ | ✓ FR-16 | ✓ §6 | konsistent |
| **Blocker** | ✓ | ✓ Feature-Gruppe G | ✓ §6 | konsistent |
| **Bereichsübergreifend offen** | ✓ | (sinngemäß FR-2 "bereichsübergreifende Liste") | – | **Begriff fehlt wörtlich** — sollte im PRD/Addendum als Label übernommen werden |
| **Crosslink** | ✓ | – | – | **Begriff fehlt** (Konzept ist nur implizit) |
| **Umsatz / Intern (Projekt-Gruppen)** | ✓ | ✓ FR-7 | ✓ §1.2 (`group umsatz|intern`) | konsistent |
| **Pipeline-Wert / Gewichteter Wert** | ✓ beide | – | – | **fehlt** (siehe Gap #2) |
| **Reichweite** | ✓ | ✓ FR-16 | – | konsistent |
| **Übergabe / An Vertrieb übergeben** | ✓ | ✓ FR-16 ("Übergabe") | ✓ "Übergabe" §6 | konsistent |
| **Kampagne / Kampagnen-Status** | ✓ 5 Status | ✓ 3 Status (FR-17) | ✓ 3 Status | **Inkonsistenz im Status-Set** (siehe Gap #9) |
| **Pflichtenheft** | ✓ Prototyp-Kontext | – | – | nicht übernommen; vermutlich projektspezifisch, kein Produkt-Vokabular |
| **Demodaten** | ✓ | – | – | bewusst weggelassen (Prototyp-Spezifikum) |
### Empfehlungen Vokabular
- "Bereichsübergreifend offen" als Label in FR-2 verankern.
- "Update-Serie" als deutscher Synonym-Begriff zu "Streak" im Addendum §6 ergänzen — der Prototyp nutzt beide nebeneinander.
- "Crosslink" als Konzept im Addendum §6 aufnehmen, falls Gap #3 angenommen wird.
- Kampagnen-Status-Set zwischen Prototyp (5) und Addendum (3) auflösen.
---
## Tonalität / Vibe
### Beobachtungen Prototyp
Der Prototyp hat einen sehr spezifischen Voice-Charakter:
- **Locker-geschäftlich:** "Alle Tagesupdates sind da. Stark." | "Aktuell keine offenen Blocker." | "Stark." als Erfolgs-Quittung.
- **Persönlich-direkt:** "Willkommen, Haris" | "Was hast du heute geschafft?" | "Wie läuft es?" | "Etwas, das dich blockiert oder wobei du Hilfe brauchst?"
- **Konkret statt abstrakt:** "in 3 Tagen", "heute fällig", "2 Tage überfällig" — Mensch-lesbare Datumsangaben statt ISO-Strings.
- **Bilder/Metaphern:** "Puls", "Welt der Übersicht" (im Header-Konzept), "Rhythmus" (Side-Nudge im Formular), "Areas" (englisch eingedeutscht).
- **Kein Corporate-Sprech:** keine "KPIs", keine "Stakeholder", keine "Initiativen" im UI-Copy.
### Was PRD/Addendum vom Vibe einfangen
- PRD hat in §1 selbst einen klaren "Voice": *"kein Tool-Problem, sondern ein Durchziehen-Problem"* | *"niemand sich tagelang wegducken kann"* | Vision §1.2 ist sehr direkt. **Das ist gut.**
- Anti-Ziele §2.2 sind in derselben direkten Tonalität gehalten.
- Persona-Beschreibungen in Addendum §3 fangen Tonalität ("Lästert intern", "will stolz zeigen") und Persönlichkeit gut ein.
### Was verloren geht
- **"Welt der Übersicht"** als emotionaler Header-Claim ist nicht im PRD prominent. Wenn dieser Anspruch ("Übersicht als Welt, in der man sich aufhält") tragend sein soll, gehört er in §1.2 (Vision) oder als eigener Abschnitt "Voice & Tone".
- **Personalisierter Empfang ("Willkommen, [Name]")** ist im Onboarding (UJ-4) zu nüchtern beschrieben — verliert den "Mensch wird begrüßt"-Vibe.
- **Konkrete Mensch-Sprache in UI-Copy** (z. B. "Wie läuft es?", "brauche Hilfe", "Stark.") ist nirgends als Voice-Anweisung dokumentiert. Risiko: ein Implementations-Team baut "Status auswählen" statt "Wie läuft es?" — funktional richtig, vibe-mäßig tot.
- **Rhythmus-Erklärtext** (Side-Nudge "Der Rhythmus") als pädagogisches Element ist nicht spezifiziert — das erzählt User aber, warum tägliches Update überhaupt Sinn macht.
- **Lockere Quittungen** ("Stark.", "Alle Tagesupdates sind da.") sind FR-frei und drohen, im Bau durch "Update erfolgreich gespeichert." ersetzt zu werden.
### Empfehlung
Ein expliziter Abschnitt **"Voice & Tone"** in PRD oder Addendum mit:
- Beispiel-Copy aus Prototyp als Referenz ("Stark.", "Wie läuft es?", "Willkommen, [Name]").
- Verbot von Corporate-Sprech in UI (keine "KPIs", keine "Submit"-Buttons — stattdessen "Tagesupdate absenden").
- Mensch-lesbare Datumsangaben Pflicht ("in 3 Tagen", nicht "2026-05-28").
- Personalisierung mit Vornamen wo sinnvoll.
- Header-Claim "Welt der Übersicht" oder vergleichbar als emotionale Klammer entscheiden (übernehmen oder bewusst rejizieren).
---
## Zusammenfassung
- **Vollständig abgedeckt:** ~50 Items (alle Haupt-Features, Datenmodell-Entitäten, Hauptbegriffe).
- **Bewusst weggelassen mit Begründung:** ~13 Items (Prototyp-Spezifika, Phase-2-Kandidaten, Off-Brand-Visuals, Anti-Ziele).
- **Gaps zur Diskussion:** 13 Items — davon 5 mittlere Priorität (Won-Deals, gewichteter Pipeline-Wert, Crosslinks, Projekt-Streak, Detail-View-Stats) und 8 UX-/Vibe-Lücken.
- **Vokabular:** überwiegend konsistent; vier kleinere Lücken (Update-Serie, Bereichsübergreifend offen, Crosslink, Kampagnen-Status-Set).
- **Tonalität:** PRD hat eigenen guten Voice für Strategie/Anti-Ziele, aber UI-Copy-Tonalität des Prototyps ("Stark.", "Wie läuft es?", personalisierter Empfang) ist nirgends als Voice-Anweisung dokumentiert. Empfehlung: "Voice & Tone"-Abschnitt nachziehen.
@@ -0,0 +1,128 @@
# PRD Quality Review — ToolCTRL Unternehmens-Cockpit
## Overall verdict
**Good.** Das PRD ist ein angemessen kalibriertes Internal-Tool-Dokument mit klarer These ("Durchziehen-Problem, nicht Tool-Problem"), ehrlichem Scope (3 Areas statt 5, harte Anti-Ziele, sauber gepflegte Out-of-Scope-Tabelle) und einem zur Stake-Höhe passenden Detaillierungsgrad. Es trägt die Entscheidungen sichtbar (Daily-Update-Pflicht, flaches Vertrauensmodell, Authentik-OIDC) und benennt die wirklichen Risiken — insbesondere das Meta-Risiko, dass das Cockpit selbst versanden könnte. Was am ehesten wackelt, ist die Done-ness-Schärfe einzelner FRs (mehrere Adjektive ohne Bound) und ein paar leise Vagheiten in den NFRs; downstream lassen sich die Stories dennoch sauber ableiten.
## Decision-readiness — strong
Das PRD legt seine Entscheidungen offen statt sie zu verstecken. § 1.1 nennt das Kernproblem in einem Satz ohne Hedge ("kein Tool-Problem, sondern ein Durchziehen-Problem"). § 4.1 deklariert das flache Vertrauensmodell ("Alle Rollen sehen alles") und § 10 bestätigt, dass diese Entscheidung bewusst gegen Sales-Sensibilität gewählt wurde — das ist gelebter Trade-off, nicht Smoothing. § 2.2 listet sechs Anti-Ziele, jedes mit Reibung zu einer plausiblen Alternative (Ticketsystem, Zeiterfassung, BI). § 3.2 führt drei Gegenmetriken, davon zwei (CM2/CM3) explizit qualitativ — mit `[NOTE FOR PM]`-Verankerung der 4-Wochen-Retro. § 9 enthält fünf echte Open Questions mit benannten Entscheidern und Fristen ("Vor MVP-Bau"), nicht rhetorisch.
Was die Decision-readiness vom Status `strong` hält statt sie zu trüben: Die Top-Entscheidung "Daily-Update-Pflicht mit öffentlicher fehlt-heute-Liste" wird zwar in § 1.1 und FR-3 begründet, aber der explizite Trade-off — Disziplin-Mechanik gegen das Risiko Lästergefühl — taucht erst verteilt in CM3 und § 10 Risiko 2 auf. Ein einziger Decision-Block "Wir haben uns für Pflicht-mit-Öffentlichkeitsdruck entschieden, obwohl …" würde das Bild schärfer machen, ist aber für ein Internal-Tool dieses Stake-Levels Kosmetik.
### Findings
- **low** Trade-off zur Pflicht-Mechanik liegt verstreut (§ 1.1, § 3.2 CM3, § 10) — *Fix:* Optional einen 3-Zeilen-Decision-Block "Pflicht vs. freiwillig" in § 1.1 oder § 2 mit explizitem Was-wir-aufgeben.
## Substance over theater — strong
Das PRD verzichtet konsequent auf Theater-Bausteine. Es gibt **keine** Differenzierungs-/Innovations-Sektion (richtig, weil intern). Die Personas in § 4.1 sind funktional (eine Tabelle, eine Spalte "Hauptnutzen") und werden in FRs und UJs auch tatsächlich gebraucht — UJ-1 lebt vom Entwickler, UJ-2 vom PM, UJ-4 vom Onboarding. Die In-Depth-Personas (Addendum § 3) sind in den Addendum verschoben, wo sie für die UX-Phase Sinn ergeben, ohne das Hauptdokument zu verstopfen.
Die Vision in § 1.2 ist produktspezifisch ("in unter 60 Sekunden", "niemand sich tagelang wegducken kann") — sie ließe sich nicht ohne Edit in ein anderes Cockpit-PRD übertragen. § 1.3 "Warum jetzt" liefert konkrete Vergangenheit (Jira/Confluence aufgegeben, "schneller ohne PM" gescheitert), keine generischen Plattitüden.
Die NFRs in § 7 sind teilweise hart (NFR-1 ≤ 1,5 s bei 6-15 Nutzern und 90 Tagen Historie; NFR-2 ≤ 500 ms; NFR-9 ≤ 3 Klicks; CM1 ≤ 60 s Median), teilweise weicher (NFR-3 99% in Mo-Fr 8-19 — passend für Internal; NFR-13 "tägliches Backup, Mechanik in Architektur-Phase"). NFR-8 "Brand-konform … konkrete Tokens in UX-Phase" ist ehrlich vertagt und nicht Theater.
### Findings
*(Keine. Substance-Bar wird für Internal-Stake-Level vollständig getragen.)*
## Strategic coherence — strong
Das PRD hat eine sichtbare These: **Versandung ist ein Sichtbarkeits-/Disziplin-Problem, kein Werkzeug-Problem.** Diese These zieht sich durch:
- § 1.1 framt das Problem
- § 2 G1 ("≥1 Tagesupdate pro Werktag") und G2 ("Ampelstatus jederzeit erkennbar") operationalisieren die These
- FR-1/FR-3 (Puls + Heute-Quote), FR-19 (Update-Formular), FR-24/FR-25 (Streak + Fehlt-Liste), FR-2 (Blocker-Liste) sind allesamt direkte Hebel auf die These
- M1-M3 messen genau die These, nicht Vanity (M1 Update-Quote, M2 Blocker-Time-to-Visible, M3 Ampel-Frische); M4-M5 messen Verankerung im Arbeitsalltag
- Die drei Mechanik-Indikatoren im Addendum § 4 (Update-Quote, Median-Update-Alter, Overdue-Meilensteine) sind die operative Übersetzung der These — selten so sauber.
Die Feature-Priorisierung folgt der These: 3 Detail-Areas statt 5, weil Buchhaltung/Design keine etablierten KPIs haben (Addendum § 2.6); Plane/Outline-API-Sync bewusst Phase 2 (§ 8) — weil API-Komfort die These nicht stützt, Sichtbarkeit aber sofort braucht. Gegenmetriken (§ 3.2) existieren und benennen explizit, dass die Pflicht-Mechanik kippen kann.
MVP-Scope-Kind ist "problem-solving" (nicht Plattform, nicht Revenue), und die Scope-Logik passt: Drei Bereiche, drei Mechaniken, eine Startseite. Kein Backlog mit Section-Headern.
### Findings
*(Keine substanziellen.)*
## Done-ness clarity — adequate
Mehrheit der FRs trägt mindestens eine testbare Konsequenz. Gute Beispiele:
- FR-3: "X von Y Mitarbeitern haben heute gepingt" mit klickbarer Fehlt-Liste — eindeutig testbar
- FR-12: "5-Spalten Kanban: Lead → Erstgespräch → Demo → Angebot → Abschluss. Drag-and-Drop" — Stages explizit
- FR-16: 5 Funnel-Stufen explizit benannt
- FR-20: "unveränderbar nach 30 Minuten" — präzise Schwelle
- FR-25: "Werktag, nach 11:00" — Bedingung scharf
Wo die Schärfe wackelt:
- **FR-1** "aggregiertem Ampelstatus" — die Aggregations-Regel ist undefiniert. Wird die Area-Ampel aus dem schlechtesten Projekt abgeleitet, aus der Mehrheit, gewichtet? Engineering muss raten oder rückfragen.
- **FR-8** "Ampelstatus (abgeleitet aus letztem Update)" + **FR-23** "zuletzt gewinnt" — die Regel ist hier definiert (zuletzt gewinnt), aber FR-1's Area-Aggregation bleibt offen.
- **FR-5** "3-5 Key-Metrics pro Area (z. B. offene Deals, aktive Kampagnen, Projekte im Plan vs. gefährdet)" — die "z. B."-Beispiele sind keine Spezifikation. Welche Metriken konkret pro Area? Das verlässt das PRD ohne Festlegung.
- **FR-11** "schreibbar durch jede Person, Audit via `created_by` / `updated_by`" — keine Acceptance dafür, was bei Lösch-/Archiv-Operationen passiert (OQ-5 deckt nur den Archiv-Sub-Fall ab).
- **FR-21** "chronologisch angezeigt" — neueste oben oder älteste oben? Pagination? Limit?
- **NFR-1** Bound präzise; **NFR-3** "99% in Mo-Fr 8-19" angemessen für Internal; **NFR-9** "≤ 3 Klicks" scharf — aber **NFR-8** "Brand-konform" ohne Tokens und **NFR-14** "ohne Migrations-Drama" ist Adjektiv, kein Bound. Für NFR-14 wäre eine Schema-Migration-Strategie-Erwartung ("additive Migrationen, keine Daten-Drops in Phase 2") konkreter.
- **OQ-4** (Wer darf Blocker als gelöst markieren?) sollte vor MVP-Bau beantwortet sein — sonst fehlt FR-31 die Berechtigungsregel.
Insgesamt ist Done-ness ausreichend für ein Internal-Tool dieser Größe, aber die Story-Phase wird an FR-1 (Area-Aggregation), FR-5 (Key-Metrics-Katalog) und FR-21 (Sort-/Pagination) rückfragen.
### Findings
- **medium** FR-1 Area-Ampel-Aggregationsregel fehlt (§ 6.1) — *Fix:* "Worst-of aller Projekt-Ampeln in der Area" oder Alternative festlegen; einen Satz hinzufügen.
- **medium** FR-5 Key-Metrics nur als "z. B."-Beispiele (§ 6.1) — *Fix:* Pro Area die 3-5 Metriken namentlich aufzählen, oder explizit als `[ASSUMPTION]` markieren und in OQ aufnehmen.
- **low** FR-21 Sortierung/Pagination der Feeds undefiniert (§ 6.5) — *Fix:* "Neueste zuerst, Pagination ≥ N Einträge" oder Äquivalent.
- **low** NFR-14 "ohne Migrations-Drama" ist Adjektiv (§ 7.6) — *Fix:* Konkretisieren als "Phase-2-Felder additiv migrierbar; kein Daten-Drop nötig".
- **low** OQ-4 (Blocker-Auflöser-Berechtigung) muss vor Story-Bau zu FR-31 gespiegelt werden (§ 9, § 6.7) — *Fix:* Antwort früh holen; danach FR-31 ergänzen.
## Scope honesty — strong
Sehr saubere Scope-Disziplin. § 2.2 nennt sechs Anti-Ziele jeweils mit der Alternative, gegen die abgegrenzt wird. § 8 ist eine zehnzeilige Out-of-Scope-Tabelle mit Begründung pro Item — kein "TBD", jeder Eintrag trägt eine Erklärung ("URL-Link reicht zunächst", "Visualisierung zuerst beweisen, dann pushen"). FR-26 (Feiertage), FR-33 (Volltextsuche) und NFR-10 (Mobile) sind explizit als Phase 2 markiert, nicht stillschweigend ausgelassen.
`[ASSUMPTION]`-Tags sind sparsam, aber an den richtigen Stellen: UJ-4 (Authentik-Group-Mapping), FR-33 (Phase 2-Charakter), § 10 (drei Top-Annahmen zu OIDC-Aufwand, Team-Größe, Backend-Stack). `[NOTE FOR PM]` in § 3.2 verankert die 4-Wochen-Retro für CM2/CM3.
§ 9 hat fünf Open Questions mit Entscheider und Frist. Open-Items-Density: ca. 5 OQs + 4 `[ASSUMPTION]` + 1 `[NOTE FOR PM]` = 10 Open-Items bei einem MVP-PRD mit 33 FRs und 14 NFRs — angemessen für ein 4-Wochen-MVP, das in die Architektur-Phase übergeht. Keines der Items blockiert den Green-Light-Beschluss zum Bau; OQ-3 und OQ-4 sollten allerdings vor Story-Erstellung beantwortet sein.
### Findings
- **low** Assumptions-Index fehlt am Ende des PRD (§ 11 endet ohne Annex) — *Fix:* Optional einen "Annahmen-Index"-Block am Ende, der die vier `[ASSUMPTION]`-Inlines auflistet. Für Internal-Stake nicht zwingend.
## Downstream usability — adequate
Glossar ist im Addendum § 6 vorhanden und sauber gepflegt (12 Begriffe: Puls, Area, Tagesupdate, Bezug, Ampel, Blocker, Streak, Jourfixe, Meilenstein, Deal-Stage, GTM-Schritt, Lead-Funnel). Die Begriffe werden im PRD konsistent verwendet — "Puls" durchgängig in § 6.1, FR-2, FR-25; "Area" durchgängig statt Mischung mit "Bereich" (Achtung: "Bereich" wird parallel benutzt, siehe Mechanical Notes).
FR-IDs sind kontinuierlich (FR-1 bis FR-33), keine Lücken, keine Duplikate. NFRs analog (NFR-1 bis NFR-14). UJs (UJ-1 bis UJ-4), Metriken (M1-M5), Gegenmetriken (CM1-CM3), Anti-Ziele (A1-A6), Open Questions (OQ-1 bis OQ-5) — alle ID-Räume sauber, lokal benannt, eindeutig.
UJs nennen Personas implizit ("PM", "Owner", "Mitarbeiter", "Person") — nicht via exakter Label aus § 4.1. UJ-2 sagt "PM" (§ 4.1 hat "Product / PM"), UJ-3 sagt "PM oder Owner" (§ 4.1 hat "Geschäftsführung / Owner"). Das ist keine Katastrophe, aber Downstream-Story-Erstellung wird einmal nachschauen müssen. Für ein Internal-Tool akzeptabel; bei chain-top-Status mit UX-Phase davor wäre eine Persona-Label-Säuberung nützlich.
Cross-References funktionieren: FR-3 referenziert klar FR-25, FR-2 spiegelt zu FR-30. Sektionen sind extrahierbar — z. B. § 6.5 (Tagesupdates) kann allein gelesen werden, ohne "siehe oben"-Verweise.
Das PRD ist explizit Chain-Top — § 0 sagt "Tech-Entscheidungen leben im begleitenden `addendum.md` und in der späteren Architektur-Phase", § 11 plant Phase-2-Review. Downstream-Usability ist damit eine relevante Dimension.
### Findings
- **medium** UJ-Persona-Linkage nicht via exakter § 4.1-Label (§ 5) — *Fix:* "PM" → "Product / PM"; "PM oder Owner" → "Product / PM oder Geschäftsführung / Owner". Klein, aber spart Reibung.
- **low** "Bereich" und "Area" werden parallel genutzt (z. B. FR-19 "Bereich", Addendum § 6 nennt beide als Synonym) — *Fix:* Glossar-Eintrag explizit als gleichwertig erklären (ist faktisch schon dort), oder konsequent eine Form wählen. Aktuell tolerierbar.
## Shape fit — strong
Das PRD ist als **Internal-Tool / Multi-Operator-Kapazitäts-Spec** geformt, was zum Produkt passt (6-15 Nutzer, kein Verkauf, mehrere Rollen mit unterschiedlichen Workflows). Personas und UJs sind vorhanden und tragen — sie sind nicht overhead, denn das Cockpit hat echte Rollendifferenz (Sales braucht Kanban, Dev braucht Meilensteine, GF liest). SMs sind operational/Quoten-basiert (M1 Update-Quote, M3 Ampel-Frische), nicht User-Acquisition — passt zum Internal-Stake.
Was richtig dosiert ist:
- Keine Differentiator-Sektion (brauchts nicht — kein Verkauf)
- Keine Investor-Pitch-Schicht
- Keine GTM-Strategie
- Personas knapp tabellarisch + In-Depth ins Addendum verschoben
- NFR-Tiefe auf Internal-Verfügbarkeit (Mo-Fr 8-19, 99%) statt 24/7-SLA
- Brand/UX explizit auf UX-Phase verschoben
Was nicht over-formalized ist: Keine UJ-Inflation (vier UJs decken die Hauptpfade — Update schreiben, Jourfixe, Verfall-Detect, Onboarding — und das genügt für ein Cockpit). Keine 10-Persona-Parade.
Was nicht under-formalized ist: Das PRD hat eine Vision, eine These, Erfolgsmetriken, Gegenmetriken, Open Questions, Risiken — alles vorhanden, ohne aufgebläht zu wirken.
### Findings
*(Keine.)*
## Mechanical notes
- **Glossar-Drift:** "Bereich" und "Area" werden synonym verwendet; das Glossar (Addendum § 6) führt sie als gleichwertig ("Area / Bereich"). Konsistent, aber nicht ganz sauber — z. B. FR-19 nutzt "Bereich", FR-1 nutzt "Areas" im Plural. Tolerierbar.
- **ID-Kontinuität:** FR-1 bis FR-33 lückenlos. NFR-1 bis NFR-14 lückenlos. UJ-1 bis UJ-4, M1-M5, CM1-CM3, A1-A6, G1-G5, OQ-1 bis OQ-5 — alle sauber. Keine Duplikate.
- **Cross-References:** FR-3 ↔ FR-25 konsistent. FR-2 ↔ FR-30 konsistent. § 9 OQ-3/OQ-4 referenzieren implizit FR-19/FR-31 — sollte vor Story-Bau gespiegelt werden.
- **Assumptions-Index-Roundtrip:** Vier inline `[ASSUMPTION]`-Tags (UJ-4, FR-33, § 10 dreifach). Kein konsolidierter Index am Ende. Für Internal-Stake nicht zwingend, aber bei Chain-Top-Lesung praktisch.
- **UJ-Persona-Linkage:** UJs nennen Rollen nicht via exakter § 4.1-Label — siehe Downstream-Findings.
- **Erforderliche Sektionen:** Vision, Ziele, Anti-Ziele, SMs, CMs, Personas, UJs, FRs, NFRs, Out-of-Scope, Open Questions, Risks/Assumptions, Review-Punkte — alle vorhanden. Glossar ins Addendum verlagert (akzeptabel; man könnte einen einzeiligen Verweis aus dem PRD ins Addendum-Glossar setzen).
- **Addendum-Aufgabentrennung:** Tech-Skizze, verworfene Alternativen, In-Depth-Personas, Mechanik-Detail, Off-Brand-Risiken, Glossar — sauber im Addendum, hält das PRD lesbar. Das ist eine starke Trennung.