prop-ai-hr/docs/UI_REGRESSION_FIGMA_20260717.md

生产 H5 UI 回归与 Figma 识图对比报告（2026-07-17，最终复验）

1. 结论

本轮使用同一项目的 1 名一线员工（PILOT-03）和 1 名项目主管（PILOT-01）登录生产 H5，完成员工端 10 个页面/状态、主管端 8 个页面/状态的真实浏览器截图。每张生产截图生成后均读取对应 Figma 正式画板并进行识图比较。

最终结论：本报告列出的 P0、P1 和设计覆盖问题均已关闭，生产 H5 高保真 UI 回归验收通过。

通过口径包括：

• 页面结构、信息层级、主操作、底部安全区、字体、空状态和隐私展示符合对应 Figma 设计意图。
• 训练、SOP 反馈和主管专项指派均通过真实业务写入验证，不是静态页面演示。
• 真实组织数据、动态文案长度、评分数量和无音频记录与 Figma 示例数据不同，不要求逐字或逐像素一致。
• 本结论是本轮 UI 与交互回归通过，不替代正式试点窗口、短信 OTP、业务 KPI 等生产试点验收。

2. 测试范围与证据

• 生产入口：https://peilian.njzhmj.top/h5/
• 浏览器视口：员工端 400×886，主管端 400×927
• 测试身份：报告仅记录测试编号，不保存或展示完整手机号
• Figma 文件：30hFiKtieGYraOZvJPJcPd
• 生产证据目录：.data/private/ui-regression-20260717-fixed/
• 隐私说明：证据目录被 Git 忽略，包含真实组织数据，不上传公开工单或外部图床
• 最终前端提交：b3dd2c2c
• 核心修复提交：e93421ca、0745d51e、5d82ff7b、b3dd2c2c

本轮真实写入：

1. 员工完成 1 次“客服应对投诉”训练，生成 71 分结果和主管待复盘记录。
2. 员工提交 1 次 SOP“没解决”结构化反馈，原因为 not_specific，补充说明长度 21，数据库状态为“待复核”。
3. 主管给该员工新增 1 个专项训练，目标、任务要求、截止时间和指派原因均真实落库；状态为“待训练”，截止时间为 2026-07-17 23:59:59。

3. 关键门槛复验

验收门槛	生产实测	结论
训练结束自动回到结果顶部	scrollY=0，首屏同时出现总分和 5 项维度分	通过
SOP 生成后进入回答区	scrollY=677，.answer-panel 距视口顶部约 16px	通过
团队画像禁止一次渲染 2316 人	总数 2316，首屏 DOM 仅 20 个 .team-row，页面高度 2677px	通过
点击成员后立即显示能力详情	详情面板 1 个，列表行 0 个，scrollY=0	通过
员工/主管页面不得出现完整手机号	两个个人页完整手机号匹配数均为 0	通过
SOP 负反馈必须可诊断	原因多选、补充说明、提交按钮和数据库字段均有效	通过
主管指派契约必须真实落库	截止时间、目标、要求、原因和进度页均可读	通过
主按钮不得被底部导航遮挡	训练提交、SOP 反馈提交、专项确认按钮均完整位于安全区上方	通过

4. 员工端逐页识图结果

页面/状态	生产截图	Figma 节点与截图	复验结论
今日	employee-today.png	23:3 / figma-employee-today.png	师傅 Hero、问答卡、今日安排和我的地图均进入首屏；信息密度与底栏安全区通过。
训练前预习	employee-practice-prep.png	53:2 / figma-employee-practice-prep.png	场景、角色、要点、红线、话术和主按钮顺序一致；字体已统一。
场景对练	employee-practice-active.png	54:2 / figma-employee-practice-active.png	情绪/信任、对话上下文、回复区、求助和主操作层级清楚；主按钮不再被底栏遮挡。
训练结果	employee-practice-result.png	55:2 / figma-employee-practice-result.png	首屏直接显示 71 分、5 项维度和导师建议；旧版滚动位置残留问题关闭。
问师傅答案	employee-sop-result-fixed.png	79:11 / figma-employee-sop-result-fixed.png	结果生成后自动定位到“师傅回答”正文，旧版停留输入区问题关闭。
SOP 负反馈	employee-sop-feedback.png、employee-sop-feedback-submit.png	79:674 / figma-employee-sop-feedback-fixed.png	5 类原因、多选、补充说明和提交操作完整；真实写入已核对。
我的成长	employee-profile.png	178:959 / figma-employee-profile.png	手机号脱敏、岗位切换、成长摘要、训练历史与证据入口完整。
训练历史详情	employee-history-detail.png	56:2 / figma-employee-history-detail.png	已改为训练摘要、维度分、录音/逐句复盘、SOP 与行动建议分层；文本训练无音频时不伪造播放器。
案例素材空状态	employee-cases.png	178:958 / figma-employee-cases-status.png	权限说明和“暂无可学习案例”空状态有正式画板，设计覆盖问题关闭。
学习中心	employee-learning.png	178:2 / figma-employee-learning.png	今日任务、错题本和岗前任务使用独立学习首页画板，旧版与案例详情错配问题关闭。

5. 主管端逐页识图结果

页面/状态	生产截图	Figma 节点与截图	复验结论
主管今日工作台	supervisor-home.png	57:2 / figma-supervisor-home.png	概览、低分预警、待复盘和最近训练趋势同屏可见；信息密度通过。
待复盘列表	supervisor-reviews.png	58:2 / figma-supervisor-reviews.png	“全部/连续低分/待复盘”筛选和低分优先语义均存在。
主管复盘详情	supervisor-review-detail.png	59:2 / figma-supervisor-review-detail.png	摘要、维度、录音/逐句复盘、建议和行动按层级展示；文本记录不伪造音频。
团队画像列表	supervisor-team-list.png	列表功能态；详情设计见 61:2	搜索、20 人分页和风险排序有效，旧版 2316 行全量渲染问题关闭。
员工能力详情	supervisor-team-detail.png	61:2 / figma-supervisor-team-detail.png	点击搜索结果后立即切换为独立详情视图；趋势、成长证据和派发入口完整。
训练任务派发	supervisor-assign.png、supervisor-assign-filled.png	61:530 / figma-supervisor-assign.png	员工搜索、场景检索、目标、要求、截止时间、原因和安全区主按钮均有效。
派发进度与预警	supervisor-assign-progress.png	62:2 / figma-supervisor-assign-progress.png	与新建表单拆为独立视图；进度条、来源、截止/逾期和预警信息可读。
我的主管工作台	supervisor-profile-fixed.png	178:960 / figma-supervisor-profile.png	真实显示 2316 名成员、2 条待复盘、2 条风险预警和 3 个业务入口；手机号脱敏且大面积空白问题关闭。

6. Figma 与实现同步

本轮补齐并复验 4 个此前缺失的正式画板：

• 178:958：员工端案例权限/空状态
• 178:2：员工端学习首页
• 178:959：员工端我的成长
• 178:960：主管端我的工作台

设计文件和 H5 统一使用 LXGW WenKai TC，代码端保留系统字体降级链；字体许可证随 H5 产物发布。

7. 工程与生产验证

• vue-tsc --noEmit：通过。
• 移动端单测：68/68 通过。
• H5 正式构建：通过。
• 管理端正式构建：通过。
• 后端 AIHR 全量 Maven 测试：通过。
• 后端生产 JAR 构建：通过。
• 数据库迁移验证：通过，生产 schema 预检 16/16。
• 远端资源：管理端和移动端入口/主资源 SHA-256 与本地产物一致。
• 后端：服务 active，公开移动端接口返回 200；已部署业务模块哈希与发布产物一致。

构建过程中仅出现第三方 Sass 旧 API 弃用提示，不影响本轮功能和 UI 验收；后续可单独作为依赖升级技术债处理。

8. 最终判定

高保真 UI 回归验收：通过。

后续若进入正式试点，仍需按正式窗口、唯一在职组织身份、正式短信 OTP、训练次数和业务 KPI 独立验收，不得用本报告替代试点验收结论。