mysql backup

docker-compose-3.129/test.md

@@ -0,0 +1,75 @@
+# 司机/车辆信息核验接口文档
+
+## 一、接口规范
+
+### 1.1 信息提交接口（服务商→中道）
+
+**接口地址**: `/provider/driver-info`  
+**请求方式**: POST  
+**Content-Type**: application/json
+
+#### 请求参数说明：
+
+| 参数名               | 必填 | 类型   | 说明                                                                 |
+|----------------------|------|--------|--------------------------------------------------------------------|
+| providerCode         | 是   | String | 服务商编码（由中道分配）                                           |
+| operateType          | 是   | String | 操作类型：1-新增 2-修改 3-停用                                     |
+| rescueNo             | 是   | String | 救援师傅工号（唯一标识）                                           |
+| rescueName           | 是   | String | 师傅姓名                                                           |
+| rescuePhone          | 是   | String | 师傅联系电话                                                       |
+| sex                  | 是   | String | 性别：0-女 1-男                                                   |
+| identity             | 是   | String | 身份证号码                                                         |
+| nonMotorVehicle      | 是   | String | 是否非机动车驾驶员：1-是 0-否（选1时驾照相关字段可不填）            |
+| identityPhoto_1      | 是   | String | 身份证正面照片URL                                                  |
+| identityPhoto_2      | 是   | String | 身份证反面照片URL                                                  |
+| licenseType          | 否   | String | 驾照类型（A1/A2/A3/B1/B2/C1/C2）                                   |
+| licenseStartDay      | 否   | String | 驾照领证时间（格式：yyyy-MM-dd）                                   |
+| licenseEndDay        | 否   | String | 驾照失效时间（格式：yyyy-MM-dd）                                   |
+| LicensePhoto         | 否   | String | 驾照照片URL                                                        |
+| rescuePersonPhoto    | 否   | String | 师傅正面照URL                                                      |
+| belongType           | 是   | String | 归属类型：1-自有师傅 0-外协师傅                                    |
+| timestamp            | 是   | String | 请求时间戳（格式：yyyy-MM-dd HH:mm:ss）                            |
+
+### 1.2 核验通知接口（中道→服务商）
+
+**回调地址**: 需服务商提前配置  
+**通知方式**: POST  
+**Content-Type**: application/json
+
+#### 通知参数说明：
+
+| 参数名        | 必填 | 类型   | 说明                                   |
+|---------------|------|--------|--------------------------------------|
+| providerCode  | 是   | String | 服务商编码                           |
+| rescueNo      | 是   | String | 救援工号                             |
+| status        | 是   | String | 核验状态：certifying/fail/success/expired |
+| timestamp     | 是   | String | 状态变更时间（格式同上）             |
+| remark        | 否   | String | 失败原因说明                         |
+
+## 二、业务流程
+
+```mermaid
+sequenceDiagram
+    participant 服务商系统
+    participant 中道系统
+    
+    服务商系统->>中道系统: 提交司机信息（/provider/driver-info）
+    中道系统-->>服务商系统: 返回受理结果
+    
+    alt 数据校验失败
+        中道系统-->>服务商系统: code=2001
+    else 校验通过
+        中道系统->>中道系统: 状态变更为「认证中」
+        
+        loop 核验流程
+            中道系统->>中道系统: 人工审核/系统核验
+        end
+        
+        中道系统->>服务商系统: POST核验通知（/provider/verification-notify）
+        
+        alt 核验成功
+            服务商系统->>服务商系统: 锁定认证字段
+        else 核验失败/过期
+            服务商系统->>服务商系统: 开放对应修改权限
+        end
+    end