报表
报表 endpoint 涵盖了所有涉及交易历史读取的功能。列表用于实时仪表盘，CSV 异步生成用于大时间段的 BI/审计。
各自的使用场景
| 场景 | Endpoint |
|---|---|
| 仪表盘交易界面 | GET /user/transactions |
| 特定交易的详情 | GET /user/transactions/{id} |
| 大时间段报表（月、年） | POST /user/report |
| 列出已请求的报表 | GET /user/reports |
| 检查报表是否已完成 | GET /user/report/{id} |
| 下载生成的 CSV | POST /user/report/{id}/download |
列表 vs 异步报表
| 场景 | 推荐方式 |
|---|---|
| 仪表盘，< 10k 条记录 | GET /user/transactions 分页 |
| 日常对账 | GET /user/transactions 分页 |
| 完整月份或年份 | POST /user/report（CSV 异步） |
| BI / 数据仓库 | POST /user/report 定时任务 |