Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/_bmad-output/specs/M26-tasks.md
T

17 KiB
Raw Blame History

module, title, phase, status, last_updated, session_source, related_lps, spec_style
module title phase status last_updated session_source related_lps spec_style
26 Tasks / Aufgaben 1 detail-spec-draft 2026-05-08 brainstorming-session-2026-05-07-2206.md
LP-2
LP-4
LP-7
LP-9
LP-10
requirements-pur

Modul 26 — Tasks / Aufgaben

Detail-Spec gemäß LP-9. Leichtgewichtiges Aufgaben-Modul, das quer zu allen Entitäten liegt. Tasks entstehen manuell, aus Chat-Nachrichten („Mark as Task"), aus Form-Submissions und aus Automation-Actions. Commodity-Säule (LP-4) — gut genug, kein Wettbewerb mit Asana/Trello.

Themenblöcke

A. Datenmodell
B. Menü-Struktur und Routes
C. Listen-Views (Meine Tasks, Projekt-Tasks, Tenant-Tasks)
D. Detail-View
E. Erstellungs-Quellen (manuell, Chat, Form, Automation)
F. Reminder & Auto-Archivierung
G. Activity-Stream-Integration
H. Permissions-Anwendung

Block A — Datenmodell

Task

  • id, tenant_id, created_at, updated_at, created_by_user_id
  • title (Pflicht, Text)
  • description (Markdown-Freitext, optional)
  • assigned_to_user_id (FK auf User, optional — eine Person als Hauptverantwortlicher)
  • assigned_to_group_id (FK auf Group, optional — alternativ zu Person; siehe Constraint)
  • deadline_at (Timestamp, optional)
  • priority (Enum: low | normal | high | urgent, Default normal)
  • status (Enum: open | in_progress | done, Default open)
  • completed_at (Timestamp, gesetzt bei Übergang zu done)
  • completed_by_user_id (FK auf User, gesetzt bei Übergang zu done)
  • archived_at (Timestamp, gesetzt bei Auto-Archivierung)
  • source (Enum: manual | chat_message | form_submission | automation)
  • source_ref (JSON — Referenz auf Quell-Entität, z.B. { "chat_message_id": "..." })
  • linked_entity_type (Enum: contact | company | lead | deal | project | null)
  • linked_entity_id (FK, optional — die Haupt-Entität, an der die Task hängt)

Constraints:

  • Entweder assigned_to_user_id oder assigned_to_group_id gesetzt — nicht beides, nicht keines (Tasks ohne Zuweisung sind nicht erlaubt; bei Anlage Default = Ersteller)
  • completed_at und completed_by_user_id nur gesetzt wenn status = done
  • Bei Wechsel done → open/in_progress: completed_at und completed_by_user_id werden zurückgesetzt

Indizes:

  • (tenant_id, assigned_to_user_id, status, deadline_at) — für „Meine Tasks"-Listen
  • (tenant_id, linked_entity_type, linked_entity_id) — für Anzeige an Entity-Detail-Views
  • (tenant_id, status, completed_at) — für Auto-Archivierungs-Cron
  • (tenant_id, archived_at) — für Filter „Archivierte anzeigen"

TaskWatcher (Phase 1, optional erweiterbar)

  • task_id, user_id, tenant_id
  • M:N — User, die Notifications zur Task bekommen sollen, ohne Assignee zu sein
  • Auto-Eintrag: Ersteller wird Watcher, wenn nicht selbst Assignee
  • Phase 1 minimal genutzt — Erweiterung in Phase 2

Block B — Menü-Struktur und Routes

Sidebar-Hauptpunkt: Aufgaben (eigener Top-Level-Punkt, da quer zu allen Modulen).

Routen:

/{tenant}/tasks                   → Task-Liste (Default: meine offenen Tasks)
/{tenant}/tasks/new               → Neue Task (Modal oder Page — Designer entscheidet)
/{tenant}/tasks/:id               → Task-Detail (Modal oder Page — Designer entscheidet)

Sub-Routen / Filter-Presets (über Query-Parameter, keine eigenen Routen):

  • ?scope=mine (Default) — vom User zugewiesene Tasks
  • ?scope=created_by_me — vom User erstellte Tasks
  • ?scope=all — alle Tasks im Tenant (nur mit tasks.read_all)
  • ?status=open|in_progress|done|archived
  • ?linked_entity_type=project&linked_entity_id=... — Tasks zu einer bestimmten Entität (verlinkt aus Entity-Detail-Views)

Embed-Anzeige in Entity-Detail-Views:

  • Contact-/Company-/Lead-/Deal-/Project-Detail-Views zeigen einen Tasks-Tab/Section mit verknüpften Tasks
  • Funktion „Aufgabe anlegen" in jeder Entity-Detail-View (Pre-Fill der Verknüpfung)

Block C — Listen-Views

„Meine Tasks" (Default-Ansicht unter /{tenant}/tasks)

Zu zeigende Daten pro Eintrag:

  • Titel
  • Priorität (visuelles Zeichen — Designer entscheidet)
  • Deadline (relativ wenn ≤ 7 Tage, absolut sonst, Markierung wenn überfällig)
  • Verknüpfte Entität (Typ + Name als Klick-Link)
  • Assignee (Person oder Group — bei Group-Zuweisung als Group-Name)
  • Status
  • Quelle (visueller Hinweis, falls aus Chat/Form/Automation entstanden)

Benötigte UI-Elemente:

  • Listen- oder Karten-Anzeige (Designer entscheidet)
  • Quick-Actions pro Eintrag: Status auf done setzen, Priorität ändern, Deadline ändern
  • Such-Funktion (Volltext über Titel + Beschreibung)
  • Filter-Komponenten:
    • Status (Multi-Select)
    • Priorität (Multi-Select)
    • Deadline (Date-Range, Presets: heute / diese Woche / überfällig / kein Datum)
    • Verknüpfungs-Typ (Multi-Select: Contact/Company/Lead/Deal/Project/keine)
    • Quelle (Multi-Select)
  • Toggle „Archivierte anzeigen"
  • Sortierung: Default Deadline aufsteigend, sekundär Priorität, alternativ nach Erstellt-Datum
  • Bulk-Auswahl (Checkboxes pro Zeile + Master-Checkbox)
  • Pagination (Cursor-basiert, „Mehr laden")
  • View-Switcher zwischen Scope-Presets (mine / created_by_me / all wenn berechtigt)

Operationen:

  • Status-Wechsel inline
  • Bulk-Actions: Status ändern, Priorität ändern, Assignee ändern, Archivieren, Löschen
  • Klick auf Eintrag → Detail-View

Performance:

  • Server-side-Filter
  • Default-Limit 50 pro Page

„Projekt-Tasks" / „Deal-Tasks" / „Contact-Tasks" (Embed in Entity-Detail-Views)

Zu zeigende Daten: wie oben, aber Verknüpfungs-Spalte entfällt (impliziert).

Operationen:

  • Anlage einer Task mit Pre-Fill der Verknüpfung
  • Quick-Actions wie in „Meine Tasks"

„Alle Tasks im Tenant"

  • Erfordert tasks.read_all
  • Zusätzliche Spalte: Assignee
  • Zusätzlicher Filter: Assignee (Multi-Select Person/Group)

Block D — Detail-View

/{tenant}/tasks/:id

Zu zeigende Daten:

  • Titel
  • Beschreibung (Markdown gerendert)
  • Status, Priorität, Deadline
  • Assignee (Person oder Group)
  • Verknüpfte Entität (mit Klick-Link auf deren Detail-View)
  • Ersteller + Erstellt-Datum
  • Quelle (manuell / Chat-Nachricht mit Link / Form-Submission mit Link / Automation mit Link auf Automation-Rule)
  • Bei done: Erledigt-Datum + Erledigt-von
  • Watcher-Liste (Phase 1 minimal)
  • Activity-Stream der Task (Status-Wechsel, Assignee-Wechsel, Deadline-Wechsel, Kommentare)

Benötigte UI-Elemente:

  • Anzeige aller Stammdatenfelder mit Inline-Edit-Funktion
  • Markdown-Editor für Beschreibung
  • Date-Picker für Deadline
  • Picker für Assignee (Person- oder Group-Suche, wechselbar)
  • Picker für verknüpfte Entität (Auto-Complete über Contact/Company/Lead/Deal/Project)
  • Status-Wechsler (open → in_progress → done, zurück möglich)
  • Action-Funktionen: Erledigen, Wieder öffnen, Duplizieren, Löschen, Watcher hinzufügen/entfernen
  • Activity-Stream-Komponente (Spec siehe Modul 1, Block E)
  • Kommentar-Funktion (optional in Phase 1 — als reiner Notiz-Activity-Eintrag realisierbar)

Operationen:

  • Stammdaten editieren (Titel, Beschreibung, Priorität, Deadline)
  • Status ändern
  • Assignee wechseln (Person ↔ Group)
  • Verknüpfung anlegen / entfernen / ändern
  • Watcher hinzufügen / entfernen
  • Duplizieren (kopiert Stammdaten, neue Task im Status open)
  • Löschen (Hard-Delete, mit Klartext-Warnung)

Klartext-Hinweise:

  • Deadline überfällig: Banner „Diese Aufgabe ist seit X Tagen überfällig"
  • Assignee deaktiviert: „Zugewiesener Mitarbeiter ist nicht mehr aktiv. Bitte neu zuweisen."
  • Bei done-Wechsel ohne Auto-Archivierung-Hinweis: „Erledigt — wird in 30 Tagen automatisch archiviert"

Block E — Erstellungs-Quellen

E.1 — Manuelle Anlage

Eintritts-Punkte:

  • Sidebar → Aufgaben → „Neue Aufgabe"
  • In Entity-Detail-View (Contact/Company/Lead/Deal/Project) → Action „Aufgabe anlegen" (Pre-Fill linked_entity_*)
  • In Listen-View → Quick-Add-Funktion (nur Titel, Rest später ergänzbar)

Anlage-Modal/-Page:

  • Pflichtfeld: Titel
  • Optionale Felder: Beschreibung, Assignee (Default = aktueller User), Deadline, Priorität (Default normal), Verknüpfung
  • Klartext bei fehlendem Assignee: „Wenn niemand zugewiesen ist, wirst automatisch du als Verantwortlicher eingetragen."

E.2 — Aus Chat-Nachricht („Mark as Task")

  • In Modul 13 (Team-Chat): Kontext-Menü pro Nachricht → „Als Aufgabe markieren"
  • Modal öffnet sich mit Pre-Fill:
    • Titel = erste 80 Zeichen der Chat-Nachricht (editierbar)
    • Beschreibung = volle Chat-Nachricht (editierbar)
    • Verknüpfung = Projekt/Deal/Contact, dem der Chat-Channel zugeordnet ist (falls vorhanden)
    • Assignee = aktueller User (editierbar)
    • source = chat_message, source_ref = { chat_message_id }
  • Activity-Eintrag im Chat: „[User] hat eine Aufgabe aus dieser Nachricht erstellt: [Titel]" mit Link auf Task

E.3 — Aus Form-Submission

  • Form-Action (Modul 5): „Aufgabe erstellen" als konfigurierbare Form-Action
  • Konfiguration im Form-Builder: Assignee (User oder Group), Priorität, Deadline-Berechnung (z.B. „heute + 3 Tage"), Titel-Template (Platzhalter aus Form-Feldern), Beschreibungs-Template, Verknüpfung
  • Bei Submission: Task wird angelegt mit source = form_submission, source_ref = { form_submission_id }
  • Activity-Eintrag bei der Form-Submission

E.4 — Aus Automation-Action

  • Automation-Engine (Modul 17) bietet Action-Typ: „Aufgabe erstellen"
  • Konfigurierbare Parameter analog Form-Action
  • source = automation, source_ref = { automation_rule_id, automation_execution_id }
  • Klartext-Trail in Automation-Logs nach LP-10

Block F — Reminder & Auto-Archivierung

F.1 — Reminder-Notifications (an Modul 22)

Trigger-Zeitpunkte (pro Task mit deadline_at):

  • 24 Stunden vor Deadline (Push + In-App)
  • Bei Deadline (Push + In-App)
  • 24 Stunden nach Deadline, falls noch open/in_progress (Push + In-App + Email als Eskalation)

Empfänger:

  • Bei Person-Zuweisung: Assignee
  • Bei Group-Zuweisung: alle Group-Mitglieder
  • Plus Watcher

Konfigurierbarkeit pro User (Modul 22):

  • Toggle „Task-Erinnerungen erhalten" (Default an)
  • Ruhezeiten respektieren (Standard-Spec aus Modul 22)
  • Anti-Spam-Bündelung: max. 1 Reminder-Notification pro 4h pro User, mehrere Tasks gebündelt

Klartext-Beispiele:

  • Pre-Reminder: „Die Aufgabe ‚Angebot an Schmidt schicken' ist morgen fällig"
  • At-Reminder: „Die Aufgabe ‚Angebot an Schmidt schicken' ist heute fällig"
  • Post-Reminder: „Die Aufgabe ‚Angebot an Schmidt schicken' ist seit 1 Tag überfällig"

F.2 — Auto-Archivierung

  • Cron-Job täglich (z.B. 03:00 Tenant-Zeitzone)
  • Bedingung: status = done AND completed_at <= now() - 30 Tage AND archived_at IS NULL
  • Setzt archived_at = now()
  • Tasks bleiben in DB, sind nur per Filter „Archivierte anzeigen" sichtbar
  • Hard-Delete erst manuell oder nach DSGVO-Workflows (Modul 35)

Klartext bei Übergang zu done:

  • „Aufgabe erledigt — wird in 30 Tagen automatisch archiviert"

Block G — Activity-Stream-Integration

Erzeugte Activity-Typen (Spec aus Modul 1, Block E)

  • task_created — bei Anlage (mit Hinweis auf Quelle)
  • task_assigned — bei Wechsel des Assignee (mit von/zu)
  • task_completed — bei Übergang zu done
  • task_reopened — bei Übergang done → open/in_progress
  • task_deadline_changed — bei Deadline-Update
  • task_priority_changed — bei Priorität-Update
  • task_archived — bei Auto-Archivierung

Verknüpfungen:

  • Activity-subject ist die Task selbst
  • related_entity_refs enthält die verknüpfte Entität (Contact/Deal/Projekt/...)
  • Damit erscheint die Task-Activity automatisch im Stream der verknüpften Entität

Klartext-Summary-Beispiele (DE):

  • „Max Mustermann hat die Aufgabe ‚Angebot an Schmidt schicken' erstellt"
  • „Lisa Müller hat die Aufgabe von Max Mustermann zu sich genommen"
  • „Max Mustermann hat die Aufgabe ‚Angebot an Schmidt schicken' erledigt"
  • „Automation ‚Lead-Eingang' hat eine Aufgabe für Vertrieb-Team erstellt"

Block H — Permissions-Anwendung

Permission-IDs

Permission Erlaubt
tasks.read_own Eigene Tasks sehen (Assignee = self ODER Ersteller = self ODER Watcher = self ODER Group-Mitglied bei Group-Zuweisung)
tasks.read_all Alle Tasks im Tenant sehen
tasks.write Tasks anlegen + bearbeiten (Permissions-aware: nur eigene wenn nur read_own)
tasks.admin Alle Tasks bearbeiten/löschen, Bulk-Operations, Auto-Archivierungs-Settings

Bundle-Mapping (Variante 2)

Bundle Atomare Permissions
tasks.none (keine)
tasks.read_own tasks.read_own
tasks.read_all tasks.read_own + tasks.read_all
tasks.write tasks.read_all + tasks.write
tasks.admin tasks.read_all + tasks.write + tasks.admin

Anwendung in Routes

  • /{tenant}/tasks → tasks.read_own oder tasks.read_all
  • /{tenant}/tasks/new → tasks.write
  • /{tenant}/tasks/:id → tasks.read_own (mit Owner-Check) oder tasks.read_all
  • Embed in Entity-Detail-View → entspricht den Tasks-Permissions zusätzlich zu den Entity-Permissions

Anwendung in Action-Buttons

  • Anlegen: tasks.write
  • Eigene Task bearbeiten: tasks.write
  • Fremde Task bearbeiten (Assignee ≠ self UND Ersteller ≠ self): tasks.write + tasks.read_all ODER tasks.admin
  • Löschen: tasks.admin ODER (tasks.write UND Ersteller = self)
  • Bulk-Operations: tasks.admin

Owner-Check-Logik (für read_own)

User „besitzt" eine Task wenn:

  • assigned_to_user_id = self, ODER
  • User ist Mitglied der zugewiesenen Group (assigned_to_group_id), ODER
  • created_by_user_id = self, ODER
  • User ist Watcher (TaskWatcher)

Klartext-Fehler

  • Zugriff auf nicht-eigene Task mit tasks.read_own: 404 (nicht 403)
  • Edit-Versuch ohne Permission: Action-Buttons werden gar nicht gerendert
  • Bulk-Action ohne tasks.admin: ausgegraut mit Tooltip „Hierfür benötigst du erweiterte Berechtigungen"

Block I — Klartext-Hinweise (zentral)

  • Leere Task-Liste (Default „Meine Tasks"): „Keine offenen Aufgaben — schöne Sache."
  • Leere gefilterte Liste: „Mit den aktuellen Filtern keine Aufgaben gefunden. [Filter zurücksetzen]"
  • Task ohne Verknüpfung: kein Hinweis (legitim)
  • Task mit gelöschter Verknüpfung: „Die verknüpfte [Entität] wurde gelöscht. [Verknüpfung entfernen]"
  • Auto-Archivierungs-Hinweis siehe Block F
  • Reminder-Texte siehe Block F

Phase 2 / spätere Features

  • Task-Templates: wiederverwendbare Task-Definitionen (Titel, Beschreibung, Priorität, Deadline-Offset, Sub-Tasks) — pro Tenant verwaltet, in Anlage-Modal auswählbar
  • Wiederkehrende Tasks (cron): Recurrence-Pattern (täglich/wöchentlich/monatlich/cron-Expression), erzeugt automatisch neue Task-Instanzen
  • Kanban-View: zusätzliche Listen-Ansicht mit Spalten pro Status, Drag-&-Drop für Status-Wechsel
  • Dependencies: Task X blockiert Task Y; Y wird erst sichtbar/aktiv wenn X erledigt
  • Sub-Tasks: Eltern-Kind-Hierarchie mit Auto-Aggregation (Eltern erledigt wenn alle Kinder erledigt)
  • Time-Tracking pro Task: Start/Stop, Summe in Stunden
  • Erweiterte Watcher-Logik: automatische Watcher (z.B. Projektleiter bei Tasks im Projekt)
  • Task-Kommentare als eigene Sub-Entität (statt nur Activity-Notizen)

Architektur-Vorschriften (Querschnitt)

  • AV #5 — Permissions-aware-Default: Listen filtern automatisch nach User-Permissions; bei Realtime-Wechsel des Assignee verschwindet die Task aus der Liste fremder User
  • AV #6 — Audit-Trail-Default: alle Statuswechsel, Assignee-Wechsel, Deadline-Wechsel als Activity geloggt
  • LP-2 — Büro vs. Baustelle: Task-Liste muss in beiden UI-Modi funktionieren; Monteur sieht „Meine Tasks" prominent, Quick-Erledigen-Funktion mobil-optimiert
  • LP-9 — Spec-Tiefe: UI-Anforderungen als Liste, kein Layout
  • LP-10 — Klartext-Diagnostik: alle User-facing Texte fest formuliert (siehe Block I + F)
  • AV #20 — Action-Boundary für KI: KI darf Tasks vorschlagen, nicht direkt anlegen ohne Bestätigung (relevant für Phase-2-KI-Vorschläge)

Detail-Spec-Status: DRAFT

Erste vollständige Detail-Spec für Modul 26. Vor Bau: Verifizierung mit Noah. Bei Implementierung dann konkrete Index-Definitionen, Migrations-SQL, Reminder-Cron-Konfiguration ergänzen.

Offene Detail-Punkte (nicht-blockierend):

  • Konkrete Reminder-Zeitpunkte (24h/0h/+24h) ggf. tenant-konfigurierbar?
  • Auto-Archivierungs-Frist (30 Tage) ggf. tenant-konfigurierbar?
  • Watcher-Logik-Tiefe in Phase 1 (minimal vs. ausgebaut)
  • Subframe-UI-Designs (separat)

Abhängige Module:

  • Modul 13 (Team-Chat) — „Mark as Task"-Funktion
  • Modul 5 (Form-Builder) — Form-Action „Aufgabe erstellen"
  • Modul 17 (Automation-Engine) — Action „Aufgabe erstellen"
  • Modul 22 (Notifications) — Reminder-Versand
  • Modul 1 (CRM) / Modul 3 (Sales) / Modul 4 (Projekte) — Verknüpfungen + Embed-Anzeige