平台架构

多仓（multi-repo）本地开发环境：平台六仓 + 业务项目仓按需登记

平台六仓

仓库	角色	说明
control-center	引导仓	编排配置 orchestration/、注册表 registry/、环境脚本 scripts/
control-api	编排后端	Go HTTP 服务：任务状态机、审批、审计、契约对账、SSE 事件流
control-web	工作台前端	React 审批工作台：看板/审批/审计/KB/API 文档/AI 助手
control-piekbs	知识引擎	Go 编写：FTS 搜索 + MCP 服务 + 文档蒸馏（wiki-distill 技能）
control-db	数据库 DDL	SQLite 运行时库 DDL（当前占位）
control-wiki	平台级 KB	raw/ 原始文档、wiki/ 蒸馏产物、schema/ 规则

运行时拓扑

            人工操作        control-web 审批工作台（4173，React + AI 助手 iframe）
            ──────────────→┌─────────────────────────────┐
                           │ 看板 / 审批 / 审计 / KB      │
                           └──────────────┬──────────────┘
                                          │ /api（REST + SSE）
            ┌──────────┐   ┌──────────────▼──────────────┐
            │ DSH GUI  │   │ control-api（8765，Go）       │
            │ (3080)   │←──┤ 状态机/审批/审计/契约/SSE     │
            │ AI 会话  │   └──────┬──────────┬────────────┘
            │ 插件工具 │          │ SQLite   │ PieKBS(8766)
            └──────────┘      control.db   FTS/KB + Git worktree

技术栈

后端

Go 1.25+ · stdlib net/http mux（无 Web 框架）· SQLite（WAL）

前端

React 18 · PrimeReact · Vite · pnpm（审批工作台）

AI 执行

DSH 会话（dsh-llm 统一出口）· control 插件工具桥（14 个 control_* 工具）

知识

PieKBS FTS 检索 · wiki-distill 蒸馏 · KB grounding 有据校验

流水线（每阶段一审批闸）

requirements → design → coding → testing → merge → deliver
      ↑ 审批闸    ↑ 审批闸    ↑ 审批闸   ↑ 审批闸    ↑ 团队 MR 终审
      （驳回附批注重做）      （测试驳回打回 coding）

merge 阶段终审为团队员工在 Git 平台合并（平台无合并按钮）；webhook 回传自动推进
任务级熔断：连败 3 次自动暂停 + 通知
开发流程（2026-08 起）：平台仓 dev 直开；业务仓 worktree + feature 分支 + MR

数据分层

层	内容	存放
权威（低频）	代码、文档、编排配置、注册表、task.md、KB	Git
派生（读多）	wiki FTS 索引、任务看板索引	SQLite / PieKBS index
运行时（高频）	work_log 流水、任务状态机	~/data/control.db（WAL）