报告.md 5.9 KB
管理后台数据加载优化验收
已检查 13 个主要运营菜单。瓶颈主要是服务器重复扫描/关联、工资核验进入工作台关键路径，以及词库读请求里的表结构操作；小接口只有数 KB 到几十 KB，传输带宽不是主因。
真实数据页面对照
同一 Mac、Chrome、本地管理端连接真实线上业务数据库，旧/新临时受限网关 A/B 交替各 10 次。每次使用独立浏览器上下文；终点为主接口成功、真实列表/统计可见并完成渲染。临时网关只允许当前授权运营账号和指定读取操作，带有效期，测试结束删除。页面字节、主要数据请求数未靠删除业务数据缩减。
工资故障恢复提交 4c34288 在测试期间已上线。因此最终对照统一使用恢复后的数据库环境；工作台对照的旧版本也使用已修复的收入视图，不能把该应急恢复重复计入本次提升。初始工作台/排课曾超过前端 20 秒超时，不进入下面成功样本的百分比计算。
| 页面 | 旧 p50/p75/p95 | 新 p50/p75/p95 | p75 缩短 |
|---|---|---|---|
| 会员管理 | 2.11 / 2.26 / 2.52 秒 | 1.13 / 1.17 / 1.28 秒 | 48.4% |
| 门店管理 | 3.30 / 3.49 / 3.55 秒 | 2.31 / 2.43 / 3.43 秒 | 30.4% |
| 排课中心 | 11.90 / 12.03 / 12.25 秒 | 2.50 / 2.58 / 2.91 秒 | 78.5% |
| 工作台 | 15.10 / 15.52 / 16.48 秒 | 6.08 / 6.20 / 6.40 秒 | 60% |
原始明细、截图、线上基线及授权信息仅保留在本机私有/忽略目录，仓库只保存不含个人数据的汇总。
改动
- 课程分类和排课选项改为集合查询，消除按课程节点重复扫描预约/绑定。
- 会员预约取消状态先去重，再关联汇总；保留重复元数据、缺失元数据和跨帐套情况的原有语义。
- 上课记录关联使用已有数字索引，保留历史日期回退、正式/体验课口径。
- 收入视图直接投影字段，使公司/月筛选可以下推；列顺序、数值精度及历史纠正金额保持一致。该 SQL 已被工资故障恢复任务采用上线，这里补齐安装源文件和独立迁移文件。
- 词库先只读检查已迁移字段，正常读请求的 ALTER TABLE 从 3 次变为 0 次；缺字段的遗留库仍兼容修复。
- 工作台只执行实时预估金额计算，省去它不使用的来源版本和结算截止核验。实际计薪公式、来源和金额不变。工作台内部校验 metadata 明确标记
not_checked / settlementReady=false，不会授权结算。工资模块以及生成、审核工资仍完整校验，用户在请求体伪造forDashboard不能跳过。真实工资概览的新旧响应也逐项一致，包含来源版本和结算状态（单次读取对照约 13.9s / 12.0s，不作为稳定速度结论）。
验证
46 项相关回归测试通过；11 个云函数定义校验通过；管理端生产构建通过。测试覆盖租户隔离、重复/取消/空记录、金额纠正、数字精度、字段序列、历史来源回退、失败重试、只读预估不能绕过结算校验，以及发布补丁保留线上其他修复。
会员、门店、排课各 10 轮所有业务响应一致；工作台各 10 轮的金额、课次、人数及其他业务字段一致，仅有意改变其不参与结算的内部校验 metadata。所有页面只忽略刷新时间/延迟秒数等时钟字段。1440px、1000px 截图核对通过：工作台/门店/排课像素一致；会员仅刷新时间差异，变化低于 0.07%。
原有菜单复用保持：会员、门店切往反馈页再返回的单次功能验收分别约 98ms、82ms，均 0 个重复主数据请求。这是原有缓存能力的验证，不计为本次新提速收益。
词库树/列表按真实默认筛选各做了 10 轮 API 对照（见 vocabulary-api-results.json），短请求耗时没有显著改善；保留该改动的依据是正常读路径表结构操作从 3 次确定性降为 0 次，不把初始 16s 计为它的收益。另在诊断筛选条件下独立探测上课记录约 1.93s、学习报表约 1.35s；初始并发调查中的较大耗时不能当作其稳定基线。反馈、注销申请、运营账号的接口为亚秒级。没有公开匿名后台地址的 CrUX 数据，以上为实验室真实数据对照，不代表所有用户网络条件。
剩余瓶颈及下一步
门店没有达到减半目标；会员接近减半。后续可测量将互不依赖的门店统计并行、将仅详情需要的历史汇总延后加载，需继续保持统计一致。
工资模块和部分老师详情仍可能受到全量来源核验影响。建议下一阶段把“金额列表加载”和“结算资格核验”拆为两个状态：先显示真实金额，核验通过后才开放结算操作。进一步减少全量核验需设计可验证的变更版本机制，不能简单用过期缓存或最后更新时间代替完整性校验。本次保留完整财务核验。还可在保证重复课次判断和全量来源版本覆盖的前提下，按月份裁剪传回应用层的工资明细；该方案尚未实施。
发布边界
本次剩余网关优化尚未发布，已生成精确到 8 个读取/计算函数的补丁；不重写整个线上网关，不触碰业务记录。私有发布目录：~/.local/state/xiaoshu/cloud-releases/2026-10-15-admin-read-performance，包含实际线上原件、候选代码、前后 SHA-256 和清单。
经授权后执行 scripts/release-admin-read-performance.mjs --deploy：检查同步空闲及线上版本未漂移，发布并回读哈希。随后复核真实页面、筛选、菜单返回及工资金额；回滚命令为同脚本 --rollback，仅在线上仍是本次候选哈希时恢复原件，防止覆盖后续发布。
复测命令：paired-api.mjs 在 PERF_BROWSER=1 下测页面，summarize.mjs 汇总各 10 轮结果，ratchet.mjs 对照保存的 p75 上限。WAN 时间门禁须同环境人工运行；离线 CI 使用数据等价和零正常读 DDL 等确定性护栏。