66 lines
3.2 KiB
Markdown
66 lines
3.2 KiB
Markdown
# sl-express-ms-web-driver使用手册
|
||
## 1.说明
|
||
**该模块为司机端web微服务，主要提供司机端APP各项服务。**<br />主要功能：
|
||
|
||
- 司机账号登录
|
||
- 用户个人信息、绑定车辆信息、任务数据（任务数量、里程统计）
|
||
- 司机任务查询、延迟提货、提货、交付、回车登记、联系调度中心
|
||
- 公告、系统通知的消息通知
|
||
|
||
## 2.服务配置
|
||
### 2.1配置信息
|
||
- 服务需要接入权限系统，所以需要配置权限系统应用id
|
||
- 司机取消任务需要联系调度员，所以需要配置调度员角色id
|
||
- 司机提货、交付、回车登记需要上传图片，所以需要配置阿里云oss
|
||
|
||
```properties
|
||
#权限系统应用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](/zh-cn/new-function.md) |
|
||
| sl-express-ms-base-api | 1.0-SNAPSHOT | [基础微服务](/zh-cn/modules/sl-express-ms-base.md) |
|
||
| sl-express-ms-work-api | 1.0-SNAPSHOT | [work微服务](/zh-cn/modules/sl-express-ms-work.md) |
|
||
| sl-express-ms-transport-api | 1.0-SNAPSHOT | [运输微服务](/zh-cn/modules/sl-express-ms-transport.md) |
|
||
| sl-express-ms-driver-api | 1.0-SNAPSHOT | [司机微服务](/zh-cn/modules/sl-express-ms-driver.md) |
|
||
|
||
## 3.技术方案
|
||
阿里云OSS：
|
||
[阿里云OSS-SDK示例](https://help.aliyun.com/document_detail/84781.htm?spm=a2c4g.11186623.0.0.56636ac1wg2W0I#t22269.html)
|
||
|
||
## 4.使用
|
||
概述：司机的每个任务要经过三个阶段：`提货-->交付-->回车登记`，只有三个阶段完全完成才可以进行下一个任务。
|
||
|
||
### 4.1待提货说明
|
||
1. 司机只有不存在在途或者已交付任务时才可以提货
|
||
2. 司机有且只能有一个任务可以提货，而且最早提货时间的任务
|
||
3. 提货时必须上传回单凭证和货品图片
|
||
|
||
### 4.2交付说明
|
||
1. 交付任务任何时候最多只有一个
|
||
2. 交付时必须上传回单凭证和货品图片
|
||
|
||
### 4.3回车登记说明
|
||
1. 任务交付完成之后还必须进行回车登记，否则无法开启下一个任务
|
||
2. 回车登记必须填写是否违章、是否故障、是否事故信息
|
||
3. 回车登记默认车辆是可用状态，如果车辆不可用，`是否可用`选项必选`是`
|