docs(ui): design and plan for the four structural UX themes
This commit is contained in:
mika kuns
@@ -0,0 +1,122 @@
|
||||
# UX-Struktur — Vorgaben für die Umsetzung
|
||||
|
||||
**Design:** `docs/superpowers/specs/2026-08-20-ux-struktur-design.md`. Dort stehen die
|
||||
Entscheidungen und Belege; dieses Dokument wiederholt sie nicht, es schneidet die Arbeit.
|
||||
|
||||
**Ausführungsmodell: eine strikte Kette.** Alle drei Pakete ändern `locales/en.json` und
|
||||
`locales/de.json` — die überlappen immer. Deshalb läuft nichts parallel.
|
||||
|
||||
```
|
||||
#189 → #190 → #191 → #192 (mechanische Audit-Fixes, bereits delegiert)
|
||||
│
|
||||
└── A Task-Zeile + Kontextmenü
|
||||
│
|
||||
└── B Settings-Sidebar
|
||||
│
|
||||
└── C Erststart-Banner + Textkette
|
||||
```
|
||||
|
||||
Jedes Paket hängt per `dependsOn` am Vorgänger. Der Picker holt es erst, wenn der Vorgänger
|
||||
**Done** (also gemergt) ist.
|
||||
|
||||
## Datei-Eigentum (bindend)
|
||||
|
||||
| Paket | Besitzt | Darf **nicht** anfassen |
|
||||
|---|---|---|
|
||||
| **A** | `Ui/Views/Islands/TaskRowView.axaml(.cs)`, `Ui/ViewModels/Islands/TaskRowViewModel.cs`, `Ui/Views/Islands/Detail/TaskHeaderBar.axaml`, `locales/*` | `WorkConsole.axaml`, Settings-Dateien, `ListsIsland*` |
|
||||
| **B** | `Ui/Views/Modals/SettingsModalView.axaml(.cs)`, `Ui/ViewModels/Modals/SettingsModalViewModel.cs`, `Ui/ViewModels/Modals/Settings/*`, `locales/*` | alles im Islands-Ordner |
|
||||
| **C** | `Ui/Views/Islands/ListsIslandView.axaml(.cs)`, `Ui/ViewModels/Islands/ListsIslandViewModel.cs`, `Ui/Views/Islands/Detail/WorkConsole.axaml` (nur die eine Approve-Gate-Zeile), `Ui/Views/Islands/TasksIslandView.axaml` (nur Empty-State-Texte aus #192 nachschärfen), `locales/*` | `TaskRowView*`, Settings-Dateien |
|
||||
|
||||
Alle drei dürfen `tests/ClaudeDo.Ui.Tests` erweitern — aber nur eigene neue Testdateien bzw.
|
||||
eigene neue Testmethoden anlegen, keine fremden umschreiben.
|
||||
|
||||
## Vorgaben für alle drei Pakete
|
||||
|
||||
- **Modell:** `sonnet`. **`maxTurns` explizit 200** — `model_presets` ist NULL, sonst gibt es
|
||||
30 Turns und „exited with code 1 and no result".
|
||||
- **Bauen** (`.slnx` scheitert auf .NET 8, laufender Worker sperrt `Debug`):
|
||||
```
|
||||
dotnet build src/ClaudeDo.App/ClaudeDo.App.csproj -c Release
|
||||
dotnet test tests/ClaudeDo.Ui.Tests/ClaudeDo.Ui.Tests.csproj -c Release
|
||||
dotnet test tests/ClaudeDo.Localization.Tests/ClaudeDo.Localization.Tests.csproj -c Release
|
||||
```
|
||||
- **Nur eigene Dateien stagen** (`git commit -- <pfade>`), nie `git add -A` — der `main`-Checkout
|
||||
ist mit parallelen Sessions geteilt.
|
||||
- **Keine Funktion still entfernen.** Wo etwas aus einer Oberfläche verschwindet, im
|
||||
Abschlussbericht benennen, wo es jetzt liegt.
|
||||
- **Locale-Parity** ist Testsache (Localization.Tests) — beide Dateien im gleichen Commit.
|
||||
- **Visuelle Verifikation im Abschlussbericht als offen markieren.** Mika macht den visuellen
|
||||
Pass; kein Task darf behaupten, die UI sei geprüft.
|
||||
|
||||
---
|
||||
|
||||
## Paket A — Task-Zeile + Kontextmenü
|
||||
|
||||
Themen 1 und 3 des Designs zusammen, weil sie dieselben drei Dateien anfassen.
|
||||
|
||||
- [ ] **A1 Kontextmenü umbauen.** Gruppe 1 (Send to queue, Remove from queue, Cancel execution,
|
||||
Open quick session, Refine task) immer sichtbar, bei nicht erfüllter Bedingung
|
||||
`IsEnabled=false` + Grund. Untermenüs „Mark as", „Planning", „Schedule" nach der Tabelle im
|
||||
Design; Untermenü-Kopf disabled wenn leer. Der „Delete task…"-Eintrag aus #191 bleibt als
|
||||
abgesetzte Gruppe unten. `MakeItem` bekommt einen `reason`-Parameter.
|
||||
- [ ] **A2 Disabled-Gründe am VM.** `SendToQueueDisabledReason`, `CancelDisabledReason`,
|
||||
`QuickSessionDisabledReason`, `RefineDisabledReason`, `PlanningDisabledReason` (`string?`)
|
||||
auf `TaskRowViewModel`, mit Change-Notification an den passenden Stellen. Unit-Tests pro
|
||||
Zustand.
|
||||
- [ ] **A3 Tooltip-Fähigkeit verifizieren.** Headless prüfen, ob Avalonia 12 einen `ToolTip` auf
|
||||
einem `IsEnabled=false` MenuItem anzeigt. Ja → Tooltip. Nein → Grund als Suffix im Header.
|
||||
Das Ergebnis gehört in den Abschlussbericht (es ist eine Projekt-Erkenntnis, kein Detail).
|
||||
- [ ] **A4 Hover-/Selektions-Aktionen.** `IsHovered` + `ShowRowActions => IsHovered || IsSelected`
|
||||
am `TaskRowViewModel`; `PointerEntered`/`PointerExited` in `TaskRowView.axaml.cs`.
|
||||
Refine-Button, ungesetzter Star und Dequeue-X werden damit AND-verknüpft; `IsRefining`-Spinner
|
||||
bleibt ausgenommen. Grid-Spalten unverändert lassen, damit die Zeile nicht springt.
|
||||
- [ ] **A5 Branch verlagern.** Branch-Chip aus `TaskRowView.axaml` entfernen und den Branch-Namen
|
||||
in `TaskHeaderBar.axaml` als Meta-Zeile aufnehmen (er steht bisher nirgends im Detail-Pane).
|
||||
Ohne A5 darf der Chip nicht entfernt werden.
|
||||
|
||||
**Fertig, wenn:** Build grün, Ui.Tests + Localization.Tests grün, und der Bericht sagt für jedes
|
||||
verschwundene Zeilen-Element, wo es jetzt erreichbar ist.
|
||||
|
||||
---
|
||||
|
||||
## Paket B — Settings-Sidebar
|
||||
|
||||
- [ ] **B1 Host umbauen.** TabStrip des bestehenden `TabControl` ausblenden, links eine
|
||||
Sidebar-`ListBox` mit Gruppen-Labels BASIS/ERWEITERT, die `SelectedIndex` bindet.
|
||||
Panel-Inhalte bleiben, wo sie sind. Fensterbreite 580 → 700.
|
||||
`SettingsCategory(Key, Label, Group, IsVisible, RequiresRepo)` + `Categories` +
|
||||
`SelectedCategory` am `SettingsModalViewModel`.
|
||||
- [ ] **B2 General aufteilen.** „Allgemein" (Sprache, Accent, Default-Instructions) und
|
||||
„Ausführung" (Model, Permission, Model-Presets, MaxTurns-Ceiling, Parallelität, Usage-Gate).
|
||||
Kategorie „Berichte" neu mit Standup-Wochentag + Report-Excluded-Paths. Reihenfolge der
|
||||
Kategorien: Allgemein, Ausführung, Prime Claude | Worktrees, Dateien & Prompts,
|
||||
Session Skills, Berichte, Online Inbox.
|
||||
- [ ] **B3 Session Skills zusammenlegen.** Checkbox-Liste aus General entfernen; in der Kategorie
|
||||
„Session Skills" pro installiertem Skill eine Zeile mit Checkbox (global aktiv) +
|
||||
Update/Remove, darunter das Install-Feld. **Speichern/Laden der Auswahl muss nachweislich
|
||||
unverändert funktionieren** — Test dafür ist Pflicht, das ist die einzige echte
|
||||
Regressionsstelle des Pakets.
|
||||
- [ ] **B4 Repo-Hinweis.** `HasLinkedRepo` am `SettingsModalViewModel` (keine Liste mit
|
||||
`WorkingDir` → false). Hinweisstreifen oben in Worktrees, Prime Claude, Session Skills und
|
||||
Berichte: „Wirkt erst mit verknüpftem Repo" + Link, der den Repo-Import öffnet.
|
||||
|
||||
**Fertig, wenn:** Build grün, Tests grün, jede der acht Kategorien einmal aufrufbar, und Save →
|
||||
Reopen zeigt alle Werte unverändert (inkl. Skill-Auswahl).
|
||||
|
||||
---
|
||||
|
||||
## Paket C — Erststart-Banner + Textkette
|
||||
|
||||
- [ ] **C1 Banner.** `HasNoLinkedRepo` am `ListsIslandViewModel` (true, solange keine User-Liste
|
||||
ein `WorkingDir` hat; neu berechnet beim Listen-Load und nach List-CRUD/List-Settings-Save).
|
||||
Banner unter dem Lists-Island-Header, optisch wie das Update-Banner des Shells, Button ruft
|
||||
`OpenRepoImportCommand`. Kein Dismiss.
|
||||
- [ ] **C2 Textkette abstimmen.** Die Empty-State-Texte aus #192 so nachschärfen, dass Banner →
|
||||
„Liste ohne Repo" → „Liste mit Repo, aber leer" als ein Weg lesbar sind; der letzte nennt
|
||||
„Send to queue" und den Worktree.
|
||||
- [ ] **C3 Review-Zeile.** Am Approve-Gate-Hinweis in `WorkConsole.axaml` (den #190 baut) eine
|
||||
Zeile ergänzen, die sagt, dass Approve gleichzeitig das Mergen der ganzen Einheit ist.
|
||||
Nur diese eine Stelle in der Datei anfassen.
|
||||
|
||||
**Fertig, wenn:** Build grün, Tests grün, und die vier Texte im Bericht als zusammenhängende
|
||||
Kette zitiert sind (damit Mika sie ohne App lesen kann).
|
||||
Reference in New Issue
Block a user