53 lines
3.1 KiB
Markdown
53 lines
3.1 KiB
Markdown
# 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 后点亮。
|