--- kind: wireframe-package project: HiveGrid Screen Project ticket: D-P4 package: WF-P4 Dateien typ: Flow status: Validiert subframe: "" canvas: "WF-P4 Dateien.canvas" --- # WF-P4 Dateien Status: Validiert (Screen-Liste) Subframe-Link: - Canvas: [Canvas]() Stand: 2026-07-08 --- ## 1. Kurzfassung Die Datei-Ablage: Übersicht (Tabelle/Kacheln), Upload mit Warteschlange, Datei-Detail mit Vorschau. Dateien hängen an Kontakten/Projekten/… mit Rollen-Label. Davids Zielbild: „einfacher Google-Drive-Klon" — Teil 1 davon ist v1, Teilen/Freigeben ist v2 (siehe Backlog). --- ## 2. Intent Check | Frage | Antwort | |---|---| | Welches Ticket/Modul ist betroffen? | D-P4 (Teil Dateien), Dev-Pendant AK-P4a | | Was soll der Nutzer am Ende schaffen? | Dateien ablegen, wiederfinden (meine/alle), ansehen, an Datensätze hängen | | Flow, Screen, Zustand oder Doku? | 3 Screens + eingebettete Sektion | | Welche Planning-Quellen wurden geprüft? | `ticket-docs/D-P4.md`, SCREEN-MAP §2, HiveGrid Map | | Was ist sicher im Scope? | Übersicht, Upload, Detail, Tags, Verknüpfungen, Bulk-ZIP, HEIC→JPG | | Was ist sicher nicht im Scope? | **Teilen/Freigeben einzelner Dateien, Ordner, Versionen** (v1 nicht beauftragt — Backlog) | | Admin/Normalrolle-Unterschiede? | Filter/Presets über Verantwortlicher; Rechte via `files.*` | | Unsichere Annahmen? | Wie prominent der Kacheln-Modus als Default ist — Subframe-Bau | --- ## 3. Scope | Punkt | Inhalt | |---|---| | Ticket/Modul | D-P4 · Dateien | | Nutzerrolle | Alle (Maximalansicht Admin) | | Startpunkt | Sidebar »Dateien« | | Ziel | Datei gefunden/abgelegt/angehängt | | Haupt-Archetyp | A2 Liste · A4 Dropzone · A3 Detail | | Bespoke-Anteil | Keiner | | Out of scope | Datei-Freigabe, Ordner, Versionen, Office-/Video-Vorschau, OCR (v2) | --- ## 4. Entscheidungen (validiert 2026-07-08) | Entscheidung | Status | Notiz | |---|---|---| | Drei Frames: Übersicht / Upload-Seite / Detail | genommen | Ticket-treu; Dropzone als wiederverwendbarer Baustein | | Ansicht-Presets **»Meine Dateien« / »Alle Dateien«** | genommen | Davids „meine Ablage" — umgesetzt über den Verantwortlicher-Filter (im Ticket vorhanden), kein neues Datenmodell | | Tabelle/Kacheln-Umschalter | genommen | Ticket-Vorgabe | | **Teilen/Freigeben einzelner Dateien** | **genommen — v1 (Davids Entscheidung 2026-07-08)** | Scope-Erweiterung gegenüber Dev-Ticket (dort v2-Thema) → **Change-Request an Dev nötig** (Datenmodell + Rechte). UI: Screen M01 | | Teilen-Umfang v1: **intern (Personen/Gruppen, ansehen/bearbeiten) + optionaler öffentlicher Link** (kopieren/deaktivieren) | genommen | validiert 2026-07-08 | | Übersicht-Presets: **Meine Dateien / Mit mir geteilt / Alle** | genommen | »Mit mir geteilt« neu dazu (validiert 2026-07-08) | | Ordner-Struktur | Backlog (v2) | v1 arbeitet mit Tags + Filtern + Verknüpfungen statt Ordnern | | HEIC→JPG-Hinweis im Upload | genommen | Pflicht laut Ticket | ### Happy Path 1. Sidebar »Dateien« → Übersicht, Preset »Meine Dateien«. 2. »Hochladen« → Upload-Seite, Dateien reinziehen, Fortschritt je Datei, HEIC-Hinweis. 3. Datei anklicken → Detail mit großer Vorschau, Tags, Verknüpfungen (mit Rolle, z. B. »Angebot«), Notizen. 4. Aus jeder Detailseite: vorgefilterte Datei-Sektion (dokumentiert, Einbau je Feature-Paket). ### Meldungs-/Error-States (validiert) | Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz | |---|---|---|---|---| | Upload einer Datei fehlgeschlagen | Fehlerzeile in der Queue + »erneut versuchen« | nein | Nur dokumentieren | andere Dateien laufen weiter | | Datei vom Virenscan abgelehnt | Fehlerzeile mit Klartext | nein | Nur dokumentieren | »Aus Sicherheitsgründen abgelehnt« (Infra-Vorgabe, fail-closed) | | Vorschau nicht möglich (Dateityp) | Klartext + Download-Knopf | nein | Nur dokumentieren | `not_supported` | | Vorschau fehlgeschlagen | Hinweis + »Vorschau neu erzeugen« | nein | Nur dokumentieren | `failed` | | Leere Übersicht | Leer-Zustand + Hochladen-Knopf | nein | Nur dokumentieren | — | --- ## 7. Validierte Screen-Liste | ID | Screen/Zustand | Typ | Umsetzung | Ort | Status | |---|---|---|---|---|---| | S01 | Datei-Übersicht | Screen | Bauen | `/files` | Validiert | | S02 | Upload (Dropzone + Warteschlange) | Screen | Bauen | `/files/upload` | Validiert | | S03 | Datei-Detail | Screen | Bauen | `/files/:id` | Validiert | | M01 | Datei freigeben | Modal | Bauen | aus S01 (Zeilen-Aktion) + S03 | Validiert | | D01 | Eingebettete Datei-Sektion (vorgefiltert) | Doku | Nur dokumentieren | in Detailseiten | Validiert | | D02–D05 | Fehler-Zustände (s. Tabelle) | Inline | Nur dokumentieren | in S02/S03 | Validiert | --- ## 8. Grid ```text Sidebar -> S01 -> S03 (Datei oeffnen) S01 -> S02 (Hochladen) -> zurueck zu S01 S01/S03 -> M01 (Datei freigeben) Detailseiten: vorgefilterte Sektion (D01) -> S03 ``` --- ## 9. Screen-Pakete - [[S01 Datei-Uebersicht]] - [[S02 Upload]] - [[S03 Datei-Detail]] - [[M01 Datei freigeben]] --- ## 10. Offene Fragen / Backlog - **Change-Request an Dev:** Teilen/Freigeben einzelner Dateien wird v1 (Davids Entscheidung 2026-07-08) — Dev muss Datenmodell/Rechte vorziehen (bisher v2-Thema). Umfang validiert: intern (Personen/Gruppen, ansehen/bearbeiten) + öffentlicher Link. Beim Handoff in `ticket-docs/D-P4.md` »Davids Delta« + als CR formulieren. - **Backlog v2:** Ordner, Versionen - Kacheln oder Tabelle als Default? → Subframe-Bau ## Handoff-Check - [x] Jeder Screen ist mit Umsetzung markiert. - [x] Meldungs-/Error-State-Matrix ist ausgefüllt. - [ ] Subframe-Link ist eingetragen. *(Subframe erst nach explizitem OK)*