3.8 KiB
3.8 KiB
Inbox Modules
本文档描述当前 inbox/ 的真实模块边界和最近一次收口后的职责落点。
总原则
- 业务入口只有一个：HTTP
- 启动命令只有两个：
server和api - 程序装配只留在入口层，不把 service 组装散落到业务 handler
- app 层按用例职责划分，store 层按聚合划分，不按页面或临时调用方划分
当前模块
1. 启动层
| 模块 | 路径 | 职责 |
|---|---|---|
| 程序入口 | cmd/inbox/ |
CLI 入口与最终 wiring |
| CLI 壳层 | internal/cli/ |
识别 server 与 api 命令 |
| HTTP client | internal/client/ |
通用 HTTP 请求封装 |
| AI CLI 封装 | internal/clientcmd/ |
面向 AI 的 api 命令封装 |
| Server 启动器 | internal/servercmd/ |
解析 flag，产出启动配置并启动 HTTP 服务 |
| Server 组装 | internal/inboxserver/ |
生产路径上的 store / service / handler composition root |
2. 基础与领域层
| 模块 | 路径 | 职责 |
|---|---|---|
| 基础能力 | internal/base/ |
timeutil、slug、idgen、httpx |
| 领域模型 | internal/domain/ |
role、skill、topic、message、workflow、merge、docspec、workspace、lane、task、taskgraph |
3. 应用层
| 模块 | 路径 | 职责 |
|---|---|---|
| roles | internal/app/roles/ |
角色配置管理与技能绑定 |
| runtimeconfig | internal/app/runtimeconfig/ |
workspace 维度的运行时角色解析 |
| skills | internal/app/skills/ |
技能管理 |
| topics | internal/app/topics/ |
topic、message、确认/停止 相关用例 |
| lanes | internal/app/lanes/ |
lane CRUD 与启动/停止 |
| tasks | internal/app/tasks/ |
task CRUD 与依赖写入 |
| taskexec | internal/app/taskexec/ |
lane 内 task 认领、执行完成、topic 收口 |
| leaderloop | internal/app/leaderloop/ |
leader delivery 轮询、规划执行、图谱落库 |
| workflowrun | internal/app/workflowrun/ |
workflow run 与日志用例 |
| workspaces | internal/app/workspaces/ |
project/workspace catalog CRUD 与 resolve |
| workspacelifecycle | internal/app/workspacelifecycle/ |
workspace runtime inspect / provision / ensure |
| workspaceprovision | internal/app/workspaceprovision/ |
provision 过程编排 |
| workspaceruntime | internal/app/workspaceruntime/ |
worktree / binary / container runtime 生命周期 |
| systemfs | internal/app/systemfs/ |
系统目录浏览与创建 |
| dashboard | internal/app/dashboard/ |
dashboard 读模型与聚合视图 |
4. 传输层
| 模块 | 路径 | 职责 |
|---|---|---|
| HTTP API | internal/httpapi/ |
/api/v2/* handler，只做 transport 解析、调用 app service、写响应 |
5. 持久化层
| 模块 | 路径 | 职责 |
|---|---|---|
| SQLite store | internal/store/sqlite/ |
schema、migration、repository 实现 |
当前 store 已按聚合拆分主要文件：
projects_workspaces.go：project / workspace 持久化topics_documents.go：topic 持久化messages.go：message 与 delivery 持久化workflow_runs_store.go：workflow run 与 log 持久化chains_store.go、tasks_store.go：lane / task 持久化task_graph_versions.go：task graph version 持久化roles_store.go、skills_store.go：配置类持久化taskexec_store.go：task execution 认领与完成写入
已删除或收口的旧边界
以下形态已经不再保留：
- 顶层
inbox/*.gofacade 包装层 - handler 中直接做 filesystem 业务
- handler 中直接做 patch merge 规则
roles包里的 runtime role resolve 适配层dashboard_queries.go/entities.go这种跨多个聚合的大一统 store 文件
如果后续继续扩展 inbox，优先遵守现有边界，不再恢复“按页面切 repo”或“transport 里做业务编排”的旧模式。