98 lines
4.6 KiB
Markdown
98 lines
4.6 KiB
Markdown
# 物业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` 覆盖。
|
||
|
||
## 启动步骤
|
||
|
||
在项目根目录执行：
|
||
|
||
```bash
|
||
./scripts/dev.sh
|
||
```
|
||
|
||
首次启动或需要重建本地 `ry-vue` Demo 数据库时执行：
|
||
|
||
```bash
|
||
./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 单独检查：
|
||
|
||
```bash
|
||
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` 下的相对目录，启动后台任务并在页面显示进度；当前重试粒度是同目录重新导入，不是单失败文件重试。
|
||
|
||
演示前可先跑最小预检：
|
||
|
||
```bash
|
||
./scripts/demo-check.sh
|
||
```
|
||
|
||
完整演示脚本与录屏兜底见 [DEMO_ACCEPTANCE.md](DEMO_ACCEPTANCE.md)。
|