Files
go-sms-V2/docs/acceptance/s2-frontend-preview.md
T

3.1 KiB
Raw Blame History

S2 结算验收页(前端预验收面) 交付单(2026-11-14 深夜)

动因:用户裁决「需要人工前端页面验收,否则对项目进度完全没有感知」——S2 后端 D1~D4 已完成但全部不可见,本单以最小可视化验收面补正(评审者感知断层),S3 结算页面族在此基础精修。

一、交付物

# 文件 内容
1 web/src/views/settle/index.vue 结算管理页 4 Tab:消耗日汇总(查询+手动回补)/充值订单(创建+确认/驳回二次确认)/月度结算单(生成/重算+确认/结账/导出 XLSX+明细抽屉)/阶梯价(增删);页头「S2 验收版·S3 精修」
2 web/src/api/settle.ts 12 端点封装(TS 类型)+downloadBill(fetch+blob 带 token 文件流下载)
3 web/src/router/routes.ts settle 项 ComingSoon → 真页面(roles admin/ops 不变)
4 scripts/seed_settle_demo.sql 演示种子:s2demo 登录账号(admin,不动内置 admin)/demo-cust 客户/价格时间线(11-01 0.10、11-15 0.15 月中调价)/近 5 天消耗(19550 成功)/待确认订单;幂等
5 web/s2-acceptance.mjs Playwright 预走查脚本(登录→四 Tab→订单确认实操作→生成账单→明细抽屉→6 截图)

二、门禁(前端四件)

项 结果
eslint(max-warnings 0) ✅ 0
vue-tsc --noEmit ✅ 0
vitest 全量 ✅ 138/138(既有零破坏)
npm run build ✅ 9.74s(chunk 警告=既有已知项,S3 性能门)

三、Playwright 预走查(真库闭环,2026-11-14 22:1x)

  1. 登录 s2demo → /home ✓;菜单进入 /settle ✓;
  2. Tab1 消耗汇总 5 行(种子数据)展示 ✓;
  3. 订单确认实操作:页面按钮→MessageBox→API→账号 2 余额 5000→6000 真实落账 ✓;
  4. 生成账单:SC202611-2 = 19550 条 × 1955.00 元——与价格时间线分毫不差(11-10~11-14 全部落在 0.10 档,11-15 调价档留走查验证) ✓;
  5. 明细抽屉(按天行)✓;Tab4 阶梯 ✓;6 张截图 web/shots/s2-settle-*.png。

过程留痕(casbin 热加载缺口):SQL 直插 casbin_rule 在 gateway 运行中不生效(策略启动时载入内存)→ 写操作 403;重启 gateway 后全通。种子脚本已注释该约束(正规路径=走开户 API 自动同步 enforcer)。

四、用户走查指引(3 分钟)

# 1. 种子(已种可跳过;幂等)——注意:gateway 运行中种后需重启使其 casbin 生效
sg docker -c 'docker exec -i go-sms-mysql mysql -uroot -proot123 gosms' < scripts/seed_settle_demo.sql
# 2. 确保服务在跑:make gw-start(8080) / make web-dev(5173)
# 3. 浏览器 http://127.0.0.1:5173 → 登录 s2demo / S2demo@2026
#    菜单「统计结算 → 结算管理」四 Tab 走查:
#    - 订单:确认到账看余额 / 驳回不涉余额
#    - 账单:生成 2026-11 → 金额 1955;配阶梯(账号2,0 档 0.08)→ 重算 → 1564;
#      确认 → 结账(SettleRecord)→ 导出 XLSX
#    - 阶梯:增/删即时生效于重算

五、边界

  • mock 模式不覆盖(msw settle handler 留 S3 结算页面族一起做);页面为验收版,S3 按设计规范精修(ProTable 化/权限走查/LCP);
  • 上家账单/利润 Tab 未含(后端 D5 未实现),S3/D5 后点亮。