30 lines
2.4 KiB
Markdown
30 lines
2.4 KiB
Markdown
## Why
|
|
|
|
The console now has real API-backed coverage and automated browser acceptance, but the current interaction polish still depends on scattered page-level choices instead of explicit acceptance criteria. This change converts UI dissatisfaction into a concrete platform_web polish contract so the next implementation can improve usability without drifting into a generic SaaS dashboard or changing product scope.
|
|
|
|
## What Changes
|
|
|
|
- Define accepted interaction/design criteria for the required first-party areas: 首页、服务器管理、插件市场、用户管理、AI 提供商管理.
|
|
- Compress low-value management page summary counts into compact status context so primary list/table surfaces keep the scarce first-screen space.
|
|
- Define server detail workflow polish for lifecycle controls, logs, config, plugin controls, AI assistant, and operation history.
|
|
- Require responsive desktop/mobile walkthrough coverage and no visible overlap, clipped text, unreadable panels, or inaccessible control states.
|
|
- Require the polish to preserve the existing black mecha default theme, magical-girl alternate theme, translucent game-operations surfaces, grouped navigation, and shared theme primitives.
|
|
- Require compatibility with the automated browser acceptance suite so visual/interaction polish does not weaken API-backed route proof or safety scanning.
|
|
- No breaking product behavior, API, authorization, plugin, run, billing, cloud-host, or provider-marketplace changes are expected.
|
|
|
|
## Capabilities
|
|
|
|
### New Capabilities
|
|
|
|
- `platform-interaction-design-polish`: Defines accepted interaction and visual polish requirements for platform_web first-party console areas, server detail workflows, responsive behavior, theme preservation, browser walkthrough evidence, and automated acceptance compatibility.
|
|
|
|
### Modified Capabilities
|
|
|
|
- None.
|
|
|
|
## Impact
|
|
|
|
- Affected roots: `platform_web/`, platform_web documentation, and OpenSpec delivery stream files.
|
|
- Expected implementation areas: shared theme surfaces/classes, route/page layouts, command affordances, responsive behavior, state feedback, browser walkthrough evidence, and test coverage.
|
|
- Validation impact: requires `cd platform_web && npm run typecheck && npm test && npm run build`, automated browser acceptance against the local debug stack, `scripts/check-structure.sh`, and `openspec validate polish-platform-interaction-design --strict`.
|