docs: sync production release truth
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# 物业AI人力资源系统
|
||||
|
||||
基于 RuoYi-Vue-Plus 后端与 plus-ui 前端的物业 AI 人力资源系统工程。2026-07 MVP 演示资料已归档；当前施工入口是演示验收清单和 AI 陪练二期推进计划。
|
||||
基于 RuoYi-Vue-Plus 后端与 plus-ui 前端的银城员工端 APP 工程。2026-07 MVP 演示资料已归档；当前真相源是 BRD 审查、版本功能对比、生产迁移 Runbook 和正式试点门禁。
|
||||
|
||||
## 当前状态
|
||||
|
||||
@@ -9,16 +9,16 @@
|
||||
- 用户侧前端：`mobile-uni`，uni-app Vue3 H5 工程，承接员工端、候选人端、主管端；旧 `mobile` 保留为 MVP 演示兜底。
|
||||
- 本地依赖：MySQL + Redis + MinIO + Qdrant 由 `docker-compose.dev.yml` 启动。
|
||||
- 品牌：前端标题为“物业AI人力资源系统”，侧栏 logo 使用银城物业图标。
|
||||
- 已验证：租户列表、验证码、`000000 / admin / admin123` 加密登录链路。
|
||||
- 管理端 MVP：首页与五个关键页面已落地，路由为 `/index`、`/recruit/interview`、`/train/practice`、`/knowledge/cases`、`/knowledge/sop`、`/knowledge/processing`。
|
||||
- 用户侧 Alpha：三端已在 `mobile-uni/` 按真实页面栈重建，portless 本地入口为 `https://wygj-mobile-uni.localhost/h5/`；员工端路由为 `/h5/#/pages/user/today/index`、`/practice/index`、`/sop/index`、`/profile/index`，候选人端为 `/h5/#/pages/candidate/index/index`，主管端为 `/h5/#/pages/supervisor/index/index`。已接手机号短信登录、问师傅检索/反馈/总结卡、员工训练闭环、案例素材入库、候选人面试/资料、主管复盘/派专项；旧 `mobile/` 不再作为新增功能承载面。三端输入不是统一全模态：员工对练/每日题支持文字和语音、问师傅仅文字，候选面试支持文字和语音且补充资料可传图片，主管端以文字复盘和录音回听为主；详见 [BRD 功能审查记录](docs/BRD_IMPLEMENTATION_AUDIT.md)。
|
||||
- 基础链路：租户列表、验证码、`000000 / admin / admin123` 加密登录已验证。
|
||||
- 管理端：除 AI 面试、训练、案例、SOP 和资料处理外，已包含常见难题、问题榜运营、知识空间、全网 AI 配置、组织权限和成长激励。
|
||||
- 用户侧：`mobile-uni/` 承载员工、候选人和主管三端；已接手机号登录、问师傅文字/语音/附件与播报、三级字号、训练/题目反馈、开放问题榜与积分、岗位考试、案例、候选面试/资料、主管复盘/派发及学员模式。旧 `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` 从 `/api/open/v1/sync/snapshot` 拉取公司、部门、员工快照并刷新本地组织人员口径。2026-07-15 已在线上完成外部同步配置和覆盖同步，生产快照为 3417 名员工，其中 3392 人可通过手机号映射，25 人为上游手机号数据不可用。
|
||||
- 组织人员：`aihr_org_snapshot` 本地 reset 保留演示 seed；生产通过 `POST /api/aihr/org/sync` 同步外部组织。最近记录的生产快照为 3417 人、2938 人在职、3392 个手机号映射、175 名在职主管和 20 名项目经理；人数属于时点事实，发布或验收前应重新查询。
|
||||
- 正式试点：管理端可按起止日期导出正式试点 CSV，严格门禁只统计唯一映射到在职组织的训练、校准和 SOP 评审。组织身份同步和至少 20 名手机号映射门槛已具备；下一步仍需选定真实试点窗口，产生员工训练、人工校准和 SOP 评审样本后重跑严格门禁，详见 [演示与试点验收](docs/DEMO_ACCEPTANCE.md)。
|
||||
- 侧栏：MVP 阶段只展示“首页 / AI面试 / 三角色对练 / 案例沉淀 / 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 强制失效）。
|
||||
- 生产发布：先执行 `scripts/release-preflight.sh`，再按 [BRD 生产迁移 Runbook](docs/BRD_PRODUCTION_MIGRATION_RUNBOOK.md) 处理 schema、内置内容、备份、回滚和发布后回归；本地构建或 strict gate 通过，都不能单独证明线上已发布。
|
||||
- 生产基线（2026-07-18）：`32fa376d` 已发布，管理端/H5/后端产物哈希一致，21 个迁移完成，目标 schema `34/34`、新增表排序规则兼容 `18/18`；服务、公开 HTTP 和关键页面已验证。正式 OTP 写链路、真机能力和严格试点仍未验收，详见 [BRD 功能审查记录](docs/BRD_IMPLEMENTATION_AUDIT.md)。
|
||||
|
||||
## 快速启动
|
||||
|
||||
@@ -59,11 +59,11 @@
|
||||
| [AI 陪练二期开发推进计划](docs/AI陪练二期开发推进计划.md) | 总纲阶段一执行文档:从 MVP 演示闭环推进到管家(生活顾问)岗位试点可用 |
|
||||
| [银城员工端APP分阶段实施总纲](docs/银城员工端APP分阶段实施总纲.md) | 2026-07-07 立项会后的三阶段总纲与阶段二/三边界 |
|
||||
| [数字师傅学练问报整合方案](docs/20260708/数字师傅学练问报整合方案.md) | 2026-07-08 产品讨论定案:学练问报四模块、开放问题榜、学分晋升、发布会「生活顾问的一天」 |
|
||||
| [AI 陪练缺口修订版](docs/AI陪练功能优化与缺口分析(修订).md) | 24 项陪练缺口的代码实况校对和二期排期依据 |
|
||||
| [AI 陪练缺口修订版](docs/AI陪练功能优化与缺口分析%28修订%29.md) | 24 项陪练缺口的代码实况校对和二期排期依据 |
|
||||
| [阶段交付归档](docs/archive/2026-07-mvp-delivery/) | 2026-07 MVP 作战清单、演示 PPT、设计 QA 记录和阶段交付材料 |
|
||||
| [业务需求 BRD](docs/物业AI人力资源系统业务需求文档BRD.md) | 业务范围、角色、边界和验收 |
|
||||
| [开发规格 TechSpec](docs/物业AI人力资源系统开发规格TechSpec.md) | 模块、数据模型、路由、API 和实现切分 |
|
||||
|
||||
## 下一步
|
||||
|
||||
现役验收入口是 [DEMO_ACCEPTANCE.md](docs/DEMO_ACCEPTANCE.md)。阶段一的工程闭环和正式组织同步已就绪，当前主线是选定 1–2 个项目、至少 20 名员工的真实试点窗口，产生训练、校准和 SOP 业务评审样本后重跑 M5 严格门禁；详见 [AI 陪练二期开发推进计划](docs/AI陪练二期开发推进计划.md)。大喇叭信息平台、知识学习平台和北森对接属阶段二/三，不进当前主线。后续迭代同时参考 [H5_REDESIGN.md](docs/H5_REDESIGN.md)、[BACKLOG.md](docs/BACKLOG.md) 和 [ruoyi-ai 能力分片迁移计划](docs/RUOYI_AI_INCREMENTAL_MIGRATION.md)，不把归档排期当当前待办。
|
||||
当前主线不是继续补页面，而是用正式 OTP、正式角色和真实手机完成读写/权限/设备验收，再选定 1–2 个项目、至少 20 名员工和固定时间窗，产生训练、校准、SOP 评审、满意度与案例样本后重跑严格门禁。功能现状看 [BRD 功能审查记录](docs/BRD_IMPLEMENTATION_AUDIT.md)，客户反馈看 [版本功能对比](docs/员工端版本功能对比与功能对齐清单-20260717.md)，正式试点看 [DEMO_ACCEPTANCE.md](docs/DEMO_ACCEPTANCE.md)。
|
||||
|
||||
Reference in New Issue
Block a user