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

161 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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).**