lzf_0626
e6d74059f2
修复员工工作台顶部导航重复（入口 JS 被引两次）
## 现象
打开 `employee-console/workspace`（平台治理），页面上出现**两份一模一样的顶部栏**：
南方财富 / 模拟基金服务 / 平台治理 / 风控中心 / admin_t 管理员 —— 连同页脚一起各两份。
## 根因：同一个入口 JS 被引了两次，且 `?v=` 不同
`app/static/portal/employee-console/workspace/index.html` 里曾同时存在：
<script type="module" src=".../workspace.js?v=20260913-3"></script>
<script type="module" src=".../workspace.js?v=20260914"></script>
浏览器按**完整 URL** 去重，两条不同 query 被当成**两个模块**、**各执行一次**。
入口里的 `mountShell()` 因此跑了两次，而它当时是
`document.body.insertAdjacentHTML('afterbegin', ...)` —— **无条件插入**，
于是 header 与 footer 各插两份。
来源是合并事故（`git blame` 定位）：
| 行 | 提交 | 作者 |
|---|---|---|
| 旧 | `e31420df` | 卿云秋月（把版本号改成 `20260913-3`）|
| 新 | `f5d1b246` | 张胜宇（把版本号改成 `20260914`）|
两人各自把**同一行**的版本号换成新的，合并时两边都被保留，成了两行。
那个提交的信息是 "merge ... and retain risk review updates" ——
"retain" 在这里保留错了地方。
## 修法（两侧都堵）
1. **HTML 收敛成一行**（保留较新的 `?v=20260914`，与 `workspace.js` 内部
`api-client.js?v=20260914` 一致），并就地写明"改版本号是替换这一行、不是新增一行"。
2. **`mountShell` 加幂等保护**：已有 `.site-header` 就直接 return。
之所以不满足于只修那个 HTML —— 这个 bug 的症状很难反推到原因
（页面看起来只是"多了一块"），而以后谁加缓存版本号时很容易再犯一次。
## 防回归（两条测试，都做过负面验证）
- `test_no_portal_page_includes_the_same_script_twice`：扫 `app/static/portal` 下
**19 个页面**，把 `<script src>` 去掉 query 后比对，同一入口出现多次即失败。
负面验证：把重复行临时放回去，测试**精确报出**
`employee-console\workspace\index.html: ['/static/portal/employee-console/workspace/workspace.js']`，
恢复后通过。
- `test_mount_shell_is_idempotent`：断言 `app-shell.js` 里有那句幂等判断。
全站扫描确认**只有这一处**，不是批量问题。
## 实测
- `GET /portal/employee-console/workspace/` -> 200，页面里 `workspace.js` **只出现一次**
（`?v=20260914`）；静态 HTML 中 `site-header` 出现 **0 次**（确认由 JS 注入，
所以 JS 执行一次就只插一份）
- `pytest tests/unit/api/test_portal_frontend.py` -> **43 passed**（41 + 新增 2 条）
- `ruff check` -> All checks passed
## 一点说明
这次是"改同一个版本号"的合并冲突处理失误，属于**流程问题**而非个人疏忽：
两边都想把缓存版本号推新，冲突解决时很容易两边都留下。
测试补上之后，这类错误会在 `pytest tests/unit` 里当场暴露。
2026-09-14 12:06:38 +08:00
..
2026-09-09 21:55:37 +08:00
2026-09-09 21:55:37 +08:00
2026-09-09 21:55:37 +08:00
2026-09-11 16:57:47 +08:00
2026-09-11 16:57:47 +08:00
2026-09-11 16:57:47 +08:00
2026-09-11 16:57:47 +08:00
2026-09-13 19:17:56 +08:00
2026-09-13 15:56:54 +08:00
2026-09-12 12:57:16 +08:00
2026-09-14 12:06:38 +08:00
2026-09-11 16:57:47 +08:00
2026-09-11 16:57:47 +08:00
2026-09-11 16:57:47 +08:00
2026-09-11 15:21:36 +08:00
2026-09-14 10:50:48 +08:00
2026-09-11 14:08:55 +08:00
2026-09-11 16:57:47 +08:00
2026-09-11 16:57:47 +08:00
2026-09-10 13:56:08 +08:00