# 氢费（采购端）汇总报表 — 产品需求说明（PRD）

| 项目 | 内容 |
|------|------|
| 文档版本 | v1.0（业务版） |
| 产品模块 | 台账数据 → 氢费（采购端）汇总报表 |
| 文档类型 | 产品需求说明 |
| 适用读者 | 产品、采购、财务、运营、测试、项目 |

---

## 一、为什么做这件事

### 1.1 业务痛点

- 采购侧需按加氢站维度掌握氢费规模、应付与实付、开票与预付余额，现有数据分散在车辆氢费明细、打款、开票等模块，缺少一站汇总视图。
- 财务对账需快速识别「未付金额」「站点欠费」等风险，并下钻到账单、流水、发票凭据。

### 1.2 产品价值

| 价值点 | 说明 |
|--------|------|
| 站点汇总 | 一行一站，看清加氢量、应付、已付、未付、开票、未开票、当前余额 |
| 对账效率 | 顶部合计条随筛选即时汇总，支撑采购与财务日常核对 |
| 可追溯 | 关键金额可钻取明细，付款凭据、发票支持在线预览与下载 |
| 风险可见 | 未付/未开票金额为正、当前余额为负时突出展示 |

### 1.3 本期目标

建设 Web 端「氢费（采购端）汇总报表」，按地区、加氢站、结算方式查询，展示站点汇总列表及合计；支持多类钻取与 CSV 导出。

### 1.4 本期不做

- 报表内直接发起打款、开票（跳转或对接后续迭代）。
- 跨年度历史数据全量迁移方案（本期以 2026 年起统计口径描述为准，上线以数据准备结果为准）。

---

## 二、谁在用、用来干什么

### 2.1 用户角色

| 角色 | 典型诉求 |
|------|----------|
| **采购人员** | 按站点查看氢费与支付进度，核对当前余额、欠费站点 |
| **财务人员** | 核对应付/实付/未付/已开票，查看付款证明与发票附件 |
| **运营/主管** | 按地区、结算方式浏览整体规模与异常站点 |

### 2.2 核心使用场景

1. **日常巡检**：按地区或结算方式筛选，查看顶部合计与列表，关注未付、已欠费站点。  
2. **站点下钻**：点击加氢总量、应付总金额等，打开明细弹窗核对构成。  
3. **付款与发票核查**：从已付总金额、已开票金额钻取，预览付款凭据或发票。  
4. **导出报送**：按当前筛选结果导出 CSV。

---

## 三、页面功能说明

### 3.1 页面组成

路径：**台账数据 → 氢费（采购端）汇总报表**

自上而下：

1. **查询条件区** — 地区、加氢站全称、结算方式  
2. **汇总列表区** — 标题、导出、筛选摘要、顶部合计条、站点表格  
3. **弹窗** — 需求说明、各类钻取明细、附件预览  

面包屑行右上角提供 **「查看需求说明」**（本文档）；汇总列表标题右侧提供 **「导出」**。

### 3.2 查询条件

| 查询项 | 业务说明 |
|--------|----------|
| 地区 | 加氢站所属省/市，支持搜索；空为全部 |
| 加氢站全称 | 从加氢站主数据选择；空为全部 |
| 结算方式 | 预付 / 月结；空为全部 |

**交互：** 修改条件后点击 **「查询」** 生效；**「重置」** 清空条件。查询成功给予简短提示。列表上方展示当前筛选摘要（地区、加氢站、结算方式）。

### 3.3 顶部合计条

表格上方独立展示（随当前列表筛选结果汇总）：

| 合计项 | 计算口径 |
|--------|----------|
| 加氢总量(kg) | 列表各行加氢总量之和 |
| 应付总金额(元) | 列表各行应付总金额之和 |
| 已付总金额(元) | 列表各行已付总金额之和 |
| 未付总金额(元) | **应付总金额合计 − 已付总金额合计**；大于 0 时红色显示 |
| 未开票总金额(元) | **应付总金额合计 − 已开票总金额合计**；大于 0 时红色显示 |
| 充值总额(元) | 列表各行充值总额之和 |
| 当前总余额(元) | 列表各行当前余额之和；合计为负时红色显示 |

### 3.4 汇总列表字段

**列顺序（左→右）：**  
序号 → 地区 → 加氢站全称 → 结算方式 → 加氢总量(kg) → 应付总金额(元) → 已付总金额(元) → 未付总金额(元) → 已开票金额(元) → 未开票金额(元) → 充值总额(元) → 当前余额(元)

**表头列宽：** 支持鼠标拖动表头右侧调整列宽（最小宽度限制），便于长站名与金额列阅读。

| 字段 | 业务口径 | 交互 |
|------|----------|------|
| 结算方式 | 预付 / 月结 | 只读 |
| 加氢总量(kg) | 自 **2026 年起** 该站全部氢费加氢量之和 | 点击钻取 **加氢量明细**（仅加氢量，不含金额） |
| 应付总金额(元) | 该站「车辆氢费明细」**加氢总价(元)** 求和 | 点击钻取明细（加氢量、成本单价、成本总价） |
| 已付总金额(元) | 加氢站打款管理中 **已支付金额** 求和 | 点击钻取支付账单明细 |
| 未付总金额(元) | **应付总金额 − 已付总金额**（行内计算） | 只读；大于 0 红色 |
| 已开票金额(元) | 该站已开票金额合计 | 点击钻取开票记录 |
| 未开票金额(元) | **应付总金额 − 已开票金额**（行内计算） | 只读；大于 0 红色 |
| 充值总额(元) | 该站预充值（打款入账）金额合计 | 点击钻取充值明细 |
| 当前余额(元) | 2026 年期初余额，扣减 2025 年及以前未扣款记录后的实时余额 | 点击钻取余额变更明细；**为负** 时金额红色 + 左侧 **「已欠费」** 标签 |

### 3.5 钻取明细说明

#### （1）加氢量明细（由加氢总量进入）

| 列 | 说明 |
|----|------|
| 序号、加氢时间、订单编号、车牌号、加氢量(kg) | 来源于车辆氢费明细，按当前加氢站筛选 |
| 合计 | 加氢量合计 |

#### （2）应付总金额明细

| 列 | 说明 |
|----|------|
| 序号、加氢时间、订单编号、车牌号、加氢量(kg)、成本单价(元/kg)、成本总价(元) | 按站筛选的车辆氢费明细 |
| 合计 | 加氢量、成本总价；弹窗标题含站名 |

#### （3）已付总金额明细（由已付总金额进入）

| 列 | 说明 |
|----|------|
| 加氢站全称、账单开始时间、账单结束时间、应付总金额(元)、已付总金额(元)、银行付款证明 | 按账单维度展示 |
| 银行付款证明 | **查看付款凭据** — 预览付款证明图片 |
| 合计 | 应付、实付合计 |

#### （4）已开票明细（由已开票金额进入）

| 列 | 说明 |
|----|------|
| 加氢站全称、开票时间、开票金额(元)、发票 | |
| 发票 | **查看发票** — 在线预览 PDF/图片；**下载发票** — 下载 PDF/图片文件 |
| 合计 | 开票金额合计 |

#### （5）充值总额明细（由充值总额进入）

| 列 | 说明 |
|----|------|
| 加氢站全称、支付时间、预充金额(元)、付款凭证 | 支付时间为 **YYYY-MM-DD** |
| 付款凭证 | **预览** — 在线查看；**下载** — 下载凭证文件 |
| 合计 | 预充金额（充值总额）合计 |

#### （6）余额变更明细（由当前余额进入）

| 列 | 说明 |
|----|------|
| 加氢站全称、收入金额(元)、支出金额(元)、余额(元)、订单编号 | 收入/支出为空显示「—」；余额为负红色 |
| 合计 | 收入合计、支出合计、末行余额（与列表该行当前余额一致） |

### 3.6 附件预览

- 付款凭据、发票在弹窗中预览；PDF 使用文档预览，图片直接展示。  
- 发票支持下载，文件名与开票记录一致。

### 3.7 导出

- 点击 **「导出」** 下载当前筛选结果 CSV（含列表字段及合计行）。  
- 编码 UTF-8（带 BOM），便于 Excel 打开。

---

## 四、业务规则摘要

| 规则 | 说明 |
|------|------|
| 统计起点 | 加氢总量等业务口径默认 **2026 年起**（与车辆氢费明细、主数据生效规则一致） |
| 未付（行） | 应付总金额 − 已付总金额 |
| 未付（合计条） | 各站未付之和，等价于应付合计 − 已付合计 |
| 未开票（行） | 应付总金额 − 已开票金额 |
| 未开票（合计条） | 各站未开票之和，等价于应付合计 − 已开票合计 |
| 已欠费 | 仅 **当前余额 < 0** 时展示标签 |
| 钻取范围 | 均限定为 **当前汇总行对应加氢站** |

---

## 五、验收要点（业务）

1. 查询、重置、筛选摘要、合计条与列表数据一致。  
2. 各可点击金额/加氢量钻取弹窗字段与上文一致，合计正确。  
3. 未付、已欠费展示规则符合第四节。  
4. 付款凭据可预览；发票可预览与下载。  
5. 列宽可拖动；导出字段完整。  
6. 「查看需求说明」可打开本 PRD 全文。

---

**文档结束**