diff --git a/AGENTS.md b/AGENTS.md index b6c7379e..260e9a64 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -81,6 +81,7 @@ - 总入口:`README.md` - 文档索引:`docs/README.md` +- Figma 设计资产清单:`docs/FIGMA_DESIGN_INVENTORY.md`;页面实现应复用既有变量与组件,以清单中的正式画板为视觉基准,不按单页自由发挥。 - MVP 演示与验收:`docs/DEMO_ACCEPTANCE.md` - 阶段交付归档:`docs/archive/2026-07-mvp-delivery/` - 分阶段总纲:`docs/银城员工端APP分阶段实施总纲.md` diff --git a/README.md b/README.md index 9e49eb91..2c3d9be6 100644 --- a/README.md +++ b/README.md @@ -44,6 +44,7 @@ | 文档 | 用途 | |---|---| | [文档目录](docs/README.md) | docs 区完整索引 | +| [Figma 设计资产清单](docs/FIGMA_DESIGN_INVENTORY.md) | 79 个页面、71 张正式画板的节点索引、批次范围和一致性审计结果 | | [本地运行手册](docs/DEV_SETUP.md) | 端口、账号、启动和基础验证 | | [MVP 演示与验收清单](docs/DEMO_ACCEPTANCE.md) | MVP 演示脚本、录屏兜底和验收口径 | | [后端 API 对接指南](docs/API_INTEGRATION.md) | 后端模块落点、正式试点 CSV、移动端训练/复盘、候选资料上传/审核和 SOP 上传解析接口 | diff --git a/docs/FIGMA_DESIGN_INVENTORY.md b/docs/FIGMA_DESIGN_INVENTORY.md new file mode 100644 index 00000000..2d493038 --- /dev/null +++ b/docs/FIGMA_DESIGN_INVENTORY.md @@ -0,0 +1,159 @@ +# 物业 AI 人力资源系统 · Figma 设计资产清单 + +> Figma 文件:[银城员工端与个人 AI 助理设计](https://www.figma.com/design/30hFiKtieGYraOZvJPJcPd) +> +> 对照来源:`docs/物业AI人力资源系统业务需求文档BRD.md`、一期 MVP 作战清单、`docs/AI陪练二期开发推进计划.md`、`docs/20260708/AI陪练功能优化与缺口分析 三期.docx`。 + +## 状态说明 + +- `[x]`:正式可编辑页面已在 Figma 中完成并通过截图检查。 +- `[ ]`:尚未设计;当前清单无此状态。 +- `[-]`:已有入口或局部内容,但缺少完整业务状态。 +- 页面必须复用 Figma 变量和组件;imagegen 图只作为视觉参考,不作为最终扁平页面。 + +## 已有正式页面 + +- [x] 员工端:今日 +- [x] 员工端:练(训练中心入口) +- [-] 员工端:问(仅提问态,缺结果与反馈) +- [-] 员工端:我(有成长摘要,缺完整画像/荣誉/偏好) +- [x] 个人 AI 助理:企业发布申请 +- [x] 个人 AI 助理:发布记录 +- [x] 个人 AI 助理:报告大纲 +- [x] 个人 AI 助理:PPT 生成 +- [x] 管理端:企业知识发布审核列表 +- [x] 管理端:企业知识发布审核详情 +- [x] 管理端:个人 AI 助理运营与紧急审计 + +## 第一批:AI 陪练员工与主管闭环 + +目标:覆盖二期 M2-M4 的训练前、训练中、训练后、主管复盘和任务派发。 + +### 员工端 + +- [x] 训练前预习卡详情:要点、红线、可说话术、场景人设(Figma `53:2`) +- [x] 正式语音对练:AI 业主、情绪/信任、求助、红线打断、风格重生成(Figma `54:2`) +- [x] 训练完成结果:多维评分、导师改写、下一步建议、再练入口(Figma `55:2`) +- [x] 训练历史详情:完整对话、录音回放、逐句标注、SOP 命中(Figma `56:2`) + +### 主管端 + +- [x] 主管今日工作台:团队概览、待办、训练预警(Figma `57:2`) +- [x] 待复盘列表:筛选、员工、场景、分数和状态(Figma `58:2`) +- [x] 主管复盘详情:录音、逐句标注、复盘建议、贡献度加分(Figma `59:2`) +- [x] 员工能力详情:雷达、趋势、短板、成长路径、评级证据(Figma `61:2`) +- [x] 训练任务派发:人员、岗位、场景/专项包、截止时间(Figma `61:530`) +- [x] 派发进度与预警:完成情况、逾期、连续低分、分数下滑(Figma `62:2`) + +验收:10 张页面均为独立可编辑画板;员工端 400px、主管端 400px 移动工作台;共享员工端组件与变量;无默认 Frame 图层名;截图无裁切和重叠。 + +## 第二批:一期 MVP 角色闭环 + +### 候选人端 + +- [x] 面试邀请/面试首页(Figma `67:2`) +- [x] 面试答题:语音、文本、进度(Figma `68:2`) +- [x] 面试完成与 AI 评分(Figma `69:26`) +- [x] 面试历史与人工复核状态(Figma `69:559`) +- [x] 补充资料上传(Figma `69:599`) +- [x] 资料审核状态/驳回原因(Figma `69:629`) + +### HR/管理端 + +- [x] AI 面试记录列表(Figma `70:2`) +- [x] AI 面试详情与人工复核(Figma `71:2`) +- [x] 场景库列表/编辑/启停(Figma `71:628`) +- [x] Rubric 维度与版本管理(Figma `72:2`) +- [x] 提示词模板管理(Figma `73:2`) +- [x] 人工评分校准与试点指标导出(Figma `74:2`) + +## 第三批:知识中心、案例与问答闭环 + +- [x] SOP 回答结果:结论、编号步骤、引用、视频(Figma `79:11`) +- [x] SOP 好评/差评与原因反馈(Figma `79:674`) +- [x] SOP 答案后台待复核(Figma `80:655`) +- [x] SOP 知识库列表/上传/详情/版本(Figma `81:2`) +- [x] 异步资料处理队列/失败重试(Figma `81:750`) +- [x] 案例语音上传(Figma `79:706`) +- [x] 案例 AI 整理结果(Figma `79:734`) +- [x] 案例审核/筛选/发布(Figma `82:2`) +- [x] 案例学习与视频详情(Figma `80:2`) + +## 第四批:个人 AI 助理主链路 + +- [x] 个人资料库首页(Figma `86:3`) +- [x] 资料列表、筛选和搜索(Figma `86:58`) +- [x] 收藏资料:文字/文件/网页(Figma `86:846`) +- [x] 文件解析进度、失败重试(Figma `86:884`) +- [x] 资料详情、来源、删除和导出(Figma `86:950`) +- [x] 个人/企业/混合知识范围选择(Figma `86:997`) +- [x] 带引用的个人知识回答结果(Figma `87:2`) +- [x] 工作思路整理输入(Figma `87:770`) +- [x] 结论/行动项/待确认事项结果(Figma `87:815`) +- [x] 摘要与可编辑文字生成(Figma `87:865`) + +## 第五批:三期量化、偏好、师徒与游戏化 + +### 量化与成长 + +- [x] 员工工作量化看板(Figma `89:9`) +- [x] 主管团队量化看板(Figma `89:776`) +- [x] HR/运营绩效看板(Figma `90:2`) +- [x] 工作积分排行榜(Figma `90:91`) +- [x] 等级详情、晋升条件和进度(Figma `90:867`) +- [x] 破格晋升申请/审核(Figma `91:2`) +- [x] 荣誉墙与成长档案导出(Figma `91:765`) + +### AI 偏好精调 + +- [x] 七维回复风格调节(Figma `93:6`) +- [x] 优化前后结果对比(Figma `93:824`) +- [x] 个人 AI 偏好设置(Figma `93:857`) +- [x] 管理端团队偏好分布(Figma `93:940`) + +### 师徒传承 + +- [-] 申请拜师与师傅池推荐(会议否决,改由开放问题榜承载) +- [-] 双方确认与师徒关系首页(取消固定师徒关系) +- [-] 师徒互动计划/记录(由公开问答留痕替代) +- [-] AI 对练旁观与点评(保留现有主管复盘,不新增师徒关系) +- [-] 月度反馈与匿名评价(取消固定师徒关系) +- [-] 续签/解除/更换师傅(取消固定师徒关系) +- [-] 师傅资格认证(改为优质回答与案例贡献证据) +- [-] 管理端师徒关系管理(取消固定师徒关系) +- [-] 带徒福利配置与发放记录(改造为激励规则配置中心) + +### 开放问题榜(师徒传承替代方案) + +- [x] 开放问题榜首页:真实求助/有奖征问题(Figma `95:6`) +- [x] 问题详情与全员回答(Figma `95:782`) +- [x] 最佳答案采纳、署名与奖励结果(Figma `95:826`) +- [x] 管理端问题审核与激励规则配置(Figma `95:858`) + +### 纯 AI 陪练与游戏化 + +- [x] AI 教练训练计划(复用每日派发/低分再练/画像,Figma `97:5`) +- [x] 自动场景任务与自动复盘报告(Figma `97:778`) +- [x] 积分、徽章和荣誉中心(Figma `97:823`) +- [-] 师傅之路任务地图/每日副本/BOSS 挑战(当前范围不做) +- [-] 员工 PK、师徒副本与学习小组(个人闭环验证后再评估) + +## 明确不补 + +- 内容营销中心/朋友圈工坊 +- 独立原生 APP 视觉分支 +- Neo4j 知识图谱管理台 +- 一期范围外的复杂多组织流程 +- 未完成授权对接前的北森、考勤、请假等伪数据页面 + +## 全文件设计一致性审计(2026-07-13) + +- [x] 建立 Figma 首屏“00|设计索引与审计”(Figma `101:3`) +- [x] 79 个页面、71 张正式画板均有内容,无重复页面名和空业务页 +- [x] 默认图层名清零,文字溢出清零,画板内容越界清零 +- [x] 字体统一为 `LXGW WenKai TC` Regular/Bold +- [x] 管理端画板统一为 1440px 宽、最低 960px 高 +- [x] 896 个精确匹配颜色补充变量绑定,整体填充变量绑定率约 50% +- [x] 品牌主红统一为 `#E60012`,员工端与管理端变量已对齐 +- [x] 正式画板和设计规范中的可见文字最低 12px,字号调整后无裁切和越界 +- [ ] 代码实现阶段验证真实对比度、键盘焦点、状态播报和读屏顺序 diff --git a/docs/README.md b/docs/README.md index ab9aa543..a5ec4b50 100644 --- a/docs/README.md +++ b/docs/README.md @@ -7,6 +7,7 @@ | 文档 | 用途 | |---|---| | [DEV_SETUP.md](DEV_SETUP.md) | 本地端口、账号、启动步骤、基础链路验证、移动端 H5 静态发布 | +| [FIGMA_DESIGN_INVENTORY.md](FIGMA_DESIGN_INVENTORY.md) | Figma 页面节点索引、设计批次范围、取消项和全文件一致性审计结果 | | [DEMO_ACCEPTANCE.md](DEMO_ACCEPTANCE.md) | 一期 MVP 演示脚本、录屏兜底、MVP 演示流验收清单 | | [API_INTEGRATION.md](API_INTEGRATION.md) | 后端 API 对接顺序、正式试点 CSV、移动端训练记录/复盘详情、候选资料上传/审核、SOP 上传解析接口 | | [RUOYI_AI_INCREMENTAL_MIGRATION.md](RUOYI_AI_INCREMENTAL_MIGRATION.md) | 从 `ageerle/ruoyi-ai` 分片迁移知识库、模型能力、文档解析、Qdrant/RAG 和 chat 的执行边界 |