Files
go-sms-V2/docs/acceptance/issue6-b3-release-log.md
T

3.6 KiB

Issue#6·B3 验收单:发布日志页移植 web-next(2026-11-18)

Issue#4 发布日志功能在 web-next(:5174) 的落地(B3 逐页指令制,用户点名页)。纯前端交付(后端零改动);基础设施(releases.ts/release store/markdown.ts/VersionBadge)B1 已随逻辑层复制就位,本次补视图 + 路由替换。

一、需求与落点

需求点 落点 状态
发布日志页在 web-next 可用 web-next/src/views/system/ReleaseLog.vue(蓝本=旧 web 同名页 Tailwind 契约直译)+ routes.ts component 替换 ✅
全角色可见 路由 meta roles=5 角色不变;侧栏「系统管理」组菜单数据驱动自动出现 ✅
红点联动 进页 onMounted → release.markSeen();VersionBadge 点击跳 /system/release(B1 已有,本次联通) ✅

二、交付清单

文件 说明
web-next/src/views/system/ReleaseLog.vue 新增。hero 概览卡(v 版本 mono + 日期 + 共 N 版 + 红点提示)+ 版本时间线卡片(mono 版本号 primary 色/tag 徽章/「当前版本」角标);markdown 预渲染 renderMarkdown 静态算一次;defineOptions({ name: 'system-release' }) 守 keep-alive 约定;无 h2.page-title(B3 视觉规范,顶栏 AppHeader h1#pageTitle 已显)
web-next/src/router/routes.ts L82 system/release component:ComingSoon → ReleaseLog.vue(meta 全角色/i-clock/系统管理组/subtitle 不变)

tag 徽章映射(契约 badge 族):新功能=badge-primary(teal)/优化=badge-warning(amber)/修复=badge-success(emerald)。

Markdown 深层样式(v-html :deep()):h3/h4/strong 色继承正文(零硬编码);code/marker/a 用 primary 色值 + html.dark 组合选择器覆盖(scoped 编译后 .rn-md[data-v] 锚点,与 Tailwind darkMode:'class' 同源)。

三、门禁(Chrome 冒烟 13/13 PASS,s2demo 登录,:5174)

# 断言 结果
1 登录进入 /home PASS
2 清 gosms_seen_ver 刷新 → 首访红点亮 PASS
3 侧栏菜单「发布日志」存在 PASS
4 点击(滚入视口)→ URL=/system/release PASS
5 顶栏页题=发布日志 PASS
6 内容页无 h2(B3 规范) PASS
7 hero:v1.5.0 + 2026-11-16 + 共 6 个版本 PASS
8 版本卡片 6 张(v1.0.0~v1.5.0) PASS
9 Markdown 渲染 h3=6 / li=18 PASS
10 v1.5.0 tag=badge-primary PASS
11 v1.5.0 卡「当前版本」角标 PASS
12 进页 markSeen(localStorage=1.5.0,红点灭) PASS
13 dark 复核(computed):strong gray-900→gray-100 / marker teal-600→teal-400 / 版本号 teal-400 PASS
  • vue-tsc 0 / vite build ✓(ReleaseLog chunk gzip 1.75 kB)。
  • 截图:/tmp/b3-release-light.png、/tmp/b3-release-dark.png(全页);脚本 /tmp/b3-release-smoke.mjs。
  • web-next 无 vitest(工程未配),四关=vue-tsc/build/Chrome 冒烟/commit。

四、口径与边界(诚实标注)

  1. 数据/语义与旧 web 完全同源:releases.ts 6 版大白话数据、红点=本地未读语义(换浏览器重提示,无服务端同步)、发版 SOP=releases.ts 头部插一条 + package.json 同步。
  2. 版本卡 tag 徽章色与旧 web 略异(旧:primary/amber/green 自定义;新:契约 badge 族),视觉口径以 web-next 契约为准。
  3. Chrome 冒烟发现并修复环境坑:旧 dev server(11-17 起)在 vite.config.ts 变更自动重启后丢失 vue 插件与 @ 别名(资源 500/白屏);杀进程重启 npx vite --host 0.0.0.0 --port 5174 --strictPort 即恢复。留痕:vite config 热重启不可信,改 config 后应人工重启 dev server。
  4. 冒烟点击菜单前需 scrollIntoViewIfNeeded(customer 菜单长,系统管理组在侧栏滚动容器底部)。