## MODIFIED Requirements ### Requirement: OpenAPI 响应结构与运行时一致 系统生成的 OpenAPI 文档 SHALL 反映真实运行时的统一响应 envelope(成功与失败均一致)。 #### Scenario: 成功响应使用统一 envelope - **WHEN** OpenAPI 生成器为任一接口生成 200 响应 schema - **THEN** 响应结构包含 `code`、`msg`、`data`、`timestamp` - **AND** `data` 字段的 schema 使用该接口的业务 DTO(保持类型信息) #### Scenario: 错误响应使用统一 envelope - **WHEN** OpenAPI 生成器为任一接口生成标准错误响应(4xx/5xx) - **THEN** 错误响应结构包含 `code`、`msg`、`data`、`timestamp` - **AND** 字段名使用 `msg`(不使用 `message`) ### Requirement: OpenAPI 文档覆盖所有真实路由 系统生成的 OpenAPI 文档 SHALL 覆盖所有实际注册的 HTTP 路由,避免“路由存在但文档缺失”。 #### Scenario: 个人客户路由纳入文档 - **WHEN** 注册 `/api/c/v1` 个人客户相关路由 - **THEN** 路由注册应使用项目统一的 `Register(...)` 机制 - **AND** OpenAPI 文档包含对应路径与方法