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

53 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 分钟)
```bash
# 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 后点亮。