Files
qipai/docs/reference-api-inventory.md

2.5 KiB

参考接口线索

本文档只记录接口路径类别和迁移方向,不记录旧域名、AppID、Token、密钥或真实请求参数。

小程序旧接口模式

旧小程序通过 app.globalData.baseUrl + path 拼接接口。旧 baseUrl 已确认不是正式域名,正式迁移必须统一为:

https://api.txyundm.cn/app-api
类别 旧路径线索 新系统迁移方向
用户/登录 登录、手机号、用户资料、token 存储 M02/M08 统一微信登录、手机号授权、角色识别和 token 刷新。
门店/房间 门店列表、房间列表、房间详情、地图定位 M03/M08 提供租户隔离的门店、房间、营业时间和价格查询。
订单 创建订单、订单列表、订单详情、取消、换房、续费 M04/M08 实现时间段锁定、订单状态机、续费/取消/换房。
支付/资金 支付、余额、充值、套餐、支付订单 M04/M05 接入微信支付、余额、套餐和资金流水;缺商户资料时做 Mock。
团购/优惠 团购、优惠券、抽奖、活动 M05/M10 建模优惠券、团购验券和活动配置。
保洁 保洁任务、任务详情、任务统计、任务结算 M07/M08 实现保洁角色、抢单/完成/驳回和结算。
设备/开门 门锁、网关、设备列表、开门提交、Wi-Fi 配置 M06/M08 接入 MQTT 设备适配器,开门权限必须绑定有效订单。
后台管理小程序入口 管理员、门店管理、房间管理、模板、推送规则 M08/M09 明确小程序管理端与 Web 后台的权限边界。
库存/商品 库存商品、出入库、商品分类、商品订单 后续运营功能,不进入第一阶段核心闭环。
外部平台 美团预订、易达取消、第三方支付桥 外部授权缺失时标记 BLOCKED_EXTERNAL,保留适配器和 Mock。

后台静态包接口线索

参考/后台管理系统_20260427.zip 为构建产物,静态 JS 中可见后台 API、字典和权限命名痕迹,但不得作为正式源码。后续 M09 只参考:

  • 菜单结构和页面覆盖范围。
  • 字典枚举名称。
  • 管理端列表/表单字段。
  • API 前缀迁移到 https://api.txyundm.cn/admin-api

禁止事项

  • 禁止把旧 baseUrl、localhost、IP、旧域名写入正式代码。
  • 禁止复用旧 AppID、AppSecret、支付密钥、证书路径和真实商户号。
  • 禁止直接复制构建产物作为 Vue3 后台源码。
  • 禁止让小程序绕过微信合法域名验证。