sl-express/sl-express-ms-web-driver/README.md

sl-express-ms-web-driver使用手册

1.说明

该模块为司机端web微服务，主要提供司机端APP各项服务。
主要功能：

• 司机账号登录
• 用户个人信息、绑定车辆信息、任务数据（任务数量、里程统计）
• 司机任务查询、延迟提货、提货、交付、回车登记、联系调度中心
• 公告、系统通知的消息通知

2.服务配置

2.1配置信息

• 服务需要接入权限系统，所以需要配置权限系统应用id
• 司机取消任务需要联系调度员，所以需要配置调度员角色id
• 司机提货、交付、回车登记需要上传图片，所以需要配置阿里云oss

#权限系统应用id
authority.applicationId = 981194468570960001

#角色id
role.manager = 986227712144197857,989278284569131905,996045142395786081,996045927523359809
role.driver = 989559028277315009
role.courier = 989559057641637825
role.dispatcher = 996045927523359809

#阿里云OSS
#yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为 oss-cn-hangzhou.aliyuncs.com。
spring.alioss.endpoint = yourEndpoint
#阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
spring.alioss.accessKeyId = yourAccessKeyId
spring.alioss.accessKeySecret = yourAccessKeySecret
# 自定义的存储bucket名称
spring.alioss.bucketName = yjy-slwl-oss

2.2依赖引入

依赖服务	版本	参考文档
sl-express-common	1.1-SNAPSHOT	sl-express-common
sl-express-ms-base-api	1.0-SNAPSHOT	基础微服务
sl-express-ms-work-api	1.0-SNAPSHOT	work微服务
sl-express-ms-transport-api	1.0-SNAPSHOT	运输微服务
sl-express-ms-driver-api	1.0-SNAPSHOT	司机微服务

3.技术方案

阿里云OSS： 阿里云OSS-SDK示例

4.使用

概述：司机的每个任务要经过三个阶段：提货-->交付-->回车登记，只有三个阶段完全完成才可以进行下一个任务。

4.1待提货说明

1. 司机只有不存在在途或者已交付任务时才可以提货
2. 司机有且只能有一个任务可以提货，而且最早提货时间的任务
3. 提货时必须上传回单凭证和货品图片

4.2交付说明

1. 交付任务任何时候最多只有一个
2. 交付时必须上传回单凭证和货品图片

4.3回车登记说明

1. 任务交付完成之后还必须进行回车登记，否则无法开启下一个任务
2. 回车登记必须填写是否违章、是否故障、是否事故信息
3. 回车登记默认车辆是可用状态，如果车辆不可用，是否可用选项必选是