Files
everythingbutwork/_bmad-output/planning-artifacts/prds/prd-projectmanagement-2026-05-25/.decision-log.md
T
dejanandClaude Opus 4.7 4f33509a0f
ci / quality (push) Has been cancelled
ci / build (push) Has been cancelled
Initial commit: everythingbutwork MVP
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>
2026-05-25 22:47:26 +02:00

11 KiB
Raw Blame History

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