docs: record ask memory production release

This commit is contained in:
2026-07-18 21:33:44 +08:00
parent 064816a784
commit 1028c55f42
3 changed files with 20 additions and 17 deletions
@@ -1,6 +1,6 @@
# 问师傅多轮会话与原始资料交付设计
> 状态:代码、自动化、本地真实 HTTP、390×844 移动端视觉与交互已验证;生产发布与正式业务验收仍须分别记录。
> 状态:代码、自动化、本地真实 HTTP、本地 390×844 移动端交互和生产基础发布验证已完成;生产正式账号多轮、真机文件权限与正式业务验收仍须分别记录。
>
> 目标:让“问·数字师傅”能理解本次连续对话中的指代,并在当前授权范围内交付命中的原文件或操作视频。
@@ -132,7 +132,9 @@
## 10. 当前验证记录
- 后端定向合同与服务测试 `20/20` 通过;移动端完整单元测试、类型检查和 H5 构建通过。
- 后端定向合同与服务测试 `21/21` 通过;移动端完整单元测试 `80/80`、类型检查和 H5 生产构建通过。
- 本地手机号真实登录后完成“报修第一步 → 把对应原文件给我 → 有对应操作视频吗”三轮:上下文版本依次递增,第二轮路由为 `FILE` 并下载受保护原文件,第三轮无视频时返回空资源和明确说明;旧版本请求返回 `409`。
- 390×844 H5 已实际操作登录、两轮追问、资料卡点击和“新对话”;资料卡请求命中受保护内容接口,未发现遮挡、溢出或底栏覆盖。
- 上述是本地工程验证,不等于生产发布、真机文件权限验证或正式业务验收。
- 2026-07-18 已发布功能提交 `064816a7`:生产 JAR/H5 与本地产物哈希一致,`wygj-aihr.service` 为 `active`,必需 schema `35/35`,19 张发布表排序规则 `19/19` 对齐。
- 生产 390×844 H5 已打开“问”页并点击“新对话”,页面明确显示新会话提示,未发现遮挡、溢出、底栏覆盖或控制台错误。
- 未使用正式短信 OTP 在生产重放认证态三轮及下载;因此上述只是生产基础发布验证,不等于生产真实多轮、真机文件权限验证或正式业务验收。
+10 -9
View File
@@ -1,22 +1,22 @@
# BRD 功能审查与未完成项记录
> 当前基线:2026-07-18,生产提交 `32fa376d635e951febbb5a17050fc4cb8de77e9f`。
> 当前基线:2026-07-18,生产功能包提交 `064816a784dad535f2320c4321f73f2e6e364d69`。
>
> 本文只维护当前结论、证据层级和剩余门槛。逐提交发布流水已从当前真相文档移除,需要追溯时使用 Git 历史;不得再用 2026-07-14/15 的“尚未发布”记录判断现网。
## 1. 当前结论
客户在 2026-07-17 反馈的主要回退和新增项已经进入当前生产包,包括语音输入与关键内容播报、总结卡图片、全局三级字号、主管学习端、姓名多选与快捷截止日期、每日题轮换和题目反馈、常见难题、开放问题榜与积分、完整岗位考试、全网 AI 独立入口,以及多租户知识空间管理。
客户在 2026-07-17 反馈的主要回退和新增项已经进入当前生产包,包括语音输入与关键内容播报、总结卡图片、全局三级字号、主管学习端、姓名多选与快捷截止日期、每日题轮换和题目反馈、常见难题、开放问题榜与积分、完整岗位考试、全网 AI 独立入口、多租户知识空间管理,以及问师傅短期多轮、追问改写和受控原文件/视频交付。
完成状态必须分层表达:
| 层级 | 当前状态 | 证据与边界 |
|---|---|---|
| 已实现 | 是 | 功能提交 `6bdc86e3`,排序规则兼容修复 `32fa376d` |
| 已实现 | 是 | 主功能提交 `6bdc86e3`,排序规则兼容修复 `32fa376d`,问师傅短期会话提交 `064816a7` |
| 本地自动化/API 验证 | 是 | 功能批次已完成后端、前端、移动端测试与真实本地 API 闭环;具体用例见代码测试和版本功能清单 |
| 本地浏览器/视觉验证 | 是 | 24 个移动端状态和 3 个管理端页面已操作并逐页截图,无页面级横向溢出、控制台错误或失败请求 |
| 已部署 | 是 | 管理端、H5、后端和 21 个版本化迁移已发布;线上产物哈希与本地发布产物一致 |
| 生产基础验证 | 是 | 服务 `active`;根站、H5、租户接口、员工首页 API 正常;目标 schema `34/34`,本次 18 张新表排序规则 `18/18` 对齐;管理端关键页及移动端匿名首屏已浏览器复核 |
| 已部署 | 是 | 管理端、H5、后端和 22 个版本化迁移已发布;线上产物哈希与本地发布产物一致 |
| 生产基础验证 | 是 | 服务 `active`;根站、H5、租户接口、员工首页 API 正常;目标 schema `35/35`,本次 19 张发布表排序规则 `19/19` 对齐;管理端关键页和移动端“新对话”已浏览器复核 |
| 生产完整业务验收 | 否 | 未用正式 OTP 重放员工/主管认证写链路,未在真实手机复验麦克风、文件/相册、下载、读屏和设备语音,也未完成严格试点窗口验收 |
“已部署”不等于“正式试点通过”。当前可以确认生产包和基础运行状态,不能把未执行的正式账号、真机和业务窗口验收写成已完成。
@@ -36,6 +36,7 @@
| 不同角色/岗位内容 | 员工、候选人、主管独立入口;岗位来自组织系统,主管可切换学员模式但不改变组织身份 | 生产包已部署;全岗位内容矩阵和正式权限正反例仍需业务数据 |
| 字号适老化 | 标准/大字/超大字全局持久化,同一页面结构响应式增高 | 本地多视口视觉通过;真实手机触控、键盘和读屏未验收 |
| 问师傅语音与播报 | 录音、选择音频、ASR、TTS/设备语音降级恢复;答案、总结卡、每日题、点评等关键内容可播报 | 生产包已部署;生产 CosyVoice2 已按老师傅/业主/面试官区分音色,业主情绪语气与语速已在生产 H5 验证;真实手机权限、弱网、方言和正式 ASR 仍未验收 |
| 问师傅连续对话与资料 | 认证用户短期会话保留 30 分钟/最近 6 轮,追问改写并路由 `QA/FILE/VIDEO/DATA_TOOL`;原文件/视频只从当前命中且实时授权的附件交付,无资源不造假链接 | 生产包、schema、哈希和匿名“新对话”页面已验证;正式 OTP 认证态三轮与真机下载未在生产重放 |
| 图片/视频与总结卡图片 | 问师傅附件仅用于本次现场分析;总结卡可下载 PNG | 生产包已部署;iOS/Android H5 下载和相册/文件权限未复验 |
| 录音归属、提交无反馈、筛选错位 | 账号/页面代次隔离、旧请求回写保护、明确加载/失败状态和窄屏布局已修 | 本地双账号/交互测试通过;生产认证态未重放 |
| 每日题变化与题目反馈 | 五岗位题库按日期、岗位和员工身份轮换;每日题/专项支持有用/无用反馈 | 生产 schema 和包已部署;正式题库内容审核与业务样本待补 |
@@ -66,11 +67,11 @@
## 5. 2026-07-18 生产发布证据
- 分支:`codex/multi-tenant-knowledge-platform`,已推送到 `origin`。
- 生产提交:`32fa376d635e951febbb5a17050fc4cb8de77e9f`;功能提交:`6bdc86e3`。
- 备份:`/opt/wygj/backups/release-20260718005151`。
- 当前生产功能包:`064816a784dad535f2320c4321f73f2e6e364d69`;前序主功能提交:`6bdc86e3`。
- 当前发布备份:`/opt/wygj/backups/ask-memory-20260718-2130`(数据库、JAR、H5 及 SHA-256);前序备份仍保留在 `/opt/wygj/backups/release-20260718005151`。
- 生产地址:`https://peilian.njzhmj.top/`、`https://peilian.njzhmj.top/h5/`。
- 数据库:21 个迁移脚本执行完成;目标 schema `34/34`;新增 18 张表与知识主表租户字段排序规则 `18/18` 对齐。
- 浏览器:管理端首页、常见难题、问题榜运营、知识空间、全网 AI 配置和 390×844 移动端 H5 已查看;最终页面无控制台/请求错误。
- 数据库:22 个版本化迁移已应用;目标 schema `35/35`;19 张发布表与知识主表租户字段排序规则 `19/19` 对齐,会话表两个业务索引均存在。
- 浏览器:管理端首页、常见难题、问题榜运营、知识空间、全网 AI 配置和 390×844 移动端 H5 已查看;当前发布又实际点击了“新对话”,最终页面无控制台/请求错误。
- 发布中发现知识空间页因历史库排序规则混用报错,已通过 `aihr_20260718_release_collation_compat_mysql8.sql` 根因修复并重新验证;禁止用 SQL 临时转换掩盖同类 schema 漂移。
## 6. 当前事实源
+5 -5
View File
@@ -4,13 +4,13 @@
## 当前生产基线
2026-07-18 已在生产发布提交 `32fa376d`:
2026-07-18 已在生产发布功能包提交 `064816a7`:
- 21 个版本化迁移按本文件顺序执行完成,目标结构核验为 `34/34`;
- 最后一条排序规则迁移把本次新增的 18 张表对齐到 `aihr_knowledge_info.tenant_id` 的实际排序规则,核验为 `18/18`;
- 22 个版本化迁移按本文件顺序执行完成,目标结构核验为 `35/35`;
- 最后一条排序规则迁移把 19 张发布表对齐到 `aihr_knowledge_info.tenant_id` 的实际排序规则,核验为 `19/19`;
- 管理端、H5、后端产物与本地发布产物哈希一致,`wygj-aihr.service` 为 `active`;
- 根站、H5、租户接口、员工首页 API 和关键管理页通过生产回归;
- 发布备份位于 `/opt/wygj/backups/release-20260718005151`。
- 当前发布备份位于 `/opt/wygj/backups/ask-memory-20260718-2130`,内含完整数据库、JAR、H5 和 SHA-256 清单。
上述事实只证明本批版本和 schema 已发布。正式 OTP、真机能力、角色权限正反例和严格试点窗口仍需按发布后回归及 `DEMO_ACCEPTANCE.md` 验收。
@@ -50,7 +50,7 @@ mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aih
mysql --default-character-set=utf8mb4 "$DB_NAME" < backend/script/sql/update/aihr_20260718_release_collation_compat_mysql8.sql
```
顺序原因:场景补充依赖三张场景/Rubric 基础表;五维迁移依赖场景和 Rubric;岗位/SOP/任务/资格迁移只补正式数据契约,不写业务行,也不代表岗位适用范围、任务规则或资格标准已经获得 HR 确认。住宅 SOP 和 Prompt 迁移只补内置内容,不代表内容已完成业务复核。排序规则兼容迁移必须最后执行,它会读取目标库 `aihr_knowledge_info.tenant_id` 的实际排序规则,并将本次新建的 18 张表统一到同一规则,兼容历史生产库与全新 MySQL 8 数据库。
顺序原因:场景补充依赖三张场景/Rubric 基础表;五维迁移依赖场景和 Rubric;岗位/SOP/任务/资格迁移只补正式数据契约,不写业务行,也不代表岗位适用范围、任务规则或资格标准已经获得 HR 确认。住宅 SOP 和 Prompt 迁移只补内置内容,不代表内容已完成业务复核。知识会话迁移只新增短期上下文表,不生成业务对话。排序规则兼容迁移必须最后执行,它会读取目标库 `aihr_knowledge_info.tenant_id` 的实际排序规则,并将 19 张发布表统一到同一规则,兼容历史生产库与全新 MySQL 8 数据库。
## 迁移后只读核验