docs(ops): register system-admin-console task and claim

This commit is contained in:
weichen
2026-09-17 06:57:13 +00:00
parent 0eaca61545
commit e310f06504
2 changed files with 58 additions and 0 deletions
+1
View File
@@ -13,6 +13,7 @@
| owner | task | branch | worktree | mutex | status |
|-------|------|--------|----------|-------|--------|
| Kimi | 2026-09-17-system-admin-console | feature/system-admin-console | - | web + sysadmin | in_progress |
| Cursor | 2026-09-17-promote-null-fk-to-test | feature/promote-null-fk-to-test | - | infra | done |
| Cursor | 2026-09-17-docgov-optional-duty-null-fk | fix/docgov-optional-duty-null-fk | - | docgov | done |
| Cursor | 2026-09-17-leftover-hygiene | chore/leftover-hygiene-2026-09-17 | - | ops | done |
@@ -0,0 +1,57 @@
---
title: "系统管理台(System Admin Console)一期"
status: in_progress
created: 2026-09-17
updated: 2026-09-17
owner: Kimi
branch: feature/system-admin-console
worktree: "-"
mutex: web + sysadmin
---
# 系统管理台(System Admin Console)一期
## 目标
为管理员提供独立的系统级管理界面(全屏视图,`workbench | admin` 顶层切换),覆盖总览状态、知识库、功能与特性开关、角色权限、工作流、用户审批、文档治理;吸收下线 AdminSettingsModal;系统设置只读为主 + SettingSpec 白名单少量可写。
## 范围
- 后端:新包 `internal/sysadmin`(薄聚合层,ports/settings/overview);迁移 `deploy/postgres/goose/00049`(`system_settings` 表);路由 `/api/v1/admin/system/{overview,kb,features,settings}`;`internal/server/admin_system_handlers.go`;`internal/app/app.go` 装配。
- 前端:`web/src/api/systemAdmin.ts` + `web/src/types/systemAdmin.ts`;`web/src/components/admin/console/AdminConsoleView.tsx` + `sections/`;`App.tsx` 顶层视图切换;LeftRail 入口语义改为进入管理台;吸收 `AdminSettingsModal` 六 tab 并删除旧模态。
## 非目标
- 不做全量 DB feature-flag 层(env 开关保留,标注「需重启」)。
- 不改项目级设置(`projectinstance.ProjectSettings` 与项目设置模态保持原样)。
- 不引入 react-router / 新前端依赖;不改 `tokens.css` 之外的全局样式。
- 不做 KB 重建/索引管理等运维动作(一期只读)。
## 步骤
1. [ ] 后端 sysadmin 包 + goose 00049
2. [ ] 后端路由/handler/装配 + 单测
3. [ ] 前端 API 模块与类型
4. [ ] AdminConsoleView 骨架与 8 个分组 sections
5. [ ] 吸收 AdminSettingsModal 并下线
6. [ ] go vet / go test -short / web npm test + build
7. [ ] 占集成槽位:dev rebuild + /health + admin overview 冒烟
## 验收标准
- [ ] admin 从 LeftRail 入口进入全屏管理台,八个分组可渲染
- [ ] 非管理员无入口且 `/api/v1/admin/system/*` 返回 403
- [ ] 白名单可写设置 PUT 后 GET 生效;env 项只读并标注需重启
- [ ] `go vet ./...`、`go test -short ./...`、`cd web && npm test && npm run build` 全绿
- [ ] dev 容器冒烟 PASS
## 相关链接
- 方案:会话计划(全屏独立视图 / 吸收旧模态 / 只读+少量可写,用户已批准)
- Checklist:
- Handoff:
- Test report:
## 证据 / 备注
(待补 commit 与命令输出)