admin
b550f54eb8
演示口径/验证步骤/README/AGENTS 全部对齐 P1 师傅层与 P0-2 总结卡 现状(师傅区四状态/今日安排/我的地图/tab今日练问我/建设中整页/ 总结卡弹层);API_INTEGRATION 补检索轻概要行为与 summary-card 端点 契约;AGENTS 移动端规则更新(状态源勿新造/visibleTabs 钉死/REVIEW 修正项优先);BACKLOG 记「保存图片」与「学」板块零散待办;删除 docs/prototypes 下与 design/ 重复的 5 张设计图副本。
56 lines
5.9 KiB
Markdown
56 lines
5.9 KiB
Markdown
# 物业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 强制失效）。
|
||
|
||
## 快速启动
|
||
|
||
```bash
|
||
./scripts/dev.sh
|
||
```
|
||
|
||
首次启动或需要重建本地 MVP 数据库时执行 `./scripts/dev.sh --reset`。详细端口、默认账号和验证项见 [本地运行手册](docs/DEV_SETUP.md)。
|
||
|
||
## 目录
|
||
|
||
| 路径 | 用途 |
|
||
|---|---|
|
||
| `backend/` | RuoYi-Vue-Plus 后端基座 |
|
||
| `frontend/` | plus-ui 管理端前端基座 |
|
||
| `mobile/` | 员工端、候选人端、主管端独立移动端工程 |
|
||
| `scripts/` | 本地 MVP 启动与数据重置脚本 |
|
||
| `docker-compose.dev.yml` | 本地 MySQL / Redis / MinIO / Qdrant |
|
||
| `docs/` | 项目文档、旧方案参考、Word 原件 |
|
||
|
||
## 文档索引
|
||
|
||
| 文档 | 用途 |
|
||
|---|---|
|
||
| [文档目录](docs/README.md) | docs 区完整索引 |
|
||
| [本地运行手册](docs/DEV_SETUP.md) | 端口、账号、启动和基础验证 |
|
||
| [MVP 演示与验收清单](docs/DEMO_ACCEPTANCE.md) | MVP 演示脚本、录屏兜底和验收口径 |
|
||
| [后端 API 对接指南](docs/API_INTEGRATION.md) | 后端模块落点、接口接入顺序、移动端训练记录、候选资料上传/审核和 SOP 上传解析接口 |
|
||
| [ruoyi-ai 能力分片迁移计划](docs/RUOYI_AI_INCREMENTAL_MIGRATION.md) | 知识库、模型能力、文档解析、RAG、chat 的渐进迁移边界 |
|
||
| [一期 MVP 版作战清单](docs/AI人力资源系统一期MVP版作战清单.md) | MVP 范围、排期、验收切割线 |
|
||
| [业务需求 BRD](docs/物业AI人力资源系统业务需求文档BRD.md) | 业务范围、角色、边界和验收 |
|
||
| [开发规格 TechSpec](docs/物业AI人力资源系统开发规格TechSpec.md) | 模块、数据模型、路由、API 和实现切分 |
|
||
| [移动端设计 QA](design-qa.md) | 三端首页高保真实现的截图对照记录 |
|
||
|
||
## 下一步
|
||
|
||
五个管理端关键页面和移动端三端首页已接入后端 API，并在前端保留失败回退。下一步按 [ruoyi-ai 能力分片迁移计划](docs/RUOYI_AI_INCREMENTAL_MIGRATION.md) 继续接 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`。
|