在租赁用户和供应商用户首页,添加导出对账单功能。包括资金账号出入账汇总和明细。

This commit is contained in:
lu7213 committed 2026-11-03 05:37:41 -05:00
1 parent 611e020f38
commit 2870c3fb6c
6 files changed
+446

No files matched your search

+27
View File
@@ -0,0 +1,27 @@
# 本人租赁资金对账单
租赁账户与供应商首页顶部新增“资金对账单”。展开后选择网络与记账日期,点击“下载 Excel”。默认沿用首页网络及近7/14/30天;导出日期独立于看板统计。执行 `sql/rent_statement_export_menu.sql`,为 PROXY_ACCOUNT、PROXY_SUPPLIER 授予 `rent:statement:export`,重新登录后生效。父菜单需要已有 `rent:portal:view` 页面。
本功能复用现有rent_account及rent_ledger,无需新增表或迁移历史资金数据。权限SQL需部署方执行,不会由页面自动修改角色。
## 文件内容和口径
- 账户收支汇总:账户编号、网络、时区、起止日期、生成时间、期初/期末总资产、资产增加/减少及校验;同时列出可用、冻结、待结算三个分户的期初、增、减、期末。
- 业务分类汇总:按 event_type 汇总笔数、资产增减和三个分户净变化。
- 资金流水明细:流水ID、记账时间、事件类型、资产与分户变动、记账后余额、订单/结算/退款/提现/冲正关联ID及记账说明。只导出明确白名单字段,不含私钥、API Secret、账户凭证或内部付款证据。
总资产=可用余额+冻结余额+待结算收益。逐笔三个分户变动之和大于0为资产增加,小于0为资产减少,0为内部划转/无净变化。因此冻结、解冻、收益结算转入可用不会重复增加收入或支出。供应商毛收入和平台扣费保留为独立事件,扣费体现在供应商待结算减少,不将平台自身收入算作本人资产。该口径是资金账本资产变化,不能等同链上钱包收付款或利润表。
同一用户双角色共用同网络资金账户,导出完整账本,不按角色遗漏其中一侧流水。NILE与MAINNET独立,禁止跨网汇总。日期按服务器/JVM本地时区,包括起止当天,数据库使用左闭右开区间;当天数据截至生成本次一致性快照。冻结中的资金仍属于资产。无流水区间仍输出期初、期末余额。
期末余额由同一事务的当前账户余额减去结束日期之后的流水变化还原;期初=期末-区间净变化。不修改历史数据,不触发链上查询,不创建账户。明细按不可变流水ID升序,金额及编号为Excel文本,保持6位小数及大整数精度。备注以文本输出,不执行公式。
## 接口与限制
`POST /rental/statements/export?network=NILE&from=2026-11-01&to=2026-11-03`,需登录与 `rent:statement:export` 权限。仅支持NILE/MAINNET、单次最多366天/50000条,结束日期不能晚于服务器当天。越限明确拒绝并提示分段导出,禁止静默截断。未开通账户返回业务错误。客户端不传userId/accountId,即使额外提交也不参与查询。
成功返回xlsx二进制,失败返回原有JSON错误;前端识别错误Blob而不下载损坏文件。响应不缓存,不在浏览器本地存储账本。SXSSF临时文件在完成/失败后均清理。按服务端导出开始、快照生成、导出完成/失败日志中的userId/network/date/rows排查,不记录金额、流水正文和凭证。
## 验证记录
JDK8隔离租赁回归186项通过。新增用例覆盖跨用户/网络过滤、冻结与结算内部划转、真实消费与提现扣款、历史期后变动还原、左闭右开日期边界、空区间和大金额文本精度,并通过POI重新读取生成的三个工作表、验证备注不是公式。前端模板/脚本检查及实际Vue组件桌面/手机交互验证通过;演示下载使用隔离测试生成的xlsx,未连接真实资金账户。impeccable独立收尾评审结论ship。