物业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-uni，uni-app Vue3 H5 工程，承接员工端、候选人端、主管端；旧 mobile 保留为 MVP 演示兜底。
• 本地依赖：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。
• 用户侧 Alpha：三端已在 mobile-uni/ 按真实页面栈重建，portless 本地入口为 https://wygj-mobile-uni.localhost/h5/；员工端路由为 /h5/#/pages/user/today/index、/practice/index、/sop/index、/profile/index，候选人端为 /h5/#/pages/candidate/index/index，主管端为 /h5/#/pages/supervisor/index/index。已接手机号短信登录、问师傅检索/反馈/总结卡、员工训练闭环、案例素材入库、候选人面试/资料、主管复盘/派专项；旧 mobile/ 不再作为新增功能承载面。
• 英雄路径：AI 面试（真模型出题/评分）、三角色对练（真 LLM 客户回复+评分，asr/tts 配置后支持语音）、案例沉淀（真实语音上传+ASR 转写+模型整理）均为真模型优先、未配置或失败回退本地兜底；SOP 知识库已接中文关键词 + MySQL Fulltext + Qdrant 混合召回 + rerank 重排，支持 txt/md/PDF/Word/Excel/PPT/图片/视频上传解析入库（图片走 vision OCR，视频走 ffmpeg 抽音轨转写+关键帧描述），资料处理中心支持 ZIP 异步展开后逐文件入队；模型配置页可查看向量库维度/点数并一键重建。
• 资料处理：已新增解析任务状态页，按 aihr_knowledge_attach 和 aihr_knowledge_fragment 展示等待解析、解析中、已完成、失败、片段数和向量化状态；页面支持多文件/浏览器目录选择，也支持从后端 AIHR_IMPORT_ROOT 下启动后台目录导入任务、轮询进度并取消运行中任务。
• 组织人员：aihr_org_snapshot 本地 reset 保留演示 seed；配置开放组织同步系统后，通过 POST /api/aihr/org/sync 从 /api/open/v1/sync/snapshot 拉取公司、部门、员工快照并刷新本地组织人员口径。
• 正式试点：管理端可按起止日期导出正式试点 CSV，严格门禁只统计唯一映射到在职组织的训练、校准和 SOP 评审。工程已验证；当前上游仅提供 1 个可用手机号，尚未满足至少 20 名正式试点人员的业务门槛，详见 演示与试点验收。
• 侧栏：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。./scripts/dev.sh 默认通过 portless 启动后端、管理端和当前 mobile-uni 用户侧，对应入口为 https://wygj-api.localhost/、https://wygj-admin.localhost/、https://wygj-mobile-uni.localhost/h5/。只有显式 PORTLESS=0 ./scripts/dev.sh 时才回退固定端口和旧移动端兜底。详细端口、默认账号和验证项见 本地运行手册。

目录

路径	用途
backend/	RuoYi-Vue-Plus 后端基座
frontend/	plus-ui 管理端前端基座
mobile-uni/	当前用户侧 uni-app H5 工程
mobile/	旧移动端 H5，保留为 MVP 演示兜底
scripts/	本地 MVP 启动与数据重置脚本
docker-compose.dev.yml	本地 MySQL / Redis / MinIO / Qdrant
docs/	项目文档、旧方案参考、Word 原件

文档索引

文档	用途
文档目录	docs 区完整索引
Figma 设计资产清单	79 个页面、71 张正式画板的节点索引、批次范围和一致性审计结果
Figma 视觉系统使用规范	通用视觉元素、业务元素、状态映射和 LLM 组页规则
Figma 与线上 H5 差异矩阵	线上真实页面与 Figma 目标的差异、调整顺序和验收口径
本地运行手册	端口、账号、启动和基础验证
MVP 演示与验收清单	MVP 演示脚本、录屏兜底和验收口径
后端 API 对接指南	后端模块落点、正式试点 CSV、移动端训练/复盘、候选资料上传/审核和 SOP 上传解析接口
ruoyi-ai 能力分片迁移计划	知识库、模型能力、文档解析、RAG、chat 的渐进迁移边界
项目规划方案与 AI 接口说明	对外会议版口径、数字师傅定位和 AI 接口规划
AI 陪练二期开发推进计划	总纲阶段一执行文档:从 MVP 演示闭环推进到管家(生活顾问)岗位试点可用
银城员工端APP分阶段实施总纲	2026-07-07 立项会后的三阶段总纲与阶段二/三边界
数字师傅学练问报整合方案	2026-07-08 产品讨论定案:学练问报四模块、开放问题榜、学分晋升、发布会「生活顾问的一天」
AI 陪练缺口修订版	24 项陪练缺口的代码实况校对和二期排期依据
阶段交付归档	2026-07 MVP 作战清单、演示 PPT、设计 QA 记录和阶段交付材料
业务需求 BRD	业务范围、角色、边界和验收
开发规格 TechSpec	模块、数据模型、路由、API 和实现切分

下一步

现役验收入口是 DEMO_ACCEPTANCE.md。阶段一的工程闭环已经就绪，当前唯一主线是补齐正式组织身份数据，完成 1–2 个项目、至少 20 名员工的真实训练、校准和 SOP 业务评审后重跑 M5 严格门禁；详见 AI 陪练二期开发推进计划。大喇叭信息平台、知识学习平台和北森对接属阶段二/三，不进当前主线。后续迭代同时参考 H5_REDESIGN.md、BACKLOG.md 和 ruoyi-ai 能力分片迁移计划，不把归档排期当当前待办。