--- 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.*