prop-ai-hr/README.md

物业AI人力资源系统

基于 RuoYi-Vue-Plus 后端与 plus-ui 前端的银城员工端 APP 工程。2026-07 MVP 演示资料已归档；当前真相源是 BRD 审查、版本功能对比、生产迁移 Runbook 和正式试点门禁。

当前状态

• 后端：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 加密登录已验证。
• 管理端：除 AI 面试、训练、案例、SOP 和资料处理外，已包含常见难题、问题榜运营、知识空间、全网 AI 配置、组织权限和成长激励。
• 用户侧：mobile-uni/ 承载员工、候选人和主管三端；已接手机号登录、问师傅文字/语音/附件与播报、30 分钟短期多轮追问、原文件/视频受控交付，以及“记一下”确认卡、仅自己保存/提交公司待流转和权限化召回；同时包含三级字号、训练/题目反馈、开放问题榜与积分、岗位考试、案例、候选面试/资料、主管复盘/派发及学员模式。旧 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 展示等待解析、解析中、已完成、失败、片段数和向量化状态；任务列表按当前筛选结果前端分页（10/20/50 条，筛选或刷新回到第一页）。页面只保留“批量导入”，通过异步队列处理多文件或 ZIP，不提供浏览器目录选择和服务端目录导入入口。后端目录导入接口仅保留为运维/调试能力。
• 组织人员：aihr_org_snapshot 本地 reset 保留演示 seed；生产通过 POST /api/aihr/org/sync 同步外部组织。最近记录的生产快照为 3417 人、2938 人在职、3392 个手机号映射、175 名在职主管和 20 名项目经理；人数属于时点事实，发布或验收前应重新查询。
• 正式试点：管理端可按起止日期导出正式试点 CSV，严格门禁只统计唯一映射到在职组织的训练、校准和 SOP 评审。组织身份同步和至少 20 名手机号映射门槛已具备；下一步仍需选定真实试点窗口，产生员工训练、人工校准和 SOP 评审样本后重跑严格门禁，详见 演示与试点验收。
• 侧栏：只展示当前 AIHR 业务菜单；过滤名单在 frontend/src/layout/components/Sidebar/index.vue，不要恢复若依默认全量菜单。
• 本地短信：真实阿里云短信参数放根目录 .env.local，由 scripts/dev-backend.sh 自动加载；不要把密钥写入 application-dev.yml。dev 未配短信时验证码固定 123456（aihr.sms.dev-fixed-code，prod 强制失效）。
• 生产状态属于易变事实，不在总入口固定某次提交或迁移数量；发布前后按 BRD 功能审查记录、生产迁移 Runbook 和正式预检结果确认。正式 OTP 写链路、真机能力和严格试点仍需独立验收。

快速启动

./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 页面实现矩阵	70 张正式画板与代码/线上实现状态、二期边界和剩余动作
Figma 与线上 H5 差异矩阵	线上真实页面与 Figma 目标的差异、调整顺序和验收口径
本地运行手册	端口、账号、启动和基础验证
MVP 演示与验收清单	MVP 演示脚本、录屏兜底和验收口径
后端 API 对接指南	后端模块落点、正式试点 CSV、移动端训练/复盘、候选资料上传/审核和 SOP 上传解析接口
问师傅多轮会话与原始资料交付设计	已实现的短期会话、指代改写、意图路由、原文件/视频安全交付及分层验收记录
BRD 功能审查记录	现阶段结论、三端输入匹配矩阵、权限、迁移、线上资源和未完成项证据
BRD 生产迁移 Runbook	生产 schema/内置内容迁移、只读预检、发布和回滚边界
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 和实现切分

下一步

当前主线不是继续补页面，而是用正式 OTP、正式角色和真实手机完成读写/权限/设备验收，再选定 1–2 个项目、至少 20 名员工和固定时间窗，产生训练、校准、SOP 评审、满意度与案例样本后重跑严格门禁。功能现状看 BRD 功能审查记录，客户反馈看 版本功能对比，正式试点看 DEMO_ACCEPTANCE.md。