f5e31268dc
- 租赁业务台账：空值留白、排序/列宽拖拽、操作列与交互优化 - 租赁合同：列表展开列合并、在租明细弹窗、编辑回填与样式修复 - 加氢站：新增站点信息独立原型，订单/记录页与共享样式调整 - 车辆氢费明细对接 h2VehicleLedgerBridge；移除 vehicle-management-clay - 同步 sidebar-tree 与标注提取 output Co-authored-by: Cursor <cursoragent@cursor.com>
340 lines
32 KiB
JSON
340 lines
32 KiB
JSON
{
|
||
"title": "站点信息 - 原型预览（开发）",
|
||
"errors": [
|
||
"Warning: [antd: Tag] `bordered={false}` is deprecated. Please use `variant=\"filled\"` instead.",
|
||
"Warning: [antd: Modal] `destroyOnClose` is deprecated. Please use `destroyOnHidden` instead."
|
||
],
|
||
"source": {
|
||
"directory": {
|
||
"nodes": [
|
||
{
|
||
"type": "folder",
|
||
"id": "oneos-project-nav",
|
||
"title": "ONE-OS 原型导航",
|
||
"defaultExpanded": true,
|
||
"children": [
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-lease-business-ledger",
|
||
"title": "租赁业务台账",
|
||
"href": "/prototypes/lease-business-ledger",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-vehicle-h2-fee-ledger",
|
||
"title": "车辆氢费明细",
|
||
"href": "/prototypes/vehicle-h2-fee-ledger",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-self-operated-business-ledger",
|
||
"title": "自营业务台账",
|
||
"href": "/prototypes/self-operated-business-ledger",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "folder",
|
||
"id": "nav-folder-prototypes-oneos-web",
|
||
"title": "ONE-OS Web 端",
|
||
"defaultExpanded": true,
|
||
"children": [
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-workbench",
|
||
"title": "工作台",
|
||
"href": "/prototypes/oneos-web-workbench",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-login",
|
||
"title": "登录",
|
||
"href": "/prototypes/oneos-web-login",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-vehicle-asset",
|
||
"title": "车辆管理",
|
||
"href": "/prototypes/oneos-web-vehicle-asset",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-contract-template",
|
||
"title": "合同模板管理",
|
||
"href": "/prototypes/oneos-web-contract-template",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-help-center",
|
||
"title": "帮助中心",
|
||
"href": "/prototypes/oneos-web-help-center",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-finance",
|
||
"title": "财务管理",
|
||
"href": "/prototypes/oneos-web-finance",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-procurement",
|
||
"title": "采购管理",
|
||
"href": "/prototypes/oneos-web-procurement",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-lease-contract",
|
||
"title": "车辆租赁合同",
|
||
"href": "/prototypes/oneos-web-lease-contract",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-h2-station",
|
||
"title": "加氢站管理",
|
||
"href": "/prototypes/oneos-web-h2-station",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-data-analysis",
|
||
"title": "数据分析",
|
||
"href": "/prototypes/oneos-web-data-analysis",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-ledger-data",
|
||
"title": "台账数据",
|
||
"href": "/prototypes/oneos-web-ledger-data",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-business",
|
||
"title": "业务管理",
|
||
"href": "/prototypes/oneos-web-business",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-ops",
|
||
"title": "运维管理",
|
||
"href": "/prototypes/oneos-web-ops",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "nav-link-oneos-web-requirements",
|
||
"title": "需求说明",
|
||
"href": "/prototypes/oneos-web-requirements",
|
||
"target": "self"
|
||
}
|
||
]
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"type": "folder",
|
||
"id": "h2-site-doc-root",
|
||
"title": "站点信息说明",
|
||
"defaultExpanded": true,
|
||
"children": [
|
||
{
|
||
"type": "markdown",
|
||
"id": "h2-site-doc-overview",
|
||
"title": "模块总览",
|
||
"markdown": "## 1. 模块定位\n\n| 项 | 说明 |\n|---|---|\n| 模块 | 加氢站管理 → 站点信息 |\n| 用户 | 运营、财务结算、管理员 |\n| 核心任务 | 站点主数据、运营配置、氢费对账结算 |\n| 页面结构 | 筛选 + KPI + 工具栏 + 列表 + 分页 |\n\n## 2. 关联模块\n\n- **车辆氢费明细**：氢费数据来源与对账回写目标\n- **加氢站合包**：加氢订单、加氢记录仍在合包入口\n\n## 3. 验收重点\n\n1. KPI 高频/低频/无加氢与氢费明细一致\n2. 对账单两阶段流程与跨页回写\n3. 列表布局与租赁合同 vm 规范一致"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "h2-site-link-vh2",
|
||
"title": "车辆氢费明细",
|
||
"href": "../vehicle-h2-fee-ledger/index.html",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "link",
|
||
"id": "h2-site-link-bundle",
|
||
"title": "加氢站管理（合包）",
|
||
"href": "../oneos-web-h2-station/index.html",
|
||
"target": "self"
|
||
},
|
||
{
|
||
"type": "folder",
|
||
"id": "h2-site-doc-prd",
|
||
"title": "PRD 全文",
|
||
"defaultExpanded": true,
|
||
"children": [
|
||
{
|
||
"type": "markdown",
|
||
"id": "h2-site-doc-prd-full",
|
||
"title": "PRD 完整文档",
|
||
"markdown": "# 加氢站管理 · 站点信息 — 产品需求文档（PRD）\n\n| 项 | 内容 |\n|---|---|\n| 文档版本 | v1.0 |\n| 模块名称 | 加氢站管理 → 站点信息 |\n| 所属系统 | ONE-OS Web 端 |\n| 目标读者 | 前端 / 后端 / 测试 / 业务产品对接人 |\n| 交互原型 | `/prototypes/oneos-web-h2-station-site` |\n| 关联原型 | [车辆氢费明细](/prototypes/vehicle-h2-fee-ledger)、[加氢站合包](/prototypes/oneos-web-h2-station) |\n| 文档状态 | 已对齐原型 |\n\n---\n\n## 1. 背景与目标\n\n### 1.1 业务背景\n\n加氢站是氢费成本结算的关键节点。运营侧需要维护站点主数据（签约、营业、成本价、预付余额），并在财务周期内按站点与加氢站完成对账、收票与付款闭环。\n\n### 1.2 本期目标\n\n- 站点台账的查询、新建、编辑、查看、删除与批量导入\n- 营业状态、成本价格、预付余额等运营配置\n- **按站点生成氢费对账单 → 填写收票信息 → 提交结算**，并与「车辆氢费明细」联动回写\n\n### 1.3 用户角色\n\n| 角色 | 典型诉求 |\n|---|---|\n| 加氢站运营 | 维护站点资料、营业与价格；查看加氢量与余额 |\n| 财务/结算 | 按周期生成对账单、登记收票、完成站点付款闭环 |\n| 管理员 | 批量导入站点、删除无效站点、配置系统账号 |\n\n### 1.4 非目标（本期不做）\n\n- 对账单审批流、ERP 自动过账\n- 发票 OCR 识别与验真\n- 加氢订单、加氢记录（仍在合包 `oneos-web-h2-station`）\n- 后端接口联调（原型使用 Mock + 共享 Store）\n\n---\n\n## 2. 信息架构\n\n```text\n站点信息\n├── 列表页\n│ ├── 筛选区（4 项）\n│ ├── KPI 卡片（6 张）\n│ ├── 工具栏\n│ └── 站点台账表 + 分页\n├── 新建 / 编辑（同页内嵌视图）\n│ ├── 基本信息\n│ ├── 系统账号绑定\n│ └── 供应商 / 付款信息\n└── 弹窗 / 抽屉\n ├── 查看详情\n ├── 营业状态 / 价格配置\n ├── 加氢量下钻 / 预付余额下钻\n ├── 生成对账单（两阶段）\n └── 查看对账记录\n```\n\n---\n\n## 3. 列表与 KPI\n\n> 详见 `.spec/requirements-prd-list.md`\n\n- 筛选：名称、签约、地区、营业状态\n- KPI：全部 / 签约·普通 / 高频≥3 / 低频1–2 / 无加氢0\n- 列表字段：名称地址、合作时间、营业、成本价、加氢次数/量、预付余额、联系方式、操作\n- 设计规范：与租赁合同管理一致的 vm 布局与 Inter 字体\n\n---\n\n## 4. 站点主数据\n\n### 4.1 新建站点\n\n同页内嵌视图：基本信息、系统账号绑定（可选）、供应商信息（新建或关联）。\n\n### 4.2 编辑 / 查看\n\n| 模式 | 交互 |\n|---|---|\n| 编辑 | 整页表单；系统账号仅 admin 可改 |\n| 查看 | 弹窗分块展示站点、账号、供应商、付款信息 |\n\n### 4.3 批量导入\n\n下载 CSV 模板 → 上传 → 解析预览 → 确认导入；站点名称不可重复。\n\n---\n\n## 5. 运营配置\n\n### 5.1 营业状态\n\n卡片式弹窗：营业状态、营业时间按钮组；非全天须配置时段；展示状态变更记录。\n\n### 5.2 价格配置\n\n配置成本价格（元/kg）与生效时间；到达生效时间后刷新列表「当前成本价格」；展示价格调整记录。\n\n### 5.3 下钻分析\n\n- **加氢量下钻**：统计卡 + 明细表 + 导出，字段对齐车辆氢费明细\n- **预付余额下钻**：充值/加氢流水 + 趋势图 + 导出\n\n---\n\n## 6. 对账与结算（重点）\n\n> 详见 `.spec/requirements-prd-statement.md`\n\n与「车辆氢费明细」配合完成站点侧氢费结算闭环：\n\n1. 拉取已对账且未结算的记录\n2. 两阶段：选期生成 → 填收票提交\n3. 提交后更新预付余额、写对账历史、回写台账（对账日期、收票日期、已付款）\n\n---\n\n## 7. 数据与集成\n\n| 能力 | 实现 |\n|---|---|\n| 氢费明细 | `src/common/h2VehicleLedgerBridge.js` |\n| 对账回写 | `H2_STATION_STATEMENT_LEDGER_UPDATES` |\n| 页面实现 | `src/prototypes/oneos-web-h2-station/pages/03-站点信息.jsx` |\n| 独立入口 | `src/prototypes/oneos-web-h2-station-site/index.tsx` |\n\n---\n\n## 8. 验收标准\n\n### 8.1 列表页\n\n- [ ] 筛选与 KPI 六卡片联动正确\n- [ ] 高频/低频/无加氢口径与车辆氢费明细一致\n- [ ] 加氢量、预付余额下钻数据来自共享 Store\n- [ ] 布局与租赁合同 vm 规范一致\n\n### 8.2 对账流程\n\n- [ ] 仅已对账未结算记录可进入对账单\n- [ ] 两阶段交互与必填校验完整\n- [ ] 提交后回写车辆氢费明细可跨页验收\n\n### 8.3 标注与文档\n\n- [ ] `@axhub/annotation` 已接入，关键区域有 `data-annotation-id`\n- [ ] 右侧工具栏目录可阅 PRD 全文与页面标注\n\n---\n\n## 9. 修订记录\n\n| 版本 | 日期 | 说明 |\n|---|---|---|\n| v1.0 | 2026-07-01 | 独立入口、vm 规范对齐、标注目录与 PRD 接入 |\n",
|
||
"markdownPath": "src/prototypes/oneos-web-h2-station-site/.spec/requirements-prd.md"
|
||
},
|
||
{
|
||
"type": "markdown",
|
||
"id": "h2-site-doc-prd-list",
|
||
"title": "列表页 PRD",
|
||
"markdown": "# 加氢站管理 · 站点信息 — 列表页 PRD\n\n| 项 | 说明 |\n|---|---|\n| 模块名称 | 加氢站管理 → 站点信息 |\n| 所属系统 | ONE-OS Web 端 |\n| 目标用户 | 加氢站运营、财务结算、平台管理员 |\n| 核心任务 | 查询站点台账、维护主数据、查看运营指标、发起对账与充值 |\n| 交互原型 | `/prototypes/oneos-web-h2-station-site` |\n| 设计规范 | 与租赁合同管理一致的 vm 布局（筛选 / KPI / 表格 / 分页） |\n\n---\n\n## 1. 页面结构\n\n用户进入「加氢站管理 → 站点信息」后，列表页自上而下为：\n\n1. **筛选区** — 名称、签约、地区、营业状态\n2. **KPI 分类** — 全部 / 签约·普通 / 高频 / 低频 / 无加氢\n3. **工具栏** — 全站余额提醒、批量导入、发起充值单、新建站点\n4. **站点列表** — 主数据 + 运营指标 + 操作列\n5. **分页栏** — 每页 5/10/20/50 条\n\n---\n\n## 2. 筛选区\n\n与租赁合同等模块一致的 **vm 筛选卡片** 布局：标题「筛选条件」+ 4 列栅格（标签在上、控件在下）；底部分隔线 + 右对齐「重置」「查询」。\n\n| 字段 | 控件 | 说明 |\n|---|---|---|\n| 加氢站名称 | 输入框 | 模糊匹配，支持回车查询 |\n| 是否签约 | 下拉 | 签约站点 / 普通站点 |\n| 地区(省-市) | 级联 | 省、市两级，可只选省 |\n| 营业状态 | 下拉 | 营业中 / 暂停营业 / 停止营业 |\n\n**交互**：\n\n- **查询**：写入「已应用筛选」，列表与 KPI 统计联动，回到第 1 页\n- **重置**：清空筛选条件并刷新列表\n\n---\n\n## 3. KPI 统计卡片\n\n与租赁合同一致的 **vm-kpi-card**：左侧图标 + 标题 + 数值，右上角 `?` 悬停说明，选中态绿色描边。\n\n| 卡片 | 口径 |\n|---|---|\n| 全部加氢站 | 列表全部站点 |\n| 签约站点 | 已签约，点击快捷筛选 |\n| 普通站点 | 未签约，点击快捷筛选 |\n| 高频加氢站 | 该站加氢次数 ≥ 3 |\n| 低频加氢站 | 有加氢但次数 < 3 |\n| 无加氢站点 | 加氢次数 = 0 |\n\n加氢次数来自「车辆氢费明细」共享 Store，按站点名称聚合。KPI 与筛选区签约条件互斥切换（点 KPI 分类会清除签约筛选，点签约卡会重置 KPI 为全部）。\n\n---\n\n## 4. 列表工具栏\n\n| 按钮 | 行为 |\n|---|---|\n| 全站余额提醒设置 | 配置全局预付余额预警阈值 |\n| 批量导入 | 下载模板 → 上传 CSV/Excel → 预览确认导入 |\n| 发起充值单 | 为站点发起预付充值流程（原型演示） |\n| 新建站点 | 进入同页内嵌新建视图 |\n\n---\n\n## 5. 列表字段说明\n\n| 字段 | 说明 |\n|---|---|\n| 加氢站名称 | 含签约标签；下一行展示省市区 + 详细地址 |\n| 合作时间 | 未签约可空 |\n| 营业状态 / 营业时间 | 列表只读；在「更多 → 营业状态」维护 |\n| 当前成本价格 | 元/kg；受价格配置生效时间驱动；多价时展示警示 |\n| 加氢次数 / 加氢量 | 加氢量可点击下钻；表头支持排序 |\n| 预付余额 | 可点击下钻流水；负值标红并显示「已欠费」 |\n| 联系方式 | 联系人 + 电话 |\n| 操作 | 查看 + 更多菜单 |\n\n**更多菜单**：编辑、删除、营业状态、价格配置、生成对账单、查看对账记录等（按状态与权限显隐）。\n\n**分页**：默认 10 条，可选 5/10/20/50。\n\n---\n\n## 6. 数据来源\n\n- 氢费/加氢明细：统一来自 `src/common/h2VehicleLedgerBridge.js`，与「车辆氢费明细」共享 Store\n- 先打开「车辆氢费明细」时台账全量同步；仅打开加氢站模块时使用 canonical seed\n- 对账单提交经 `H2_STATION_STATEMENT_LEDGER_UPDATES` 回写车辆氢费明细\n\n---\n\n## 7. 双入口说明\n\n| 入口 | 路径 |\n|---|---|\n| 独立原型（本页） | OneOS → 加氢站管理 → 站点信息 |\n| 合包 | ONE-OS Web 端 → 加氢站管理 → 加氢订单 / 加氢记录 |\n",
|
||
"markdownPath": "src/prototypes/oneos-web-h2-station-site/.spec/requirements-prd-list.md"
|
||
},
|
||
{
|
||
"type": "markdown",
|
||
"id": "h2-site-doc-prd-statement",
|
||
"title": "对账与结算 PRD",
|
||
"markdown": "# 加氢站管理 · 站点信息 — 对账与结算 PRD\n\n> 本模块与「车辆氢费明细」配合完成**站点侧氢费结算闭环**。\n\n---\n\n## 1. 数据来源\n\n对账单明细取自 **车辆氢费明细** 中同时满足以下条件的记录：\n\n1. 对账状态 = **已对账**（台账已完成「完成对账」）\n2. **尚未**被本站点历史对账单结算过（未绑定 `statementRecordId`）\n3. 加氢时间落在用户选择的 **[账单开始日期, 账单结束日期]** 内\n4. 加氢站名称与当前操作站点一致\n\n> 对账单明细**仅展示成本字段**（加氢量、成本单价、成本总价等），不展示加氢单价、加氢总价。\n\n---\n\n## 2. 两阶段交互\n\n**阶段一 · 选期生成**\n\n- 日期区下方展示：**上次对账单结束时间**（无历史则「暂无」）\n- 默认开始日期建议 = 上次结束日 + 1 天\n- 点击「生成对账单」后进入阶段二，日期锁定不可改\n- 无符合条件记录时提示调整日期\n\n**阶段二 · 结算提交**\n\n统计卡（明细表上方）：\n\n| 指标 | 说明 |\n|---|---|\n| 加氢次数 | 本账单包含的已对账记录笔数 |\n| 加氢总量 | kg 合计 |\n| 成本总金额 | 成本总价合计 |\n\n明细表下方**必填**结算项：\n\n| 字段 | 规则 |\n|---|---|\n| 结算后加氢站预付款余额 | **只读**，= 当前预付余额 − 成本总金额；不足为负并标「已欠费」 |\n| 收票日期 | 必填 |\n| 收票金额 | 必填，默认填入成本总金额 |\n| 发票附件 | 必填，支持上传 |\n\n---\n\n## 3. 提交后的系统行为\n\n提交成功后需**原子性**完成：\n\n1. 写入对账历史（供「查看对账记录」查询）\n2. 扣减站点预付余额\n3. 标记台账记录已结算（绑定 `statementRecordId`）\n4. **回写车辆氢费明细**：\n\n| 车辆氢费明细字段 | 回写值 |\n|---|---|\n| 对账日期 | 操作完成时间 |\n| 收票日期 | 操作完成日期 |\n| 加氢站付款状态 | 已付款 |\n\n原型通过 `H2_STATION_STATEMENT_LEDGER_UPDATES` / `h2VehicleLedgerBridge` 模拟跨页回写。\n\n---\n\n## 4. 查看对账记录\n\n入口：列表操作列 → 更多 → **查看对账记录**\n\n历史列表：对账日期、对账人、账单区间、加氢次数、加氢金额、结算后余额、查看明细。\n\n查看明细：账单区间、统计三卡、收票信息、发票附件、成本明细表。\n\n---\n\n## 5. 校验与异常\n\n| 场景 | 处理 |\n|---|---|\n| 日期未填 / 开始晚于结束 | 阻止生成 |\n| 区间内无已对账未结算记录 | 阻止生成，提示调整日期 |\n| 收票日期/金额/附件未填 | 阻止提交 |\n| 收票金额 ≤ 0 | 阻止提交 |\n| 预付余额结算后为负 | 允许提交，标「已欠费」 |\n\n---\n\n## 6. 研发要点\n\n1. **对账单幂等**：同一笔已对账记录只能进入一次成功提交的对账单\n2. **上次结束时间**：取该站点已成功提交对账单的最大 `endDate`\n3. **余额计算**：`balanceAfter = prepaidBalance - sum(costTotal)`\n4. **跨模块同步**：生产对接统一台账；原型使用 Bridge Store\n5. **明细字段范围**：对账弹窗不展示客户侧加氢单价/总价\n",
|
||
"markdownPath": "src/prototypes/oneos-web-h2-station-site/.spec/requirements-prd-statement.md"
|
||
},
|
||
{
|
||
"type": "markdown",
|
||
"id": "h2-site-doc-scope",
|
||
"title": "范围与决策",
|
||
"markdown": "# 站点信息独立原型 — 范围与决策\n\n## 背景\n\n「站点信息」从 ONE-OS Web 合包 `oneos-web-h2-station` 拆出，作为 OneOS → 加氢站管理下的独立 Axhub 入口，便于与正式菜单路径对齐。\n\n## 范围\n\n| 包含 | 不包含 |\n|------|--------|\n| 站点列表、KPI、新建/编辑/查看/删除 | 加氢订单、加氢记录（仍在合包） |\n| 营业状态、价格配置、余额下钻 | 后端接口联调 |\n| 两阶段对账单、充值单、批量导入 | |\n\n## 数据来源\n\n- **氢费/加氢明细**：统一来自 `src/common/h2VehicleLedgerBridge.js`，与「车辆氢费明细」原型共享 Store。\n- 先打开「车辆氢费明细」时，台账全量行会同步至 Store；仅打开加氢站模块时使用 canonical seed（10 条演示数据）。\n- 对账单提交 patch 经 `window.H2_STATION_STATEMENT_LEDGER_UPDATES` 回写车辆氢费明细。\n\n## KPI 口径（已确认）\n\n全部 / 签约·普通 / **高频（≥3 次）** / **低频（1–2 次）** / **无加氢（0 次）**，与《站点管理使用说明书》及页面内嵌 PRD 一致。\n\n## 角色演示\n\n页面右上角提供「平台管理员 / 加氢站账号」切换，影响编辑页系统账号字段可编辑性。\n\n## 双入口说明\n\n- **本原型**：OneOS → 加氢站管理 → 站点信息\n- **合包**：ONE-OS Web 端 → 加氢站管理 → 加氢订单 / 加氢记录\n",
|
||
"markdownPath": "src/prototypes/oneos-web-h2-station-site/.spec/requirements.md"
|
||
},
|
||
{
|
||
"type": "markdown",
|
||
"id": "h2-site-doc-acceptance",
|
||
"title": "验收标准",
|
||
"markdown": "## 8. 验收标准\n\n### 8.1 列表页\n\n- [ ] 筛选与 KPI 六卡片联动正确\n- [ ] 高频/低频/无加氢口径与车辆氢费明细一致\n- [ ] 加氢量、预付余额下钻数据来自共享 Store\n- [ ] 布局与租赁合同 vm 规范一致\n\n### 8.2 对账流程\n\n- [ ] 仅已对账未结算记录可进入对账单\n- [ ] 两阶段交互与必填校验完整\n- [ ] 提交后回写车辆氢费明细可跨页验收\n\n### 8.3 标注与文档\n\n- [ ] `@axhub/annotation` 已接入，关键区域有 `data-annotation-id`\n- [ ] 右侧工具栏目录可阅 PRD 全文与页面标注\n\n---"
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"type": "folder",
|
||
"id": "h2-site-doc-page",
|
||
"title": "页面标注",
|
||
"defaultExpanded": true,
|
||
"children": [
|
||
{
|
||
"type": "markdown",
|
||
"id": "h2-site-doc-node-h2-site-filter",
|
||
"title": "筛选条件",
|
||
"markdown": "## 2. 筛选区\n\n与租赁合同等模块一致的 **vm 筛选卡片** 布局：标题「筛选条件」+ 4 列栅格（标签在上、控件在下）；底部分隔线 + 右对齐「重置」「查询」。\n\n| 字段 | 控件 | 说明 |\n|---|---|---|\n| 加氢站名称 | 输入框 | 模糊匹配，支持回车查询 |\n| 是否签约 | 下拉 | 签约站点 / 普通站点 |\n| 地区(省-市) | 级联 | 省、市两级，可只选省 |\n| 营业状态 | 下拉 | 营业中 / 暂停营业 / 停止营业 |\n\n**交互**：\n\n- **查询**：写入「已应用筛选」，列表与 KPI 统计联动，回到第 1 页\n- **重置**：清空筛选条件并刷新列表\n\n---"
|
||
},
|
||
{
|
||
"type": "markdown",
|
||
"id": "h2-site-doc-node-h2-site-kpi",
|
||
"title": "KPI 快捷筛选",
|
||
"markdown": "## 3. KPI 统计卡片\n\n与租赁合同一致的 **vm-kpi-card**：左侧图标 + 标题 + 数值，右上角 `?` 悬停说明，选中态绿色描边。\n\n| 卡片 | 口径 |\n|---|---|\n| 全部加氢站 | 列表全部站点 |\n| 签约站点 | 已签约，点击快捷筛选 |\n| 普通站点 | 未签约，点击快捷筛选 |\n| 高频加氢站 | 该站加氢次数 ≥ 3 |\n| 低频加氢站 | 有加氢但次数 < 3 |\n| 无加氢站点 | 加氢次数 = 0 |\n\n加氢次数来自「车辆氢费明细」共享 Store，按站点名称聚合。KPI 与筛选区签约条件互斥切换（点 KPI 分类会清除签约筛选，点签约卡会重置 KPI 为全部）。\n\n---"
|
||
},
|
||
{
|
||
"type": "markdown",
|
||
"id": "h2-site-doc-node-h2-site-statement",
|
||
"title": "工具栏与对账",
|
||
"markdown": "## 4. 列表工具栏\n\n| 按钮 | 行为 |\n|---|---|\n| 全站余额提醒设置 | 配置全局预付余额预警阈值 |\n| 批量导入 | 下载模板 → 上传 CSV/Excel → 预览确认导入 |\n| 发起充值单 | 为站点发起预付充值流程（原型演示） |\n| 新建站点 | 进入同页内嵌新建视图 |\n\n---\n\n---\n\n## 6. 数据来源\n\n- 氢费/加氢明细：统一来自 `src/common/h2VehicleLedgerBridge.js`，与「车辆氢费明细」共享 Store\n- 先打开「车辆氢费明细」时台账全量同步；仅打开加氢站模块时使用 canonical seed\n- 对账单提交经 `H2_STATION_STATEMENT_LEDGER_UPDATES` 回写车辆氢费明细\n\n---"
|
||
},
|
||
{
|
||
"type": "markdown",
|
||
"id": "h2-site-doc-node-h2-site-table",
|
||
"title": "站点列表",
|
||
"markdown": "## 5. 列表字段说明\n\n| 字段 | 说明 |\n|---|---|\n| 加氢站名称 | 含签约标签；下一行展示省市区 + 详细地址 |\n| 合作时间 | 未签约可空 |\n| 营业状态 / 营业时间 | 列表只读；在「更多 → 营业状态」维护 |\n| 当前成本价格 | 元/kg；受价格配置生效时间驱动；多价时展示警示 |\n| 加氢次数 / 加氢量 | 加氢量可点击下钻；表头支持排序 |\n| 预付余额 | 可点击下钻流水；负值标红并显示「已欠费」 |\n| 联系方式 | 联系人 + 电话 |\n| 操作 | 查看 + 更多菜单 |\n\n**更多菜单**：编辑、删除、营业状态、价格配置、生成对账单、查看对账记录等（按状态与权限显隐）。\n\n**分页**：默认 10 条，可选 5/10/20/50。\n\n---"
|
||
}
|
||
]
|
||
}
|
||
]
|
||
}
|
||
]
|
||
},
|
||
"nodes": [
|
||
{
|
||
"id": "h2-site-filter",
|
||
"index": 1,
|
||
"title": "筛选条件",
|
||
"pageId": "site-info",
|
||
"locator": {
|
||
"selectors": [
|
||
".h2-station-page .vm-filter-card",
|
||
"[data-annotation-id=\"h2-site-filter\"]"
|
||
],
|
||
"fingerprint": "filter|site-info",
|
||
"path": []
|
||
},
|
||
"aiPrompt": "筛选字段与查询/重置行为。",
|
||
"annotationText": "## 2. 筛选区\n\n与租赁合同等模块一致的 **vm 筛选卡片** 布局：标题「筛选条件」+ 4 列栅格（标签在上、控件在下）；底部分隔线 + 右对齐「重置」「查询」。\n\n| 字段 | 控件 | 说明 |\n|---|---|---|\n| 加氢站名称 | 输入框 | 模糊匹配，支持回车查询 |\n| 是否签约 | 下拉 | 签约站点 / 普通站点 |\n| 地区(省-市) | 级联 | 省、市两级，可只选省 |\n| 营业状态 | 下拉 | 营业中 / 暂停营业 / 停止营业 |\n\n**交互**：\n\n- **查询**：写入「已应用筛选」，列表与 KPI 统计联动，回到第 1 页\n- **重置**：清空筛选条件并刷新列表\n\n---",
|
||
"hasMarkdown": true,
|
||
"color": "#2563eb",
|
||
"images": [],
|
||
"createdAt": 1782912426507,
|
||
"updatedAt": 1782912426507,
|
||
"controls": []
|
||
},
|
||
{
|
||
"id": "h2-site-kpi",
|
||
"index": 2,
|
||
"title": "KPI 快捷筛选",
|
||
"pageId": "site-info",
|
||
"locator": {
|
||
"selectors": [
|
||
".h2-station-page .vm-kpi-row",
|
||
"[data-annotation-id=\"h2-site-kpi\"]"
|
||
],
|
||
"fingerprint": "kpi|site-info",
|
||
"path": []
|
||
},
|
||
"aiPrompt": "六张 KPI 卡片口径与点击筛选。",
|
||
"annotationText": "## 3. KPI 统计卡片\n\n与租赁合同一致的 **vm-kpi-card**：左侧图标 + 标题 + 数值，右上角 `?` 悬停说明，选中态绿色描边。\n\n| 卡片 | 口径 |\n|---|---|\n| 全部加氢站 | 列表全部站点 |\n| 签约站点 | 已签约，点击快捷筛选 |\n| 普通站点 | 未签约，点击快捷筛选 |\n| 高频加氢站 | 该站加氢次数 ≥ 3 |\n| 低频加氢站 | 有加氢但次数 < 3 |\n| 无加氢站点 | 加氢次数 = 0 |\n\n加氢次数来自「车辆氢费明细」共享 Store，按站点名称聚合。KPI 与筛选区签约条件互斥切换（点 KPI 分类会清除签约筛选，点签约卡会重置 KPI 为全部）。\n\n---",
|
||
"hasMarkdown": true,
|
||
"color": "#2563eb",
|
||
"images": [],
|
||
"createdAt": 1782912426507,
|
||
"updatedAt": 1782912426507,
|
||
"controls": []
|
||
},
|
||
{
|
||
"id": "h2-site-statement",
|
||
"index": 3,
|
||
"title": "工具栏与对账",
|
||
"pageId": "site-info",
|
||
"locator": {
|
||
"selectors": [
|
||
".h2-station-page .vm-table-toolbar",
|
||
"[data-annotation-id=\"h2-site-toolbar\"]"
|
||
],
|
||
"fingerprint": "toolbar|statement",
|
||
"path": []
|
||
},
|
||
"aiPrompt": "工具栏操作与对账单氢费联动。",
|
||
"annotationText": "## 4. 列表工具栏\n\n| 按钮 | 行为 |\n|---|---|\n| 全站余额提醒设置 | 配置全局预付余额预警阈值 |\n| 批量导入 | 下载模板 → 上传 CSV/Excel → 预览确认导入 |\n| 发起充值单 | 为站点发起预付充值流程（原型演示） |\n| 新建站点 | 进入同页内嵌新建视图 |\n\n---\n\n---\n\n## 6. 数据来源\n\n- 氢费/加氢明细：统一来自 `src/common/h2VehicleLedgerBridge.js`，与「车辆氢费明细」共享 Store\n- 先打开「车辆氢费明细」时台账全量同步；仅打开加氢站模块时使用 canonical seed\n- 对账单提交经 `H2_STATION_STATEMENT_LEDGER_UPDATES` 回写车辆氢费明细\n\n---",
|
||
"hasMarkdown": true,
|
||
"color": "#d97706",
|
||
"images": [],
|
||
"createdAt": 1782912426507,
|
||
"updatedAt": 1782912426507,
|
||
"controls": []
|
||
},
|
||
{
|
||
"id": "h2-site-table",
|
||
"index": 4,
|
||
"title": "站点列表",
|
||
"pageId": "site-info",
|
||
"locator": {
|
||
"selectors": [
|
||
".h2-station-page .vm-table-card",
|
||
"[data-annotation-id=\"h2-site-table\"]"
|
||
],
|
||
"fingerprint": "table|site-info",
|
||
"path": []
|
||
},
|
||
"aiPrompt": "台账表格列、下钻与行内操作。",
|
||
"annotationText": "## 5. 列表字段说明\n\n| 字段 | 说明 |\n|---|---|\n| 加氢站名称 | 含签约标签；下一行展示省市区 + 详细地址 |\n| 合作时间 | 未签约可空 |\n| 营业状态 / 营业时间 | 列表只读；在「更多 → 营业状态」维护 |\n| 当前成本价格 | 元/kg；受价格配置生效时间驱动；多价时展示警示 |\n| 加氢次数 / 加氢量 | 加氢量可点击下钻；表头支持排序 |\n| 预付余额 | 可点击下钻流水；负值标红并显示「已欠费」 |\n| 联系方式 | 联系人 + 电话 |\n| 操作 | 查看 + 更多菜单 |\n\n**更多菜单**：编辑、删除、营业状态、价格配置、生成对账单、查看对账记录等（按状态与权限显隐）。\n\n**分页**：默认 10 条，可选 5/10/20/50。\n\n---",
|
||
"hasMarkdown": true,
|
||
"color": "#32a06e",
|
||
"images": [],
|
||
"createdAt": 1782912426507,
|
||
"updatedAt": 1782912426507,
|
||
"controls": []
|
||
}
|
||
]
|
||
}
|
||
} |