P2 · 增值功能已通

QX Demo · Java 版

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

服务状态

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

演示数据(宝安店)

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

已交付

登录 / 多店切换✓
租户隔离 / 订阅限权✓
开单 → 施工 → 结算✓
配件领料 / 退料 / 成本✓
提成计提 / 大屏 / 看板✓
预约到店 / 打印 / 导入✓

这一版能做什么

现在还不能做什么

接口一览

方法路径说明
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门店信息 + 价目表 + 员工
两个环境分开跑:这个域名是 Java 新版,后端已能跑完整业务,但还没有配套页面; ssa.agent2.0755xzb.club/qx/app/ 是现有 Python 版完整界面演示。 Java 版的门店端界面在 P2 之后接现有 Vue3 前端,届时才对外演示。