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

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

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
王冕
2026-06-04 19:57:30 +08:00
parent d29e2a821b
commit d432d51eed
35 changed files with 26963 additions and 1463 deletions

View File

@@ -2,11 +2,11 @@
| 项目 | 内容 |
|------|------|
| 文档版本 | v2.0(业务版) |
| 文档版本 | v2.1(业务版) |
| 产品模块 | 台账数据 → 车辆氢费明细 |
| 文档类型 | 产品需求说明 |
| 适用读者 | 产品、业务、运营、测试、项目 |
| 修订说明 | 从业务与使用场景出发描述需求,不展开技术实现细节 |
| 修订说明 | 同步列表字段顺序、顶部合计条、承担方式、系统带出字段等现行页面行为 |
---
@@ -75,14 +75,14 @@
### 3.1 端到端流程(推荐操作顺序)
```mermaid
\`\`\`mermaid
flowchart LR
A[录入/复制] --> B[待保存]
B --> C[点击保存]
C[保存/导入] --> D[未对账]
D --> E[勾选并完成对账]
E --> F[已对账]
```
\`\`\`
**说明:**
@@ -129,9 +129,9 @@ flowchart LR
| 客户名称 | 从客户库选择 |
| 加氢站名称 | 从加氢站库选择 |
| 业务员 | 按客户归属业务员筛选 |
| 结算状态 | 客户承担 / 我司承担 |
| 款状态 | 未付款 / 已付款 / 部分付款 |
| 开票公司 | 从开票主体选择 |
| 承担方式 | 客户承担 / 我司承担 / 客户自行结算 / 其他结算 |
| 客户收款状态 | 已付款 / 未付款(系统带出,用于筛选) |
| 开票公司 | 从开票主体选择(系统带出字段对应公司) |
查询成功给予简短成功提示。
@@ -153,7 +153,17 @@ flowchart LR
不同区域之间有明显分隔,已对账区背景略灰、待保存区背景略黄,降低误操作概率。
**部合计:** 对当前列表可见记录,合计 **加氢量、成本总价、加氢总价**(随筛选与「仅看异常」变化)
**部合计** 表格上方独立展示 **加氢量(kg)、成本总价(元)、加氢总价(元)** 三项合计
- **统计范围:** 与当前列表可见行一致。
- **随查询重算:** 点击「查询」应用筛选条件后,合计立即按新结果重新汇总。
- **随「仅显示异常数据」变化:** 开关开启时,仅对当前可见的异常记录(及本人待保存行)合计。
- **说明:** 合计条含「待保存 / 未对账 / 已对账」等当前列表中的全部可见记录,与导出范围(仅未对账+已对账)不同。
**列表列顺序(左→右,业务视角):**
序号 → 加氢日期 → 加氢时间 → 加氢站名称 → 客户名称 → 车牌号 → 加氢量 → 成本单价 → 成本总价 → 加氢单价 → 加氢总价 → 行驶里程 → 备注 → 业务员 → 承担方式 → 对账日期 → **收票日期****加氢站付款状态****开票日期****客户收款状态****开票公司** → 状态 → 订单编号 → 操作(操作列固定右侧)。
**系统带出字段(不可手工维护):** 收票日期、加氢站付款状态、开票日期、客户收款状态、开票公司;选择/变更客户等信息后由系统自动刷新,单元格为浅灰底只读样式。
**列表勾选:****未对账** 记录可勾选,用于批量「完成对账」。
@@ -177,28 +187,30 @@ flowchart LR
| 信息项 | 用户是否填写 | 业务说明 |
|--------|--------------|----------|
| 状态 | 否 | 展示「未对账」「已对账」;待保存不显示标签 |
| 订单编号 | 否 | 系统按规则自动生成,不可改 |
| 加氢时间 | 是* | 精确到秒,必填 |
| 加氢日期 | 否 | 由加氢时间自动得出 |
| 加氢日期 | 否 | 由加氢时间自动得出,只读 |
| 加氢站名称 | 是* | 必选 |
| 客户名称 | 是* | 必选,位于加氢站右侧;决定业务员与系统带出信息 |
| 车牌号 | 是* | 必选,须为公司登记车辆 |
| 行驶里程 | 否 | 选填,用于业务留痕 |
| 加氢量(kg) | 是* | 必填,用于算总价 |
| 成本单价 | 是* | 必填,向站点的采购成本价 |
| 成本总价 | 否 | 加氢量 × 成本单价,自动计算 |
| 客户名称 | 是* | 必选,决定业务员与财务带出信息 |
| 加氢单价 | 是* | 必填,对客户的销售单价 |
| 加氢总价 | 否 | 加氢量 × 加氢单价,自动计算 |
| 业务员 | 否 | 选客户后自动带出 |
| 结算状态 | 是* | 客户承担 / 我司承担 |
| 开票日期 | 否 | 系统按客户等业务规则带出 |
| 对账日期 | 否 | 系统带出 |
| 付款状态 | 否 | 系统带出 |
| 开票公司 | 否 | 系统带出 |
| 行驶里程 | 否 | 选填,位于加氢总价之后 |
| 备注 | 否 | 自由文本 |
| 业务员 | 否 | 选客户后自动带出 |
| 承担方式 | 是* | 客户承担 / 我司承担 / 客户自行结算 / 其他结算 |
| 对账日期 | 否 | 完成对账等流程带出,只读 |
| 收票日期 | 否 | 由财务/收票模块自动带出,不可编辑 |
| 加氢站付款状态 | 否 | 已付款 / 未付款,由加氢站打款管理带出 |
| 开票日期 | 否 | 由开票模块自动带出 |
| 客户收款状态 | 否 | 已付款 / 未付款,由客户收款模块带出 |
| 开票公司 | 否 | 显示开票公司名称,系统自动带出 |
| 状态 | 否 | 展示「未对账」「已对账」;待保存不显示标签;列在列表末尾 |
| 订单编号 | 否 | 系统按规则自动生成,不可改;列在列表末尾 |
\* 保存时校验,缺失则标红提示。
\\* 保存时校验,缺失则标红提示。
### 5.2 订单编号规则(业务口径)
@@ -266,7 +278,7 @@ flowchart LR
### 8.1 表头批量改价 / 改结算
-**成本单价**、**加氢单价** 列表头可批量填入统一单价,作用于当前可编辑的所有记录(待保存 + 未对账)。
-**结算状态** 列表头可批量改为「客户承担」或「我司承担」
-**承担方式** 列表头可批量改为四种承担方式之一
- **已对账** 记录不参与批量修改。
### 8.2 批量导入
@@ -276,11 +288,11 @@ flowchart LR
**流程:**
1. 点击「批量导入」→ 下载标准模板
2. 按模板填写(无需填开票日期、对账日期、付款状态、开票公司
2. 按模板填写(无需填对账日期及收票/开票/付款等系统带出字段
3. 上传文件 → 系统生成多条 **待保存** 记录
4. 业务核对列表 → 点击 **保存** 进入未对账
**模板包含列:** 加氢时间、加氢站名称、车牌号、行驶里程、加氢量、成本单价、客户名称、加氢单价、结算状态、备注
**模板包含列:** 加氢时间、加氢站名称、车牌号、加氢量、成本单价、客户名称、加氢单价、承担方式、备注(行驶里程可在备注前按业务需要填写,导入模板列顺序以页面下载为准)
**导入后状态:** 均为待保存,与手工新增一致,须保存后才参与对账与导出。
@@ -296,7 +308,7 @@ flowchart LR
- 弹窗文案:「请选择导出的列」;支持全选/取消全选;默认勾选全部可导出列。
- 无符合条件数据时提示:暂无未对账或已对账数据可导出。
**可导出列(业务名称):** 序号、状态、订单编号、加氢时间、加氢日期、加氢站名称、车牌号、行驶里程、加氢量、成本单价、成本总价、客户名称、加氢单价、加氢总价、业务员、结算状态、开票日期、对账日期、付款状态、开票公司、备注
**可导出列(业务名称):** 序号、状态、订单编号、加氢时间、加氢日期、加氢站名称、车牌号、加氢量、成本单价、成本总价、客户名称、加氢单价、加氢总价、行驶里程、业务员、承担方式、对账日期、备注、收票日期、加氢站付款状态、开票日期、客户收款状态、开票公司。
---
@@ -325,7 +337,7 @@ flowchart LR
### 10.1 保存
- 一次保存处理页面上**全部**待保存记录。
- 必填:加氢时间、加氢站、车牌(须为登记车辆)、客户、加氢量、成本单价、加氢单价、结算状态
- 必填:加氢时间、加氢站、车牌(须为登记车辆)、客户、加氢量、成本单价、加氢单价、承担方式
- 校验失败:仅格子标红,无「保存成功」类提示。
### 10.2 完成对账
@@ -337,8 +349,8 @@ flowchart LR
### 10.3 筛选与列表
- 查询点击后生效;重置恢复。
- 筛选后合计与所见列表一致
- 本人待保存新增行在筛选后仍可见。
- **顶部合计条** 对当前列表可见行实时汇总;修改筛选并点击「查询」后重新计算;「仅显示异常数据」开启时仅统计可见行
- 本人待保存新增行在筛选后仍可见(合计亦包含这些行,若其在列表中展示)
### 10.4 导出
@@ -374,9 +386,13 @@ flowchart LR
| 待保存 | 草稿,未进入对账流程 |
| 未对账 | 已保存,等待业务确认并完成对账 |
| 已对账 | 对账完成,业务员不可随意改动 |
| 客户承担 | 氢费由客户结算 |
| 我司承担 | 氢费由司承担 |
| 未付款 / 已付款 / 部分付款 | 系统带出的付款进度,业务只读 |
| 客户承担 | 氢费由客户承担 |
| 我司承担 | 氢费由司承担 |
| 客户自行结算 | 由客户自行与加氢站等方结算 |
| 其他结算 | 其他结算方式 |
| 加氢站付款状态 | 加氢站侧是否已付款,已付款 / 未付款 |
| 客户收款状态 | 客户侧是否已收款,已付款 / 未付款 |
| 收票日期 | 财务收票日期,系统带出 |
| 标准价 | 公司维护的、按加氢站与生效时段确定的参考单价 |
---