feat(admin): 新增后台财务看板与财务明细

This commit is contained in:
yml2213
2026-10-30 13:22:31 +08:00
parent ab5dac51f7
commit 4239bec519
10 changed files with 789 additions and 5 deletions
+2 -2
View File
@@ -194,9 +194,9 @@ dist/assets/AdminLayout-*.js 36.87 kB │ gzip 13.02 kB
## 5. 已知限制
1. 移动端订单列表/详情与消息中心已接入真实接口;下单、支付、交接、归还、结账等操作仍待迁移。
2. 后台已完成仪表盘、订单列表/详情、退款审核、提现审核、商品列表/详情与审核、用户列表/详情与人工操作、申诉仲裁,其余页面仍为统一占位。
2. 后台已完成仪表盘、订单列表/详情、退款审核、提现审核、商品列表/详情与审核、用户列表/详情与人工操作、申诉仲裁、财务看板,其余页面仍为统一占位。
3. 分销后台已完成主题、Logo、登录页与 Shell 轻改,页面结构未重写。
4. 后台菜单权限码按后端逐个核对:订单 `order:list` / `order:view` / `order:close`,商品 `listing:view` / `listing:approve` / `listing:reject` / `listing:offline`,用户 `user:view` / `user:freeze` / `user:unfreeze` / `user:deposit_free` / `user:growth_points` / `user:manual_realname` / `user:revoke_realname` / `user:wallet_adjust`,提现 `withdrawal:list` / `withdrawal:detail` / `withdrawal:review` / `withdrawal:pay`,申诉 `dispute:view` / `dispute:arbitrate`;其余页面仍需核对。
4. 后台菜单权限码按后端逐个核对:订单 `order:list` / `order:view` / `order:close`,商品 `listing:view` / `listing:approve` / `listing:reject` / `listing:offline`,用户 `user:view` / `user:freeze` / `user:unfreeze` / `user:deposit_free` / `user:growth_points` / `user:manual_realname` / `user:revoke_realname` / `user:wallet_adjust`,提现 `withdrawal:list` / `withdrawal:detail` / `withdrawal:review` / `withdrawal:pay`,申诉 `dispute:view` / `dispute:arbitrate`,财务 `wallet:view`;其余页面仍需核对。
5. SVG 中文尚未转曲。
6. 入口包已降至 495 kB(gzip 161 kB);AntD 共享基础设施仍在入口,后续可拆独立入口。
7. 移动端、订单、分销轻改与首屏优化均已提交;商品管理与审核在本批次提交。
+65
View File
@@ -0,0 +1,65 @@
# Phase 2 验收报告(后台财务看板)
> 日期:2026-10-30
> 项目:解忧商行(hfb_jysh)
> 范围:`/console-jy8k3m/finance`
> 结论:**本切片通过,财务总览、每日趋势与财务明细已接真实接口**
---
## 1. 接口与权限
| 能力 | 接口 | 权限码 |
| --- | --- | --- |
| 财务总览 | `GET /api/admin/finance/dashboard` | `wallet:view` |
| 财务明细 | `GET /api/admin/finance/details` | `wallet:view` |
日期参数:`start_date` / `end_date`(`YYYY-MM-DD`)。前端菜单权限已从推断值 `finance:view` 修正为 `wallet:view`。
## 2. 页面结构
`frontend/src/features/admin/AdminFinancePage.tsx`
- 顶部日期区间:默认近 7 天,可切换任意区间;总览与明细共用区间
- 主 KPI:总流水、总退款、平台收入、号主应得、渠道净额、资金异常、待打款、提现待审
- 次级摘要:待结算订单、线下提号、撞车商城净额、运营支出
- 每日趋势:流水、退款、渠道净额、平台收入、号主应得、结算/支付订单数、运营支出、已打款
- 财务明细:订单号、双方、订单金额、结账金额、支付/退款/渠道净额、财务状态、结算时间
- 明细支持订单号精确查询、日期类型(下单/结算/线下结算)、分页
- 点击订单号跳转订单管理并带上 `keyword` 查询
## 3. 财务状态
| 值 | 文案 |
| --- | --- |
| `normal` | 正常 |
| `refund_pending` | 退款中 |
| `refund_failed` | 退款失败 |
| `settlement_diff` | 结算差异 |
| `offline_settlement_pending` | 待线下结算 |
## 4. 验证结果
```text
npx tsc --noEmit 通过
npm run build 通过(入口 496.68 kB,gzip 161.26 kB)
GET /api/admin/finance/dashboard?start_date=2026-10-24&end_date=2026-10-30 ok,返回 summary/daily/各摘要
GET /api/admin/finance/details?...&page=1&page_size=5 ok,{"items":[],"total":0}
GET /console-jy8k3m/finance 200
```
开发库没有订单流水,总览与明细均为 0;接口字段与 DTO 已核对。
## 5. 已知限制
1. 未接线下出款、人工出款、运营支出登记与作废接口(需要 `finance:manual_disbursement` / `finance:operating_expense`)。
2. 未做图表可视化,当前以 KPI + 表格呈现。
3. 财务明细不支持按财务状态筛选(后端未提供该参数)。
4. 未做导出与对账单下载。
## 6. 下一步建议
1. 后台公告管理与系统配置。
2. 后台审计日志。
3. 线下出款/运营支出登记。
4. 移动端下单、支付与交接/归还/结账。
+1 -1
View File
@@ -395,7 +395,7 @@ hfb_jysh/
### Phase 4:管理后台核心(4–5 周)
> 状态:**进行中(2026-10-30)**。已完成仪表盘、订单列表/详情、退款审核、提现审核、商品列表/详情与审核、用户列表/详情与人工操作、申诉仲裁;财务看板、系统配置与审计日志待迁移。
> 状态:**进行中(2026-10-30)**。已完成仪表盘、订单、退款、提现、商品、用户、申诉与财务看板;线下出款/运营支出、系统配置与审计日志待迁移。
- 后台登录、工作台、订单列表、订单详情。
- 商品列表、商品详情、审核。