feat(web): 同步 web 端目录更新至 Gitea

包含加氢站站点信息、运维交车/故障、台账与数据分析等页面新增与改动。

Co-authored-by: Cursor <cursoragent@cursor.com>

web端/台账数据/氢费采购端汇总报表-需求文档.md

@@ -0,0 +1,199 @@
+# 氢费（采购端）汇总报表 — 产品需求说明（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 全文。
+
+---
+
+**文档结束**