memory-bank: B1 收官回填(activeContext 重写为 B2 开工态+B1 坑留痕五条/progress 补 B1 行)

This commit is contained in:
2026-11-18 10:58:18 +08:00
parent 9afab52239
commit 936fed5cac
2 changed files with 26 additions and 22 deletions
+24 -22
View File
@@ -1,33 +1,35 @@
# 当前工作上下文(最近更新:2026-11-17 B 方案拍板)
# 当前工作上下文(最近更新:2026-11-17 B1 收官,新会话从 B2 开工)
## ⭐ Issue#6 · B 方案(0 重构 web-next)已拍板,新会话从 B1 开工
## ⭐ Issue#6 · B 方案执行中:B1 契约基座已收官(commit 96ab7b87),下一步 B2 三契约页 1:1
- **决议(用户原话)**:执行 B 方案;**必须不要有旧前端的影子**;**新增前端工程目录**,不要混乱;A 方案(EP 换肤模拟)彻底废弃——"不断失误不断修复"不可接受。
- **B1 已交付(web-next/ 新工程,零 EP/零旧影子)**:脚手架 7 件(:5174+proxy→8080/tsconfig ES2021)/styles/tailwind.css(=sub2api style.css 775 行直拷+契约补充段 stat-card 族+body.folded 折叠态)/IconSprite(契约 24 symbol 直挂)/逻辑层复制 27 文件(api 15/stores 3/router 2/data releases/utils 3,EP 引用全域归零)/壳层 5 件(BasicLayout mainWrap+keep-alive include=cachedNames/AppSidebar 256 折叠 72+RBAC 分组菜单与守卫 accessibleRoutes 同源/AppHeader glass blur 顶栏+主题+用户菜单/TagsBar Issue#2 语义 fullPath 身份+中键+关闭其他+全部+home 固定/VersionBadge Issue#4 红点 markSeen)/LoginView(sub2api AuthLayout 范式)/36 视图路由契约占位(name/title/group/roles/subtitle 对齐旧 routes,icon=契约 #i-*,component=ComingSoon)。
- **B1 验收全绿**:vue-tsc 0/build ✓(主包 gzip 68KB)/chrome 冒烟 10/10(登录 s2demo→壳→RBAC 34 链接 7 组→标签条→版本徽章 markSeen 红点灭→主题/折叠)/契约 style 断言 8/8(teal 渐变/256/72/glass blur24/亮 gray-50/暗 slate-950)。冒烟脚本=/tmp/smoke-webnext.mjs、/tmp/style-webnext.mjs(临时不入库,B2 对拍可复用改写)。
## B2 任务清单(新会话直接执行;对拍基线=http://192.168.5.18:17890/ v3-2-tailwind.html)
1. 三契约页 1:1 实装(routes.ts 换 component):#p-dash 运营总览(home;stat-card×4+chart.js 趋势图+动态流;消费 P2 已合 main 的 3 端点 /ops/system/overview+/stats/biz+/stats/realtime)/#p-acct 账号管理(account-list;筛选区 border-b+原生 table+分页条单卡一体)/#p-chan 通道编辑(channel-edit;表单范式)。
2. 与 17890 computed style 逐页对拍(断言脚本口径同 /tmp/style-webnext.mjs)。
3. 三页必须 defineOptions({name:路由名})(home/account-list/channel-edit),否则 keep-alive 不命中。
4. 契约源段:#p-dash≈895-1005 行/#p-acct≈1006-1060 行/#p-chan≈1060-1066 行(v3-2-tailwind.html 全文件已通读)。
5. 后续:B3 33 视图范式族分批→B4 收口(切部署/旧 web 归档/测试 verify 重建/统一人工验收单/CHANGELOG/Gitea#6)。
## B 方案决议留痕(2026-11-17 拍板)
- **决议(用户原话)**:执行 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)。
- **零影子复用边界**:✅ 仅**复制**纯逻辑层进新目录(不跨目录 import 旧 web/);❌ 零复用:全部样式/36 视图/全部组件/EP 依赖(不装)。
- **技术栈(契约同款实证)**:Vue3.5+TS5.6+Vite5+Tailwind 3.4+PostCSS8+autoprefixer+SVG sprite 图标(<use href="#i-*">,契约 defs 直挂)+chart.js/vue-chartjs(Dashboard)。
## B1 任务清单(新会话直接执行)
## 环境要点(B2 沿用)
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
- web-next dev 口径:`cd web-next && npx vite --host 0.0.0.0 --port 5174 --strictPort`(nohup 后台;:5173 是旧 web 的,两者并行);npm 依赖已装齐(154 包,registry 直连可用)。
- 后端网关 :8080 在跑;/channels/monitor/ws 现成;后端零改动。
- chrome 铁律:channel:'chrome'+独立 launch+单 page;playwright 用 web/node_modules 的(web-next 未装);dev admin 冒烟账号 s2demo/S2demo@2026。
- 坑留痕(B1 实录):①pgrep -f 'vue-tsc' 匹配自身 bash 壳误判 RUNNING(排查用 pgrep -af 看 cmdline);②契约 .btn-primary 是 bg-gradient(backgroundColor=transparent),断言主色须查 backgroundImage;③暗色态断言按 dark: 变体口径(sidebar-link-active 暗=primary-900/20,hover=/30);④30s 命令超时:npm install/vue-tsc/冒烟一律 nohup 后台+轮询 log;⑤旧 web「帐号管理」用「帐」字,:has-text 选择器注意;⑥5174 曾被旧 web 遗留 vite dev 占用已杀,:5173 旧 dev(pid 2502998)保留不动。
- **Gitea API 已通**(账号 Tory):token 存 `/tmp/gitea_token`(600,勿入 git;失效则请用户在 192.168.5.27:24400 Settings→Applications 重生成);**#6 B 方案决议评论已发布(201)+#4 完成评论历史欠账已补发(201)**;写评论口径=POST /api/v1/repos/Tory/go-sms-V2/issues/{n}/comments
## P3 留痕(已被 B 方案取代,commits 不回滚)
- **P2 后端 3 端点已入库**(/ops/system/overview + /stats/biz + /stats/realtime,openapi 1.5.0);**人工验收挂起**,与 B2/B3 合并统一验收单(验收标准已定稿待执行:重启网关+admin JWT+逐端点断言)。
+2
View File
@@ -26,6 +26,8 @@
| 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(教训:机器断言全绿≠用户感知范围,契约类文档必须全文件通读) |
| Issue#6·B1 web-next 契约基座 | 新工程 web-next 落地(commit 96ab7b87):脚手架 7 件(:5174+proxy→8080,无 EP)+tailwind.css(sub2api 775 行直拷+契约 stat-card/folded 补充)+IconSprite(契约 24 symbol)+逻辑层复制 27 文件(EP 归零)+壳层 5 件(BasicLayout/AppSidebar/AppHeader/TagsBar/VersionBadge,Issue#2/#4 语义保留)+LoginView(sub2api 范式)+36 视图路由契约占位;**验收=vue-tsc 0/build ✓ gzip 68KB/冒烟 10/10/style 断言 8/8** | ✅ 2026-11-17(B2 三契约页 1:1 对拍为下一步) |
| 观察项 | 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》) |