yuyueguahao/docs/api/CHANGELOG.md

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 管理后台