docs(changelog): 财务域 账期/费用分类/业务外分类/收款账户/资金流水/资金互转/资金日报 7 篇入 changelogs-v2
changelog-filename-gate / validate (push) Failing after 2s

- 09_6951_财务账期设置:page/开新账期/封账 3 端点
- 09_7129_费用分类:tree/增/改/停用/启用 5 端点(DISABLED 统一+幂等)
- 09_7052_业务外收支分类:查询/增/改/停用/启用 5 端点(自动生码 NONBIZ_)
- 09_7003_收款账户:page/增/改/设默认/停用 5 端点
- 09_7003_资金流水:page/详情 2 端点(只读,含 remark)
- 09_7003_资金互转:page/发起 2 端点(双边成对记账+幂等)
- 09_7003_资金日报:daily 1 端点(closing=opening+收入−支出勾稽)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
这个提交包含在:
yaosutu
2026-09-09 16:25:37 +08:00
共同撰写人 Claude Opus 4.8
父节点 2b45ee9d44
当前提交 5025f8d69b
共修改 7 个文件,包含 725 行新增和 0 行删除
@@ -0,0 +1,100 @@
---
schema: "hl-changelog/v2"
ticket: "7003"
title: "资金日报(区间收支 + 逐日结余)"
consumer: "admin"
author: "yst"
change_type: "新增接口"
backend_status: "deployed"
gateway_status: "verified"
frontend_status: "pending"
frontend_owner: "hl-admin"
frontend_ref: ""
target_release: ""
verified_at: "2026-09-09"
status_note: "后端已合 dev-v3(account 资金账户域)并部署测试服。closing=opening+收入−支出勾稽;收支聚合排除期初调整留痕流水。"
updated_at: "2026-09-09"
base: "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)