chore(repo): sync wireframe structure and references

This commit is contained in:
david committed 2026-08-08 03:09:06 +02:00
1 parent 05d2d5777f
commit d953a79e95
453 files changed
+36639 -621

No files matched your search

@@ -0,0 +1,63 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P4
package: WF-P4 Dateien
id: M01
screen: Datei freigeben
typ: Modal
umsetzung: Bauen
status: Validiert
route: "aus S01 (Zeilen-Aktion) und S03"
subframe: ""
---
# M01 — Datei freigeben
## Ziel
Eine Datei gezielt teilen — intern mit Kollegen oder per Link nach außen (z. B. an einen Kunden). **v1-Erweiterung auf Davids Entscheidung (2026-07-08); Change-Request an Dev.**
## Pattern / Archetyp
A5 Dialog (echtes Modal: DialogLayout → Dialog → Dialog.Content).
## Daten
- **Intern freigeben:** Personen-/Gruppen-Picker + Rolle je Eintrag (ansehen / bearbeiten)
- Liste bestehender Freigaben (wer, welche Rolle) mit Entfernen-Knopf
- **Öffentlicher Link:** erzeugen → Link mit Kopier-Knopf · Deaktivieren-Knopf · Klartext-Hinweis »Jeder mit dem Link kann die Datei ansehen«
- Hinweis: Freigaben und Link-Aufrufe werden protokolliert (Audit)
## Aktionen
- Person/Gruppe hinzufügen (mit Rolle) · Rolle ändern · Freigabe entfernen
- Link erzeugen / kopieren / deaktivieren
- Fertig (Änderungen speichern sofort, Toast)
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Link deaktivieren | Kurz-Bestätigung inline | nein | Nur dokumentieren | »Bestehende Link-Empfänger verlieren den Zugriff« |
| Speichern fehlgeschlagen | Toast | nein | Wiederverwenden | Klartext |
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Noch keine Freigaben | Leer-Hinweis im Modal | Nur dokumentieren |
| Laden / Fehler | A7 | Wiederverwenden |
## Permissions / Gates
Freigeben nur, wer die Datei bearbeiten darf; Details klärt der Change-Request mit Dev.
## Subframe
- (erst nach explizitem OK)
## Notizen
- Scope-Erweiterung gegenüber `ticket-docs/D-P4.md` → beim Handoff als Davids Delta + Change-Request formulieren (Datenmodell/Rechte, zieht Teile des v2-Themas vor).
- Ordner + Versionen bleiben v2.
@@ -0,0 +1,56 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P4
package: WF-P4 Dateien
id: S01
screen: Datei-Uebersicht
typ: Liste
umsetzung: Bauen
status: Validiert
route: "/files"
subframe: ""
---
# S01 — Datei-Übersicht
## Ziel
Dateien schnell wiederfinden — meine zuerst, per Filter oder Suche.
## Pattern / Archetyp
A2 Liste mit **Tabelle/Kacheln-Umschalter** (Kacheln mit Thumbnail).
## Daten
- Zeile/Kachel: Vorschau-Thumbnail · Name · Größe · Datum · Tags · verknüpfte Entität · Verantwortlicher
- Presets: **Meine Dateien / Mit mir geteilt / Alle Dateien**
- Filter: Verknüpfung (Entität), Datei-Typ-Gruppe, Tags, Verantwortlicher · Archiviert-Schalter
- Inline-Schnell-Vorschau (Hover/Einzelklick)
## Aktionen
- Datei öffnen → [[S03 Datei-Detail]]
- »Hochladen« → [[S02 Upload]]
- Zeilen-Aktion **»Freigeben«** → [[M01 Datei freigeben]] (geteilte Dateien tragen einen Geteilt-Marker)
- Mehrfach-Auswahl: Tag vergeben · Verknüpfen · Archivieren · **ZIP-Download**
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | »Noch keine Dateien« + Hochladen-Knopf | Nur dokumentieren |
| Laden / Fehler | A7 | Wiederverwenden |
## Permissions / Gates
`files.*` — Aktions-Knöpfe rechte-abhängig.
## Subframe
- (erst nach explizitem OK)
## Notizen
- Kein Ordner-Baum in v1 (Tags + Filter statt Ordner). Teilen/Freigeben ist v1 (M01, Davids Entscheidung + Change-Request an Dev).
@@ -0,0 +1,54 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P4
package: WF-P4 Dateien
id: S02
screen: Upload
typ: Form/Dropzone
umsetzung: Bauen
status: Validiert
route: "/files/upload"
subframe: ""
---
# S02 — Upload
## Ziel
Mehrere Dateien auf einmal hochladen und dabei sehen, was passiert.
## Pattern / Archetyp
A4 mit Datei-Dropzone — die Dropzone ist ein **wiederverwendbarer Baustein** (steckt später auch in Detailseiten, Chat, Abnahme).
## Daten
- Dropzone (Drag&Drop + Datei-Auswahl)
- Warteschlange: je Datei Name · Größe · Fortschrittsbalken · Status (wartet / lädt / fertig / Fehler)
- **HEIC-Hinweis:** »iPhone-Fotos werden automatisch zu JPG konvertiert«
## Aktionen
- Fehlgeschlagene Datei: »erneut versuchen« (andere laufen weiter)
- Fertige Datei: direkt öffnen → [[S03 Datei-Detail]]
- Optional beim Upload: Tags vergeben, an Entität verknüpfen
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Upload fehlgeschlagen | Fehlerzeile + Retry | nein | Nur dokumentieren | — |
| Virenscan-Ablehnung | Fehlerzeile | nein | Nur dokumentieren | »Aus Sicherheitsgründen abgelehnt« |
| Datei zu groß | Inline vor Upload | ja (Datei) | Nur dokumentieren | Limit-Klartext |
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | nur Dropzone sichtbar | — |
| Fehler | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,63 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P4
package: WF-P4 Dateien
id: S03
screen: Datei-Detail
typ: Detail
umsetzung: Bauen
status: Validiert
route: "/files/:id"
subframe: ""
---
# S03 — Datei-Detail
## Ziel
Datei ansehen und einordnen: Wozu gehört sie, wer hat sie angefasst?
## Pattern / Archetyp
A3 Detail mit großer Vorschau-Komponente.
## Daten
- **Vorschau:** Bild mit Zoom / PDF-Viewer (HEIC bereits als JPG) · Fallback bei nicht unterstütztem Typ: Klartext + Download
- Stammdaten (Name, Größe, Typ, Datum, Verantwortlicher) · Tags · Notizen
- Verknüpfte Entitäten **mit Rollen-Label** (z. B. »Angebot« am Projekt)
- Verlauf (Upload, Verknüpfungs-Änderungen, Downloads)
## Aktionen
- Download · Ersetzen · Archivieren
- **»Freigeben«** → [[M01 Datei freigeben]] (zeigt bestehende Freigaben + Link-Status)
- »Vorschau neu erzeugen« (wenn Vorschau fehlgeschlagen)
- Verknüpfung hinzufügen/entfernen (mit Rolle)
## Meldungsentscheidung
| Ereignis | UI-Form | Blockiert? | Umsetzung | Copy/Notiz |
|---|---|---|---|---|
| Vorschau nicht möglich | Klartext + Download | nein | Nur dokumentieren | `not_supported` |
| Vorschau fehlgeschlagen | Hinweis + »neu erzeugen« | nein | Nur dokumentieren | `failed` |
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Vorschau wird erzeugt | Skeleton + »wird vorbereitet« | Nur dokumentieren |
| Laden / Fehler | A7 | Wiederverwenden |
## Permissions / Gates
`files.*`.
## Subframe
- (erst nach explizitem OK)
## Notizen
- Kein Versionsverlauf in v1 (Ersetzen überschreibt) — Versionen sind v2.