Files
ONE-OS/web端/台账数据/氢费采购端汇总报表-需求文档.md
王冕 d432d51eed feat(web): 同步 web 端目录更新至 Gitea
包含加氢站站点信息、运维交车/故障、台账与数据分析等页面新增与改动。

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-06-04 19:57:30 +08:00

8.6 KiB
Raw Blame History

氢费(采购端)汇总报表 — 产品需求说明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 全文。

文档结束