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>
161 lines
11 KiB
Markdown
161 lines
11 KiB
Markdown
# 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).**
|