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>
405 lines
28 KiB
Markdown
405 lines
28 KiB
Markdown
---
|
||
title: PRD – ToolCTRL Unternehmens-Cockpit
|
||
status: final
|
||
created: 2026-05-25
|
||
updated: 2026-05-25
|
||
owner: Dejancosic
|
||
audience: ToolCTRL (intern, alle Mitarbeiter)
|
||
binding_frame: ToolCTRL Projektmanagement-Leitfaden v3.0 (Mai 2026)
|
||
---
|
||
|
||
# PRD – ToolCTRL Unternehmens-Cockpit
|
||
|
||
> **Was das ist.** Eine interne Web-Anwendung als tägliches Übersichts-Cockpit über alle laufenden Projekte und Bereiche von ToolCTRL. Sie operationalisiert den **ToolCTRL Projektmanagement-Leitfaden v3.0** als drittes Werkzeug neben **Plane** (Arbeit) und **Outline** (Gedächtnis) — im Leitfaden §5 (Rhythmus) so vorgesehen.
|
||
>
|
||
> **Wofür dieses Dokument da ist.** Es legt fest, was das Cockpit im MVP können muss. Capability-orientiert; technische Tiefe lebt im `addendum.md`.
|
||
|
||
---
|
||
|
||
## 1. Vision & Problemkontext
|
||
|
||
### 1.1 Das echte Problem
|
||
ToolCTRL hat **kein Tool-Problem, sondern ein Durchziehen-Problem.** Dank KI-gestützter Entwicklung starten wir 10+ Projekte parallel. Die Anfangsphase ist schnell und motivierend. Sobald Reibung entsteht, versandet das Projekt: Updates bleiben aus, Meilensteine schleifen, Verantwortlichkeit löst sich auf, Markt-Releases bleiben aus.
|
||
|
||
Wir hatten Jira und Confluence im Einsatz und haben mittendrin damit aufgehört, weil wir „schneller ohne PM" sein wollten. Ergebnis: Wir bekommen nichts fertig. Wir holen die strukturierte Projektarbeit jetzt zurück — mit der **dreigeteilten Werkzeug-Logik des Leitfadens**:
|
||
|
||
| Ebene | Werkzeug | Funktion (Leitfaden §5, §8) |
|
||
|---|---|---|
|
||
| **Arbeit** | **Plane** | Module → Issues → Sub-Issues, Boards, Cycles. *„Plane ist jederzeit die Wahrheit über den aktuellen Stand."* |
|
||
| **Gedächtnis** | **Outline** | Projektsteckbrief, Risikoliste, Status-Notizen, Entscheidungen, Lessons Learned. |
|
||
| **Übersicht / Disziplin** | **Cockpit** (dieses Produkt) | Grober Überblick über alle Projekte, tägliche Updates und Check-ins, illustrierte Unternehmensbereiche. |
|
||
|
||
Das Cockpit ist die Antwort auf: *„Warum versanden unsere Projekte? Weil niemand täglich gezwungen ist, sichtbar zu machen, wo er steht — und weil das Leitfaden-Pflicht-Minimum schleichend erodiert."* Das Cockpit erzwingt Sichtbarkeit und macht Erosion früh erkennbar.
|
||
|
||
### 1.2 Vision in einem Satz
|
||
**Das Cockpit ist der Ort, an dem jeder Mitarbeiter in unter 60 Sekunden sieht, woran heute gearbeitet wird, was klemmt, welche Projekte aus dem Plan laufen und welche das Pflicht-Minimum des Leitfadens nicht (mehr) erfüllen — und an dem niemand sich tagelang wegducken kann.**
|
||
|
||
### 1.3 Warum jetzt
|
||
- „Kein PM" als Strategie ist gescheitert.
|
||
- Der Leitfaden v3.0 setzt die verbindliche Rahmen-Methodik — das Cockpit ist sein operatives Tagesgesicht.
|
||
- Plane (Tickets) und Outline (Doku) decken den *aggregierten Status* und das *tägliche Sichtbarmachen* nicht ab.
|
||
- Das Cockpit muss vor der nächsten Welle neuer Projekte stehen, damit wir nicht in dasselbe Muster fallen.
|
||
|
||
---
|
||
|
||
## 2. Ziele & Anti-Ziele
|
||
|
||
### 2.1 Ziele (was wir erreichen wollen)
|
||
- **G1** – Jeder aktive Mitarbeiter schreibt mindestens 1× pro Werktag ein Tagesupdate. Die Quote ist öffentlich sichtbar.
|
||
- **G2** – Jedes laufende Projekt hat jederzeit einen klar erkennbaren Ampelstatus (Leitfaden §5: Grün / Gelb / Rot) inkl. Trend und einen visuellen Deadline-/Meilenstein-Verlauf.
|
||
- **G3** – Bereichsübergreifende Blocker sind innerhalb von 24h für alle Beteiligten sichtbar.
|
||
- **G4** – Das Cockpit ist feste erste Anlaufstation des Jourfixe (Di 11:00) und der täglichen Routine.
|
||
- **G5** – Mehr Projekte erreichen die „Marktreife / Release"-Phase, weil Stagnation früh sichtbar wird.
|
||
- **G6** – Erfüllung des **Pflicht-Minimums** (Leitfaden §9) ist pro Projekt sofort sichtbar; nicht erfüllte Punkte sind im Puls aufgelistet.
|
||
|
||
### 2.2 Anti-Ziele (was wir explizit NICHT bauen)
|
||
- **A1** – Kein **Ticketsystem**. Tickets bleiben in Plane.
|
||
- **A2** – Keine **Doku**. Wissens-Seiten, Steckbriefe, Risikolisten, Lessons Learned bleiben in Outline.
|
||
- **A3** – **Kein zusätzliches Projektmanagement-Tool** (Leitfaden §8: „Wir führen kein zusätzliches Projektmanagement-Tool ein."). Cockpit hält sich strikt an die Tool-Aufteilung.
|
||
- **A4** – **Kein Steckbrief-Editor.** Steckbrief lebt in Outline (Leitfaden §3). Das Cockpit verlinkt und referenziert.
|
||
- **A5** – **Kein gespiegeltes Plane-Board.** Die Issue-Liste bleibt in Plane.
|
||
- **A6** – **Keine externe Kundenkommunikation** (kein CRM, kein Kundenportal).
|
||
- **A7** – **Keine Zeiterfassung** — Kimai existiert.
|
||
- **A8** – **Kein Werkzeug zum Verkauf.** Das Cockpit ist und bleibt rein intern.
|
||
- **A9** – **Kein konfigurierbares Reporting-/BI-Dashboard** im MVP. Nur die im PRD spezifizierten Aggregate.
|
||
|
||
---
|
||
|
||
## 3. Erfolgskriterien & Gegenmetriken
|
||
|
||
### 3.1 Erfolgsmetriken
|
||
| ID | Metrik | Zielwert nach 8 Wochen Live-Betrieb |
|
||
|---|---|---|
|
||
| M1 | Anteil Werktage mit ≥1 Tagesupdate pro aktiver Person | ≥ 80% |
|
||
| M2 | Mittlere Zeit von „Blocker eingetragen" bis „im Puls sichtbar" | < 5 Minuten |
|
||
| M3 | Anteil Projekte mit aktuellem Ampelstatus (Update ≤ 3 Werktage alt) | ≥ 90% |
|
||
| M4 | Anteil Jourfixes, die das Cockpit als Hauptview nutzen | 100% |
|
||
| M5 | Aktiv genutzte Bereiche (Dev / Sales / Marketing) bekommen wöchentlich Updates | 3/3 |
|
||
| M6 | Anteil aktiver Projekte, die alle 6 Leitfaden-§9-Pflicht-Punkte erfüllen | ≥ 90% |
|
||
|
||
### 3.2 Gegenmetriken (was wir nicht kaputt machen dürfen)
|
||
| ID | Gegenmetrik | Grenze |
|
||
|---|---|---|
|
||
| CM1 | Gesamt-Tageszeit im Cockpit pro Person (Median, Werktag) | ≤ 3 Minuten |
|
||
| CM1a | Zeit pro Morgen-Einstempeln + ToDos (Median) | ≤ 60 Sekunden |
|
||
| CM1b | Zeit pro Abend-Reflexion (Median) | ≤ 90 Sekunden |
|
||
| CM2 | Anteil inhaltsleerer Pflicht-Updates | qualitativ — Jourfixe-Diskussion |
|
||
| CM3 | Spannungs-/Lästergefühl durch „fehlt heute"-Anzeige | qualitativ — 4-Wochen-Retro |
|
||
| CM4 | Doppelpflege Cockpit ↔ Outline-Steckbrief | qualitativ — wenn Steckbrief-Felder im Cockpit dupliziert werden, justieren wir |
|
||
|
||
> [NOTE FOR PM] CM2/CM3/CM4 sind qualitativ und werden 4 Wochen nach Launch im Jourfixe reflektiert.
|
||
|
||
---
|
||
|
||
## 4. Nutzer & Rollen
|
||
|
||
### 4.1 Leitfaden-Rollen (§7) – pro Projekt
|
||
| Rolle | Aufgabe im Cockpit-Kontext |
|
||
|---|---|
|
||
| **Projektverantwortliche/r** (P1) | Pflegt Ampelstatus + Trend, achtet auf Pflicht-Minimum, moderiert Cockpit-Sicht im Jourfixe für ihr/sein Projekt. |
|
||
| **Team** (P2) | Schreibt Tagesupdates mit Projektbezug; setzt Blocker; aktualisiert Meilenstein-Status. |
|
||
| **Product Owner** (P3, bei Produktprojekten) | Lese-Schwerpunkt; nutzt das Cockpit zur Priorisierungs-Diskussion. |
|
||
| **Auftraggeber** (P4, intern = Geschäftsführung) | Lesender Hauptnutzer für Pflicht-Minimum und Puls. |
|
||
|
||
### 4.2 Querschnittsrollen – alle Mitarbeiter
|
||
Alle Mitarbeiter sind aktive Cockpit-Nutzer, unabhängig vom Leitfaden-Rolle-Hut:
|
||
|
||
| Querschnitt | Hauptnutzen am Cockpit |
|
||
|---|---|
|
||
| **Entwickler** (Q1) | Tägliche Updates mit Projektbezug, Meilenstein-Status, eigene Streak. |
|
||
| **Sales / Vertrieb** (Q2) | Pflegt Deal-Pipeline + GTM-Schritte, postet Vertriebs-Updates. |
|
||
| **Marketing** (Q3) | Pflegt Lead-Funnel + Kampagnen-Status, postet Marketing-Updates. |
|
||
| **Design** (Q4) | Postet allgemeine Tagesupdates, kann Projekte als Bezug wählen. |
|
||
| **Buchhaltung** (Q5) | Postet allgemeine Tagesupdates. |
|
||
|
||
Alle Rollen sehen alles (flaches internes Vertrauensmodell im MVP).
|
||
|
||
### 4.3 Identität & Authentifizierung
|
||
Login erfolgt ausschließlich über **Authentik** (auth.tool-ctrl.de) per OIDC. Default-Bereich wird aus Authentik-Group-Claim abgeleitet (Mapping in OQ-1). Projektverantwortliche/r wird pro Projekt im Cockpit als Attribut gesetzt.
|
||
|
||
---
|
||
|
||
## 5. User Journeys
|
||
|
||
### UJ-1 — Tagesrhythmus: Einstempeln, Arbeiten, Reflektieren
|
||
*Primär: Q1-Q5*
|
||
|
||
**Morgens — Einstempeln + ToDos**
|
||
1. Person öffnet das Cockpit, klickt „Einstempeln".
|
||
2. Trägt eine **ToDo-Liste für heute** ein: 1-N Items, jedes Item mit Titel und optionalem Bezug (Projekt/Deal/Kampagne/Allgemein).
|
||
3. Speichert → Person verschwindet aus „heute fehlt eingestempelt", gilt für die Streak als „heute begonnen".
|
||
|
||
**Abends — Reflexion**
|
||
4. Person ruft im Lauf des Tages oder spätestens abends ihre ToDo-Liste auf.
|
||
5. Hakt ab, was erledigt wurde.
|
||
6. Trägt im Freitext nach, was sonst noch passiert ist (max. 1.000 Zeichen).
|
||
7. Setzt **Ampel** und — falls Bezug=Projekt vorhanden — **Trend**.
|
||
8. Optional: Blocker → bereichsübergreifende Blocker-Liste im Puls.
|
||
9. Speichert → Tag gilt als „voll abgeschlossen", Streak+1.
|
||
|
||
**Nächster Morgen — Kollegen-Sichtbarkeit**
|
||
10. Ab dem nächsten Werktagsmorgen ist der konsolidierte Vortags-Eintrag (ToDos + Häkchen + Reflexion + Ampel + Trend) für alle Kollegen sichtbar.
|
||
11. Innerhalb des laufenden Tages sehen Kollegen nur die binäre Anwesenheit („eingestempelt: ja/nein"), nicht die ToDo-Inhalte. Reduziert In-Day-Surveillance.
|
||
|
||
### UJ-2 — Jourfixe-Moderation
|
||
*Primär: P1, P4 (dienstags 11:00)*
|
||
1. PM öffnet Cockpit-Puls.
|
||
2. Geht die 3 Bereiche durch — Ampel pro Bereich, Top-Projekt-Status, offene Blocker, **Pflicht-Minimum-Score**.
|
||
3. Klickt auf rote/gelbe Projekte → Detail-View mit letzten Updates, Ampel + Trend, Meilenstein-Status, Deadline-Bar.
|
||
4. Diskutiert Blocker mit Verantwortlichen.
|
||
|
||
### UJ-3 — Projekt-Verfall früh erkennen
|
||
*Primär: P1, P4*
|
||
1. Person scrollt durch den Puls.
|
||
2. Sieht in einem Bereich ein Projekt mit roter Ampel, ablaufender Deadline-Bar **oder** unerfülltem Pflicht-Minimum.
|
||
3. Klickt → Detail-View zeigt: letztes Update vor X Tagen, X von Y Meilensteinen fällig, welche Pflicht-Punkte offen sind.
|
||
4. Schreibt direkt einen Kommentar/eine Nachfrage als allgemeines Update mit Bezug=Projekt.
|
||
|
||
### UJ-4 — Onboarding eines neuen Mitarbeiters
|
||
*Primär: Q1-Q5*
|
||
1. Mitarbeiter wird in Authentik angelegt → Cockpit-Zugriff automatisch via OIDC.
|
||
2. Erster Login: leerer „Mein Status"-Bereich + Hinweis „Hier schreibst du dein erstes Tagesupdate".
|
||
3. Default-Bereich aus Authentik-Group.
|
||
4. Schreibt das erste Update, erscheint ab sofort in Anwesenheits-/Streak-Liste.
|
||
|
||
### UJ-5 — Projekt anlegen (Cockpit-Sicht)
|
||
*Primär: P1*
|
||
1. Person legt in Outline den Steckbrief an (Leitfaden §3).
|
||
2. Wechselt ins Cockpit → „Neues Projekt anlegen" — füllt Cockpit-Sichtdaten: Name, Verantwortliche/r, Projektart (Kundenprojekt/Internes Projekt), Arbeitsmodus (Cycle/Kanban), **Steckbrief-URL** (Outline), **Plane-Board-URL**, grobe Meilensteine.
|
||
3. Cockpit zeigt das neue Projekt in seinem Bereich und im Puls. Die Pflicht-Minimum-Häkchen werden initial bewertet (Steckbrief vorhanden ✓, Verantwortliche/r ✓ usw.).
|
||
|
||
> [ASSUMPTION] Authentik-Groups werden für die initiale Bereichszuweisung genutzt. Mapping legen wir in der Architektur-Phase fest.
|
||
|
||
---
|
||
|
||
## 6. Funktionale Anforderungen (Features)
|
||
|
||
> Feature-Gruppen mit global durchnummerierten FR-IDs. Stabil für Architektur- und Story-Phase.
|
||
|
||
### 6.1 Feature-Gruppe A: Unternehmens-Puls (Startseite)
|
||
**Zweck:** Eine Seite, auf der jeder in unter 60s sieht, was los ist.
|
||
|
||
- **FR-1** Übersichtsleiste aller Bereiche (MVP: Entwicklung, Vertrieb, Marketing) inkl. aggregiertem Ampelstatus und Anzahl heute-fehlender Updates pro Bereich.
|
||
- **FR-1a** **Ampel-Aggregation pro Bereich:** *Rot*, wenn ≥1 Projekt rot ist; *Gelb*, wenn ≥1 Projekt gelb und kein rotes; *Grün*, wenn alle Projekte grün; *Grau*, wenn keine Projekte aktiv. *Pflicht-Minimum-Verstöße eines Projekts heben die Ampel mindestens auf Gelb.*
|
||
- **FR-2** Bereichsübergreifende Liste aller offenen Blocker (sortiert nach Alter).
|
||
- **FR-3** Heute-Quote: „X von Y Mitarbeitern haben heute gepingt" mit Klick → Liste der fehlenden Personen.
|
||
- **FR-4** Anzeige des nächsten Jourfixe-Termins (statisch konfigurierbar; Default Di 11:00).
|
||
- **FR-5** Pro Bereich werden folgende Key-Metrics angezeigt (verbindlicher Katalog für MVP):
|
||
- **Entwicklung:** Anzahl Projekte gesamt | im Plan (grün) | gefährdet (gelb) | blockiert (rot) | überzogene Meilensteine
|
||
- **Vertrieb:** Pipeline-Wert gewichtet (Σ value × probability) | offene Deals | gewonnene Deals (Quartal, # + EUR) | offene GTM-Schritte
|
||
- **Marketing:** Reichweite (laufende Periode) | aktive Kampagnen | Leads (Periode) | MQLs (Periode) | Übergaben an Vertrieb (Periode)
|
||
- **FR-6** Klick auf Bereichs-Kachel öffnet die Bereichs-Detail-View.
|
||
- **FR-7** **Pflicht-Minimum-Übersicht** im Puls: Liste aller aktiven Projekte mit roten/gelben Pflicht-Minimum-Punkten (siehe FR-38).
|
||
|
||
### 6.2 Feature-Gruppe B: Bereichs-Detail Entwicklung
|
||
- **FR-8** Liste aller aktiven Projekte der Entwicklung, gruppiert nach **Projektart** (Kundenprojekt / Internes Projekt — Leitfaden §1).
|
||
- **FR-9** Pro Projekt-Kachel: Name, Verantwortliche/r (P1), Ampelstatus (Grün/Gelb/Rot) + Trend (↗︎ besser / → gleich / ↘︎ schlechter), Deadline-Progress-Bar (verstrichene Zeit / Gesamtzeit), Anzahl offener Meilensteine, Pflicht-Minimum-Score (z. B. „5/6").
|
||
- **FR-10** Klick → Projekt-Detail mit:
|
||
- Kopfzeile: Name, Verantwortliche/r, Projektart, Arbeitsmodus (Cycle/Kanban), Ampel + Trend
|
||
- Pflicht-Minimum-Anzeige (FR-38)
|
||
- **Verlinkungen (Pflicht-Felder):** Outline-Steckbrief-URL, Plane-Board-URL, optional Risikoliste-URL
|
||
- Optional Definition of Done (Freitext, Cockpit-Sichtfeld)
|
||
- Meilenstein-Checkliste (Cockpit-Sicht — siehe FR-11)
|
||
- Update-Feed des Projekts
|
||
- **FR-11** Meilensteine werden im Cockpit als grobe Sicht gepflegt (Titel, Fälligkeit, Status: offen/erledigt/überzogen). *Wahrheit ist der Steckbrief in Outline;* Cockpit-Meilensteine sind eine reduzierte Sichtkopie. Doppelpflege wird akzeptiert, bis Phase-2-API-Sync eingeführt wird.
|
||
|
||
### 6.3 Feature-Gruppe C: Bereichs-Detail Vertrieb
|
||
- **FR-12** 5-Spalten-Kanban: Lead → Erstgespräch → Demo → Angebot → Abschluss. Drag-and-Drop zwischen Spalten.
|
||
- **FR-13** Deal-Karten zeigen Name, Verantwortlicher, Wert (€), **Stage-Wahrscheinlichkeit (probability, 0-100%)**, Tage in aktueller Stage.
|
||
- **FR-14** **Vertriebs-Header-KPIs:** Pipeline-Wert gewichtet (Σ value × probability), gewonnene Deals (# + EUR, laufendes Quartal), aktiver Deal-Count, durchschnittliche Stage-Verweildauer.
|
||
- **FR-15** Pro Produkt eine sortierbare GTM-Schritt-Liste (Schritt, Verantwortlicher, Status).
|
||
- **FR-16** Vertrieb-Update-Feed (Filter auf Bezug=Deal oder Bezug=Vertrieb-allgemein).
|
||
|
||
### 6.4 Feature-Gruppe D: Bereichs-Detail Marketing
|
||
- **FR-17** Horizontaler Lead-Funnel mit 5 Stufen (Reichweite → Website → Leads → MQL → Übergabe) und Conversion-Prozenten zwischen den Stufen.
|
||
- **FR-18** Liste aktiver Kampagnen mit Status (Aktiv / Pausiert / Beendet), Reichweite, Verantwortlicher.
|
||
- **FR-19** **Crosslink-Banner Marketing↔Vertrieb:** Sichtbarer Banner in Marketing & Vertrieb: „Marketing hat X Leads übergeben in [Zeitraum], Vertrieb hat daraus Y Deals erzeugt (Z €)."
|
||
- **FR-20** Marketing-Update-Feed (Filter auf Bezug=Kampagne oder Bezug=Marketing-allgemein).
|
||
|
||
### 6.5 Feature-Gruppe E: Tagesrhythmus (Einstempeln · ToDos · Reflexion)
|
||
|
||
> Ein „Tagesupdate" besteht aus zwei Touchpoints am gleichen Tag: **Morgen-Einstempeln mit ToDo-Liste** und **Abend-Reflexion**. Beides zusammen wird am nächsten Werktagsmorgen als konsolidierter Vortags-Eintrag für Kollegen sichtbar.
|
||
|
||
#### 6.5.1 Morgen — Einstempeln & ToDos
|
||
- **FR-21** „Einstempeln"-Aktion auf der Puls-Seite (großer Button bei nicht eingestempelten Personen): öffnet die ToDo-Eingabe für heute.
|
||
- **FR-22** **ToDo-Liste** für den aktuellen Werktag:
|
||
- 1-N ToDo-Items
|
||
- pro Item: Titel (max. 200 Zeichen), optionaler Bezug (Projekt/Deal/Kampagne/Allgemein), optionale Bezugs-ID
|
||
- keine Ampel/Trend pro ToDo
|
||
- **FR-23** Beim Einstempeln gilt der Tag als „begonnen" — Person verschwindet aus der „heute fehlt"-Liste auf dem Puls.
|
||
- **FR-24** **Sichtbarkeit innerhalb des laufenden Tages:**
|
||
- Kollegen sehen nur „Person hat sich eingestempelt (ja/nein)" — keine ToDo-Inhalte.
|
||
- Die Person selbst sieht ihre ToDo-Liste in „Mein heute".
|
||
- Projektverantwortliche/r eines bezogenen Projekts darf die ToDos sehen, falls Bezug auf das Projekt verweist (operative Notwendigkeit).
|
||
- **FR-25** ToDos sind während des Tages bis zur Reflexion editierbar (hinzufügen / löschen / ändern).
|
||
|
||
#### 6.5.2 Abend — Reflexion
|
||
- **FR-26** **Reflexions-Formular**: Person ruft ihre ToDo-Liste auf und füllt aus:
|
||
- Pro ToDo: ☑️ erledigt / ☐ offen / ✖️ verworfen (mit optionalem Grund)
|
||
- **Reflexions-Freitext** (max. 1.000 Zeichen) — was sonst noch passiert ist
|
||
- **Status-Ampel** (Leitfaden §5 Wortlaut):
|
||
- 🟢 Grün – im Plan
|
||
- 🟡 Gelb – spürbare Abweichung, **aber** Maßnahmenplan greift
|
||
- 🔴 Rot – Abweichung **ohne** gesicherten Plan, braucht jetzt eine Entscheidung
|
||
- **Trend** (Pflicht bei Bezug=Projekt; sonst optional): ↗︎ besser / → gleich / ↘︎ schlechter
|
||
- **Blocker** (optional Freitext, erzeugt Blocker-Eintrag — siehe FR-41ff.)
|
||
- **URL** (optional, z. B. Plane-Ticket oder Outline-Seite)
|
||
- **FR-27** Nach Speichern der Reflexion ist der Tag „voll abgeschlossen". Person zählt für die Streak als voller Tag.
|
||
- **FR-28** Reflexion ist nach 30 Minuten nicht mehr editierbar. Erinnerung optional („Du hast heute noch nicht reflektiert"-Hinweis ab z. B. 17:00 Uhr — keine externe Push-Notification im MVP).
|
||
|
||
#### 6.5.3 Konsolidierung & Sichtbarkeit
|
||
- **FR-29** Am nächsten Werktagsmorgen wird der konsolidierte Vortags-Eintrag publiziert: ToDos + Häkchen + Reflexions-Freitext + Ampel + Trend werden für Kollegen sichtbar im Bereichs-Feed und im jeweiligen Bezugs-Feed.
|
||
- **FR-30** Default-Sortierung in Feeds: neueste oben. Pagination: 50 Items pro Seite oder „Mehr laden".
|
||
- **FR-31** Eine Reflexion setzt Ampelfarbe und Trend des verlinkten Projekts/Deals/Kampagne — zuletzt eingetragener Wert gewinnt (mehrere Bezüge möglich → jeder Bezug erhält die Werte).
|
||
- **FR-32** **Rückwirkende Erfassung:** Bis zu **einem Werktag zurück** dürfen Einstempeln + Reflexion nachgetragen werden. Ältere Tage sind nicht mehr erfassbar (außer als „Abwesend" markiert, siehe FR-37).
|
||
- **FR-33** **Tages-Status pro Person** (sichtbar im eigenen Profil und im Puls für andere):
|
||
- 🟢 voll (Einstempeln + Reflexion) — zählt für Streak
|
||
- 🟡 halb (nur Einstempeln, keine Reflexion) — zählt nicht für Streak, aber Person ist „nicht durchgefallen"
|
||
- ⚪ nicht angefangen (kein Einstempeln) — fällt aus Streak
|
||
- 🟣 abwesend
|
||
|
||
### 6.6 Feature-Gruppe F: Anwesenheit / Update-Serie (Streak) / Disziplin
|
||
- **FR-34** Pro Person wird die aktuelle **Update-Serie** (Streak) — aufeinanderfolgende Werktage mit Tages-Status „voll" — angezeigt. „Halbe" Tage brechen die Streak nicht, zählen aber nicht zur Serie.
|
||
- **FR-35** „Heute fehlt"-Liste auf der Puls-Seite (siehe FR-3); klickbar, zeigt Personen ohne Einstempeln am aktuellen Werktag nach 11:00 und Personen mit „halbem" Tag-Status nach 17:00.
|
||
- **FR-36** Werktage-Definition: Mo-Fr (Feiertage Phase 2).
|
||
- **FR-37** Eine Person kann sich für einen Tag (oder Zeitraum) als „Abwesend" markieren (Urlaub / Krankheit). Diese Tage zählen nicht gegen die Streak.
|
||
|
||
### 6.7 Feature-Gruppe G: **Pflicht-Minimum-Check (Leitfaden §9)**
|
||
- **FR-38** Pro aktivem Projekt zeigt das Cockpit die 6 Pflicht-Punkte des Leitfadens als sichtbare Checkliste:
|
||
1. Projektsteckbrief in Outline freigegeben → erfüllt, wenn `outline_steckbrief_url` gepflegt **und** als „freigegeben" markiert ist
|
||
2. Projektverantwortliche/r gesetzt → erfüllt, wenn P1 zugewiesen
|
||
3. Plane-Board mit zerlegter Arbeit → erfüllt, wenn `plane_project_url` gepflegt
|
||
4. Meilensteine mit groben Terminen → erfüllt, wenn ≥1 Meilenstein definiert
|
||
5. Status-Ampel aktuell → erfüllt, wenn letzte Reflexion mit Bezug=Projekt ≤ 7 Werktage alt
|
||
6. Abschluss-Retrospektive — *nur bei beendeten Projekten relevant; aktiv = n/a*
|
||
- **FR-39** Im MVP werden Pflicht-Punkte 1, 2, 3, 4 als manuelle Bestätigungs-Felder pro Projekt geführt (Cockpit-Sicht, Doppelpflege akzeptiert). Punkt 5 wird automatisch aus dem Reflexions-Zeitstempel abgeleitet. Punkt 6 wird beim Abschluss-Workflow gesetzt.
|
||
- **FR-40** Projekte mit ≥1 unerfülltem Pflicht-Punkt erscheinen prominent auf der Puls-Seite (siehe FR-7).
|
||
|
||
### 6.8 Feature-Gruppe H: Blocker
|
||
- **FR-41** Ein Blocker entsteht entweder als Feld in einer Reflexion oder separat über „Neuer Blocker"-Button.
|
||
- **FR-42** Blocker tragen: Titel, Beschreibung, Verantwortlicher (zur Lösung), Ersteller, Bereich(e), Datum offen, Status (offen / gelöst).
|
||
- **FR-43** Blocker erscheinen auf der Puls-Seite, in den betroffenen Bereichs-Detail-Views und in der Projekt-Detail-View (falls projektgebunden).
|
||
- **FR-44** Auflösung: Auflöser, Auflöse-Datum und Auflösungs-Kommentar werden persistiert. **Nur die/der Projektverantwortliche (P1) des bezogenen Projekts darf einen Blocker als gelöst markieren.** Bei Blockern ohne Projektbezug darf die/der Ersteller/in oder Verantwortliche/r des Blockers selbst auflösen.
|
||
|
||
### 6.9 Feature-Gruppe I: Projekt-Abschluss
|
||
- **FR-45** Projektverantwortliche/r kann ein Projekt im Cockpit auf „abgeschlossen" setzen.
|
||
- **FR-46** Beim Abschluss prüft das Cockpit Pflicht-Minimum-Punkt 6 (Lessons-Learned-URL) — wenn fehlend, fordert es die URL an.
|
||
- **FR-47** Abgeschlossene Projekte verschwinden aus dem Puls, bleiben aber in einer „Archiv"-Sicht pro Bereich lesbar.
|
||
|
||
### 6.10 Feature-Gruppe J: Navigation, Suche & Filter
|
||
- **FR-48** Globale Top-Navigation: Puls / Entwicklung / Vertrieb / Marketing / „Mein heute" / Eigenes Profil / Archiv.
|
||
- **FR-49** Volltextsuche über Updates → Phase 2. Im MVP genügt Filterung im Feed nach Bereich/Bezug.
|
||
|
||
---
|
||
|
||
## 7. Nicht-funktionale Anforderungen (NFRs)
|
||
|
||
### 7.1 Performance
|
||
- **NFR-1** Puls-Seite lädt vollständig in < 1,5 s bei 6-15 aktiven Nutzern und 90 Tagen Historie.
|
||
- **NFR-2** Tagesupdate-Speichern dauert < 500 ms (Server-Roundtrip).
|
||
|
||
### 7.2 Verfügbarkeit
|
||
- **NFR-3** Zielverfügbarkeit Mo-Fr 8-19 Uhr: 99% (kein 24/7-SLA).
|
||
- **NFR-4** Geplante Wartungsfenster außerhalb der Kernzeit kommunizierbar.
|
||
|
||
### 7.3 Sicherheit & Privacy
|
||
- **NFR-5** Alle Routen sind hinter Authentik-OIDC abgesichert; kein anonymer Zugriff.
|
||
- **NFR-6** Keine PII von Externen (Deal-Karten enthalten nur intern bekannte Firmennamen, keine Klar-Personendaten).
|
||
- **NFR-7** Audit-Spur: jedes mutierende Event (Update, Blocker, Meilenstein-Statuswechsel, Pflicht-Minimum-Änderung) hat `actor`, `timestamp`, `payload`.
|
||
|
||
### 7.4 Bedienbarkeit & Visual
|
||
- **NFR-8** Brand-konform: primär weiß, sekundär schwarz, gemäß ToolCTRL Brand Identity. Konkrete Design-Tokens in der UX-Phase.
|
||
- **NFR-9** Tagesupdate-Schreib-Workflow ist in ≤ 3 Klicks ab Puls erreichbar.
|
||
- **NFR-10** Desktop-first; mobile-Responsiveness ist Phase 2 (mobil-lesbar ist Pflicht, mobil-schreibbar nicht).
|
||
- **NFR-11** Sprache: Deutsch durchgängig im UI. Keine i18n im MVP.
|
||
|
||
### 7.5 Voice & Tone (Mikrocopy)
|
||
- **NFR-12** Tonalität ist **locker, direkt, deutsch, kurze Imperative.** Beispiele aus dem Prototyp als Voice-Anker:
|
||
- „Stark."
|
||
- „Wie läuft es?"
|
||
- „Du hast heute noch nicht gepingt."
|
||
- „Willkommen, [Name]"
|
||
- **NFR-13** Keine Corporate-Sprech-Phrasen („wir möchten Sie darauf hinweisen", „im Zuge der Optimierung"). Keine englischen Floskeln im Fließtext der UI (Fachbegriffe wie „Backlog", „Kanban" sind okay — sie kommen aus dem Leitfaden).
|
||
|
||
### 7.6 Datenhaltung
|
||
- **NFR-14** Persistenz in **Postgres**. Kein localStorage-only.
|
||
- **NFR-15** Tägliches Backup (Mechanik in Architektur-Phase).
|
||
|
||
### 7.7 Erweiterbarkeit
|
||
- **NFR-16** Datenmodell muss Phase-2-Erweiterungen ohne mehr als eine zweistündige Migration tragen: zusätzliche Bereiche (Design, Buchhaltung), Plane/Outline-API-Sync, Kommentare auf Updates, Mobile, Feiertags-Kalender.
|
||
|
||
---
|
||
|
||
## 8. Out of Scope (MVP) / Phase-2-Kandidaten
|
||
|
||
| Item | Begründung |
|
||
|---|---|
|
||
| Plane-API-Sync (Ticket-Status, Owner, Titel ziehen; Meilensteine auto-erkennen) | Komplexität verzögert MVP; URL-Link reicht zunächst. |
|
||
| Outline-API-Sync (Steckbrief-Status „freigegeben" auto-erkennen) | Selbe Begründung; manuelle Bestätigung reicht. |
|
||
| Outline-Embed | Verlinkung genügt. |
|
||
| Design-Bereich, Buchhaltung-Bereich (eigene Detail-Views) | Beide nutzen „Allgemein" im MVP. |
|
||
| Mobile-App / Responsive Mobile-UI (schreibend) | Desktop deckt 95% der täglichen Nutzung ab; mobil bleibt lesbar. |
|
||
| Volltextsuche über Updates | Filter im Feed reicht im MVP. |
|
||
| Reaktionen / Kommentare auf Updates | Nice-to-have, kein Kernproblem. |
|
||
| Reminders per Element/Matrix/Mail bei fehlendem Update | Cockpit-Visualisierung zuerst beweisen, dann pushen. |
|
||
| Konfigurierbare Reporting-/BI-Dashboards | Andere Werkzeuge geeigneter. |
|
||
| Zeiterfassung | Kimai existiert. |
|
||
| Mehrsprachigkeit | Nicht nötig. |
|
||
| Feiertags-Kalender (für Streak-Berechnung) | MVP: Mo-Fr ohne Feiertags-Sonderfall. |
|
||
|
||
---
|
||
|
||
## 9. Offene Fragen
|
||
|
||
| ID | Frage | Wer entscheidet | Bis wann | Phase-Blocker? |
|
||
|---|---|---|---|---|
|
||
| OQ-1 | Genaues Mapping Authentik-Groups → Cockpit-Bereiche? | Architektur-Phase | Vor MVP-Bau | ja |
|
||
| OQ-2 | Welche konkreten Brand-Tokens (Hex, Typografie, Logo-Verwendung) gelten 1:1? | UX-Phase | Vor UI-Bau | ja |
|
||
| OQ-5 | Archivierte Projekte: Historie für immer behalten oder nach X Monaten löschen? | Architektur + Product | Vor MVP-Bau | nein |
|
||
| OQ-8 | Erinnerungszeit für „du hast noch nicht reflektiert"-Hinweis (Default 17:00)? | Product (Dejan) | Vor Story-Bau | nein |
|
||
| OQ-9 | Was passiert, wenn eine Person die ToDo-Liste morgens leer lässt — ist „eingestempelt mit 0 ToDos" gültig oder muss ≥1 ToDo gesetzt sein? PRD-Default: ≥1 ToDo Pflicht. | Product (Dejan) | Vor MVP-Bau | nein |
|
||
| OQ-10 | Darf eine Person ToDos *nach* dem Abend-Reflektieren noch nachtragen (z. B. „bin um 10 noch zur Apotheke gefahren")? PRD-Default: nein, nach Reflexion ist der Tag geschlossen. | Product (Dejan) | Vor Story-Bau | nein |
|
||
|
||
**Beschlossene OQs (vorher offen, jetzt im PRD verankert):**
|
||
- ~~OQ-3~~ → Rückwirkende Erfassung **max 1 Werktag zurück** (FR-32).
|
||
- ~~OQ-4~~ → Nur P1 (oder Blocker-Ersteller/Verantwortlicher bei projektlosen Blockern) darf auflösen (FR-44).
|
||
- ~~OQ-6~~ → Pflicht-Minimum-Punkt 1 als manuelle Cockpit-Checkbox im MVP (FR-39).
|
||
- ~~OQ-7~~ → Trend **Pflicht bei Bezug=Projekt**, sonst optional (FR-26).
|
||
|
||
---
|
||
|
||
## 10. Annahmen-Index
|
||
|
||
Sammlung aller im PRD getroffenen Annahmen — zur expliziten Bestätigung im Architektur- bzw. UX-Lauf:
|
||
|
||
- **A-1** Authentik-OIDC-Integration ist technisch in < 1 Tag erledigt (Erfahrung aus Plane/Outline-Setup).
|
||
- **A-2** Authentik-Groups werden für die initiale Bereichszuweisung genutzt; Mapping wird in der Architektur-Phase festgelegt.
|
||
- **A-3** Team wächst in den nächsten 12 Monaten nicht über 30 Personen.
|
||
- **A-4** Postgres + ein leichter Backend-Layer reichen aus; konkrete Backend-Wahl in Architektur-Phase.
|
||
- **A-5** Pflicht-Minimum-Punkte 1-4 werden im MVP manuell im Cockpit bestätigt (kein Outline-/Plane-API-Sync).
|
||
- **A-6** Doppelpflege Cockpit-Meilenstein ↔ Outline-Steckbrief ist im MVP akzeptiert; wird beobachtet (CM4).
|
||
|
||
---
|
||
|
||
## 11. Risiken
|
||
|
||
| Risiko | Mitigation |
|
||
|---|---|
|
||
| Das Cockpit wird selbst zu einem „starten und abbrechen"-Projekt. | MVP-Scope hart klein halten. Erstes Release in 4 Wochen anpeilen. Selbst-Dogfooding ab Tag 1. **Das Cockpit selbst muss das Pflicht-Minimum erfüllen.** |
|
||
| Daily-Update-Pflicht erzeugt Lästergefühl. | CM2/CM3 messen; 4-Wochen-Retro; Mechanik justierbar. |
|
||
| Cockpit erodiert die Tool-Aufteilung des Leitfadens (wird Schatten-Plane oder Schatten-Outline). | A1-A5 + CM4 wachen darüber. Architektur-Phase prüft den Schnitt explizit. |
|
||
| Sales-Daten sind sensibel und sollen evtl. nicht jeder sehen. | MVP: flaches Vertrauen, alle sehen alles. Bei Bedarf in Phase 2 Rollen-Sichtbarkeit. |
|
||
| Pflicht-Minimum-Häkchen werden „durchgewinkt" und verlieren Bedeutung. | Jourfixe diskutiert Stichproben. Phase 2: Outline-/Plane-API-Validierung. |
|
||
|
||
---
|
||
|
||
## 12. Erfolgskontrolle & Review-Punkte
|
||
|
||
- **Woche 2 nach Launch** – kurzer Puls-Check im Jourfixe: M1 erreicht?
|
||
- **Woche 4 nach Launch** – Retro: CM2/CM3/CM4. Adjust falls nötig.
|
||
- **Woche 8 nach Launch** – Vollauswertung gegen M1-M6. Entscheidung: Phase 2 starten oder MVP weiter härten?
|
||
|
||
---
|
||
|
||
*Ende PRD. Begleitend: `addendum.md` (technische Tiefe, verworfene Alternativen, Leitfaden-Bezüge, In-Depth-Personas) und `.decision-log.md` (Audit-Trail).*
|