后台swagger添加

docs/swagger.yaml

@@ -23,6 +23,44 @@ definitions:
       tokenType:
         type: string
     type: object
+  carsrv.AddCarReqVO:
+    properties:
+      carNumber:
+        type: string
+      carType:
+        type: string
+      driver:
+        $ref: '#/definitions/global.ClodAccount'
+      enable:
+        type: integer
+      snCode:
+        type: string
+    type: object
+  carsrv.CarIdRespVO:
+    properties:
+      carId:
+        type: integer
+    type: object
+  carsrv.DriverLogReqVO:
+    properties:
+      carId:
+        type: integer
+    type: object
+  carsrv.UpdateCarReqVO:
+    properties:
+      carId:
+        type: integer
+      carNumber:
+        type: string
+      carType:
+        type: string
+      driver:
+        $ref: '#/definitions/global.ClodAccount'
+      enable:
+        type: integer
+      snCode:
+        type: string
+    type: object
   commonsrv.ProvinceListRespVO:
     properties:
       children:
@@ -62,6 +100,13 @@ definitions:
     - LastThreeDays
     - LastSevenDays
     - LastMonthDays
+  dao.StaticNumData:
+    properties:
+      orderCount:
+        type: integer
+      xKey:
+        type: string
+    type: object
   devicesrv.DeviceSensorListReqVO:
     properties:
       snCode:
@@ -110,6 +155,15 @@ definitions:
       singTime:
         $ref: '#/definitions/models.MyTime'
     type: object
+  global.ClodAccount:
+    properties:
+      name:
+        type: string
+      pid:
+        type: integer
+      uuid:
+        type: string
+    type: object
   global.SnIdVO:
     properties:
       id:
@@ -122,6 +176,20 @@ definitions:
       time.Time:
         type: string
     type: object
+  models.TimeStatType:
+    enum:
+    - year
+    - month
+    - day
+    type: string
+    x-enum-comments:
+      TimeStatDay: 日
+      TimeStatMonth: 月
+      TimeStatYear: 年
+    x-enum-varnames:
+    - TimeStatYear
+    - TimeStatMonth
+    - TimeStatDay
   myselfsrv.AddAddressReqVO:
     properties:
       address:
@@ -278,6 +346,26 @@ definitions:
         description: 区中文名
         type: string
     type: object
+  ordersrv.AssignOrderReqVO:
+    properties:
+      destination:
+        description: 目的地：dest-终点 transit-中转
+        type: string
+      driver:
+        $ref: '#/definitions/global.ClodAccount'
+      freight:
+        description: 运费分
+        type: integer
+      orderId:
+        description: 运单ID
+        type: integer
+    type: object
+  ordersrv.AssignOrderRespVO:
+    properties:
+      orderId:
+        description: 运单ID
+        type: integer
+    type: object
   ordersrv.LocationInfoVO:
     properties:
       contactPerson:
@@ -459,6 +547,19 @@ definitions:
         description: 订单状态
         type: integer
     type: object
+  statisticsrv.OrderNumTimeStatReqVO:
+    properties:
+      orderStatus:
+        type: integer
+      statType:
+        allOf:
+        - $ref: '#/definitions/models.TimeStatType'
+        description: 年，月，天
+      timeEnd:
+        $ref: '#/definitions/models.MyTime'
+      timeStart:
+        $ref: '#/definitions/models.MyTime'
+    type: object
   swagger.AccountInfoVo:
     properties:
       accountId:
@@ -516,6 +617,20 @@ definitions:
       reference:
         description: 关联信息
     type: object
+  swagger.CarPageReqVO:
+    properties:
+      page:
+        $ref: '#/definitions/swagger.Page'
+      search:
+        properties:
+          carNumber:
+            type: string
+          driverAccountUuid:
+            type: string
+          snCode:
+            type: string
+        type: object
+    type: object
   swagger.FileSource:
     properties:
       fileCode:
@@ -527,6 +642,11 @@ definitions:
       fileUrl:
         type: string
     type: object
+  swagger.ListResponse:
+    properties:
+      list:
+        description: 列表数据信息
+    type: object
   swagger.LogisticListReqVO:
     properties:
       page:
@@ -544,6 +664,34 @@ definitions:
       page:
         $ref: '#/definitions/swagger.Page'
     type: object
+  swagger.ManageOrderPageReqVO:
+    properties:
+      page:
+        $ref: '#/definitions/swagger.Page'
+      search:
+        properties:
+          orderNo:
+            type: string
+          orderStatus:
+            type: integer
+        type: object
+    type: object
+  swagger.OrderNumUserStatReqVO:
+    properties:
+      page:
+        $ref: '#/definitions/swagger.Page'
+      search:
+        properties:
+          orderStatus:
+            type: integer
+          statType:
+            $ref: '#/definitions/models.TimeStatType'
+          timeEnd:
+            $ref: '#/definitions/models.MyTime'
+          timeStart:
+            $ref: '#/definitions/models.MyTime'
+        type: object
+    type: object
   swagger.OrderPageReqVO:
     properties:
       page:
@@ -624,6 +772,18 @@ definitions:
       status:
         type: integer
     type: object
+  swagger.UserListReqVO:
+    properties:
+      page:
+        $ref: '#/definitions/swagger.Page'
+      search:
+        properties:
+          name:
+            type: string
+        type: object
+      userTokey:
+        type: string
+    type: object
   swagger.WarehouseOrderReqVO:
     properties:
       page:
@@ -638,6 +798,36 @@ definitions:
             $ref: '#/definitions/models.MyTime'
         type: object
     type: object
+  swagger.WarehousePageReqVO:
+    properties:
+      page:
+        $ref: '#/definitions/swagger.Page'
+      search:
+        properties:
+          name:
+            type: string
+          snCode:
+            type: string
+        type: object
+    type: object
+  warehousesrv.AddWarehouseReqVO:
+    properties:
+      address:
+        description: 地址
+        type: string
+      enable:
+        type: integer
+      manage:
+        items:
+          $ref: '#/definitions/global.ClodAccount'
+        type: array
+      name:
+        description: 仓库名称
+        type: string
+      snCode:
+        description: sn编码
+        type: string
+    type: object
   warehousesrv.OrderIntoHouseReqVO:
     properties:
       orderId:
@@ -652,6 +842,31 @@ definitions:
       orderNo:
         type: string
     type: object
+  warehousesrv.UpdateWarehouseReqVO:
+    properties:
+      address:
+        description: 地址
+        type: string
+      enable:
+        type: integer
+      manage:
+        items:
+          $ref: '#/definitions/global.ClodAccount'
+        type: array
+      name:
+        description: 仓库名称
+        type: string
+      snCode:
+        description: sn编码
+        type: string
+      warehouseId:
+        type: integer
+    type: object
+  warehousesrv.WarehouseIdRespVO:
+    properties:
+      warehouseId:
+        type: integer
+    type: object
   warehousesrv.WarehouseInfoRespVO:
     properties:
       name:
@@ -666,7 +881,7 @@ definitions:
 info:
   contact: {}
 paths:
-  /address/add:
+  /app/address/add:
     post:
       consumes:
       - application/json
@@ -685,7 +900,7 @@ paths:
       summary: 设备数据列表
       tags:
       - 公共接口
-  /auth/login:
+  /app/auth/login:
     post:
       consumes:
       - application/json
@@ -704,7 +919,7 @@ paths:
       summary: 小程序登录
       tags:
       - 登录
-  /auth/loginOut:
+  /app/auth/loginOut:
     post:
       consumes:
       - application/json
@@ -720,7 +935,7 @@ paths:
       summary: 登出
       tags:
       - 登录
-  /auth/wechatCallback:
+  /app/auth/wechatCallback:
     post:
       consumes:
       - application/json
@@ -743,7 +958,7 @@ paths:
       summary: 获取微信返回的授权码
       tags:
       - 登录
-  /auth/wechatLogin:
+  /app/auth/wechatLogin:
     post:
       consumes:
       - application/json
@@ -755,7 +970,7 @@ paths:
       summary: 微信扫码登录
       tags:
       - 登录
-  /common/logisticList:
+  /app/common/logisticList:
     get:
       consumes:
       - application/json
@@ -774,7 +989,7 @@ paths:
       summary: 物流公司列表
       tags:
       - 公共接口
-  /common/provinceList:
+  /app/common/provinceList:
     get:
       consumes:
       - application/json
@@ -786,7 +1001,7 @@ paths:
       summary: 省市区列表
       tags:
       - 公共接口
-  /driver/carInfo:
+  /app/driver/carInfo:
     post:
       consumes:
       - application/json
@@ -798,7 +1013,7 @@ paths:
       summary: 车辆信息
       tags:
       - 司机
-  /driver/orderIntoCar:
+  /app/driver/orderIntoCar:
     post:
       consumes:
       - application/json
@@ -817,7 +1032,26 @@ paths:
       summary: 装车
       tags:
       - 司机
-  /driver/signReceipt:
+  /app/driver/scanIntoCar:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/driversrv.ScanIntoReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/driversrv.OrderIntoCarRespVO'
+      summary: 扫码装车
+      tags:
+      - 司机
+  /app/driver/signReceipt:
     post:
       consumes:
       - application/json
@@ -840,7 +1074,7 @@ paths:
       summary: 签收
       tags:
       - 司机
-  /driver/taskPage:
+  /app/driver/taskPage:
     post:
       consumes:
       - application/json
@@ -859,7 +1093,7 @@ paths:
       summary: 司机任务列表
       tags:
       - 司机
-  /myself/address/add:
+  /app/myself/address/add:
     post:
       consumes:
       - application/json
@@ -878,7 +1112,7 @@ paths:
       summary: 添加寄件/收件人
       tags:
       - 用户-我的
-  /myself/address/delete:
+  /app/myself/address/delete:
     post:
       consumes:
       - application/json
@@ -897,7 +1131,7 @@ paths:
       summary: 删除寄件/收件人
       tags:
       - 用户-我的
-  /myself/address/page:
+  /app/myself/address/page:
     post:
       consumes:
       - application/json
@@ -916,7 +1150,7 @@ paths:
       summary: 寄件/收件人列表
       tags:
       - 用户-我的
-  /myself/address/update:
+  /app/myself/address/update:
     post:
       consumes:
       - application/json
@@ -935,7 +1169,7 @@ paths:
       summary: 修改寄件/收件人
       tags:
       - 用户-我的
-  /myself/info:
+  /app/myself/info:
     get:
       consumes:
       - application/json
@@ -947,7 +1181,7 @@ paths:
       summary: 个人信息
       tags:
       - 用户-我的
-  /myself/logisticCompany/add:
+  /app/myself/logisticCompany/add:
     post:
       consumes:
       - application/json
@@ -966,7 +1200,7 @@ paths:
       summary: 物流公司添加
       tags:
       - 用户-我的
-  /myself/logisticCompany/delete:
+  /app/myself/logisticCompany/delete:
     post:
       consumes:
       - application/json
@@ -985,7 +1219,7 @@ paths:
       summary: 物流公司删除
       tags:
       - 用户-我的
-  /myself/logisticCompany/page:
+  /app/myself/logisticCompany/page:
     post:
       consumes:
       - application/json
@@ -1004,7 +1238,7 @@ paths:
       summary: 物流公司列表
       tags:
       - 用户-我的
-  /myself/orderDetail:
+  /app/myself/orderDetail:
     post:
       consumes:
       - application/json
@@ -1023,7 +1257,7 @@ paths:
       summary: 订单详情
       tags:
       - 用户-我的
-  /myself/orderPage:
+  /app/myself/orderPage:
     post:
       consumes:
       - application/json
@@ -1042,7 +1276,7 @@ paths:
       summary: 订单列表
       tags:
       - 用户-我的
-  /myself/orderSubNo:
+  /app/myself/orderSubNo:
     post:
       consumes:
       - application/json
@@ -1061,7 +1295,7 @@ paths:
       summary: 订单揽件码
       tags:
       - 用户-我的
-  /myself/placeOrder:
+  /app/myself/placeOrder:
     post:
       consumes:
       - application/json
@@ -1080,7 +1314,7 @@ paths:
       summary: 下单
       tags:
       - 用户-我的
-  /myself/refreshToken:
+  /app/myself/refreshToken:
     post:
       consumes:
       - application/json
@@ -1092,7 +1326,7 @@ paths:
       summary: 刷新token
       tags:
       - 用户-我的
-  /myself/update:
+  /app/myself/update:
     post:
       consumes:
       - application/json
@@ -1111,7 +1345,7 @@ paths:
       summary: 修改个人信息
       tags:
       - 用户-我的
-  /public/deviceSensorList:
+  /app/public/deviceSensorList:
     post:
       consumes:
       - application/json
@@ -1130,7 +1364,7 @@ paths:
       summary: 设备探头列表
       tags:
       - 公开接口不登录
-  /public/logisticDetail:
+  /app/public/logisticDetail:
     post:
       consumes:
       - application/json
@@ -1149,7 +1383,7 @@ paths:
       summary: 物流详情
       tags:
       - 公开接口不登录
-  /public/queryOrder:
+  /app/public/queryOrder:
     post:
       consumes:
       - application/json
@@ -1168,7 +1402,7 @@ paths:
       summary: 查运单
       tags:
       - 公开接口不登录
-  /public/sensorDataList:
+  /app/public/sensorDataList:
     post:
       consumes:
       - application/json
@@ -1187,7 +1421,7 @@ paths:
       summary: 设备数据列表
       tags:
       - 公开接口不登录
-  /warehouse/info:
+  /app/warehouse/info:
     post:
       consumes:
       - application/json
@@ -1199,7 +1433,7 @@ paths:
       summary: 仓库信息
       tags:
       - 仓管
-  /warehouse/orderInto:
+  /app/warehouse/orderInto:
     post:
       consumes:
       - application/json
@@ -1218,7 +1452,7 @@ paths:
       summary: 订单入库
       tags:
       - 仓管
-  /warehouse/orderOutHouse:
+  /app/warehouse/orderOutHouse:
     post:
       consumes:
       - application/json
@@ -1237,7 +1471,7 @@ paths:
       summary: 订单出库
       tags:
       - 仓管
-  /warehouse/orderPage:
+  /app/warehouse/orderPage:
     post:
       consumes:
       - application/json
@@ -1256,4 +1490,327 @@ paths:
       summary: 库中订单列表
       tags:
       - 仓管
+  /manage/car/add:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/carsrv.AddCarReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/carsrv.CarIdRespVO'
+      summary: 添加车辆
+      tags:
+      - 后台-车辆管理
+  /manage/car/driverLog:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/carsrv.DriverLogReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/swagger.ListResponse'
+      summary: 车辆既往司机
+      tags:
+      - 后台-车辆管理
+  /manage/car/page:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/swagger.CarPageReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/swagger.PageListResponse'
+      summary: 车辆列表
+      tags:
+      - 后台-车辆管理
+  /manage/car/update:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/carsrv.UpdateCarReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/carsrv.CarIdRespVO'
+      summary: 修改车辆
+      tags:
+      - 后台-车辆管理
+  /manage/common/deviceSensorList:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/devicesrv.DeviceSensorListReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/devicesrv.DeviceSensorListRespVO'
+      summary: 设备探头列表
+      tags:
+      - 后台-公共接口
+  /manage/common/sensorDataList:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/swagger.SnDataListReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/swagger.PageListResponse'
+      summary: 设备数据列表
+      tags:
+      - 后台-公共接口
+  /manage/common/userList:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/swagger.UserListReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/swagger.PageListResponse'
+      summary: 用户列表
+      tags:
+      - 后台-公共接口
+  /manage/order/assign:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/ordersrv.AssignOrderReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/ordersrv.AssignOrderRespVO'
+      summary: 派单订单
+      tags:
+      - 后台-订单管理
+  /manage/order/detail:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/ordersrv.OrderDetailReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/ordersrv.OrderDetailRespVO'
+      summary: 订单详情
+      tags:
+      - 后台-订单管理
+  /manage/order/logistic:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/ordersrv.OrderLogisticDetailReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/ordersrv.OrderLogisticDetailRespVO'
+      summary: 物流详情
+      tags:
+      - 后台-订单管理
+  /manage/order/page:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/swagger.ManageOrderPageReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/swagger.PageListResponse'
+      summary: 订单列表
+      tags:
+      - 后台-订单管理
+  /manage/statistic/orderNum/byTime:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/statisticsrv.OrderNumTimeStatReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/dao.StaticNumData'
+      summary: 根据订单开始时间统计
+      tags:
+      - 后台-统计
+  /manage/statistic/orderNum/byUser:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/swagger.OrderNumUserStatReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/swagger.PageListResponse'
+      summary: 根据订单用户统计
+      tags:
+      - 后台-统计
+  /manage/warehouse/add:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/warehousesrv.AddWarehouseReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/warehousesrv.WarehouseIdRespVO'
+      summary: 添加仓库
+      tags:
+      - 后台-仓库管理
+  /manage/warehouse/orderPage:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/swagger.WarehousePageReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/swagger.PageListResponse'
+      summary: 仓库订单列表
+      tags:
+      - 后台-仓库管理
+  /manage/warehouse/page:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/swagger.WarehousePageReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/swagger.PageListResponse'
+      summary: 仓库列表
+      tags:
+      - 后台-仓库管理
+  /manage/warehouse/update:
+    post:
+      consumes:
+      - application/json
+      parameters:
+      - description: 请求参数
+        in: body
+        name: req
+        required: true
+        schema:
+          $ref: '#/definitions/warehousesrv.UpdateWarehouseReqVO'
+      responses:
+        "200":
+          description: 成功响应的结构体
+          schema:
+            $ref: '#/definitions/warehousesrv.WarehouseIdRespVO'
+      summary: 修改仓库
+      tags:
+      - 后台-仓库管理
 swagger: "2.0"

internal/server/adapter/adapter.go

@@ -22,7 +22,7 @@ func HttpRoutes() func(r *gin.Engine) {
 		swagger.RegisterSwagger(r)
 
 		// 用户端
-		app := r.Group("/clodLogistic/app/api/v1")
+		app := r.Group("/clodLogistic/api/v1/app")
 		auth.Register(app)
 		// 我的
 		myself.Register(app)
@@ -34,7 +34,7 @@ func HttpRoutes() func(r *gin.Engine) {
 		common.Register(app)
 
 		// 管理后台
-		admin := r.Group("/clodLogistic/manage/api/v1")
+		admin := r.Group("/clodLogistic/api/v1/manage")
 		manage.Register(admin)
 
 	}

internal/server/adapter/http/v1/auth/auth.go

@@ -43,7 +43,7 @@ func NewApi() Api {
 // @Param req body authsrv.LoginReqVo true "登录"
 // @Accept application/json
 // @Authorization Bearer
-// @Router /auth/login [post]
+// @Router /app/auth/login [post]
 func (api Api) login(c *gin.Context) {
 	req := authsrv.LoginReqVo{}
 	if err := c.ShouldBindJSON(&req); err != nil {
@@ -85,7 +85,7 @@ func (api Api) login(c *gin.Context) {
 // @Success 200 {object}  authsrv.LoginRespVo
 // @Accept application/json
 // @Authorization Bearer
-// @Router /auth/wechatLogin [post]
+// @Router /app/auth/wechatLogin [post]
 func (api Api) wechatLogin(c *gin.Context) {
 	appId := options.OptInstance.Wechat.AppId
 	state := ""                                                            //防止跨站请求伪造攻击 增加安全性
@@ -118,7 +118,7 @@ func (api Api) wechatLogin(c *gin.Context) {
 // @Param req body authsrv.LoginReqVo true "登录"
 // @Accept application/json
 // @Authorization Bearer
-// @Router /auth/wechatCallback [post]
+// @Router /app/auth/wechatCallback [post]
 func (api Api) wechatCallBack(c *gin.Context) {
 	// 获取微信返回的授权码
 	code := c.Query("code")
@@ -187,7 +187,7 @@ func (api Api) wechatCallBack(c *gin.Context) {
 // @Success 200 {string}  "success"
 // @Accept application/json
 // @Authorization Bearer
-// @Router /auth/loginOut [post]
+// @Router /app/auth/loginOut [post]
 func (api Api) LoginOut(c *gin.Context) {
 	srv := authsrv.NewAuthService(dao.NewDataStore(global.CommonConnectRepoInst.StoreDB))
 	err := srv.LoginOut(c)

internal/server/adapter/http/v1/common/api.go

@@ -35,7 +35,7 @@ func NewApi() Api {
 // @Success 200 {object}  commonsrv.ProvinceListRespVO "成功响应的结构体"
 // @Accept application/json
 // @Authorization
-// @Router /common/provinceList [get]
+// @Router /app/common/provinceList [get]
 func (api Api) provinceList(c *gin.Context) {
 	srv := commonsrv.NewCommonService(dao.NewDataStore(global.CommonConnectRepoInst.StoreDB))
 	data, err := srv.ProvinceList(c)
@@ -54,7 +54,7 @@ func (api Api) provinceList(c *gin.Context) {
 // @Param  req body swagger.SnDataListReqVO true "请求参数"
 // @Accept application/json
 // @Authorization Bearer
-// @Router /address/add [post]
+// @Router /app/address/add [post]
 func (api Api) sensorDataList(c *gin.Context) {
 	req := devicesrv.SnDataListReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -84,7 +84,7 @@ func (api Api) sensorDataList(c *gin.Context) {
 // @Param  req body swagger.LogisticListReqVO true "请求参数"
 // @Accept application/json
 // @Authorization Bearer
-// @Router /common/logisticList [get]
+// @Router /app/common/logisticList [get]
 func (api Api) logisticList(c *gin.Context) {
 	req := commonsrv.LogisticListReqVO{}
 	if err := c.BindJSON(&req); err != nil {

internal/server/adapter/http/v1/insider/driver.go

@@ -12,12 +12,10 @@ import (
 
 // carInfo
 // @Tags 司机
-// @BasePath /clodLogistic/app/api/v1
 // @Summary 车辆信息
 // @Success 200 {object}  driversrv.DriverCarInfoRespVO "成功响应的结构体"
 // @Accept application/json
-// @Authorization
-// @Router /driver/carInfo [post]
+// @Router /app/driver/carInfo [post]
 func (api Api) carInfo(c *gin.Context) {
 	srv := driversrv.NewDriverService(dao.NewDataStore(global.CommonConnectRepoInst.StoreDB))
 	res, err := srv.DriverCarInfo(c)
@@ -30,13 +28,11 @@ func (api Api) carInfo(c *gin.Context) {
 
 // taskPage
 // @Tags 司机
-// @BasePath /clodLogistic/app/api/v1
 // @Summary 司机任务列表
 // @Success 200 {object}  swagger.PageListResponse "成功响应的结构体"
 // @Param  req body swagger.TaskPageReqVO true "请求参数"
 // @Accept application/json
-// @Authorization
-// @Router /driver/taskPage [post]
+// @Router /app/driver/taskPage [post]
 func (api Api) taskPage(c *gin.Context) {
 	req := driversrv.TaskPageReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -61,13 +57,11 @@ func (api Api) taskPage(c *gin.Context) {
 
 // orderIntoCar
 // @Tags 司机
-// @BasePath /clodLogistic/app/api/v1
 // @Summary 装车
 // @Success 200 {object}  driversrv.OrderIntoCarRespVO "成功响应的结构体"
 // @Param  req body driversrv.OrderIntoCarReqVO true "请求参数"
 // @Accept application/json
-// @Authorization
-// @Router /driver/orderIntoCar [post]
+// @Router /app/driver/orderIntoCar [post]
 func (api Api) orderIntoCar(c *gin.Context) {
 	req := driversrv.OrderIntoCarReqVO{}
 	if err := c.ShouldBindJSON(&req); err != nil {
@@ -89,6 +83,13 @@ func (api Api) orderIntoCar(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// orderIntoCar
+// @Tags 司机
+// @Summary 扫码装车
+// @Success 200 {object}  driversrv.OrderIntoCarRespVO "成功响应的结构体"
+// @Param  req body driversrv.ScanIntoReqVO true "请求参数"
+// @Accept application/json
+// @Router /app/driver/scanIntoCar [post]
 func (api Api) scanIntoCar(c *gin.Context) {
 	req := driversrv.ScanIntoReqVO{}
 	if err := c.ShouldBindJSON(&req); err != nil {
@@ -112,14 +113,12 @@ func (api Api) scanIntoCar(c *gin.Context) {
 
 // orderIntoCar
 // @Tags 司机
-// @BasePath /clodLogistic/app/api/v1
 // @Summary 签收
 // @Success 200 {object}  driversrv.SignReceiptRespVO "成功响应的结构体"
 // @Param  req body driversrv.ScanIntoReqVO true "请求参数"
 // @failure 400 {string} codex.ErrBindJSON "error"
 // @Accept application/json
-// @Authorization
-// @Router /driver/signReceipt [post]
+// @Router /app/driver/signReceipt [post]
 func (api Api) signReceipt(c *gin.Context) {
 	req := driversrv.ScanIntoReqVO{}
 	if err := c.ShouldBindJSON(&req); err != nil {

internal/server/adapter/http/v1/insider/house.go

@@ -12,12 +12,10 @@ import (
 
 // houseInfo
 // @Tags 仓管
-// @BasePath /clodLogistic/app/api/v1
 // @Summary 仓库信息
 // @Success 200 {object}  warehousesrv.WarehouseInfoRespVO "成功响应的结构体"
 // @Accept application/json
-// @Authorization
-// @Router /warehouse/info [post]
+// @Router /app/warehouse/info [post]
 func (api Api) houseInfo(c *gin.Context) {
 	srv := warehousesrv.NewWarehouseService(dao.NewDataStore(global.CommonConnectRepoInst.StoreDB))
 	res, err := srv.WarehouseInfo(c)
@@ -30,13 +28,11 @@ func (api Api) houseInfo(c *gin.Context) {
 
 // warehouseOrder
 // @Tags 仓管
-// @BasePath /clodLogistic/app/api/v1
 // @Summary 库中订单列表
 // @Success 200 {object}  swagger.PageListResponse "成功响应的结构体"
 // @Param  req body swagger.WarehouseOrderReqVO true "请求参数"
 // @Accept application/json
-// @Authorization
-// @Router /warehouse/orderPage [post]
+// @Router /app/warehouse/orderPage [post]
 func (api Api) warehouseOrder(c *gin.Context) {
 	req := warehousesrv.WarehouseOrderReqVO{}
 	if err := c.ShouldBindJSON(&req); err != nil {
@@ -55,13 +51,11 @@ func (api Api) warehouseOrder(c *gin.Context) {
 
 // orderIntoHouse
 // @Tags 仓管
-// @BasePath /clodLogistic/app/api/v1
 // @Summary 订单入库
 // @Success 200 {object}  warehousesrv.OrderIntoHouseRespVO "成功响应的结构体"
 // @Param  req body warehousesrv.OrderIntoHouseReqVO true "请求参数"
 // @Accept application/json
-// @Authorization
-// @Router /warehouse/orderInto [post]
+// @Router /app/warehouse/orderInto [post]
 func (api Api) orderIntoHouse(c *gin.Context) {
 	req := warehousesrv.OrderIntoHouseReqVO{}
 	if err := c.ShouldBindJSON(&req); err != nil {
@@ -85,13 +79,11 @@ func (api Api) orderIntoHouse(c *gin.Context) {
 
 // orderOutHouse
 // @Tags 仓管
-// @BasePath /clodLogistic/app/api/v1
 // @Summary 订单出库
 // @Success 200 {object}  warehousesrv.OrderIntoHouseRespVO "成功响应的结构体"
 // @Param  req body warehousesrv.OrderIntoHouseReqVO true "请求参数"
 // @Accept application/json
-// @Authorization
-// @Router /warehouse/orderOutHouse [post]
+// @Router /app/warehouse/orderOutHouse [post]
 func (api Api) orderOutHouse(c *gin.Context) {
 	req := warehousesrv.OrderIntoHouseReqVO{}
 	if err := c.ShouldBindJSON(&req); err != nil {

internal/server/adapter/http/v1/manage/car.go

@@ -10,6 +10,13 @@ import (
 	"gogs.baozhida.cn/Cold_Logistic_libs/pkg/contrib/errors"
 )
 
+// carPage
+// @Tags 后台-车辆管理
+// @Summary 车辆列表
+// @Success 200 {object}  swagger.PageListResponse "成功响应的结构体"
+// @Param  req body swagger.CarPageReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/car/page [post]
 func (api Api) carPage(c *gin.Context) {
 	req := carsrv.CarPageReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -26,6 +33,13 @@ func (api Api) carPage(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// addCar
+// @Tags 后台-车辆管理
+// @Summary 添加车辆
+// @Success 200 {object}  carsrv.CarIdRespVO "成功响应的结构体"
+// @Param  req body carsrv.AddCarReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/car/add [post]
 func (api Api) addCar(c *gin.Context) {
 	req := carsrv.AddCarReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -47,6 +61,13 @@ func (api Api) addCar(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// updateCar
+// @Tags 后台-车辆管理
+// @Summary 修改车辆
+// @Success 200 {object}  carsrv.CarIdRespVO "成功响应的结构体"
+// @Param  req body carsrv.UpdateCarReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/car/update [post]
 func (api Api) updateCar(c *gin.Context) {
 	req := carsrv.UpdateCarReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -68,6 +89,13 @@ func (api Api) updateCar(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// updateCar
+// @Tags 后台-车辆管理
+// @Summary 车辆既往司机
+// @Success 200 {object}  swagger.ListResponse "成功响应的结构体"
+// @Param  req body carsrv.DriverLogReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/car/driverLog [post]
 func (api Api) driverLog(c *gin.Context) {
 	req := carsrv.DriverLogReqVO{}
 	if err := c.BindJSON(&req); err != nil {

internal/server/adapter/http/v1/manage/common.go

@@ -11,7 +11,13 @@ import (
 	"gogs.baozhida.cn/Cold_Logistic_libs/pkg/contrib/errors"
 )
 
-// userList 用户列表
+// userList
+// @Tags 后台-公共接口
+// @Summary 用户列表
+// @Success 200 {object}  swagger.PageListResponse "成功响应的结构体"
+// @Param  req body swagger.UserListReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/common/userList [post]
 func (api Api) userList(c *gin.Context) {
 	req := commonsrv.UserListReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -28,6 +34,13 @@ func (api Api) userList(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// deviceSensorList
+// @Tags 后台-公共接口
+// @Summary 设备探头列表
+// @Success 200 {object}  devicesrv.DeviceSensorListRespVO "成功响应的结构体"
+// @Param  req body devicesrv.DeviceSensorListReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/common/deviceSensorList [post]
 func (api Api) deviceSensorList(c *gin.Context) {
 	req := devicesrv.DeviceSensorListReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -49,6 +62,13 @@ func (api Api) deviceSensorList(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// snDataList
+// @Tags 后台-公共接口
+// @Summary 设备数据列表
+// @Success 200 {object}  swagger.PageListResponse "成功响应的结构体"
+// @Param  req body swagger.SnDataListReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/common/sensorDataList [post]
 func (api Api) snDataList(c *gin.Context) {
 	req := devicesrv.SnDataListReqVO{}
 	if err := c.BindJSON(&req); err != nil {

internal/server/adapter/http/v1/manage/order.go

@@ -10,6 +10,13 @@ import (
 	"gogs.baozhida.cn/Cold_Logistic_libs/pkg/contrib/errors"
 )
 
+// orderPage
+// @Tags 后台-订单管理
+// @Summary 订单列表
+// @Success 200 {object}  swagger.PageListResponse "成功响应的结构体"
+// @Param  req body swagger.ManageOrderPageReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/order/page [post]
 func (api Api) orderPage(c *gin.Context) {
 	req := ordersrv.ManageOrderPageReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -26,6 +33,13 @@ func (api Api) orderPage(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// orderDetail
+// @Tags 后台-订单管理
+// @Summary 订单详情
+// @Success 200 {object}  ordersrv.OrderDetailRespVO "成功响应的结构体"
+// @Param  req body ordersrv.OrderDetailReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/order/detail [post]
 func (api Api) orderDetail(c *gin.Context) {
 	req := ordersrv.OrderDetailReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -42,6 +56,13 @@ func (api Api) orderDetail(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// orderLogistic
+// @Tags 后台-订单管理
+// @Summary 物流详情
+// @Success 200 {object}  ordersrv.OrderLogisticDetailRespVO "成功响应的结构体"
+// @Param  req body ordersrv.OrderLogisticDetailReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/order/logistic [post]
 func (api Api) orderLogistic(c *gin.Context) {
 	req := ordersrv.OrderLogisticDetailReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -58,6 +79,13 @@ func (api Api) orderLogistic(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// orderAssign
+// @Tags 后台-订单管理
+// @Summary 派单订单
+// @Success 200 {object}  ordersrv.AssignOrderRespVO "成功响应的结构体"
+// @Param  req body ordersrv.AssignOrderReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/order/assign [post]
 func (api Api) orderAssign(c *gin.Context) {
 	req := ordersrv.AssignOrderReqVO{}
 	if err := c.BindJSON(&req); err != nil {

internal/server/adapter/http/v1/manage/statistic.go

@@ -10,6 +10,13 @@ import (
 	"gogs.baozhida.cn/Cold_Logistic_libs/pkg/contrib/errors"
 )
 
+// statOrderNumByTime
+// @Tags 后台-统计
+// @Summary 根据订单开始时间统计
+// @Success 200 {object}  dao.StaticNumData "成功响应的结构体"
+// @Param  req body statisticsrv.OrderNumTimeStatReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/statistic/orderNum/byTime [post]
 func (api Api) statOrderNumByTime(c *gin.Context) {
 	req := statisticsrv.OrderNumTimeStatReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -26,6 +33,13 @@ func (api Api) statOrderNumByTime(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// statOrderNumByUser
+// @Tags 后台-统计
+// @Summary 根据订单用户统计
+// @Success 200 {object}  swagger.PageListResponse "成功响应的结构体"
+// @Param  req body swagger.OrderNumUserStatReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/statistic/orderNum/byUser [post]
 func (api Api) statOrderNumByUser(c *gin.Context) {
 	req := statisticsrv.OrderNumUserStatReqVO{}
 	if err := c.BindJSON(&req); err != nil {

internal/server/adapter/http/v1/manage/warehouse.go

@@ -10,6 +10,13 @@ import (
 	"gogs.baozhida.cn/Cold_Logistic_libs/pkg/contrib/errors"
 )
 
+// warehousePage
+// @Tags 后台-仓库管理
+// @Summary 仓库列表
+// @Success 200 {object}  swagger.PageListResponse "成功响应的结构体"
+// @Param  req body swagger.WarehousePageReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/warehouse/page [post]
 func (api Api) warehousePage(c *gin.Context) {
 	req := warehousesrv.WarehousePageReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -26,6 +33,13 @@ func (api Api) warehousePage(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// addWarehouse
+// @Tags 后台-仓库管理
+// @Summary 添加仓库
+// @Success 200 {object}  warehousesrv.WarehouseIdRespVO "成功响应的结构体"
+// @Param  req body warehousesrv.AddWarehouseReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/warehouse/add [post]
 func (api Api) addWarehouse(c *gin.Context) {
 	req := warehousesrv.AddWarehouseReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -47,6 +61,13 @@ func (api Api) addWarehouse(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// updateWarehouse
+// @Tags 后台-仓库管理
+// @Summary 修改仓库
+// @Success 200 {object}  warehousesrv.WarehouseIdRespVO "成功响应的结构体"
+// @Param  req body warehousesrv.UpdateWarehouseReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/warehouse/update [post]
 func (api Api) updateWarehouse(c *gin.Context) {
 	req := warehousesrv.UpdateWarehouseReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -68,6 +89,13 @@ func (api Api) updateWarehouse(c *gin.Context) {
 	core.WriteResponse(c, nil, res)
 }
 
+// updateWarehouse
+// @Tags 后台-仓库管理
+// @Summary 仓库订单列表
+// @Success 200 {object}  swagger.PageListResponse "成功响应的结构体"
+// @Param  req body swagger.WarehousePageReqVO true "请求参数"
+// @Accept application/json
+// @Router /manage/warehouse/orderPage [post]
 func (api Api) warehouseOrder(c *gin.Context) {
 	req := warehousesrv.WarehouseOrderReqVO{}
 	if err := c.ShouldBindJSON(&req); err != nil {

internal/server/adapter/http/v1/myself/address.go

@@ -18,7 +18,7 @@ import (
 // @Param  req body swagger.AddressPageReqVO true "请求参数"
 // @Accept application/json
 // @Authorization
-// @Router /myself/address/page [post]
+// @Router /app/myself/address/page [post]
 func (api Api) addressPage(c *gin.Context) {
 	req := myselfsrv.AddressPageReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -48,7 +48,7 @@ func (api Api) addressPage(c *gin.Context) {
 // @Param  req body myselfsrv.AddAddressReqVO true "请求参数"
 // @Accept application/json
 // @Authorization
-// @Router /myself/address/add [post]
+// @Router /app/myself/address/add [post]
 func (api Api) addAddress(c *gin.Context) {
 	req := myselfsrv.AddAddressReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -78,7 +78,7 @@ func (api Api) addAddress(c *gin.Context) {
 // @Param  req body myselfsrv.UpdateAddressReqVO true "请求参数"
 // @Accept application/json
 // @Authorization
-// @Router /myself/address/update [post]
+// @Router /app/myself/address/update [post]
 func (api Api) updateAddress(c *gin.Context) {
 	req := myselfsrv.UpdateAddressReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -102,13 +102,11 @@ func (api Api) updateAddress(c *gin.Context) {
 
 // deleteAddress
 // @Tags 用户-我的
-// @BasePath /clodLogistic/app/api/v1
 // @Summary 删除寄件/收件人
 // @Success 200 {object}  swagger.BaseResponse "成功响应的结构体"
 // @Param  req body myselfsrv.DeleteAddressReqVO true "请求参数"
 // @Accept application/json
-// @Authorization
-// @Router /myself/address/delete [post]
+// @Router /app/myself/address/delete [post]
 func (api Api) deleteAddress(c *gin.Context) {
 	req := myselfsrv.DeleteAddressReqVO{}
 	if err := c.BindJSON(&req); err != nil {

internal/server/adapter/http/v1/myself/logistic.go

@@ -18,7 +18,7 @@ import (
 // @Param  req body swagger.LogisticPageReqVO true "请求参数"
 // @Accept application/json
 // @Authorization
-// @Router /myself/logisticCompany/page [post]
+// @Router /app/myself/logisticCompany/page [post]
 func (api Api) logisticPage(c *gin.Context) {
 	req := myselfsrv.LogisticPageReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -43,7 +43,7 @@ func (api Api) logisticPage(c *gin.Context) {
 // @Param  req body myselfsrv.AddLogisticReqVO true "请求参数"
 // @Accept application/json
 // @Authorization
-// @Router /myself/logisticCompany/add [post]
+// @Router /app/myself/logisticCompany/add [post]
 func (api Api) addLogistic(c *gin.Context) {
 	req := myselfsrv.AddLogisticReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -73,7 +73,7 @@ func (api Api) addLogistic(c *gin.Context) {
 // @Param  req body myselfsrv.DeleteLogisticReqVO true "请求参数"
 // @Accept application/json
 // @Authorization
-// @Router /myself/logisticCompany/delete [post]
+// @Router /app/myself/logisticCompany/delete [post]
 func (api Api) deleteLogistic(c *gin.Context) {
 	req := myselfsrv.DeleteLogisticReqVO{}
 	if err := c.BindJSON(&req); err != nil {

internal/server/adapter/http/v1/myself/order.go

@@ -19,7 +19,7 @@ import (
 // @Param  req body swagger.OrderPageReqVO true "请求参数"
 // @Accept application/json
 // @Authorization
-// @Router /myself/orderPage [post]
+// @Router /app/myself/orderPage [post]
 func (api Api) orderPage(c *gin.Context) {
 	req := myselfsrv.OrderPageReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -44,7 +44,7 @@ func (api Api) orderPage(c *gin.Context) {
 // @Param  req body myselfsrv.OrderSubNoReqVO true "请求参数"
 // @Accept application/json
 // @Authorization
-// @Router /myself/orderSubNo [post]
+// @Router /app/myself/orderSubNo [post]
 func (api Api) orderSubNo(c *gin.Context) {
 	req := myselfsrv.OrderSubNoReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -69,7 +69,7 @@ func (api Api) orderSubNo(c *gin.Context) {
 // @Param  req body ordersrv.PlaceOrderReqVO true "请求参数"
 // @Accept application/json
 // @Authorization
-// @Router /myself/placeOrder [post]
+// @Router /app/myself/placeOrder [post]
 func (api Api) placeOrder(c *gin.Context) {
 	req := ordersrv.PlaceOrderReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -99,7 +99,7 @@ func (api Api) placeOrder(c *gin.Context) {
 // @Param  req body ordersrv.OrderDetailReqVO true "请求参数"
 // @Accept application/json
 // @Authorization
-// @Router /myself/orderDetail [post]
+// @Router /app/myself/orderDetail [post]
 func (api Api) orderDetail(c *gin.Context) {
 	req := ordersrv.OrderDetailReqVO{}
 	if err := c.BindJSON(&req); err != nil {

internal/server/adapter/http/v1/myself/self.go

@@ -17,7 +17,7 @@ import (
 // @Success 200 {object}  swagger.AccountInfoVo "成功响应的结构体"
 // @Accept application/json
 // @Authorization
-// @Router /myself/info [get]
+// @Router /app/myself/info [get]
 func (api Api) myselfInfo(c *gin.Context) {
 	srv := myselfsrv.NewMyselfService(dao.NewDataStore(global.CommonConnectRepoInst.StoreDB))
 	res, err := srv.MyselfInfo(c)
@@ -36,7 +36,7 @@ func (api Api) myselfInfo(c *gin.Context) {
 // @Param  req body myselfsrv.UpdateMyselfInfoReqVO true "请求参数"
 // @Accept application/json
 // @Authorization
-// @Router /myself/update [post]
+// @Router /app/myself/update [post]
 func (api Api) updateMyselfInfo(c *gin.Context) {
 	req := myselfsrv.UpdateMyselfInfoReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -65,7 +65,7 @@ func (api Api) updateMyselfInfo(c *gin.Context) {
 // @Success 200 {object}  myselfsrv.RefreshTokenRespVo "成功响应的结构体"
 // @Accept application/json
 // @Authorization
-// @Router /myself/refreshToken [post]
+// @Router /app/myself/refreshToken [post]
 func (api Api) refreshToken(c *gin.Context) {
 	srv := myselfsrv.NewMyselfService(dao.NewDataStore(global.CommonConnectRepoInst.StoreDB))
 	res, err := srv.RefreshToken(c)

internal/server/adapter/http/v1/public/public.go

@@ -20,7 +20,7 @@ import (
 // @Param req body ordersrv.QueryExpressOrderReqVO true "运单号"
 // @Accept application/json
 // @Authorization Bearer
-// @Router /public/queryOrder [post]
+// @Router /app/public/queryOrder [post]
 func (api Api) queryExpressOrder(c *gin.Context) {
 	req := ordersrv.QueryExpressOrderReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -49,7 +49,7 @@ func (api Api) queryExpressOrder(c *gin.Context) {
 // @Success 200 {object}  ordersrv.OrderLogisticDetailRespVO
 // @Param req body ordersrv.OrderLogisticDetailReqVO true "订单id"
 // @Accept application/json
-// @Router /public/logisticDetail [post]
+// @Router /app/public/logisticDetail [post]
 func (api Api) logisticDetail(c *gin.Context) {
 	req := ordersrv.OrderLogisticDetailReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -78,7 +78,7 @@ func (api Api) logisticDetail(c *gin.Context) {
 // @Success 200 {object}  devicesrv.DeviceSensorListRespVO
 // @Param req body devicesrv.DeviceSensorListReqVO true "SN"
 // @Accept application/json
-// @Router /public/deviceSensorList [post]
+// @Router /app/public/deviceSensorList [post]
 func (api Api) deviceSensorList(c *gin.Context) {
 	req := devicesrv.DeviceSensorListReqVO{}
 	if err := c.BindJSON(&req); err != nil {
@@ -106,7 +106,7 @@ func (api Api) deviceSensorList(c *gin.Context) {
 // @Success 200 {}  swagger.PageListResponse
 // @Param req body swagger.SnDataListReqVO true "SN数据"
 // @Accept application/json
-// @Router /public/sensorDataList [post]
+// @Router /app/public/sensorDataList [post]
 func (api Api) snDataList(c *gin.Context) {
 	req := devicesrv.SnDataListReqVO{}
 	if err := c.BindJSON(&req); err != nil {

internal/server/adapter/http/v1/swagger/swagger.go

@@ -7,15 +7,19 @@ import (
 	ginSwagger "github.com/swaggo/gin-swagger"
 )
 
-// 注册Swagger
+// swagger1.go
+type SwaggerDocV1 struct {
+	BasePath string `json:"basePath"`
+}
+
+// RegisterSwagger 注册Swagger
 func RegisterSwagger(r *gin.Engine) {
 	// API文档访问地址: http://host/swagger/index.html
 	// 注解定义可参考 https://github.com/swaggo/swag#declarative-comments-format
-	docs.SwaggerInfo.BasePath = "/clodLogistic/app/api/v1"
-	docs.SwaggerInfo.Title = "冷链运输平台后台管理接口"
+	docs.SwaggerInfo.BasePath = "/clodLogistic/api/v1"
+	docs.SwaggerInfo.Title = "冷链运输平台接口文档"
 	docs.SwaggerInfo.Version = "1.0"
 	docs.SwaggerInfo.Host = "localhost:8888"
 	docs.SwaggerInfo.Schemes = []string{"http", "https"}
-	//由于 Swagger 本身并不直接支持多 base path通过自定义方式实现不同的basePath
 	r.GET("/swagger/*any", ginSwagger.WrapHandler(swaggerFiles.Handler))
 }

internal/server/adapter/http/v1/swagger/swagger_model.go

@@ -80,6 +80,31 @@ type SnDataListReqVO struct {
 		TimeEnd   models.MyTime `json:"timeEnd"`
 	}
 }
+
+type WarehousePageReqVO struct {
+	Page   Page `json:"page"`
+	Search struct {
+		Name   string `json:"name"`
+		SnCode string `json:"snCode"`
+	}
+}
+type OrderNumUserStatReqVO struct {
+	Page   Page `json:"page"`
+	Search struct {
+		StatType    models.TimeStatType
+		TimeStart   models.MyTime `json:"timeStart"`
+		TimeEnd     models.MyTime `json:"timeEnd"`
+		OrderStatus int           `json:"orderStatus"`
+	}
+}
+type ManageOrderPageReqVO struct {
+	Page   Page `json:"page"`
+	Search struct {
+		OrderNo     string `json:"orderNo"`
+		OrderStatus int    `json:"orderStatus"`
+	} `json:"search"`
+}
+
 type BaseResponse struct {
 	Code int `json:"code"` // 业务code码
 
@@ -93,6 +118,21 @@ type BaseResponse struct {
 type ListResponse struct {
 	List interface{} `json:"list"` // 列表数据信息
 }
+type CarPageReqVO struct {
+	Page   Page `json:"page"`
+	Search struct {
+		CarNumber         string `json:"carNumber"`
+		SnCode            string `json:"snCode"`
+		DriverAccountUuid string `json:"driverAccountUuid"`
+	} `json:"search"`
+}
+type UserListReqVO struct {
+	Page      Page   `json:"page"`
+	UserTokey string `json:"userTokey"`
+	Search    struct {
+		Name string `json:"name"`
+	} `json:"search"`
+}
 
 type Page struct {
 	Page   int    `json:"page"`   // 页码