58 lines
5.3 KiB
Markdown
58 lines
5.3 KiB
Markdown
# 第 1 批 H5 对接实施与验证记录
|
||
|
||
2026-10-13：客户端功能已实现。仅对接 `/api/c/v1`；不处理代理注册、密码规则和后台接口。真实微信授权、短信绑定及后端 A/B 资产通知范围尚需测试环境联调，未部署或提交代码。
|
||
|
||
## 已实现
|
||
|
||
- 客户手机号、资产是否绑号、号码归属、绑定提示分别保存；登录字段按当前令牌和资产隔离，退出/过期/切换时清理，旧 phoneBindStatus 不再作为权威状态。
|
||
- 四种绑定模式使用原 bind-phone 入参；资产首次绑号可输入与客户号不同的号码，1192 提示管理员并禁用当前提交，1184 保留后端错误。按用户最新确认，强制绑定成功保留有效 token 和资产标识，直接进入首页，不再要求重登。
|
||
- 客户换号只更新后端确认的客户号码，不改资产关联；归属事实失效，下一次真实登录重新确认。换号的原号来源不再放进 URL。
|
||
- asset/info 的共享返回入口接收一次性临期提醒，首页按最新要求使用居中、可关闭弹窗，已移除旧横幅组件。0 天正常显示，使用服务器等级和上海时区；与风险换货/运营候选、普通通知依次展示。绑定页预填收到的提醒留在当前会话，进入首页展示。
|
||
- 旧首页通知弹窗排除临期项，通知中心保留。全部已读改 POST，单条已读保持 PUT；成功后重新读取列表和计数，失败不乐观清空，延迟响应不能覆盖新的资产上下文。
|
||
- 通知卡片移除左侧未读强调边框和小圆点，标题右侧显示“未读/已读”小按钮。点击卡片或按钮成功标记后更新，失败仍显示未读。
|
||
|
||
## 验证证据
|
||
|
||
| 证据 | 结果 | 说明 |
|
||
|---|---|---|
|
||
| `npm run test:h5-integration` | 17/17 通过 | 实际 store/API 模块及页面 setup，使用 Vue 响应性；原生 API、生命周期和后端响应为模拟 |
|
||
| `npm run build:h5` | 通过 | uni-app H5 开发配置构建 |
|
||
| `npm run build:h5:production` | 通过 | uni-app H5 生产配置构建 |
|
||
| `openspec validate update-october-batch1-h5-integration --strict` | 通过 | 提案、需求和场景结构校验 |
|
||
| `git diff --check` | 通过 | 默认 Git 换行配置下未发现补丁空白错误；Windows 换行提示不影响构建 |
|
||
| 本地浏览器，390×844 / 320×640 | 通过 | 居中临期弹窗、0 天/上海时间、关闭、通知标题右侧未读按钮、点击卡片变已读；此前绑定表单及 1192 检查保留，无页面运行错误 |
|
||
|
||
测试文件：[tests/october-h5.test.mjs](../../../tests/october-h5.test.mjs)。覆盖绑定模式/成功后的分类更新、登录提示开关、状态持久化/隔离、换号不迁移资产、1192/1184、强制绑定直接进入首页且 token/客户信息/提醒保留、预填失败、共享接收/并发、0～15 天/上海边界、旧弹窗过滤、POST/PUT 请求方法、通知失败与切换、模拟 A/B 全部已读以及 401 状态清理。
|
||
|
||
本次修订删除了绑定成功后的登录态清理和“绑定手机号成功，请重新登录”提示，替代旧手动重登提案；真正的退出或 401 登录过期处理不变。
|
||
|
||
最新界面修订：`ExpiryReminderPopup.vue` 替代横幅；候选请求结束后才消费临期弹窗，普通通知显示时收到临期提醒会排队。候选组件卸载后的延迟响应不再影响新页面。`notifications.vue` 标题右侧使用阅读状态按钮，原标记接口不变。
|
||
|
||
本地渲染复验：先完成生产构建，再运行以下命令。使用独立浏览器会话和虚构号码，所有业务接口改写到本地模拟服务。
|
||
|
||
```powershell
|
||
node tests/mock-h5-preview.mjs
|
||
```
|
||
|
||
另开一个终端：
|
||
|
||
```powershell
|
||
agent-browser --session october-h5-ui --headed false --init-script ./tests/mock-h5-browser-init.js open http://127.0.0.1:48138/pages/index/index
|
||
agent-browser --session october-h5-ui set viewport 390 844
|
||
agent-browser --session october-h5-ui snapshot -i
|
||
agent-browser --session october-h5-ui close
|
||
```
|
||
|
||
模拟服务固定在 `127.0.0.1:48138`，init 脚本仅在该地址注入；检查后使用 Ctrl+C 停止服务。该模拟接口故意重复返回提醒用于检查前端防重复，不能证明后端每日一次规则。
|
||
|
||
需要复验通知按钮时，在启动服务的终端先设置 `$env:H5_MOCK_NOTIFICATIONS='1'`；进入首页关闭临期弹窗，再点击站内通知。模拟通知初始为未读，点击卡片后服务端模拟状态变已读。
|
||
|
||
## 仍需真实联调
|
||
|
||
1. 微信公众号真实登录应返回三个布尔字段；尤其验证客户无号/资产有号时只给客户绑定，以及客户已有号时资产可绑定不同号码。
|
||
2. 确认 asset/info.bound_phone 仍表示当前客户手机号，与登录布尔事实区分；换号后资产号码保持原值。若实际响应与对接文档冲突，先确认契约，不猜测接口。
|
||
3. 同客户 A/B 两个临期资产分别扫码进入，确认服务器每天只返回一次、临期列表/未读数仅计当前资产，以及 A 上 POST 全部已读不改变 B 的临期通知。
|
||
4. 完整回归真实支付、实名认证、套餐订购以及运营/风险换货候选弹窗。本次没有修改这些接口或候选组件，构建成功不替代真实业务验收。
|
||
|
||
完成结果已按实际验证范围回写 [tasks.md](tasks.md)，真实联调项保留未勾选；不归档历史提案。
|