nex_animation/frontend
mula.liu cbc645c4e1 perf(交付面): 按 media type 压缩 + 哈希产物长期缓存,后端与 nginx 同一套口径
Bundle 那十几轮量的是**文件字节**(`chunkinfo`),但线上真正过网的是这一层的响应头:
首屏闭包 1 469 kB 里 1 144 kB 是一个带哈希的 JS chunk,不压就是按 raw 发,量好的
gzip 450 kB 白量。补上缺的另一半(阶段 29、30)。

backend/app/main.py:
- `gzip_eligible()` 是唯一的权威名单,只认 media type 不认路径前缀(只压文本,
  mp4 与已压过的图片挡在外面);`ContentTypeGZipMiddleware` 按它决定是否压,
  小于阈值的响应不压(压完加头比原文还大,还多一个 `Vary` 命中率)。
- 中间件顺序是有条件的:压缩层必须**最先**注册,否则 `add_middleware` 把自己插到
  最外层之后,压缩跑到了鉴权外面。
- 交付面缓存:`/assets` 带内容哈希 ⇒ `public, max-age=31536000, immutable`;
  `index.html` 与 history 回落出去的壳 ⇒ `no-cache` 每次回源校验,否则发版后老标签页
  拿着旧壳去引已经不存在的哈希文件,用户看到白屏。

frontend/nginx.conf:反代这一层写同一套口径(注释里点名「权威名单在后端
`app.main.gzip_eligible`,这里这份是兜底」),并补 `gzip_proxied any`——
它管的是**带 `Via` 请求头的请求**(nginx 站在 CDN 后面时),默认 `off` 下直连浏览器
照样压;挂 CDN 时这套压缩不能整块失效。三组合 A/B/C 的实测对账在
`reports/ui_evidence/nex-p30/nginx-ab.log`:后端已压时 nginx 透传不叠第二层,
后端没压时这里兜底压上(A 组合 `/api/projects` 341 909 → 53 333 B 是 nginx 自己压的)。

测试:新增 `backend/tests/test_api_content_gzip.py`,`test_spa_history_fallback.py`
补 `test_asset_delivery_cache_and_gzip`,三条断言各自钉住一个会真实发生的事故
(不压 / 壳不回源 / 小文件也压)。
2026-11-12 10:21:17 +08:00
..
public/help docs(帮助页): 重拍 12 张手册插图,跟上门禁与外壳的当前样子 2026-11-08 00:18:12 +08:00
src fix(可访问性): 图标默认为装饰 · 4 处控件补自然中文名称 2026-11-08 17:24:06 +08:00
Dockerfile v 0.1.0 2026-11-01 16:18:07 +08:00
index.html 前端按 Ant Design 规范重写:Header + 两级侧栏 + 页面内部页签,手写规范整体退场 2026-11-03 12:42:16 +08:00
nginx.conf perf(交付面): 按 media type 压缩 + 哈希产物长期缓存,后端与 nginx 同一套口径 2026-11-12 10:21:17 +08:00
package-lock.json 前端统一到 React 18 + Ant Design 5 + Vite + Zustand + React Router 6:控件不再在原生件上缝皮,Radix 那一层整体换成 antd 标准件 + 一层自有 kit,并把「谁定义控件」收口成词汇表。 2026-11-02 21:57:13 +08:00
package.json 前端按 Ant Design 规范重写:Header + 两级侧栏 + 页面内部页签,手写规范整体退场 2026-11-03 12:42:16 +08:00
tsconfig.json 前端统一到 React 18 + Ant Design 5 + Vite + Zustand + React Router 6:控件不再在原生件上缝皮,Radix 那一层整体换成 antd 标准件 + 一层自有 kit,并把「谁定义控件」收口成词汇表。 2026-11-02 21:57:13 +08:00
vite.config.ts 前端统一到 React 18 + Ant Design 5 + Vite + Zustand + React Router 6:控件不再在原生件上缝皮,Radix 那一层整体换成 antd 标准件 + 一层自有 kit,并把「谁定义控件」收口成词汇表。 2026-11-02 21:57:13 +08:00