Initial commit: everythingbutwork MVP
ci / quality (push) Has been cancelled
ci / build (push) Has been cancelled

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>
This commit is contained in:
dejanandClaude Opus 4.7 committed 2026-05-25 22:47:26 +02:00
commit 4f33509a0f
131 files changed
+34339

No files matched your search

@@ -0,0 +1,273 @@
---
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.*