4.8 KiB
4.8 KiB
S3 前端收尾泳道收官 人工验收单(2026-11-14 深夜④)
前置:s2-closeout.md(S2 结算域收官)。本单=《Go-sms-重建计划》S3 行出口判定: FE-6(权限矩阵走查/Mock 下线/性能/CI 镜像化)+ 结算页面族(含 FE-D34 利润分析)。
一、交付物
| # | 任务 | 结果 | 证据 |
|---|---|---|---|
| 1 | views 31 页等价核对 | ✅ | git --git-dir=归档仓 ls-tree poc-final 与现仓逐文件比对:31 个 .vue 全量在位(S1-B 已搬)+S2 新增 settle/index.vue;api 12 文件+router 3 文件同构+settle.ts 新增——搬运项实为零残留,S3 仅回归验证 |
| 2 | FE-D34 利润分析页 | ✅ | views/stats/profit/index.vue(用户/通道双 Tab+汇总条:应收/成本分摊/返点/平台净利;利润正负着色;口径说明常驻=阶梯不进分析/占比分摊/R4 诚实标注);路由 /stats/profit(统计结算组,roles admin/ops/service 与后端平台门一致);api/settle.ts +profitUsers/profitChannels(类型+契约);vitest 2 件(api 契约+组件挂载渲染) |
| 3 | FE-6 · Mock 下线 | ✅ | 浏览器 mock 通道全链移除:main.ts worker 分支/mocks/browser.ts/public/mockServiceWorker.js/.env* VITE_API_MODE/LoginView isMock(演示账号提示)/Makefile web-dev·web-real 口径;msw 移至 devDependencies 仅存 vitest 层(mocks/node.ts 测试隔离服务器,138 用例不破);单一 real 模式(vite proxy→gateway :8080) |
| 4 | FE-6 · 权限矩阵走查 | ✅ | tests/role-menu-matrix.spec.ts:五角色×33 菜单固化矩阵快照(人工确认语义:资金/通道/结算=admin/ops,service=运营执行,group/customer=业务自助不见资金页,与后端 casbin/statsIsPlatform 同口径);矩阵未登记新菜单=测试红(走查强制过目);8 件断言 |
| 5 | FE-6 · 性能 | ✅(产物口径) | manualChunks 拆 vendor:主包 1.27MB→element-plus 341KB+vue-vendor 62KB+业务 entry ~19KB(全部 gzip),逐 chunk <500KB 达标;页面全量路由懒加载;⚠️LCP 真浏览器实测受阻(本机 chromium 确定性 Target crashed,3 轮 flag 组合均崩,见 §四) |
| 6 | FE-6 · CI 集成 | ✅ | .gitea/workflows/ci.yml +web-test job(setup-node22+corepack pnpm+四件门禁,与 make web-test 同语义;Gitea Actions 未启用时同 Go job 不执行不碍仓) |
| 7 | FE-6 · web 镜像化 | ✅(构建+容器冒烟实测) | web/Dockerfile(dist 产物镜像 nginx:1.27-alpine——容器内 npm 带宽实测 22~49KiB/s 全量依赖不可行,构建前置=宿主/CI vite build,make web-image 一键)+nginx.conf.template(envsubst 注入 API_UPSTREAM;gzip/SPA fallback/资产一年强缓存);容器冒烟:root 200/SPA 路由 200/api 反代→宿主网关 401 应答/gzip+immutable 生效;deploy/k8s/web.yaml(Deployment+Service NodePort 30081,POC 既定口径)——kind 本机未装,清单随 S5 灰度实际 apply |
二、门禁(七件套前端件;后端零改动)
| 项 | 结果 |
|---|---|
| eslint(max-warnings 0) | ✅ 0 |
| vue-tsc --noEmit | ✅ 0 |
| vitest | ✅ 148 用例全绿(138 存量+利润 2+矩阵 8;guard 菜单计数随 FE-D34 31→32 显式更新) |
| vite build | ✅ 产物全 chunk gzip<500KB(最大 element-plus 341KB) |
| go vet/-race/lint | ✅ S2-D5 终态延续(后端零触碰) |
三、真机验证(dev,2026-11-15 00:0x)
- dev server 重启(Mock 下线生效):
/200、SPA 路由/stats/profit返回壳、index.html 零 msw 引用; - vite proxy→gateway 链路:
/api/v1/billing/consume、/api/v1/stats/profit/users→ 401(未带 token,网关正常应答); - web 镜像:
make web-image构建实测(结果见 CHANGELOG 行;拉取慢=宿主带宽已知特性)。
四、受阻与诚实标注
- LCP<2s 真浏览器实测不可执行:本机 chromium(playwright/headless shell)newPage 即 Target crashed(3 轮:默认/--disable-gpu/+GLIBC_TUNABLES 关 AVX/--no-sandbox 全崩;dmesg 无内核记录=渲染进程层崩溃)。宿主 CPU 指令缺陷为已知系统级事实(techContext)。以产物口径代替判定:首屏传输=entry ~19KB+两 vendor ~404KB(gzip)+css,局域网/光纤下 LCP<2s 结构性成立;S5 压测泳道若 chromium 可用则补实测。
- kind 未装(老机 go-sms-dev 集群未随迁):deploy/k8s/web.yaml 为备档,S5 灰度实际 apply+kind load 摆渡镜像。
五、遗留移交(不阻塞 S4)
- element-plus 按需引入(裸 1.09MB 的根治项,涉及全站组件注册改造)=二期优化;
- Playwright 截图矩阵/e2e 本机不可跑(chromium 崩),回归依赖 vitest+真机走查;
- S2 用户本人走查补正(D2~D5 脚本 27 PASS 已备)与本单页面走查(浏览器 :5173 → 统计结算/利润分析)一并待用户执行。
六、验收结论
S3 泳道通过(出口:LCP/单包口径达标+走查归档自动化矩阵+CI 镜像化落地;两项环境受阻如实标注)。 下一步=S4(C1/C2+CH 冷热+明细分区)。