17 KiB
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 |
|
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_idtitle(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, Defaultnormal)status(Enum:open | in_progress | done, Defaultopen)completed_at(Timestamp, gesetzt bei Übergang zudone)completed_by_user_id(FK auf User, gesetzt bei Übergang zudone)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_idoderassigned_to_group_idgesetzt — nicht beides, nicht keines (Tasks ohne Zuweisung sind nicht erlaubt; bei Anlage Default = Ersteller) completed_atundcompleted_by_user_idnur gesetzt wennstatus = done- Bei Wechsel
done → open/in_progress:completed_atundcompleted_by_user_idwerden 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 mittasks.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
donesetzen, 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 = doneANDcompleted_at <= now() - 30 TageANDarchived_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 zudonetask_reopened— bei Übergangdone → open/in_progresstask_deadline_changed— bei Deadline-Updatetask_priority_changed— bei Priorität-Updatetask_archived— bei Auto-Archivierung
Verknüpfungen:
- Activity-
subjectist die Task selbst related_entity_refsenthä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_ownodertasks.read_all/{tenant}/tasks/new→tasks.write/{tenant}/tasks/:id→tasks.read_own(mit Owner-Check) odertasks.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_allODERtasks.admin - Löschen:
tasks.adminODER (tasks.writeUND 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