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

- 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>
2026-09-09 16:25:37 +08:00
@@ -0,0 +1,100 @@
+---
+schema: "hl-changelog/v2"
+ticket: "6951"
+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（param 参数设置域）并部署测试服。首期起始日任选；非首期须紧接上期；同时最多一个开账期。"
+updated_at: "2026-09-09"
+base: "dev-v3"
+---
+
+# 财务账期设置
+
+## 1. 接口背景
+财务域「账期」：财务核算的会计期间。同一时间最多一个开账期，封账后进入下一期。属财务域 param 参数设置域。
+
+## 2. 变更清单
+| 类型 | 接口 | 说明 |
+|---|---|---|
+| 新增 | GET `/admin/finance/account-periods/page` | 账期分页列表 |
+| 新增 | POST `/admin/finance/account-periods` | 开新账期 |
+| 新增 | POST `/admin/finance/account-periods/{id}/close` | 封账 |
+
+## 3. 接口详情
+
+### 3.1 分页列表 GET /page
+入参（Query + 分页）：`isClosed`（0 开着 / 1 已封账，空=全部）/ pageNo / pageSize。
+
+出参行（AccountPeriodRowRespVO，Long ID 序列化为 String）：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| id | String | 账期ID |
+| periodName | String | 账期名称 |
+| startDate | String | 起始日（yyyy-MM-dd） |
+| endDate | String | 截止日（yyyy-MM-dd，开账中为 null） |
+| isClosed | Integer | 0 开着 / 1 已封账 |
+| closedByName | String | 封账操作人姓名 |
+| closedTime | String | 封账时间（yyyy-MM-dd HH:mm:ss） |
+
+### 3.2 开新账期 POST /
+入参（AccountPeriodCreateReqVO）：
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| periodName | 是 | 账期名称（≤50 字） |
+| startDate | 是 | 起始日（yyyy-MM-dd；须为上期截止日的次日，首期任选） |
+
+出参：`{id}`（新账期ID，String）。
+
+### 3.3 封账 POST /{id}/close
+入参（AccountPeriodCloseReqVO，可空 body）：`endDate`（可选，缺省=该账期起始日所在月的月末）。
+
+## 4. 枚举 / 数据字典
+- `isClosed`：0 开着 / 1 已封账
+
+## 5. 错误码（段位 598100-598199）
+| 码 | 含义 |
+|---|---|
+| 598101 | 账期不存在 |
+| 598102 | 账期已封账 |
+| 598103 | 存在未封账的旧账期，请先封账 |
+| 598104 | 账期起始日与现有账期重叠或更早 |
+| 598105 | 账期起始日须为上期截止日的次日 |
+| 598106 | 账期截止日不能早于起始日 |
+
+## 6. 示例
+**开新账期（紧接上期）**
+```
+POST /admin/finance/account-periods  {"periodName":"2026-09期","startDate":"2026-09-01"}
+→ 200 {"id":"2097..."}
+```
+**封账（缺省月末）**
+```
+POST /admin/finance/account-periods/{id}/close  {}
+→ 200
+```
+**起始日不紧接上期（异常）**
+```
+POST /admin/finance/account-periods  {"periodName":"X","startDate":"2026-09-05"}
+→ 598105 账期起始日须为上期截止日的次日
+```
+
+## 7. 注意事项
+- 首期账期起始日任选；之后每期必须紧接上期截止日次日。
+- 同时最多一个开账期；封账后才能开下一期。
+- 长整型 ID 序列化为字符串。
+
+## 8. 关联 / 联系人
+- Issue：https://git.1814.love:8443/wx/HL/issues/6951
+- Commit：https://git.1814.love:8443/wx/HL/commit/fc87029a68
+- 负责人：腰苏图（yst）
@@ -0,0 +1,117 @@
+---
+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 资金账户域）并部署测试服。设默认/停用独立端点；设默认排他（同收款方其余自动降 0）。"
+updated_at: "2026-09-09"
+base: "dev-v3"
+---
+
+# 收款账户
+
+## 1. 接口背景
+财务域「收款账户」：各类收款方（司导/员工、车队、导游公司、供应商）的收款方式档案（微信/支付宝收款码、银行卡、对公账户）。供付款、报销等场景选择收款对象账户。
+
+## 2. 变更清单
+| 类型 | 接口 | 说明 |
+|---|---|---|
+| 新增 | GET `/admin/finance/payee-accounts/page` | 收款账户分页 |
+| 新增 | POST `/admin/finance/payee-accounts` | 新增收款账户 |
+| 新增 | PUT `/admin/finance/payee-accounts/{id}` | 编辑 |
+| 新增 | POST `/admin/finance/payee-accounts/{id}/set-default` | 设为默认（排他） |
+| 新增 | POST `/admin/finance/payee-accounts/{id}/disable` | 停用（软删） |
+
+## 3. 接口详情
+
+### 3.1 分页 GET /page
+入参（Query + 分页，均可选）：`payeeType` / `payeeName`（模糊）/ `accountType` / pageNo / pageSize。
+
+出参行（PayeeAccountRowRespVO，Long ID 序列化为 String）：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| id | String | 账户ID |
+| payeeType | String | 收款方类型 |
+| payeeRefId | String | 收款方关联ID（弱关联快照，可空） |
+| payeeName | String | 收款方名称 |
+| accountType | String | 账户类型 |
+| qrUrl | String | 收款码影像 URL |
+| bankAccount | String | 银行账号（展示层脱敏） |
+| bankName | String | 开户行 |
+| isDefault | Integer | 0 否 / 1 是（同收款方默认唯一） |
+
+### 3.2 新增 POST /
+入参（PayeeAccountCreateReqVO）：
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| payeeType | 是 | STAFF / FLEET / GUIDE_CO / SUPPLIER |
+| payeeRefId | 否 | 收款方关联ID（弱关联快照） |
+| payeeName | 是 | 收款方名称（≤100） |
+| accountType | 是 | WECHAT_QR / ALIPAY_QR / BANK_CARD / CORP_ACCOUNT |
+| qrUrl | 否 | 收款码影像（≤500，收款码类用） |
+| bankAccount | 银行卡/对公必填 | 银行账号（≤64；BANK_CARD/CORP_ACCOUNT 必填否则 595202） |
+| bankName | 否 | 开户行（≤100） |
+| isDefault | 否 | 默认 0；置 1 时同收款方原默认自动降 0 |
+
+出参 `{id}`。
+
+### 3.3 编辑 PUT /{id}
+入参均可选：`payeeName` / `accountType` / `qrUrl` / `bankAccount` / `bankName`。
+
+### 3.4 设默认 POST /{id}/set-default
+本账户置默认（isDefault=1），**同收款方其余账户自动降为 0**（默认排他，先降后升）。
+
+### 3.5 停用 POST /{id}/disable
+软删该收款账户。
+
+## 4. 枚举 / 数据字典
+| 字段 | 取值 |
+|---|---|
+| payeeType | STAFF 司导/员工个人 / FLEET 车队 / GUIDE_CO 导游公司 / SUPPLIER 供应商（预留） |
+| accountType | WECHAT_QR 微信收款码 / ALIPAY_QR 支付宝收款码 / BANK_CARD 银行卡 / CORP_ACCOUNT 对公账户 |
+| isDefault | 0 否 / 1 是 |
+
+## 5. 错误码（段位 595200-595299）
+| 码 | 含义 |
+|---|---|
+| 595201 | 收款方账户不存在 |
+| 595202 | 收款方账户字段组合不合法（银行卡/对公账户必填账号） |
+
+## 6. 示例
+**新增银行卡收款账户**
+```
+POST /admin/finance/payee-accounts
+{"payeeType":"STAFF","payeeName":"张三","accountType":"BANK_CARD","bankAccount":"622XXX","bankName":"工商银行","isDefault":1}
+→ 200 {"id":"2097..."}
+```
+**银行卡缺账号（异常）**
+```
+POST /admin/finance/payee-accounts  {"payeeType":"STAFF","payeeName":"张三","accountType":"BANK_CARD"}
+→ 595202 收款方账户字段组合不合法
+```
+**设默认**
+```
+POST /admin/finance/payee-accounts/{id}/set-default  → 200（同收款方其余自动降 0）
+```
+
+## 7. 注意事项
+- 同一收款方默认账户唯一；设默认会自动取消原默认。
+- 银行卡/对公账户必须填 bankAccount；收款码类填 qrUrl。
+- 银行账号原值入库、展示层脱敏。
+- 长整型 ID 序列化为字符串。
+
+## 8. 关联 / 联系人
+- Issue：https://git.1814.love:8443/wx/HL/issues/7003
+- Commit：https://git.1814.love:8443/wx/HL/commit/b46269a4d4
+- 负责人：腰苏图（yst）
@@ -0,0 +1,120 @@
+---
+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 资金账户域）并部署测试服。双边成对记账（一转出一入账）；幂等键防重复提交；不收转入金额（转出净减 amount+fee、转入净加 amount）。"
+updated_at: "2026-09-09"
+base: "dev-v3"
+---
+
+# 资金互转
+
+## 1. 接口背景
+财务域「资金互转」：公司各资金账户间划转（银行取现、现金存银行、三方提现、账户互转等）。一次互转双边成对记账（转出户一笔 OUT、转入户一笔 IN，共享 transferGroupId）。
+
+## 2. 变更清单
+| 类型 | 接口 | 说明 |
+|---|---|---|
+| 新增 | GET `/admin/finance/fund-transfers/page` | 互转记录分页（按 transferGroupId 成对聚合） |
+| 新增 | POST `/admin/finance/fund-transfers` | 发起互转（幂等） |
+
+## 3. 接口详情
+
+### 3.1 分页 GET /page
+入参（Query + 分页，均可选）：`fromAccountId` / `toAccountId` / `mode` / `operatorName`（精确）/ `flowAtStart` / `flowAtEnd`（按 transferDate 过滤）/ pageNo / pageSize。
+
+出参行（FundTransferRowRespVO，一转出一入账聚合成一行，Long ID 序列化为 String）：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| transferGroupId | String | 互转组ID |
+| mode | String | 存取方式 |
+| fromAccountId / fromAccountName | String | 转出账户 |
+| toAccountId / toAccountName | String | 转入账户 |
+| transferDate | String | 业务日期（yyyy-MM-dd，可回溯补录） |
+| amount | BigDecimal | 转出金额（转入实收同额） |
+| fee | BigDecimal | 手续费（挂转出行） |
+| outFlowId / inFlowId | String | 转出/入账流水ID |
+| voucherUrl | String | 佐证影像 |
+| flowAt | String | 落账时刻 |
+| handlerName / operatorName | String | 经手人 / 经办人 |
+| status | String | 恒 COMPLETED（本期无审批/撤销） |
+
+### 3.2 发起互转 POST /
+**幂等**：`@Idempotent`，key=`fromAccountId:toAccountId:amount`，5 秒内重复提交返回「互转提交处理中，请勿重复提交」。
+
+入参（FundTransferReqVO）：
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| mode | 是 | 存取方式（见枚举） |
+| fromAccountId | 是 | 转出账户ID |
+| toAccountId | 是 | 转入账户ID（不得与转出相同） |
+| amount | 是 | 转出金额（>0） |
+| fee | 否 | 手续费（≥0，默认 0，挂转出行） |
+| transferDate | 是 | 业务日期（可回溯补录） |
+| handlerName | 否 | 经手人（≤50） |
+| voucherUrl | 否 | 佐证影像（≤500） |
+| remark | 否 | 备注（≤200） |
+
+**口径**：不收转入金额——转出户净减 `amount+fee`、转入户净加 `amount`。
+
+出参（FundTransferRespVO）：`transferGroupId` / `outFlowId` / `inFlowId` / `fromBalanceAfter` / `toBalanceAfter`。
+
+## 4. 枚举 / 数据字典
+| 字段 | 取值 |
+|---|---|
+| mode | BANK2CASH 银行取现金 / CASH2BANK 现金存银行 / THIRD2BANK 三方提现到银行 / BANK2THIRD 银行转三方 / BANK2BANK 银行转银行 / CASH2CASH 现金转现金 |
+| status | COMPLETED（恒值，本期无审批/撤销） |
+
+## 5. 错误码
+| 码 | 含义 |
+|---|---|
+| 595001 | 账户不存在 |
+| 595004 | 互转两方账户不能相同 |
+| 595006 | 账户已停用 |
+| 595008 | 取现出账账户须为基本户 |
+| 595009 | 存取方式无效 |
+| 595010 | 存取方式与转出/转入账户类型不匹配 |
+| 595102 | 金额无效（须大于0） |
+| 595103 | 余额不足且不允许透支 |
+| 595104 | 资金写入并发冲突，请重试 |
+
+## 6. 示例
+**银行取现**
+```
+POST /admin/finance/fund-transfers
+{"mode":"BANK2CASH","fromAccountId":"2097...","toAccountId":"2098...","amount":5000.00,"transferDate":"2026-09-09","handlerName":"李四"}
+→ 200 {"transferGroupId":"...","outFlowId":"...","inFlowId":"...","fromBalanceAfter":...,"toBalanceAfter":...}
+```
+**两方同账户（异常）**
+```
+POST /admin/finance/fund-transfers  {"mode":"BANK2BANK","fromAccountId":"X","toAccountId":"X","amount":100,"transferDate":"2026-09-09"}
+→ 595004 互转两方账户不能相同
+```
+**5 秒内重复提交（幂等拦截）**
+```
+（同 fromAccountId:toAccountId:amount 再次 POST）
+→ 互转提交处理中，请勿重复提交
+```
+
+## 7. 注意事项
+- 互转即付即完成（status 恒 COMPLETED），无审批/撤销。
+- 银行取现（BANK2CASH）出账账户须为基本户（595008）。
+- 手续费 fee 只挂转出行，转入户实收=amount。
+- 长整型 ID 序列化为字符串。
+
+## 8. 关联 / 联系人
+- Issue：https://git.1814.love:8443/wx/HL/issues/7003
+- Commit：https://git.1814.love:8443/wx/HL/commit/b46269a4d4
+- 负责人：腰苏图（yst）
@@ -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）
@@ -0,0 +1,95 @@
+---
+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 资金账户域）并部署测试服。只读；balanceAfter 勾稽；列表行+详情补 remark 字段（#7133）。"
+updated_at: "2026-09-09"
+base: "dev-v3"
+---
+
+# 资金流水
+
+## 1. 接口背景
+财务域「资金流水」：资金账户每笔出入账的流水记录（只读）。来源包括付款、预付、报销、收款、业务外、互转、盘盈盘亏、期初调整等。本期列表行与详情补充 remark 字段（互转备注/盘盈盘亏/期初调整原因，#7133）。
+
+## 2. 变更清单
+| 类型 | 接口 | 说明 |
+|---|---|---|
+| 新增 | GET `/admin/finance/fund-flows/page` | 流水分页（flowAt 倒序） |
+| 新增 | GET `/admin/finance/fund-flows/{id}` | 流水详情 |
+
+## 3. 接口详情
+
+### 3.1 分页 GET /page
+入参（Query + 分页，均可选）：`fundAccountId` / `accountType` / `direction` / `bizType` / `flowNo`（模糊）/ `flowAtStart` / `flowAtEnd`（yyyy-MM-dd）/ pageNo / pageSize。
+
+出参行（FundFlowRowRespVO，Long ID 序列化为 String）：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| id | String | 流水ID |
+| flowNo | String | 流水号（日期前缀） |
+| fundAccountId | String | 资金账户ID |
+| accountName | String | 账户名称 |
+| accountType | String | 账户类型 |
+| direction | String | OUT 出 / IN 入 |
+| amount | BigDecimal | 金额 |
+| bizType | String | 业务类型 |
+| bizId | String | 业务单据ID（可空） |
+| bizNo | String | 业务单号（手写动作 TRANSFER/INVENTORY/OPENING 恒为 null） |
+| balanceAfter | BigDecimal | 本笔记完后结存快照（勾稽） |
+| transferGroupId | String | 互转组ID（仅 TRANSFER） |
+| fee | BigDecimal | 手续费（仅 TRANSFER，挂转出行） |
+| counterparty | String | 对方账户/往来（脱敏） |
+| flowAt | String | 记账时间（yyyy-MM-dd HH:mm:ss） |
+| voucherUrl | String | 佐证影像 |
+| remark | String | 备注（互转备注/盘盈盘亏/期初调整原因） |
+
+### 3.2 详情 GET /{id}
+出参 = 行全字段 + `pairedFlowId`（互转对侧流水ID，仅 TRANSFER）+ `operatorName`（经办人）。
+
+## 4. 枚举 / 数据字典
+| 字段 | 取值 |
+|---|---|
+| accountType | BANK / CASH / THIRD_PARTY / INTERNAL_VIRTUAL |
+| direction | OUT 出账 / IN 入账 |
+| bizType | PAYMENT 付款 / PREPAY 预付 / EXPENSE 费用 / REIMBURSE 报销 / RECEIPT 收款 / STAFF_LOAN 员工借款 / COMPANY_LOAN 公司借款 / NONBIZ 业务外 / ADVANCE 预支 / TRANSFER 互转 / ORDER_PAY 订单支付 / INVENTORY 盘盈盘亏 / OPENING 期初调整 |
+
+## 5. 错误码（段位 595100-595199）
+| 码 | 含义 |
+|---|---|
+| 595101 | 流水不存在（查询路径仅见此码） |
+| 595102-595106 | 写入侧（金额无效/余额不足/并发冲突/期初调整非法/盘盈盘亏方向无效），查询不触发 |
+
+## 6. 示例
+**按账户+方向查**
+```
+GET /admin/finance/fund-flows/page?fundAccountId=2097...&direction=OUT&pageNo=1&pageSize=20
+→ 200 {"records":[{"flowNo":"LS20260909...","direction":"OUT","amount":100.00,"balanceAfter":4900.00,"bizType":"PAYMENT",...}],"total":N}
+```
+**详情（互转带对侧）**
+```
+GET /admin/finance/fund-flows/{id}
+→ 200 {..., "bizType":"TRANSFER","transferGroupId":"...","pairedFlowId":"...","remark":"银行取现"}
+```
+
+## 7. 注意事项
+- 流水只读，无新增/修改/删除端点（由业务动作产生）。
+- balanceAfter 为该笔记完后的结存快照，可用于逐笔勾稽。
+- 手写动作（互转/盘盈盘亏/期初）无关联业务单号，bizNo 为 null。
+- 长整型 ID 序列化为字符串。
+
+## 8. 关联 / 联系人
+- Issue：https://git.1814.love:8443/wx/HL/issues/7003 ｜ remark 出参 #7133
+- Commit：https://git.1814.love:8443/wx/HL/commit/b46269a4d4
+- 负责人：腰苏图（yst）
@@ -0,0 +1,96 @@
+---
+schema: "hl-changelog/v2"
+ticket: "7052"
+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 并部署测试服。新增 code 留空后端自动生码（NONBIZ_ 前缀，#7052）；按方向组各自一套含已停用；停用/启用幂等。"
+updated_at: "2026-09-09"
+base: "dev-v3"
+---
+
+# 业务外收支分类
+
+## 1. 接口背景
+财务域「业务外收支分类」：与旅游主业无关的其他收入/支出归类（如房租、工资、理财收益等），按方向（IN 收入 / OUT 支出）各成一套。用于业务外流水（nonbiz）归集。
+
+## 2. 变更清单
+| 类型 | 接口 | 说明 |
+|---|---|---|
+| 新增 | GET `/admin/finance/nonbiz-categories` | 按方向查分类列表（含已停用） |
+| 新增 | POST `/admin/finance/nonbiz-categories` | 新增分类（code 可留空自动生码） |
+| 新增 | PUT `/admin/finance/nonbiz-categories/{code}` | 改名称/排序 |
+| 新增 | POST `/admin/finance/nonbiz-categories/{code}/disable` | 停用（幂等） |
+| 新增 | POST `/admin/finance/nonbiz-categories/{code}/enable` | 启用（幂等） |
+
+## 3. 接口详情
+
+### 3.1 查询 GET /
+入参（Query）：`direction` 必填：`IN` 收入组 / `OUT` 支出组。返回该方向组全部分类（含已停用）。
+
+出参 `List<NonbizCategoryRespVO>`：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| code | String | 类别码（如 AGENT_SALARY；业务主键） |
+| name | String | 分类名 |
+| direction | String | IN / OUT |
+| status | String | NORMAL / DISABLED |
+| sort | Integer | 排序 |
+
+### 3.2 新增 POST /
+入参：`direction`（必填 IN/OUT）/ `code`（可选 ≤50；**留空后端自动生码** `NONBIZ_` 前缀全局唯一）/ `name`（必填 ≤50）/ `sort`（缺省 0）。
+
+出参：`Result<String>`，data=最终落库的类别码（自动生码时返回生成值）。
+
+### 3.3 改 PUT /{code}
+入参：`name`（必填 ≤50）/ `sort`。（code 建后不可改；历史单据快照不追溯。）
+
+### 3.4 / 3.5 停用 / 启用
+`POST /{code}/disable`、`POST /{code}/enable`，均幂等。
+
+## 4. 枚举 / 数据字典
+- `direction`：IN 收入 / OUT 支出
+- `status`：NORMAL 正常 / DISABLED 停用
+
+## 5. 错误码（段位 598200-598299）
+| 码 | 含义 |
+|---|---|
+| 598201 | 类别码已存在（code 全局唯一，创建跨方向查重；自动生码序号耗尽同码） |
+| 598202 | 类别不存在 |
+| 598203 | 方向组非法，须为 IN 或 OUT |
+
+## 6. 示例
+**新增（自动生码）**
+```
+POST /admin/finance/nonbiz-categories  {"direction":"OUT","name":"办公室租金"}
+→ 200 data="NONBIZ_7"（自动生成的类别码）
+```
+**新增（指定 code 撞码，异常）**
+```
+POST /admin/finance/nonbiz-categories  {"direction":"IN","code":"RENT","name":"租金"}
+→ 598201 类别码已存在（即使 RENT 在 OUT 组已存在也报）
+```
+**查询支出组**
+```
+GET /admin/finance/nonbiz-categories?direction=OUT
+→ 200 [{"code":"RENT","name":"租金","direction":"OUT","status":"NORMAL","sort":0},...]
+```
+
+## 7. 注意事项
+- code 全局唯一（跨方向），创建时后端跨方向查重。
+- code 建后不可改；前端展示以 name 为准。
+- 推荐新增时留空 code 走自动生码。
+
+## 8. 关联 / 联系人
+- Issue：https://git.1814.love:8443/wx/HL/issues/7052（自动生码）
+- Commit：https://git.1814.love:8443/wx/HL/commit/fc87029a68
+- 负责人：腰苏图（yst）
@@ -0,0 +1,97 @@
+---
+schema: "hl-changelog/v2"
+ticket: "7129"
+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 并部署测试服。status 统一 DISABLED（#7129）；重复停用/启用改幂等成功；停用大类级联停用末级、启用不级联。"
+updated_at: "2026-09-09"
+base: "dev-v3"
+---
+
+# 费用分类（业务内）
+
+## 1. 接口背景
+财务域「费用分类」（业务内支出分类）：两级树（大类 level=1 → 末级 level=2），供费用报销等业务归集。本期统一状态枚举为 DISABLED，停用/启用幂等化。
+
+## 2. 变更清单
+| 类型 | 接口 | 说明 |
+|---|---|---|
+| 新增 | GET `/admin/finance/expense-categories/tree` | 分类树（status 筛选） |
+| 新增 | POST `/admin/finance/expense-categories` | 新增分类（大类或末级） |
+| 新增 | PUT `/admin/finance/expense-categories/{id}` | 改名称/排序 |
+| 新增 | POST `/admin/finance/expense-categories/{id}/disable` | 停用（幂等，大类级联停用末级） |
+| 新增 | POST `/admin/finance/expense-categories/{id}/enable` | 启用（幂等，不级联） |
+
+## 3. 接口详情
+
+### 3.1 分类树 GET /tree
+入参（Query）：`status` 可选：`NORMAL`（默认，只出正常）/ `DISABLED` / `ALL`；其他值 → 598303。
+
+出参 `List<ExpenseCategoryNodeRespVO>`（树形，大类嵌 children）：
+
+| 字段 | 类型 | 说明 |
+|---|---|---|
+| id | String | 分类ID |
+| parentId | String | 父类ID（大类为 null） |
+| level | Integer | 1 大类 / 2 末级 |
+| name | String | 分类名 |
+| sort | Integer | 排序 |
+| status | String | NORMAL / DISABLED |
+| children | Array | 末级列表（仅大类行有，空数组非 null） |
+
+### 3.2 新增 POST /
+入参：`parentId`（可选；空=新增大类 level=1，填=新增末级 level=2）/ `name`（必填，≤50 字）/ `sort`（可选默认 0）。出参 `{id}`。
+
+### 3.3 改 PUT /{id}
+入参：`name`（必填 ≤50）/ `sort`。（历史单据名称快照不追溯。）
+
+### 3.4 停用 /{id}/disable
+幂等（已 DISABLED 直接成功）；**停用大类级联停用其全部末级**。
+
+### 3.5 启用 /{id}/enable
+幂等（DISABLED→NORMAL，已正常直接成功）；**启用大类不级联启用末级**（末级需单独启用）。
+
+## 4. 枚举 / 数据字典
+- `status`：NORMAL 正常 / DISABLED 停用（原 CANCELLED 已统一为 DISABLED）
+
+## 5. 错误码（段位 598300-598399）
+| 码 | 含义 |
+|---|---|
+| 598301 | 分类不存在 |
+| 598302 | 分类名已存在（大类名全局唯一；末级名大类内唯一） |
+| 598303 | 分类当前状态不允许此操作（含非法 status 参数） |
+| 598304 | 所属大类不存在或非法 |
+
+## 6. 示例
+**新增末级**
+```
+POST /admin/finance/expense-categories  {"parentId":"2097...","name":"市内交通","sort":1}
+→ 200 {"id":"2098..."}
+```
+**停用大类（级联停用末级）**
+```
+POST /admin/finance/expense-categories/{id}/disable  → 200
+```
+**重复停用（幂等）**
+```
+POST /admin/finance/expense-categories/{id}/disable  → 200（再次调用仍成功）
+```
+
+## 7. 注意事项
+- 停用大类会级联停用末级；启用大类**不**级联（末级单独启用）。
+- 重复停用/启用返回 200 幂等成功，不再报 598303。
+- 长整型 ID 序列化为字符串。
+
+## 8. 关联 / 联系人
+- Issue：https://git.1814.love:8443/wx/HL/issues/7129（统一 DISABLED）
+- Commit：https://git.1814.love:8443/wx/HL/commit/fc87029a68
+- 负责人：腰苏图（yst）