TidyTrue 后端接口测试台

⓪ 管理员登录（访问 /api/admin/* 必需）

管理员登录 退出（清除 token）

① 健康检查

GET /api/health

② 用户注册（邮箱验证码）

第 1 步：发送验证码

邮箱 POST /register/send-code

未配置 SMTP 时为开发模式：验证码打印到后端控制台，复制到下方。

第 2 步：提交注册

地址(可选) POST /register

注：公开注册固定为「普通用户」，权限由管理员在下方「用户管理」指定/修改。

③ 账户（登录 / 当前信息 / 退出 / 重置密码 / 注销）

用户登录（拿 token，供 /me、/logout 使用）

POST /login

当前用户 token：（未登录）

当前用户信息 / 退出

GET /me（带用户 token） POST /logout（带用户 token）

重置密码（邮箱验证码，二步）

邮箱（须已注册） POST /reset-password/send-code

开发模式验证码打印到后端控制台，复制到下方。

POST /reset-password

重置成功不自动登录，请用新密码到上方重新登录。

注销账号（软删除，需上方已登录拿到用户 token）

当前密码（二次确认） POST /deactivate（带用户 token）

有进行中订单(非 finished/cancelled)会被拒(40013)；成功后该 token 失效、原邮箱可重新注册。

④ 用户管理（管理端，权限）

GET 用户列表

管理员创建用户（可指定权限，免验证码）

POST 创建用户

⑤ 评论（客户端获取 + 管理端 CRUD）

GET /api/client/comments

管理端评论 CRUD（需 ⓪ 管理员登录）

管理端列表（完整中英文）

新增 / 编辑（填了「评论ID」即编辑 PUT，留空为新增 POST）

⑥ 保洁人员管理（中英文 CRUD）

GET 列表

新增 / 编辑（填了 ID 即为编辑 PUT，留空为新增 POST）

电话* 服务年限 保存（POST/PUT） 清空表单

⑦ 产品管理（中英文 CRUD）

新增 / 编辑（填了 ID 即为编辑 PUT，留空为新增 POST）

保存（POST/PUT） 清空表单

⑧ 产品明细 · 日常清洁（子表，嵌套中英文 CRUD）

管理端列表（完整中英文） 客户端（按 lang 解析）

新增 / 编辑（填了「明细ID」即编辑 PUT，留空为新增 POST）

套餐 combos（数组，对应基础/快捷/标准/家庭/高级） + 添加套餐

清洁区域 areas + 添加区域

额外服务 extras + 添加额外项

保存（POST/PUT） 清空表单

⑨ 产品明细 · 其余子表（退租/开荒/商业/地毯/其他服务）

嵌套层级各异，这里用「JSON 请求体编辑器」做增删改，可直接看到每种类型的请求结构，方便前端对照。

管理端列表 客户端（按 lang 解析）

新增 / 编辑（填了「明细ID」即编辑 PUT，留空为新增 POST）

请求体 JSON 保存（POST/PUT） 清空ID

⑩ 订单（创建 / 获取 / 更新，客户端 + 管理端）

客户端需「本人登录 token」（在下方登录）：可创建本人订单、改自己订单的填写信息；管理端用 ⓪ 的管理员 token，可改派单/报价/状态。

客户端本人登录（拿用户 token）

用户登录 未登录

创建订单（POST，本人下单 · 需用户登录）

已预填示例值，可直接点「创建订单」。新单初始 pending(待报价)、金额为空、order_no 自动生成；创建成功后会把新订单ID回填到下方「获取/更新」。

quoteDetail（报价配置快照 JSON） {"propertyType":"house","bedrooms":2,"bathrooms":1,"selection":{"serviceId":"daily","comboId":"standard","cleanerNum":1,"frequency":"standard"},"selectedAreas":["厨房","卫生间"],"addons":[],"extraCharges":[],"price":{"subtotal":156.52,"gst":23.48,"total":180},"quoteSummary":"标准清洁 · 一次性 · 1人","photoCount":0}

订单列表（客户端本人 / 管理端）

获取 / 删除订单

软删仅限本人、且订单为 pending(待报价)/cancelled(已取消) 且未支付；其它状态返回 40015。删除后该单对用户隐藏(GET 返回 40409)，管理端仍可见、可「恢复」(撤销软删，未删的订单恢复返回 40016)。

更新订单（填写信息，两端通用）

quoteDetail（报价配置快照 JSON，不改留空）

房屋情况图片上传（需用户登录）

上传到该区域 清空已传 houseCondition（上传后累积，更新订单时一并提交）

{}

管理端额外字段（仅管理端更新时生效）

保洁结算记账

⑪ 其他服务咨询（客户端提交 + 管理端跟进）

「其他服务」页提交的清洁需求咨询，落库 service_enquiry，不产生报价。客户端提交需「本人登录 token」（复用 ⑩ 的用户登录）；管理端用 ⓪ 的管理员 token。

提交咨询（POST · 需用户登录）

需先在 ⑩ 完成「用户登录」。联系人/电话留空时后端自动回退登录用户的资料。照片填 URL（可先用 ⑩ 的上传接口拿到 URL）。

清洁需求* 三房两厅，搬家后开荒清洁，厨房油污较重，希望本周末上门评估。 照片URL列表(JSON 数组，选填；上传后自动累积，也可手填) []

咨询列表（客户端本人 / 管理端）

详情 / 跟进（管理端）