3.5 KiB
3.5 KiB
schema, ticket, title, consumer, author, change_type, backend_status, gateway_status, frontend_status, frontend_owner, frontend_ref, target_release, verified_at, status_note, updated_at, base
| schema | ticket | title | consumer | author | change_type | backend_status | gateway_status | frontend_status | frontend_owner | frontend_ref | target_release | verified_at | status_note | updated_at | base |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| hl-changelog/v2 | 7003 | 资金日报（区间收支 + 逐日结余） | admin | yst | 新增接口 | deployed | verified | verified | mmg | 21540997 | 2026-09-09 | 后端已合 dev-v3（account 资金账户域）并部署测试服。closing=opening+收入−支出勾稽；收支聚合排除期初调整留痕流水。 | 2026-09-09 | dev-v3 |
资金日报
1. 接口背景
财务域「资金日报」：按账户（或全部账户汇总）统计某日期区间的收入/支出/结余，并给出逐日明细。用于财务每日资金看板。
2. 变更清单
| 类型 | 接口 | 说明 |
|---|---|---|
| 新增 | GET /admin/finance/fund-stats/daily |
资金日报（区间收支 + 逐日结余） |
3. 接口详情
3.1 资金日报 GET /daily
入参（Query）：
| 字段 | 必填 | 说明 |
|---|---|---|
| accountId | 否 | 资金账户ID；空=全部账户汇总（全账户口径下互转双边计入） |
| startDate | 是 | 起始日（yyyy-MM-dd，含当日） |
| endDate | 是 | 截止日（yyyy-MM-dd，含当日） |
出参（FundDailyStatsRespVO）：
| 字段 | 类型 | 说明 |
|---|---|---|
| openingBalance | BigDecimal | 期初结转（=当前结存−起点以来流水净影响） |
| priorIncome | BigDecimal | 起始日前累计收入 |
| priorExpense | BigDecimal | 起始日前累计支出 |
| totalIncome | BigDecimal | 区间总收入 |
| totalExpense | BigDecimal | 区间总支出 |
| closingBalance | BigDecimal | 期末结存 = openingBalance + totalIncome − totalExpense |
| days | Array | 逐日明细（仅有流水的日期，日期升序） |
days 行（DayRow）：
| 字段 | 类型 | 说明 |
|---|---|---|
| date | String | 日期（yyyy-MM-dd） |
| income | BigDecimal | 当日收入 |
| expense | BigDecimal | 当日支出 |
| dayNet | BigDecimal | 当日净额（income−expense） |
| runningBalance | BigDecimal | 累计结余（自期初结转逐日累加） |
口径：收支聚合排除 biz_type=OPENING 留痕流水（期初调整是重定基准，非业务收支）。
4. 枚举 / 数据字典
无（数值统计）。
5. 错误码（段位 595300-595399）
| 码 | 含义 |
|---|---|
| 595301 | 账户不存在 |
| 595302 | 日期区间非法（起始日不能晚于截止日） |
| 595303 | 日期区间跨度超限（最长 366 天） |
6. 示例
全账户 9 月日报
GET /admin/finance/fund-stats/daily?startDate=2026-09-01&endDate=2026-09-09
→ 200 {"openingBalance":12000.00,"totalIncome":8000.00,"totalExpense":5000.00,"closingBalance":15000.00,"days":[{"date":"2026-09-03","income":5000.00,"expense":0,"dayNet":5000.00,"runningBalance":17000.00},...]}
单账户日报
GET /admin/finance/fund-stats/daily?accountId=2097...&startDate=2026-09-01&endDate=2026-09-09
→ 200 {...}
区间非法（异常）
GET /admin/finance/fund-stats/daily?startDate=2026-09-09&endDate=2026-09-01
→ 595302 日期区间非法
7. 注意事项
- 勾稽关系：closingBalance = openingBalance + totalIncome − totalExpense。
- 逐日 days 仅含有流水的日期（无流水日期不返回，前端可自行补零）。
- 期初调整流水不计入收支（避免重定基准被算成收支）。
8. 关联 / 联系人
- Issue：https://git.1814.love:8443/wx/HL/issues/7003
- Commit：https://git.1814.love:8443/wx/HL/commit/b46269a4d4
- 负责人：腰苏图（yst）