6.6 KiB
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/Projekt), 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) · Milestones:- 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: