|
|
@@ -0,0 +1,65 @@
|
|
|
+# 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. 回车登记默认车辆是可用状态，如果车辆不可用，`是否可用`选项必选`是`
|
