乘务作业智能调度提醒系统

一、项目背景

1.1 建设单位概况

1.2 业务现状分析

1.2.1 当前作业模式

中国铁路成都局集团有限公司贵阳车辆段乘务作业当前采用传统人工调度模式，主要流程如下：

传统乘务作业流程

1. 班前准备阶段
   └─ 调度员通过电话/微信群通知乘务员出乘信息

2. 运行作业阶段
   └─ 乘务员需自行记忆到站时间和作业任务
   └─ 依赖人工查看时刻表或等待车站通知

3. 到站作业阶段
   └─ 乘务员凭记忆完成到站作业任务
   └─ 作业完成后无需系统记录

4. 事后管理阶段
   └─ 纸质记录或Excel表格统计
   └─ 缺乏实时监督和追溯手段

1.2.2 存在问题

1.3 建设必要性

1.3.1 业务需求

1.3.2 技术可行性

二、建设目标

2.1 总体目标

2.2 具体目标

2.2.1 业务目标

2.2.2 管理目标

2.2.3 技术目标

三、预估成效

3.1 经济效益

3.1.1 直接经济效益

3.2 管理效益

3.2.1 管理效率提升

管理效率对比分析

传统管理模式                      智能化管理模式
┌─────────────────────┐          ┌─────────────────────────────────────┐
│ • 电话通知，逐个联系 │    →     │ • 系统自动推送，批量提醒            │
│ • Excel手工统计     │    →     │ • 系统自动统计，实时展示            │
│ • 无法实时监控      │    →     │ • 调度大屏实时监控                  │
│ • 事后人工追溯      │    →     │ • 系统完整记录，随时查询            │
│ • 异情况发现滞后    │    →     │ • 预警自动触发，及时处理            │
└─────────────────────┘          └─────────────────────────────────────┘

管理效率提升：约60%

3.3 安全效益

3.3.1 安全风险降低

四、功能架构设计

4.1 系统功能模块图

乘务作业智能调度提醒系统

服务端功能模块：
┌─────────────────────────────────────────────────────────┐
│ 调度大屏模块 │ 管理后台模块 │ 车次管理     │ 时刻作业图     │
│ 乘务员管理 │ 设备管理     │ 排班管理     │ 提醒          │
│ 预警       │ 定位         │ WebSocket推送                │
└─────────────────────────────────────────────────────────┘
                          │
                          │ WebSocket / HTTP API
                          │
客户端功能模块（Android）：
┌─────────────────────────────────────────────────────────┐
│ 任务列表模块 │ 提醒弹窗模块 │ GPS定位模块 │ 确认操作模块 │
│ 离线缓存模块 │ 数据同步模块 │ 个人中心模块 │ 设置管理模块 │
└─────────────────────────────────────────────────────────┘

4.2 功能模块清单

五、服务端功能设计

5.1 调度大屏模块

5.1.1 车次实时监控

5.1.2 统计看板

5.2 管理后台模块

5.2.1 车次管理

管理车次基本信息，包括车次号、车次类型、始发站、终到站等。

5.2.2 乘务员管理

管理乘务员信息和APP账号，包括工号、姓名、性别、电话等。

5.2.3 设备管理

5.2.4 时刻作业图管理

配置车次到站时刻和作业任务清单，设置触发距离/时间阈值。

5.2.5 排班管理

管理乘务员与车次的绑定关系，支持排班创建、编辑、删除和查询。

5.3 业务服务层

5.3.1 提醒触发服务

根据GPS位置和时刻计算，判断是否触发提醒。触发条件为：距离≤30km 或 时间≤30分钟

5.3.2 预警判定服务

监控任务确认状态，连续3次未确认触发红色预警，2次未确认触发黄色预警。

5.3.3 WebSocket推送服务

实现服务端到客户端的实时消息推送，包括提醒推送、确认响应、预警通知等。

六、客户端功能设计

6.1 任务列表模块

显示乘务员今日所有任务，包括待提醒、提醒中、待确认、已完成等状态。

6.2 提醒功能模块

6.2.1 提醒弹窗

6.3 GPS定位模块

定时获取GPS位置并上报到服务器，上报频率为30秒/次。

6.4 离线缓存模块

在本地SQLite数据库缓存任务数据，支持离线提醒和断网续传。

6.5 数据同步模块

网络恢复后自动上传离线期间的数据，包括离线确认记录和定位记录。

七、数据库设计

7.1 数据库选型

7.2 核心数据表设计

核心数据表清单

八、接口设计

8.1 接口规范

8.2 REST API接口

认证相关

POST /api/v1/auth/login      - 登录接口
POST /api/v1/auth/logout     - 登出接口（交班）

任务相关

GET  /api/v1/tasks/today    - 获取今日任务
POST /api/v1/remind/confirm  - 确认任务

定位相关

POST /api/v1/location/upload - 上报GPS位置
POST /api/v1/location/batch   - 批量上传离线定位

8.3 WebSocket接口

九、业务流程设计

9.1 完整业务流程

阶段一：准备阶段
1. 管理员配置基础数据
   ├─ 车次管理：创建车次（K108、K107...）
   ├─ 乘务员管理：添加乘务员（张三、李四...）
   ├─ 设备管理：设备与车次绑定
   ├─ 时刻作业图：配置车次到站时间和作业任务
   └─ 排班管理：创建排班（3月9日，K108，张三）

2. 乘务员登录APP
   ├─ 输入工号密码
   ├─ 设备绑定验证
   ├─ 获取今日任务列表
   └─ 启动GPS定位服务

阶段二：运行阶段
1. GPS定位上报（每30秒）
2. 服务端计算触发条件
3. 触发提醒 → WebSocket推送
4. Android接收提醒 → 震动+响铃+弹窗
5. 用户确认 → 更新提醒记录
6. 用户未确认 → 超时计数 → 预警

阶段三：完成阶段
1. 任务完成 → 统计今日完成率
2. 生成报表 → 提醒记录、预警记录
3. 次日准备 → 创建新排班

9.2 交班流程

十、非功能性需求

10.1 性能要求

10.2 可靠性要求

10.3 安全性要求

10.4 兼容性要求

服务端

Android客户端

十一、功能开发优先级

11.1 功能分期规划

第一期：核心功能（MVP）- 4周

第二期：完善功能 - 2周

第二期目标：完善预警机制、统计分析、查询功能

第三期：优化功能 - 2周

第三期目标：完善离线功能和用户体验优化

11.2 开发排期建议

附录

术语表

参考文档

1. 《乘务作业智能调度提醒系统-项目方案》
2. Spring Boot官方文档
3. Vue 3官方文档
4. Android开发者文档
5. MySQL 8.0参考手册

文档变更记录