# 防汛物资应急保障平台操作手册

本手册面向业务使用者，帮助仓储管理员、调度员及管理人员更高效地在“防汛物资应急保障平台”中完成日常工作。开发细节在此不做展开。

---

## 1. 快速上手

| 步骤 | 操作 |
| --- | --- |
| 1 | 使用电脑 Chrome 浏览器访问部署地址（如 `https://xxx/admin/`）。建议 1920×1080 分辨率，以便完整呈现大屏。 |
| 2 | 输入平台账号与密码后登录。首次登录请按右上角头像 → `密码修改` 及时修改默认密码。 |
| 3 | 登录成功自动进入 `系统首页`（大屏驾驶舱）。所有业务菜单在左侧导航/顶部快捷入口中展示，权限根据角色自动控制。 |

> **角色说明**：常见角色包括`系统管理员`、`仓库管理员`、`调度员`等。不同角色能看到的菜单、按钮（如“采购入库”、“发起流程”等）会有所不同。

---

## 2. 页面结构

- **顶部栏**：系统标题、全屏切换、消息提醒和个人中心（密码修改、退出登录）。
- **侧边导航**：按照模块分组，例如“库存管理”“出入库管理”“运维管理”“统计报表”等。
- **主工作区**：展示当前功能页的表格、表单、图表或地图。
- **快捷入口**：`系统首页`底部提供常用模块按钮，可快速跳转至库存、盘点、运维、应急调令等页面。

---

## 3. 首页与可视化大屏

### 3.1 系统首页（`/jsc/index`）

- **页面概览**：也称“防汛应急力量一张图”。顶部展示`仓库数量`、`物资种类`、`本年度市级调度`、`物资调动`、`队伍出动`等核心指标，中间为苏州市地图，左侧分栏显示市级/全市重要防汛物资统计，右侧为“最新入库/出库”列表。
- **操作技巧**：  
  - 点击右上角“切换视图”可打开更简化的领导视角大屏。  
  - 底部八个快捷入口（库存/入库/出库/盘点/运维/应急调令/应急防御/统计报表）支持一键跳转到对应业务模块。
- **数据来源**：  
  - 指标及物资统计调用 `@/api/charts.js` 中的 `homeCharts()` 与 `fenleiCharts()`；  
  - “已办任务”相关数据由 `finishCharts()` 提供，如接口异常则有内置模拟数据兜底；  
  - 仓库分布地图使用 `echartsMap` 组件，数据同样来自上述接口汇总。

### 3.2 领导可视化大屏（`/jsc/leader`）

- **页面内容**：重点突出`仓库数量`、`物资种类`、`队伍数量`三项指标，并以卡片形式展示“重点防汛物资统计”“各地重点防汛物资”“各地队伍数量”与地图联动，方便领导快速掌握整体态势。
- **交互**：右侧切换各地市可查看不同区域的物资数量；底部图表展示队伍数量分布。
- **数据来源**：与系统首页共用 `homeCharts()`、`fenleiCharts()`；队伍数量与区域维度由 `homeCharts().team` 等字段提供，页面仅做可视化渲染，无额外手动录入。

---

## 4. 物资管理

> 对应左侧“物资管理”主菜单及所有下级功能。菜单路径即 `src/views` 下的页面路径，可用于快速定位界面代码或在浏览器地址栏中识别模块。

### 3.1 出入库管理

#### 入库管理（`/stocks/index`）
- 顶部操作：`采购入库`、`请示入库`、`调拨入库`、`盘点入库`、`归还入库`（仅管理员/仓库管理员可见）。
- 查询条件：经办人、入库类型、状态；状态从`待处理`→`待办结`→`待入库`→`已入库`，另有`退回`。
- 列表列：入库日期、类型、状态、经办人、备注。
- 常见动作：新增/编辑、发起流程（对接 OA）、确认入库、删除（仅待处理）以及查看打印。

#### 出库管理（`/outbounds/index`）
- 支持多种出库类型，与入库流程一致。
- 重点字段：出库单号、仓库、申请单位、审批状态。
- 操作流程：新增出库 → 填写申请内容 → 发起流程 → 实物出库后“确认出库” → 打印出库单签收。

### 3.2 物资信息

#### 自管物资（`/inventorys`）
- 查看本单位仓库实时库存，支持按仓库、类别、批次筛选。
- 可钻取到物资明细、批次、占用情况，辅助日常盘点与调拨。

#### 全市防汛物资（`/storages/floodmaterialfile`）
- 汇总全市或上级下发的物资台账，展示各类别、各仓库数量。
- 常用于对接市级调拨、统计上报。

### 3.3 运维管理

#### 运维记录（`/maintenance/maintenance_records`）
- 记录设备、泵车、仓库设施的维护、检修、校准。
- 表单包含维护类型、执行人、时间、附件照片；支持筛选与导出。

#### 运维规则（`/maintenance/maintenance_rules`）
- 维护制度、周期、责任人等文档化内容集中展示，可在线查看/下载。

#### 盘点运维（`/inventorys/stocktaking`）
- 计划盘点：设置仓库、物资范围、负责人和时间。
- 执行盘点：录入实盘数量、差异原因，可批量导入 Excel。
- 盘点结果：生成报告，必要时触发盘盈盘亏入库。

### 3.4 信息管理

| 子菜单 | 路径 | 使用说明 |
| --- | --- | --- |
| 仓库信息 | `/storages/index` | 维护仓库基础信息、定位、负责人、容量等，影响地图及报表。 |
| 物品分类 | `/materialfile/fenlei` | 维护物资大类层级，用于入库/出库下拉选择。 |
| 物资种类 | `/materialfile/index` | 维护具体物资品名、规格、计量单位，是入库明细的基准数据。 |
| 固定资产 | `/storages/fixAssets` | 记录大型设备、车辆等固定资产台账，可关联维修与调拨记录。 |
| 虚拟货架 | `/virtual/index` | 用于模拟仓库货位、货位编码，便于精准定位物资。 |

### 3.5 调令管理

#### 应急调令（`/workOrder/index`）
- 新增调令：填写任务来源、等级、调拨物资/队伍、执行单位、时限。
- 跟踪调令进度，记录执行反馈、附件与批示。
- 完成后归档，供统计报表与历史查询。

### 3.6 仓库监控

| 子菜单 | 路径 | 功能 |
| --- | --- | --- |
| 环境监测 | `/xukou/monitor` | 实时查看温湿度、水位、门磁等感知数据，异常高亮。 |
| 环境预警设置 | `/xukou/warningSetting` | 配置各仓库阈值（如温度上限），设定预警策略及接收人。 |
| 环境预警信息 | `/xukou/warning` | 列出所有历史/实时预警，可标记已处理、导出记录。 |

### 3.7 抢险泵车行程定位管理

| 子菜单 | 路径 | 功能 |
| --- | --- | --- |
| 泵车管理 | `/car/basic` | 录入泵车编号、装备信息、所属单位、维保记录。 |
| 实时定位 | `/car/location` | 地图实时显示泵车位置、状态，支持轨迹回放入口。 |
| 运行轨迹 | `/car/playback` | 选择时间段回放行驶路径，用于核实调度执行情况。 |
| 系统预警 | `/car/warning` | 泵车超速、越界、离线等报警信息集中处理。 |
| 行驶统计 | `/car/driveStatistics` | 统计里程、用车频次、运行时长，支持导出。 |

---

## 5. 队伍建设

### 4.1 防汛应急队伍（`/team/team`）
- 管理全部应急队伍的信息：所属单位、编制人数、装备、联系方式。
- 支持导入、导出，常用于年度更新与调度分配。

### 4.2 市级队伍动态（`/team/teamUpdate`）
- 记录队伍的训练、拉练、出勤、考核等动态。
- 可按时间、队伍、事件类型筛选，支持上传照片、附件。

### 4.3 地图分布（`/books/index`）
- 地图模式展示各队伍驻点、可支援的河段。
- 点击标记可查看队伍详情，与调令模块联动定位最近队伍。

---

## 6. 统计报表

| 子菜单 | 路径 | 说明 |
| --- | --- | --- |
| 入库统计 | `/reports/stocks` | 按时间、仓库、类型统计入库数量金额，可导出 Excel。 |
| 出库统计 | `/reports/outbounds` | 统计各类出库（应急、调拨等）数量、物资去向。 |
| 入库明细 | `/inventorys/stocks` | 明细级数据，支持条件筛选与导出，便于核对流水。 |
| 出库明细 | `/inventorys/outbounds` | 对应出库单明细，包含用途、审批号等信息。 |

- 所有报表均可通过筛选条件生成图表或表格，可在侧边栏导出下载。
- 建议月末固定导出入/出库统计与明细，以满足审计和上级汇报。

---

## 7. 常用辅助功能

- **搜索与筛选**：几乎所有列表页都提供关键字、类型、状态等筛选条件；输入后点击“查询”即可刷新。
- **分页**：列表底部通过 `xy-table` 提供分页器，调整每页数量或切换页码查看数据。
- **导入导出**：
  - `imports` 组件支持批量导入物资明细（Excel）。导入前请下载官方模板，避免字段对不上导致失败。
  - 表格右上角通常有“导出”按钮，可生成 Excel/CSV。
- **附件与图片**：入库、出库、运维等页面可上传/预览照片、扫描件、流程附件。
- **地图操作**：大屏地图支持鼠标缩放、拖拽；点击仓库图标可查看基础信息和库存概览。

---

## 8. 使用建议

1. **数据及时维护**：入库、出库、盘点、维护等操作完成后当日录入，确保大屏及报表实时准确。
2. **流程与单据对齐**：依赖 OA 审批的操作（如采购/请示入库）务必使用“发起流程”按钮，避免数据与流程脱节。
3. **附件命名规范**：上传文件建议包含日期、仓库、单号，方便后续检索。
4. **定期导出报表**：每月导出库存与出入库报表存档，满足审计或上级检查。
5. **账号安全**：定期修改密码，不要在公共电脑保存登录信息。离岗请点击“退出登录”。

---

## 9. 常见问题解答

| 问题 | 解决方法 |
| --- | --- |
| 登录提示“账号或密码错误” | 检查大小写，仍无法登录请联系系统管理员重置。 |
| 列表数据不更新 | 点击页面右上角的刷新，或使用浏览器 `Ctrl+F5` 强制刷新缓存。 |
| 无法看到“入库/出库”按钮 | 当前账号可能无 `仓库管理员` 权限，请联系管理员授权。 |
| 发起流程页面空白 | 确认浏览器未阻止弹窗；若 OA 地址变更，请在 `.env` 中更新 `VUE_APP_OA_URL`（由管理员操作）。 |
| 导入 Excel 失败 | 确认使用官方模板，所有必填字段已填写且无合并单元格。 |

---

## 10. 支持与反馈

- **业务问题**：请联系本单位仓储/调度负责人。
- **账号与权限**：联系系统管理员。
- **系统异常或新需求**：通过“问题反馈”菜单或企业 IM 工单提交，附上截图、操作步骤及期望结果。

祝您使用顺利，如需进一步操作指导，可在每个页面右上角点击帮助图标查看更详细的说明或联系管理员获取培训资料。