Issue#4: 版本号+发布日志(侧栏红点/系统管理二级菜单/运营大白话Markdown)——①单一事实源=data/releases.ts(APP_VERSION=首条;package.json 0.1.0→1.5.0 同步,releases.spec 两侧一致断言防漂移;版本线 v1.0.0~v1.5.0 六版全运营大白话);②侧栏底脚版本chip(MainLayout sidebar-foot 折叠按钮旁,点击进发布日志;红点=本地未读 localStorage gosms_seen_ver≠当前版本即亮,CSS gosms-ver-blink 脉冲闪烁,首访亮/点击或进页 markSeen 即灭/发新版全员再亮;折叠态64px 短版本 1.5+红点 badge 绝对定位——实测 monospace 渲染偏宽 v1.5 溢出 foot 55px>47px 修正);③发布日志页 views/system/ReleaseLog.vue(defineOptions name=system-release 守门)+路由 /system/release 全角色(同 faq 口径用户拍板,icon=Memo);④迷你Markdown渲染器 utils/markdown.ts 零新依赖(标题/无序有序列表 1.与1、顿号中文习惯/粗体/行内代码哨兵保护 code内**不误判/围栏代码块/链接仅http(s) javascript伪协议不渲染;先全量HTML转义再解析,v-html 零注入);⑤守门=releases.spec +14(数据一致性4:单一事实源/降序/semver/日期标签;渲染器7:格式+转义+伪协议+哨兵;store3:首访亮/markSeen灭+刷新持久/新版再亮)+guard 菜单33→34显式更+role-menu-matrix 登记 system-release:ALL+verify-layout 23→31(chip可见/文本vN.N/首访红点/点击跳转/已读即灭/卡片≥3实为6/md列表渲染/回home);⑥门禁=eslint0/vue-tsc0/vitest 179(165+14)/build 全绿;Chrome 157 实机走查4步(红点1→点击进页→已读0+localStorage=1.5.0→折叠1.5)+样式级复核(动画名gosms-ver-blink/chip几何/暗亮双主题可见);口径诚实标注:红点=本地未读语义(换浏览器/清缓存重提示一次,无服务端同步)/移动端≤900随sidebar-foot既有隐藏/发布内容=仓库静态数据;发版SOP=releases.ts头部插一条+package.json同步,部署后全员红点亮起;验收单issue4-release-notes.md+CHANGELOG+memory-bank回填;Gitea#4完成评论待用户(token)
This commit is contained in:
@@ -2,6 +2,17 @@
|
||||
|
||||
> 本仓 CHANGELOG 自重建起记(POC 明细见归档仓 /data/poc-archive/repos/go-sms.git 的 CHANGELOG.md,已冻结)。
|
||||
|
||||
## 2026-11-16(晚六)· Issue#4:版本号 + 发布日志(侧栏红点 / 系统管理二级菜单 / 运营大白话 Markdown)
|
||||
|
||||
- **工单**:Gitea Issue#4「增加:版本号及发布日志」——①菜单底部折叠展开旁显示最新版本号,有更新红点闪烁;②系统管理新增二级菜单「发布日志」,功能迭代明细用运营能读懂的大白话 + Markdown。
|
||||
- **单一事实源**:`web/src/data/releases.ts`(版本列表最新在前,`APP_VERSION = RELEASE_NOTES[0].version`);`package.json` version 0.1.0→**1.5.0** 同步,**tests/releases.spec.ts 断言两侧一致防漂移**;版本线 v1.0.0(11-13 平台一期上线)→ v1.5.0(11-16 客户对接打通+充值修复+本功能),文案全部运营向大白话(不写实现细节/工单号)。
|
||||
- **侧栏版本 chip**:MainLayout sidebar-foot(折叠按钮旁)加 `router-link → /system/release`(data-testid=sidebar-version);**红点=浏览器本地"未读"语义**:localStorage `gosms_seen_ver` ≠ 当前版本即亮(CSS `gosms-ver-blink` 脉冲闪烁);首访无记录=亮(引导看一次发布日志);点击 chip / 进入发布日志页 `markSeen()` 即灭;发新版重新部署后全员自动再亮。折叠态(64px)chip 缩为无边框短版本(v1.5)纵向排布。
|
||||
- **发布日志页**:`views/system/ReleaseLog.vue`(`defineOptions name='system-release'` 守门)+ 路由 `system/release`(**全角色**,同 faq 口径——发布日志本质是面向所有用户的平台公告,用户拍板;icon=Memo;subtitle=平台功能迭代明细·大白话版);时间线卡片=版本徽章+日期+标签(新功能/优化/修复)+「当前版本」角标。
|
||||
- **迷你 Markdown 渲染器**(`utils/markdown.ts`,**零新依赖**):标题/无序有序列表(`1.` 与 `1、` 顿号中文习惯均支持)/粗体/行内代码(哨兵保护,code 内 `**` 不误判粗体)/围栏代码块/链接(**仅 http(s)**,javascript: 伪协议不渲染为 a);**先全量 HTML 转义再解析**——内容源虽是仓库静态数据仍按不可信文本处理,v-html 零注入面。
|
||||
- **守门**:tests/releases.spec.ts **+14**(数据一致性 4:单一事实源/降序/semver/日期标签白名单;渲染器 7:格式+转义+伪协议+哨兵;store 3:首访亮/markSeen 灭+刷新持久/新版再亮);guard.spec 菜单计数 33→**34** 显式更;role-menu-matrix 登记 `system-release: ALL`;verify-layout.mjs **+8 断言(23→31)**:chip 可见/文本 vN.N/首访红点/点击跳转/已读即灭/版本卡片≥3/Markdown 列表渲染/回 home。
|
||||
- **门禁**:eslint 0 警/vue-tsc 0/**vitest 179 全绿(165+14)**/build ✓/verify-layout 31/31 ✓(Chrome 实机)。
|
||||
- **口径诚实标注**:红点为本地"未读"(换浏览器/清缓存会重新提示一次,无服务端已读同步——单机后台语义够用);移动端 ≤900 sidebar-foot 沿用既有隐藏约定(版本号仅桌面侧栏可见);发布内容=仓库静态数据,**发版 SOP=releases.ts 头部插一条 + package.json version 同步**,部署后全员红点亮起。验收单 `docs/acceptance/issue4-release-notes.md`。
|
||||
|
||||
## 2026-11-16(晚五)· Issue#3 联调闭环:客户(192.168.5.210)登录+提交+回执全链打通
|
||||
|
||||
- **登录**:15:47:13 `cmpp_conn_ok{s2demo, 192.168.5.210, ver=0x20}`+抓包 `CONNECT_RESP 2.0(21B) status=0` 双证——**-1 问题终结**(协议修复全链生效)。
|
||||
|
||||
@@ -0,0 +1,49 @@
|
||||
# Issue#4 验收单:版本号 + 发布日志(2026-11-16)
|
||||
|
||||
> 工单:Gitea Tory/go-sms-V2#4「增加:版本号及发布日志」。**纯前端交付(后端零改动)**;门禁四件 + verify-layout 全绿。
|
||||
|
||||
## 一、需求与落点
|
||||
|
||||
| 需求原文 | 落点 | 状态 |
|
||||
|---|---|---|
|
||||
| ①菜单底部,折叠展开旁边增加最新版本号,有更新时增加红点闪烁提示 | `MainLayout.vue` sidebar-foot 折叠按钮旁版本 chip(`data-testid=sidebar-version`,点击进发布日志页);红点=未读时 `gosms-ver-blink` CSS 脉冲闪烁 | ✅ |
|
||||
| ②系统管理增加二级菜单「发布日志」,功能迭代明细,运营大白话,Markdown 格式 | 路由 `/system/release`(**全角色**,同 faq 口径,用户拍板);`ReleaseLog.vue` 时间线卡片;`utils/markdown.ts` 迷你渲染器 | ✅ |
|
||||
|
||||
## 二、交付清单
|
||||
|
||||
| 文件 | 说明 |
|
||||
|---|---|
|
||||
| `web/src/data/releases.ts` | **单一事实源**:版本列表(最新在前,6 个版本 v1.0.0~v1.5.0,运营大白话 Markdown);`APP_VERSION = RELEASE_NOTES[0].version`;文件头含发版 SOP |
|
||||
| `web/src/utils/markdown.ts` | 迷你 Markdown→HTML(**零新依赖**):标题/无序有序列表(`1.` 与 `1、` 均支持)/粗体/行内代码(哨兵保护)/围栏代码块/链接(仅 http(s));**先全量 HTML 转义再解析** |
|
||||
| `web/src/stores/release.ts` | pinia store:`hasUpdate`(localStorage `gosms_seen_ver` ≠ APP_VERSION)/`markSeen()` |
|
||||
| `web/src/views/system/ReleaseLog.vue` | 发布日志页(`defineOptions name='system-release'`):hero 当前版本 + 版本时间线卡片(版本徽章/日期/标签/当前版本角标)+ Markdown 渲染 |
|
||||
| `web/src/layouts/MainLayout.vue` + `styles/shell.scss` | sidebar-foot 版本 chip(红点闪烁动画/折叠态 64px 短版本纵向/暗亮主题 token) |
|
||||
| `web/src/router/routes.ts` | `system/release` 路由(系统管理组,全角色,icon=Memo) |
|
||||
| `web/package.json` | version 0.1.0 → **1.5.0**(与 APP_VERSION 同步,测试断言防漂移) |
|
||||
| `web/tests/releases.spec.ts` | **+14 用例**(数据一致性 4/渲染器 7/store 3) |
|
||||
| `web/tests/guard.spec.ts` `role-menu-matrix.spec.ts` `web/scripts/verify-layout.mjs` | 菜单计数 33→34 显式更;矩阵登记 `system-release: ALL`;布局断言 23→**31** |
|
||||
|
||||
## 三、设计口径
|
||||
|
||||
1. **单一事实源**:版本号只在 `releases.ts` 头条维护;`APP_VERSION` 自动取首条,`package.json` 同步(测试两侧一致断言)。发版 SOP:**releases.ts 头部插一条(minor=功能/patch=修复)+ package.json version 同步**,部署后全员红点自动亮起。
|
||||
2. **红点语义(本地未读)**:localStorage `gosms_seen_ver` 存"上次已看过的版本";≠ 当前版本即亮;首访无记录=亮(引导看一次);点击 chip / 进入发布日志页即 `markSeen()` 熄灭;发新版后全员再亮。
|
||||
3. **Markdown 安全**:内容源=仓库静态数据(非用户输入),渲染器仍按不可信文本处理——先全量 HTML 转义再解析,链接仅 http(s)(javascript: 伪协议不渲染为 `<a>`),v-html 零注入面。
|
||||
4. **折叠态适配**:64px 窄栏下 chip 缩为无边框短版本(v1.5.0 → v1.5),与折叠按钮纵向排布;hover title 提示完整版本与更新引导。
|
||||
|
||||
## 四、门禁
|
||||
|
||||
- eslint **0 警** / vue-tsc **0** / vitest **179 全绿**(165+14)/ build ✓(chunk 剖面不变)。
|
||||
- verify-layout **31/31**(Chrome 实机,:5173,s2demo 登录):新增 8 项=chip 可见、文本 `vN.N`、首访红点存在、点击进发布日志、已读红点即灭、版本卡片 ≥3、Markdown 列表渲染、回 home。
|
||||
- 浏览器实机走查截图:`/tmp/issue4-*.png`(红点态/已读态/折叠态/发布日志页)。
|
||||
|
||||
## 五、口径与边界(诚实标注)
|
||||
|
||||
1. **红点为浏览器本地"未读"语义**:换浏览器/清缓存会重新提示一次;无服务端已读同步(单机管理后台语义够用,如需全员强提醒再挂后端)。
|
||||
2. **移动端(≤900px)**:sidebar-foot 沿用既有 `display:none` 约定,版本号仅桌面侧栏可见(工单语境为桌面管理后台)。
|
||||
3. **发布内容为仓库静态数据**:运营改文案=编辑 `releases.ts`(TypeScript 文件,格式有测试守门);不提供后台在线编辑(无需求,且内容发布本就应走代码评审)。
|
||||
4. CHANGELOG.md(技术向,仓库根)与发布日志(运营向,前端)是**两份受众不同的内容**,发版时各自更新。
|
||||
|
||||
## 六、遗留与下一步
|
||||
|
||||
- Gitea 工单 #4 完成评论待用户贴(写评论需 token)。
|
||||
- 版本线 v1.0.0~v1.4.0 的日期/内容为按 CHANGELOG 重建的运营向回顾(口径:一期 11-13 上线为 v1.0.0),如与用户预期划分不同,改 `releases.ts` 即可(纯数据)。
|
||||
@@ -2,6 +2,7 @@
|
||||
|
||||
## 当前状态快照(2026-11-16,**Issue#3 三连修复+方案B 系统配置落地,S4 泳道收官,一期 18/27 计划日**)
|
||||
|
||||
- **Issue#4 版本号+发布日志已交付(2026-11-16 晚六)**:①侧栏底脚(折叠按钮旁)版本 chip `v1.5.0`,未读红点 CSS 脉冲闪烁(localStorage `gosms_seen_ver`≠APP_VERSION;首访=亮;点击/进发布日志页 markSeen 即灭;发新版全员再亮);②系统管理二级菜单「发布日志」/system/release(**全角色**,同 faq 口径用户拍板),时间线卡片渲染 Markdown。**单一事实源=web/src/data/releases.ts**(APP_VERSION=首条;package.json 1.5.0 同步,releases.spec 断言防漂移);渲染器 utils/markdown.ts **零新依赖**(先全量 HTML 转义+仅 http(s) 链接,v-html 零注入)。门禁:eslint0/vue-tsc0/**vitest 179**(+14)/build/verify-layout **31/31**(+8)/Chrome 走查 4 步+样式级复核(折叠态曾溢出 foot 55px>47px,修=去 v 短版本 1.5+10px+红点 badge 绝对定位)。**发版 SOP=releases.ts 头部插一条+package.json 同步**;红点=本地未读语义(换浏览器重提示,无服务端同步);移动端 ≤900 版本号随 sidebar-foot 既有约定隐藏。验收单 issue4-release-notes.md;Gitea #4 完成评论待用户(token)。
|
||||
- **Issue#3 联调闭环(2026-11-16 晚五)🎉**:客户 192.168.5.210 登录成功(cmpp_conn_ok+抓包双证,-1 终结);首报「提交报错:0」=余额不足(MsgID=0+Result=10,充值 10000 恢复);重提 3 条全链打通(任务 status=2/明细 DELIVRD/计费正常)——**Issue#3 三问题(CMPP -1/充值无响应/SrcID 核验)全部闭环**。挂账:①抓包分析器混合流重组错位(D30/P2);②联调余额 10000 条在 s2demo;③上游 5.16:7890=旧平台网关与公网 121.46.230.53 同源(客户历史地址疑指此,已不影响联调)。
|
||||
|
||||
- **Issue#3 三连修复(2026-11-16 晚)**:①CMPP 连接报 -1 根因=`ConnectResp` 误按 **3.0 的 1B Status** 编码(标准 2.0 客户端按 4B 大端解析恒非 0)→ 修复=Marshal 4B(21B 包体)+AuthenticatorISMG 4B 参与 MD5+`ParseConnectResp` 自适应双布局(≥20B/2.0,17~19B/3.0);标准 2.0 探针真机实证 18B/垃圾值→21B/Status=0,**教训:2.0 与 3.0 在 CONNECT_RESP.Status/SUBMIT_RESP.Result 上互为镜像(2.0=4B/1B),自家 client+server 同源对称自测掩盖协议错位——同 Day39 坑**;②充值无响应=前端发 `{count}` 后端要 `{amount}`+submit 无 catch 静默吞错 → API/mock/组件三处修复;③SrcID 核验**用户裁定方案 C(前缀+动态扩展,行业惯例)**——s2demo 已配 ext_code=10690331(通道码即前缀),客户 SrcID 须以 10690331 开头+可追加扩展(≤21 位);真机四场景实证(纯码→10 过/码+扩展→10 过/不匹配→9/空→9);**运营口径:ext_code 变更后 30s 缓存生效(Day63 accCache)**。顺手修 TestClient_LoginOK 时序竞争(轮询吸收);门禁 -race 41 包/vitest 165/build 全绿;gateway 已串行部署(md5 比对 ✓)。
|
||||
|
||||
@@ -22,6 +22,7 @@
|
||||
| S4-D1/D2 C1 回调推送+C2 拉黑 | callback_task(v21)+PushWorker(指数退避/死信/重派)+双挂点(report 终态 Consumer/PairService+uplink 消费)+GET /ops/callback 管理面+前端回调管理页;C2 等值词表可配拉黑+Redis 即时生效;真机全链六步实证;**死信可查/拒收即拉黑两项验收 ✅** | ✅ 2026-11-16(s4-d1d2-callback.md) |
|
||||
| S4-D3 分区+冷热 | v22 RANGE(id) 分区(热 5 天+缓冲 3+pmax)+archive 域(CH 表/归档 job count 校验零丢失)+/record/history 冷查 16ms+settle-check 热窗感知(DetailPartial 两方基线);真机 5 连坑全修;**冷查<1s 验收 ✅,S4 三项全过收官** | ✅ 2026-11-16 下午(s4-d3-partition-archive.md) |
|
||||
| Issue#2 管理前端 | 多标签导航(TagsBar/tabs store:独立关闭+中键+关闭其他+全部关闭,home 固定)+keep-alive 页签缓存(include=路由名;29 视图 defineOptions name=路由名,守门 view-cache-name.spec;tab 身份=fullPath 参数页独立);vitest 165/verify-layout 23/Chrome 走查 17/17(内 Tab+筛选切走切回保留实证) | ✅ 2026-11-16 傍晚(issue2-frontend-tabs.md) |
|
||||
| Issue#4 版本号+发布日志 | 侧栏底脚版本 chip(红点=本地未读 localStorage gosms_seen_ver,CSS 脉冲闪烁,点击/进页 markSeen 即灭;折叠态 64px 短版本 1.5+红点 badge 绝对定位)+系统管理二级菜单「发布日志」(/system/release 全角色同 faq;ReleaseLog 时间线卡片);releases.ts 单一事实源(APP_VERSION=首条,package.json 1.5.0 同步防漂移断言);utils/markdown.ts 迷你渲染器零新依赖(先全量转义+仅 http(s) 链接);vitest 179(+14)/verify-layout 31(+8)/Chrome 走查+样式级复核(chip 几何/动画名/暗亮可见);**发版 SOP=releases.ts 头部插一条+package.json 同步** | ✅ 2026-11-16 晚(issue4-release-notes.md) |
|
||||
| 观察项 | 24h 稳定性门槛(11-13 17:55 起计;期内 21:33 宿主主动重启=已知事件不判失败)期满核验 11-14 17:55 | ✅ 2026-11-14 18:02 终判通过(dmesg 0/零重启/驻留+md5 一致;S5 压测前置确认,S1 完全闭环) |
|
||||
| S2~S5 | 结算域/前端收尾/C1C2+冷热/基线与灰度 | 🔄 S2✅S3✅**S4✅收官**(S5 见《Go-sms-重建计划.md》) |
|
||||
|
||||
|
||||
+1
-1
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "hwsms-web",
|
||||
"version": "0.1.0",
|
||||
"version": "1.5.0",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"packageManager": "pnpm@12.18.0",
|
||||
|
||||
@@ -63,6 +63,21 @@ await page.getByTestId('tag-channel-close').click()
|
||||
await page.waitForTimeout(500)
|
||||
ok(await page.locator('.tags-bar .tag-chip').count() === 1, `独立关闭生效并回退 home chip=1(实际 ${await page.locator('.tags-bar .tag-chip').count()})`)
|
||||
|
||||
// I4 · Issue#4 侧栏版本号 + 发布日志断言(桌面视口;全新会话 localStorage 空 → 红点亮)
|
||||
const verChip = page.getByTestId('sidebar-version')
|
||||
ok(await verChip.isVisible(), '侧栏底脚显示版本号 chip(折叠按钮旁)')
|
||||
const verText = ((await verChip.textContent()) ?? '').trim()
|
||||
ok(/^v\d+\.\d+/.test(verText), `版本号文本 vN.N(实际 ${verText})`)
|
||||
ok(await page.getByTestId('sidebar-version-dot').count() === 1, '首访未读 → 红点存在')
|
||||
await verChip.click()
|
||||
await page.waitForTimeout(500)
|
||||
ok(page.url().includes('/system/release'), '点击版本号进入发布日志页')
|
||||
ok(await page.getByTestId('sidebar-version-dot').count() === 0, '进入后红点消失(已读)')
|
||||
ok(await page.locator('.rn-item').count() >= 3, `发布日志版本卡片 ≥3(实际 ${await page.locator('.rn-item').count()})`)
|
||||
ok(await page.locator('.rn-md ul li').first().isVisible(), 'Markdown 列表已渲染')
|
||||
await page.getByTestId('menu-home').click()
|
||||
await page.waitForTimeout(300)
|
||||
|
||||
// 6) 移动端汉堡抽屉(375×812)
|
||||
await page.setViewportSize({ width: 375, height: 812 })
|
||||
await page.waitForTimeout(300)
|
||||
|
||||
@@ -0,0 +1,78 @@
|
||||
// data/releases.ts — Issue#4 版本号与发布日志(单一事实源)。
|
||||
//
|
||||
// 发版 SOP(每 次功能上线):
|
||||
// 1. 在 RELEASE_NOTES **头部**插入一条(最新在最前),version 沿语义化
|
||||
// 版本递增(major.minor.patch:功能=minor、修复/小改=patch);
|
||||
// 2. APP_VERSION 自动取首条 version;package.json 的 version 需手工同步
|
||||
// (tests/releases.spec.ts 断言两侧一致防漂移);
|
||||
// 3. 文案面向运营/客户的**大白话**(不写实现细节/工单号),Markdown 格式
|
||||
// (utils/markdown.ts 渲染:标题/有序无序列表/粗体/行内代码/代码块/链接)。
|
||||
// 4. 部署后所有用户侧栏底部亮红点,点击进入发布日志页即标记已读。
|
||||
|
||||
/** 一条发布日志。 */
|
||||
export interface ReleaseNote {
|
||||
version: string // 语义化版本 x.y.z(与 package.json 一致)
|
||||
date: string // 发布日期 YYYY-MM-DD
|
||||
tag: string // 标签:新功能 / 优化 / 修复
|
||||
markdown: string // 发布说明(大白话 Markdown)
|
||||
}
|
||||
|
||||
export const RELEASE_NOTES: ReleaseNote[] = [
|
||||
{
|
||||
version: '1.5.0',
|
||||
date: '2026-11-16',
|
||||
tag: '新功能',
|
||||
markdown: `### 客户对接全链打通
|
||||
- **客户软件直连平台**:客户用自己熟悉的短信软件(标准 CMPP 协议)即可连上平台,**登录、发短信、接收发送报告**全流程顺畅,之前"连接报错"的问题已彻底解决。
|
||||
- **充值修复**:给账号充值时偶尔"没反应"的问题已修复,现在充值成功后余额马上更新。
|
||||
- **版本号与发布日志上线**(就是您现在看的这个页面):左侧菜单底部显示当前版本号,平台有更新时会亮**红点**提醒,点开就能看这次更新了什么。`,
|
||||
},
|
||||
{
|
||||
version: '1.4.0',
|
||||
date: '2026-11-16',
|
||||
tag: '优化',
|
||||
markdown: `### 操作更顺手
|
||||
- **多标签页**:打开的功能页会变成顶部标签,像浏览器标签页一样——可单独关闭、一键关闭全部;切走再切回来,**之前填的筛选条件还在**,不用重新填。
|
||||
- **系统配置页上线**:平台级参数(默认接入码、上行拉黑词表等)有了专门的管理页面,改完**立即生效**,全部操作留痕。`,
|
||||
},
|
||||
{
|
||||
version: '1.3.0',
|
||||
date: '2026-11-16',
|
||||
tag: '新功能',
|
||||
markdown: `### 平台能力升级
|
||||
- **发送结果自动通知**:短信发出后(无论成功失败),平台可自动把结果**推送到客户自己的系统**,不用登录平台手动查。
|
||||
- **退订自动拉黑**:用户回复"退订 / R / 拒收"等关键词后,系统自动把该号码加入黑名单,以后不再给 TA 发短信,减少投诉风险。
|
||||
- **历史记录查询提速**:短信明细保留 5 天热数据,更早的自动转入历史库;查**几个月前的记录也在 1 秒内**出结果。`,
|
||||
},
|
||||
{
|
||||
version: '1.2.0',
|
||||
date: '2026-11-15',
|
||||
tag: '新功能',
|
||||
markdown: `### 经营看得清
|
||||
- **利润分析上线**:一眼看清**每个账号赚多少、每条通道花多少、平台整体净利多少**;支持按时间段筛选,口径说明常驻页面,数字怎么算的清清楚楚。
|
||||
- **通道页面焕新**:通道列表从 20 列精简为 8 列重点信息,不再眼花缭乱;编辑页按"基本信息 / 通道配置 / 优先级限额"分组,找配置更快。`,
|
||||
},
|
||||
{
|
||||
version: '1.1.0',
|
||||
date: '2026-11-14',
|
||||
tag: '新功能',
|
||||
markdown: `### 结算管理上线
|
||||
- **订单与账单**:给客户创建结算订单、按月生成账单、确认结账、导出 Excel 对账单,全流程在页面上完成。
|
||||
- **阶梯价**:支持"发得越多、单价越便宜"的阶梯计费,按月用量自动落档。
|
||||
- **对账保障**:平台内部三方数据自动核对,**金额分毫不差才允许结账**,保证账单准确。`,
|
||||
},
|
||||
{
|
||||
version: '1.0.0',
|
||||
date: '2026-11-13',
|
||||
tag: '新功能',
|
||||
markdown: `### 平台一期上线
|
||||
- **全新短信管理平台**重建完成,界面焕然一新。
|
||||
- **基础功能**:登录、运营总览(今日发送量 / 成功率一眼看)、账号管理(开户 / 充值 / 角色权限)。
|
||||
- **短信业务**:群发工作台、个性短信、定时任务、短信模板。
|
||||
- **记录中心**:下发记录、上行记录、失败重推——每条短信的来龙去脉都可查。
|
||||
- **多协议接入**:支持 **CMPP、SMPP、HTTP** 三种主流方式对接客户与通道。`,
|
||||
},
|
||||
]
|
||||
|
||||
/** 当前版本(=最新一条;侧栏版本号与红点判定的事实源)。 */
|
||||
export const APP_VERSION: string = RELEASE_NOTES[0]!.version
|
||||
@@ -45,6 +45,15 @@
|
||||
</template>
|
||||
</div>
|
||||
<div class="sidebar-foot">
|
||||
<!-- Issue#4:当前版本号(折叠按钮旁;点击进发布日志,有未读新版本时红点闪烁) -->
|
||||
<router-link
|
||||
to="/system/release" class="ver-chip" data-testid="sidebar-version"
|
||||
:title="release.hasUpdate ? `发现新版本 v${APP_VERSION},点击查看更新内容` : `当前版本 v${APP_VERSION}`"
|
||||
@click="release.markSeen()"
|
||||
>
|
||||
<span v-if="release.hasUpdate" class="ver-dot" data-testid="sidebar-version-dot"></span>
|
||||
<span class="ver-txt">{{ collapsed ? shortVersion : `v${APP_VERSION}` }}</span>
|
||||
</router-link>
|
||||
<button class="collapse-btn" :aria-label="collapsed ? '展开侧栏' : '收起侧栏'" data-testid="sidebar-collapse-btn" @click="toggleCollapse">
|
||||
<span class="cg" :style="{ transform: collapsed ? 'rotate(180deg)' : '' }">❮</span>
|
||||
</button>
|
||||
@@ -78,13 +87,20 @@ import { computed, ref, watch } from 'vue'
|
||||
import { useRoute, useRouter } from 'vue-router'
|
||||
import { useUserStore } from '@/stores/user'
|
||||
import { useTabsStore } from '@/stores/tabs'
|
||||
import { useReleaseStore } from '@/stores/release'
|
||||
import { accessibleRoutes } from '@/router/guard'
|
||||
import { APP_VERSION } from '@/data/releases'
|
||||
import TagsBar from '@/components/TagsBar.vue'
|
||||
|
||||
const route = useRoute()
|
||||
const router = useRouter()
|
||||
const userStore = useUserStore()
|
||||
const tabs = useTabsStore()
|
||||
// Issue#4:版本已读状态(侧栏版本号红点判定)
|
||||
const release = useReleaseStore()
|
||||
// 折叠态(64px 窄栏)短版本:v1.5.0 → 1.5(去 v 前缀,实测 monospace 渲染偏宽,
|
||||
// 带 v 的 "v1.5" 在 64px 侧栏溢出 foot 内容区——style-check 实测 55px>47px)
|
||||
const shortVersion = computed(() => APP_VERSION.split('.').slice(0, 2).join('.'))
|
||||
|
||||
// ===== 暗色模式(html.dark;demo data-theme 的项目语义映射) =====
|
||||
const isDark = ref(document.documentElement.classList.contains('dark'))
|
||||
|
||||
@@ -76,6 +76,9 @@ export const asyncRoutes: RouteRecordRaw[] = [
|
||||
|
||||
{ path: 'logs', name: 'logs', component: () => import('@/views/coming/ComingSoon.vue'), meta: { title: '日志报表', icon: 'Document', menu: true, group: '系统管理', roles: ['admin', 'ops', 'service'] } },
|
||||
{ path: 'system', name: 'system', component: () => import('@/views/system/index.vue'), meta: { title: '系统配置', icon: 'Setting', menu: true, group: '系统管理', roles: ['admin'], subtitle: '系统级参数 KV · 默认接入码 · 拉黑词表' } },
|
||||
// Issue#4 发布日志:面向全体用户的平台更新公告(全角色,同 faq 口径);
|
||||
// 版本数据单一事实源=src/data/releases.ts(发版 SOP 见文件头注)。
|
||||
{ path: 'system/release', name: 'system-release', component: () => import('@/views/system/ReleaseLog.vue'), meta: { title: '发布日志', icon: 'Memo', menu: true, group: '系统管理', roles: ['admin', 'ops', 'service', 'group', 'customer'], subtitle: '平台功能迭代明细 · 大白话版' } },
|
||||
{ path: 'faq', name: 'faq', component: () => import('@/views/coming/ComingSoon.vue'), meta: { title: '常见问题', icon: 'QuestionFilled', menu: true, group: '系统管理', roles: ['admin', 'ops', 'service', 'group', 'customer'] } },
|
||||
|
||||
// 隐藏页(不在菜单)
|
||||
|
||||
@@ -0,0 +1,29 @@
|
||||
// stores/release.ts — Issue#4 版本已读状态(侧栏红点判定)。
|
||||
//
|
||||
// 口径:localStorage 记"上次已看过的版本"(gosms_seen_ver),≠ 当前版本
|
||||
// APP_VERSION 即视为"有更新"(红点亮);首次访问无记录=有更新,引导用户
|
||||
// 看一次发布日志。红点为浏览器本地"未读"语义——换浏览器/清缓存会重新
|
||||
// 提示一次(验收单如实标注),平台侧不做服务端已读同步。
|
||||
import { defineStore } from 'pinia'
|
||||
import { APP_VERSION } from '@/data/releases'
|
||||
|
||||
const SEEN_KEY = 'gosms_seen_ver'
|
||||
|
||||
function loadSeen(): string {
|
||||
return localStorage.getItem(SEEN_KEY) ?? ''
|
||||
}
|
||||
|
||||
export const useReleaseStore = defineStore('release', {
|
||||
state: (): { seenVer: string } => ({ seenVer: loadSeen() }),
|
||||
getters: {
|
||||
/** 有未读新版本(侧栏版本号旁红点闪烁的判定源)。 */
|
||||
hasUpdate: (s): boolean => s.seenVer !== APP_VERSION,
|
||||
},
|
||||
actions: {
|
||||
/** 标记当前版本已读(点击版本号 / 进入发布日志页时调用)。 */
|
||||
markSeen() {
|
||||
this.seenVer = APP_VERSION
|
||||
localStorage.setItem(SEEN_KEY, APP_VERSION)
|
||||
},
|
||||
},
|
||||
})
|
||||
@@ -58,8 +58,8 @@ html:not(.dark) .topbar { background: rgba(255, 255, 255, 0.72); }
|
||||
/* W6:菜单滚动区(flex:1 承接)+底脚收起按钮固定最下方 */
|
||||
.nav-scroll { flex: 1; min-height: 0; overflow-y: auto; scrollbar-width: none; }
|
||||
.nav-scroll::-webkit-scrollbar { display: none; }
|
||||
.sidebar-foot { flex-shrink: 0; display: flex; padding: 10px 0 0; margin-top: 8px; border-top: 1px solid var(--gosms-border); }
|
||||
.sidebar.collapsed .sidebar-foot { justify-content: center; }
|
||||
.sidebar-foot { flex-shrink: 0; display: flex; align-items: center; gap: 8px; padding: 10px 0 0; margin-top: 8px; border-top: 1px solid var(--gosms-border); }
|
||||
.sidebar.collapsed .sidebar-foot { justify-content: center; flex-direction: column; gap: 6px; }
|
||||
html:not(.dark) .sidebar { background: rgba(255, 255, 255, 0.55); }
|
||||
.nav-group { font-size: 10px; color: var(--gosms-text-muted); letter-spacing: 0.16em; padding: 16px 12px 6px; }
|
||||
.nav-item {
|
||||
@@ -165,6 +165,14 @@ html:not(.dark) .card:hover { box-shadow: 0 8px 28px rgba(13, 148, 136, 0.12); }
|
||||
.collapse-btn { display: grid; place-items: center; width: 34px; height: 34px; border: 1px solid var(--gosms-border); border-radius: 8px; background: none; color: var(--gosms-text-muted); cursor: pointer; font-size: 13px; transition: all 0.2s; }
|
||||
.collapse-btn:hover { color: var(--gosms-primary); border-color: var(--gosms-primary); }
|
||||
.collapse-btn .cg { display: inline-block; transition: transform 0.25s; }
|
||||
/* Issue#4:侧栏底脚版本 chip(折叠按钮旁;点击进发布日志,未读新版本红点闪烁) */
|
||||
.ver-chip { display: inline-flex; align-items: center; gap: 6px; height: 34px; padding: 0 12px; border: 1px solid var(--gosms-border); border-radius: 999px; color: var(--gosms-text-dim, #909399); font-family: ui-monospace, monospace; font-size: 12px; text-decoration: none; white-space: nowrap; transition: all 0.2s; position: relative; }
|
||||
.ver-chip:hover { color: var(--gosms-primary); border-color: var(--gosms-primary); }
|
||||
.ver-chip .ver-dot { flex: none; width: 7px; height: 7px; border-radius: 50%; background: #f56c6c; animation: gosms-ver-blink 1.1s ease-in-out infinite; }
|
||||
@keyframes gosms-ver-blink { 0%, 100% { opacity: 1; box-shadow: 0 0 0 0 rgba(245, 108, 108, 0.55); } 50% { opacity: 0.45; box-shadow: 0 0 0 5px rgba(245, 108, 108, 0); } }
|
||||
/* 折叠态(64px):chip 缩为无边框短版本(1.5);红点转绝对定位悬浮右上(badge 式,不占宽防溢出) */
|
||||
.sidebar.collapsed .ver-chip { height: auto; padding: 2px 4px; border-color: transparent; font-size: 10px; gap: 0; }
|
||||
.sidebar.collapsed .ver-chip .ver-dot { position: absolute; top: -2px; right: -4px; box-shadow: 0 0 0 2px rgba(255, 255, 255, 0.35); }
|
||||
.sidebar.collapsed { width: 64px; padding: 16px 8px; }
|
||||
.sidebar.collapsed .nav-item { justify-content: center; padding: 8px 0; }
|
||||
.sidebar.collapsed .nav-item .txt { display: none; }
|
||||
|
||||
@@ -0,0 +1,89 @@
|
||||
// utils/markdown.ts — Issue#4 迷你 Markdown 渲染器(发布日志专用,零依赖)。
|
||||
//
|
||||
// 支持范围(够用即止,不求 GFM 全集):
|
||||
// 标题 #~####、无序列表(-/*)、有序列表(1. / 1、)、粗体 **x**、
|
||||
// 行内代码 \`x\`、围栏代码块 \`\`\`、链接 [t](https://…)(仅 http/https)、
|
||||
// 空行分段(段内换行 → <br>)。
|
||||
// 安全口径:**输入先整体 HTML 转义再解析**——内容源虽是仓库静态数据
|
||||
// (releases.ts),仍按不可信文本处理,任何标签/引号都不会进入 DOM;
|
||||
// 链接仅允许 http(s) 协议(javascript: 伪协议不命中即保持原样文本)。
|
||||
|
||||
/** HTML 全量转义(含引号,防属性注入)。 */
|
||||
function escapeHtml(s: string): string {
|
||||
return s
|
||||
.replace(/&/g, '&')
|
||||
.replace(/</g, '<')
|
||||
.replace(/>/g, '>')
|
||||
.replace(/"/g, '"')
|
||||
.replace(/'/g, ''')
|
||||
}
|
||||
|
||||
/** 行内格式:行内代码(哨兵保护,内部不做粗体/链接替换)→ 粗体 → 链接。 */
|
||||
const CODE_SENTINEL = '@@GOSMS_MD_CODE_'
|
||||
function inline(s: string): string {
|
||||
const codes: string[] = []
|
||||
let t = s.replace(/`([^`]+)`/g, (_m, c: string) => {
|
||||
codes.push(c)
|
||||
return `${CODE_SENTINEL}${codes.length - 1}@@`
|
||||
})
|
||||
t = t.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>')
|
||||
t = t.replace(/\[([^\]]+)\]\((https?:\/\/[^)\s]+)\)/g, '<a href="$2" target="_blank" rel="noopener noreferrer">$1</a>')
|
||||
return t.replace(new RegExp(`${CODE_SENTINEL}(\\d+)@@`, 'g'), (_m, i: string) => `<code>${codes[Number(i)]!}</code>`)
|
||||
}
|
||||
|
||||
/** 块级行判据(段落收集的截断条件):代码围栏 / 标题 / 列表。 */
|
||||
const BLOCK_START = /^(#{1,4}\s|\s*[-*]\s|\s*\d+(?:\.\s+|、\s*)|```)/
|
||||
/** 有序列表行:点号后须空格(英文习惯),顿号后空格可选(中文习惯)。 */
|
||||
const OL_LINE = /^\s*\d+(?:\.\s+|、\s*)/
|
||||
|
||||
/** Markdown → HTML(输入不可信,输出已全量转义;v-html 挂载)。 */
|
||||
export function renderMarkdown(src: string): string {
|
||||
const lines = escapeHtml(src.replace(/\r\n/g, '\n')).split('\n')
|
||||
const out: string[] = []
|
||||
let i = 0
|
||||
while (i < lines.length) {
|
||||
const line = lines[i]!
|
||||
// 围栏代码块:内容保持原样(不再做行内格式化)
|
||||
if (line.trim().startsWith('```')) {
|
||||
const buf: string[] = []
|
||||
i++
|
||||
while (i < lines.length && !lines[i]!.trim().startsWith('```')) buf.push(lines[i++]!)
|
||||
i++ // 跳过闭合围栏(缺闭合则吞到结尾)
|
||||
out.push(`<pre><code>${buf.join('\n')}</code></pre>`)
|
||||
continue
|
||||
}
|
||||
// 标题 # ~ ####
|
||||
const h = /^(#{1,4})\s+(.*)$/.exec(line)
|
||||
if (h) {
|
||||
const lv = h[1]!.length
|
||||
out.push(`<h${lv}>${inline(h[2]!)}</h${lv}>`)
|
||||
i++
|
||||
continue
|
||||
}
|
||||
// 无序列表
|
||||
if (/^\s*[-*]\s+/.test(line)) {
|
||||
const items: string[] = []
|
||||
while (i < lines.length && /^\s*[-*]\s+/.test(lines[i]!)) items.push(inline(lines[i++]!.replace(/^\s*[-*]\s+/, '')))
|
||||
out.push(`<ul>${items.map((x) => `<li>${x}</li>`).join('')}</ul>`)
|
||||
continue
|
||||
}
|
||||
// 有序列表(1. 或 1、)
|
||||
if (OL_LINE.test(line)) {
|
||||
const items: string[] = []
|
||||
while (i < lines.length && OL_LINE.test(lines[i]!)) items.push(inline(lines[i++]!.replace(OL_LINE, '')))
|
||||
out.push(`<ol>${items.map((x) => `<li>${x}</li>`).join('')}</ol>`)
|
||||
continue
|
||||
}
|
||||
// 空行
|
||||
if (line.trim() === '') {
|
||||
i++
|
||||
continue
|
||||
}
|
||||
// 段落:连续普通行合并,行间 <br>
|
||||
const buf: string[] = [line]
|
||||
i++
|
||||
while (i < lines.length && lines[i]!.trim() !== '' && !BLOCK_START.test(lines[i]!)) buf.push(lines[i++]!)
|
||||
out.push(`<p>${buf.map(inline).join('<br>')}</p>`)
|
||||
}
|
||||
return out.join('\n')
|
||||
}
|
||||
@@ -0,0 +1,75 @@
|
||||
<template>
|
||||
<section class="rn-wrap" data-testid="release-log">
|
||||
<div class="card rn-hero">
|
||||
<span class="rn-hero-ver">v{{ latest.version }}</span>
|
||||
<span class="rn-hero-date">{{ latest.date }} 发布</span>
|
||||
<span class="rn-hero-count">共 {{ notes.length }} 个版本</span>
|
||||
<span class="rn-hero-tip">侧栏底部亮红点 = 有您还没看过的新版本</span>
|
||||
</div>
|
||||
|
||||
<article v-for="r in notes" :key="r.version" class="card rn-item" :data-testid="`release-${r.version}`">
|
||||
<header class="rn-head">
|
||||
<span class="rn-ver">v{{ r.version }}</span>
|
||||
<span class="rn-tag" :class="`rn-tag-${r.tagKey}`">{{ r.tag }}</span>
|
||||
<span class="rn-date">{{ r.date }}</span>
|
||||
<span v-if="r.version === APP_VERSION" class="rn-cur">当前版本</span>
|
||||
</header>
|
||||
<!-- 内容=仓库内置静态数据,渲染前已全量 HTML 转义——见 utils/markdown.ts -->
|
||||
<div class="rn-md" v-html="r.html"></div>
|
||||
</article>
|
||||
</section>
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
// Issue#4 发布日志页(keep-alive 缓存锚点——组件名必须=路由 name)。
|
||||
defineOptions({ name: 'system-release' })
|
||||
import { computed, onMounted } from 'vue'
|
||||
import { APP_VERSION, RELEASE_NOTES } from '@/data/releases'
|
||||
import { renderMarkdown } from '@/utils/markdown'
|
||||
import { useReleaseStore } from '@/stores/release'
|
||||
|
||||
const release = useReleaseStore()
|
||||
|
||||
const latest = computed(() => RELEASE_NOTES[0]!)
|
||||
|
||||
// 预渲染 markdown(静态数据,挂载时算一次即可,避免 v-html 重渲重复解析)。
|
||||
const notes = RELEASE_NOTES.map((r) => {
|
||||
const tagKey = r.tag === '新功能' ? 'new' : r.tag === '优化' ? 'opt' : 'fix'
|
||||
return { ...r, tagKey, html: renderMarkdown(r.markdown) }
|
||||
})
|
||||
|
||||
// 进入发布日志页即视为已读 → 侧栏红点消失。
|
||||
onMounted(() => release.markSeen())
|
||||
</script>
|
||||
|
||||
<style scoped>
|
||||
.rn-wrap { display: flex; flex-direction: column; gap: 12px; }
|
||||
|
||||
.rn-hero { display: flex; align-items: baseline; gap: 10px; padding: 14px 18px; flex-wrap: wrap; }
|
||||
.rn-hero-ver { font-size: 20px; font-weight: 700; font-family: ui-monospace, monospace; color: var(--gosms-text-bright); }
|
||||
.rn-hero-date, .rn-hero-count { font-size: 12px; color: var(--gosms-text-dim, #909399); }
|
||||
.rn-hero-tip { margin-left: auto; font-size: 12px; color: var(--gosms-text-dim, #909399); }
|
||||
|
||||
.rn-item { padding: 14px 18px; }
|
||||
.rn-head { display: flex; align-items: center; gap: 8px; padding-bottom: 10px; margin-bottom: 10px; border-bottom: 1px solid var(--gosms-border); flex-wrap: wrap; }
|
||||
.rn-ver { font-size: 16px; font-weight: 700; font-family: ui-monospace, monospace; color: var(--gosms-primary); }
|
||||
.rn-tag { font-size: 11px; line-height: 18px; padding: 0 8px; border-radius: 999px; flex: none; }
|
||||
.rn-tag-new { color: #2dd4bf; background: rgba(45, 212, 191, 0.12); }
|
||||
.rn-tag-opt { color: #e6a23c; background: rgba(230, 162, 60, 0.14); }
|
||||
.rn-tag-fix { color: #67c23a; background: rgba(103, 194, 58, 0.14); }
|
||||
.rn-date { font-size: 12px; color: var(--gosms-text-dim, #909399); }
|
||||
.rn-cur { margin-left: auto; font-size: 11px; line-height: 18px; padding: 0 8px; border-radius: 999px; color: var(--gosms-primary); border: 1px solid var(--gosms-border-glow); }
|
||||
|
||||
/* Markdown 渲染样式(v-html 深层) */
|
||||
.rn-md { font-size: 13px; line-height: 1.8; }
|
||||
.rn-md :deep(h3), .rn-md :deep(h4) { margin: 4px 0 6px; font-size: 13.5px; font-weight: 600; color: var(--gosms-text-bright); }
|
||||
.rn-md :deep(p) { margin: 6px 0; }
|
||||
.rn-md :deep(ul), .rn-md :deep(ol) { margin: 6px 0; padding-left: 20px; }
|
||||
.rn-md :deep(li) { margin: 3px 0; }
|
||||
.rn-md :deep(li::marker) { color: var(--gosms-primary); }
|
||||
.rn-md :deep(strong) { color: var(--gosms-text-bright); font-weight: 600; }
|
||||
.rn-md :deep(code) { font-family: ui-monospace, monospace; font-size: 12px; padding: 0 5px; border-radius: 4px; background: var(--gosms-primary-soft); color: var(--gosms-primary-strong); }
|
||||
.rn-md :deep(pre) { margin: 8px 0; padding: 10px 12px; border-radius: 8px; background: rgba(127, 127, 127, 0.12); overflow-x: auto; }
|
||||
.rn-md :deep(pre code) { background: none; padding: 0; color: inherit; }
|
||||
.rn-md :deep(a) { color: var(--gosms-primary); text-decoration: none; border-bottom: 1px dashed var(--gosms-border-glow); }
|
||||
</style>
|
||||
@@ -2,13 +2,13 @@ import { describe, expect, it } from 'vitest'
|
||||
import { accessibleRoutes } from '@/router/guard'
|
||||
|
||||
describe('路由权限过滤 accessibleRoutes', () => {
|
||||
it('admin 直通全部业务路由(32 模块菜单,含 FE-2 通道与策略五入口+D19 定时任务+D20 模板管理+D22 结果反馈+D23 短信聚合页+D24 下行记录+D27 上行记录+D28 回执工具+S3·FE-D34 利润分析+S4·C1 回调管理)', () => {
|
||||
it('admin 直通全部业务路由(34 模块菜单,含 FE-2 通道与策略五入口+D19 定时任务+D20 模板管理+D22 结果反馈+D23 短信聚合页+D24 下行记录+D27 上行记录+D28 回执工具+S3·FE-D34 利润分析+S4·C1 回调管理+Issue#4 发布日志)', () => {
|
||||
const all = accessibleRoutes(['admin'])
|
||||
const menus = all.flatMap((r) => (r.children ?? []).filter((c) => c.meta?.menu))
|
||||
expect(menus.length).toBe(33)
|
||||
// FE-2/D23/S3 关键入口在菜单(D11 上家/D14 通道组/D16 导流+报备/D19 定时任务/D20 模板管理/D22 结果反馈/D23 聚合页/FE-D34 利润分析)
|
||||
expect(menus.length).toBe(34)
|
||||
// FE-2/D23/S3/Issue#4 关键入口在菜单(D11 上家/D14 通道组/D16 导流+报备/D19 定时任务/D20 模板管理/D22 结果反馈/D23 聚合页/FE-D34 利润分析/发布日志)
|
||||
const names = menus.map((m) => m.name)
|
||||
for (const want of ['channel-upstream', 'channel-group', 'policy-route', 'policy-report', 'sms-timer', 'sms-template', 'sms-result', 'sms-home', 'record-down', 'stats-profit', 'ops-callback']) {
|
||||
for (const want of ['channel-upstream', 'channel-group', 'policy-route', 'policy-report', 'sms-timer', 'sms-template', 'sms-result', 'sms-home', 'record-down', 'stats-profit', 'ops-callback', 'system-release']) {
|
||||
expect(names).toContain(want)
|
||||
}
|
||||
})
|
||||
|
||||
@@ -0,0 +1,107 @@
|
||||
// releases.spec.ts — Issue#4 守门三件:
|
||||
// 1. 发布日志数据一致性(单一事实源:releases.ts 头条 ↔ package.json,防漂移);
|
||||
// 2. 迷你 Markdown 渲染器(utils/markdown.ts:格式 + 全量转义防注入);
|
||||
// 3. 版本已读状态(stores/release.ts:红点判定/持久化/新版本再亮)。
|
||||
import { beforeEach, describe, expect, it } from 'vitest'
|
||||
import { createPinia, setActivePinia } from 'pinia'
|
||||
import pkg from '../package.json'
|
||||
import { APP_VERSION, RELEASE_NOTES } from '@/data/releases'
|
||||
import { renderMarkdown } from '@/utils/markdown'
|
||||
import { useReleaseStore } from '@/stores/release'
|
||||
|
||||
describe('Issue#4 发布日志数据(单一事实源)', () => {
|
||||
it('APP_VERSION = 最新一条(头部)', () => {
|
||||
expect(APP_VERSION).toBe(RELEASE_NOTES[0]!.version)
|
||||
})
|
||||
|
||||
it('package.json version 与 APP_VERSION 一致(防两处漂移)', () => {
|
||||
expect(pkg.version).toBe(APP_VERSION)
|
||||
})
|
||||
|
||||
it('版本号语义化(x.y.z)且严格降序', () => {
|
||||
const nums = RELEASE_NOTES.map((r) => r.version.split('.').map(Number))
|
||||
for (const v of nums) {
|
||||
expect(v.length === 3 && v.every((n) => Number.isInteger(n)), `${v.join('.')} 非 x.y.z`).toBe(true)
|
||||
}
|
||||
for (let i = 1; i < nums.length; i++) {
|
||||
const a = nums[i - 1]!
|
||||
const b = nums[i]!
|
||||
const newer = a[0]! > b[0]! || (a[0]! === b[0]! && (a[1]! > b[1]! || (a[1]! === b[1]! && a[2]! > b[2]!)))
|
||||
expect(newer, `${a.join('.')} 应新于 ${b.join('.')}`).toBe(true)
|
||||
}
|
||||
})
|
||||
|
||||
it('日期 YYYY-MM-DD / 标签白名单 / markdown 非空', () => {
|
||||
expect(RELEASE_NOTES.length).toBeGreaterThanOrEqual(1)
|
||||
for (const r of RELEASE_NOTES) {
|
||||
expect(r.date).toMatch(/^\d{4}-\d{2}-\d{2}$/)
|
||||
expect(['新功能', '优化', '修复']).toContain(r.tag)
|
||||
expect(r.markdown.trim().length).toBeGreaterThan(0)
|
||||
}
|
||||
})
|
||||
})
|
||||
|
||||
describe('Issue#4 迷你 Markdown 渲染器', () => {
|
||||
it('标题 #~####', () => {
|
||||
expect(renderMarkdown('### 标题')).toContain('<h3>标题</h3>')
|
||||
expect(renderMarkdown('#### 小标题')).toContain('<h4>小标题</h4>')
|
||||
})
|
||||
|
||||
it('无序 / 有序列表', () => {
|
||||
expect(renderMarkdown('- 甲\n- 乙')).toContain('<ul><li>甲</li><li>乙</li></ul>')
|
||||
expect(renderMarkdown('1. 第一步\n2、第二步')).toContain('<ol><li>第一步</li><li>第二步</li></ol>')
|
||||
})
|
||||
|
||||
it('粗体 / 行内代码 / 段内换行 <br>', () => {
|
||||
expect(renderMarkdown('这是**重点**')).toContain('<strong>重点</strong>')
|
||||
expect(renderMarkdown('按 `Ctrl` 键')).toContain('<code>Ctrl</code>')
|
||||
expect(renderMarkdown('第一行\n第二行')).toContain('<br>')
|
||||
})
|
||||
|
||||
it('链接仅允许 http(s)(javascript: 伪协议不渲染为 <a>)', () => {
|
||||
expect(renderMarkdown('[官网](https://example.com)')).toContain('<a href="https://example.com"')
|
||||
expect(renderMarkdown('[x](javascript:alert(1))')).not.toContain('<a ')
|
||||
})
|
||||
|
||||
it('HTML 全量转义(内容自控仍防注入)', () => {
|
||||
const h = renderMarkdown('<script>alert(1)</script> & "引号"')
|
||||
expect(h).not.toContain('<script>')
|
||||
expect(h).toContain('<script>')
|
||||
expect(h).toContain('&')
|
||||
})
|
||||
|
||||
it('围栏代码块内容保持原样(不做行内格式化)', () => {
|
||||
expect(renderMarkdown('```\n**raw**\n```')).toContain('<pre><code>**raw**</code></pre>')
|
||||
})
|
||||
|
||||
it('行内代码内的 ** 不误判粗体', () => {
|
||||
expect(renderMarkdown('`a**b`')).toContain('<code>a**b</code>')
|
||||
expect(renderMarkdown('`a**b`')).not.toContain('<strong>')
|
||||
})
|
||||
})
|
||||
|
||||
describe('Issue#4 版本已读状态(红点判定)', () => {
|
||||
beforeEach(() => {
|
||||
localStorage.clear()
|
||||
setActivePinia(createPinia())
|
||||
})
|
||||
|
||||
it('首访(无记录)= 有更新(引导看一次发布日志)', () => {
|
||||
expect(useReleaseStore().hasUpdate).toBe(true)
|
||||
})
|
||||
|
||||
it('markSeen 后红点消失且 localStorage 持久(刷新仍已读)', () => {
|
||||
const s = useReleaseStore()
|
||||
s.markSeen()
|
||||
expect(s.hasUpdate).toBe(false)
|
||||
expect(localStorage.getItem('gosms_seen_ver')).toBe(APP_VERSION)
|
||||
// 模拟刷新:新 pinia 实例从 localStorage 恢复,仍为已读
|
||||
setActivePinia(createPinia())
|
||||
expect(useReleaseStore().hasUpdate).toBe(false)
|
||||
})
|
||||
|
||||
it('发新版本后(本地记录为旧版本)红点重新亮起', () => {
|
||||
localStorage.setItem('gosms_seen_ver', '0.0.1')
|
||||
expect(useReleaseStore().hasUpdate).toBe(true)
|
||||
})
|
||||
})
|
||||
@@ -27,6 +27,8 @@ const MATRIX: Record<string, Roles[]> = {
|
||||
'stats-profit': ['admin', 'ops', 'service'], settle: ['admin', 'ops'],
|
||||
'ops-callback': ['admin', 'ops'],
|
||||
logs: ['admin', 'ops', 'service'], system: ['admin'], faq: ALL,
|
||||
// Issue#4 发布日志:平台更新公告,面向全体用户(同 faq 口径,用户拍板)。
|
||||
'system-release': ALL,
|
||||
}
|
||||
|
||||
/** 实测:某角色经守卫过滤后的可见菜单集合。 */
|
||||
|
||||
Reference in New Issue
Block a user