# 物流业务台账 — 产品需求说明（PRD）

| 项目 | 内容 |
|------|------|
| 文档版本 | v1.0 |
| 产品模块 | 数据分析 → 物流业务台账 |
| 文档类型 | 产品需求说明 |
| 适用读者 | 产品、业务、研发、测试 |
| 对齐来源 | 《2026年业务二部运营台账总表》子表「1.2物流业务台账」 |

---

## 一、为什么做这件事

### 1.1 业务背景

业务二部物流运营涉及出车记录、营收、氢费、ETC、人工及车辆日成本等多类费用，原先分散在 Excel 子表中维护，存在以下问题：

- 各操作人各自维护，主管难以统一查看与核对；
- 氢费、ETC 等费用与系统台账（车辆氢费明细、ETC 记录）缺乏自动比对，易录入偏差；
- 缺少按筛选条件汇总营收与成本的能力，经营分析效率低。

### 1.2 产品目标

建设 Web 端「物流业务台账」页面，支撑业务服务组操作人**录入、查询、导入、导出、删改**各自台账；主管可**查看全部**操作人数据；系统自动计算总成本、盈亏，并对氢费/ETC 异常给出提示。

### 1.3 本期不做

- 与财务系统过账、审批流（后续迭代）；
- 复杂组织架构数据权限（本期按「操作人 / 主管」两类角色）；
- 菜单路由注册（由 Axhub / 系统导航统一配置）。

---

## 二、角色与权限

| 角色 | 数据范围 | 可执行操作 |
|------|----------|------------|
| **业务服务组操作人** | 仅本人维护的台账 | 筛选、新增、行内编辑、弹窗编辑、导入、导出、批量删除（本人数据）、查看变更日志 |
| **业务服务组主管** | 全部操作人台账 | 筛选、查看、编辑/删除任意记录、导出、批量删除、查看变更日志；**不可**导入、表格底部新增 |

**原型说明：** 页面顶部提供「当前登录（原型切换）」下拉，用于演示不同角色；正式环境由系统登录态与权限接口驱动。

---

## 三、页面结构

用户进入「数据分析 → 物流业务台账」后，自上而下为：

1. **面包屑** + 右上角 **「查看需求说明」**
2. **原型用户切换**（仅原型）
3. **筛选条件区**
4. **KPI 统计卡片**（6 张）
5. **列表工具栏**（批量导入 / 批量删除 / 导出）
6. **数据列表**
7. **表格底部新增入口**（操作人可见）
8. **弹窗**：批量导入、编辑台账、变更日志、需求说明

---

## 四、筛选条件

**交互原则：** 修改条件后需点击 **「查询」** 生效；**「重置」** 清空条件。

**默认展示：** 第一行 4 项（月份、出车日期、业务名称、车牌号码）；点击 **「展开更多筛选项」** 显示其余条件；可 **「收起」**。

| 筛选项 | 说明 |
|--------|------|
| 月份 | 月份选择器，中文展示（如 2026年01月）；占位「全部月份」 |
| 出车日期 | 日期区间，占位「开始日期 / 结束日期」，中文选择器 |
| 业务名称 | 下拉选择器，支持输入模糊搜索匹配项；查询为精确匹配所选业务 |
| 车牌号码 | **多选**；未选任何车牌时视为「全部」；可勾选/取消单个车牌 |
| 车辆承接方 | 我司 / 第三方车队 |
| 品牌 | 下拉，与型号级联 |
| 型号 | 需先选品牌；选项来自「型号参数」模块品牌型号映射 |
| 维护人 | **仅主管可见**；按台账维护人筛选 |

---

## 五、KPI 统计卡片

统计范围为 **当前筛选条件下的全部台账记录**，卡片右上角 ? 可查看计算说明。

| 卡片 | 计算规则（示例表述） |
|------|----------------------|
| 台账条数 | 筛选后记录 A、B、C… 的条数合计 |
| 金额合计 | 记录 A 金额 + 记录 B 金额 + 记录 C 金额 + … |
| 总成本合计 | 记录 A 总成本 + 记录 B 总成本 + … |
| 氢费总计 | 记录 A 氢费 + 记录 B 氢费 + … |
| ETC费用总计 | 记录 A ETC费用 + 记录 B ETC费用 + … |
| 盈亏合计 | 记录 A 盈亏 + 记录 B 盈亏 + … |

卡片顺序：台账条数 → 金额合计 → 总成本合计 → 氢费总计 → ETC费用总计 → 盈亏合计。

---

## 六、列表字段与排序

### 6.1 主要列

序号、月份、出车日期、业务名称、司机、电话、车辆承接方、车牌号码、品牌、型号、单价、数量、金额、氢费、ETC费用、薪资、电费、人工报销费用、日社保服务费、日挂车费用、日停车费用、日轮胎费用、车辆费用、总成本、盈亏、是否多趟、线路计价、备注、**操作人**、**最后操作时间**、操作。

- **主管**额外在列表前部展示 **维护人** 列。
- **出车日期** 默认 **降序**；点击表头可在降序/升序间切换。
- **数量** 支持 2 位小数。

### 6.2 自动计算

- **金额** = 单价 × 数量（修改单价或数量时自动重算，亦可手填金额）。
- **总成本** = 氢费 + ETC费用 + 薪资 + 电费 + 人工报销费用 + 日社保服务费 + 日挂车费用 + 日停车费用 + 日轮胎费用 + 车辆费用。
- **盈亏** = 金额 − 总成本。

### 6.3 氢费 / ETC 异常提示

当台账填写的氢费或 ETC 与系统按 **车牌 + 出车日期** 汇总值不一致时，对应单元格显示橙色警告图标，悬停提示：

- 氢费：`成本总价（元）：xxx`（对接「车辆氢费明细」按日汇总）
- ETC：`ETC记录总金额（元）：xxx`（对接 ETC 通行记录按日汇总）

---

## 七、车辆承接方与车牌

| 承接方 | 车牌 | 品牌型号 | 校验 |
|--------|------|----------|------|
| **我司** | 下拉选择档案车牌 | 根据车牌自动带出，不可手改 | 保存时校验车牌存在于车辆档案 |
| **第三方车队** | 自由输入 | 品牌、型号手动级联选择 | 不校验车牌档案 |

品牌型号级联与「型号参数」模块一致（现代、飞驰、宇通等）。

---

## 八、维护方式

### 8.1 表格底部新增（操作人）

- 点击 **「点击在表格下方直接新增一行」** 在表格底部追加 **草稿行**（绿色背景）。
- 草稿行支持 **行内编辑**；操作列显示 **保存 / 取消**。
- 保存前校验：业务名称、车辆承接方、我司车牌档案匹配等。

### 8.2 弹窗编辑

- 已有记录：操作列 **更多（⋮）→ 编辑**，弹窗表单修改。
- 保存后更新 **操作人、最后操作时间**，并写入变更日志。

### 8.3 批量导入（操作人）

1. 下载 CSV 模板（字段对齐子表 1.2，月份格式 YYYY-MM）。
2. 上传 CSV；导入记录归属当前登录操作人。
3. 车辆承接方为「我司」时按车牌自动匹配品牌型号；总成本、盈亏系统计算。

### 8.4 导出

- 导出 **当前筛选结果全部记录**（含排序后顺序）。
- 字段含导入模板全部列 + 总成本、盈亏；主管导出额外含维护人。
- 文件名：`物流业务台账_时间戳.csv`。

### 8.5 批量删除

- 列表左侧多选；仅可勾选本人有权维护的记录。
- 工具栏 **批量删除**，二次确认后删除所选记录。

### 8.6 单条删除

- 更多 → 删除，二次确认。

---

## 九、操作列

| 行状态 | 操作列展示 |
|--------|------------|
| 草稿行（操作人） | 保存、取消 |
| 已保存（有权维护） | 更多 ⋮：编辑、删除、变更日志 |
| 无权维护 | 无操作 |

样式参照「车辆氢费明细」操作列图标按钮。

---

## 十、变更日志

入口：操作列 **更多 → 变更日志**。

记录以下场景的字段变更：行内新增保存、弹窗编辑、批量导入。展示：修改时间、修改人、修改字段、修改前、修改后。

---

## 十一、联调接口（研发）

| 能力 | 对接说明 |
|------|----------|
| 车辆档案 | 「车辆管理」车牌 → 品牌/型号 |
| 氢费比对 | 「车辆氢费明细」按车牌+加氢日期汇总 costTotal |
| ETC 比对 | ETC 通行记录按车牌+通行日期汇总 fee |
| 品牌型号 | 「型号参数」品牌型号级联 |
| 用户权限 | 登录用户 ID、角色（操作人/主管） |

---

## 十二、验收要点（测试）

1. 操作人仅见本人数据；主管见全部。
2. 筛选默认收起第一行；展开后条件查询正确；车牌多选空=全部。
3. KPI 随筛选变化；? 提示文案正确。
4. 出车日期默认降序，表头切换升序。
5. 我司/第三方车队车牌与品牌型号联动及校验。
6. 氢费/ETC 不一致时出现警告提示。
7. 导入、导出、批量删除、变更日志流程可用。
8. 操作人、最后操作时间在保存/编辑后更新。

**文档结束**
