重构:前端风格样式布局 #6

Open
opened 2026-11-16 21:20:06 +08:00 by Tory · 3 comments
Owner

现状,布局混乱,组件分布密集,风格不够清爽,久看容易疲劳。Dashboard,未做合理设计。
Frontend Design重构风格(色调生命绿+科技蓝)要求清爽简约,行距适中减少阅读疲劳,出1-3个方案选择。
high-info-density-dashboard-designer 介入设计运营总览,增加系统监控,发送数据分析,全局用户/通道实时速度,业务类型发送统计等等

现状,布局混乱,组件分布密集,风格不够清爽,久看容易疲劳。Dashboard,未做合理设计。 Frontend Design重构风格(色调生命绿+科技蓝)要求清爽简约,行距适中减少阅读疲劳,出1-3个方案选择。 high-info-density-dashboard-designer 介入设计运营总览,增加系统监控,发送数据分析,全局用户/通道实时速度,业务类型发送统计等等
Author
Owner

Issue#6 前端重构 · 路线决议:废弃 A(EP 换肤模拟),执行 B(0 重构新工程)

进展留痕

  • ✅ P1 视觉契约锁定: docs/design/issue6/v3-2-tailwind.html(v3.2.1,sub2api 源码级 1:1,机器验收 23/23)
  • ✅ P2 后端 3 端点已合入 main(03aacb16): /ops/system/overview(五子系统四态诚实探测)、/stats/biz(business+send_type 两维)、/stats/realtime(60s 覆盖索引速率+Top5);openapi 1.5.0。B 方案完全复用,零改动
  • ❌ P3 壳层改造(6 commits, 31815cf9→2bf43d33)验收否决:与契约功能页(#p-acct 账号管理 / #p-chan 通道编辑)差距大。根因复盘:① 契约实含 3 页蓝本,验收时只认知 Dashboard 页,"统一范围"被窄化为壳层;② sub2api 前端无 Element Plus(package.json 实证:Vue3+Tailwind+自研 class 件+chart.js),用 EP 变量模拟非 EP 生态,转译损耗是结构性的——继续修补只会循环返工

B 方案决议(拍板:不要旧前端影子,新增工程目录)

  • 新工程 web-next/(与旧 web/ 并列隔离,旧目录不动,收尾后归档)
  • 技术栈=契约同款: Vue3+TS+Vite5+Tailwind 3.4+PostCSS(契约 config 直用)+契约 style.css 直拼+SVG sprite 图标+chart.js;不装 Element Plus
  • 复用边界: 仅复制纯逻辑层(api/stores/router 守卫/types/releases/markdown,复制时清零 EP 引用);样式/视图/组件层全部按契约与 sub2api 源码重写
  • 路线: B1 契约基座(壳/登录/图标/路由占位/:5174)→ B2 三契约页 1:1(Dashboard 13 模块+账号管理+通道编辑,与 17890 预览 computed style 对拍)→ B3 其余 33 视图按范式族分批 → B4 收口(切部署/测试重建/统一人工验收)

下一里程碑: B1 契约基座冒烟。

**Issue#6 前端重构 · 路线决议:废弃 A(EP 换肤模拟),执行 B(0 重构新工程)** **进展留痕** - ✅ P1 视觉契约锁定: `docs/design/issue6/v3-2-tailwind.html`(v3.2.1,sub2api 源码级 1:1,机器验收 23/23) - ✅ P2 后端 3 端点已合入 main(`03aacb16`): `/ops/system/overview`(五子系统四态诚实探测)、`/stats/biz`(business+send_type 两维)、`/stats/realtime`(60s 覆盖索引速率+Top5);openapi 1.5.0。**B 方案完全复用,零改动** - ❌ P3 壳层改造(6 commits, `31815cf9`→`2bf43d33`)验收否决:与契约功能页(`#p-acct` 账号管理 / `#p-chan` 通道编辑)差距大。根因复盘:① 契约实含 3 页蓝本,验收时只认知 Dashboard 页,"统一范围"被窄化为壳层;② sub2api 前端**无 Element Plus**(package.json 实证:Vue3+Tailwind+自研 class 件+chart.js),用 EP 变量模拟非 EP 生态,转译损耗是结构性的——继续修补只会循环返工 **B 方案决议(拍板:不要旧前端影子,新增工程目录)** - 新工程 `web-next/`(与旧 `web/` 并列隔离,旧目录不动,收尾后归档) - 技术栈=契约同款: Vue3+TS+Vite5+**Tailwind 3.4+PostCSS**(契约 config 直用)+契约 style.css 直拼+SVG sprite 图标+chart.js;**不装 Element Plus** - 复用边界: 仅**复制**纯逻辑层(api/stores/router 守卫/types/releases/markdown,复制时清零 EP 引用);样式/视图/组件层全部按契约与 sub2api 源码重写 - 路线: B1 契约基座(壳/登录/图标/路由占位/:5174)→ B2 三契约页 1:1(Dashboard 13 模块+账号管理+通道编辑,与 17890 预览 computed style 对拍)→ B3 其余 33 视图按范式族分批 → B4 收口(切部署/测试重建/统一人工验收) 下一里程碑: B1 契约基座冒烟。
Author
Owner

B1 契约基座收官 ✅(commit 96ab7b87)

web-next/ 新工程落地(零 EP/零旧影子):

  • 脚手架:Vite5 :5174(proxy /api→8080)/TS5.6/Tailwind3.4(sub2api config 直用),依赖 154 包无 EP
  • 样式:sub2api style.css 775 行直拷 + 契约补充段(stat-card 族/折叠态)
  • 图标:契约 SVG defs 24 symbol 直挂(IconSprite,零图标库)
  • 逻辑层:api/stores/router/data/utils 27 文件复制,grep element-plus 全域归零
  • 壳层:BasicLayout(keep-alive)/AppSidebar(RBAC 34 链接 7 组)/AppHeader(glass)/TagsBar(Issue#2 语义)/VersionBadge(Issue#4 红点 markSeen)
  • 登录页:sub2api AuthLayout 范式(渐变+光斑+card-glass)
  • 36 视图路由契约占位(name/roles/subtitle 对齐旧 routes,B2/B3 逐页实装)

验收全绿:vue-tsc 0 错 / build ✓(主包 gzip 68KB)/ Chrome 冒烟 10/10 / 契约 style 断言 8/8(teal 渐变/侧栏 256 折叠 72/glass blur/双主题底色)

下一步 B2:三契约页(dash/acct/chan)1:1 实装 + 与 17890 预览 computed style 对拍。

## B1 契约基座收官 ✅(commit 96ab7b87) **web-next/ 新工程落地**(零 EP/零旧影子): - 脚手架:Vite5 :5174(proxy /api→8080)/TS5.6/Tailwind3.4(sub2api config 直用),依赖 154 包无 EP - 样式:sub2api style.css 775 行直拷 + 契约补充段(stat-card 族/折叠态) - 图标:契约 SVG defs 24 symbol 直挂(IconSprite,零图标库) - 逻辑层:api/stores/router/data/utils 27 文件复制,grep element-plus 全域归零 - 壳层:BasicLayout(keep-alive)/AppSidebar(RBAC 34 链接 7 组)/AppHeader(glass)/TagsBar(Issue#2 语义)/VersionBadge(Issue#4 红点 markSeen) - 登录页:sub2api AuthLayout 范式(渐变+光斑+card-glass) - 36 视图路由契约占位(name/roles/subtitle 对齐旧 routes,B2/B3 逐页实装) **验收全绿**:vue-tsc 0 错 / build ✓(主包 gzip 68KB)/ Chrome 冒烟 10/10 / 契约 style 断言 8/8(teal 渐变/侧栏 256 折叠 72/glass blur/双主题底色) 下一步 B2:三契约页(dash/acct/chan)1:1 实装 + 与 17890 预览 computed style 对拍。
Author
Owner

下拉菜单视觉契约修复(F1~F4,4 commits 6e6f5caf→F4)——已闭环

三根因与修复

  1. 色调不统一(根因=暗色映射被 EP 官方打回): ep-theme 漏写 html.dark 双写,EP dark/css-vars 以更高特异性覆盖 :root 颜色族,致暗色下 select trigger/弹层回退原生 #141414 系与 slate token 割裂。修复=双写+--el-select-* 9 变量族挂接。实测: trigger rgb(20,20,20)→rgba(148,163,184,.06),弹层→rgb(30,41,59)=slate-800
  2. 对齐无规则: el-select 左对齐本身正常;差异在密度(EP 0·32·20)与选中语义(EP 仅主色加粗无底)。修复=契约桥: 选项 padding 10/16(sub2api px-4 py-2.5)/选中=primary-soft 底+primary-600 字/弹层圆角 4→12/dropdown-item flex-start 显式
  3. 条件过多无搜索: 对齐 sub2api Select searchable=auto 语义(选项>5 自动出搜索)。新增 ScSelect 统一封装(auto>5 自动 filterable,searchable 可关/filterable 可覆盖)+downlink 来源(4 项,无搜索)/状态(6 项,出搜索)正反示范替换

验收: 新增 verify-select-contract.mjs 双主题 10 项 computed 断言 10/10 全过;sc-select.spec 4 用例;vitest 186/build/eslint/vue-tsc 全绿。新代码下拉一律用 ScSelect;「面板首项=搜索输入」严格形态将由 web-next(B 方案新工程)1:1 直译 sub2api Select 承载。

**下拉菜单视觉契约修复(F1~F4,4 commits `6e6f5caf`→F4)——已闭环** **三根因与修复** 1. **色调不统一(根因=暗色映射被 EP 官方打回)**: ep-theme 漏写 html.dark 双写,EP dark/css-vars 以更高特异性覆盖 :root 颜色族,致暗色下 select trigger/弹层回退原生 #141414 系与 slate token 割裂。修复=双写+--el-select-* 9 变量族挂接。实测: trigger rgb(20,20,20)→rgba(148,163,184,.06),弹层→rgb(30,41,59)=slate-800 2. **对齐无规则**: el-select 左对齐本身正常;差异在密度(EP 0·32·20)与选中语义(EP 仅主色加粗无底)。修复=契约桥: 选项 padding 10/16(sub2api px-4 py-2.5)/选中=primary-soft 底+primary-600 字/弹层圆角 4→12/dropdown-item flex-start 显式 3. **条件过多无搜索**: 对齐 sub2api Select searchable=auto 语义(选项>5 自动出搜索)。新增 **ScSelect 统一封装**(auto>5 自动 filterable,searchable 可关/filterable 可覆盖)+downlink 来源(4 项,无搜索)/状态(6 项,出搜索)正反示范替换 **验收**: 新增 verify-select-contract.mjs 双主题 10 项 computed 断言 **10/10 全过**;sc-select.spec 4 用例;vitest 186/build/eslint/vue-tsc 全绿。新代码下拉一律用 ScSelect;「面板首项=搜索输入」严格形态将由 web-next(B 方案新工程)1:1 直译 sub2api Select 承载。
Sign in to join this conversation.
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Tory/go-sms-V2#6