Files
go-sms-V2/docs/acceptance/issue2-frontend-tabs.md
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

3.8 KiB

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——待用户提供或自行回贴。