diff --git a/.doc/ops/CURRENT.md b/.doc/ops/CURRENT.md index 0fdc5ac3..14123c1f 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-control-center-server | feature/control-center-server | - | controlcenter | in_progress | | Cursor | 2026-09-17-initial-load-perf-u2 | feature/initial-load-perf-u2 | - | web + static-delivery | done | | Codex | 2026-09-17-initial-load-performance-plan | feature/initial-load-performance-plan | .worktrees/feature-initial-load-performance-plan | loading-performance-audit | done | | Kimi | 2026-09-17-system-admin-console | feature/system-admin-console | - | web + sysadmin | done | diff --git a/.doc/ops/short-term/2026-09-17-control-center-server.md b/.doc/ops/short-term/2026-09-17-control-center-server.md new file mode 100644 index 00000000..e50af3cb --- /dev/null +++ b/.doc/ops/short-term/2026-09-17-control-center-server.md @@ -0,0 +1,61 @@ +--- +title: "个人项目中控台 Control Center:独立 Go 服务 + 8 阶段流水线 + 向量文档库 + agent 协作 API" +status: in_progress +created: 2026-09-17 +updated: 2026-09-17 +owner: Kimi +branch: feature/control-center-server +worktree: "-" +mutex: controlcenter +--- + +# 个人项目中控台 Control Center + +## 目标 + +交付独立于产品系统的个人项目管理中控台 Go 服务:任务/提案 8 阶段流水线(提案→分析→方案制定→方案评审→实施→测试→评价→确认)、agent 认领/进度/产物/决策上报 API(agent 禁止自动推进阶段)、`.doc` 文档 + 阶段产物入 pgvector 向量库支持模糊查询、阶段级模型指定、外部工具阶段提交、每日定时仓库审查与 findings 展示、Vite+React SPA 前端。 + +## 范围 + +- `cmd/control-center/` + `internal/controlcenter/{config,server,store,pipeline,tasks,docs,importer,audit,llm,embed}` +- `deploy/control-center/`(独立 pgvector 容器 + goose 迁移) +- `control-center/web/`(Vite+React SPA,embed 进二进制) +- 复用系统 `.env`:EMBEDDING_* / MINIMAX_* / CURSOR_*(仅读配置,不耦合产品代码路径) +- 设计文档、agent 接入规范、FEATURE-MATRIX 行、验收报告 + +## 非目标 + +- 不接产品 sysadmin、不动 internal/server 路由 +- 不做多仓库、不做远端 CI 集成 +- 不删旧 `internal/engineeringdashboard`(共存,对齐后另行弃用) +- 不做 agent 自动推进阶段(任何推进必须人工批准) + +## 步骤 + +1. [ ] P0 骨架:cmd/internal/compose/goose/healthz/token 鉴权 +2. [ ] P1 流水线核心:8 阶段状态机、门禁、decision 上报/裁决、阶段产物、claim/lease/事件流、阶段指令包、SSE +3. [ ] P2 文档向量库:扫描入库、切片、embedding、hybrid 检索、阶段产物向量化 +4. [ ] P3 前端 SPA:总览/阶段看板/任务详情 stepper/决策收件箱/文档搜索/设置 +5. [ ] P4 .doc 导入同步 + agent CLI 子命令 + 外部提交入口 +6. [ ] P5 定时审查:调度器、确定性检查、LLM chat client、findings 转任务 +7. [ ] P6 文档收口 + 验收报告 + +## 验收标准 + +- [ ] `go vet ./...` / `go test -short ./...` / `go build ./cmd/control-center` 全绿 +- [ ] 状态机单测:agent 直接推进被拒、decision 缺建议拒收、lease 过期孤儿恢复 +- [ ] `.doc` 全量入库后语义搜索命中已知文档 +- [ ] curl 冒烟:建任务→agent claim→产物→advance-request→人工批准→下一阶段 全链路 +- [ ] 前端 `vite build` 通过并 embed 可用 + +## 相关链接 + +- 设计: .doc/system-design/project-control-center/02-control-center-design.md(待建) +- Agent 接入规范: .doc/system-design/project-control-center/agent-integration.md(待建) +- Checklist: +- Handoff: +- Test report: .doc/test-reports/2026-09-17-control-center-test-report.md(待建) + +## 证据 / 备注 + +计划经用户批准(存储=独立 pgvector 容器;前端=Vite+React SPA embed;旧台共存后弃用;审查 LLM=薄 OpenAI 兼容客户端)。