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:
2026-11-18 10:58:18 +08:00
parent 52692f4628
commit eda275944f
16 changed files with 491 additions and 7 deletions
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "hwsms-web",
"version": "0.1.0",
"version": "1.5.0",
"private": true,
"type": "module",
"packageManager": "pnpm@12.18.0",
+15
View File
@@ -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)
+78
View File
@@ -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
+16
View File
@@ -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'))
+3
View File
@@ -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'] } },
// 隐藏页(不在菜单)
+29
View File
@@ -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)
},
},
})
+10 -2
View File
@@ -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; }
+89
View File
@@ -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, '&amp;')
.replace(/</g, '&lt;')
.replace(/>/g, '&gt;')
.replace(/"/g, '&quot;')
.replace(/'/g, '&#39;')
}
/** 行内格式:行内代码(哨兵保护,内部不做粗体/链接替换)→ 粗体 → 链接。 */
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')
}
+75
View File
@@ -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>
+4 -4
View File
@@ -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)
}
})
+107
View File
@@ -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('&lt;script&gt;')
expect(h).toContain('&amp;')
})
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)
})
})
+2
View File
@@ -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,
}
/** 实测:某角色经守卫过滤后的可见菜单集合。 */