chore(M00-A): 建立单仓库基线和参考清单

2026-06-15 15:34:50 +08:00
commit 28613b2093
62 changed files with 5830 additions and 0 deletions
@@ -0,0 +1,41 @@
+# 参考接口线索
+
+> 本文档只记录接口路径类别和迁移方向，不记录旧域名、AppID、Token、密钥或真实请求参数。
+
+## 小程序旧接口模式
+
+旧小程序通过 `app.globalData.baseUrl + path` 拼接接口。旧 `baseUrl` 已确认不是正式域名，正式迁移必须统一为：
+
+```text
+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 后台源码。
+- 禁止让小程序绕过微信合法域名验证。
+