docs: 增加 API OpenAPI 契约

This commit is contained in:
que01 committed 2026-09-19 01:03:31 +08:00
1 parent 3640ec46ed
commit 02554ed86c
2 files changed
+353 -4

No files matched your search

+4 -4
View File
@@ -34,6 +34,7 @@
- 修复 ESM 下 `bcryptjs` 导入和 Fastify 请求 ID middleware 的运行时问题。
- API 已通过真实 HTTP 验证:健康检查、公开品牌/服务读取和管理员登录。
- HTTP 集成测试:公开接口、管理员登录、错误密码、管理员权限边界、客户会话、预约 DTO 校验、创建/取消和状态流转,共 8 项通过。
- OpenAPI 3.1 契约:`docs/openapi.yaml`,覆盖当前公开、客户和管理员接口。
- 已执行多轮 Codex 代码审查并修复关键认证和权限问题。
## 最近提交
@@ -51,10 +52,9 @@ b89853b fix: harden api authentication and validation
## 下一步优先级
1. 补 OpenAPI/Swagger 契约和统一响应示例。
2. 创建类型化 `api-client`,固定前后端接口边界。
3. 接入管理后台订单处理页面。
4. 接入小程序品牌展示、服务列表和下单流程。
1. 创建类型化 `api-client`,固定前后端接口边界。
2. 接入管理后台订单处理页面。
3. 接入小程序品牌展示、服务列表和下单流程。
## 未决问题