# 加氢站管理 · 站点信息 — 列表页 PRD

| 项 | 说明 |
|---|---|
| 模块名称 | 加氢站管理 → 站点信息 |
| 所属系统 | ONE-OS Web 端 |
| 目标用户 | 加氢站运营、财务结算、平台管理员 |
| 核心任务 | 查询站点台账、维护主数据、查看运营指标、发起对账与充值 |
| 交互原型 | `/prototypes/oneos-web-h2-station-site` |
| 设计规范 | 与租赁合同管理一致的 vm 布局（筛选 / KPI / 表格 / 分页） |

---

## 1. 页面结构

用户进入「加氢站管理 → 站点信息」后，列表页自上而下为：

1. **筛选区** — 名称、签约、地区、营业状态
2. **KPI 分类** — 全部 / 签约·普通 / 高频 / 低频 / 无加氢
3. **工具栏** — 全站余额提醒、批量导入、发起充值单、新建站点
4. **站点列表** — 主数据 + 运营指标 + 操作列
5. **分页栏** — 每页 5/10/20/50 条

---

## 2. 筛选区

与租赁合同等模块一致的 **vm 筛选卡片** 布局：标题「筛选条件」+ 4 列栅格（标签在上、控件在下）；底部分隔线 + 右对齐「重置」「查询」。

| 字段 | 控件 | 说明 |
|---|---|---|
| 加氢站名称 | 输入框 | 模糊匹配，支持回车查询 |
| 是否签约 | 下拉 | 签约站点 / 普通站点 |
| 地区(省-市) | 级联 | 省、市两级，可只选省 |
| 营业状态 | 下拉 | 营业中 / 暂停营业 / 停止营业 |

**交互**：

- **查询**：写入「已应用筛选」，列表与 KPI 统计联动，回到第 1 页
- **重置**：清空筛选条件并刷新列表

---

## 3. KPI 统计卡片

与租赁合同一致的 **vm-kpi-card**：左侧图标 + 标题 + 数值，右上角 `?` 悬停说明，选中态绿色描边。

| 卡片 | 口径 |
|---|---|
| 全部加氢站 | 列表全部站点 |
| 签约站点 | 已签约，点击快捷筛选 |
| 普通站点 | 未签约，点击快捷筛选 |
| 高频加氢站 | 该站加氢次数 ≥ 3 |
| 低频加氢站 | 有加氢但次数 < 3 |
| 无加氢站点 | 加氢次数 = 0 |

加氢次数来自「车辆氢费明细」共享 Store，按站点名称聚合。KPI 与筛选区签约条件互斥切换（点 KPI 分类会清除签约筛选，点签约卡会重置 KPI 为全部）。

---

## 4. 列表工具栏

| 按钮 | 行为 |
|---|---|
| 全站余额提醒设置 | 配置全局预付余额预警阈值 |
| 批量导入 | 下载模板 → 上传 CSV/Excel → 预览确认导入 |
| 发起充值单 | 为站点发起预付充值流程（原型演示） |
| 新建站点 | 进入同页内嵌新建视图 |

---

## 5. 列表字段说明

| 字段 | 说明 |
|---|---|
| 加氢站名称 | 含签约标签；下一行展示省市区 + 详细地址 |
| 合作时间 | 未签约可空 |
| 营业状态 / 营业时间 | 列表只读；在「更多 → 营业状态」维护 |
| 当前成本价格 | 元/kg；受价格配置生效时间驱动；多价时展示警示 |
| 加氢次数 / 加氢量 | 加氢量可点击下钻；表头支持排序 |
| 预付余额 | 可点击下钻流水；负值标红并显示「已欠费」 |
| 联系方式 | 联系人 + 电话 |
| 操作 | 查看 + 更多菜单 |

**更多菜单**：编辑、删除、营业状态、价格配置、生成对账单、查看对账记录等（按状态与权限显隐）。

**分页**：默认 10 条，可选 5/10/20/50。

---

## 6. 数据来源

- 氢费/加氢明细：统一来自 `src/common/h2VehicleLedgerBridge.js`，与「车辆氢费明细」共享 Store
- 先打开「车辆氢费明细」时台账全量同步；仅打开加氢站模块时使用 canonical seed
- 对账单提交经 `H2_STATION_STATEMENT_LEDGER_UPDATES` 回写车辆氢费明细

---

## 7. 双入口说明

| 入口 | 路径 |
|---|---|
| 独立原型（本页） | OneOS → 加氢站管理 → 站点信息 |
| 合包 | ONE-OS Web 端 → 加氢站管理 → 加氢订单 / 加氢记录 |
