From 1d14497bc3535d28a13af7e915019461bdd87cc1 Mon Sep 17 00:00:00 2001 From: let5sne Date: Tue, 7 Jul 2026 11:06:21 +0800 Subject: [PATCH] docs: sync entry docs to phased plan structure MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit AGENTS.md/README.md 项目定位并入立项会重定位(银城员工端 APP、 三阶段边界、管家=生活顾问);docs/README.md 索引补总纲、立项会 纪要与组织同步接口设计;组织快照口径更新为可外部同步。 --- AGENTS.md | 7 ++++--- README.md | 6 ++++-- docs/README.md | 5 ++++- 3 files changed, 12 insertions(+), 6 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 0e6b4aa9..2cea1902 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,7 +2,7 @@ ## 项目定位 -这是“物业AI人力资源系统”工程。2026-07 MVP 演示资料已归档；当前开发按 `docs/DEMO_ACCEPTANCE.md` 守住演示验收口径，并按 `docs/AI陪练二期开发推进计划.md` 推进生活顾问岗位试点可用。不要把归档作战清单当当前待办，也不要把演示闭环写成一期生产验收完成。 +这是“物业AI人力资源系统”工程,2026-07-07 立项会后交付物升级为**银城员工端 APP**(H5 套壳,分三阶段:陪练 → 大喇叭+知识学习平台 → 北森对接,见 `docs/银城员工端APP分阶段实施总纲.md`)。2026-07 MVP 演示资料已归档;当前开发按 `docs/DEMO_ACCEPTANCE.md` 守住演示验收口径,并按 `docs/AI陪练二期开发推进计划.md`(总纲阶段一)推进管家(生活顾问)岗位试点可用——“管家”与“生活顾问”是同一岗位,`position` 标签沿用现有值。不要把归档作战清单当当前待办,也不要把演示闭环写成一期生产验收完成,更不要把大喇叭/品检翻转/北森对接拉进阶段一。 ## 工程边界 @@ -72,7 +72,7 @@ - seed service 阶段已完成；后续按 `docs/RUOYI_AI_INCREMENTAL_MIGRATION.md` 分片迁移 `ruoyi-ai` 的知识库、文档解析、RAG、chat 能力。 - 迁移时不要整包搬 `ruoyi-chat`；优先在 `ruoyi-aihr` 内吸收必要表、service、loader 和检索接口，并保留 seed fallback。 - 已落地的演示流不要退回静态壳：AI 面试、三角色对练、案例沉淀已是真模型优先（未配置/失败回退本地兜底），SOP 知识库、移动端三端首页保留 fallback——改造时降级链必须保留。 -- 本项目 AI 表前缀用 `aihr_*`：知识库是 `aihr_knowledge_info/attach/fragment`，上传队列是 `aihr_knowledge_upload_item`，导入任务是 `aihr_knowledge_import_task`，模型配置是 `aihr_model_provider/config`，移动端训练记录是 `aihr_practice_session`，候选人补充资料是 `aihr_candidate_material`，组织人员快照是 `aihr_org_snapshot`（Demo 静态数据，生产走外部同步）。 +- 本项目 AI 表前缀用 `aihr_*`：知识库是 `aihr_knowledge_info/attach/fragment`，上传队列是 `aihr_knowledge_upload_item`，导入任务是 `aihr_knowledge_import_task`，模型配置是 `aihr_model_provider/config`，移动端训练记录是 `aihr_practice_session`，候选人补充资料是 `aihr_candidate_material`，组织人员快照是 `aihr_org_snapshot`（本地 reset 有 Demo seed；生产/试点从 `docs/open-org-sync-api-design-v1.md` 对应开放组织系统同步，入口 `POST /api/aihr/org/sync`）。 ## 业务文档 @@ -80,7 +80,8 @@ - 文档索引：`docs/README.md` - MVP 演示与验收：`docs/DEMO_ACCEPTANCE.md` - 阶段交付归档：`docs/archive/2026-07-mvp-delivery/` -- AI 陪练二期推进：`docs/AI陪练二期开发推进计划.md` +- 分阶段总纲：`docs/银城员工端APP分阶段实施总纲.md` +- AI 陪练二期推进（阶段一执行）：`docs/AI陪练二期开发推进计划.md` - AI 陪练缺口修订：`docs/AI陪练功能优化与缺口分析(修订).md` - 后端 API 对接：`docs/API_INTEGRATION.md` - 对外会议版口径：`docs/AI人力资源系统项目规划方案与AI接口说明.md` diff --git a/README.md b/README.md index c677fd3b..11ad6c5c 100644 --- a/README.md +++ b/README.md @@ -14,6 +14,7 @@ - 移动端 MVP：三端首页已拆到独立工程 `mobile/`；路由为 `/h5/user`、`/h5/candidate`、`/h5/supervisor`，并兼容 `/h5/employee`、`/h5/admin`；已接手机号短信登录、`GET /api/aihr/mobile/home/{role}` 首页 API。员工端首页为「数字师傅」形态（师傅头像四状态+按住说话/打字问+快捷chips→今日安排→我的地图四色块→成长摘要，视觉基准 `docs/feedback/2026070423/design/`），底部 tab 今日/练/问/我整页切换；“开始训练”可完成两轮三角色对练，记录落 `aihr_practice_session` 并刷新主管端待复盘列表、复盘详情、标记已复盘状态和员工能力画像；「查 SOP」文本/语音提问返回结构化概要+引用片段，可按需生成信息图总结卡（听一遍/开始跟读）；候选人端“开始面试/面试练习”复用 AI 面试 API 拉题、作答、评分，“补充资料”走 OSS + `aihr_candidate_material` 入库，HR 可在 AI 面试页审核通过/驳回；前端保留本地 fallback。 - 英雄路径：AI 面试（真模型出题/评分）、三角色对练（真 LLM 客户回复+评分，asr/tts 配置后支持语音）、案例沉淀（真实语音上传+ASR 转写+模型整理）均为真模型优先、未配置或失败回退本地兜底；SOP 知识库已接中文关键词 + MySQL Fulltext + Qdrant 混合召回 + rerank 重排，支持 txt/md/PDF/Word/Excel/PPT/图片/视频上传解析入库（图片走 vision OCR，视频走 ffmpeg 抽音轨转写+关键帧描述）；模型配置页可查看向量库维度/点数并一键重建。 - 资料处理：已新增解析任务状态页，按 `aihr_knowledge_attach` 和 `aihr_knowledge_fragment` 展示等待解析、解析中、已完成、失败、片段数和向量化状态；页面支持多文件/浏览器目录选择，也支持从后端 `AIHR_IMPORT_ROOT` 下启动后台目录导入任务、轮询进度并取消运行中任务。 +- 组织人员：`aihr_org_snapshot` 本地 reset 保留演示 seed；配置开放组织同步系统后，通过 `POST /api/aihr/org/sync` 从 `/open/v1/sync/snapshot` 拉取公司、部门、员工快照并刷新本地组织人员口径。 - 侧栏：MVP 阶段只展示“首页 / AI面试 / 三角色对练 / 案例沉淀 / SOP知识库 / 资料处理 / 系统设置-模型配置”，其余若依默认菜单暂时隐藏。 - 本地短信：真实阿里云短信参数放根目录 `.env.local`，由 `scripts/dev-backend.sh` 自动加载；不要把密钥写入 `application-dev.yml`。dev 未配短信时验证码固定 `123456`（`aihr.sms.dev-fixed-code`，prod 强制失效）。 @@ -46,7 +47,8 @@ | [后端 API 对接指南](docs/API_INTEGRATION.md) | 后端模块落点、接口接入顺序、移动端训练记录、候选资料上传/审核和 SOP 上传解析接口 | | [ruoyi-ai 能力分片迁移计划](docs/RUOYI_AI_INCREMENTAL_MIGRATION.md) | 知识库、模型能力、文档解析、RAG、chat 的渐进迁移边界 | | [项目规划方案与 AI 接口说明](docs/AI人力资源系统项目规划方案与AI接口说明.md) | 对外会议版口径、数字师傅定位和 AI 接口规划 | -| [AI 陪练二期开发推进计划](docs/AI陪练二期开发推进计划.md) | 从 MVP 演示闭环推进到生活顾问岗位试点可用的二期实施计划 | +| [AI 陪练二期开发推进计划](docs/AI陪练二期开发推进计划.md) | 总纲阶段一执行文档:从 MVP 演示闭环推进到管家(生活顾问)岗位试点可用 | +| [银城员工端APP分阶段实施总纲](docs/银城员工端APP分阶段实施总纲.md) | 2026-07-07 立项会后的三阶段总纲与阶段二/三边界 | | [AI 陪练缺口修订版](docs/AI陪练功能优化与缺口分析(修订).md) | 24 项陪练缺口的代码实况校对和二期排期依据 | | [阶段交付归档](docs/archive/2026-07-mvp-delivery/) | 2026-07 MVP 作战清单、演示 PPT 和阶段交付材料 | | [业务需求 BRD](docs/物业AI人力资源系统业务需求文档BRD.md) | 业务范围、角色、边界和验收 | @@ -55,4 +57,4 @@ ## 下一步 -现役演示验收入口是 [DEMO_ACCEPTANCE.md](docs/DEMO_ACCEPTANCE.md)。2026-07 MVP 作战清单和演示材料已归档；AI 陪练二期按 [AI 陪练二期开发推进计划](docs/AI陪练二期开发推进计划.md) 推进，后续 P1 迭代同时参考 [H5_REDESIGN.md](docs/H5_REDESIGN.md)、[BACKLOG.md](docs/BACKLOG.md) 和 [ruoyi-ai 能力分片迁移计划](docs/RUOYI_AI_INCREMENTAL_MIGRATION.md)，不把归档排期当当前待办。 +现役演示验收入口是 [DEMO_ACCEPTANCE.md](docs/DEMO_ACCEPTANCE.md)。2026-07-07 立项会后按 [银城员工端APP分阶段实施总纲](docs/银城员工端APP分阶段实施总纲.md) 三阶段推进:阶段一即 [AI 陪练二期开发推进计划](docs/AI陪练二期开发推进计划.md)(时间锚点 2026-07-10 Alpha → 半年会发布 → 9 月收费季前试点可用);大喇叭信息平台、知识学习平台、北森对接属阶段二/三,不进当前主线。后续迭代同时参考 [H5_REDESIGN.md](docs/H5_REDESIGN.md)、[BACKLOG.md](docs/BACKLOG.md) 和 [ruoyi-ai 能力分片迁移计划](docs/RUOYI_AI_INCREMENTAL_MIGRATION.md),不把归档排期当当前待办。 diff --git a/docs/README.md b/docs/README.md index 26f47201..57530622 100644 --- a/docs/README.md +++ b/docs/README.md @@ -11,7 +11,10 @@ | [API_INTEGRATION.md](API_INTEGRATION.md) | 后端 API 对接顺序、业务模块落点、移动端训练记录/复盘详情、候选资料上传/审核、SOP 上传解析接口 | | [RUOYI_AI_INCREMENTAL_MIGRATION.md](RUOYI_AI_INCREMENTAL_MIGRATION.md) | 从 `ageerle/ruoyi-ai` 分片迁移知识库、模型能力、文档解析、Qdrant/RAG 和 chat 的执行边界 | | [AI人力资源系统项目规划方案与AI接口说明.md](AI人力资源系统项目规划方案与AI接口说明.md) | 对外会议版口径、数字师傅定位、AI 接口和供应商规划 | -| [AI陪练二期开发推进计划.md](AI陪练二期开发推进计划.md) | AI 陪练二期从 MVP 演示闭环推进到生活顾问岗位试点可用的实施计划 | +| [银城员工端APP分阶段实施总纲.md](银城员工端APP分阶段实施总纲.md) | 2026-07-07 立项会后的三阶段总纲:陪练 → 大喇叭+知识学习平台 → 北森对接;身份三轴模型与防遗漏分发策略 | +| [AI陪练二期开发推进计划.md](AI陪练二期开发推进计划.md) | 总纲阶段一执行文档:AI 陪练从 MVP 演示闭环推进到管家(生活顾问)岗位试点可用 | +| [基于AI的银城员工端APP项目立项与开发规划会议-2026年07月07日-来自【Get 笔记】.md](基于AI的银城员工端APP项目立项与开发规划会议-2026年07月07日-来自【Get%20笔记】.md) | 2026-07-07 立项会纪要原文(总纲的输入源,只作留档) | +| [open-org-sync-api-design-v1.md](open-org-sync-api-design-v1.md) | 开放组织同步系统 `/open/v1` 接口设计,`POST /api/aihr/org/sync` 的外部契约 | | [物业AI人力资源系统业务需求文档BRD.md](物业AI人力资源系统业务需求文档BRD.md) | 业务需求、范围边界、角色、风险与验收 | | [物业AI人力资源系统开发规格TechSpec.md](物业AI人力资源系统开发规格TechSpec.md) | 工程结构、数据模型、页面路由、API 和核心实现规格 | | [BACKLOG.md](BACKLOG.md) | 需求池与延后事项（B1–B8：数据权限/人设语音/生成图片/生成视频/员工画像/视觉检索/数字师傅） |