Files
prop-ai-hr/docs/DEV_SETUP.md
T
2026-07-03 01:25:10 +08:00

4.6 KiB
Raw Blame History

物业AI人力资源系统 Demo 本地启动

当前仓库

  • 后端:backend,来自 dromara/RuoYi-Vue-Plus 的 5.X 分支
  • 前端:frontend,来自 CrazyLionCat/plus-ui 的 5.X 分支

本地端口

  • 前端:http://127.0.0.1:5173/
  • 后端:http://127.0.0.1:8080/
  • MySQL:127.0.0.1:13306,数据库 ry-vue,账号 root/root
  • Redis:127.0.0.1:16379,密码 ruoyi123
  • MinIO API:http://127.0.0.1:9000,Console:http://127.0.0.1:9001,账号 ruoyi / ruoyi123,默认 bucket ruoyi
  • Qdrant REST:http://127.0.0.1:6333,默认 collection aihr_knowledge
  • 服务端资料导入根目录:./.data/import

Qdrant 默认本地无需配置;远端或自定义 collection 可用 AIHR_QDRANT_URL、AIHR_QDRANT_COLLECTION、AIHR_QDRANT_API_KEY 覆盖。服务端资料导入根目录可用 AIHR_IMPORT_ROOT 或 -Daihr.import.root 覆盖。

启动步骤

在项目根目录执行:

./scripts/dev.sh

首次启动或需要重建本地 ry-vue Demo 数据库时执行:

./scripts/dev.sh --reset

--reset 会删除并重建本地 Demo 数据库,只用于本地开发环境。

默认登录

  • 租户:000000
  • 管理员:admin / admin123
  • 测试账号:test / 666666、test1 / 666666

品牌资源

  • 页面标题:物业AI人力资源系统
  • 侧栏 Logo:frontend/src/assets/logo/logo.png

已验证的基础链路

  • MySQL、Redis 与 MinIO 容器健康检查通过
  • Qdrant 容器随本地开发编排启动,供 SOP 知识库向量召回使用
  • ry_vue_5.X.sql、ry_job.sql、ry_workflow.sql 已导入
  • aihr_knowledge_mysql8.sql、aihr_model_mysql8.sql 已导入;本地库含住宅 SOP seed 片段与模型配置表
  • SOP 知识库支持 .txt/.md/.markdown/.pdf/.doc/.docx/.xls/.xlsx/.ppt/.pptx 上传到 MinIO 后解析入库,接口为 POST /api/knowledge/doc/upload,单文件上限 100MB
  • 服务端目录导入接口为 POST /api/knowledge/doc/import-local-task,只读取导入根目录下的相对目录,后台逐文件复用同一上传解析链路;POST /api/knowledge/doc/import-local 保留为同步调试接口。
  • 启用 aihr_model_config.category='vector' 的模型配置后,上传会同步写入片段 embedding,并尽力 upsert 到 Qdrant;未配置或 Qdrant 不可用时只走 MySQL Fulltext/seed fallback,不影响检索。
  • 后端 ruoyi-admin 已完成 Maven 打包并启动在 8080
  • 前端依赖已安装,Vite 已启动在 5173
  • /dev-api/auth/tenant/list 与 /dev-api/auth/code 已通过前端代理返回 200
  • 000000 / admin / admin123 已通过真实加密登录接口返回 access_token

Qdrant 单独检查:

curl -fsS http://127.0.0.1:6333/

Demo 页面验证

登录后侧栏应只展示以下入口:

  • 首页:/index
  • AI面试:/recruit/interview
  • 三角色对练:/train/practice
  • 案例沉淀:/knowledge/cases
  • SOP知识库:/knowledge/sop
  • 资料处理:/knowledge/processing
  • 系统设置-模型配置:/system/model

若依默认菜单如“系统管理 / 租户管理 / 系统监控 / 系统工具 / 测试菜单”在当前 Demo 阶段应保持隐藏。

Demo 演示流验证

当前已跑通四个本地演示流:

  • AI面试:进入 /recruit/interview,点击“生成题目” → “填满 seed 回答” → “完成评分”,应看到“已完成闭环”“建议复试”和新增面试记录。
  • 三角色对练:进入 /train/practice,点击“开始对练” → 两次“填入 seed 回复 / 继续一轮” → “结束并评分”,应看到“已完成闭环”“导师改写”和新增对练记录。
  • 案例沉淀:进入 /knowledge/cases,点击“选择样例录音” → “AI 整理” → “送审” → “入库”,应看到“已完成闭环”和新增 seed入库 记录。
  • SOP知识库:进入 /knowledge/sop,可上传 txt/md/PDF/Word/Excel/PPT 文档入库;点击“检索” → “生成训练题”,应看到“已完成闭环”、命中数据库 SOP 原文片段和训练题;数据库不可用时页面回退 seed。
  • 资料处理:进入 /knowledge/processing,应看到资料总量、解析任务表、处理链路、规则与风险;可用少量文件验证“批量导入/选择目录/服务端导入”。服务端导入读取 ./.data/import 下的相对目录,启动后台任务并在页面显示进度;当前重试粒度是同目录重新导入,不是单失败文件重试。

演示前可先跑最小预检:

./scripts/demo-check.sh

完整演示脚本与录屏兜底见 DEMO_ACCEPTANCE.md。