Plan Querschnitt-Pakete P3-P5 und Infrastruktur-Entscheidungen

- Feature Map: Regelwerk, Kanten-System, Paket-Canvas-Verknuepfungen, MD-Links
- Infrastruktur & Navigation: Sidebar-Abgleich, Einstellungen-Modell, Mobile, Gating
- WF-P3 Benachrichtigungen + Audit Log (validiert)
- WF-P4 Aufgaben (inkl. Topbar-Drawer-Delta) + Dateien (inkl. Teilen v1, CR an Dev)
- WF-P5 Integrationen (Sync-Verlauf als eigene Seiten)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
davidandClaude Fable 5 committed 2026-07-08 20:47:46 +02:00
1 parent 1363933387
commit e48a5a46e8
38 files changed
+3147 -732

No files matched your search

@@ -0,0 +1,45 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P4
package: WF-P4 Aufgaben
id: M01
screen: Aufgabe anlegen
typ: Modal
umsetzung: Bauen
status: Validiert
route: "aus S01/S03/Detailseiten"
subframe: ""
---
# M01 — Aufgabe anlegen
## Ziel
Aufgabe in Sekunden anlegen — aus der Liste, dem Drawer oder direkt aus einer Detailseite (dann vorbefüllt).
## Pattern / Archetyp
A5 Dialog (echtes Modal: DialogLayout → Dialog → Dialog.Content).
## Daten
- Titel (Pflicht) · Beschreibung (Markdown) · Priorität · Frist (Date-Picker)
- Zuständig: Person ↔ Gruppe · Verknüpfung (Auto-Complete) · Beobachter
- Aus Detailseite geöffnet: Verknüpfung vorbefüllt
## Aktionen
- »Anlegen« → Toast + Aufgabe erscheint in Liste/Drawer
- Abbrechen
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Titel fehlt | Inline-Validierung | Nur dokumentieren |
| Speichern fehlgeschlagen | Toast mit Klartext | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,52 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P4
package: WF-P4 Aufgaben
id: S01
screen: Aufgaben-Liste
typ: Liste
umsetzung: Bauen
status: Validiert
route: "/tasks"
subframe: ""
---
# S01 — Aufgaben-Liste
## Ziel
Alle Aufgaben im Griff: meine zuerst, überfällige sofort sichtbar, schnell abhaken.
## Pattern / Archetyp
A2 Liste — **wiederverwendbare Komponente** (Kompakt-Variante: [[V01 Eingebettete Kompakt-Variante]]).
## Daten
- Zeile: Titel · Prioritäts-Marker · Frist (relativ ≤ 7 Tage, überfällig rot) · verknüpfte Entität · Zuständig (Person/Gruppe) · Status · Herkunfts-Marker (manuell/Chat/Formular/Automation)
- Presets: **Meine / Von mir erstellt / Alle** (»Alle« nur mit `tasks.read_all`)
- Suche · Filter: Status, Priorität, Frist-Zeitraum, Verknüpfungs-Typ, Herkunft · Archiviert-Schalter
## Aktionen
- Zeile öffnen → [[S02 Aufgaben-Detail]]
- Schnell-Aktionen in der Zeile: erledigt · Priorität · Frist
- Mehrfach-Auswahl + Bulk-Aktionen
- »Neue Aufgabe« → [[M01 Aufgabe anlegen]]
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | »Keine offenen Aufgaben — schöne Sache« | Nur dokumentieren |
| Laden | Skeleton (A7) | Wiederverwenden |
| Fehler | A7-Fehlerzustand | Wiederverwenden |
## Permissions / Gates
`tasks.*` — Aktions-Knöpfe rechte-abhängig; Preset »Alle« gegated.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,54 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P4
package: WF-P4 Aufgaben
id: S02
screen: Aufgaben-Detail
typ: Detail
umsetzung: Bauen
status: Validiert
route: "/tasks/:id"
subframe: ""
---
# S02 — Aufgaben-Detail
## Ziel
Eine Aufgabe komplett verstehen und direkt bearbeiten.
## Pattern / Archetyp
A3 Detail.
## Daten
- Titel · Beschreibung (Markdown) · Status/Priorität/Frist direkt änderbar
- Zuständig: Umschalter **Person ↔ Gruppe** (genau eines)
- Verknüpfung (Auto-Complete: Kontakt/Organisation/Lead/Projekt) · Beobachter
- Herkunft mit Link zur Quelle (Chat-Nachricht, Formular, Automation)
- Verlauf (Activity-Stream)
## Aktionen
- Erledigen / Wieder öffnen · Duplizieren · Löschen (mit Klartext-Warnung)
## Banner / Hinweise
- Überfällig · Zuständiger deaktiviert (+ »neu zuweisen«) · »wird in 30 Tagen archiviert« · Verknüpfung gelöscht
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Nicht gefunden | 404 auch bei fehlendem Recht (Dev-Vorgabe) | Wiederverwenden |
| Laden / Fehler | A7 | Wiederverwenden |
## Permissions / Gates
Aktions-Knöpfe rechte-abhängig; fremde Aufgaben → 404.
## Subframe
- (erst nach explizitem OK)
@@ -0,0 +1,55 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P4
package: WF-P4 Aufgaben
id: S03
screen: Aufgaben-Drawer
typ: Drawer
umsetzung: Bauen
status: Validiert
route: "Topbar, global"
subframe: ""
---
# S03 — Aufgaben-Drawer
## Ziel
Schnellzugriff auf die eigenen Aufgaben von überall — ohne die aktuelle Seite zu verlassen. **Davids Ergänzung über das Ticket hinaus (Delta).**
## Pattern / Archetyp
Drawer rechts, geöffnet über einen Topbar-Button (analog Glocken-Drawer aus WF-P3 — gleiches Drawer-Muster).
## Daten
- Meine offenen Aufgaben, überfällige oben (rot)
- Zeile kompakt: Titel · Frist · Prioritäts-Marker · verknüpfte Entität
## Aktionen
- Tipp auf Eintrag → [[S02 Aufgaben-Detail]]
- Erledigt-Haken direkt in der Zeile
- »Neue Aufgabe« → [[M01 Aufgabe anlegen]]
- »Alle Aufgaben« → [[S01 Aufgaben-Liste]]
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | »Keine offenen Aufgaben — schöne Sache« | Nur dokumentieren |
| Laden / Fehler | A7 | Wiederverwenden |
## Permissions / Gates
Keine — zeigt nur eigene Aufgaben.
## Subframe
- (erst nach explizitem OK)
## Notizen
- Offen: Zähler-Badge am Topbar-Button (offene/überfällige)? → Subframe-Bau
- Delta in `ticket-docs/D-P4.md` (»Davids Delta«) beim Handoff nachtragen
@@ -0,0 +1,48 @@
---
kind: screen
project: HiveGrid Screen Project
ticket: D-P4
package: WF-P4 Aufgaben
id: V01
screen: Eingebettete Kompakt-Variante
typ: Variante (wiederverwendbar)
umsetzung: Bauen
status: Validiert
route: "Reiter in jeder Detailseite"
subframe: ""
---
# V01 — Eingebettete Kompakt-Variante
## Ziel
Der Aufgaben-Reiter, der später in **jeder** Detailseite steckt (Kontakt, Organisation, Lead, Projekt) — vorgefiltert auf das Objekt. **Das Einbett-Muster für alle Features.**
## Pattern / Archetyp
Kompakte Ausführung von [[S01 Aufgaben-Liste]]: weniger Spalten, keine Presets (immer objektbezogen), gleiche Zeilen-Optik.
## Daten
- Aufgaben des Objekts: Titel · Frist · Prioritäts-Marker · Zuständig · Status
## Aktionen
- »Aufgabe anlegen« → [[M01 Aufgabe anlegen]] (Verknüpfung vorbefüllt)
- Zeile öffnen → [[S02 Aufgaben-Detail]]
- Erledigt-Haken in der Zeile
## Zustände
| Zustand | Beschreibung | Umsetzung |
|---|---|---|
| Leer | »Noch keine Aufgaben zu diesem Eintrag« + Anlegen-Knopf | Nur dokumentieren |
| Laden / Fehler | A7 | Wiederverwenden |
## Subframe
- (erst nach explizitem OK)
## Notizen
- Wird von den Feature-Paketen (D-CRM, D-P8 …) referenziert, nicht neu gebaut.
@@ -0,0 +1,178 @@
{
"nodes": [
{
"id": "group-main",
"type": "group",
"x": -80,
"y": -100,
"width": 1840,
"height": 420,
"label": "Hauptflow"
},
{
"id": "group-schnell",
"type": "group",
"x": -80,
"y": 460,
"width": 1000,
"height": 400,
"label": "Schnellzugriff (Davids Delta)"
},
{
"id": "group-anlage",
"type": "group",
"x": 1060,
"y": 460,
"width": 1240,
"height": 400,
"label": "Anlegen und Einbettung"
},
{
"id": "note-entry",
"type": "text",
"text": "# Einstieg\n\nSidebar → Aufgaben (`/tasks`).",
"x": 0,
"y": 0,
"width": 360,
"height": 200
},
{
"id": "s01",
"type": "file",
"file": "02 Wireframes/P4 Aufgaben und Dateien/WF-P4 Aufgaben/Screens/S01 Aufgaben-Liste.md",
"x": 560,
"y": 0,
"width": 420,
"height": 200
},
{
"id": "s02",
"type": "file",
"file": "02 Wireframes/P4 Aufgaben und Dateien/WF-P4 Aufgaben/Screens/S02 Aufgaben-Detail.md",
"x": 1240,
"y": 0,
"width": 420,
"height": 200
},
{
"id": "note-topbar",
"type": "text",
"text": "# Einstieg\n\nTopbar-Button »Meine Aufgaben« (Davids Ergänzung).",
"x": 0,
"y": 560,
"width": 320,
"height": 200
},
{
"id": "s03",
"type": "file",
"file": "02 Wireframes/P4 Aufgaben und Dateien/WF-P4 Aufgaben/Screens/S03 Aufgaben-Drawer.md",
"x": 440,
"y": 560,
"width": 420,
"height": 200
},
{
"id": "m01",
"type": "file",
"file": "02 Wireframes/P4 Aufgaben und Dateien/WF-P4 Aufgaben/Screens/M01 Aufgabe anlegen.md",
"x": 1120,
"y": 560,
"width": 420,
"height": 200
},
{
"id": "v01",
"type": "file",
"file": "02 Wireframes/P4 Aufgaben und Dateien/WF-P4 Aufgaben/Screens/V01 Eingebettete Kompakt-Variante.md",
"x": 1600,
"y": 560,
"width": 420,
"height": 200
},
{
"id": "md-paket",
"type": "file",
"file": "02 Wireframes/P4 Aufgaben und Dateien/WF-P4 Aufgaben/WF-P4 Aufgaben.md",
"x": -80,
"y": -440,
"width": 460,
"height": 280
}
],
"edges": [
{
"id": "e-entry",
"fromNode": "note-entry",
"fromSide": "right",
"toNode": "s01",
"toSide": "left",
"toEnd": "arrow",
"styleAttributes": {
"path": "dotted",
"pathfindingMethod": "direct"
}
},
{
"id": "e-open",
"fromNode": "s01",
"fromSide": "right",
"toNode": "s02",
"toSide": "left",
"toEnd": "arrow",
"label": "Zeile öffnen",
"styleAttributes": {
"pathfindingMethod": "direct"
}
},
{
"id": "e-topbar",
"fromNode": "note-topbar",
"fromSide": "right",
"toNode": "s03",
"toSide": "left",
"toEnd": "arrow",
"styleAttributes": {
"path": "dotted",
"pathfindingMethod": "direct"
}
},
{
"id": "e-drawer",
"fromNode": "s03",
"fromSide": "top",
"toNode": "s02",
"toSide": "bottom",
"toEnd": "arrow",
"label": "Eintrag öffnen",
"styleAttributes": {
"pathfindingMethod": "direct"
}
},
{
"id": "e-new",
"fromNode": "s01",
"fromSide": "bottom",
"toNode": "m01",
"toSide": "top",
"toEnd": "arrow",
"label": "Neue Aufgabe (auch aus S03 + Detailseiten, vorbefüllt)",
"styleAttributes": {
"pathfindingMethod": "direct"
}
},
{
"id": "e-variant",
"fromNode": "v01",
"fromSide": "top",
"toNode": "s01",
"toSide": "bottom",
"toEnd": "arrow",
"label": "kompakte Ausführung von S01",
"styleAttributes": {
"path": "short-dashed",
"pathfindingMethod": "direct"
}
}
]
}
@@ -0,0 +1,131 @@
---
kind: wireframe-package
project: HiveGrid Screen Project
ticket: D-P4
package: WF-P4 Aufgaben
typ: Flow
status: Validiert
subframe: ""
canvas: "WF-P4 Aufgaben.canvas"
---
# WF-P4 Aufgaben
Status: Validiert (Screen-Liste)
Subframe-Link: -
Canvas: [Canvas](<WF-P4 Aufgaben.canvas>)
Stand: 2026-07-08
---
## 1. Kurzfassung
Das Aufgaben-Modul: Liste, Detail, Anlegen-Modal, Topbar-Drawer für den Schnellzugriff und die eingebettete Kompakt-Variante, die später in jeder Detailseite (Kontakt, Projekt, …) steckt. **Einmal bauen, überall einbetten.**
---
## 2. Intent Check
| Frage | Antwort |
|---|---|
| Welches Ticket/Modul ist betroffen? | D-P4 (Teil Aufgaben), Dev-Pendant AK-P4b |
| Was soll der Nutzer am Ende schaffen? | Aufgaben sehen (meine zuerst), schnell anlegen, abhaken, nichts verpassen (Fristen) |
| Flow, Screen, Zustand oder Doku? | Screens + Modal + Drawer + wiederverwendbare Kompakt-Variante |
| Welche Planning-Quellen wurden geprüft? | `ticket-docs/D-P4.md`, SCREEN-MAP §2, HiveGrid Map |
| Was ist sicher im Scope? | Liste, Detail, Anlegen, Drawer, Kompakt-Variante, Banner-Zustände |
| Was ist sicher nicht im Scope? | Unteraufgaben, Boards für Aufgaben, wiederkehrende Aufgaben (nicht im Ticket) |
| Admin/Normalrolle-Unterschiede? | Preset »Alle« nur mit Recht `tasks.read_all`; fremde Aufgaben → 404 |
| Unsichere Annahmen? | Feinverhalten Drawer (z. B. Anzahl-Badge am Topbar-Button) — beim Subframe-Bau |
---
## 3. Scope
| Punkt | Inhalt |
|---|---|
| Ticket/Modul | D-P4 · Aufgaben |
| Nutzerrolle | Alle (Maximalansicht Admin) |
| Startpunkt | Sidebar »Aufgaben« oder Topbar-Button |
| Ziel | Aufgabe angelegt / erledigt / gefunden |
| Haupt-Archetyp | A2 Liste · A3 Detail · A5 Modal |
| Bespoke-Anteil | Keiner |
| Out of scope | Wiederkehrende Aufgaben, Unteraufgaben (nicht beauftragt) |
---
## 4. Entscheidungen (validiert 2026-07-08)
| Entscheidung | Status | Notiz |
|---|---|---|
| Detail als eigene Seite, Anlegen als Modal (vorbefüllbar) | genommen | Ticket-treu |
| Eingebettete Kompakt-Variante als eigener Frame (V01) | genommen | Einbett-Muster steht, bevor D-CRM es braucht |
| **Topbar-Button »Meine Aufgaben« + Aufgaben-Drawer rechts** | genommen | **Davids Ergänzung (Delta über Ticket hinaus)** — Schnellzugriff analog Glocken-Drawer; in »Davids Delta« der Ticket-Doc nachtragen |
| Zuweisung an Person ODER Gruppe (genau eines) | genommen | Ticket-Vorgabe, Umschalter im Picker |
| Herkunfts-Marker (manuell/Chat/Formular/Automation) mit Link | genommen | Ticket-Vorgabe |
| Banner nur dokumentieren | genommen | überfällig / Zuständiger deaktiviert / 30-Tage-Archiv / Verknüpfung gelöscht |
### Happy Path
1. Sidebar »Aufgaben« → Liste, Preset »Meine«, überfällige rot oben.
2. Schnell-Aktionen direkt in der Zeile: erledigt, Priorität, Frist.
3. »Neue Aufgabe« → Modal (aus einer Detailseite geöffnet: Verknüpfung vorbefüllt).
4. Zwischendurch überall: Topbar-Button → Drawer rechts mit meinen offenen Aufgaben, Tipp auf Eintrag → Detail.
### Meldungs-/Error-States (validiert)
| Ereignis | UI-Form | Blockiert? | Bauen? | Copy/Notiz |
|---|---|---|---|---|
| Fremde Aufgabe aufgerufen | 404 »nicht gefunden« | ja | Wiederverwenden | bewusst nicht »verboten« (Dev-Vorgabe) |
| Zuständiger deaktiviert | Banner + »neu zuweisen« | nein | Nur dokumentieren | im Detail |
| Überfällig | Banner/rote Frist | nein | Nur dokumentieren | Liste + Detail |
| Wird in 30 Tagen archiviert | Banner | nein | Nur dokumentieren | erledigte Aufgaben |
| Verknüpfung gelöscht | Banner | nein | Nur dokumentieren | »Verknüpftes Objekt existiert nicht mehr« |
| Leere Liste | Leer-Zustand | nein | Nur dokumentieren | »Keine offenen Aufgaben — schöne Sache« |
---
## 7. Validierte Screen-Liste
| ID | Screen/Zustand | Typ | Umsetzung | Ort | Status |
|---|---|---|---|---|---|
| S01 | Aufgaben-Liste | Screen | Bauen | `/tasks` | Validiert |
| S02 | Aufgaben-Detail | Screen | Bauen | `/tasks/:id` | Validiert |
| S03 | Aufgaben-Drawer (Topbar) | Drawer | Bauen | Topbar, global | Validiert |
| M01 | Aufgabe anlegen | Modal | Bauen | aus S01/S03/Detailseiten | Validiert |
| V01 | Eingebettete Kompakt-Variante | Variante | Bauen | Reiter in Detailseiten | Validiert |
| D01–D05 | Banner-Zustände (s. Tabelle oben) | Banner/Inline | Nur dokumentieren | in S01/S02 | Validiert |
---
## 8. Grid
```text
Sidebar -> S01 -> S02
Topbar-Button -> S03 (Drawer) -> S02
S01/S03/Detailseiten -> M01 (Anlegen, vorbefuellt)
V01 = kompakte S01 als Reiter in jeder Detailseite
```
---
## 9. Screen-Pakete
- [[S01 Aufgaben-Liste]]
- [[S02 Aufgaben-Detail]]
- [[S03 Aufgaben-Drawer]]
- [[M01 Aufgabe anlegen]]
- [[V01 Eingebettete Kompakt-Variante]]
---
## 10. Offene Fragen
- Topbar-Button: mit Zähler-Badge (offene/überfällige)? → beim Subframe-Bau
- Drawer-Umfang: nur »Meine offen« oder mit Tabs? → beim Subframe-Bau schlank starten
- Davids Delta (Topbar-Button + Drawer) in `ticket-docs/D-P4.md` »Davids Delta« nachtragen → beim Handoff
## 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)*
@@ -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,166 @@
{
"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 Aufgaben und 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 Aufgaben und 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 Aufgaben und 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 Aufgaben und Dateien/WF-P4 Dateien/WF-P4 Dateien.md",
"x": -80,
"y": -440,
"width": 460,
"height": 280
},
{
"id": "m01",
"type": "file",
"file": "02 Wireframes/P4 Aufgaben und 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",
"pathfindingMethod": "direct"
}
},
{
"id": "e-open",
"fromNode": "s01",
"fromSide": "right",
"toNode": "s03",
"toSide": "left",
"toEnd": "arrow",
"label": "Datei öffnen",
"styleAttributes": {
"pathfindingMethod": "direct"
}
},
{
"id": "e-upload",
"fromNode": "s01",
"fromSide": "bottom",
"toNode": "s02",
"toSide": "top",
"toEnd": "arrow",
"label": "Hochladen",
"styleAttributes": {
"pathfindingMethod": "direct"
}
},
{
"id": "e-done",
"fromNode": "s02",
"fromSide": "right",
"toNode": "s03",
"toSide": "bottom",
"toEnd": "arrow",
"label": "fertige Datei öffnen",
"styleAttributes": {
"path": "long-dashed",
"pathfindingMethod": "direct"
}
},
{
"id": "e-share",
"fromNode": "s01",
"fromSide": "bottom",
"toNode": "m01",
"toSide": "top",
"toEnd": "arrow",
"label": "Freigeben (auch aus S03)",
"styleAttributes": {
"pathfindingMethod": "direct"
}
}
]
}
@@ -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)*