From e310f06504b6eb6e5b0ffe8c6bbbed8634476326 Mon Sep 17 00:00:00 2001
From: weichen <weichen@example.com>
Date: Thu, 17 Sep 2026 06:57:13 +0000
Subject: [PATCH] docs(ops): register system-admin-console task and claim

---
 .doc/ops/CURRENT.md                           |  1 +
 .../2026-09-17-system-admin-console.md        | 57 +++++++++++++++++++
 2 files changed, 58 insertions(+)
 create mode 100644 .doc/ops/short-term/2026-09-17-system-admin-console.md

diff --git a/.doc/ops/CURRENT.md b/.doc/ops/CURRENT.md
index ccd52048..0bc9dbd8 100644
--- a/.doc/ops/CURRENT.md
+++ b/.doc/ops/CURRENT.md
@@ -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 |
diff --git a/.doc/ops/short-term/2026-09-17-system-admin-console.md b/.doc/ops/short-term/2026-09-17-system-admin-console.md
new file mode 100644
index 00000000..88261aeb
--- /dev/null
+++ b/.doc/ops/short-term/2026-09-17-system-admin-console.md
@@ -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 与命令输出）