AGENTS.md/README.md 项目定位并入立项会重定位(银城员工端 APP、 三阶段边界、管家=生活顾问);docs/README.md 索引补总纲、立项会 纪要与组织同步接口设计;组织快照口径更新为可外部同步。
6.5 KiB
6.5 KiB
物业AI人力资源系统
基于 RuoYi-Vue-Plus 后端与 plus-ui 前端的物业 AI 人力资源系统工程。2026-07 MVP 演示资料已归档;当前施工入口是演示验收清单和 AI 陪练二期推进计划。
当前状态
- 后端:
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下启动后台目录导入任务、轮询进度并取消运行中任务。 - 组织人员:
aihr_org_snapshot本地 reset 保留演示 seed;配置开放组织同步系统后,通过POST /api/aihr/org/sync从/open/v1/sync/snapshot拉取公司、部门、员工快照并刷新本地组织人员口径。 - 侧栏: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 的渐进迁移边界 |
| 项目规划方案与 AI 接口说明 | 对外会议版口径、数字师傅定位和 AI 接口规划 |
| AI 陪练二期开发推进计划 | 总纲阶段一执行文档:从 MVP 演示闭环推进到管家(生活顾问)岗位试点可用 |
| 银城员工端APP分阶段实施总纲 | 2026-07-07 立项会后的三阶段总纲与阶段二/三边界 |
| AI 陪练缺口修订版 | 24 项陪练缺口的代码实况校对和二期排期依据 |
| 阶段交付归档 | 2026-07 MVP 作战清单、演示 PPT 和阶段交付材料 |
| 业务需求 BRD | 业务范围、角色、边界和验收 |
| 开发规格 TechSpec | 模块、数据模型、路由、API 和实现切分 |
| 移动端设计 QA | 三端首页高保真实现的截图对照记录 |
下一步
现役演示验收入口是 DEMO_ACCEPTANCE.md。2026-07-07 立项会后按 银城员工端APP分阶段实施总纲 三阶段推进:阶段一即 AI 陪练二期开发推进计划(时间锚点 2026-07-10 Alpha → 半年会发布 → 9 月收费季前试点可用);大喇叭信息平台、知识学习平台、北森对接属阶段二/三,不进当前主线。后续迭代同时参考 H5_REDESIGN.md、BACKLOG.md 和 ruoyi-ai 能力分片迁移计划,不把归档排期当当前待办。