# 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).**