Files
everythingbutwork/_bmad-output/planning-artifacts/prds/prd-projectmanagement-2026-05-25/addendum.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

15 KiB
Raw Blame History

title, status, created, updated, binding_frame
title status created updated binding_frame
Addendum – ToolCTRL Unternehmens-Cockpit final 2026-05-25 2026-05-25 ToolCTRL Projektmanagement-Leitfaden v3.0 (Mai 2026)

Addendum zum PRD – ToolCTRL Unternehmens-Cockpit

Inhalte, die im Hauptdokument den Lesefluss stören würden, aber für Architektur, UX-Design und das spätere Verständnis von Entscheidungen wichtig sind.


1. Technische Orientierung (vorläufig)

1.1 Stack-Default

  • Frontend: React.
  • Datenhaltung: Postgres.
  • Backend: offen — Node/Express oder Fastify (passt zur React-Welt), Python/FastAPI, oder .NET. Entscheidung in Architektur-Phase.
  • Auth: Authentik (auth.tool-ctrl.de) via OIDC. Cockpit als weitere App im Authentik-Provider; Token-Validierung im Backend.
  • Hosting: wahrscheinlich gleiche interne Infrastruktur wie Plane/Outline/Gitea.

1.2 Datenmodell-Skizze (nicht normativ)

User
  id, authentik_sub, name, email, default_area_id, active, abwesend_bis

Area
  id, name, kind (dev|sales|marketing|allgemein), order

Project
  id, area_id, name,
  kind (kundenprojekt|internes_projekt)             # Leitfaden §1
  verantwortliche_user_id                            # Leitfaden §7 (P1)
  arbeitsmodus (cycle|kanban)                        # Leitfaden §5
  outline_steckbrief_url
  steckbrief_freigegeben (bool, manuell)
  plane_project_url
  risikoliste_url (nullable)
  dod_text (nullable, Freitext)                      # Leitfaden §4
  start, deadline,
  status_cache (green|amber|red|null)
  trend_cache (besser|gleich|schlechter|null)
  pflicht_minimum_state (jsonb mit 6 booleans)       # Leitfaden §9
  archiviert (bool), archiviert_am, lessons_learned_url (nullable)
  created_by, created_at

Milestone
  id, project_id, title, due, status (open|done|overdue), description

Deal
  id, area_id (=sales), name, owner_id, value_eur,
  probability (0-100),                               # für gewichtete Pipeline
  stage (lead|erstgespraech|demo|angebot|abschluss),
  entered_stage_at,
  won_at (nullable), won_value_eur (nullable)

GtmStep
  id, product, title, owner_id, status (open|in_progress|done), order

Campaign
  id, area_id (=marketing), name, status (active|paused|done),
  reach, owner_id

LeadHandover                                          # Crosslink Marketing → Sales
  id, campaign_id, dealkette_deal_ids (array),
  übergeben_am, übergeben_von

DayEntry                                              # ersetzt das alte "Update"
  id, user_id, date,
  status (begun|full|absent),                          # begun = nur Einstempeln; full = Einstempeln + Reflexion
  checked_in_at,                                       # Zeitstempel Morgen-Einstempeln
  reflected_at (nullable),                             # Zeitstempel Abend-Reflexion
  reflection_text (nullable, max 1000 Zeichen),
  ampel (green|amber|red|null),
  trend (besser|gleich|schlechter|null),
  url (nullable),
  blocker_id (nullable),
  edit_locked_at (nullable),                           # 30 Min nach Reflexion
  published_at                                         # nächster Werktag 00:00 — ab dann für Kollegen sichtbar

Todo
  id, day_entry_id, user_id, date,
  title (max 200), order,
  bezug_kind (project|deal|campaign|allgemein|null),
  bezug_id (nullable),
  status (open|done|dropped),
  drop_reason (nullable, Freitext),
  created_at, completed_at, dropped_at

# Hinweis: ein Tagesupdate (DayEntry) hat 0..N Todos plus einen einzigen
# Reflexionsblock. Vor `published_at` sehen nur die Person selbst und
# Projektverantwortliche (für Todos mit Projekt-Bezug) die Inhalte.

Blocker
  id, title, description, area_id, project_id (nullable),
  owner_id, opened_by, opened_at,
  resolved_by, resolved_at, resolution_text

AbsenceDay
  id, user_id, date, reason (urlaub|krank|sonstiges)

AuditEvent
  id, actor_user_id, action, entity_kind, entity_id, payload_jsonb, created_at

1.3 Auth-Flow

  1. User öffnet cockpit.tool-ctrl.de.
  2. Backend prüft Session-Cookie; bei Fehlen Redirect auf Authentik-Authorize-Endpoint.
  3. Authentik liefert OIDC-Code, Cockpit-Backend tauscht ihn gegen Token (Authorization Code Flow + PKCE).
  4. Backend legt User in eigener Tabelle an, falls erstmaliger Login (Mapping per sub).
  5. Default-Area wird aus Authentik-Group-Claim gemappt.

1.4 Phase 2 – Plane/Outline-Integration (Skizze)

  • Plane: API-Token; bei Eingabe einer Plane-URL holt das Backend Titel, Status und Owner und cached sie. Pflicht-Minimum-Punkt 3 (Plane-Board) wird damit automatisch validiert.
  • Outline: bei Eingabe einer Steckbrief-URL prüft das Backend per Outline-API, ob das Dokument existiert und welchen Status es hat (Draft/Published). Pflicht-Minimum-Punkt 1 wird damit automatisch validiert.
  • Lessons-Learned-Vorlage: beim Projekt-Abschluss erzeugt das Cockpit eine vorbefüllte Outline-Seite gemäß Leitfaden-Vorlage.

2. Verworfene Alternativen

2.1 „Bleiben wir bei Plane allein, sparen uns das Cockpit"

  • Verworfen, weil: Plane ist ein Tickets-Tool. Es zwingt nicht zu täglichen Updates und aggregiert nicht über Bereiche hinweg. Der Schmerz „wir sehen nicht, was läuft" bleibt ungelöst. Das Cockpit ist im Leitfaden §5 zudem explizit vorgesehen.

2.2 „Zurück zu Jira+Confluence"

  • Verworfen, weil: schon einmal aufgegeben. Plane/Outline sind die strategisch gewollten Nachfolger.

2.3 „Slack/Element-Channel mit Daily-Standup-Bot"

  • Verworfen, weil: Chat skaliert nicht zu Übersicht. Visualisierung (Puls, Funnel, Kanban) und Aggregation fehlen; Suche und Filter sind schwach.

2.4 „SaaS-Lösung kaufen (Range, Geekbot, Standuply, etc.)"

  • Verworfen, weil: externe SaaS bedeutet weiteren Anbieter, Datenabfluss und Auth-Insel. ToolCTRL bevorzugt Self-Hosting hinter Authentik. Keine der untersuchten Lösungen trifft die ToolCTRL-Spezifika (Pflicht-Minimum-Check aus Leitfaden, Crosslinks, GTM-Schritte).

2.5 „localStorage / Single-Page, kein Backend"

  • Verworfen, weil: Multi-User braucht Server-Persistenz.

2.6 „Alle 5 Bereiche mit Detail-Views im MVP"

  • Verworfen, weil: Buchhaltung und Design haben keine etablierten KPI-Strukturen. Detail-Views wären leere Skelette. Phase 2 nach Definition.

2.7 „Steckbrief-Editor ins Cockpit holen — One-Stop-Shop"

  • Verworfen, weil: Leitfaden §8 ist explizit: „Wir führen kein zusätzliches Projektmanagement-Tool ein." Outline ist das Gedächtnis. Doppel-Storage erodiert die Tool-Aufteilung.

2.8 „Plane-Issues spiegeln, damit man im Cockpit Tickets sieht"

  • Verworfen, weil: Plane ist „jederzeit die Wahrheit" (Leitfaden §5). Ein Spiegel driftet auseinander. Wir verlinken auf Plane.

2.9 „CRUD für Projekte komplett aus dem Cockpit raus, nur API-Sync"

  • Verworfen, weil: im MVP gibt es noch keinen API-Sync. Pragmatik vor Reinheit: das Cockpit pflegt eine reduzierte Sicht (Name, Verantwortliche/r, URLs, grobe Meilensteine), bis Phase 2 kommt. Die Doppelpflege wird offen kommuniziert und gemessen (CM4).

3. In-Depth-Personas (für UX-Phase)

3.1 Lukas, Entwickler, 28

  • Macht morgens Code, will das Cockpit in unter 30 s pro Tag bedienen.
  • Wechselt häufig zwischen 2–3 Projekten am Tag.
  • Lästert intern, wenn das Tool ihn „checken" lässt. Sichtbar zu machen, dass Kollege X seit 5 Tagen blockt, empfindet er als hilfreich.

3.2 Dejan, Owner / Auftraggeber (P4), oft auch P1, 35

  • Will im Jourfixe nicht mehr fragen „wie sieht's bei X aus" — sondern direkt klicken.
  • Liest den Puls 2× täglich, schreibt selbst 1× Tagesupdate mit Bezug „Allgemein" oder zu einem Projekt.
  • Größte Sorge: dass das Cockpit-Projekt das gleiche Schicksal erleidet wie Jira/Confluence zuvor.

3.3 Sales-Kollege (Q2), 30+

  • Lebt im Kanban-Tab; bewegt 5–10 Karten pro Woche.
  • Schreibt Tagesupdates ungern, wenn das Schreiben träge ist — daher CM1-Schwellwert (≤ 60 s Median).
  • Will den eigenen Funnel-Snapshot stolz zeigen können — Marketing-Crosslink (FR-19) ist UI-relevant.

3.4 Marketing-Kollege (Q3)

  • Aktualisiert wöchentlich Kampagnen, weniger täglich.
  • Die tägliche Update-Pflicht ist die ungewohnteste Anforderung — UX muss kurze „heute kein Fortschritt, aber dran"-Updates erlauben.

3.5 Designerin / Buchhaltung (Q4, Q5)

  • Schreiben Tagesupdates mit Bezug „Allgemein". Die UI darf sie nicht zwingen, ein Projekt zu wählen.
  • Bereich = ihr eigener (Authentik-Group), Bezug-Default = „Allgemein".

4. Mechanik-Detail: Wie wir „Versandung" wirklich messen

Vier Indikatoren zusammen:

  1. Update-Quote pro Person/Tag — direkter Disziplin-Indikator. Sinkt sie unter 70 %, ist die Cockpit-Kultur erodiert.
  2. Median-Update-Alter pro Projekt — steigt der Median über 7 Werktage, hat das Projekt aufgehört zu leben.
  3. Anteil Meilensteine mit Status overdue — steigt er über 30 %, sind Planung und Realität auseinandergedriftet.
  4. Pflicht-Minimum-Erfüllungsquote (M6) — die Leitfaden-Brücke. Sinkt sie, geht es nicht nur am Status, sondern an der Methodik selbst.

Diese vier werden im Puls aggregiert und in der 4-Wochen-Retro besprochen.


5. Off-Brand-Risiken des Prototyps

Der HTML-Prototyp (inputs/unternehmens-cockpit.html) zeigt das gewünschte Konzept gut, trifft aber visuell nicht die Markenrichtung:

  • Hintergrund: Hellgrau (#eceef3) — soll weiß sein.
  • Header: dunkles Navy — passt nicht zu „weiß primär, schwarz sekundär".
  • Akzentfarbe: Indigo (#4f46e5) — durch ToolCTRL-Brand-Akzent ersetzen.
  • Ampelfarben (Grün/Amber/Rot): inhaltlich nötig, an die Brand-Palette adaptieren, ohne Funktion zu verlieren.

Die UX-Phase muss das Re-Skinning explizit durchführen — der Prototyp ist Logik-Referenz, keine Visual-Referenz. Die Voice-Anker aus dem Prototyp („Stark.", „Wie läuft es?", „Welt der Übersicht", „Willkommen, [Name]") sind zu bewahren — siehe NFR-12/13 im PRD.


6. Konzept-Vokabular

Begriff Bedeutung im Produkt Quelle
Puls Startseite — Unternehmens-Übersichtspuls. Prototyp
Area / Bereich Fachliche Spielwiese: Entwicklung, Vertrieb, Marketing. Prototyp + Leitfaden
Tagesupdate / DayEntry Kombinierter Tageseintrag einer Person: Einstempeln + ToDos + Reflexion + Ampel + Trend. Leitfaden §5 + ToolCTRL-Workflow
Einstempeln Morgendliche Anwesenheits-Aktion plus Anlegen der ToDo-Liste für den Tag. ToolCTRL-Workflow
ToDo Selbstgesetzter Tagesplan-Punkt mit optionalem Bezug, abends abhakbar. ToolCTRL-Workflow
Reflexion Abendlicher zweiter Touchpoint: ToDos abhaken, Freitext, Ampel, Trend. ToolCTRL-Workflow
„Mein heute" Persönliche Tagessicht (eigene ToDos, eigener Status) — privat während des Tages. Cockpit-Konzept
Konsolidierter Vortagseintrag Die für Kollegen sichtbare Version eines DayEntry, publiziert am nächsten Werktagsmorgen. Cockpit-Konzept
Bezug Worauf sich ein Tagesupdate bezieht: Projekt / Deal / Kampagne / Allgemein. Prototyp
Ampel Grün (im Plan) / Amber (Abweichung, Plan greift) / Rot (Abweichung, kein Plan). Leitfaden §5
Trend besser / gleich / schlechter. Leitfaden §5
Blocker Strukturiertes Hindernis, bereichsübergreifend sichtbar. Prototyp
Update-Serie / Streak Aufeinanderfolgende Werktage mit ≥ 1 Tagesupdate. Prototyp
Jourfixe Wöchentliches Treffen, vom Puls aus moderiert (Default Di 11:00). ToolCTRL
Crosslink Lead-Übergabe-Banner Marketing → Vertrieb. Prototyp
Bereichsübergreifend offen Label für die aggregierte Blocker-Liste im Puls. Prototyp
Pflicht-Minimum Die 6 Pflichtpunkte pro Projekt. Leitfaden §9
Projektsteckbrief Eckdaten-Dokument in Outline. Das Cockpit verlinkt darauf. Leitfaden §3
Zieldreieck Leistung & Umfang · Zeit · Aufwand. Leitfaden §1
Meilenstein Überprüfbares Zwischenergebnis am Phasen-Ende. Leitfaden Anhang
Baseline Freigegebener Bezugsstand (Steckbrief nach Freigabe). Leitfaden Anhang
Scope Creep Schleichende, unkontrollierte Umfangserweiterung. Leitfaden Anhang
Definition of Done (DoD) Festlegung, wann etwas wirklich „fertig" ist. Leitfaden Anhang
Module / Issue / Sub-Issue Plane-Hierarchie der Arbeitszerlegung. Leitfaden §4
Cycles / Kanban Zwei Arbeitsmodi der Umsetzungsphase. Leitfaden §5
Retrospektive / Lessons Learned Strukturierter Rückblick am Projektende. Leitfaden §6
Deal-Stage Lead → Erstgespräch → Demo → Angebot → Abschluss. Prototyp
GTM-Schritt Go-to-Market-Aufgabe pro Produkt. Prototyp
Lead-Funnel Reichweite → Website → Leads → MQL → Übergabe. Prototyp
Projektart Kundenprojekt oder Internes Projekt. Leitfaden §1
Projektverantwortliche/r (P1) Eine Person pro Projekt, führt das Zieldreieck. Leitfaden §7

7. Leitfaden-Bezüge (was setzt was um)

Tabelle zur Nachvollziehbarkeit, welche PRD-Anforderung auf welchen Leitfaden-Paragraphen zurückgeht. Hilft Architektur- und Story-Phase, die Methodik-Anbindung zu prüfen.

Leitfaden-Abschnitt Im PRD umgesetzt durch
§1 Was ein Projekt ist · Projektarten FR-8 (Projektart-Gruppierung); Datenmodell Project.kind.
§1 Zieldreieck Implizit in Ampel + Trend + Meilenstein-Status (kein eigenes UI).
§2 Vier-Phasen-Zyklus FR-35-37 (Abschluss-Workflow); UJ-5 (Anlegen).
§3 Projektsteckbrief A4 (kein Editor); FR-10 (Verlinkung); FR-30 Pflicht-Punkt 1.
§3 SMART-Ziele nicht explizit im Cockpit (lebt in Outline); im Leitfaden §3 als Pflicht-Inhalt des Steckbriefs referenziert.
§3 Stakeholder nicht im MVP; bleibt im Outline-Steckbrief.
§4 Arbeit zerlegen A5 (kein Spiegel des Plane-Boards); FR-30 Pflicht-Punkt 3.
§4 Meilensteine FR-11 Cockpit-Sicht; FR-30 Pflicht-Punkt 4.
§4 Aufwand schätzen Out of Scope — Kimai + Plane decken ab.
§4 Risiken FR-10 (Risikoliste-URL verlinken); Liste bleibt in Outline.
§5 Arbeitsmodus (Cycles/Kanban) Datenmodell Project.arbeitsmodus; angezeigt in FR-10.
§5 Rhythmus → tägliche Updates im Cockpit gesamte Feature-Gruppe E (Einstempeln · ToDos · Reflexion).
§5 Status sichtbar machen (Ampel + Trend + 2-3 Sätze) FR-26 Reflexions-Formular (Ampel, Trend, Freitext ≤ 1000 Zeichen).
§5 Mit Änderungen umgehen Out of Scope MVP; ändert nur den Outline-Steckbrief.
§5 Reviews an Meilensteinen FR-11 Meilenstein-Status; UJ-3 Verfall-Erkennung.
§6 Abschluss / Lessons Learned FR-35-37; Pflicht-Punkt 6.
§7 Rollen §4.1 PRD (Projektverantwortliche/r, Team, PO, Auftraggeber).
§8 Tool-Aufteilung A3-A5 PRD; gesamtes Strategie-Framing.
§9 Pflicht-Minimum Feature-Gruppe G (FR-30); M6; Puls-Sichtbarkeit.

Ende Addendum.