adminandClaude Opus 5
d84ad87cb6
73712994 disabled voice-first on native by gating the TTS preload behind
!isNativeAppRuntime(), which left App users with the degraded text bubble
plus a 播报 button. The voice-line, 转文字 toggle and 收起全文 markup were
still present but unreachable.
Re-enable the preload on every platform and open the transcript when the
message is created, so the answer is readable while synthesis runs.
Collapse the transcript when playback starts rather than when synthesis
finishes: on-device synthesis settles in 2-6s, so collapsing on ready
pulled the answer away mid-sentence. transcriptPinned records a manual
toggle so the automatic collapse never overrides the reader.
Bound the preparing bubble at 20s (the upstream DashScope ceiling) so a
stalled synthesis degrades to the plain text bubble instead of showing an
endless placeholder duration.
Replace the tautological assertion that pinned the previous behaviour by
matching source strings with assertions on the behaviour itself.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>帮道
基于 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 打包。 - 本地依赖：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 完整包部署，但 Agent 专项认证态业务回归和真机验收尚未完成；旧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同步外部组织。2026-07-25 记录的生产快照为 3417 人、2938 人在职且均有姓名、3392 个手机号映射、175 名在职主管和 20 名项目经理；姓名通过稳定employee_id定向补齐，未执行全量覆盖。当前上游employee_number与既有主体不一致且手机号大量脱敏，修复契约前禁止强制全量同步；人数属于时点事实，发布或验收前应重新查询。 - 正式试点：服务端提供按起止日期导出的受角色保护 CSV；当前管理端不展示个人训练或试点导出入口，正式试点需在明确独立后台契约后再开放。严格门禁只统计唯一映射到在职组织的训练、校准和 SOP 评审。组织身份同步和至少 20 名手机号映射门槛已具备；下一步仍需选定真实试点窗口，产生员工训练、人工校准和 SOP 评审样本后重跑严格门禁，详见 演示与试点验收。
- 侧栏：只展示当前 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 功能审查记录、生产迁移 Runbook 和正式预检结果确认。已授权的生产登录方式可直接用于认证验收；真机能力和严格试点仍需独立验收。
快速启动
./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 时才回退固定端口和旧移动端兜底。详细端口、默认账号和验证项见 本地运行手册。
目录
| 路径 | 用途 |
|---|---|
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 原件 |
文档索引
| 文档 | 用途 |
|---|---|
| 变更记录 | 按明确时间记录源码、发布、生产验证及未验收边界 |
| 文档目录 | docs 区完整索引 |
| Figma 设计资产清单 | 79 个页面、71 张正式画板的节点索引、批次范围和一致性审计结果 |
| Figma 视觉系统使用规范 | 通用视觉元素、业务元素、状态映射和 LLM 组页规则 |
| Figma 页面实现矩阵 | 70 张正式画板与代码/线上实现状态、二期边界和剩余动作 |
| Figma 与线上 H5 差异矩阵 | 线上真实页面与 Figma 目标的差异、调整顺序和验收口径 |
| 本地运行手册 | 端口、账号、启动和基础验证 |
| 原生 App 打包 | Android/iOS 资源构建、隐私/签名边界和出包前置条件 |
| 原生 App 真机验收 | Android/iOS 自定义基座或签名包的验收清单 |
| MVP 演示与验收清单 | MVP 演示脚本、录屏兜底和验收口径 |
| 后端 API 对接指南 | 后端模块落点、正式试点 CSV、移动端训练/复盘、候选资料上传/审核和 SOP 上传解析接口 |
| 数字师傅 Agent 总体设计 | “问”模块的最终产品边界、意图/工具/权限/确认/审计契约和当前实现差距 |
| 数字师傅 Agent 实施计划 | 当前实现、自动化与浏览器验证记录，以及已部署但仍未完成的专项生产/真机验收项 |
| 问师傅多轮会话与原始资料交付设计 | 已实现的短期会话、指代改写、意图路由、原文件/视频安全交付及分层验收记录 |
| 工作助手与今日工作成果迭代计划 | 项目名称选择、日常采集、来源追溯、今日成果、主管视图、成果投稿和外部流转的实施顺序；含当前本地实现、390×844 证据、权威高保真路径和剩余生产边界 |
| 帮道产品功能优先级与实施计划（2026-07-21 快照） | 对历史输入《银城帮道介绍》十项能力的当时事实校正；当前状态以 BRD 审查为准 |
| BRD 功能审查记录 | 现阶段结论、三端输入匹配矩阵、权限、迁移、线上资源和未完成项证据 |
| BRD 生产迁移 Runbook | 生产 schema/内置内容迁移、只读预检、发布和回滚边界 |
| ruoyi-ai 能力分片迁移计划 | 知识库、模型能力、文档解析、RAG、chat 的渐进迁移边界 |
| 项目规划方案与 AI 接口说明 | 对外会议版口径、数字师傅定位和 AI 接口规划 |
| AI 陪练完整交付计划 | 当前阶段一“练”模块固定范围：住宅物业 × 五岗位 × 三级成长，含现有基线、收口动作和验收门槛 |
| AI 陪练二期开发推进计划 | 2026-07-11 历史推进记录；用于追溯已完成的 M0-M5，不再作为后续范围切分依据 |
| 银城员工端APP分阶段实施总纲 | 2026-07-07 立项会后的三阶段总纲与阶段二/三边界 |
| 数字师傅学练问报整合方案 | 2026-07-08 产品讨论定案:学练问报四模块、开放问题榜、学分晋升、发布会「生活顾问的一天」 |
| AI 陪练缺口修订版 | 24 项陪练缺口的代码实况校对和二期排期依据 |
| 阶段交付归档 | 2026-07 MVP 作战清单、演示 PPT、设计 QA 记录和阶段交付材料 |
| 业务需求 BRD | 业务范围、角色、边界和验收 |
| 开发规格 TechSpec | 模块、数据模型、路由、API 和实现切分 |
下一步
当前主线不是继续补页面，而是用已授权的生产登录方式、正式角色和真实手机完成剩余读写/权限/设备验收，再选定 1–2 个项目、至少 20 名员工和固定时间窗，产生训练、校准、SOP 评审、满意度与案例样本后重跑严格门禁。功能现状看 BRD 功能审查记录，客户反馈看 版本功能对比，正式试点看 DEMO_ACCEPTANCE.md。