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.
@@ -0,0 +1,155 @@
{
"nodes": [
{
"id": "group-main",
"type": "group",
"x": -80,
"y": -100,
"width": 1840,
"height": 420,
"label": "Hauptflow"
},
{
"id": "group-upload",
"type": "group",
"x": -80,
"y": 460,
"width": 1040,
"height": 400,
"label": "Upload und Freigeben"
},
{
"id": "group-notes",
"type": "group",
"x": 1060,
"y": 460,
"width": 1240,
"height": 400,
"label": "Regeln und Backlog"
},
{
"id": "note-entry",
"type": "text",
"text": "# Einstieg\n\nSidebar → Dateien (`/files`).\n\nPresets: Meine Dateien / Alle Dateien.",
"x": 0,
"y": 0,
"width": 360,
"height": 200
},
{
"id": "s01",
"type": "file",
"file": "02 Wireframes/P4 Dateien/WF-P4 Dateien/Screens/S01 Datei-Uebersicht.md",
"x": 560,
"y": 0,
"width": 420,
"height": 200
},
{
"id": "s03",
"type": "file",
"file": "02 Wireframes/P4 Dateien/WF-P4 Dateien/Screens/S03 Datei-Detail.md",
"x": 1240,
"y": 0,
"width": 420,
"height": 200
},
{
"id": "s02",
"type": "file",
"file": "02 Wireframes/P4 Dateien/WF-P4 Dateien/Screens/S02 Upload.md",
"x": 0,
"y": 560,
"width": 420,
"height": 200
},
{
"id": "note-backlog",
"type": "text",
"text": "# Scope-Update (2026-07-08)\n\n**Teilen/Freigeben = v1** (Davids Entscheidung, validiert): intern an Personen/Gruppen (ansehen/bearbeiten) + öffentlicher Link. Übersicht-Preset »Mit mir geteilt«. → Change-Request an Dev.\n\n**Backlog v2:** Ordner, Versionen. v1: Tags + Filter statt Ordner.",
"x": 1120,
"y": 560,
"width": 540,
"height": 260
},
{
"id": "note-embed",
"type": "text",
"text": "# Einbettung (nur Doku)\n\nVorgefilterte Datei-Sektion in jeder Detailseite — Einbau passiert je Feature-Paket (D-CRM, D-P8 …).",
"x": 1720,
"y": 560,
"width": 420,
"height": 260
},
{
"id": "md-paket",
"type": "file",
"file": "02 Wireframes/P4 Dateien/WF-P4 Dateien/WF-P4 Dateien.md",
"x": -80,
"y": -440,
"width": 460,
"height": 280
},
{
"id": "m01",
"type": "file",
"file": "02 Wireframes/P4 Dateien/WF-P4 Dateien/Screens/M01 Datei freigeben.md",
"x": 480,
"y": 560,
"width": 420,
"height": 200
}
],
"edges": [
{
"id": "e-entry",
"fromNode": "note-entry",
"fromSide": "right",
"toNode": "s01",
"toSide": "left",
"toEnd": "arrow",
"styleAttributes": {
"path": "dotted"
}
},
{
"id": "e-open",
"fromNode": "s01",
"fromSide": "right",
"toNode": "s03",
"toSide": "left",
"toEnd": "arrow",
"label": "Datei öffnen"
},
{
"id": "e-upload",
"fromNode": "s01",
"fromSide": "bottom",
"toNode": "s02",
"toSide": "top",
"toEnd": "arrow",
"label": "Hochladen"
},
{
"id": "e-done",
"fromNode": "s02",
"fromSide": "right",
"toNode": "s03",
"toSide": "bottom",
"toEnd": "arrow",
"label": "fertige Datei öffnen",
"styleAttributes": {
"path": "long-dashed"
}
},
{
"id": "e-share",
"fromNode": "s01",
"fromSide": "bottom",
"toNode": "m01",
"toSide": "top",
"toEnd": "arrow",
"label": "Freigeben (auch aus S03)"
}
]
}
@@ -0,0 +1,131 @@
---
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)*