# D-P4 · Screens P4 — Files & Tasks | | | |---|---| | **Typ** | Screen (Design) | | **Owner** | David | | **Phase** | P4 — Files & Tasks (bedient `AK-P4a`/`AK-P4b`) | | **Cycle/Fenster** | W2 — Plattform & CRM (Demo 1) · fällig 2026-06-21 (Dev-Fenster 2026-06-18 → 19) · Gate W2 | | **Status** | geplant (NEU — schließt P4-Screen-Lücke) | ## Abhängigkeiten & Parallelität - **Blocked by:** `D-D0a` (App-Shell), `D-D0b` (Archetypen A2 Liste, A3 Detail, A4 Form + Dropzone, A5 Modal, Zustands-Kit) - **Bedient (Dev):** `AK-P4a` (Files — chunked Upload, HEIC→JPG, ClamAV), `AK-P4b` (Tasks + polymorphe EntityLink-Tabelle) - **Liefert wiederverwendbare Komponenten:** Task-Liste + Files-Browser-Sub-Sektion werden ab P12/P14/P16 und in **allen** Entity-Detail-Views (Kontakt/Firma/Lead/Projekt) eingebettet — **einmal bauen, überall einbetten** - **Subframe:** Pflicht je Route (A2 Liste, A3 Detail, A4 Form/Dropzone, A5 Modal) ## Was wir bauen Die **nutzerseitigen Plattform-Primitive**: Files (chunked Upload mit Multi-Datei-Queue, Preview inkl. **HEIC→JPG Pflicht**, Anhängen an jede Entität über `FileEntityLink`, Tags, Archiv, Bulk-ZIP) und Tasks (leichtgewichtiges querliegendes Aufgaben-Modul mit Status/Priorität/Fälligkeit, Entitäts-Verknüpfung, Person-/Gruppen-Zuweisung, Watcher, Quelle-Marker). Die **Task-Liste ist als wiederverwendbare Komponente** zu bauen. ## Benötigte Screens | Screen [Route] | Kern-Inhalt | Archetyp | |---|---|---| | Files-Browser [`/files`] | Tabelle/Grid-Umschalter: Name, Größe, Datum, Tags, verknüpfte Entität, Thumbnail · Filter (Entität, MIME-Gruppe, Tags, Verantwortlicher) · Bulk (Tag/Verknüpfen/Archiv/ZIP) · Inline-Schnell-Vorschau (Hover/Single-Klick) · Archiviert-Toggle (keine Versions-Spalte v1) | A2 | | Upload-View + Datei-Dropzone [`/files/upload`] | Drag&Drop, Multi-Datei-Queue mit Per-Datei-Fortschritt, Fehler+Retry · **HEIC-Hinweis „wird zu JPG konvertiert"** | A4 | | File-Detail [`/files/:id`] | Stammdaten · **Vorschau (Bild mit Zoom / PDF; HEIC→JPG)** mit Fallback-Klartext + Download bei `not_supported` · Tags · Notizen · verknüpfte Entitäten mit Rolle · Activity (Upload/Verknüpfungs-Änderungen/Downloads) · Aktionen Download/Ersetzen/Archiv/„Vorschau neu generieren" bei `failed` (kein Versionsverlauf v1) | A3 | | Task-Liste [`/tasks`] | Titel, Prioritäts-Marker, Fälligkeit (überfällig rot, relativ ≤7 T), verknüpfte Entität, Assignee (Person/Gruppe), Status, Quelle-Hinweis · Presets Meine/Erstellt/Alle (Alle nur mit `tasks.read_all`) · Such-Funktion · Filter (Status/Priorität/Deadline-Range/Verknüpfungs-Typ/Quelle) · Archiviert-Toggle · Bulk · Inline-Quick-Actions (done/Priorität/Deadline) | A2 — **wiederverwendbare Komponente** | | Task-Detail + Anlage-Modal [`/tasks/:id`, `/tasks/new`] | Titel, Beschreibung (Markdown), Status/Priorität/Fälligkeit inline, Assignee-Picker (Person↔Gruppe), Verknüpfungs-Picker (Auto-Complete Contact/Company/Lead/Deal/Project), Watcher, Quelle (manuell/Chat/Form/Automation mit Link), Activity-Stream, Aktionen (Erledigen/Wieder-öffnen/Duplizieren/Löschen) · Klartext-Banner (überfällig / Assignee deaktiviert / „wird in 30 Tagen archiviert") | A3 + A5 | **Eingebettet (kein eigener Screen, aber zu designen):** Files-Browser vorgefiltert als Sub-Sektion in Entity-Detail-Views · Tasks-Tab/Section mit verknüpften Tasks + „Aufgabe anlegen" (Pre-Fill) in jeder Entity-Detail-View. *(FileVersion/Versions-Verlauf, Office-/Video-Previews, Resume-Upload, OCR → v2. HEIC→JPG bleibt v1-Pflicht.)* ## Features (muss abgedeckt sein) - [ ] Multi-Datei-Upload-Queue mit Per-Datei-Progress + Retry (chunked TUS, RLS auf Storage-Pfaden) - [ ] Preview PDF→PNG, Bild→WebP, **HEIC→JPG (Pflicht)** mit Status (pending/generating/ready/failed/not_supported) + Klartext-Fallback - [ ] Datei-Anhängen über `FileEntityLink` (polymorph) + Rollen-Label; Tags; Archiv-Flag; Bulk-ZIP - [ ] Files-Browser server-side-Filter (Entität/MIME-Gruppe/Tags/Verantwortlicher), Tabelle/Grid-Umschalter, Inline-Schnell-Vorschau - [ ] Tasks (Status/Priorität/Fälligkeit, Entitäts-Verknüpfung, Person-ODER-Gruppen-Zuweisung [genau eines], Watcher) - [ ] Task-Quellen-Marker: manuell / Chat / Form-Submission / Automation-Action — je mit Link - [ ] Reminder-Banner-UX (24h vor / bei / 24h nach Deadline) + Auto-Archivierungs-Hinweis (30 Tage) - [ ] Permission-aware Action-Buttons (`tasks.*`); fremde Tasks 404 statt 403 - [ ] Empty/Loading/Permission-Denied/Fehler-States (Klartext, z. B. „Keine offenen Aufgaben — schöne Sache") ## UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand) Daten-Tabelle mit Tabelle/Grid-Umschalter, Vorschau-Thumbnail, sortierbaren Spalten, Filter-Bar (Entität/MIME-Gruppe/Tags/Verantwortlicher), Bulk-Action-Bar (Tag/Verknüpfen/Archiv/ZIP), Archiviert-Toggle, Inline-Schnell-Vorschau; Datei-Dropzone mit Drag&Drop + Multi-Datei-Upload-Queue (Per-Datei-Fortschrittsbalken, Fehler-Zustand + Retry, HEIC→JPG-Klartext-Hinweis); Vorschau-Komponente (Bild-Viewer mit Zoom, PDF-Viewer) mit `not_supported`-Fallback (Klartext + Download) + „Vorschau neu generieren" bei `failed`; File-Detail-Panel (Stammdaten, Tags-Zeile, Notiz-Feld, verknüpfte-Entitäten-Liste mit Rollen-Label, Activity-Timeline, Aktions-Buttons); Task-Liste (wiederverwendbar/embeddable) mit Prioritäts-Marker, Fälligkeits-Anzeige (relativ/absolut, überfällig rot), Quelle-Marker, Scope-Preset-Switcher (Meine/Erstellt/Alle), Such-Feld, Filter (Status/Priorität/Deadline-Range-Presets/Verknüpfungs-Typ/Quelle), Bulk-Auswahl + Bulk-Actions, Inline-Quick-Actions (done/Priorität/Deadline); Task-Detail/-Anlage (Markdown-Editor, Status-Wechsler, Date-Picker, Assignee-Picker Person↔Gruppe umschaltbar, Verknüpfungs-Auto-Complete-Picker, Watcher-Verwaltung, Quelle-Anzeige mit Link, Activity-Stream, Aktions-Buttons mit Klartext-Warnung); Klartext-Banner (überfällig / Assignee deaktiviert / Auto-Archivierungs-Hinweis / gelöschte Verknüpfung); Empty-/Loading-/Permission-Denied-/Fehler-States. ## Quellen (granular) - `designer-briefs/P04-files-tasks.md` (vollständiger Brief — diese Doc ist sein Ticket-Destillat) - `ENTITY-MODEL.md` → **Domäne 3** (File, FileChunk, FileUploadProgress, FileEntityLink, Task, TaskWatcher) - `ROADMAP.md` → Phase 4 · `REQUIREMENTS.md` → Modul 23/26 (`REQ-files-datenmodell`, `-upload-preview`, `-tasks-datenmodell`, `-tasks-reminder-archivierung`) · `PHASE-SOURCES.md` → Phase 4 - `_bmad-output/specs/M23-files.md`, `M26-tasks.md` - Dev-Pendant: `ticket-docs/AK-P4a.md`, `ticket-docs/AK-P4b.md` ## Davids Delta (David füllt aus) - [ ] Überschriebene/geänderte Spec-Punkte: - [ ] Neue UI/UX-Entscheidungen: - [ ] Subframe-Screen-Link(s): - [ ] Offene Fragen an Dev: