132 lines
5.6 KiB
Markdown
132 lines
5.6 KiB
Markdown
---
|
||
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](<WF-P4 Dateien.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)*
|