Track HiveGrid Cloud planning reference

This commit is contained in:
david committed 2026-06-26 20:48:01 +02:00
1 parent b3d5ea6764
commit e341c5938a
5784 files changed
+1104929 -3

No files matched your search

@@ -0,0 +1,58 @@
# 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: