From eda275944f63ab2d1cb41d6dbfcbcea325bde445 Mon Sep 17 00:00:00 2001 From: Tory Date: Mon, 16 Nov 2026 16:29:50 +0800 Subject: [PATCH] =?UTF-8?q?Issue#4:=20=E7=89=88=E6=9C=AC=E5=8F=B7+?= =?UTF-8?q?=E5=8F=91=E5=B8=83=E6=97=A5=E5=BF=97(=E4=BE=A7=E6=A0=8F?= =?UTF-8?q?=E7=BA=A2=E7=82=B9/=E7=B3=BB=E7=BB=9F=E7=AE=A1=E7=90=86?= =?UTF-8?q?=E4=BA=8C=E7=BA=A7=E8=8F=9C=E5=8D=95/=E8=BF=90=E8=90=A5?= =?UTF-8?q?=E5=A4=A7=E7=99=BD=E8=AF=9DMarkdown)=E2=80=94=E2=80=94=E2=91=A0?= =?UTF-8?q?=E5=8D=95=E4=B8=80=E4=BA=8B=E5=AE=9E=E6=BA=90=3Ddata/releases.t?= =?UTF-8?q?s(APP=5FVERSION=3D=E9=A6=96=E6=9D=A1;package.json=200.1.0?= =?UTF-8?q?=E2=86=921.5.0=20=E5=90=8C=E6=AD=A5,releases.spec=20=E4=B8=A4?= =?UTF-8?q?=E4=BE=A7=E4=B8=80=E8=87=B4=E6=96=AD=E8=A8=80=E9=98=B2=E6=BC=82?= =?UTF-8?q?=E7=A7=BB;=E7=89=88=E6=9C=AC=E7=BA=BF=20v1.0.0~v1.5.0=20?= =?UTF-8?q?=E5=85=AD=E7=89=88=E5=85=A8=E8=BF=90=E8=90=A5=E5=A4=A7=E7=99=BD?= =?UTF-8?q?=E8=AF=9D);=E2=91=A1=E4=BE=A7=E6=A0=8F=E5=BA=95=E8=84=9A?= =?UTF-8?q?=E7=89=88=E6=9C=ACchip(MainLayout=20sidebar-foot=20=E6=8A=98?= =?UTF-8?q?=E5=8F=A0=E6=8C=89=E9=92=AE=E6=97=81,=E7=82=B9=E5=87=BB?= =?UTF-8?q?=E8=BF=9B=E5=8F=91=E5=B8=83=E6=97=A5=E5=BF=97;=E7=BA=A2?= =?UTF-8?q?=E7=82=B9=3D=E6=9C=AC=E5=9C=B0=E6=9C=AA=E8=AF=BB=20localStorage?= =?UTF-8?q?=20gosms=5Fseen=5Fver=E2=89=A0=E5=BD=93=E5=89=8D=E7=89=88?= =?UTF-8?q?=E6=9C=AC=E5=8D=B3=E4=BA=AE,CSS=20gosms-ver-blink=20=E8=84=89?= =?UTF-8?q?=E5=86=B2=E9=97=AA=E7=83=81,=E9=A6=96=E8=AE=BF=E4=BA=AE/?= =?UTF-8?q?=E7=82=B9=E5=87=BB=E6=88=96=E8=BF=9B=E9=A1=B5=20markSeen=20?= =?UTF-8?q?=E5=8D=B3=E7=81=AD/=E5=8F=91=E6=96=B0=E7=89=88=E5=85=A8?= =?UTF-8?q?=E5=91=98=E5=86=8D=E4=BA=AE;=E6=8A=98=E5=8F=A0=E6=80=8164px=20?= =?UTF-8?q?=E7=9F=AD=E7=89=88=E6=9C=AC=201.5+=E7=BA=A2=E7=82=B9=20badge=20?= =?UTF-8?q?=E7=BB=9D=E5=AF=B9=E5=AE=9A=E4=BD=8D=E2=80=94=E2=80=94=E5=AE=9E?= =?UTF-8?q?=E6=B5=8B=20monospace=20=E6=B8=B2=E6=9F=93=E5=81=8F=E5=AE=BD=20?= =?UTF-8?q?v1.5=20=E6=BA=A2=E5=87=BA=20foot=2055px>47px=20=E4=BF=AE?= =?UTF-8?q?=E6=AD=A3);=E2=91=A2=E5=8F=91=E5=B8=83=E6=97=A5=E5=BF=97?= =?UTF-8?q?=E9=A1=B5=20views/system/ReleaseLog.vue(defineOptions=20name=3D?= =?UTF-8?q?system-release=20=E5=AE=88=E9=97=A8)+=E8=B7=AF=E7=94=B1=20/syst?= =?UTF-8?q?em/release=20=E5=85=A8=E8=A7=92=E8=89=B2(=E5=90=8C=20faq=20?= =?UTF-8?q?=E5=8F=A3=E5=BE=84=E7=94=A8=E6=88=B7=E6=8B=8D=E6=9D=BF,icon=3DM?= =?UTF-8?q?emo);=E2=91=A3=E8=BF=B7=E4=BD=A0Markdown=E6=B8=B2=E6=9F=93?= =?UTF-8?q?=E5=99=A8=20utils/markdown.ts=20=E9=9B=B6=E6=96=B0=E4=BE=9D?= =?UTF-8?q?=E8=B5=96(=E6=A0=87=E9=A2=98/=E6=97=A0=E5=BA=8F=E6=9C=89?= =?UTF-8?q?=E5=BA=8F=E5=88=97=E8=A1=A8=201.=E4=B8=8E1=E3=80=81=E9=A1=BF?= =?UTF-8?q?=E5=8F=B7=E4=B8=AD=E6=96=87=E4=B9=A0=E6=83=AF/=E7=B2=97?= =?UTF-8?q?=E4=BD=93/=E8=A1=8C=E5=86=85=E4=BB=A3=E7=A0=81=E5=93=A8?= =?UTF-8?q?=E5=85=B5=E4=BF=9D=E6=8A=A4=20code=E5=86=85**=E4=B8=8D=E8=AF=AF?= =?UTF-8?q?=E5=88=A4/=E5=9B=B4=E6=A0=8F=E4=BB=A3=E7=A0=81=E5=9D=97/?= =?UTF-8?q?=E9=93=BE=E6=8E=A5=E4=BB=85http(s)=20javascript=E4=BC=AA?= =?UTF-8?q?=E5=8D=8F=E8=AE=AE=E4=B8=8D=E6=B8=B2=E6=9F=93;=E5=85=88?= =?UTF-8?q?=E5=85=A8=E9=87=8FHTML=E8=BD=AC=E4=B9=89=E5=86=8D=E8=A7=A3?= =?UTF-8?q?=E6=9E=90,v-html=20=E9=9B=B6=E6=B3=A8=E5=85=A5);=E2=91=A4?= =?UTF-8?q?=E5=AE=88=E9=97=A8=3Dreleases.spec=20+14(=E6=95=B0=E6=8D=AE?= =?UTF-8?q?=E4=B8=80=E8=87=B4=E6=80=A74:=E5=8D=95=E4=B8=80=E4=BA=8B?= =?UTF-8?q?=E5=AE=9E=E6=BA=90/=E9=99=8D=E5=BA=8F/semver/=E6=97=A5=E6=9C=9F?= =?UTF-8?q?=E6=A0=87=E7=AD=BE;=E6=B8=B2=E6=9F=93=E5=99=A87:=E6=A0=BC?= =?UTF-8?q?=E5=BC=8F+=E8=BD=AC=E4=B9=89+=E4=BC=AA=E5=8D=8F=E8=AE=AE+?= =?UTF-8?q?=E5=93=A8=E5=85=B5;store3:=E9=A6=96=E8=AE=BF=E4=BA=AE/markSeen?= =?UTF-8?q?=E7=81=AD+=E5=88=B7=E6=96=B0=E6=8C=81=E4=B9=85/=E6=96=B0?= =?UTF-8?q?=E7=89=88=E5=86=8D=E4=BA=AE)+guard=20=E8=8F=9C=E5=8D=9533?= =?UTF-8?q?=E2=86=9234=E6=98=BE=E5=BC=8F=E6=9B=B4+role-menu-matrix=20?= =?UTF-8?q?=E7=99=BB=E8=AE=B0=20system-release:ALL+verify-layout=2023?= =?UTF-8?q?=E2=86=9231(chip=E5=8F=AF=E8=A7=81/=E6=96=87=E6=9C=ACvN.N/?= =?UTF-8?q?=E9=A6=96=E8=AE=BF=E7=BA=A2=E7=82=B9/=E7=82=B9=E5=87=BB?= =?UTF-8?q?=E8=B7=B3=E8=BD=AC/=E5=B7=B2=E8=AF=BB=E5=8D=B3=E7=81=AD/?= =?UTF-8?q?=E5=8D=A1=E7=89=87=E2=89=A53=E5=AE=9E=E4=B8=BA6/md=E5=88=97?= =?UTF-8?q?=E8=A1=A8=E6=B8=B2=E6=9F=93/=E5=9B=9Ehome);=E2=91=A5=E9=97=A8?= =?UTF-8?q?=E7=A6=81=3Deslint0/vue-tsc0/vitest=20179(165+14)/build=20?= =?UTF-8?q?=E5=85=A8=E7=BB=BF;Chrome=20157=20=E5=AE=9E=E6=9C=BA=E8=B5=B0?= =?UTF-8?q?=E6=9F=A54=E6=AD=A5(=E7=BA=A2=E7=82=B91=E2=86=92=E7=82=B9?= =?UTF-8?q?=E5=87=BB=E8=BF=9B=E9=A1=B5=E2=86=92=E5=B7=B2=E8=AF=BB0+localSt?= =?UTF-8?q?orage=3D1.5.0=E2=86=92=E6=8A=98=E5=8F=A01.5)+=E6=A0=B7=E5=BC=8F?= =?UTF-8?q?=E7=BA=A7=E5=A4=8D=E6=A0=B8(=E5=8A=A8=E7=94=BB=E5=90=8Dgosms-ve?= =?UTF-8?q?r-blink/chip=E5=87=A0=E4=BD=95/=E6=9A=97=E4=BA=AE=E5=8F=8C?= =?UTF-8?q?=E4=B8=BB=E9=A2=98=E5=8F=AF=E8=A7=81);=E5=8F=A3=E5=BE=84?= =?UTF-8?q?=E8=AF=9A=E5=AE=9E=E6=A0=87=E6=B3=A8:=E7=BA=A2=E7=82=B9=3D?= =?UTF-8?q?=E6=9C=AC=E5=9C=B0=E6=9C=AA=E8=AF=BB=E8=AF=AD=E4=B9=89(?= =?UTF-8?q?=E6=8D=A2=E6=B5=8F=E8=A7=88=E5=99=A8/=E6=B8=85=E7=BC=93?= =?UTF-8?q?=E5=AD=98=E9=87=8D=E6=8F=90=E7=A4=BA=E4=B8=80=E6=AC=A1,?= =?UTF-8?q?=E6=97=A0=E6=9C=8D=E5=8A=A1=E7=AB=AF=E5=90=8C=E6=AD=A5)/?= =?UTF-8?q?=E7=A7=BB=E5=8A=A8=E7=AB=AF=E2=89=A4900=E9=9A=8Fsidebar-foot?= =?UTF-8?q?=E6=97=A2=E6=9C=89=E9=9A=90=E8=97=8F/=E5=8F=91=E5=B8=83?= =?UTF-8?q?=E5=86=85=E5=AE=B9=3D=E4=BB=93=E5=BA=93=E9=9D=99=E6=80=81?= =?UTF-8?q?=E6=95=B0=E6=8D=AE;=E5=8F=91=E7=89=88SOP=3Dreleases.ts=E5=A4=B4?= =?UTF-8?q?=E9=83=A8=E6=8F=92=E4=B8=80=E6=9D=A1+package.json=E5=90=8C?= =?UTF-8?q?=E6=AD=A5,=E9=83=A8=E7=BD=B2=E5=90=8E=E5=85=A8=E5=91=98?= =?UTF-8?q?=E7=BA=A2=E7=82=B9=E4=BA=AE=E8=B5=B7;=E9=AA=8C=E6=94=B6?= =?UTF-8?q?=E5=8D=95issue4-release-notes.md+CHANGELOG+memory-bank=E5=9B=9E?= =?UTF-8?q?=E5=A1=AB;Gitea#4=E5=AE=8C=E6=88=90=E8=AF=84=E8=AE=BA=E5=BE=85?= =?UTF-8?q?=E7=94=A8=E6=88=B7(token)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CHANGELOG.md | 11 +++ docs/acceptance/issue4-release-notes.md | 49 +++++++++++ memory-bank/activeContext.md | 1 + memory-bank/progress.md | 1 + web/package.json | 2 +- web/scripts/verify-layout.mjs | 15 ++++ web/src/data/releases.ts | 78 +++++++++++++++++ web/src/layouts/MainLayout.vue | 16 ++++ web/src/router/routes.ts | 3 + web/src/stores/release.ts | 29 +++++++ web/src/styles/shell.scss | 12 ++- web/src/utils/markdown.ts | 89 ++++++++++++++++++++ web/src/views/system/ReleaseLog.vue | 75 +++++++++++++++++ web/tests/guard.spec.ts | 8 +- web/tests/releases.spec.ts | 107 ++++++++++++++++++++++++ web/tests/role-menu-matrix.spec.ts | 2 + 16 files changed, 491 insertions(+), 7 deletions(-) create mode 100644 docs/acceptance/issue4-release-notes.md create mode 100644 web/src/data/releases.ts create mode 100644 web/src/stores/release.ts create mode 100644 web/src/utils/markdown.ts create mode 100644 web/src/views/system/ReleaseLog.vue create mode 100644 web/tests/releases.spec.ts diff --git a/CHANGELOG.md b/CHANGELOG.md index c29cd08a..7682a3db 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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 问题终结**(协议修复全链生效)。 diff --git a/docs/acceptance/issue4-release-notes.md b/docs/acceptance/issue4-release-notes.md new file mode 100644 index 00000000..cca45bc1 --- /dev/null +++ b/docs/acceptance/issue4-release-notes.md @@ -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: 伪协议不渲染为 ``),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` 即可(纯数据)。 diff --git a/memory-bank/activeContext.md b/memory-bank/activeContext.md index 25bfff86..46e69fde 100644 --- a/memory-bank/activeContext.md +++ b/memory-bank/activeContext.md @@ -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 比对 ✓)。 diff --git a/memory-bank/progress.md b/memory-bank/progress.md index 93f48172..9ac82c54 100644 --- a/memory-bank/progress.md +++ b/memory-bank/progress.md @@ -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》) | diff --git a/web/package.json b/web/package.json index 2996cd51..e6a6ebc9 100644 --- a/web/package.json +++ b/web/package.json @@ -1,6 +1,6 @@ { "name": "hwsms-web", - "version": "0.1.0", + "version": "1.5.0", "private": true, "type": "module", "packageManager": "pnpm@12.18.0", diff --git a/web/scripts/verify-layout.mjs b/web/scripts/verify-layout.mjs index 524bb6f6..edae0f67 100644 --- a/web/scripts/verify-layout.mjs +++ b/web/scripts/verify-layout.mjs @@ -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) diff --git a/web/src/data/releases.ts b/web/src/data/releases.ts new file mode 100644 index 00000000..7cad614d --- /dev/null +++ b/web/src/data/releases.ts @@ -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 diff --git a/web/src/layouts/MainLayout.vue b/web/src/layouts/MainLayout.vue index ffe969e9..423ca157 100644 --- a/web/src/layouts/MainLayout.vue +++ b/web/src/layouts/MainLayout.vue @@ -45,6 +45,15 @@