已关闭
Build admin overview, cache topology, repository coverage, and diagnostics views #94
urandon创建于  17 天前关闭于  16 天前
urandon
urandon成员
17 天前 创建

Parent: #52
Depends on: embedded admin runtime foundation; admin observation API

Design: https://gitcode.com/urandon/gitcode-mcp/wiki/Admin-Web-UI-Design-2026-08-25.md

Goal

Build the read-only operator experience for overview, cache topology, repository coverage, and diagnostics.

Scope

  • Overview attention queue, active work grouped by cache, service/provider readiness, and cache/repository cohort summaries.
  • Cache topology: cache → repository bindings → maintenance registrations/RAG namespaces.
  • Repository detail tabs for Coverage, Collections, Search status, and Activity.
  • Five independent coverage lanes: head, tail, secondary, projection, and RAG.
  • Collection counts/frontiers/recent sync events and issue/PR comment queue summaries.
  • Typed diagnostics grouped by entity/failure class, current/recovered state, remediation, and copyable CLI handoff.
  • Capability catalog with safety class and enabled/disabled reason.
  • Stable local deep links and URL-backed filters.
  • Keyboard navigation, semantic tables/forms, visible focus, non-color status text, reduced motion, and WCAG AA contrast.

Acceptance criteria

  1. An operator can determine system readiness, cache topology, corpus freshness/completeness, current jobs, RAG search readiness, and the next safe action without inspecting SQLite or raw logs.
  2. Bounded tail work never appears as proven complete without end-of-collection evidence.
  3. A transient historical failure does not override newer current coverage.
  4. Ordinary views expose no absolute cache paths or secrets.
  5. Empty, loading, partial, blocked, stale, recovered, and API-version-mismatch states have explicit designs and tests.
  6. Responsive narrow layouts remain operable without hiding status meaning.
  7. Component/unit tests and Playwright read-only flows pass.

Non-goals

  • Job or maintenance mutation controls.
  • Full GitCode issue/PR/wiki browsing and authoring.
likedislike
urandonurandon成员
17 天前 添加了label:enhancement
urandon
urandon成员
17 天前 评论:

Implementation plan for the read-only operator slice:

  1. Extend the version-1 observation DTO only with backward-compatible collection frontier and recent sanitized sync-event summaries needed by the repository views; keep all reads aggregate/bounded.
  2. Replace placeholder sections with real Overview, Caches, repository detail, and Diagnostics/Capabilities views while preserving the selected shell and System-default Light/Dark/System theme design.
  3. Keep deep-link state in URL search parameters (view, cache, repo, tab, diagnostic filters) so reload/back/forward and copied local URLs retain context.
  4. Make the five coverage lanes independent and non-color-coded, with explicit unknown/partial/current/blocked wording; never infer tail completeness from a bounded stop.
  5. Add explicit loading, empty, partial/degraded, stale, recovered, and API-version-mismatch states plus accessible semantic controls/tables, visible focus, reduced motion, and responsive narrow layouts.
  6. Verify component/type/unit coverage, mocked Playwright navigation/deep links/responsive/a11y semantics, real embedded browser flow, deterministic assets, Go tests/race checks, and public-path redaction.

No mutation controls, release/tag, or routine source install are part of this slice.

likedislike
urandonurandon成员
16 天前 关联了pull request:Add read-only admin observation views
urandon
urandon成员
16 天前 评论:

Implemented in !98.

Delivered:

  • attention-first Overview, current readiness, active work, cache cohort summaries, and recovered state;
  • cache → repository topology with opaque cache identities only;
  • repository Coverage, Collections, Search status, and Activity tabs;
  • five independent lanes with explicit textual states; bounded tail/max-pages evidence remains partial;
  • current RAG truth alongside (not replaced by) contention, retry, and historical error context;
  • bounded collection/frontier and recent sanitized sync summaries;
  • read-only Jobs and Maintenance summaries plus typed Diagnostics and Capability catalog;
  • URL-backed deep links and reload/back-forward continuity;
  • explicit loading, empty, partial/degraded, stale, recovered, and API-version-mismatch states;
  • semantic tabs/tables, visible focus, reduced motion, non-color status text, and 390px operability.

Verification includes full Go tests/race/vet/diff check, frontend type/unit/Playwright, deterministic embedded assets, visual comparison to the selected direction, and a live embedded-binary session/SSE/reload/theme/path-redaction smoke.

No mutation controls, release/tag, or routine source install were produced.

likedislike
urandonurandon成员
16 天前 关闭了 issue
urandonurandon成员
16 天前 关联了里程碑:Admin Web UI
urandonurandon成员
16 天前 添加了label:admin-ui
urandonurandon成员
16 天前 添加了label:cache
urandonurandon成员
16 天前 添加了label:diagnostics