# API 变更日志

所有非破坏性变更记录在此，**重大变更必须先经过设计评审**。

## [1.2.0] - 2026-06-14

### Added
- ✨ **Phase 3**：新增 `leads` 表（`phone + source` 唯一索引）
- ✨ **Phase 3**：`POST /api/v1/leads` 公开提交意向客户（自主问卷）
- ✨ **Phase 3**：`GET /api/v1/leads/stats` 鉴权统计
- ✨ **Phase 3**：`GET /api/v1/admin/leads` 鉴权列表（phone/source/keyword/时间过滤 + 分页）
- ✨ **Phase 3**：`GET /api/v1/admin/leads/:id` 详情
- ✨ **Phase 3**：`PUT /api/v1/admin/leads/:id/remark` 改备注
- ✨ **Phase 3**：`DELETE /api/v1/admin/leads/:id` 删除

## [1.1.0] - 2026-06-14

### Added
- ✨ **Phase 1**：后端按业务域重构为 `modules/{route,service,dto,README}` 四件套
- ✨ **Phase 1**：所有接口统一加 `/api/v1` 前缀，URL 路径升级
- ✨ **Phase 2**：Swagger UI 文档（`/api/docs`）和 OpenAPI 3.0 JSON 端点
- ✨ **Phase 2**：Appointment 模块新增 `GET /api/v1/appointments/stats` 鉴权接口

### Changed
- 修改：所有接口路径前缀从 `/api/...` 改为 `/api/v1/...`
- 修改：业务错误响应中，**资源不存在** 仍使用 HTTP 404，但响应体保持 `{code, message, data}` 结构
- 修改：管理后台自动给 `/api/` 路径加 `/v1` 前缀，调用方无需修改

### Removed
- 删除：`/api/hospitals` `/api/departments` 等无版本前缀的接口

## [1.0.0] - 2026-06-13

- 初始版本
- 7 个业务域：hospital / department / doctor / appointment / expert / banner / config
- 1 个鉴权域：adminAuth
- 同进程静态托管 `/admin` 管理后台