Issue#6·决议留痕: A(EP 模拟)废弃,B(0 重构 web-next)拍板——activeContext 固化 B 方案/零影子复用边界/B1 任务清单/环境要点;progress 补 P3 否决记录(根因:契约 3 页蓝本漏读 2 页+sub2api 无 EP 实证);新会话自 activeContext 直接开工 B1

This commit is contained in:
2026-11-18 10:58:18 +08:00
parent 449531e3e4
commit daf0659d2c
2 changed files with 35 additions and 8 deletions
+34 -8
View File
@@ -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 内层 </template> 截断;②契约断言脚本须归一起始主题(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 图标(<use href="#i-*">,契约 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 内层 </template> 截断;②契约断言脚本须归一起始主题;③#020617 hex→dec=rgb(2,6,23);④契约类 HTML 文档必须**全文件通读**(3 页蓝本漏读 2 页=本次翻车主因)。
- 挂账(随 B4 清偿):channel flaky 测试/access 域 6 lint unused/工作区遗留 8 文件(先前会话半成品,未提交未回滚)。
## Issue#6 前端重构 · 视觉契约已锁定(2026-11-17,P1 收官)
+1
View File
@@ -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》) |