66 lines
5.0 KiB
Markdown
66 lines
5.0 KiB
Markdown
# AGENTS.md
|
||
|
||
## 项目定位
|
||
|
||
这是“物业AI人力资源系统”一期 Demo 工程。目标是用 RuoYi-Vue-Plus + plus-ui 先跑通本地账号登录和可演示业务壳，再实现 AI HR 的最小英雄路径。
|
||
|
||
## 工程边界
|
||
|
||
- `backend/` 是 `dromara/RuoYi-Vue-Plus` 的 `5.X` 分支检出。
|
||
- `frontend/` 是 `CrazyLionCat/plus-ui` 的 `5.X` 分支检出。
|
||
- 本项目自己的本地编排放在根目录：`docker-compose.dev.yml`、`scripts/`；运行说明在 `docs/DEV_SETUP.md`。
|
||
- 除非确实要接业务模块，不要改上游框架默认配置；本地端口和开关优先放根目录脚本里覆盖。
|
||
|
||
## 本地运行
|
||
|
||
- MySQL：`127.0.0.1:13306`，库 `ry-vue`，账号 `root/root`。
|
||
- Redis：`127.0.0.1:16379`，密码 `ruoyi123`。
|
||
- MinIO：API `127.0.0.1:9000`，Console `127.0.0.1:9001`，账号 `ruoyi / ruoyi123`，bucket `ruoyi`。
|
||
- Qdrant：REST `127.0.0.1:6333`，默认 collection `aihr_knowledge`；可用 `AIHR_QDRANT_URL`、`AIHR_QDRANT_COLLECTION`、`AIHR_QDRANT_API_KEY` 覆盖。
|
||
- 资料导入根目录：默认 `./.data/import`，由 `scripts/dev-backend.sh` 传入 `aihr.import.root`；也可用 `AIHR_IMPORT_ROOT` 覆盖。
|
||
- 后端：`./scripts/dev-backend.sh`，端口 `8080`。
|
||
- 前端：`./scripts/dev-frontend.sh`，端口 `5173`。
|
||
- 重置数据：`./scripts/reset-dev-db.sh`，会删除并重建本地 `ry-vue`。
|
||
|
||
导入 SQL 必须带 `--default-character-set=utf8mb4`，否则中文昵称可能按错误字符集导入并触发字段长度问题。
|
||
|
||
## 验证口径
|
||
|
||
- 前端首页：`http://127.0.0.1:5173/`
|
||
- 租户接口：`http://127.0.0.1:5173/dev-api/auth/tenant/list`
|
||
- 验证码接口：`http://127.0.0.1:5173/dev-api/auth/code`
|
||
- 默认登录：租户 `000000`，管理员 `admin / admin123`。
|
||
|
||
## 品牌入口
|
||
|
||
- 页面标题在 `frontend/.env.development` 与 `frontend/.env.production`。
|
||
- 侧栏 logo 在 `frontend/src/assets/logo/logo.png`。
|
||
|
||
## Demo 前端边界
|
||
|
||
- 首页：`frontend/src/views/index.vue`，路由 `/index`。
|
||
- AI 面试：`frontend/src/views/recruit/interview.vue`，路由 `/recruit/interview`。
|
||
- 三角色对练：`frontend/src/views/train/practice.vue`，路由 `/train/practice`。
|
||
- 案例沉淀：`frontend/src/views/knowledge/cases.vue`，路由 `/knowledge/cases`。
|
||
- SOP 知识库：`frontend/src/views/knowledge/sop.vue`，路由 `/knowledge/sop`。
|
||
- 资料处理：`frontend/src/views/knowledge/processing.vue`，路由 `/knowledge/processing`。
|
||
- Demo 阶段侧栏只保留“首页 / AI面试 / 三角色对练 / 案例沉淀 / SOP知识库 / 资料处理 / 系统设置-模型配置”。过滤逻辑在 `frontend/src/layout/components/Sidebar/index.vue`，不要在未明确要求时恢复若依默认全量菜单。
|
||
- 当前业务页已用 seed 数据跑通可演示闭环；后端 API 对接先看 `docs/API_INTEGRATION.md`。
|
||
- 后端业务代码不要塞进上游 `ruoyi-demo`；自有 API 放在 `backend/ruoyi-modules/ruoyi-aihr`，再接入 `ruoyi-admin`。
|
||
- AI 面试页、三角色对练页、案例沉淀页、SOP 知识库页已是 API 优先 + 本地 fallback；SOP 知识库优先查 `aihr_knowledge_fragment` 的 MySQL Fulltext，并在 vector 模型和 Qdrant 可用时做混合召回；支持 `.txt/.md/.markdown/.pdf/.doc/.docx/.xls/.xlsx/.ppt/.pptx` 上传解析入库。
|
||
- SOP 上传接口是 `POST /api/knowledge/doc/upload`，表单字段为 `file` 和 `category`；当前限制 100MB 内，支持 txt/md/PDF/Word/Excel/PPT，先写 MinIO/`sys_oss` 再绑定 `aihr_knowledge_attach.oss_id`，同一知识库同名文件会替换旧 fragment。若数据库启用 `category=vector` 的模型配置，会同步调用 OpenAI-compatible `/embeddings`，写入 `embedding_json` 并尽力 upsert 到 Qdrant；Qdrant 不可用时保留 MySQL Fulltext/seed fallback。
|
||
- 资料处理接口是 `GET /api/knowledge/processing/overview`，直接聚合 `aihr_knowledge_attach`、`aihr_knowledge_fragment` 和 `sys_oss.ext1`；`POST /api/knowledge/doc/import-local` 保留同步导入，`POST /api/knowledge/doc/import-local-task` + `GET /api/knowledge/doc/import-tasks` 用于页面启动后台目录导入和轮询进度。目录只能是 `aihr.import.root` 下的相对路径，逐文件复用上传解析链路。
|
||
- seed service 阶段已完成；后续按 `docs/RUOYI_AI_INCREMENTAL_MIGRATION.md` 分片迁移 `ruoyi-ai` 的知识库、文档解析、RAG、chat 能力。
|
||
- 迁移时不要整包搬 `ruoyi-chat`；优先在 `ruoyi-aihr` 内吸收必要表、service、loader 和检索接口，并保留 seed fallback。
|
||
- 已落地的 seed 演示流不要退回静态壳：AI 面试、三角色对练、案例沉淀、SOP 知识库。
|
||
- 本项目 AI 表前缀用 `aihr_*`：知识库是 `aihr_knowledge_info/attach/fragment`，模型配置是 `aihr_model_provider/config`。
|
||
|
||
## 业务文档
|
||
|
||
- 总入口：`README.md`
|
||
- 文档索引：`docs/README.md`
|
||
- Demo 范围和止损线：`docs/AI人力资源系统一期Demo作战清单.md`
|
||
- 后端 API 对接：`docs/API_INTEGRATION.md`
|
||
- 业务需求：`docs/物业AI人力资源系统业务需求文档BRD.md`
|
||
- 开发规格：`docs/物业AI人力资源系统开发规格TechSpec.md`
|