
## 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 文档包含对应路径与方法
