# 流水明细对手方聚合查询前端实施计划

## 背景

用户希望在项目详情的“流水明细查询”中增加“对手方”视图，效果参考 lsfx 对手方列表：在同一筛选条件下按对手方汇总，查看流入、流出和总交易规模。

## 实施范围

- `ruoyi-ui/src/views/ccdiProject/components/detail/DetailQuery.vue`
- `ruoyi-ui/src/api/ccdiProjectBankStatement.js`

## 实施步骤

1. 在流水明细结果区标题旁增加 `el-radio-group`，提供“流水明细 / 对手方”切换。
2. 新增 `listBankStatementCounterparties` API 方法，请求后端 `/ccdi/project/bank-statement/counterparty/list`。
3. 对手方模式下复用左侧筛选区和分页组件，隐藏“导出流水”按钮。
4. 对手方表格展示对手方名称、流入合计、流出合计、总交易额和最近交易时间。
5. 对手方模式默认按总交易额倒序；表格列排序映射到后端白名单字段。

## 验证计划

- 前端构建：
  `npm run build:prod`
- 真实页面验证：
  1. 打开项目详情 `http://127.0.0.1:8081/ccdiProject/detail/42?tab=detail`。
  2. 进入“流水明细查询”，切换到“对手方”。
  3. 确认列表展示对手方名称、流入/流出/总交易额与分页总数。
  4. 确认对手方表格不展示“操作”列和“查看流水”按钮。

## 本机 Node 说明

`.nvmrc` 指向 `14.21.3`，但本机该版本环境不可稳定提供 npm。按仓库约定，本次使用已验证可用的 Node `22.22.3` 与 npm `10.9.8` 完成构建和页面验证。