统一信封 {"ok":true,"data":...};金额单位「分」;鉴权 Authorization: Bearer <token>。
登录:POST /api/v1/auth/login {"phone":"13800000001","code":"123456"}(演示环境任意 6 位)。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/v1/auth/login | 登录换 token |
| POST | /api/v1/auth/logout | 注销 |
| GET | /api/v1/me | 当前员工 + 所属租户 |
| GET | /api/v1/t/{tid}/dashboard | 工作台数字(今日进场/待结算/30 天提醒/7 日曲线) |
| GET | /api/v1/t/{tid}/settings | 门店信息 + 员工 |
| PUT | /api/v1/t/{tid}/settings | 改门店信息 |
| GET | /api/v1/t/{tid}/items | 价目表 |
| POST | /api/v1/t/{tid}/items | 新增项目 |
| PATCH | /api/v1/t/{tid}/items/{id} | 改价 |
| GET | /api/v1/t/{tid}/customers?q=&page= | 客户列表(搜姓名/手机) |
| GET | /api/v1/t/{tid}/customers/{id} | 客户档案 + 车辆 + 历史工单 |
| GET | /api/v1/t/{tid}/vehicles/lookup?plate=粤B1000 | 车牌带出客户与上次保养 |
| GET | /api/v1/t/{tid}/orders?status= | 工单列表 |
| POST | /api/v1/t/{tid}/orders | 接车开单 |
| GET | /api/v1/t/{tid}/orders/{no} | 工单详情 |
| POST | /api/v1/t/{tid}/orders/{no}/quote | 生成报价分享 token |
| POST | /api/v1/t/{tid}/orders/{no}/confirm | 客户确认报价(演示) |
| PATCH | /api/v1/t/{tid}/orders/{no}/status | 状态流转(不能跳步) |
| POST | /api/v1/t/{tid}/orders/{no}/settle | 结算(自动写客户累计 + 下次保养提醒) |
| GET | /api/v1/t/{tid}/reminders?month=2026-11 | 到期提醒 |
| POST | /api/v1/t/{tid}/reminders/{id} | 标记已联系/已到店 |
错误码:VALIDATION 400 · UNAUTHORIZED 401 · TENANT_FORBIDDEN 403 ·
NOT_FOUND 404 · STATE_CONFLICT 409 · RATE_LIMIT 429