Files
go-sms-V2/docs/acceptance/issue2-frontend-tabs.md
T
Tory eaecd83ab0
ci / test (push) Canceled after 0s
ci / web-test (push) Canceled after 0s
ci / build (push) Canceled after 0s
ci / deploy-dev (push) Canceled after 0s
Issue#2: 管理前端多标签导航+页签缓存(Gitea 工单:可独立关闭/一次全部关闭/切换后缓存)—— ①多标签导航=stores/tabs.ts(tab 身份=fullPath,参数页每实例一 tab 带 #id 后缀;home 固定不可关;登出 $reset 防跨角色残留;close 关当前回退相邻右邻优先/closeOthers/closeAll)+TagsBar.vue(纯原生元素守 G2 断言语义;✕独立关闭+中键关闭[auxclick button===1,@click.middle 对中键永不触发]+关闭其他+全部关闭;aurora token 风格 primary-soft 激活/圆角10px);②keep-alive 页签缓存=MainLayout router-view v-slot+include=cachedNames+key=fullPath;**29 个业务视图 defineOptions name=路由名**(28 新增+stats/profit 由 StatsProfitView 对齐——script setup 文件名推断名永不命中 include:15 个 index.vue 全叫 index/PascalCase≠kebab);ComingSoon(11 路由共用)刻意豁免(无本地状态,不缓存零副作用);③守门=view-cache-name.spec.ts 固化组件名=路由名约定(漏写=缓存静默失效,测试红而非线上)+verify-layout.mjs +5 项 tags-bar 断言(18→23)且凭据 env 化(SHOT_USER/SHOT_PASS 缺省 s2demo——admin 原密码首启打印一次不可知,硬编码 admin123 已不可登录 ISC:401);④门禁=eslint0/vue-tsc0/vitest 165(+17:tabs-store 7+守门 4+tags-bar 6)/build 9.99s chunk 剖面不变;verify-layout 23/23;Chrome 157 实机走查 17/17 含两项核心状态保留实证(结算页内 Tab 选中+筛选账号ID=2 切走切回均保留;截图 /tmp/issue2-*.png);验收单 issue2-frontend-tabs.md+CHANGELOG+memory-bank 回填
2026-11-16 12:35:42 +08:00

41 lines
3.8 KiB
Markdown

# Issue#2 验收单:管理前端多标签导航 + 页签缓存(2026-11-16)
> 工单:Gitea `Tory/go-sms-V2` Issue #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 |
## 三、设计口径(评审可追溯)
1. **tab 身份=route.fullPath**:参数页(account/:id、channel/edit/:id?)每实例一 tab(标题带 `#id` 后缀);query 变体亦独立成 tab,与 keep-alive key 同口径。
2. **缓存身份=组件名=路由名**:keep-alive include 按组件名匹配,而 script setup 文件名推断名(15 个 index.vue 全叫 "index";PascalCase≠kebab 路由名)永不命中——守门测试固化此约定。
3. **同名多实例**(account/1 与 account/2):关闭其一缓存条目随名保留,最后一个同名 tab 关闭才真正释放(keep-alive 按名驱逐,有限驻留可接受)。
4. **刷新不持久化**:工单未要求;刷新后仅重开当前页 tab(watch immediate 兜底),增强项留待运营反馈。
## 四、已知边界与挂账
- ComingSoon 占位页每次进入重挂载(无状态可丢,刻意不缓存)。
- 标签不随刷新恢复(挂账增强项,非工单范围)。
- 工单评论回贴:Gitea API 读已验免 token(http://192.168.5.27:24400),写需 token——待用户提供或自行回贴。