admin a6112b6559 docs: add phase-2 practice development plan v0.2
综合缺口分析修订版与 BRD v1.1 制定二期推进计划,并补齐逐项复核
发现的 6 处缺漏:#6/#9/#16/师徒演练处置、#13 定向再练落点(M4)、
画像雷达图承载、TechSpec P1 表映射、场景管理权限口径、G6 成本上限。
2026-07-06 22:13:24 +08:00

物业AI人力资源系统

基于 RuoYi-Vue-Plus 后端与 plus-ui 前端的一期 MVP 版工程。当前阶段目标是保住本地可运行骨架,并围绕招聘面试、三角色对练、案例沉淀、SOP 知识库落出可点击的 AI HR 英雄路径。

当前状态

  • 后端:backend,来自 dromara/RuoYi-Vue-Plus 的 5.X 分支。
  • 管理端前端:frontend,来自 CrazyLionCat/plus-ui 的 5.X 分支。
  • 移动端前端:mobile,独立 Vue/Vite 工程,承接员工端、候选人端、主管端。
  • 本地依赖:MySQL + Redis + MinIO + Qdrant 由 docker-compose.dev.yml 启动。
  • 品牌:前端标题为“物业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。员工端首页为「数字师傅」形态(师傅头像四状态+按住说话/打字问+快捷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知识库 / 资料处理 / 系统设置-模型配置”,其余若依默认菜单暂时隐藏。
  • 本地短信:真实阿里云短信参数放根目录 .env.local,由 scripts/dev-backend.sh 自动加载;不要把密钥写入 application-dev.yml。dev 未配短信时验证码固定 123456(aihr.sms.dev-fixed-code,prod 强制失效)。

快速启动

./scripts/dev.sh

首次启动或需要重建本地 MVP 数据库时执行 ./scripts/dev.sh --reset。详细端口、默认账号和验证项见 本地运行手册。

目录

路径 用途
backend/ RuoYi-Vue-Plus 后端基座
frontend/ plus-ui 管理端前端基座
mobile/ 员工端、候选人端、主管端独立移动端工程
scripts/ 本地 MVP 启动与数据重置脚本
docker-compose.dev.yml 本地 MySQL / Redis / MinIO / Qdrant
docs/ 项目文档、旧方案参考、Word 原件

文档索引

文档 用途
文档目录 docs 区完整索引
本地运行手册 端口、账号、启动和基础验证
MVP 演示与验收清单 MVP 演示脚本、录屏兜底和验收口径
后端 API 对接指南 后端模块落点、接口接入顺序、移动端训练记录、候选资料上传/审核和 SOP 上传解析接口
ruoyi-ai 能力分片迁移计划 知识库、模型能力、文档解析、RAG、chat 的渐进迁移边界
一期 MVP 版作战清单 MVP 范围、排期、验收切割线
业务需求 BRD 业务范围、角色、边界和验收
开发规格 TechSpec 模块、数据模型、路由、API 和实现切分
移动端设计 QA 三端首页高保真实现的截图对照记录

下一步

五个管理端关键页面和移动端三端首页已接入后端 API,并在前端保留失败回退。下一步按 ruoyi-ai 能力分片迁移计划 继续接 RAG 引用回答与最小 chat;当前已落知识库表、移动端训练记录表 aihr_practice_session、候选人资料表 aihr_candidate_material、员工训练历史、主管复盘列表、复盘详情、标记已复盘、能力画像、候选资料 OSS 上传与 HR 审核、住宅 SOP MySQL Fulltext + Qdrant 混合召回、OSS-first 文档上传、txt/md/PDF/Word/Excel/PPT 解析、图片视觉 OCR(配置 vision/chat 模型后上传 jpg/png 等自动识别文字)、embedding 写入、向量库状态/重建、模型供应商/模型配置、资料处理状态页和后台目录导入任务取消,不整包搬 ruoyi-chat。

S
Description
No description provided
Readme
50 MiB
Languages
Java 60.5%
Vue 21.9%
TypeScript 5.3%
JavaScript 4%
Shell 3.2%
Other 5.1%