P3 完成 · 车主端上线

QX Demo · Java 版

门店端 API 8902 · 运营后台 API 8903 · PostgreSQL 18 · Spring Boot 3.3
P0 骨架登录 / 租户 / 订阅
P1 核心工单 / 结算 / 客户
P2 增值配件 / 提成 / 看板
P4 后台建店 / 续费 / 审计
P3 车主端预约 / 查进度 / 报价

服务状态

门店端 API检测中
运营后台 API检测中
PostgreSQL18.6

演示数据(宝安店)

客户 / 车7 / 7
价目表 / 配件10 / 10
工单各阶段都有

已交付

门店端 16 个页面✓
开单 → 施工 → 结算 → 交车✓
配件 / 提成 / 大屏 / 看板✓
建店 / 续费 / 停用 / 审计✓
老板自己加员工账号✓
车主预约 / 查进度 / 报价✓
短信验证码 / 微信授权—

这一版能做什么

现在还不能做什么

接口一览

方法路径说明
POST/api/v1/auth/login门店登录,返回 token + 可进门店
POST/api/v1/auth/switch换店,校验该店是否属于你
GET/api/v1/me登录态 + 门店 + 订阅状态 + 功能开关
GET/api/v1/t/{tid}/dashboard今日单量/营收、在店车辆、各阶段计数
GET·POST/api/v1/t/{tid}/orders工单列表(按阶段筛)/ 开单
GET/api/v1/t/{tid}/orders/{no}工单详情:明细、预计完工、交车时间
PATCH/api/v1/t/{tid}/orders/{no}/status开工 / 完工(跳步 409)
POST/api/v1/t/{tid}/orders/{no}/settle收款结算(写金额、排保养提醒)
POST/api/v1/t/{tid}/orders/{no}/deliver交车(只写交付时间)
GET·POST/api/v1/t/{tid}/customers客户列表 / 新建(可带首台车)
GET/api/v1/t/{tid}/vehicles/lookup车牌查车,开单页自动带客户
GET·PATCH/api/v1/t/{tid}/items价目表;改价改工时仅老板
GET·PATCH/api/v1/t/{tid}/reminders保养/保险提醒,可标记完成
GET·POST/api/v1/t/{tid}/parts配件库 / 新增;含低库存标记
POST/api/v1/t/{tid}/orders/{no}/requisition领料扣库存(不足 409、已交车 409)
POST/api/v1/t/{tid}/orders/{no}/returns退料回库存(不能超领)
GET/api/v1/t/{tid}/commission月度提成汇总 + 规则;技师只看到自己
GET/api/v1/t/{tid}/screen营业大屏:营收 / 趋势 / 排行(仅老板)
GET/api/v1/t/{tid}/board客户看板:三列、车牌脱敏、无金额
GET·POST/api/v1/t/{tid}/appointments预约列表(带 7 天)/ 新建预约
POST/api/v1/t/{tid}/appointments/{id}/arrive到店一键开单
GET/api/v1/t/{tid}/orders/{no}/print打印数据:reception / settlement
POST/api/v1/t/{tid}/import/customers导入客户(CSV 文本 / 文件)
GET/api/v1/t/{tid}/settings门店信息 + 价目表 + 员工
POST/admin/api/tenants建店:生成订阅 / 联系人 / 店主账号
POST/admin/api/tenants/{id}/subscribe续费 / 换套餐 / 延长,可同时记账
POST/admin/api/tenants/{id}/policy到期策略 + 宽限期
POST/admin/api/tenants/{id}/suspend停用(店主立刻登录不了)
POST/admin/api/tenants/{id}/resume恢复
POST/admin/api/tenants/{id}/impersonate冒充店主登录(写审计)
GET/admin/api/payments收款记录 + 合计
GET/admin/api/audit操作审计(前后值 + IP)
PATCH/admin/api/plans/{code}套餐改价 / 限额 / 功能开关
GET/api/v1/t/{tid}/staff员工名单 + 坐席用量
POST/api/v1/t/{tid}/staff加员工(按手机号,支持一人多店)
PATCH/api/v1/t/{tid}/staff/{id}改姓名 / 角色
POST/api/v1/t/{tid}/staff/{id}/toggle停用 / 恢复(停用不占坐席)
GET/api/v1/pub/{tid}/info车主端:门店 + 价目 + 繁忙度(免登录)
GET/api/v1/pub/{tid}/progress车主端:查进度(车牌 + 手机后四位,无金额)
POST/api/v1/pub/{tid}/book车主端:自助预约(每 IP 每小时 6 次)
GET/api/v1/pub/quote/{token}车主端:报价明细(一次性 token)
POST/api/v1/pub/quote/{token}/confirm车主端:确认报价(幂等)
POST/api/v1/t/{tid}/orders/{no}/quote门店端:生成报价链接
三个端都在线:门店端 /app/(手机 / 平板)、运营后台 /admin.html、 车主端 预约 · 查进度(这两个给车主,不需要登录,也不需要装 App)。 门店端「设置」页最下面能直接复制这两条链接。