3.8 KiB
3.8 KiB
Issue#2 验收单:管理前端多标签导航 + 页签缓存(2026-11-16)
工单:Gitea
Tory/go-sms-V2Issue #2「优化:管理前端V1」(2026-11-16 11:07)。 需求原文:增加菜单Tab页(可独立关闭,一次全部关闭),现状是每个菜单独立打开,且切换后没有缓存,对运营非常不友好。
一、交付范围
| 组件 | 文件 | 说明 |
|---|---|---|
| 标签状态 | web/src/stores/tabs.ts |
pinia:visited[](tab 身份=fullPath);addTab 去重/错误页与 redirect 过滤;close(右邻优先回退)/closeOthers/closeAll;cachedNames(include 锚,同名去重);home 固定不可关 |
| 标签条 | web/src/components/TagsBar.vue |
纯原生元素(G2 断言语义:EP 导航壳不进布局壳);✕ 独立关闭+中键关闭(auxclick button===1;@click.middle 对中键永不触发)+关闭其他+全部关闭;aurora token 风格(primary-soft 激活/圆角 10px) |
| 布局挂载 | web/src/layouts/MainLayout.vue |
<router-view v-slot>+<keep-alive :include="tabs.cachedNames">+<component :key="viewRoute.fullPath">;watch fullPath→addTab(immediate);登出 $reset() 清标签防跨角色残留 |
| 缓存命名 | 29 个业务视图 SFC | 各加 defineOptions({ name: <路由名> })(28 新增+stats/profit 原名 StatsProfitView 对齐 'stats-profit');ComingSoon(11 路由共用)刻意豁免:无本地状态可保,不缓存零副作用 |
| 守门测试 | web/tests/view-cache-name.spec.ts |
遍历路由断言「组件名=路由名」——新增页面漏写 defineOptions 会缓存静默失效(页面照常、仅切 tab 丢状态),此类回归必须在测试红而非线上发现 |
| 配套测试 | web/tests/tabs-store.spec.ts(7)+web/tests/tags-bar.spec.ts(6) |
状态机全链(去重/关闭导航语义/固定标签/缓存名去重)+组件渲染与交互 |
| 断言扩展 | web/scripts/verify-layout.mjs |
+5 项:tags-bar 唯一/登录即 home chip/固定无 ✕/点菜单 chip+1/独立关闭回退;凭据 env 化(SHOT_USER/SHOT_PASS,缺省 s2demo——内置 admin 原密码首启打印一次已不可知) |
二、验证证据(2026-11-16)
| 门禁 | 结果 |
|---|---|
| eslint(max-warnings 0) | ✅ 0 |
| vue-tsc --noEmit | ✅ 0 |
| vitest | ✅ 165/165(148→+17:tabs-store 7+view-cache-name 4+tags-bar 6) |
| vite build | ✅ 9.99s(chunk 剖面不变,gzip 逐块<500KB 基线保持) |
| verify-layout(实渲染) | ✅ 23/23(原 18+新 5) |
| Chrome 157 实机走查(:5173,s2demo,单 page 铁律) | ✅ 17/17,两项核心 keep-alive 状态保留实证:①结算页内 Tab 切第 2 个→切走通道配置→切回仍选中;②筛选 账号ID=2→切走→切回保留;独立关后台不跳转/关当前回退相邻/全部关闭仅剩 home 回 /home;截图 /tmp/issue2-{settle-state,state-preserved,close-all}.png |
三、设计口径(评审可追溯)
- tab 身份=route.fullPath:参数页(account/:id、channel/edit/:id?)每实例一 tab(标题带
#id后缀);query 变体亦独立成 tab,与 keep-alive key 同口径。 - 缓存身份=组件名=路由名:keep-alive include 按组件名匹配,而 script setup 文件名推断名(15 个 index.vue 全叫 "index";PascalCase≠kebab 路由名)永不命中——守门测试固化此约定。
- 同名多实例(account/1 与 account/2):关闭其一缓存条目随名保留,最后一个同名 tab 关闭才真正释放(keep-alive 按名驱逐,有限驻留可接受)。
- 刷新不持久化:工单未要求;刷新后仅重开当前页 tab(watch immediate 兜底),增强项留待运营反馈。
四、已知边界与挂账
- ComingSoon 占位页每次进入重挂载(无状态可丢,刻意不缓存)。
- 标签不随刷新恢复(挂账增强项,非工单范围)。
- 工单评论回贴:Gitea API 读已验免 token(http://192.168.5.27:24400),写需 token——待用户提供或自行回贴。