From b550f54eb8689e7ad293c7fe05d8fed9f730065b Mon Sep 17 00:00:00 2001 From: let5sne Date: Sun, 5 Jul 2026 23:00:10 +0800 Subject: [PATCH] docs: sync mentor layer, summary card and design baseline across docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 演示口径/验证步骤/README/AGENTS 全部对齐 P1 师傅层与 P0-2 总结卡 现状(师傅区四状态/今日安排/我的地图/tab今日练问我/建设中整页/ 总结卡弹层);API_INTEGRATION 补检索轻概要行为与 summary-card 端点 契约;AGENTS 移动端规则更新(状态源勿新造/visibleTabs 钉死/REVIEW 修正项优先);BACKLOG 记「保存图片」与「学」板块零散待办;删除 docs/prototypes 下与 design/ 重复的 5 张设计图副本。 --- AGENTS.md | 2 +- README.md | 2 +- docs/API_INTEGRATION.md | 3 ++- docs/BACKLOG.md | 5 +++++ docs/DEMO_ACCEPTANCE.md | 2 +- docs/DEV_SETUP.md | 2 +- 6 files changed, 11 insertions(+), 5 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 854646e8..b594c364 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -55,7 +55,7 @@ - 资料处理：`frontend/src/views/knowledge/processing.vue`，路由 `/knowledge/processing`。 - 模型配置：`frontend/src/views/system/model/index.vue`，路由 `/system/model`。 - MVP 阶段侧栏只保留“首页 / AI面试 / 三角色对练 / 案例沉淀 / SOP知识库 / 资料处理 / 系统设置-模型配置”。过滤逻辑在 `frontend/src/layout/components/Sidebar/index.vue`，不要在未明确要求时恢复若依默认全量菜单。 -- 移动端三端首页：`mobile/src/App.vue`，路由 `/h5/user`、`/h5/candidate`、`/h5/supervisor`，分别对应用户/员工端、候选人端、主管端；兼容 `/h5/employee`、`/h5/admin`，但移动端不要把主管端等同后台系统管理员。员工端首页是「学/复盘/用/报/成长」五个情境区；底部 tab 是整页互斥切换（isHomeTab + activeUserPanel/activeSupervisorPanel 条件），**不要把面板改回插入首页长页面的叠加渲染**；未实现入口必须走 `tap()` 的「建设中」toast，不留无反应按钮。查 SOP 全屏层（sopPanel）调 `/api/knowledge/search`（category='sop' 全库），关闭后回到进入前 tab。 +- 移动端三端首页：`mobile/src/App.vue`，路由 `/h5/user`、`/h5/candidate`、`/h5/supervisor`，分别对应用户/员工端、候选人端、主管端；兼容 `/h5/employee`、`/h5/admin`，但移动端不要把主管端等同后台系统管理员。员工端首页是「师傅区→今日安排→我的地图→我的成长摘要」（视觉基准 `docs/feedback/2026070423/design/` + REVIEW.md 修正项，修正项优先于图面）；师傅四状态(idle/listening/thinking/speaking)只从 `sopRecording/sopLoading/sopSpeaking` 推导，**不要新造状态源**；员工端底部 tab 钉死「今日/练/问/我」（visibleTabs 强制,不跟随后端 home 旧文案），整页互斥切换（isHomeTab + activeUserPanel/activeSupervisorPanel 条件），**不要把面板改回插入首页长页面的叠加渲染**；未实现入口进「建设中」整页（openBuildingPage），不留无反应按钮。查 SOP 全屏层（sopPanel）调 `/api/knowledge/search`（category='sop' 全库），关闭后回到进入前 tab；「生成总结卡」按需调 `/api/knowledge/summary-card`，失败明确报错可重试,不兜假数据。 - 移动端首页接口：`GET /api/aihr/mobile/home/{role}`，当前 `@SaIgnore` 公开只读 seed，用于 H5 首屏 API 优先 + 本地 fallback；后续确定小程序登录后再接移动端 token，不复用管理后台登录态。 - 移动端手机号登录：验证码发送走 `GET /resource/sms/code?phonenumber=...`，登录走 `POST /auth/mobile/sms-login`；短信发送复用 `sms.blends.config1` 阿里云配置。手机号不存在时自动注册 `app_user`，备注为“移动端短信自动注册”。模板 ID 用 `AIHR_SMS_LOGIN_TEMPLATE_ID`，AccessKey/Secret/签名用 `ALIYUN_SMS_ACCESS_KEY_ID`、`ALIYUN_SMS_ACCESS_KEY_SECRET`、`ALIYUN_SMS_SIGN_NAME`，本地放 `.env.local`。dev 兜底：`aihr.sms.dev-fixed-code` 非空则验证码固定（dev 默认 `123456`）、不真发短信；prod profile 代码级强制失效，不要移除该闸门。 - 移动端员工训练闭环：员工端首页“开始训练”复用 `POST /api/train/practice/start`、`/turn`、`/finish`，请求必须带移动端登录返回的 `Authorization` 与 `clientid`；`mode=mobile` 完成后写入 `aihr_practice_session`，并更新主管端首页完训率、“待复盘对练”、员工训练历史和能力画像。主管端复盘详情查 `GET /api/aihr/mobile/practice/reviews/{id}`，标记复盘用 `POST /api/aihr/mobile/practice/reviews/{id}/reviewed`。 diff --git a/README.md b/README.md index 45f3fadc..ac22ace5 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ - 品牌：前端标题为“物业AI人力资源系统”，侧栏 logo 使用银城物业图标。 - 已验证：租户列表、验证码、`000000 / admin / admin123` 加密登录链路。 - 管理端 MVP：首页与五个关键页面已落地，路由为 `/index`、`/recruit/interview`、`/train/practice`、`/knowledge/cases`、`/knowledge/sop`、`/knowledge/processing`。 -- 移动端 MVP：三端首页已拆到独立工程 `mobile/`；路由为 `/h5/user`、`/h5/candidate`、`/h5/supervisor`，并兼容 `/h5/employee`、`/h5/admin`；已接手机号短信登录、`GET /api/aihr/mobile/home/{role}` 首页 API。员工端首页按「今天要学/练完要复盘/工作中要用/碰到问题要报/我的成长」五个情境区组织，底部 tab 整页切换；“开始训练”可完成两轮三角色对练，记录落 `aihr_practice_session` 并刷新主管端待复盘列表、复盘详情、标记已复盘状态和员工能力画像；「查 SOP」支持文本/语音提问并返回带引用片段的答案；候选人端“开始面试/面试练习”复用 AI 面试 API 拉题、作答、评分，“补充资料”走 OSS + `aihr_candidate_material` 入库，HR 可在 AI 面试页审核通过/驳回；前端保留本地 fallback。 +- 移动端 MVP：三端首页已拆到独立工程 `mobile/`；路由为 `/h5/user`、`/h5/candidate`、`/h5/supervisor`，并兼容 `/h5/employee`、`/h5/admin`；已接手机号短信登录、`GET /api/aihr/mobile/home/{role}` 首页 API。员工端首页为「数字师傅」形态（师傅头像四状态+按住说话/打字问+快捷chips→今日安排→我的地图四色块→成长摘要，视觉基准 `docs/feedback/2026070423/design/`），底部 tab 今日/练/问/我整页切换；“开始训练”可完成两轮三角色对练，记录落 `aihr_practice_session` 并刷新主管端待复盘列表、复盘详情、标记已复盘状态和员工能力画像；「查 SOP」文本/语音提问返回结构化概要+引用片段，可按需生成信息图总结卡（听一遍/开始跟读）；候选人端“开始面试/面试练习”复用 AI 面试 API 拉题、作答、评分，“补充资料”走 OSS + `aihr_candidate_material` 入库，HR 可在 AI 面试页审核通过/驳回；前端保留本地 fallback。 - 英雄路径：AI 面试（真模型出题/评分）、三角色对练（真 LLM 客户回复+评分，asr/tts 配置后支持语音）、案例沉淀（真实语音上传+ASR 转写+模型整理）均为真模型优先、未配置或失败回退本地兜底；SOP 知识库已接中文关键词 + MySQL Fulltext + Qdrant 混合召回 + rerank 重排，支持 txt/md/PDF/Word/Excel/PPT/图片/视频上传解析入库（图片走 vision OCR，视频走 ffmpeg 抽音轨转写+关键帧描述）；模型配置页可查看向量库维度/点数并一键重建。 - 资料处理：已新增解析任务状态页，按 `aihr_knowledge_attach` 和 `aihr_knowledge_fragment` 展示等待解析、解析中、已完成、失败、片段数和向量化状态；页面支持多文件/浏览器目录选择，也支持从后端 `AIHR_IMPORT_ROOT` 下启动后台目录导入任务、轮询进度并取消运行中任务。 - 侧栏：MVP 阶段只展示“首页 / AI面试 / 三角色对练 / 案例沉淀 / SOP知识库 / 资料处理 / 系统设置-模型配置”，其余若依默认菜单暂时隐藏。 diff --git a/docs/API_INTEGRATION.md b/docs/API_INTEGRATION.md index 2c2bd57e..9bf6acc5 100644 --- a/docs/API_INTEGRATION.md +++ b/docs/API_INTEGRATION.md @@ -60,7 +60,8 @@ SOP 文档上传第三片已经落最小后端边界： | 缺失向量补跑 | `POST /api/knowledge/doc/vectorize-missing` | 扫描缺少 `embedding_json` 的片段，复用同一向量化与 Qdrant 入库链路，适合模型配置变更后或历史资料补齐向量 | | 向量库状态与重建 | `GET /api/knowledge/doc/vector-index-status`、`POST /api/knowledge/doc/rebuild-vector-index` | 模型配置页展示当前 vector 模型维度、Qdrant collection 维度、点数和片段向量数；维度不一致时可一键清空旧 embedding、删除 collection 并按当前模型重建 | | Qdrant 向量索引 | 同一上传接口内机会性执行 | embedding 写入 MySQL 后尽力 upsert 到 Qdrant；同名文档替换会尽力删除旧 points；Qdrant 不可用不影响上传和 MySQL 检索；外部 embedding 成功但 collection 维度不一致时不静默降级为 `local-hash-v1`，通过状态接口和重建入口处理 | -| 混合检索 | `POST /api/knowledge/search` | 先跑中文关键词 `LIKE` 打分和 MySQL Fulltext，再生成 query embedding 走 Qdrant，RRF 融合后交给 `category='rerank'` 模型（如硅基流动 bge-reranker-v2-m3）按语义相关性重排；rerank 未配置或失败保持 RRF 顺序，Qdrant 或外部向量接口不可用时保留关键词/全文检索 | +| 混合检索 | `POST /api/knowledge/search` | 先跑中文关键词 `LIKE` 打分和 MySQL Fulltext，再生成 query embedding 走 Qdrant，RRF 融合后交给 `category='rerank'` 模型（如硅基流动 bge-reranker-v2-m3）按语义相关性重排；rerank 未配置或失败保持 RRF 顺序，Qdrant 或外部向量接口不可用时保留关键词/全文检索。命中后若 chat 模型可用，自动生成结构化轻概要写入响应 `answer/keyPoints/cautions`（≤60字直答+3-6要点+0-3注意；temperature=0，15s 超时，硬约束不得编造、答不了明示无依据）；概要失败回退片段原文拼接，检索不报错 | +| 检索总结卡 | `POST /api/knowledge/summary-card`（JSON `{queryText, category}`） | 按需生成信息图式总结卡 `{title, steps[], objections[], scripts[], reminders[]}`：复用检索命中片段（最多5条）调 chat 模型，temperature=0、30s 超时；无命中/无 chat 模型/生成失败均抛明确错误供前端重试，不兜假数据。移动端查SOP结果页「生成总结卡」按钮触发，底部弹层展示并可 TTS 朗读 | | 解析状态聚合 | `GET /api/knowledge/processing/overview` | 聚合 `aihr_knowledge_attach.status`、fragment 数、embedding 数、`sys_oss.ext1.fileSize`，生成资料处理页指标、分类、任务、链路和事件列表 | | 服务端目录导入 | `POST /api/knowledge/doc/import-local` | JSON `{ directory, category, limit }`；`directory` 只能是 `AIHR_IMPORT_ROOT` / `aihr.import.root` 下的相对目录，默认根目录为 `./.data/import`；逐文件复用上传解析链路，同步执行，保留给小批量/调试 | | 服务端导入任务 | `POST /api/knowledge/doc/import-local-task`、`GET /api/knowledge/doc/import-tasks`、`POST /api/knowledge/doc/import-tasks/{id}/cancel` | 启动后台目录导入并返回任务；任务写入 `aihr_knowledge_import_task`，页面轮询查看总数、成功数、失败数、当前文件和进度；运行中任务可取消；重试当前按同目录重新启动一轮 | diff --git a/docs/BACKLOG.md b/docs/BACKLOG.md index 17c7426a..a42afa99 100644 --- a/docs/BACKLOG.md +++ b/docs/BACKLOG.md @@ -95,6 +95,11 @@ 配套知识模型扩容:知识类型维度(SOP=标准 / 案例=参照 / 话术=直接能说 / 经验策略=火候),检索按类型分层供给;案例沉淀链路是隐性知识的采集入口,战略地位上调。 +### 零散待办 + +- **总结卡「保存图片」按钮**(设计基准 summary-modal 图内有):需 html2canvas 类依赖做 DOM 转图,2026-07-05 P0-2 实现时按"不加依赖"红线砍掉;引依赖或后端出图方案定型后补。 +- **员工端「学」板块**(我的地图橙色块):当前进「建设中」整页,承接 B8 五段旅程的岗前课程/每日小训模块。 + ## Future Enhancements ### Model Classification Version Governance diff --git a/docs/DEMO_ACCEPTANCE.md b/docs/DEMO_ACCEPTANCE.md index 48e68acc..51244f33 100644 --- a/docs/DEMO_ACCEPTANCE.md +++ b/docs/DEMO_ACCEPTANCE.md @@ -15,7 +15,7 @@ | 顺序 | 页面 | 点击路径 | 必须看到 | |---|---|---|---| | 1 | 首页 `/index` | 打开首页 | 只展示“首页 / AI面试 / 三角色对练 / 案例沉淀 / SOP知识库 / 资料处理 / 系统设置-模型配置” | -| 2 | 移动端三端 `http://127.0.0.1:5174/h5/user`、`/h5/candidate`、`/h5/supervisor` | 打开后先手机号登录；已配置 `AIHR_SMS_LOGIN_TEMPLATE_ID` 时可真实收短信，新手机号会自动注册；员工端首页为「今天要学/练完要复盘/工作中要用/碰到问题要报/我的成长」五个情境区，点“开始训练”完成两轮提交，再打开主管端；点「遇到问题，问一句」可文本/语音查 SOP 并看到引用片段；候选人端点“开始面试/面试练习”和“补充资料”；管理端 `/recruit/interview` 审核候选资料 | 员工端显示评分、“训练完成，主管端待复盘已更新”、训练历史和能力画像；底部 tab 为整页切换（首页/训练/知识/我的互斥渲染、切换回顶）；未实现入口点击弹「本期演示未开放」toast，无死按钮；主管端完训人数、“待复盘对练”计数和待复盘列表增加；训练页语音输入在浏览器录音失败时应切到“选择语音”而不是死按钮；点进待复盘记录可看评分、话术、导师改写，并可标记已复盘；候选人端可拉题/答题/评分，资料上传后显示“已提交资料”、`OSS ...`、`待审核`；HR 审核后候选人端显示 `已通过/已驳回`；接口不可用时走本地 fallback | +| 2 | 移动端三端 `http://127.0.0.1:5174/h5/user`、`/h5/candidate`、`/h5/supervisor` | 打开后先手机号登录；已配置 `AIHR_SMS_LOGIN_TEMPLATE_ID` 时可真实收短信，新手机号会自动注册；员工端首页为「师傅区(头像+气泡+按住说话/打字问+快捷chips)→今日安排→我的地图(问/练/学/报四色块)→我的成长摘要」，点“开始训练”完成两轮提交，再打开主管端；点快捷 chip 或「问」可文本/语音查 SOP，结果页点「生成总结卡·约10秒」弹出信息图卡（四步法/异议应对/开口话术/关键提醒+听一遍/开始跟读）；候选人端点“开始面试/面试练习”和“补充资料”；管理端 `/recruit/interview` 审核候选资料 | 员工端显示评分、“训练完成，主管端待复盘已更新”、训练历史和能力画像；底部 tab 整页切换（员工端为 今日/练/问/我，切换回顶），滚动后师傅头像收缩为右下悬浮球；未实现入口进「建设中」整页（返回首页按钮），无死按钮；主管端完训人数、“待复盘对练”计数和待复盘列表增加；训练页语音输入在浏览器录音失败时应切到“选择语音”而不是死按钮；点进待复盘记录可看评分、话术、导师改写，并可标记已复盘；候选人端可拉题/答题/评分，资料上传后显示“已提交资料”、`OSS ...`、`待审核`；HR 审核后候选人端显示 `已通过/已驳回`；接口不可用时走本地 fallback | | 3 | AI面试 `/recruit/interview` | 生成题目 → 填满参考回答或输入真实回答 → 完成评分 | 配置 chat 模型时真实生成题目和评分；未配置时用本地 Rubric 估分，不返回固定候选人分数；应看到新增面试记录 | | 4 | 三角色对练 `/train/practice` | 开始对练 → 填入参考回复或输入真实回复 → 继续一轮 → 结束并评分 | 已完成闭环、导师改写、新增对练记录；数据库已启用 chat 模型时，客户回复与评分为真实 LLM 生成（回复不再是固定台词，分数随话术变化），未配置时使用本地剧本兜底 | | 5 | 案例沉淀 `/knowledge/cases` | 上传真实语音 → ASR 转写 → AI 整理 → 送审 → 入库 → 查看样片 | 已完成闭环，案例列表新增真实转写生成的记录；视频仍用样片兜底 | diff --git a/docs/DEV_SETUP.md b/docs/DEV_SETUP.md index 25339597..8ab204b4 100644 --- a/docs/DEV_SETUP.md +++ b/docs/DEV_SETUP.md @@ -129,7 +129,7 @@ curl -k -s https://peilian.njzhmj.top/h5/supervisor | sed -n '1,20p' - 案例沉淀：进入 `/knowledge/cases`，上传真实语音 → “AI 整理” → “送审” → “入库”，应看到“已完成闭环”和新增案例记录；上传必须先完成 ASR 转写。 - SOP知识库：进入 `/knowledge/sop`，可上传 txt/md/PDF/Word/Excel/PPT 文档入库；点击“检索” → “生成训练题”，应看到“已完成闭环”、命中数据库 SOP 原文片段和训练题；数据库不可用时页面回退 seed。 - 资料处理：进入 `/knowledge/processing`，应看到资料总量、解析任务表、处理链路、规则与风险；可用少量文件验证“批量导入/选择目录/服务端导入”。**批量导入走异步队列**：提交即返回，页面出现“本次批量上传”进度面板（排队/加工中/完成/失败 + 单条重试），后台 worker 并发 2 逐条解析入库；暂存目录默认 `./.data/staging`（`aihr.upload.staging` 覆盖）。服务端导入读取 `./.data/import` 下的相对目录，启动后台任务并在页面显示进度，运行中任务可点“取消”；目录导入的重试粒度是同目录重新导入，批量上传的重试粒度是单文件。 -- 移动端员工训练：进入 `http://127.0.0.1:5174/h5/user`，手机号登录（dev 验证码固定 `123456`）。员工端首页为「今天要学/练完要复盘/工作中要用/碰到问题要报/我的成长」五个情境区，底部 tab（首页/训练/知识/我的）为整页切换；未实现入口点击弹「建设中」toast。“开始训练” → 两次“填入建议回复 / 提交本轮”，应看到评分、导师改写、训练历史和能力画像；切到主管端后完训人数与“待复盘对练”计数增加，并展示待复盘列表；点进单条可看评分、话术、导师改写，并可标记已复盘。训练页有“语音输入”和“播报”按钮，需启用 asr/tts 模型后生效；iOS/WebView 若无法直接访问麦克风，会切到“选择语音”并用系统录音/音频文件继续走 ASR，否则降级文本。「遇到问题，问一句」打开查 SOP 面板：文本/语音提问 → 返回回答+依据+引用片段（需后端在跑；语音需 asr 模型）。 +- 移动端员工训练：进入 `http://127.0.0.1:5174/h5/user`，手机号登录（dev 验证码固定 `123456`）。员工端首页为「师傅区(mentor.png 头像+气泡+按住说话/打字问+快捷chips)→今日安排→我的地图四色块→我的成长摘要」（视觉基准 `feedback/2026070423/design/`），底部 tab（今日/练/问/我）整页切换，滚动后师傅头像收缩为右下悬浮球；未实现入口进「建设中」整页。“开始训练” → 两次“填入建议回复 / 提交本轮”，应看到评分、导师改写、训练历史和能力画像；切到主管端后完训人数与“待复盘对练”计数增加，并展示待复盘列表；点进单条可看评分、话术、导师改写，并可标记已复盘。训练页有“语音输入”和“播报”按钮，需启用 asr/tts 模型后生效；iOS/WebView 若无法直接访问麦克风，会切到“选择语音”并用系统录音/音频文件继续走 ASR，否则降级文本。快捷 chip 或「问」打开查 SOP 面板：文本/语音提问 → 轻概要(回答+要点+注意)+依据折叠；点「生成总结卡·约10秒」弹出信息图卡（四步法/异议/话术/提醒+听一遍/开始跟读），需 chat 模型；语音需 asr 模型。 - 移动端候选人：进入 `http://127.0.0.1:5174/h5/candidate`，手机号登录（dev 验证码固定 `123456`）→ “开始面试/面试练习”完成答题评分；“补充资料”选择 PDF/Word/图片后上传，应看到“已提交资料”、`OSS ...`、`待审核`。再进入管理端 `/recruit/interview` 底部“候选资料审核”点“通过/驳回”，候选人端刷新后应显示新状态。Codex 内置浏览器不支持本地文件选择时，用真实 HTTP multipart smoke 代替浏览器文件选择。 - 真 LLM 激活：在 `/system/model` 给供应商填 api_host/api_key 并启用 `category=chat` 模型后，三角色对练的客户回复与评分即为真实 LLM 生成；再启用 `category=asr/tts`（如硅基流动 SenseVoice/CosyVoice2）语音路径生效。未配置时全链路自动回退 seed。