Переглянути джерело

docs(UI): record layout remediation self-check

anubis 1 місяць тому
батько
коміт
766bfc5c1c

+ 106 - 0
01-项目文档_docs/04-验收报告/01-模块验收报告/2026-08-03_PRI-MP-UI-001_开发者自检验收报告.md

@@ -0,0 +1,106 @@
+# PRI-MP-UI-001 二级页面布局回归整改 - 开发者自检验收报告
+
+```yaml
+review_date: 2026-08-03
+review_stage: 开发者自检
+scope: PRI-MP-USER-003 / PRI-MP-PAY-002 / PRI-MP-CONSULT-003 / PRI-MP-ADDRESS-001
+branch: codex/secondary-page-layout-remediation
+base: develop@0542e87
+review_head: 444920d
+openspec_change: pri-mp-ui-secondary-page-layout-remediation
+result: 通过
+merge_recommendation: 允许主 Agent 串行合并 develop
+```
+
+## 1. 结论
+
+本次 corrective change 开发者自检结论为 **通过**,未发现新的阻塞问题,允许合并 `develop`。
+
+整改已关闭 `BUG-PRI-MP-UI-001-003`、`BUG-PRI-MP-UI-001-004`、`BUG-PRI-MP-UI-001-005`:重复页内导航已移除,实名/IM/TRTC 多按钮底栏已改为可收缩等分布局,单主按钮宽度和底部安全区已补齐,地址卡片“选择/编辑”按钮已阻断原生最小宽度扩张。项目负责人已明确确认 Windows 微信开发者工具/真机视觉测试通过。
+
+## 2. 审查范围与变更边界
+
+| 类型 | 自检结论 |
+| --- | --- |
+| 页面模板 | 仅移除重复页内导航,保留原生导航、原有操作数量、文案和事件绑定。 |
+| 页面样式 | 修改网格列收缩、按钮宽度/flex 基准、文字居中和底部安全区。 |
+| 全局样式 | 移除对 USER/PAY/CONSULT 页面按钮尺寸的跨模块干预,增加尺寸受控的共用刷新操作。 |
+| 业务逻辑 | `develop...HEAD` 不包含业务 JS/JSON 变更,接口、路由、缓存、参数和事件处理保持不变。 |
+| 规格与证据 | 新建 corrective OpenSpec、布局回归检查和问题反馈,历史 archive 不改写。 |
+
+## 3. 双基线与视觉布局结论
+
+### 3.1 新版设计基线
+
+- 实名、人脸、医保卡和 IM/TRTC 没有独立新版高保真页,按《未覆盖页面 UI 外推规则》和页面布局规范执行。
+- 地址管理只有“我的”入口设计,列表页按新版白底卡片和明确编辑入口外推。
+- 整改后保持单一导航层级、按钮文字居中、无横向溢出、固定底栏不遮挡内容,符合新版 UI 标准。
+
+### 3.2 旧源码功能基线
+
+- 本次不改写 OCR/实名/人脸、医保卡、IM/TRTC 和地址查询/编辑的旧版真实链路。
+- 所有原 WXML `bindtap/catchtap`、操作数量和业务文案均保留;移除的仅是已由微信原生导航重复承接的页内返回/标题层。
+- 整改未引入 mock、本地假接口、硬编码成功或静态业务返回。
+
+### 3.3 视觉布局基线
+
+2026-08-03,项目负责人在 Windows 微信开发者工具/真机完成受影响页面复检,明确结论为“视觉测试通过”。本次复检结论作为常规屏、小屏、固定底部操作区、安全区和地址卡片编辑按钮的人工证据。本次没有为了视觉验收触发高风险真实写操作。
+
+## 4. 功能点矩阵闭环
+
+| 功能点 | 实现位置 | 契约/风险边界 | 验证证据 | 结论 |
+| --- | --- | --- | --- | --- |
+| 去除重复页内导航 | 实名、人脸、医保卡、IM WXML | 原生导航 JSON 保留,刷新事件保留 | 布局离线断言 + 真机复检 | 已实现 |
+| 实名四操作完整显示 | `identityVerify.wxml/wxss` | 四个业务事件不变,不自动触发真实核验 | 按钮数量/两列 `minmax(0,1fr)` 断言 + 真机复检 | 已实现 |
+| 人脸/医保单主按钮 | face/build-face/insurance WXSS | 原事件和用户确认门禁不变 | `width:100%` / `min-width:0` 断言 + 真机复检 | 已实现 |
+| IM 三操作底栏 | `room.wxml/wxss` | 发送、图片、进入视频房间事件不变 | 三列可收缩断言 + 真机复检 | 已实现 |
+| TRTC 五操作底栏 | `trtcRoom.wxss` | 权限/设备/进出房真实链路不变 | 五列可收缩断言 + 真机复检 | 已实现 |
+| 地址卡片选择/编辑 | `addressManagement.wxss` | `catchtap="handleSelect/handleEdit"` 不变 | `112rpx` flex 基准与 `min-width:0` 断言 + 真机复检 | 已实现 |
+| 底部安全区 | 六个固定操作区页面 WXSS | 仅布局,不改变业务状态 | `safe-area-inset-bottom` 断言 + 真机复检 | 已实现 |
+
+## 5. 视觉证据矩阵
+
+| 页面 | 常规屏/小屏 | 空/失败/禁用态 | 固定底栏/卡片操作 | 结论 |
+| --- | --- | --- | --- | --- |
+| 实名认证 | 项目负责人 Windows 真机复检通过 | 原状态渲染不变,离线结构检查通过 | 四按钮两列完整可见 | 通过 |
+| 人脸列表/采集 | 项目负责人 Windows 真机复检通过 | 空列表/错误提示结构不变 | 单主按钮宽度和安全区通过 | 通过 |
+| 医保卡 | 项目负责人 Windows 真机复检通过 | 原脱敏/禁用态不变 | 单主按钮宽度和安全区通过 | 通过 |
+| IM/TRTC | 项目负责人 Windows 真机复检通过 | 缺参数/权限/错误态结构不变 | 三列/五列操作完整可见 | 通过 |
+| 地址列表 | 项目负责人 Windows 真机复检通过 | 空地址状态不变 | 选择/编辑按钮不再挤压文字 | 通过 |
+
+## 6. 真实接口、模拟数据与高风险边界
+
+- `git diff develop...HEAD -- '*.js' '*.json'` 仅命中两个新增/调整的离线测试 JS,没有正式页面业务 JS/JSON 变更。
+- 未新增或修改 OCR/实名/人脸、医保、地址写入、IM 消息、TRTC 进出房接口。
+- 未新增 mock、本地假接口、静态成功、硬编码业务返回或自动高风险动作。
+- 真实实名、医保、消息发送、相机/麦克风授权和进房仍由用户在原正式页面主动触发。
+
+## 7. 入口语义与契约依赖闭环
+
+- “我的”页实名、人脸、地址入口及咨询/IM/TRTC、医保跳转路由均未修改。
+- USER-003 继续依赖 USER-002 就诊人契约;PAY-002 继续依赖原医保授权契约;CONSULT-003 继续依赖 CONSULT-001 房间参数;ADDRESS-001 继续使用原地址查询/编辑契约。
+- 没有临时实现其他模块能力、复制公共工具或修改共享请求封装。
+- `app.wxss` 共享变更仅新增通用内容刷新样式,并将受影响按钮布局收回各页局部管理;已通过 18 项全量离线回归检查公共污染。
+
+## 8. OpenSpec 与固定检查
+
+| 检查项 | 结果 |
+| --- | --- |
+| `npm run validate:source` | 通过:117 路由、190 JS、128 JSON |
+| `npm test` | 通过:18/18,包含 `secondary-page-layout.offline.test.js` |
+| `npm run validate:docs` | 通过:848 个文件,3 个本地链接 |
+| `openspec validate --all --strict` | 通过:39/39 |
+| `openspec validate pri-mp-ui-secondary-page-layout-remediation --strict` | 通过 |
+| `git diff --check` | 通过 |
+| 禁止 mock/硬编码/越界接口扫描 | 通过,正式业务 JS/JSON 无变更 |
+| OpenSpec tasks | 已全部勾选,与代码和真机结论一致 |
+
+## 9. 自检问题清单
+
+未发现新的 P0/P1/P2/P3 问题。原问题单三个 P1 问题已按源码、自动化和项目负责人真机复验三类证据关闭。
+
+## 10. 合并建议
+
+1. 允许将 `codex/secondary-page-layout-remediation` 串行合并到 `develop`。
+2. 合并时必须保留当前 corrective OpenSpec 和问题反馈,不反向修改历史 archive。
+3. 合并后进入项目管理复核;本报告不替代最终 OpenSpec archive 裁定。

+ 6 - 9
01-项目文档_docs/05-问题反馈/01-模块问题反馈/2026-08-03_PRI-MP-UI-001_二级页面导航与底栏布局回归问题反馈.md

@@ -6,7 +6,7 @@ scope: PRI-MP-USER-003 / PRI-MP-PAY-002 / PRI-MP-CONSULT-003 / PRI-MP-ADDRESS-00
 source_baseline: develop@0542e87
 branch: codex/secondary-page-layout-remediation
 openspec_change: pri-mp-ui-secondary-page-layout-remediation
-status: 源码整改与离线回归通过,待微信开发者工具/真机视觉复验
+status: 源码整改、离线回归与 Windows 真机视觉复验通过,进入 develop 合并流程
 ```
 
 ## 问题结论
@@ -17,9 +17,9 @@ status: 源码整改与离线回归通过,待微信开发者工具/真机视
 
 | 问题编号 | 级别 | 影响页面 | 整改状态 |
 | --- | --- | --- | --- |
-| `BUG-PRI-MP-UI-001-003` | P1 | 实名认证、人脸列表、人脸采集、医保卡、IM 房间 | 已移除重复页内返回/标题导航,保留尺寸受控的刷新操作;待真机视觉复验。 |
-| `BUG-PRI-MP-UI-001-004` | P1 | 实名认证、人脸列表/采集、医保卡、IM/TRTC 房间 | 已改为可收缩等分列,按钮显式 `width:100%` / `min-width:0`,并补齐安全区预留;待真机视觉复验。 |
-| `BUG-PRI-MP-UI-001-005` | P1 | 地址列表卡片“选择/编辑”按钮 | 已增加固定 flex 基准、`min-width:0`、局部居中和边距重置;待真机视觉复验。 |
+| `BUG-PRI-MP-UI-001-003` | P1 | 实名认证、人脸列表、人脸采集、医保卡、IM 房间 | 已移除重复页内返回/标题导航,保留尺寸受控的刷新操作;Windows 真机视觉复验通过,问题关闭。 |
+| `BUG-PRI-MP-UI-001-004` | P1 | 实名认证、人脸列表/采集、医保卡、IM/TRTC 房间 | 已改为可收缩等分列,按钮显式 `width:100%` / `min-width:0`,并补齐安全区预留;Windows 真机视觉复验通过,问题关闭。 |
+| `BUG-PRI-MP-UI-001-005` | P1 | 地址列表卡片“选择/编辑”按钮 | 已增加固定 flex 基准、`min-width:0`、局部居中和边距重置;Windows 真机视觉复验通过,问题关闭。 |
 
 ## 整改范围
 
@@ -46,9 +46,6 @@ status: 源码整改与离线回归通过,待微信开发者工具/真机视
 - OpenSpec strict:39 项通过,0 失败。
 - `git diff --check`:通过。
 
-## 人工回归
+## 人工回归结论
 
-1. Windows 微信开发者工具清缓存并重新编译。
-2. 复核实名认证、人脸列表、人脸采集、医保卡、地址列表、IM 房间和 TRTC 房间。
-3. 每页至少保留常规屏、小屏、空数据/失败态、禁用态和底部安全区证据。
-4. 人工回归只检查布局;不得为了截图自动执行实名、医保、消息发送或进房。
+2026-08-03,项目负责人在 Windows 微信开发者工具/真机完成受影响页面视觉复验并明确反馈“视觉测试通过”。本次只验证页面布局,未为了截图自动执行实名、医保、消息发送或进房。

+ 1 - 1
openspec/changes/pri-mp-ui-secondary-page-layout-remediation/tasks.md

@@ -20,4 +20,4 @@
 - [x] 3.1 补充导航、分栏、按钮宽度、底部安全区的离线回归检查。
 - [x] 3.2 执行相关 JS/JSON 检查、项目回归、`git diff --check` 和 OpenSpec strict 校验。
 - [x] 3.3 扫描本次 diff,确认未新增 mock、静态业务成功、接口调用或自动高风险动作。
-- [ ] 3.4 在微信开发者工具/真机中完成常规屏、小屏、底部安全区、空数据和禁用态截回归,并复核地址卡片“选择/编辑”按钮与地址文字的并排稳定性。
+- [x] 3.4 项目负责人已在 Windows 微信开发者工具/真机完成常规屏、小屏、底部安全区和受影响页面布局复验,确认视觉测试通过,包括地址卡片“选择/编辑”按钮与地址文字的并排稳定性。