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

@@ -7,42 +7,101 @@ id: V01
screen: Eingebettete Kompakt-Variante
typ: Variante (wiederverwendbar)
umsetzung: Bauen
status: Validiert
status: Fertig / Development-Handoff
route: "Reiter in jeder Detailseite"
subframe: ""
subframe: "https://app.subframe.com/f023064a5ca0/flow/192a194e-bb51-4f4c-9f02-7c05d26584e8/edit"
source_checked: 2026-08-23
---
# V01 — Eingebettete Kompakt-Variante
## Ziel
> [!success] Finaler Subframe-Bestand
> V01 besitzt zwei finale Repräsentationen: [A · Kompakte Tabelle](https://app.subframe.com/f023064a5ca0/design/7dd5df56-7cea-445b-91f2-29b9f1fbb407/edit) (`7dd5df56-7cea-445b-91f2-29b9f1fbb407`) und [Minimal · Sidebar-Liste](https://app.subframe.com/f023064a5ca0/design/841f9e3f-ca13-4fed-aac6-6977cea19a03/edit) (`841f9e3f-ca13-4fed-aac6-6977cea19a03`). Beide wurden im Abschlusslauf als Desktop gerendert.
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.**
## Finale Varianten
## 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 |
| Seite | Einsatz | Kerneigenschaften |
|---|---|---|
| Leer | »Noch keine Aufgaben zu diesem Eintrag« + Anlegen-Knopf | Nur dokumentieren |
| Laden / Fehler | A7 | Wiederverwenden |
| V01 A · Kompakte Tabelle | breite Detail-Reiter und datenreiche Einbettungen | Auswahl, Bulk-Leiste, Inline-Priorität/Fälligkeit/Verantwortlich/Status/Tags, Zeilenmenü |
| V01 Minimal · Sidebar-Liste | reduzierte Einbettungen mit geringerem Informationsbedarf | Gruppen Überfällig/Heute/Diese Woche/Erledigt, kompakte Accordion-Zeilen, aufklappbarer Aufgabentext, Priorität und Datum rechts |
## Subframe
Beide Varianten sind auf das aktuelle Objekt vorgefiltert. Empty/Error/Feedback bleibt auch für V01 ausschließlich in [[Z01 Zustände und Feedback]].
- (erst nach explizitem OK)
## Ziel und validierte Planung
## Notizen
> [!note] Globaler Vertrag
> Feldbedeutung und Bearbeitungsregeln folgen verbindlich [[WF-P4 Aufgaben#Globaler Aufgaben-Feldvertrag · kanonische Quelle]]. V01 zeigt davon eine objektbezogene Teilmenge.
- Wird von den Feature-Paketen (D-CRM, D-P8 …) referenziert, nicht neu gebaut.
Der Aufgaben-Reiter, der in Kontakt-, Organisations-, Lead- und Projekt-Details wiederverwendet wird — immer auf das aktuelle Objekt vorgefiltert.
- Kompakte Ausführung von [[S01 Aufgaben-Liste]], ohne globale Presets.
- Zeile: Titel, Frist, Priorität, Zuständig und Status.
- Aufgabe anlegen → [[M01 Aufgabe anlegen]] mit vorbefüllter Verknüpfung.
- Zeile öffnen → [[S02 Aufgaben-Detail]]; Haken → erledigt/wieder öffnen.
- Empty: »Noch keine Aufgaben zu diesem Eintrag« + Anlegen; Loading/Error über A7.
## Historischer Subframe-Bestand vor den finalen Varianten
### V1 — Einbettung im vollständigen Projektkontext
UUID: `601d0110-9828-4eaa-8223-f36c2ce9acc4` · Datei: `V01EingebetteteAufgabenV1.tsx` · 876 Zeilen
![Subframe-Screenshot V1](https://egniatlvhajtqurt.public.blob.vercel-storage.com/prod/39410/screenshots/601d0110-9828-4eaa-8223-f36c2ce9acc4-1787355959112.png)
Sichtbar:
- Vollständiger Projektkopf `PV + Speicher Familie Wagner`, Projekt-ID, Status, Wert und Verantwortlicher.
- Tabs Details, Aufgaben, Aktivität und Dokumente; Aufgaben ist aktiv.
- Kopf `7 Aufgaben` und »Aufgabe hinzufügen«.
- Tabelle mit Aufgabe, Priorität, Fälligkeit, Verantwortlich, Status und Zeilenaktionen.
- Sieben Aufgaben; zwei überfällig, eine erledigt; Statuswerte Offen, In Bearbeitung und Erledigt.
- Direkter Haken und Mehr-Menü mit Detail öffnen, Bearbeiten, Fälligkeit ändern, Zuweisen, Löschen bzw. Wieder öffnen.
- `emptyText="Keine Aufgaben vorhanden"` ist im Table-Prop vorhanden, aber nicht sichtbar gerendert.
Komponenten: `Table`, `Tabs`, `Checkbox`, `Button`, `IconButton`, `BadgeFeedback`, `Avatar`, `DropdownMenuSelect` und Subframe-Dropdown-Menüs.
Aktionen im JSX: 14 leere Click- und sieben leere Checkbox-Handler. Der Screen beweist den Host-Kontext, ist aber als wiederverwendbarer Aufgaben-Body zu groß und dupliziert Projektkopf/Tabs.
### V2 — objektneutraler kompakter Aufgaben-Body
UUID: `8e57da9d-592b-4cd3-9e6f-a8f55ec31448` · Datei: `V01EingebetteteAufgabenV2.tsx` · 640 Zeilen
![Subframe-Screenshot V2](https://egniatlvhajtqurt.public.blob.vercel-storage.com/prod/39410/screenshots/8e57da9d-592b-4cd3-9e6f-a8f55ec31448-1787355976175.png)
Sichtbar:
- Objektneutraler Kopf »Aufgaben« mit »Aufgabe hinzufügen«.
- Gruppen Offen (`5`) und Erledigt (`2`).
- Kompakte Zeilen: Checkbox, Titel, Frist, Priorität, Avatar und Mehr-Menü.
- Überfällige Fristen rot, heutige Frist orange, erledigte Titel durchgestrichen.
- Footer `7 Aufgaben · 2 überfällig · 2 erledigt`.
- Mehr-Menü: Detail öffnen, Erledigen/Wieder öffnen, Fälligkeit ändern, Priorität ändern und Löschen.
Komponenten: `Checkbox`, `Button`, `IconButton`, `BadgeFeedback`, `Avatar`, `DropdownMenuSelect` und Subframe-Dropdown-Menüs.
Aktionen im JSX: acht leere Click- und sieben leere Checkbox-Handler. Die Variante ist leichter wiederverwendbar, zeigt aber keinen Status `In Bearbeitung` und keinen Host-/Tab-Kontext.
## Historische Zustände und Einbettungsanforderungen vor den finalen Varianten
| Thema | Subframe-Stand | Abgleich |
|---|---|---|
| Projekt-Host | nur V1 | als Integrationsbeispiel wertvoll, nicht Teil des wiederverwendbaren Bodys |
| Objektneutraler Body | V2 | bessere Wiederverwendung |
| Status `In Bearbeitung` | V1 vorhanden, V2 verloren | in V2 ergänzen oder Statusmodell vereinfachen lassen |
| Empty | V1 nur `emptyText`; V2 fehlt | echter State mit kontextbezogenem CTA fehlt |
| Loading / Error | fehlt | A7 wiederverwenden |
| Rechte | nicht sichtbar | Zeilen-/Anlageaktionen nach `tasks.*` gaten |
| Kontextübergabe | Beispielprojekt nur in V1 | M01 muss Objekt-ID/Typ zuverlässig erhalten |
| Lange Titel / schmale Host-Spalte | nicht separat geprüft | responsive Einbettung in Zwei-Spalter nötig |
## Historische UX-/Produktbewertung
Empfehlung: **zusammenführen + als wiederverwendbaren Body schneiden; V2 als Basis, noch nicht final**.
- V2 ist näher am eigentlichen Produktartefakt: ein objektneutraler Aufgaben-Body, der in verschiedene Detailseiten eingesetzt werden kann.
- V1 belegt die Einbettung im Projektkontext und hat mit Statusspalte und Tabellenkopf die vollständigere Semantik.
- V1 sollte nicht als einzige Implementierung dienen, weil Projektkopf und Tabs sonst in jedem Feature dupliziert würden.
- V2 gruppiert nur Offen und Erledigt und verschluckt damit `In Bearbeitung`; das widerspricht S01/S02 und erzeugt einen inkonsistenten Statuswechsel.
- Beide Varianten brauchen den leeren, ladenden und fehlerhaften Zustand sowie eine klare Permission-Strategie.
Empfohlene Zusammenführung: V2 als wiederverwendbare Komponente/Body, ergänzt um einen konsistenten Status `In Bearbeitung` und optional klarere Spaltenlabels; V1 als Kontext-/Integrationstest behalten, bis die Einbettung in mindestens Projekt und Kontakt validiert ist.