Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/D-P4.md
T

6.7 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/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: