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>
11 KiB
11 KiB
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 inextract-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_framegesetzt. - 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, neueLeadHandover-Entität. - Addendum §7 "Leitfaden-Bezüge"-Tabelle ergänzt.
- PRD-Frontmatter
- 2026-05-25 – Reconciliation-Subagent Findings eingearbeitet:
- FR-13:
probabilityergä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.
- FR-13:
- 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
DayEntryersetztUpdate, neue EntitätTodo, 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: finalin 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-clientv6+ 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), danachbmad-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-Lockupcockpit ^, 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).