From daf0659d2c2c040e8dda4a17b9ac88349dddb9fb Mon Sep 17 00:00:00 2001 From: Tory Date: Tue, 17 Nov 2026 11:27:29 +0800 Subject: [PATCH] =?UTF-8?q?Issue#6=C2=B7=E5=86=B3=E8=AE=AE=E7=95=99?= =?UTF-8?q?=E7=97=95:=20A(EP=20=E6=A8=A1=E6=8B=9F)=E5=BA=9F=E5=BC=83,B(0?= =?UTF-8?q?=20=E9=87=8D=E6=9E=84=20web-next)=E6=8B=8D=E6=9D=BF=E2=80=94?= =?UTF-8?q?=E2=80=94activeContext=20=E5=9B=BA=E5=8C=96=20B=20=E6=96=B9?= =?UTF-8?q?=E6=A1=88/=E9=9B=B6=E5=BD=B1=E5=AD=90=E5=A4=8D=E7=94=A8?= =?UTF-8?q?=E8=BE=B9=E7=95=8C/B1=20=E4=BB=BB=E5=8A=A1=E6=B8=85=E5=8D=95/?= =?UTF-8?q?=E7=8E=AF=E5=A2=83=E8=A6=81=E7=82=B9;progress=20=E8=A1=A5=20P3?= =?UTF-8?q?=20=E5=90=A6=E5=86=B3=E8=AE=B0=E5=BD=95(=E6=A0=B9=E5=9B=A0:?= =?UTF-8?q?=E5=A5=91=E7=BA=A6=203=20=E9=A1=B5=E8=93=9D=E6=9C=AC=E6=BC=8F?= =?UTF-8?q?=E8=AF=BB=202=20=E9=A1=B5+sub2api=20=E6=97=A0=20EP=20=E5=AE=9E?= =?UTF-8?q?=E8=AF=81);=E6=96=B0=E4=BC=9A=E8=AF=9D=E8=87=AA=20activeContext?= =?UTF-8?q?=20=E7=9B=B4=E6=8E=A5=E5=BC=80=E5=B7=A5=20B1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- memory-bank/activeContext.md | 42 +++++++++++++++++++++++++++++------- memory-bank/progress.md | 1 + 2 files changed, 35 insertions(+), 8 deletions(-) diff --git a/memory-bank/activeContext.md b/memory-bank/activeContext.md index 71dfaf58..8c20486a 100644 --- a/memory-bank/activeContext.md +++ b/memory-bank/activeContext.md @@ -1,13 +1,39 @@ -# 当前工作上下文(最近更新:2026-11-17 P3 收官) +# 当前工作上下文(最近更新:2026-11-17 B 方案拍板) -## Issue#6 · P3 壳层契约化已完成(2026-11-17,6 commits:03aacb16→2bf43d33) +## ⭐ Issue#6 · B 方案(0 重构 web-next)已拍板,新会话从 B1 开工 -- **P2 后端 3 端点已入库**(/ops/system/overview + /stats/biz + /stats/realtime,openapi 1.5.0);**人工验收挂起**,与 P3/P4 合并统一验收单(验收标准已定稿待执行:重启网关+admin JWT+逐端点断言)。 -- **P3 壳层= sub2api 契约全面落地**:C1 tokens(teal 官方 16 阶+slate 暗/gray 亮+字阶 10~24+lh1.65+旧名兼容映射,60 处视图消费零改动自动适配)/C2 shell(侧栏 256·折叠 72·品牌头部区/顶栏 64 glass/page-head 24/card 实底 r16 shadow-sm/ch-table td14·py16px20/aurora 退役)/C3 MainLayout 重排(brand→侧栏+版本徽章迁品牌下方=用户指令位+icon20+top-title;shortVersion 退役)+TagsBar 契约化(功能零动)/C4 ep-theme(primary teal·success emerald 分离·hover 中性化·表格密度桥·渐变按钮桥退役)/C5 全站旧值清零(LoginView aurora 退役+恒暗 slate 化)。 -- **验收成果**:verify-layout **31/31 全绿**(仅续 2 项值断言 224/64→256/72,结构+功能断言零重写=类名锚点策略兑现);**新增 scripts/verify-p3-contract.mjs 30 项双主题 DOM 断言 30/30 PASS**(契约核心值机器可证);四门禁 eslint0/vue-tsc0/vitest182/build 全绿;Issue#2/#4 资产(keep-alive/标签/版本红点)无伤。 -- **坑留痕**:①Vue template 整段替换防 dropdown 内层 截断;②契约断言脚本须归一起始主题(s2demo localStorage 暗色残留);③#020617 hex→dec=rgb(2,6,23)。 -- **Next P4**:Dashboard 13 模块组件化(KpiCard/AreaChart/Donut/Sparkline/HealthStrip/ActivityFeed/AppIcon/Hero 判定句等)+WS 客户端(/channels/monitor/ws 现成)+消费 P2 三端点;契约蓝本=docs/design/issue6/v3-2-tailwind.html 数据模块;余额 pill 归 Dashboard 域内。 -- **Next P5**:七件套门禁(verify-p3-contract 并入)+P2/P4 统一人工验收单+CHANGELOG+Gitea#6 评论;挂账:channel flaky 测试/access 域 6 lint unused/工作区遗留 8 文件(先前会话半成品,未提交未回滚)。 +- **决议(用户原话)**:执行 B 方案;**必须不要有旧前端的影子**;**新增前端工程目录**,不要混乱;A 方案(EP 换肤模拟)彻底废弃——"不断失误不断修复"不可接受。 +- **根因留痕(P3 被否决)**:① 契约 v3-2-tailwind.html(1097 行)内含 **3 页蓝本**——#p-dash 运营总览/#p-acct 账号管理(单卡一体:筛选区 border-b+原生 table+分页条)/#p-chan 通道编辑(表单范式),P1 验收只认知 Dashboard 页,"统一范围"被窄化为壳层;② **sub2api 前端无 Element Plus**(package.json 实证:Vue3+Tailwind+自研 class 件+chart.js),用 EP 模拟非 EP 生态转译损耗是结构性的。P3 六 commits(31815cf9→2bf43d33)留档不回滚。 +- **零影子复用边界**:✅ 仅**复制**纯逻辑层进新目录(不跨目录 import 旧 web/):api/stores/router 守卫/types/data/releases/utils-markdown——复制时**清零 EP 引用**(ElMessage→自研 toast;EP icons→契约 SVG sprite);❌ 零复用:全部样式/36 视图/全部组件/EP 依赖(不装)。 +- **技术栈(契约同款实证)**:Vue3.5+TS5.6+Vite5+**Tailwind 3.4+PostCSS8+autoprefixer**(契约 config 直用)+契约 style.css 直拼+SVG sprite 图标(,契约 defs 直挂)+chart.js/vue-chartjs(Dashboard)。 + +## B1 任务清单(新会话直接执行) + +1. 脚手架 `web-next/`:package.json(**无 EP**)/vite.config.ts(**:5174**,proxy /api→8080,alias @)/tsconfig/postcss.config.js/**tailwind.config.js 契约直用**(源:/tmp/sub2api-main/frontend/ 同名文件,改 content 路径)/index.html +2. `src/styles/tailwind.css`:三指令+**sub2api style.css(775 行)直拷**(源头真值,优于契约 HTML 内嵌段)+.stat-card 等效 CSS 补(契约豁免①) +3. `IconSprite.vue`:契约 HTML 的 svg defs 段直挂 App.vue(全站图标唯一来源,零图标库) +4. 逻辑层复制+EP 清零(grep element-plus 归零=验收项) +5. BasicLayout+AppSidebar/AppHeader/TagsBar(keep-alive 资产契约重实现)+VersionBadge(Issue#4 红点/markSeen 语义保留) +6. LoginView(sub2api 登录页范式:/tmp/sub2api-main/frontend/src/views/ 找 Auth/Login) +7. 36 视图路由占位(name 对齐旧 defineOptions,ComingSoon;B2/B3 逐页实装) +8. dev :5174 起服+chrome-session 冒烟(登录→壳→RBAC 菜单→标签条→版本徽章);B1 commit +9. 后续:B2 三契约页 1:1(与 17890 computed style 对拍)→B3 33 视图范式族分批→B4 收口(切部署/旧 web 归档/测试 verify 重建/统一人工验收单/CHANGELOG/Gitea#6) + +## 环境要点(B1 依赖) + +- npm 新装:tailwindcss@^3.4/postcss/autoprefixer/chart.js/vue-chartjs(旧 web/node_modules 无;需网络或内网 mirror,失败先测 npm registry 连通) +- 契约源:docs/design/issue6/v3-2-tailwind.html(蓝本)+/tmp/sub2api-main/frontend/(style.css/组件真值;若 /tmp 清理过,ghproxy 重拉 tarball) +- P2 后端 3 端点已合 main 可直接消费;/channels/monitor/ws 现成;后端零改动 +- chrome 铁律:channel:'chrome'+独立 launch+单 page(chrome-session.mjs);dev admin 冒烟账号 s2demo/S2demo@2026 +- 工单 #6 已回复(用户粘贴文本,B 方案决议留痕);Gitea 无 token,评论靠用户侧操作 + + +## P3 留痕(已被 B 方案取代,commits 不回滚) + +- **P2 后端 3 端点已入库**(/ops/system/overview + /stats/biz + /stats/realtime,openapi 1.5.0);**人工验收挂起**,与 B2/B3 合并统一验收单(验收标准已定稿待执行:重启网关+admin JWT+逐端点断言)。 +- **P3 壳层= sub2api 契约落地于旧 EP 工程**(用户验收否决,详见顶部根因):C1 tokens(teal 16 阶+slate/gray+旧名兼容)/C2 shell(侧栏 256/折叠 72/顶栏 64 glass)/C3 MainLayout 重排+TagsBar/C4 ep-theme/C5 旧值清零;verify-layout 31/31+verify-p3-contract.mjs 30/30+vitest 182 全绿——**机器断言全绿仍被否,教训:断言范围≠用户感知范围,功能页范式没进断言集**。 +- **坑留痕(通用)**:①Vue template 整段替换防 dropdown 内层 截断;②契约断言脚本须归一起始主题;③#020617 hex→dec=rgb(2,6,23);④契约类 HTML 文档必须**全文件通读**(3 页蓝本漏读 2 页=本次翻车主因)。 +- 挂账(随 B4 清偿):channel flaky 测试/access 域 6 lint unused/工作区遗留 8 文件(先前会话半成品,未提交未回滚)。 ## Issue#6 前端重构 · 视觉契约已锁定(2026-11-17,P1 收官) diff --git a/memory-bank/progress.md b/memory-bank/progress.md index 264b5c15..af29021c 100644 --- a/memory-bank/progress.md +++ b/memory-bank/progress.md @@ -25,6 +25,7 @@ | 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) | | Issue#6·P2 Dashboard 后端 3 端点 | /ops/system/overview(gateway 视角五子系统,up/degraded/down/unknown 三态诚实+admin/ops 门,LagReader 复用闭包注入)+/stats/biz(business[sms/video]+send_type[batch/personal/timer/file] 两维;口径修正留痕:biz_type 属审核域 audit_record 非 task 维)+/stats/realtime(60s 窗覆盖索引 COUNT+Top5 账号+名字);openapi +3;新测试 3 组绿,api 域 lint 0,全量 -race 除 channel 存量 flaky(单跑×2 绿,挂账) | ✅ 2026-11-17(P1 视觉契约 v3.2.1 同日锁定) | | Issue#6·P3 壳层契约化 | tokens(teal16 阶+slate/gray+字阶 10~24+lh1.65+旧名兼容)+shell(侧栏 256/折叠 72 品牌区/顶栏 64 glass/card r16 实底/td14·py16px20/aurora 退役)+MainLayout 重排(brand→侧栏+版本徽章迁位+icon20)+TagsBar 契约化+ep-theme(teal/emerald 分离/表格密度桥/渐变桥退役)+全站旧值清零;verify-layout 31/31(类名锚点策略兑现,仅续 2 值断言)+verify-p3-contract.mjs 30/30 双主题 DOM 断言+vitest 182 全绿(Issue#2/#4 资产无伤);6 commits | ✅ 2026-11-17 | +| Issue#6·P3 壳层改造(EP 路线) | **用户验收否决→B 方案(0 重构 web-next)拍板**:契约实含 3 页蓝本(dash/acct/chan)P1 只认知 1 页;sub2api 无 EP(实证),EP 模拟非 EP 转译损耗结构性不可救;P3 六 commits 留档不回滚;决议=新工程 web-next(Tailwind3.4+契约 CSS 直拼+零 EP+零旧影子,仅复制逻辑层清 EP 引用);B1 契约基座→B2 三契约页对拍→B3 33 视图→B4 收口 | ❌ 2026-11-17(教训:机器断言全绿≠用户感知范围,契约类文档必须全文件通读) | | 观察项 | 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》) |