admin/prop-ai-hr
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: sync production release truth

Browse Source
This commit is contained in:
admin
2026-07-18 01:30:13 +08:00
parent 32fa376d63
commit 267bb3525f
14 changed files with 247 additions and 932 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/FIGMA需求覆盖与版本偏差审计-20260717.md
+36 -28
View File
@@ -1,5 +1,7 @@
# Figma 需求覆盖与版本偏差审计
> 生产状态更新（2026-07-18）：本文记录的 Figma 修复、代码恢复和新增学习能力已随 `32fa376d` 发布。管理端/H5/后端产物、21 个迁移、目标 schema 与关键生产页面已经验证；正式 OTP 写链路、真实手机权限、外部模型和严格试点仍未验收。文中带日期的“本轮未发布”仅描述当时批次，不再代表当前现网。
> 日期：2026-07-17
> Figma 文件：[银城员工端与个人 AI 助理设计](https://www.figma.com/design/30hFiKtieGYraOZvJPJcPd)
> 对照范围：历史可运行移动端 `mobile/`、已确认业务文档、Figma 实际画板、当前权威工程 `mobile-uni/`。
@@ -31,31 +33,31 @@ Figma 当前存在五类风险：
| `54:2` 正式语音对练 | 有“按住说话”和切换文字输入，包含情绪/信任、SOP 求助、红线和风格重生成 | 训练语音设计较完整，但不能代替问师傅、题目、点评等其他页面的语音覆盖 |
| `61:530` 主管训练任务派发 | 明确显示 3 名员工、多选删除、训练类型、专项包、截止时间、任务目标和“确认派发给 3 人” | 多人派发和截止时间已经是明确 Figma 要求；当前实现只有单人、场景和原因 |
| `79:11` SOP 回答结果 | 有问题、结论、三步操作、可用话术、引用、视频、有帮助/没解决/收藏 | 对应画板没有回答播报、总结卡播报和下载图片控件；只照此画板会遗漏历史语音优势和新增下载要求 |
| `95:6` 开放问题榜 | 有“今天遇到什么难题了”“有奖征问题”、热门/待回答/有悬赏/我参与的和奖励规则 | 设计本身完整，但业务总纲明确属于阶段二；不能因为 Figma 已画就算当前阶段缺陷 |
| `95:6` 开放问题榜 | 有“今天遇到什么难题了”“有奖征问题”、热门/待回答/有悬赏/我参与的和奖励规则 | 原属阶段二，不能仅因 Figma 已画就算阶段一缺陷；2026-07-17 客户明确要求一并实现后，已作为批准的范围例外开发并发布 |
还有两处文件内部口径冲突：
- `FIGMA_DESIGN_INVENTORY.md` 顶部仍把员工端“问”和“我”标记为 `[-]`，说明业务状态不完整；同一文件后部却写“设计冻结完成”。
- `FIGMA_IMPLEMENTATION_MATRIX.md` 曾把训练任务派发行标为“已实现”，当时 `mobile-uni/src/pages/supervisor/assign/index.vue` 只有单员工选择、没有截止时间。2026-07-17 晚间已补多人、截止快捷项和批量接口，矩阵已改为记录本地验证事实，仍不等同于生产发布。
- `FIGMA_IMPLEMENTATION_MATRIX.md` 曾把训练任务派发行标为“已实现”，当时 `mobile-uni/src/pages/supervisor/assign/index.vue` 只有单员工选择、没有截止时间。2026-07-17 晚间补齐多人、截止快捷项和批量接口，2026-07-18 已随当前版本发布；生产正式团队仍待验收。
## 3. 四方功能对照
| 功能 | 历史可运行版/文档要求 | Figma 表达 | 当前实现 | 客观结论与动作 |
|---|---|---|---|---|
| 问师傅语音输入 | 旧 `mobile/src/App.vue` 有语音录制/选择音频并转写；产品方案也明确“语音提问” | 首页 `23:3` 明确写“语音提问”，但未形成完整提问、转写、失败和重试状态画板 | 本地已恢复录音、转写、选择音频兜底，继续复用 `speech.ts` 与 `/api/ai/asr` | **确认回退已在代码恢复，未发布**：Figma 仍需补录音、识别、失败和文件兜底状态 |
| SOP 回答播报 | 旧版有“听一遍” | `79:11` 无播报控件 | 本地已补回答播报，未证明线上已发布 | **Figma 遗漏、代码本地恢复**：先保留功能，再补设计，不得为了贴图删掉 |
| 总结卡播报 | 旧版有总结卡 TTS；总纲写“语音播报（能力已有）” | 对应清单/画板未体现完整播报状态 | 本地已补总结卡播报 | **Figma 遗漏、代码本地恢复**：补播放/停止/生成失败状态 |
| 总结卡下载图片 | 旧版无充分证据；本轮客户新增 | Figma 未体现下载控件 | 本地已补 PNG 下载，无聊天模型时按真实 SOP 原文降级生成；浏览器已触发下载成功提示 | **新增需求已本地实现，未发布**：仍需补 iOS/Android H5 下载状态设计与真机验收 |
| 全局字号调节 | 未找到旧版开关；客户为老年员工新增明确要求 | `4:16` 已修为标准/大字/超大字三张同构画板 | 本地已实现全局三档、持久化与响应式自增高；400×900 已逐档截图复核 | **新增无障碍需求已本地实现并视觉验证，未发布**：继续做真机触控、键盘和读屏验收 |
| 主管多人派发 | 未证明旧版可运行；客户本轮再次明确 | `61:530` 明确选择 3 人并批量确认 | 本地已支持姓名多选、最多 100 人、逐人结果、幂等请求与失败隔离；真实提交 2/2 成功 | **Figma 需求已本地实现，未发布**：生产继续验证大团队权限与超时重试 |
| 截止时间/快捷日期 | 历史计划要求训练任务有截止时间；客户细化为今天/明天/3天/7天 | `61:530` 有精确截止时间，没有快捷日期控件 | 本地已增加 `dueDate` 及当天/明天/3天/7天快捷项，并在逐人结果显示到期日 | **部分被 Figma 覆盖的需求已本地实现，未发布**：补设计状态并复验时区边界 |
| 每日题每日变化/专项不重复 | 文档要求覆盖岗位常见场景和动态训练 | Figma 主要画页面结果，没有内容版本、日期派发、去重和降级规则 | 本地每日题已扩为 7 组 21 题，按日期、岗位和员工身份轮换，同日稳定、相邻日不重复 | **非视觉型缺口已完成第一阶段修复，未发布**：继续扩正式岗位题库和内容版本审计 |
| 生成题目、AI 回复、点评播报 | 语音优先原则支持；不能证明旧版全部覆盖 | 对应画板没有形成全链路播报覆盖表 | 本地已覆盖每日题、AI 回复、点评、参考答案、训练结果与候选面试；无 TTS 模型时 H5 已验证设备语音降级 | **需求覆盖已在代码补齐，未发布**：Figma 仍需形成内容类型/播放状态矩阵 |
| 主管切换学习端 | 客户明确主管也要学习；历史目标支持角色兼任 | Figma 分别画员工端和主管端，没有双模式切换入口及权限说明 | 本地已实现“工作台/学习端”双向切换，显示模式变化但组织角色保持主管；已用主管登录态验证 | **代码已本地实现，Figma 仍未覆盖，未发布**：补入口、返回路径与权限说明画板 |
| 岗位差异化内容 | 总纲要求岗位→SOP→场景→学习内容映射 | Figma 有多个岗位/角色页面，但没有展示内容分发规则和岗位覆盖表 | 当前主要仍围绕生活顾问 | **功能规则缺口，P1**：用岗位内容矩阵验收，不用“页面不同”代替“内容不同” |
| 问 AI（全网） | 旧版无；会议基线是企业内部知识 | 本轮检查的设计索引和相关问答画板未见独立外部 AI 入口、来源和免责声明 | 当前无全网检索 | **新增范围**：单独立项，与问师傅分入口、分数据外发、分引用和免责声明 |
| 图片/视频提问 | 历史文档列为新增/后置情境能力 | `79:11` 有回答侧视频内容，但没有提问附件上传流程 | 本地已补本次查询的图片/视频附件分析 | **设计与实现顺序倒置**：先补权限、PII 外发、大小/失败状态设计，再决定是否发布 |
| 开放问题榜/有奖问答 | 总纲明确阶段二，阶段一只积累 `knowledge_gap` | `95:6` 等画板已完整设计 | 当前没有业务闭环 | **不是当前版本误删**：保留为阶段二，不得因“Figma 已完成”提前宣称上线或拉入 P0 |
| 问师傅语音输入 | 旧 `mobile/src/App.vue` 有语音录制/选择音频并转写；产品方案也明确“语音提问” | 首页 `23:3` 明确写“语音提问”，但未形成完整提问、转写、失败和重试状态画板 | 已恢复录音、转写、选择音频兜底，继续复用 `speech.ts` 与 `/api/ai/asr` | **确认回退已恢复并部署**：Figma 仍需补录音、识别、失败和文件兜底状态；真机权限待验收 |
| SOP 回答播报 | 旧版有“听一遍” | `79:11` 无播报控件 | 已补回答播报并发布 | **Figma 遗漏、代码已恢复**：保留功能并补设计，不得为了贴图删掉 |
| 总结卡播报 | 旧版有总结卡 TTS；总纲写“语音播报（能力已有）” | 对应清单/画板未体现完整播报状态 | 已补总结卡播报并发布 | **Figma 遗漏、代码已恢复**：补播放/停止/生成失败状态 |
| 总结卡下载图片 | 旧版无充分证据；本轮客户新增 | Figma 未体现下载控件 | 已补 PNG 下载，无聊天模型时按真实 SOP 原文降级生成；浏览器已触发下载成功提示 | **已实现并部署**：仍需补 iOS/Android H5 下载状态设计与真机验收 |
| 全局字号调节 | 未找到旧版开关；客户为老年员工新增明确要求 | `4:16` 已修为标准/大字/超大字三张同构画板 | 已实现全局三档、持久化与响应式自增高；400×900 已逐档截图复核 | **已实现、视觉验证并部署**：继续做真机触控、键盘和读屏验收 |
| 主管多人派发 | 未证明旧版可运行；客户本轮再次明确 | `61:530` 明确选择 3 人并批量确认 | 已支持姓名多选、最多 100 人、逐人结果、幂等请求与失败隔离；本地真实提交 2/2 成功 | **已实现并部署**：生产继续验证大团队权限与超时重试 |
| 截止时间/快捷日期 | 历史计划要求训练任务有截止时间；客户细化为今天/明天/3天/7天 | `61:530` 有精确截止时间，没有快捷日期控件 | 已增加 `dueDate` 及当天/明天/3天/7天快捷项，并在逐人结果显示到期日 | **已实现并部署**：补设计状态并复验生产时区边界 |
| 每日题每日变化/专项不重复 | 文档要求覆盖岗位常见场景和动态训练 | Figma 主要画页面结果，没有内容版本、日期派发、去重和降级规则 | 五岗位题库按日期、岗位和员工身份轮换，并保存内容版本、快照和哈希 | **非视觉型缺口已实现并部署**：继续做正式内容审核和长期样本审计 |
| 生成题目、AI 回复、点评播报 | 语音优先原则支持；不能证明旧版全部覆盖 | 对应画板没有形成全链路播报覆盖表 | 已覆盖每日题、AI 回复、点评、参考答案、训练结果与候选面试；无 TTS 模型时 H5 可降级设备语音 | **已实现并部署**：Figma 仍需形成内容类型/播放状态矩阵，真机待验收 |
| 主管切换学习端 | 客户明确主管也要学习；历史目标支持角色兼任 | Figma 分别画员工端和主管端，没有双模式切换入口及权限说明 | 已实现“工作台/学习端”双向切换，显示模式变化但组织角色保持主管 | **已实现并部署，Figma 仍未覆盖**：补入口、返回路径与权限说明画板 |
| 岗位差异化内容 | 总纲要求岗位→SOP→场景→学习内容映射 | Figma 有多个岗位/角色页面，但没有展示内容分发规则和岗位覆盖表 | 五岗位场景和题库已发布，正式 SOP/资格规则仍未完整配置 | **部分实现**：用岗位内容矩阵和正式内容验收，不用“页面不同”代替“内容不同” |
| 问 AI（全网） | 旧版无；会议基线是企业内部知识 | 原设计索引未见独立外部 AI 入口、来源和免责声明 | 已与问师傅分入口/接口/来源并发布，提供方须测试后启用 | **新增范围已批准并实现**：Figma 仍需补来源、禁用、错误和免责声明状态；正式提供方待验收 |
| 图片/视频提问 | 历史文档列为新增/后置情境能力 | `79:11` 有回答侧视频内容，但没有提问附件上传流程 | 已补本次查询的图片/视频附件分析并发布 | **设计仍需追齐**：补权限、PII 外发、大小/失败状态，真机待验收 |
| 开放问题榜/有奖问答 | 原总纲列阶段二，2026-07-17 客户明确要求一并实现 | `95:6` 等画板已完整设计 | 提问、回答、审核、最佳答案、积分/学分已实现并发布 | **范围例外已落地**：正式运营规则和认证写链路待验收；不含现金/提现 |
| 个人 AI 助理/个人资料库 | 2026-07-11 新增，明确阶段二 | Figma 已有完整画板组 | 当前未实现 | **阶段混放风险**：从当前阶段一研发指令中排除，另建阶段二验收表 |
## 4. 根因判断
@@ -130,12 +132,12 @@ Figma 当前存在五类风险：
## 8. 立即执行顺序
1. 先让客户确认《员工端版本功能对比与功能对齐清单》中的“确认回退/历史规划/新增需求”分类。
2. 给确认项分配需求 ID，并把阶段、来源和功能覆盖状态回写到 Figma 索引。
3. 先做 P0：问师傅语音输入、关键内容播报全覆盖、每日题/专项版本和去重。
4. 再做 P1：多人派发、截止时间、主管学习端、岗位内容映射、字号三档。
5. 开放问题榜、个人 AI 助理和全网 AI 分别按阶段二或新增专项推进，不与阶段一修复混包。
6. 每一批完成后分别记录“本地实现、功能验证、视觉验证、已发布、生产验证”，不再用一个“完成”覆盖所有状态。
1. 给已确认项补齐需求 ID、来源、阶段和功能覆盖状态，并回写 Figma 索引。
2. 用正式 OTP 完成员工、主管、候选人和后台角色正反例，不用开发固定验证码替代。
3. 在真实手机复验语音、附件、下载、三级字号、键盘和读屏。
4. 由业务审核五岗位题库/SOP/资格、问题榜积分规则和全网 AI 正式提供方。
5. 个人 AI 助理、完整徽章荣誉和完整偏好仍按后续阶段管理。
6. 每批分别记录“本地实现、功能验证、视觉验证、已发布、生产验证、正式业务验收”。
## 9. 补充抽查：`页面｜我` 不是有效的字号变体组
@@ -172,7 +174,7 @@ Figma 当前存在五类风险：
- 修复前四张画板已复制为隐藏备份，根节点为 `251:119`、`251:299`、`251:358`、`251:417`。
- 修复后逐张重新生成 400×886 截图并人工查看，同时复核直接子节点网格、文字越界、字体族、最小字号和固定层；三稿首屏均未发现重叠或裁切。
因此 `4:16` 的状态先由“设计阻塞”调整为 **Figma 视觉已修**；随后代码恢复批次已实现全局字号和持久化并完成本地视觉复核，详见 10.5。两者均不代表已经发布。
因此 `4:16` 的状态由“设计阻塞”调整为 **Figma 视觉已修**；随后代码实现全局字号和持久化并完成本地视觉复核，2026-07-18 已随当前 H5 发布。真实设备触控、键盘和读屏仍是独立验收项。
## 10. 全文件批量质量审计（2026-07-17）
@@ -197,7 +199,7 @@ Figma 当前存在五类风险：
| 页面 / 节点 | 插件与截图证据 | 分级 | 处理 |
|---|---|---|---|
| 页面｜我 `4:16` | 修复前四张字号画板结构漂移、指标错误、双 active、超大字重叠和末尾安全区不足；2026-07-17 已修为 `7:2` / `253:131` / `253:188` 三张同构稿并逐张截图复核 | **Figma 视觉已修；代码本地已实现并复核** | 发布后补真实设备触控、键盘、读屏和长数据回流验证，不再使用隐藏旧稿 |
| 页面｜我 `4:16` | 修复前四张字号画板结构漂移、指标错误、双 active、超大字重叠和末尾安全区不足；2026-07-17 已修为 `7:2` / `253:131` / `253:188` 三张同构稿并逐张截图复核 | **Figma 已修；代码已实现、部署** | 补真实设备触控、键盘、读屏和长数据回流验证，不再使用隐藏旧稿 |
| 页面｜问 `21:3` | 修复前空回答态被固定底栏遮住 | **Figma 已修** | 内容末尾已增加 108px 安全占位并重新截图；真实实现仍验证长回答、键盘与滚动末尾 |
| SOP 反馈 `79:674` | 修复前底部说明被裁 6px | **Figma 已修** | 画板高度由 832 增至 860，完整说明已重新截图复核 |
| 案例语音上传 `79:706` | 修复前上传表单被裁 48px | **Figma 已修** | 画板高度由 860 增至 932，上传区完整显示并重新截图复核 |
@@ -209,9 +211,9 @@ Figma 当前存在五类风险：
### 10.3 对研发排期的影响
- **可以继续按业务文档开发**：没有列入上表的当前阶段页面；Figma 仍只负责视觉，不负责补齐算法、权限和接口规则。
- **已作为视觉实现基线并本地落地**：`4:16` 字号三档已修为同构稿；代码已补全局字号切换和持久化，真实设备的长内容/键盘/底栏与读屏仍待发布前验证。
- **已作为视觉实现基线并部署**：`4:16` 字号三档已修为同构稿，代码已补全局字号切换和持久化；真实设备的长内容、键盘、底栏与读屏仍待验收。
- **当前阶段 Figma 截断缺陷已修**：`21:3`、`79:674`、`79:706` 可作为新的视觉参考，但代码仍须以真实同尺寸截图和交互状态完成二次验收。
- **后续阶段暂不进入当前主线**：工作积分、荣誉中心、个人 AI 助理、开放问题榜等虽已修复确定性视觉错误，功能仍按阶段二/三管理。
- **后续阶段边界**：开放问题榜和积分基础能力已按客户确认提前发布；工作积分排行榜、完整荣誉中心、个人 AI 助理等仍按阶段二/三管理。
- **索引必须更新后才能重新冻结**：当前真实口径为 81 页/78 张 `Screen/` 画板，结构复扫结果为默认 `Frame` 0、小于 12px 文本 0、根级越界 0；索引仍写 78/70，不能继续作为文件总数事实源。
### 10.4 修复后的再次复检边界
@@ -223,7 +225,7 @@ Figma 当前存在五类风险：
- **Figma 结构复核**：78 张画板，默认 `Frame` 0、小于 12px 文本 0、不可滚动根级越界 0。
- **Figma 视觉复核**：78 张当次截图已逐张查看；本轮发现的裁切、头像重叠、占位数据和字符级换行已修并复截图。
- **代码实现/浏览器复核**：本轮没有修改移动端或管理端代码，不能把 Figma 修复写成代码已对齐；同尺寸实现截图、滚动、键盘、长数据、触控和读屏仍需单独验证。
- **发布/生产验证**：本轮未发布，不改变现网完成状态。
- **当时的发布状态**：本段所述 Figma 批次当日没有发布；其后代码批次已于 2026-07-18 发布，当前状态以本文开头和 11.1 为准。
### 10.5 后续代码恢复与浏览器复核（2026-07-17 晚间）
@@ -235,7 +237,7 @@ Figma 当前存在五类风险：
- 总结卡在无聊天模型配置时只摘录相关 SOP 原文并标注来源，排除低相关片段；浏览器已显示下载成功提示。
- TTS 模型未配置时，H5 已从后端 TTS 自动切换到设备语音，按钮从“语音播报”进入“停止播报”，随后可手动停止。
该批次的完成层级为 **本地实现、自动化验证、浏览器交互验证和视觉验证**；仍未发布、未做生产验证，也未完成真实手机上的麦克风/相册权限与读屏验收。
该批次当时完成到 **本地实现、自动化验证、浏览器交互验证和视觉验证**；2026-07-18 已继续完成发布和生产基础验证，但真实手机上的麦克风/相册权限与读屏仍未验收。
## 11. 代码实现的逐页视觉复核（2026-07-18）
@@ -250,6 +252,12 @@ Figma 当前存在五类风险：
当次证据保存在 `.data/visual-audit-20260718/runtime/`：`contact-employee-standard.png`、`contact-employee-accessibility.png`、`contact-supervisor.png` 和 `contact-admin.png`。这些证据只证明本地运行与视觉验证，仍不等于发布和生产验证。
### 11.1 生产发布复核（2026-07-18）
- 当前提交 `32fa376d` 的管理端、H5、后端和 21 个迁移已发布，目标 schema `34/34`、新增表排序规则兼容 `18/18`。
- 生产浏览器已查看管理端首页、常见难题、问题榜运营、知识空间、全网 AI 配置和 390×844 H5；最终无控制台或请求错误。
- 本次只完成生产包、schema、公开接口和关键页面验证。正式 OTP 下的移动端写操作、真机麦克风/文件/下载/读屏、外部模型和严格试点仍需单独验收。
## 12. 关联文档
- [员工端版本功能对比与功能对齐清单-20260717.md](员工端版本功能对比与功能对齐清单-20260717.md)