# 管理后台提速报告

| 页面 | 旧版 p75 | 新版 p75 | 提升 | 首次 JS 原始传输量 |
| --- | ---: | ---: | ---: | ---: |
| 会员管理 | 2386.3 ms | 1885.5 ms | 21.0% | 908831 → 479783 字节 |
| 学习报表 | 2886.8 ms | 1883.2 ms | 34.8% | 1169844 → 477352 字节 |

两个页面均未达到简报里默认的减半目标。当前主要收益来自首次打开时不再加载 Excel/PDF 引擎；后续要继续提速，应测真实账号下的接口耗时、请求瀑布和列表渲染，再决定是否处理后台数据查询或其他前端瓶颈。

验证：生产构建成功；后台 221 个单元测试通过；模拟接口下 Excel 模板和 PDF 实际下载成功；会员管理和学习报表在 1440 与 390 像素宽度下，新旧版截图完全一致。固定本地接口的配对测速各 10 轮。`perf/bench/ceilings.json` 将两页首次 JS 原始传输量上限定为 500000 字节，可用 `admin-frontend.py --ceilings` 检查回退。

复测命令（需 Python Playwright 与 Chromium；`BASELINE_BROWSER` 指向基线提交的 `dist/xiaoshu-admin/browser`）：

```bash
python3 perf/bench/admin-frontend.py --baseline "$BASELINE_BROWSER" --candidate dist/xiaoshu-admin/browser --page members --runs 10 --ceilings perf/bench/ceilings.json
python3 perf/bench/admin-frontend.py --baseline "$BASELINE_BROWSER" --candidate dist/xiaoshu-admin/browser --page learning-reports --runs 10 --ceilings perf/bench/ceilings.json
```

本报告的时间和字节来自本地模拟条件。线上 CDN 压缩、真实接口响应、真实管理员数据量和实际设备体验尚未验收；推送代码也不等于确认线上部署。若需回滚，回退本次动态导入改动即可恢复原加载行为。

## 2026-09-26 其余运营菜单

登录后当前页面稳定 4.5 秒再从侧栏首次切入。下表是**目标页面标题出现**的 p75，代表路由代码切换速度；各模块的业务数据耗时未包含在内。

| 模块 | 原版 | 新版 | 降幅 |
| --- | ---: | ---: | ---: |
| 门店管理 | 378.5 ms | 188.4 ms | 50.2% |
| 排课中心 | 353.1 ms | 121.5 ms | 65.6% |
| 陪练老师 | 231.6 ms | 74.9 ms | 67.7% |
| 工资结算 | 345.2 ms | 100.9 ms | 70.8% |
| 词库管理 | 219.0 ms | 83.2 ms | 62.0% |
| 专项训练 | 233.2 ms | 71.2 ms | 69.5% |

词库另测到目录与第一页词条数据均到齐的真正可用 p75：1572.5→1389.5 ms（11.6%）。工作台是本轮预热的起点，没有单独可归因的首次打开提速；会员与学习报表冷启动 p75 基本持平，分别是 1891.1→1891.3 ms、1877.7→1881.5 ms。

运营主菜单只预加载页面代码，不发额外业务接口；登录页、详情页、技术后台、Excel/PDF 导出代码不预热。3 秒延迟保护当前页，省流量及 2G 连接跳过。`perf/bench/admin-menu-switch.py` 和 `admin-frontend.py` 可重跑，10 轮原始结果在同目录的 `*-2026-09-26.json`。`menu-ceilings.json` 和 `ceilings.json` 分别锁住菜单切换 p75 与首次 JS 字节上限。

验证范围：本地生产构建、后台单元测试、固定模拟接口与网络条件。真实管理员权限、真实数据量、线上网络和部署后的体验尚未测量，因此以上数字不代表线上实际提速。

## 2026-09-26 页面回访

九个运营主菜单页面首次加载后，返回时保留原实例和原筛选状态，不重新请求整页数据。旧版每次返回会重复 1–5 个业务请求；新版九页均为 0。当前页面仍每 5 秒轻量检查版本，离开时暂停，返回时补查；发现数据变化后在后台更新。工作台快照超过 30 秒或日期变化时也在后台更新。词库和专项训练维持页面上的手动刷新。

| 页面 | 旧版返回 p75 | 新版返回 p75 | 重复业务请求 |
| --- | ---: | ---: | ---: |
| 工作台 | 845.0 ms | 58.6 ms | 1 → 0 |
| 会员管理 | 70.4 ms | 53.7 ms | 1 → 0 |
| 门店管理 | 62.8 ms | 53.5 ms | 1 → 0 |
| 排课中心 | 70.7 ms | 58.0 ms | 1 → 0 |
| 学习报表 | 61.3 ms | 53.9 ms | 1 → 0 |
| 陪练老师 | 59.5 ms | 50.4 ms | 1 → 0 |
| 工资结算 | 54.8 ms | 53.9 ms | 5 → 0 |
| 词库管理 | 66.4 ms | 49.2 ms | 2 → 0 |
| 专项训练 | 62.7 ms | 48.9 ms | 1 → 0 |

工作台计到欢迎内容及趋势图真正可用；其余页面计到原组件可见，旧版业务数据一般仍在加载，不能将表内耗时解释成旧版业务可用时间。测试为同机固定模拟接口、A/B 交替各 10 轮；浏览器脚本错误为零。登录后工作台可用 p75 2389.8→1872.8 ms；直接冷开 2403.3→2397.4 ms。旧版和新版静态包及数据见 `perf/bench/dashboard-*-2026-09-26.json` 与 `menu-return-2026-09-26.json`。

回归命令：

```bash
python3 perf/bench/admin-menu-return.py --baseline /tmp/xiaoshu-dashboard-baseline/browser --candidate dist/xiaoshu-admin/browser --runs 10 --ceilings perf/bench/menu-return-ceilings.json
```

本次无真实管理员数据、线上网络或上线后的测量。云端工作台查询精简已通过静态校验，只有在云函数发布后才会在线上生效。