# 加氢站管理 · 站点信息 — 产品需求文档（PRD）

| 项 | 内容 |
|---|---|
| 文档版本 | v1.0 |
| 模块名称 | 加氢站管理 → 站点信息 |
| 所属系统 | ONE-OS Web 端 |
| 目标读者 | 前端 / 后端 / 测试 / 业务产品对接人 |
| 交互原型 | `/prototypes/oneos-web-h2-station-site` |
| 关联原型 | [车辆氢费明细](/prototypes/vehicle-h2-fee-ledger)、[加氢站合包](/prototypes/oneos-web-h2-station) |
| 文档状态 | 已对齐原型 |

---

## 1. 背景与目标

### 1.1 业务背景

加氢站是氢费成本结算的关键节点。运营侧需要维护站点主数据（签约、营业、成本价、预付余额），并在财务周期内按站点与加氢站完成对账、收票与付款闭环。

### 1.2 本期目标

- 站点台账的查询、新建、编辑、查看、删除与批量导入
- 营业状态、成本价格、预付余额等运营配置
- **按站点生成氢费对账单 → 填写收票信息 → 提交结算**，并与「车辆氢费明细」联动回写

### 1.3 用户角色

| 角色 | 典型诉求 |
|---|---|
| 加氢站运营 | 维护站点资料、营业与价格；查看加氢量与余额 |
| 财务/结算 | 按周期生成对账单、登记收票、完成站点付款闭环 |
| 管理员 | 批量导入站点、删除无效站点、配置系统账号 |

### 1.4 非目标（本期不做）

- 对账单审批流、ERP 自动过账
- 发票 OCR 识别与验真
- 加氢订单、加氢记录（仍在合包 `oneos-web-h2-station`）
- 后端接口联调（原型使用 Mock + 共享 Store）

---

## 2. 信息架构

```text
站点信息
├── 列表页
│   ├── 筛选区（4 项）
│   ├── KPI 卡片（6 张）
│   ├── 工具栏
│   └── 站点台账表 + 分页
├── 新建 / 编辑（同页内嵌视图）
│   ├── 基本信息
│   ├── 系统账号绑定
│   └── 供应商 / 付款信息
└── 弹窗 / 抽屉
    ├── 查看详情
    ├── 营业状态 / 价格配置
    ├── 加氢量下钻 / 预付余额下钻
    ├── 生成对账单（两阶段）
    └── 查看对账记录
```

---

## 3. 列表与 KPI

> 详见 `.spec/requirements-prd-list.md`

- 筛选：名称、签约、地区、营业状态
- KPI：全部 / 签约·普通 / 高频≥3 / 低频1–2 / 无加氢0
- 列表字段：名称地址、合作时间、营业、成本价、加氢次数/量、预付余额、联系方式、操作
- 设计规范：与租赁合同管理一致的 vm 布局与 Inter 字体

---

## 4. 站点主数据

### 4.1 新建站点

同页内嵌视图：基本信息、系统账号绑定（可选）、供应商信息（新建或关联）。

### 4.2 编辑 / 查看

| 模式 | 交互 |
|---|---|
| 编辑 | 整页表单；系统账号仅 admin 可改 |
| 查看 | 弹窗分块展示站点、账号、供应商、付款信息 |

### 4.3 批量导入

下载 CSV 模板 → 上传 → 解析预览 → 确认导入；站点名称不可重复。

---

## 5. 运营配置

### 5.1 营业状态

卡片式弹窗：营业状态、营业时间按钮组；非全天须配置时段；展示状态变更记录。

### 5.2 价格配置

配置成本价格（元/kg）与生效时间；到达生效时间后刷新列表「当前成本价格」；展示价格调整记录。

### 5.3 下钻分析

- **加氢量下钻**：统计卡 + 明细表 + 导出，字段对齐车辆氢费明细
- **预付余额下钻**：充值/加氢流水 + 趋势图 + 导出

---

## 6. 对账与结算（重点）

> 详见 `.spec/requirements-prd-statement.md`

与「车辆氢费明细」配合完成站点侧氢费结算闭环：

1. 拉取已对账且未结算的记录
2. 两阶段：选期生成 → 填收票提交
3. 提交后更新预付余额、写对账历史、回写台账（对账日期、收票日期、已付款）

---

## 7. 数据与集成

| 能力 | 实现 |
|---|---|
| 氢费明细 | `src/common/h2VehicleLedgerBridge.js` |
| 对账回写 | `H2_STATION_STATEMENT_LEDGER_UPDATES` |
| 页面实现 | `src/prototypes/oneos-web-h2-station/pages/03-站点信息.jsx` |
| 独立入口 | `src/prototypes/oneos-web-h2-station-site/index.tsx` |

---

## 8. 验收标准

### 8.1 列表页

- [ ] 筛选与 KPI 六卡片联动正确
- [ ] 高频/低频/无加氢口径与车辆氢费明细一致
- [ ] 加氢量、预付余额下钻数据来自共享 Store
- [ ] 布局与租赁合同 vm 规范一致

### 8.2 对账流程

- [ ] 仅已对账未结算记录可进入对账单
- [ ] 两阶段交互与必填校验完整
- [ ] 提交后回写车辆氢费明细可跨页验收

### 8.3 标注与文档

- [ ] `@axhub/annotation` 已接入，关键区域有 `data-annotation-id`
- [ ] 右侧工具栏目录可阅 PRD 全文与页面标注

---

## 9. 修订记录

| 版本 | 日期 | 说明 |
|---|---|---|
| v1.0 | 2026-07-01 | 独立入口、vm 规范对齐、标注目录与 PRD 接入 |
