docs(p4): finalize tasks handoff

This commit is contained in:
david committed 2026-08-23 22:02:58 +02:00
1 parent 058d72be72
commit 1eb7765b41
14 files changed
+1346 -239

No files matched your search

@@ -4,128 +4,167 @@ project: HiveGrid Screen Project
ticket: D-P4
package: WF-P4 Aufgaben
typ: Flow
status: Validiert
subframe: ""
status: Fertig / Development-Handoff
subframe: "https://app.subframe.com/f023064a5ca0/flow/192a194e-bb51-4f4c-9f02-7c05d26584e8/edit"
canvas: "WF-P4 Aufgaben.canvas"
source_checked: 2026-08-23
---
# WF-P4 Aufgaben
Status: Validiert (Screen-Liste)
Subframe-Link: -
Canvas: [Canvas](<WF-P4 Aufgaben.canvas>)
Stand: 2026-07-08
Status: **Fertig / Development-Handoff**
---
Subframe: [WF-P16 Aufgaben öffnen](https://app.subframe.com/f023064a5ca0/flow/192a194e-bb51-4f4c-9f02-7c05d26584e8/edit)
## 1. Kurzfassung
Canvas: [WF-P4 Aufgaben.canvas](<WF-P4 Aufgaben.canvas>)
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.**
Stand: 2026-08-23
---
## Abschlussstand
## 2. Intent Check
Subframe ist die Single Source of Truth für den sichtbaren UI-Bestand. Der finale Live-Flow enthält **16 Seiten**:
| 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 |
- 4 Kernseiten: S01, S02, S03 und M01.
- 2 finale V01-Einbettungsvarianten.
- 10 entscheidungsrelevante Interaktionsmodals M02 bis M09 inklusive M02b und M08b.
- Keine eigenen Mobile-, Empty-, Loading-, Error-, Save-, Success- oder Undo-Seiten; ihr verbindlicher Development-Vertrag steht in [[Z01 Zustände und Feedback]].
---
Der Live-Bestand wurde am 2026-08-23 erneut per MCP gelesen. S03, M01 und beide V01-Seiten wurden im Abschlusslauf zusätzlich als Desktop gerendert; M02 und M02b wurden nach der finalen Archivieren-Anpassung ebenfalls gelesen und gerendert.
## 3. Scope
> [!note] Bekannter Namensunterschied
> Der Subframe-Flow heißt weiterhin `WF-P16 Aufgaben`. Das lokale Paket und der Ticket-Handoff heißen `WF-P4 Aufgaben` / `D-P4`. Die Abweichung ist dokumentiert und blockiert das Development-Handoff nicht.
| 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) |
## Vollständiges Subframe-Inventar
---
| # | Familie | Live-Name | UUID | Repo | Subframe |
|---:|---|---|---|---|---|
| 1 | S01 | S01 B3 · Kompakter Statuspunkt | `7dcb65c5-ba2c-490a-ad06-8758e8e6e913` | [MD](<Screens/S01 Aufgaben-Liste.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/7dcb65c5-ba2c-490a-ad06-8758e8e6e913/edit) |
| 2 | S02 | S02 Fullscreen Versuch 4 · Verlauf im Fokus | `b4e91d35-0d28-43d1-941e-e67a7ec3d834` | [MD](<Screens/S02 Aufgaben-Detail.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/b4e91d35-0d28-43d1-941e-e67a7ec3d834/edit) |
| 3 | S03 | S03 | `c7978061-8467-49d9-adf3-614301843bb2` | [MD](<Screens/S03 Aufgaben-Drawer.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/c7978061-8467-49d9-adf3-614301843bb2/edit) |
| 4 | V01 | V01 A · Kompakte Tabelle | `7dd5df56-7cea-445b-91f2-29b9f1fbb407` | [MD](<Screens/V01 Eingebettete Kompakt-Variante.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/7dd5df56-7cea-445b-91f2-29b9f1fbb407/edit) |
| 5 | V01 | V01 Minimal · Sidebar-Liste | `841f9e3f-ca13-4fed-aac6-6977cea19a03` | [MD](<Screens/V01 Eingebettete Kompakt-Variante.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/841f9e3f-ca13-4fed-aac6-6977cea19a03/edit) |
| 6 | M01 | M01 V5 · Inhalt + Planung | `826b6837-a486-42c8-bbe6-d3745528993e` | [MD](<Screens/M01 Aufgabe anlegen.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/826b6837-a486-42c8-bbe6-d3745528993e/edit) |
| 7 | M02 | M02 Aufgabe löschen | `a5d5de83-f8a6-4270-abe3-3e11d3f7bdb3` | [MD](<Screens/M02-M09 Interaktionsmodals.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/a5d5de83-f8a6-4270-abe3-3e11d3f7bdb3/edit) |
| 8 | M02b | M02b Mehrere Aufgaben löschen | `47e17c3e-aef5-449b-b042-1c9898d9f6cd` | [MD](<Screens/M02-M09 Interaktionsmodals.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/47e17c3e-aef5-449b-b042-1c9898d9f6cd/edit) |
| 9 | M04 | M04 Verknüpfung lösen | `c5c91314-ef9b-4434-b574-168b2ee99947` | [MD](<Screens/M02-M09 Interaktionsmodals.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/c5c91314-ef9b-4434-b574-168b2ee99947/edit) |
| 10 | M03 | M03 Verknüpfung hinzufügen | `8020d4ea-9823-400f-b779-dbb78f3cef2e` | [MD](<Screens/M02-M09 Interaktionsmodals.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/8020d4ea-9823-400f-b779-dbb78f3cef2e/edit) |
| 11 | M05 | M05 Änderungen verwerfen | `ae739bed-4f12-47fc-9ea2-e3cfc410abc0` | [MD](<Screens/M02-M09 Interaktionsmodals.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/ae739bed-4f12-47fc-9ea2-e3cfc410abc0/edit) |
| 12 | M06 | M06 Offene Punkte bestätigen | `17e1ded0-3344-49ad-bfeb-698d52f730f6` | [MD](<Screens/M02-M09 Interaktionsmodals.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/17e1ded0-3344-49ad-bfeb-698d52f730f6/edit) |
| 13 | M07 | M07 Notiz hinzufügen | `ac3f4aec-4d41-4d96-af71-f77931e12437` | [MD](<Screens/M02-M09 Interaktionsmodals.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/ac3f4aec-4d41-4d96-af71-f77931e12437/edit) |
| 14 | M08 | M08 Datei hinzufügen | `41a74bd3-2bb1-4429-bd33-2cad30be2621` | [MD](<Screens/M02-M09 Interaktionsmodals.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/41a74bd3-2bb1-4429-bd33-2cad30be2621/edit) |
| 15 | M08b | M08b Anhang entfernen | `35ac0b6b-04d2-4319-af87-66941cd24f1a` | [MD](<Screens/M02-M09 Interaktionsmodals.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/35ac0b6b-04d2-4319-af87-66941cd24f1a/edit) |
| 16 | M09 | M09 Filter-Preset speichern | `4f427f0e-73f6-4c87-956b-26014939afa9` | [MD](<Screens/M02-M09 Interaktionsmodals.md>) | [Öffnen](https://app.subframe.com/f023064a5ca0/design/4f427f0e-73f6-4c87-956b-26014939afa9/edit) |
## 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
## Finaler Hauptfluss
```text
Sidebar -> S01 -> S02
Topbar-Button -> S03 (Drawer) -> S02
S01/S03/Detailseiten -> M01 (Anlegen, vorbefuellt)
V01 = kompakte S01 als Reiter in jeder Detailseite
Sidebar Aufgaben -> S01 -> S02 als route-gebundene Vollansicht
Topbar Meine Aufgaben -> S03 -> S02
S03 -> S01 über Vollansicht
Detail-Reiter -> V01 A oder V01 Minimal -> S02
S01 / S03 / Detailseite / V01 -> M01
global: Verknüpfung leer
Objektkontext: primäre Verknüpfung vorbefüllt
Duplizieren: bestehende Werte als bearbeitbare Kopie vorbefüllt
S01 / S02 / S03 / M01 / V01 -> M02–M09
M02–M09 -> Z01 für ausschließlich dokumentierte Zustände und Rückmeldungen
```
---
Die Kanten beschreiben Produktlogik. Die statischen Subframe-Exporte enthalten keine fertig verdrahtete Navigation oder Business-Handler.
## 9. Screen-Pakete
## Finale Produktentscheidungen
### S01 Aufgaben-Liste
- B3 ist die finale Listenbasis.
- Priorität, Fälligkeit, Verantwortlich, Status und Tags sind inline editierbar; Titel und Verknüpfung bleiben Navigationsziele.
- Bulk-Aktionen: Status, Priorität, Fälligkeit, Zuweisen, Tags und Löschen.
- Überfälligkeit wird über rote Fristen und einen kompakten Direktfilter-Zähler kommuniziert.
- Einzel- und Mehrfachlöschung führen in M02 beziehungsweise M02b; beide bieten als sichere Alternative den blauen Button `Lieber archivieren`.
### S02 Aufgaben-Detail
- Route-gebundenes Vollbild-Modal unter `/tasks/:id`; `Dialog Fullscreen` ist die direkte äußere Komponente.
- Eigenschaften links, Beschreibung/Checkliste, Anhänge, Verknüpfungen und Verlauf rechts.
- Status, Priorität, Fälligkeit/Uhrzeit, Verantwortlich, Tags, Beobachter und Erinnerung sind direkt bearbeitbar.
- `Notiz hinzufügen` sitzt im Kopf des Verlaufs und öffnet M07.
- Pro Verlaufsereignis erscheint genau einmal `Datum · Uhrzeit`.
### S03 Aufgaben-Drawer
- Globaler Schnellzugriff aus der Topbar; 540 px breit.
- Farbige Zeitgruppen, kompakte Accordion-Aufgaben ohne seitlichen Chevron und ohne graue Accordion-Fläche.
- Verknüpfung unter dem Titel; Priorität und Datum rechts untereinander.
- Footer-Aktionen: `Neue Aufgabe` und `Vollansicht`.
### M01 Aufgabe anlegen
- Eine finale Subframe-Seite deckt die datengetriebenen Modi global, Objektkontext und Duplizieren ab.
- Global startet die primäre Verknüpfung leer; im Objektkontext wird sie vorbefüllt.
- Duplizieren befüllt die editierbaren Werte vor, setzt den Status auf `Offen`, öffnet Checklistenpunkte und übernimmt keinen alten Verlauf.
- Modulweit gilt die Bezeichnung `Fälligkeit`.
- Dirty-Close führt zu M05.
### V01 Einbettung
- `V01 A · Kompakte Tabelle` ist die datenreiche Einbettung mit Auswahl, Bulk-Aktionen und Inline-Feldern.
- `V01 Minimal · Sidebar-Liste` ist die reduzierte, nach Fälligkeit gruppierte Einbettung mit aufklappbarem Aufgabentext.
- Beide Varianten werden auf den aktuellen Kontakt, die Organisation, den Lead oder das Projekt vorgefiltert.
### Interaktionsmodals
- M02/M02b: Löschen bestätigen oder über den gleich großen blauen Button `Lieber archivieren` in den Archivieren-Pfad wechseln.
- M03/M04: Verknüpfung hinzufügen beziehungsweise gezielt lösen.
- M05: geänderte M01-Eingaben vor dem Verwerfen schützen.
- M06: Erledigen trotz offener Checklistenpunkte bestätigen.
- M07: Notiz aus dem S02-Verlauf hinzufügen.
- M08/M08b: Datei hinzufügen beziehungsweise nur den Anhang von der Aufgabe lösen.
- M09: persönliches Filter-Preset speichern.
## Globaler Aufgaben-Feldvertrag
| Feld | Verbindliche Regel |
|---|---|
| Titel | bearbeitbar; beim Anlegen die einzige manuell zwingende Eingabe |
| Status | `Offen`, `In Bearbeitung`, `Erledigt`; Standard beim Anlegen `Offen` |
| Verantwortlich | genau eine Person oder Gruppe; nie leer; eigener Nutzer als Standard |
| Fälligkeit | optionales Datum mit optionaler Uhrzeit |
| Priorität | `Niedrig`, `Mittel`, `Hoch`, `Kritisch` |
| Verknüpfungen | optional zu Kontakt, Organisation, Lead oder Projekt; M01 setzt den Primärbezug, S02 verwaltet weitere Bezüge |
| Beschreibung | optional; Markdown und Checkliste |
| Zusammenarbeit | Beobachter, Tags und Erinnerung optional |
| Anhänge | beim Anlegen und später im Detail verfügbar |
| Herkunft | systemseitig `Manuell`, `Chat`, `Formular` oder `Automation`; außer `Manuell` mit Deep Link zur Quelle |
| Systemfelder | Ersteller, Zeiten, Verlauf und Archivlogik automatisch |
## Zustände und Development-Vertrag
Empty-, Loading-, Error-, Permission-, Uploadfortschritts-, Autosave-, Erfolgs-, Toast- und Undo-Zustände sind bewusst keine eigenen Subframe-Seiten. Texte, Recovery-Regeln und QA-Kriterien stehen vollständig in [[Z01 Zustände und Feedback]]. Mobile war nicht Teil der Abnahme.
## Bereinigter Variantenstand
- M01b und M01c sind nicht mehr im finalen Live-Flow. Die Unterschiede werden als Datenmodus derselben M01-Oberfläche umgesetzt.
- Von den parallel entstandenen V01-Zwischenvarianten bleibt A erhalten; zusätzlich ist die finale Minimal-Liste im Flow. B, D und ihre Duplikate sind nicht mehr aktiv.
- Frühere S01-/S02-/S03-/M01-/V01-Varianten bleiben ausschließlich als Entscheidungshistorie in den jeweiligen Screen-Dateien dokumentiert.
## Screen-Dateien
- [[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
- [[M02-M09 Interaktionsmodals]]
- [[Z01 Zustände und Feedback]]
## 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)*
- [x] 16 Live-Seiten aus Subframe gelesen und mit UUIDs/Direktlinks inventarisiert.
- [x] S01, S02, S03, M01 und beide V01-Repräsentationen final dokumentiert.
- [x] Zehn Interaktionsmodals inklusive finaler Archivieren-Alternative dokumentiert.
- [x] M01-Modi ohne zusätzliche Live-Seiten als Development-Vertrag festgehalten.
- [x] Empty/Error/Save/Undo/Upload ausschließlich in Z01 dokumentiert.
- [x] Mobile ausdrücklich aus Scope und Abnahme entfernt.
- [x] Canvas, Tracker, HiveGrid Map und Ticket-Handoff auf den finalen Stand synchronisiert.