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

52 lines
3.6 KiB
Markdown

# 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 菜单长,系统管理组在侧栏滚动容器底部)。