Files
prop-ai-hr/docs/FIGMA_IMPLEMENTATION_MATRIX.md
T

134 lines
19 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Figma 页面实现矩阵
更新时间:2026-07-18
## 统计口径
- Figma 索引 `101:3` 仍声明 78 个页面、70 张正式画板;该数字已经落后于当前文件。
- 2026-07-17 通过 Figma 插件逐页切换并重新导出当次截图,实际确认 **81 个顶层页面、78 张顶层 `Screen/` 正式画板**;“我”页修复时已删除 1 张冗余冲突稿。78 张截图均已人工检查,不再沿用此前 63 页/59 张的限流中间结果。
- 索引没有说明如何从 78 张 `Screen/` 画板排除为 70 张“正式画板”,因此本表继续保留产品页面映射,但不把 70 当作可复算的当前总数;完整设计质量结论见 `FIGMA需求覆盖与版本偏差审计-20260717.md`。
- `[x]` 只表示 Figma 画板已完成,不表示代码或线上已完成。
- `已实现`:仓库存在对应页面,并有真实业务接口或明确的降级链。
- `部分实现`:有入口或局部状态,但没有完成 Figma 对应的完整业务闭环。
- `未实现`:没有对应业务页面,或只有建设中占位。
- `已部署待业务验收`:代码和生产包已对齐,但正式账号、真机、外部提供方或真实业务数据尚未验收。
- “Figma 位置”使用设计清单中的 node id;未标 node id 的项目不是正式画板。
## 与《AI陪练二期开发推进计划》对账
这两份文档不是同一张验收表:
- 本矩阵回答“Figma 设计的页面在代码/线上完成到什么程度”,覆盖 MVP、二期、阶段二/三和已取消设计。
- 二期计划回答“生活顾问 AI 陪练阶段一的工程闭环和 M5 试点条件是否满足”,不要求实现索引原口径下的全部 70 张 Figma 正式画板。
- 因此,矩阵中的“未实现”不等于二期延期。开放问题榜和积分基础能力已因 2026-07-17 客户明确要求提前实现并发布;个人 AI 助理、完整徽章荣誉和完整偏好体系仍属阶段二/三。
- 矩阵中的“已实现”也不等于 M5 业务验收通过;评分校准、SOP 评审、正式组织身份和真实试点数据仍以严格预检为准。
与二期计划的主要对应关系:
| 计划范围 | 矩阵行 | 对账结论 |
|---|---:|---|
| M1 场景、Rubric、提示词模板 | 5、23、24、25 | 工程能力已实现;场景/Rubric保留轻量入口,未做计划明确不要求的复杂 CRUD。提示词模板已挂在模型配置页,按计划完成;按 Figma 独立画板仍是部分对齐。 |
| M2 预习卡、情绪/红线、求助、知识缺口 | 5、6、7、27、28 | 代码闭环和问答反馈已实现;当前 Figma 差异主要是独立画板中的收藏持久化尚无后端契约,以及完整视觉状态仍需按正式画板继续复核。开放问题榜不属于本期。 |
| M3 录音、回放、逐句标注 | 8、11、27 | 工程能力已实现;线上主管角色路由和真实音频/线上包仍需验证。 |
| M4 画像、预警、派发、复盘建议、校准 | 9—14、26、46—47、50、61—62 | 主链路已实现;完整 Figma 看板、晋升和游戏化页面不属于本期必做。 |
| M5 试点收口 | 26 | 只有工程闸门和导出能力已实现;正式业务是否通过不能由本矩阵判定,必须看真实组织数据和人工评审样本。 |
结论:本矩阵与二期计划**功能边界基本一致,但原表缺少计划对账层**;本节已补上,后续不再把 Figma 全量完成度当成二期完成度。
## 当前剩余动作
| 优先级 | 项目 | 需要什么才能继续 |
|---|---|---|
| P0 | 正式账号与真机验收 | 2026-07-18 当前分支的管理端、H5、后端和 21 个迁移已发布,产物哈希、服务、公开接口、schema 和关键页面已验证;仍需正式 OTP 下员工/主管/候选人读写与权限正反例,以及真实手机麦克风、文件/下载、设备语音和读屏复验。 |
| P1 | 案例学习/视频详情 | 原始音频 `mediaUrl/mediaOssId` 已形成真实留痕和回放;学习点已从真实摘要提取并持久化,主管点评已有受保护接口和两端展示;仍需业务提供一期预渲染视频样片,并确定相关训练场景字段后再完成视频详情页面。 |
| P1 | 正式组织数据 | 用正式员工、项目和试点时间窗口验证团队量化、成长证据和 M5 导出;不使用本地 smoke 样本替代。 |
| P2 | 后续阶段页面 | 开放问题榜和积分基础能力已发布;个人 AI 助理、完整徽章荣誉、完整七维偏好和独立 AI 教练编排仍按阶段二/三单独立项。 |
## 业务画板实现矩阵(原索引 70 张口径)
| # | 页面/状态 | Figma 位置 | 代码路径 | 当前实现 | 是否修正 |
|---:|---|---|---|---|---|
| 1 | 员工端:今日 | `23:3` | `mobile-uni/src/pages/user/today/index.vue` | [x] 已实现并部署 | 2026-07-18 当前 H5 已发布并在 390×844 视口复核匿名首屏;认证态个性化内容仍需正式 OTP 回归 |
| 2 | 员工端:练入口 | `22:3` | `mobile-uni/src/pages/user/practice/index.vue` | [x] 已实现 | 已验证场景首屏、最近练过、每日三题和独立练习入口;蓝白视觉已复核 |
| 3 | 员工端:问 | `21:3` | `mobile-uni/src/pages/user/sop/index.vue` | [x] 已实现、部署;Figma 已修 | 文字查询、引用、反馈、语音输入/选音频、回答/总结卡播报和 PNG 下载已本地验证并进入生产包;真实手机键盘、麦克风、文件和下载权限仍待验收 |
| 4 | 员工端:我 | `4:16`(标准 `7:2` / 大字 `253:131` / 超大字 `253:188`) | `mobile-uni/src/pages/user/profile/index.vue` | [x] 已实现、部署;Figma 已修 | 三档保持同一结构并全局持久化,本地多视口无横向溢出、底栏遮挡或卡片重叠;真实设备触控、键盘和读屏仍待验收 |
| 5 | 训练前预习卡 | `53:2` | `mobile-uni/src/pages/user/practice/index.vue` | [x] 已实现 | 已验证预习卡、开始练习与真实对话状态;视觉已复核 |
| 6 | 正式语音对练 | `54:2` | `mobile-uni/src/pages/user/practice/index.vue` | [x] 已实现 | 已验证文字提交、情绪/信任、求助和录音入口;失败保留文本降级 |
| 7 | 训练完成结果 | `55:2` | `mobile-uni/src/pages/user/practice/index.vue` | [x] 已实现 | 已验证两轮真实提交、评分结果和主管待复盘更新;视觉已复核 |
| 8 | 训练历史详情 | `56:2` | `mobile-uni/src/pages/user/history/index.vue` | [x] 已实现 | 已验证员工归属、评分明细、对话、复盘建议和刷新返回 |
| 9 | 主管今日工作台 | `57:2` | `mobile-uni/src/pages/supervisor/index/index.vue` | [x] 已实现 | 已用主管账号验证团队概览、任务入口和预警;蓝白视觉已复核 |
| 10 | 主管待复盘列表 | `58:2` | `mobile-uni/src/pages/supervisor/reviews/index.vue` | [x] 已实现 | 已验证真实待复盘列表、低分优先和详情跳转 |
| 11 | 主管复盘详情 | `59:2` | `mobile-uni/src/pages/supervisor/review/index.vue` | [x] 已实现 | 已验证评分明细、对话、标注、建议、贡献分和标记已复盘 |
| 12 | 员工能力详情 | `61:2` | `mobile-uni/src/pages/supervisor/team/index.vue` | [x] 已实现 | 已验证点击成员展示最新评分、训练次数、待复盘数量、真实训练趋势和成长证据;400px 主管画布、蓝白卡片、层级和间距已复核;未虚构 Figma 未提供的数据 |
| 13 | 训练任务派发 | `61:530` | `mobile-uni/src/pages/supervisor/assign/index.vue` | [x] 已实现并部署 | 已按项目团队姓名多选、最多 100 人、当天/明天/3天/7天、逐人结果和幂等批量接口对齐;本地向 2 名成员提交 2/2 成功,生产正式团队待复验 |
| 14 | 派发进度与预警 | `62:2` | `mobile-uni/src/pages/supervisor/assign/index.vue` | [x] 已实现 | 已验证真实派发进度计数(待训练/已完成/低分再练)和低分训练预警;400px 主管画布、表单/列表/进度卡层级已复核;截止时间与下滑趋势暂无后端字段,未伪造 |
| 15 | 候选人面试首页 | `67:2` | `mobile-uni/src/pages/candidate/index/index.vue` | [x] 已实现 | 已修正 |
| 16 | 候选人面试答题 | `68:2` | `mobile-uni/src/pages/candidate/interview/index.vue` | [x] 已实现 | 已修正 |
| 17 | 候选人面试完成评分 | `69:26` | `mobile-uni/src/pages/candidate/interview/index.vue` | [x] 已实现 | 已修正 |
| 18 | 候选人历史/人工复核 | `69:559` | `mobile-uni/src/pages/candidate/progress/index.vue` | [x] 已实现 | 已对齐面试记录、评分摘要、真实问答快照、人工复核状态和返回候选人中心;浏览器已验证真实面试提交后可查看 3 条问答记录 |
| 19 | 候选人补充资料上传 | `69:599` | `mobile-uni/src/pages/candidate/materials/index.vue` | [x] 已实现 | 已修正 |
| 20 | 候选人资料审核状态 | `69:629` | `mobile-uni/src/pages/candidate/progress/index.vue` | [x] 已实现 | 已修正 |
| 21 | 管理端 AI 面试列表 | `70:2` | `frontend/src/views/recruit/interview.vue` | [x] 已实现 | 已修正 |
| 22 | 管理端 AI 面试详情复核 | `71:2` | `frontend/src/views/recruit/interview.vue` | [x] 已实现 | 已修正;新增 HR/管理员将候选人本地记录关联到已同步在职 `ext_party_id` 的入口,不复制组织字段,关联其他主体会拒绝;当前批次已发布,认证态 HR 回归仍待正式账号 |
| 23 | 场景库列表/编辑/启停 | `71:628` | `frontend/src/views/train/scenarios.vue` | [x] 已实现 | 已按 Figma 独立工作台实现筛选、分页、列表、Rubric/状态展示、编辑、新增和启停;真实浏览器已验证编辑保存及停用/启用恢复 |
| 24 | Rubric 维度/版本管理 | `72:2` | `frontend/src/views/train/rubrics.vue` | [x] 已实现 | 已按 Figma 实现版本列表、维度权重编辑、保存发布、复制版本与启停;真实浏览器已验证权重保存、复制版本落库及启用/停用恢复 |
| 25 | 提示词模板管理 | `73:2` | `frontend/src/views/system/prompts.vue` | [x] 已实现 | 已按 Figma 独立工作台实现模板列表、名称/代码/输出文体/系统提示词/模板/变量编辑、保存草稿、保存并启用;真实浏览器已验证编辑保存、新增启用、刷新持久化,临时样本已清理 |
| 26 | 人工评分校准/指标导出 | `74:2` | `frontend/src/views/train/reviews.vue`、`frontend/src/views/train/practice.vue` | [x] 已实现 | 已按 Figma 补齐日期窗口、岗位/组织范围、校准样本指标卡和独立 CSV 导出;真实浏览器已验证页面加载、导出下载和复盘校准表单,正式试点数据仍需真实样本 |
| 27 | SOP 回答结果 | `79:11` | `mobile-uni/src/pages/user/sop/index.vue` | [x] 已实现 | 已按 Figma 补齐「师傅回答/我的问题/答案卡/引用依据/反馈」层级,保留真实检索、引用和反馈接口;浏览器已验证登录、真实答案展示和“有用”反馈状态 |
| 28 | SOP 好评/差评反馈 | `79:674` | `mobile-uni/src/pages/user/sop/index.vue` | [x] 已实现;Figma 已修 | 已按 Figma 语义对齐为「有帮助/没解决」双按钮,保留真实反馈接口、提交后状态提示与按钮锁定;浏览器已验证真实搜索、点击反馈、结果提示和两个按钮 disabled。Figma 已补足画板高度并重新截图复核;其中「收藏」当前仍无后端持久化接口,未添加假按钮 |
| 29 | SOP 后台待复核 | `80:655` | `frontend/src/views/knowledge/sop.vue` | [x] 已实现 | 已补真实答案反馈待复核队列、待复核/已复核筛选、状态展示与「标记已复核」动作;浏览器已验证刷新加载临时待复核样本、点击复核后从待办移除并清理测试数据 |
| 30 | SOP 知识库管理 | `81:2` | `frontend/src/views/knowledge/sop.vue` | [x] 已实现 | 已修正 |
| 31 | 异步资料处理队列 | `81:750` | `frontend/src/views/knowledge/processing.vue` | [x] 已实现 | ZIP 异步入队已在生产复核;解析任务列表已于 2026-07-15 发布前端分页(10/20/50 条),真实管理员会话已验证翻页与筛选复位。 |
| 32 | 案例语音上传 | `79:706` | `mobile-uni/src/pages/user/cases/index.vue`、`frontend/src/views/knowledge/cases.vue` | [x] 已实现;Figma 已修 | 功能已实现;Figma 已补足上传表单所需高度并重新截图复核,真实实现仍需验证录音、文件选择和长文件名状态 |
| 33 | 案例 AI 整理结果 | `79:734` | `frontend/src/views/knowledge/cases.vue` | [x] 已实现 | 已修正 |
| 34 | 案例审核/筛选/发布 | `82:2` | `frontend/src/views/knowledge/cases.vue` | [x] 已实现 | 已修正 |
| 35 | 案例学习/视频详情 | `80:2` | `mobile-uni/src/pages/user/learning/index.vue`、`cases/index.vue` | 部分实现 | 已补 `caseId`、按项目权限校验的案例详情 API、原始音频 OSS 留痕/回放、员工端转写/摘要详情、学习点和主管点评查看;仍缺预渲染视频样片与相关训练场景契约,暂不把音频回放标成完整视频详情 |
| 36 | 个人资料库首页 | `86:3` | — | 未实现 | 未修正,阶段二 |
| 37 | 个人资料列表/筛选搜索 | `86:58` | — | 未实现 | 未修正,阶段二 |
| 38 | 收藏资料 | `86:846` | — | 未实现 | 未修正,阶段二 |
| 39 | 文件解析进度/失败重试 | `86:884` | — | 未实现 | 未修正,阶段二 |
| 40 | 资料详情/来源/删除/导出 | `86:950` | — | 未实现 | 未修正,阶段二 |
| 41 | 个人/企业/混合知识范围 | `86:997` | — | 未实现 | 未修正,阶段二 |
| 42 | 个人知识带引用回答 | `87:2` | — | 未实现 | 未修正,阶段二 |
| 43 | 工作思路整理输入 | `87:770` | — | 未实现 | 未修正,阶段二 |
| 44 | 结论/行动项结果 | `87:815` | — | 未实现 | 未修正,阶段二 |
| 45 | 摘要/可编辑文字生成 | `87:865` | — | 未实现 | 未修正,阶段二 |
| 46 | 员工工作量化看板 | `89:9` | `frontend/src/views/competency/growth.vue` | 按二期计划已实现;按 Figma 部分对齐 | 已有训练时长、贡献度、测评分、等级、证据包、预警和派发;完整三期量化指标暂不补 |
| 47 | 主管团队量化看板 | `89:776` | `mobile-uni/src/pages/supervisor/team/index.vue` | 按二期计划已实现;按 Figma 部分对齐 | 已有团队成员、风险、训练记录、成长证据和按项目范围聚合的团队错题本;完整团队经营指标仍需正式组织数据 |
| 48 | HR/运营绩效看板 | `90:2` | — | 未实现 | 未修正,三期 |
| 49 | 工作积分排行榜 | `90:91` | — | 未实现;Figma 已修 | 三期;排行榜行组件已按真实尺寸缩放头像,6 行改为可区分姓名并重新截图复核;代码仍未实现,不进入当前阶段主线 |
| 50 | 等级/晋升条件/进度 | `90:867` | `frontend/src/views/competency/growth.vue` | 按二期计划已实现;按 Figma 部分对齐 | 已有初/中/高级成长路径和评级证据包;正式晋升申请/审核属于后续范围 |
| 51 | 破格晋升申请/审核 | `91:2` | — | 未实现 | 未修正,三期 |
| 52 | 荣誉墙/成长档案导出 | `91:765` | — | 未实现;Figma 已修 | 徽章示例已去除重复占位文案,等级文案字符级换行已修;仍属三期,代码未实现 |
| 53 | 七维回复风格调节 | `93:6` | `mobile-uni/src/pages/user/practice/index.vue` | 按二期计划已实现首期形态;按 Figma 部分对齐 | 已有训练内“再严肃/更温柔/更细致/更专业”重生成;偏好持久化和七维设置属于后续范围 |
| 54 | 优化前后结果对比 | `93:824` | — | 未实现 | 未修正,三期 |
| 55 | 个人 AI 偏好设置 | `93:857` | — | 未实现 | 未修正,三期 |
| 56 | 管理端团队偏好分布 | `93:940` | — | 未实现 | 未修正,三期 |
| 57 | 开放问题榜首页 | `95:6` | `mobile-uni/src/pages/user/questions/index.vue` | [x] 已实现并部署 | 按客户明确要求提前落地;生产包和 schema 已验证,正式员工读写待 OTP 回归 |
| 58 | 问题详情/全员回答 | `95:782` | `mobile-uni/src/pages/user/questions/detail.vue`、`publish.vue` | [x] 已实现并部署 | 支持提问、回答和状态展示,服务端按租户/身份校验;正式业务内容待验收 |
| 59 | 最佳答案/奖励结果 | `95:826` | `mobile-uni/src/pages/user/questions/detail.vue`、`points/index.vue` | [x] 已实现并部署 | 最佳答案与积分/学习学分双账户已落地,重复选优不重复发奖;不含现金或提现 |
| 60 | 问题审核/激励规则 | `95:858` | `frontend/src/views/community/questions.vue` | [x] 已实现并部署 | 生产页面已打开复核;正式运营规则、审核角色正反例待业务验收 |
| 61 | AI 教练训练计划 | `97:5` | `mobile-uni/src/pages/supervisor/assign/index.vue` | 按二期计划已实现;按 Figma 部分对齐 | 已用主管派发、低分再练、每日三题和成长证据承载;独立 AI 教练编排属于后续范围 |
| 62 | 自动场景任务/自动复盘 | `97:778` | `mobile-uni/src/pages/user/practice/index.vue`、`supervisor/review/index.vue` | 按二期计划已实现基础闭环;按 Figma 部分对齐 | 已有训练、评分、标注、复盘和再练;自动编排/自动复盘报告不属于当前二期必做 |
| 63 | 积分/徽章/荣誉中心 | `97:823` | `mobile-uni/src/pages/user/points/index.vue` | 部分实现并部署;Figma 已修 | 积分/学习学分余额和明细已实现;完整徽章、荣誉中心仍属后续范围 |
| 64 | 企业发布申请 | `42:2` | — | 未实现 | 未修正,阶段二 |
| 65 | 个人 AI 助理发布记录 | `44:2` | — | 未实现 | 未修正,阶段二 |
| 66 | 个人 AI 助理报告大纲 | `44:229` | — | 未实现 | 未修正,阶段二 |
| 67 | 个人 AI 助理 PPT 生成 | `45:2` | — | 未实现 | 未修正,阶段二 |
| 68 | 企业知识发布审核列表 | `46:2` | — | 未实现 | 未修正,阶段二 |
| 69 | 企业知识发布审核详情 | `47:2` | — | 未实现 | 未修正,阶段二 |
| 70 | 个人 AI 助理运营/紧急审计 | `48:2` | — | 未实现 | 未修正,阶段二 |
## 已取消而不应补做
以下 Figma 清单中的“师徒关系”项目已经被业务会议否决,不应作为缺口继续开发:申请拜师、师傅池、固定师徒关系、互动计划、师傅认证、带徒福利等。当前替代方向是主管复盘闭环和后续开放问题榜。
## 当前优先级
1. **P0:正式账号、角色与项目范围**。当前包已发布,仍需用正式 OTP 和组织数据验证员工/主管/候选人及项目级权限正反例。
2. **P0:M5 正式试点证据**。本地严格门禁可跑通,但正式窗口内的员工、训练次数、校准、SOP 评审和完训率仍需真实数据。
3. **P1:按 BRD 补齐一期业务缺口**。优先是岗位-SOP匹配与上岗资格、错题本可见闭环、案例学习/视频详情的稳定数据模型。
4. **P2:案例详情数据模型**。`caseId`、原始音频媒体留痕、学习点和主管点评已具备;继续等待真实视频样片与相关训练场景契约,不用假视频占位。
5. **P3:剩余阶段二/三页面**。开放问题榜和积分基础能力已按客户要求提前发布;个人 AI 助理、完整徽章荣誉、完整偏好和独立 AI 教练编排仍按后续阶段单独立项。