docs(audit): 补充目标逐条验收矩阵
This commit is contained in:
@@ -21,6 +21,32 @@
|
|||||||
- 前端 Studio 九个工作台页面均已对接真实 API,API 层与页面单测已覆盖主要聚合接口。
|
- 前端 Studio 九个工作台页面均已对接真实 API,API 层与页面单测已覆盖主要聚合接口。
|
||||||
- 旧管理接口继续兼容;Studio 原型新增聚合接口用于支撑工作台页面,不替代低层 CRUD 接口。
|
- 旧管理接口继续兼容;Studio 原型新增聚合接口用于支撑工作台页面,不替代低层 CRUD 接口。
|
||||||
|
|
||||||
|
## 2.1 目标逐条验收矩阵
|
||||||
|
|
||||||
|
以下矩阵直接对照本次目标中的显式要求,标记当前证据状态:
|
||||||
|
|
||||||
|
| 验收项 | 当前状态 | 主要证据 |
|
||||||
|
|--------|----------|----------|
|
||||||
|
| 以 `docs/需求分析`、`docs/设计文档`、`docs/数据库设计`、`docs/后端实现文档`、`docs/前端实现文档` 为实现依据 | 已核对 | 本文档第 1 节与模块核对章节;`docs/数据库设计/9.模块一致性校验.md` |
|
||||||
|
| 后端为 Maven 多模块单体架构 | 已实现 | 根 `pom.xml` 的 9 个子模块;`common-agent-boot` 作为启动模块 |
|
||||||
|
| 模块按业务域拆分,而不是按技术类型散落 | 已实现 | `common-agent-common`、`rag`、`modelprovider`、`agent`、`workflow`、`mcp`、`skill`、`observability` 子模块 |
|
||||||
|
| `sys_enum` 设计与整型枚举协议保持不变 | 已实现 | `script/sql/1.enum.sql`、`script/sql/18.studio_enum.sql`、`PersistableSysEnumDefinition`、`EnumDefinitionTests` |
|
||||||
|
| Entity 与 SQL 表结构一致 | 已强验证 | `SqlEntityMappingContractTests` + `docs/数据库设计/9.模块一致性校验.md` |
|
||||||
|
| Controller 不直接暴露 Entity,统一 DTO/VO/RequestResult | 已实现 | 各模块控制器签名;controller/component 测试 |
|
||||||
|
| Factory/Assembler 承担 DTO/Entity/VO 转换 | 已实现 | 各模块 `factory` 包与 `*FactoryTests` |
|
||||||
|
| Service 承担业务逻辑、状态流转、校验 | 已实现 | 各模块 `service/impl` 与 `*ServiceTests` |
|
||||||
|
| Mapper 使用 MyBatis-Plus,数据访问与脚本命名一致 | 基本实现,证据中等 | `BaseMapper` 结构测试 + SQL/Entity 契约测试;真实 DB 读写集成仍偏少 |
|
||||||
|
| 核心流程补中文注释与中文业务日志 | 基本实现,证据中等 | `1d401c68` 提交 + 关键控制器/服务实现;未做全仓逐文件注释覆盖率检测 |
|
||||||
|
| 每模块补测试并运行 | 已实现 | 当前后端测试文件 68 个;前端 API/页面测试 25 个;多轮 reactor/vitest/build 验证 |
|
||||||
|
| 前端 Studio 页面与真实 API 对接 | 已实现 | 9 个工作台页面、16 个 API 单测、9 个页面单测、`npm run build` 通过 |
|
||||||
|
| 旧接口兼容且新增聚合接口支撑工作台 | 已实现 | RAG/Agent/Workflow/MCP/Skill 文档草案兼容路径与聚合接口 |
|
||||||
|
| 输出模块完成总结、测试结果、本地提交 | 已持续执行 | 最近提交记录:`c8245ba0`、`73237507`、`d5d239ae` 等 |
|
||||||
|
|
||||||
|
说明:
|
||||||
|
|
||||||
|
- 上表中“基本实现,证据中等”的项目,不表示发现功能缺失,而是提示当前最强证据还不如“脚本/实体一致性”那样直接。
|
||||||
|
- 目前最薄弱的仍是“真实数据库读写集成测试”和“全仓中文日志/注释覆盖率的自动化证明”。
|
||||||
|
|
||||||
## 3. 模块核对
|
## 3. 模块核对
|
||||||
|
|
||||||
### 3.1 common
|
### 3.1 common
|
||||||
@@ -291,6 +317,7 @@
|
|||||||
- 当前多数“mapper / repository 验证”仍以结构契约测试为主,真实数据库集成测试覆盖度有限。
|
- 当前多数“mapper / repository 验证”仍以结构契约测试为主,真实数据库集成测试覆盖度有限。
|
||||||
- 当前实现仍保留“旧管理接口 + Studio 聚合接口 + 文档草案兼容路径”的三轨并行方式,能力已覆盖,但后续如进入正式 API 收敛阶段,仍建议选定长期主路径并逐步淘汰别名。
|
- 当前实现仍保留“旧管理接口 + Studio 聚合接口 + 文档草案兼容路径”的三轨并行方式,能力已覆盖,但后续如进入正式 API 收敛阶段,仍建议选定长期主路径并逐步淘汰别名。
|
||||||
- 现有运行链路以“主数据优先 + 最小可运行”实现为主,复杂分支调度、远程 MCP 实时执行编排、重型运行器能力仍适合后续继续增强。
|
- 现有运行链路以“主数据优先 + 最小可运行”实现为主,复杂分支调度、远程 MCP 实时执行编排、重型运行器能力仍适合后续继续增强。
|
||||||
|
- 当前尚未形成“逐文件自动扫描中文日志/注释完整性”的机械化证明,现阶段主要依赖关键实现抽查、提交记录与模块测试覆盖。
|
||||||
|
|
||||||
## 6. 本次审计后的新增变更
|
## 6. 本次审计后的新增变更
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user