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>
274 lines
15 KiB
Markdown
274 lines
15 KiB
Markdown
---
|
||
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.*
|