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

274 lines
15 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.
---
title: Addendum – ToolCTRL Unternehmens-Cockpit
status: final
created: 2026-05-25
updated: 2026-05-25
binding_frame: 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.*