Files
yuyueguahao/docs/api/CHANGELOG.md
T
2026-07-05 14:43:34 +08:00

38 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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` 管理后台