85 lines
14 KiB
Markdown
85 lines
14 KiB
Markdown
# 帮道
|
||
|
||
基于 RuoYi-Vue-Plus 后端与 plus-ui 前端的帮道 APP 工程。2026-07 MVP 演示资料已归档；当前真相源是 BRD 审查、版本功能对比、生产迁移 Runbook 和正式试点门禁。
|
||
|
||
## 当前状态
|
||
|
||
- 后端：`backend`，来自 `dromara/RuoYi-Vue-Plus` 的 `5.X` 分支。
|
||
- 管理端前端：`frontend`，来自 `CrazyLionCat/plus-ui` 的 `5.X` 分支。
|
||
- 用户侧前端：`mobile-uni`，uni-app Vue3 H5 + App-Plus 工程，承接员工端、候选人端、主管端；旧 `mobile` 保留为 MVP 演示兜底。原生资源构建、签名边界和真机验收见 [原生 App 打包](docs/MOBILE_APP_PACKAGING.md)。
|
||
- 本地依赖：MySQL + Redis + MinIO + Qdrant 由 `docker-compose.dev.yml` 启动。
|
||
- 品牌：管理端与员工端统一显示“帮道”，继续使用现有红色品牌图标。
|
||
- 基础链路：租户列表、验证码、`000000 / admin / admin123` 加密登录已验证。
|
||
- 管理端：除 AI 面试、训练、案例、SOP 和资料处理外，已包含大喇叭发布、单文件提炼与多岗位解读、五渠道直通反馈收件箱、内容/任务运营、问题榜运营、知识空间、全网 AI 配置和组织权限；员工个人训练、主管复盘、团队难题、成长证据与训练录音仅在认证 APP 按项目范围访问。
|
||
- 用户侧：`mobile-uni/` 承载员工、候选人和主管三端；“问”已改为数字师傅 Agent，文字、ASR 转写和图片/视频统一先做意图规划，再按服务端权限调用知识、训练、待办、记忆、媒体或全网工具，寒暄和不完整表达不再机械落入 RAG。现有能力还包括手机号登录、30 分钟短期多轮、原文件/视频受控交付、大喇叭公司文件摘要/下载/多岗位解读/追问、五渠道直通反馈、“记一下”确认卡、三级字号、训练/题目反馈、问题榜与积分、岗位考试、案例、候选面试/资料、主管复盘/派发及学员模式。Agent 代码已随 2026-07-25 完整包部署；2026-07-29 当前 DCloud 云端证书内测 APK 为 `0.1.13 (113)`，SHA-256 `FA2D2A6DC84AE759714E6D16D146C1E1552A0F3F53C046069422012361D1D0C0`，启动阶段不展示 DCloud 原生隐私确认，法务同意统一由登录页承担。该版进一步让认证身份、角色和组织岗位异常失败关闭，不再回退为普通员工或公开首页；移动端 199 项、`ruoyi-aihr` 700 项、类型检查、App-Plus 资源和 APK 深检已通过。干净提交 `af8af2f6` 的统一 RC 已达到 `releaseEligible=true`，证据在 `output/aug1-rc/0.1.13-113-af8af2f6-frozen/`；冻结候选后端 JAR SHA-256 为 `93AD272118F6A28F88C2BFA305F5C450E163CBE22577FF5BE3E85B3BD3958DAD`，其语义已包含在 2026-07-29 后续定向发布的生产 JAR `5376B67B…` 中。当前双提交交付包为 `output/aug1-release/bangdao-aug1-0.1.13-113-af8af2f6-ops46f4616b.zip`，大小 `192,948,093` 字节，SHA-256 `F6DF4AB2660A4D3523C7E9785C1F8B572770F1F795A841E2D95C88936A8AE9C0`，20 个条目和内部哈希已复核；严格门禁会核对固定码模式、5/5 场景、30/30 问题证据、五类负责人签认、每个直通角色的主处理人/替补、五通道正向授权/越权拒绝/一次正式回复验收，以及受控分发、法务例外和测试签名接受，包内 Go/No-Go 已指向当前双提交包，旧 `ops9c53668c` 及更早 ZIP 只作历史追溯。生产现有在职 APP 账号的固定码链路已经完整通过首次获取/登录、认证只读主路径、退出、旧令牌失效、等待防刷窗口后的再次获取和重新登录，应用日志确认两次均未真实发送短信；固定码、登录和重新登录不再列为功能缺口。当前 x86_64 AVD 对仅含 ARM ABI 的 DCloud Weex 运行时出现 IPC 超时；浏览器截图只作布局和交互补充证据，不替代 App 运行、认证业务或设备能力验收，也不因此修改发布 ABI、增加降级路径或启用兜底内容。机器签认当前准确显示正式场景 `0/5`、有据问题 `0/30`、通道验收 `0/5`、负责人签认 `0/5`、受控分发 `PENDING`，五个处理角色有效绑定均为 `0`；生产后端定向发布已经完成，但业务签认、受控分发和真机门禁仍未闭环，当前 Go/No-Go 仍为 No-Go。旧 `mobile/` 只用于历史回溯。
|
||
- 英雄路径：AI 面试（真模型出题/评分）、三角色对练（真 LLM 客户回复+评分，ASR/TTS 配置后支持语音）、案例沉淀（真实语音上传+ASR 转写+模型整理）均为真模型优先、未配置或失败回退本地兜底；生产短音频 ASR 当前为阿里云百炼 `qwen3-asr-flash`，SiliconFlow audio 接口保留兼容。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，不提供浏览器目录选择和服务端目录导入入口。历史图片/视频若无片段会保持可重试失败，可直接从原 OSS 文件重新入队；2026-07-29 生产已用该链路恢复原卡住的 4 项资料，全部生成片段并入库。后端目录导入接口仅保留为运维/调试能力。
|
||
- 组织人员：`aihr_org_snapshot` 本地 reset 保留演示 seed；生产通过 `POST /api/aihr/org/sync` 同步外部组织。2026-07-25 记录的生产快照为 3417 人、2938 人在职且均有姓名、3392 个手机号映射、175 名在职主管和 20 名项目经理；姓名通过稳定 `employee_id` 定向补齐，未执行全量覆盖。当前上游 `employee_number` 与既有主体不一致且手机号大量脱敏，修复契约前禁止强制全量同步；人数属于时点事实，发布或验收前应重新查询。
|
||
- 正式试点：服务端提供按起止日期导出的受角色保护 CSV；当前管理端不展示个人训练或试点导出入口，正式试点需在明确独立后台契约后再开放。严格门禁只统计唯一映射到在职组织的训练、校准和 SOP 评审。组织身份同步和至少 20 名手机号映射门槛已具备；下一步仍需选定真实试点窗口，产生员工训练、人工校准和 SOP 评审样本后重跑严格门禁，详见 [演示与试点验收](docs/DEMO_ACCEPTANCE.md)。
|
||
- 侧栏：只展示当前 AIHR 业务菜单；过滤名单在 `frontend/src/layout/components/Sidebar/index.vue`，不要恢复若依默认全量菜单。
|
||
- 本地认证：真实阿里云短信参数放根目录 `.env.local`，由 `scripts/dev-backend.sh` 自动加载；不要把密钥写入 `application-dev.yml`。dev 未配短信时短信验证码固定 `123456`；管理端图形验证码默认关闭，需要时设置 `AIHR_DEV_CAPTCHA_ENABLED=true`。生产不读取该图形验证码开发开关，短信固定码也保持默认关闭，只有试点明确同时开启两项生产固定码配置时才生效。
|
||
- 生产状态属于易变事实，不在总入口固定某次提交或迁移数量；发布前后按 [BRD 功能审查记录](docs/BRD_IMPLEMENTATION_AUDIT.md)、[生产迁移 Runbook](docs/BRD_PRODUCTION_MIGRATION_RUNBOOK.md) 和正式预检结果确认。已授权的生产登录方式可直接用于认证验收；真机能力和严格试点仍需独立验收。
|
||
|
||
## 快速启动
|
||
|
||
Linux/macOS：
|
||
|
||
```bash
|
||
./scripts/dev.sh
|
||
```
|
||
|
||
首次启动或需要重建本地 MVP 数据库时执行 `./scripts/dev.sh --reset`。`./scripts/dev.sh` 默认通过 portless 启动后端、管理端和当前 `mobile-uni` 用户侧，对应入口为 `https://wygj-api.localhost/`、`https://wygj-admin.localhost/`、`https://wygj-mobile-uni.localhost/h5/`。只有显式 `PORTLESS=0 ./scripts/dev.sh` 时才回退固定端口和旧移动端兜底。
|
||
|
||
Windows 10/11 + Docker Desktop 使用 PowerShell 原生 portless，并仅用 Git Bash 执行 `.sh`；不要从 PowerShell 直接把 `./scripts/dev.sh` 交给 WSL。管理端与 `mobile-uni` 分开启动，避免本机 portless 版本和网络代理造成批量启动或 Node.js DNS 假成功。完整首启、日常启动、验证和停止命令见 [本地运行手册的 Windows 章节](docs/DEV_SETUP.md#windows-docker-desktop)。
|
||
|
||
## 目录
|
||
|
||
| 路径 | 用途 |
|
||
|---|---|
|
||
| `backend/` | RuoYi-Vue-Plus 后端基座 |
|
||
| `frontend/` | plus-ui 管理端前端基座 |
|
||
| `mobile-uni/` | 当前用户侧 uni-app H5 + App-Plus 工程 |
|
||
| `mobile/` | 旧移动端 H5，保留为 MVP 演示兜底 |
|
||
| `scripts/` | 本地 MVP 启动与数据重置脚本 |
|
||
| `docker-compose.dev.yml` | 本地 MySQL / Redis / MinIO / Qdrant |
|
||
| `docs/` | 项目文档、旧方案参考、Word 原件 |
|
||
|
||
## 文档索引
|
||
|
||
| 文档 | 用途 |
|
||
|---|---|
|
||
| [变更记录](CHANGELOG.md) | 按明确时间记录源码、发布、生产验证及未验收边界 |
|
||
| [文档目录](docs/README.md) | docs 区完整索引 |
|
||
| [Figma 设计资产清单](docs/FIGMA_DESIGN_INVENTORY.md) | 79 个页面、71 张正式画板的节点索引、批次范围和一致性审计结果 |
|
||
| [Figma 视觉系统使用规范](docs/FIGMA_DESIGN_SYSTEM_GUIDE.md) | 通用视觉元素、业务元素、状态映射和 LLM 组页规则 |
|
||
| [Figma 页面实现矩阵](docs/FIGMA_IMPLEMENTATION_MATRIX.md) | 70 张正式画板与代码/线上实现状态、二期边界和剩余动作 |
|
||
| [Figma 与线上 H5 差异矩阵](docs/FIGMA_ONLINE_DELTA.md) | 线上真实页面与 Figma 目标的差异、调整顺序和验收口径 |
|
||
| [本地运行手册](docs/DEV_SETUP.md) | Linux/macOS 与 Windows + Docker Desktop 的端口、账号、启动和基础验证 |
|
||
| [原生 App 打包](docs/MOBILE_APP_PACKAGING.md) | Android/iOS 资源构建、隐私/签名边界和出包前置条件 |
|
||
| [原生 App 真机验收](docs/MOBILE_APP_DEVICE_ACCEPTANCE.md) | Android/iOS 自定义基座或签名包的验收清单 |
|
||
| [8 月 1 日 Android 内测 Go/No-Go](docs/帮道8月1日Android内测Go-No-Go-20260728.md) | 当前候选 APK、自动化证据、硬阻断项和转 Go 最短路径 |
|
||
| [生活顾问调研转化清单](docs/生活顾问调研转化清单-20260728.md) | 将仓库外访谈脱敏转成待审核 SOP、知识、题目和对练候选项 |
|
||
| [MVP 演示与验收清单](docs/DEMO_ACCEPTANCE.md) | MVP 演示脚本、录屏兜底和验收口径 |
|
||
| [后端 API 对接指南](docs/API_INTEGRATION.md) | 后端模块落点、正式试点 CSV、移动端训练/复盘、候选资料上传/审核和 SOP 上传解析接口 |
|
||
| [数字师傅 Agent 总体设计](docs/superpowers/specs/2026-07-24-digital-master-agent-design.md) | “问”模块的最终产品边界、意图/工具/权限/确认/审计契约和当前实现差距 |
|
||
| [数字师傅 Agent 实施计划](docs/superpowers/plans/2026-07-24-digital-master-agent.md) | 当前实现、自动化与浏览器验证记录，以及已部署但仍未完成的专项生产/真机验收项 |
|
||
| [问师傅多轮会话与原始资料交付设计](docs/20260718/问师傅多轮会话与原始资料交付设计.md) | 已实现的短期会话、指代改写、意图路由、原文件/视频安全交付及分层验收记录 |
|
||
| [工作助手与今日工作成果迭代计划](docs/工作助手与今日工作成果迭代计划-20260721.md) | 项目名称选择、日常采集、来源追溯、今日成果、主管视图、成果投稿和外部流转的实施顺序；含当前本地实现、390×844 证据、权威高保真路径和剩余生产边界 |
|
||
| [帮道产品功能优先级与实施计划（2026-07-21 快照）](docs/帮道产品功能优先级与实施计划-20260721.md) | 对历史输入《银城帮道介绍》十项能力的当时事实校正；当前状态以 BRD 审查为准 |
|
||
| [BRD 功能审查记录](docs/BRD_IMPLEMENTATION_AUDIT.md) | 现阶段结论、三端输入匹配矩阵、权限、迁移、线上资源和未完成项证据 |
|
||
| [BRD 生产迁移 Runbook](docs/BRD_PRODUCTION_MIGRATION_RUNBOOK.md) | 生产 schema/内置内容迁移、只读预检、发布和回滚边界 |
|
||
| [ruoyi-ai 能力分片迁移计划](docs/RUOYI_AI_INCREMENTAL_MIGRATION.md) | 知识库、模型能力、文档解析、RAG、chat 的渐进迁移边界 |
|
||
| [项目规划方案与 AI 接口说明](docs/AI人力资源系统项目规划方案与AI接口说明.md) | 对外会议版口径、数字师傅定位和 AI 接口规划 |
|
||
| [AI 陪练完整交付计划](docs/AI陪练完整交付计划-20260724.md) | 当前阶段一“练”模块固定范围：住宅物业 × 五岗位 × 三级成长，含现有基线、收口动作和验收门槛 |
|
||
| [AI 陪练二期开发推进计划](docs/AI陪练二期开发推进计划.md) | 2026-07-11 历史推进记录；用于追溯已完成的 M0-M5，不再作为后续范围切分依据 |
|
||
| [银城员工端APP分阶段实施总纲](docs/银城员工端APP分阶段实施总纲.md) | 2026-07-07 立项会后的三阶段总纲与阶段二/三边界 |
|
||
| [数字师傅学练问报整合方案](docs/20260708/数字师傅学练问报整合方案.md) | 2026-07-08 产品讨论定案:学练问报四模块、开放问题榜、学分晋升、发布会「生活顾问的一天」 |
|
||
| [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 和实现切分 |
|
||
|
||
## 下一步
|
||
|
||
当前主线不是继续补页面，而是用已授权的生产登录方式、正式角色和真实手机完成剩余读写/权限/设备验收，再选定 1–2 个项目、至少 20 名员工和固定时间窗，产生训练、校准、SOP 评审、满意度与案例样本后重跑严格门禁。功能现状看 [BRD 功能审查记录](docs/BRD_IMPLEMENTATION_AUDIT.md)，客户反馈看 [版本功能对比](docs/员工端版本功能对比与功能对齐清单-20260717.md)，正式试点看 [DEMO_ACCEPTANCE.md](docs/DEMO_ACCEPTANCE.md)。
|