Sync wiki after UX decisions accepted

2026-07-09 13:05:41 +02:00
parent 9b227f1f31
commit a9388671e1

@@ -1,4 +1,4 @@
<!-- codex-wiki-sync:cf53d20eede728869b7f3de3 --> <!-- codex-wiki-sync:152f0f41a0121022597b1435 -->
> Mirrored from `/mnt/DATA/git/govoplan-core/docs/UI_UX_DECISION_LEDGER.md`. > Mirrored from `/mnt/DATA/git/govoplan-core/docs/UI_UX_DECISION_LEDGER.md`.
> Origin: `repository`. > Origin: `repository`.
@@ -36,29 +36,27 @@ exist, but it must be deliberately layered.
| UX-008 | Similar concepts must use shared placement and components: server/credential/policy rows, problem lists, review steps, advanced panels, confirmation modals, and empty/error states. | Accepted | Core WebUI and module WebUIs | | UX-008 | Similar concepts must use shared placement and components: server/credential/policy rows, problem lists, review steps, advanced panels, confirmation modals, and empty/error states. | Accepted | Core WebUI and module WebUIs |
| UX-009 | Preflight and diagnostics are product UX. Validation, policy, permission, dependency, and capability failures must be written for operators before exposing internal details. | Accepted | Installer, connectors, policy, package import | | UX-009 | Preflight and diagnostics are product UX. Validation, policy, permission, dependency, and capability failures must be written for operators before exposing internal details. | Accepted | Installer, connectors, policy, package import |
## Decisions Due Now ## Confirmed Implementation Decisions
These decisions should be made before the first implementation slice because These decisions were accepted on 2026-07-09 for the first implementation slice.
they shape reusable components and screen structure. They shape reusable components and screen structure. Future changes must revise
this section and update affected screens.
### DUE-001: Primary Admin Configuration Shell ### DUE-001: Primary Admin Configuration Shell
Decision needed: should admin/configuration surfaces standardize on a Decision: admin/configuration surfaces should standardize on a two-zone layout.
two-zone layout?
- Left or top area: searchable overview/list, status, and primary actions. - Left or top area: searchable overview/list, status, and primary actions.
- Main area: selected item summary and common settings. - Main area: selected item summary and common settings.
- Modal/wizard: create, connect, edit, test, review, and confirm actions. - Modal/wizard: create, connect, edit, test, review, and confirm actions.
- Collapsed advanced panels: rarely used technical fields. - Collapsed advanced panels: rarely used technical fields.
Recommended default: yes. Use this for file connectors and mail servers first, Use this for file connectors and mail servers first, then migrate policy,
then migrate policy, retention, API keys, and module operations. retention, API keys, and module operations.
### DUE-002: Wizard Step Model ### DUE-002: Wizard Step Model
Decision needed: standard wizard steps and names. Decision: standard wizard steps and names use this baseline:
Recommended baseline:
1. Choose type or scope. 1. Choose type or scope.
2. Enter essentials. 2. Enter essentials.
@@ -72,9 +70,7 @@ where applicable.
### DUE-003: Explanation Placement ### DUE-003: Explanation Placement
Decision needed: where do richer explanations live? Decision: richer explanations should use this placement model:
Recommended baseline:
- Short helper text below labels only when it prevents common mistakes. - Short helper text below labels only when it prevents common mistakes.
- Tooltips for icon-only controls and compact terms. - Tooltips for icon-only controls and compact terms.
@@ -85,9 +81,8 @@ Avoid permanently visible paragraphs inside dense admin cards.
### DUE-004: Advanced Options Contract ### DUE-004: Advanced Options Contract
Decision needed: what qualifies as advanced? Decision: advanced options are fields that are needed for control, compatibility,
or diagnostics but are not part of the common setup path.
Recommended baseline:
- protocol-specific endpoints, ports, path overrides, TLS/signing toggles, - protocol-specific endpoints, ports, path overrides, TLS/signing toggles,
timeout/retry tuning, raw headers, migration/destructive flags, and fallback timeout/retry tuning, raw headers, migration/destructive flags, and fallback
@@ -99,10 +94,10 @@ Advanced fields must still be editable through typed controls.
### DUE-005: Blocker Language Contract ### DUE-005: Blocker Language Contract
Decision needed: should all disabled/blocked actions use a shared structured Decision: all disabled or blocked primary actions should use a shared structured
reason object? reason object.
Recommended default: yes. Shape: Shape:
- `summary`: short plain-language reason. - `summary`: short plain-language reason.
- `details`: optional explanation. - `details`: optional explanation.
@@ -113,9 +108,7 @@ Recommended default: yes. Shape:
### DUE-006: First Migration Surface ### DUE-006: First Migration Surface
Decision needed: first screen family to convert. Decision: convert file connectors first, then mail servers. They share the same
Recommended default: file connectors, then mail servers. They share the same
server/credential/policy model, are high-value, and will prove the reusable server/credential/policy model, are high-value, and will prove the reusable
patterns quickly. patterns quickly.