zhangqian
2024-07-01 84346bdafad764c8964256829dc7dc564fe95769
docs/swagger.yaml
@@ -74,6 +74,17 @@
    - CostingMethodStandardPrice
    - CostingMethodFIFO
    - CostingMethodAverageCost
  constvar.FileTemplateCategory:
    enum:
    - 1
    - 2
    type: integer
    x-enum-comments:
      FileTemplateCategory_Output: 出库
      FileTemplateCategory_Selfmade: 入库-自制
    x-enum-varnames:
    - FileTemplateCategory_Selfmade
    - FileTemplateCategory_Output
  constvar.FileType:
    enum:
    - file
@@ -184,6 +195,20 @@
    - MaterialModeConsumables
    - MaterialModeOther
    - MaterialModeVirtual
  constvar.MiniDictType:
    enum:
    - 1
    - 2
    - 3
    type: integer
    x-enum-comments:
      StockoutType: 出库类型
      StorageType: 入库类型
      TransferType: 调拨类型
    x-enum-varnames:
    - TransferType
    - StorageType
    - StockoutType
  constvar.OperationSource:
    enum:
    - 1
@@ -297,6 +322,14 @@
    x-enum-varnames:
    - RuleType_Product
    - RuleType_ProductCategory
  constvar.SystemConfigType:
    enum:
    - 1
    type: integer
    x-enum-comments:
      SystemConfigTypeInventoryCutOffPoint: 库存结算时间点
    x-enum-varnames:
    - SystemConfigTypeInventoryCutOffPoint
  constvar.WhetherType:
    enum:
    - 1
@@ -540,7 +573,7 @@
        type: array
      autoIncr:
        type: integer
      barcode:
      barCode:
        description: 条码
        type: string
      buyExplain:
@@ -572,6 +605,9 @@
      cost:
        description: 成本
        type: number
      createBy:
        description: 创建人
        type: string
      currencyName:
        description: 币种名称
        type: string
@@ -727,6 +763,27 @@
        description: 重量
        type: number
    type: object
  models.MiniDict:
    properties:
      code:
        description: 编码
        type: string
      id:
        type: integer
      isDefault:
        description: 是否默认
        type: boolean
      name:
        description: 名称
        type: string
      type:
        allOf:
        - $ref: '#/definitions/constvar.MiniDictType'
        description: 字典类型
      value:
        description: 值
        type: string
    type: object
  models.MonthStats:
    properties:
      MoreUnitsArr:
@@ -850,8 +907,6 @@
        allOf:
        - $ref: '#/definitions/constvar.BaseOperationType'
        description: 基础作业类型
      checkedAt:
        type: string
      checkedBy:
        type: string
      comment:
@@ -878,6 +933,13 @@
        type: array
      id:
        type: integer
      inventoryDealer:
        $ref: '#/definitions/models.MiniDict'
      inventoryDealerType:
        type: integer
      isInternalOutput:
        description: 是否调拨产生的出库
        type: boolean
      location:
        allOf:
        - $ref: '#/definitions/models.Location'
@@ -922,6 +984,8 @@
        type: string
      receiverPhone:
        type: string
      remark:
        type: string
      salesDetailsNumber:
        type: string
      source:
@@ -942,6 +1006,8 @@
        type: integer
      updateTime:
        type: string
      warehouseId:
        type: integer
      waybillNumber:
        description: 运单号
        type: string
@@ -959,6 +1025,9 @@
        type: number
      auxiliaryUnit:
        type: string
      cost:
        description: 成本单价
        type: number
      createTime:
        type: string
      fromLocation:
@@ -970,8 +1039,9 @@
        type: integer
      id:
        type: integer
      note:
        type: string
      isInternalOutput:
        description: 是否调拨产生的出库
        type: boolean
      operationId:
        description: 操作id
        type: integer
@@ -982,6 +1052,11 @@
      productId:
        description: 产品id
        type: string
      remark:
        type: string
      salePrice:
        description: 销售单价
        type: number
      toLocation:
        allOf:
        - $ref: '#/definitions/models.Location'
@@ -1072,6 +1147,25 @@
      updateTime:
        type: string
    type: object
  models.SystemConfig:
    properties:
      configType:
        allOf:
        - $ref: '#/definitions/constvar.SystemConfigType'
        description: 每月库存结算时间点
      createTime:
        type: string
      id:
        type: integer
      name:
        description: 设置名称
        type: string
      updateTime:
        type: string
      val:
        description: 设置值
        type: string
    type: object
  models.UnitDict:
    properties:
      id:
@@ -1114,6 +1208,10 @@
        type: string
      createTime:
        type: string
      fileTemplateCategoryIn:
        $ref: '#/definitions/constvar.FileTemplateCategory'
      fileTemplateCategoryOut:
        $ref: '#/definitions/constvar.FileTemplateCategory'
      id:
        type: integer
      inboundTransportation:
@@ -1145,6 +1243,31 @@
        type: string
      warehouseLocation:
        description: 库存位置
        type: string
    type: object
  request.AddAttribute:
    properties:
      dataType:
        description: 值类型(1字符串 2 int 3 下拉框 )
        type: integer
      entityType:
        description: 给谁用的 1 物料(产品)
        type: integer
      name:
        description: 属性名称
        type: string
      selectValues:
        items:
          type: string
        type: array
    type: object
  request.AddAttributeValue:
    properties:
      attributeId:
        type: integer
      entityId:
        type: string
      value:
        type: string
    type: object
  request.AddCompany:
@@ -1204,12 +1327,32 @@
        - $ref: '#/definitions/constvar.RuleType'
        description: 上架规则类型 1:产品类型;2:产品类别类型
    type: object
  request.AddMiniDict:
    properties:
      isDefault:
        description: 是否默认
        type: boolean
      name:
        description: 名称
        type: string
      type:
        allOf:
        - $ref: '#/definitions/constvar.MiniDictType'
        description: 字典类型
      value:
        description: 值
        type: string
    type: object
  request.AddOperation:
    properties:
      accountant:
        type: string
      accountantId:
        type: string
      baseOperationType:
        allOf:
        - $ref: '#/definitions/constvar.BaseOperationType'
        description: 基础作业类型 5库存盘点
      comment:
        description: 备注
        type: string
@@ -1276,6 +1419,9 @@
        description: 状态
      toLocationId:
        description: 目标位置id
        type: integer
      warehouseId:
        description: 仓库id
        type: integer
      waybillNumber:
        description: 运单号
@@ -1376,9 +1522,41 @@
    required:
    - code
    type: object
  request.AttributeList:
    properties:
      entityType:
        type: integer
      keyword:
        type: string
      page:
        description: 页码
        type: integer
      pageSize:
        description: 每页大小
        type: integer
    type: object
  request.DoMonthStats:
    properties:
      token:
        type: string
    type: object
  request.EditMiniDict:
    properties:
      id:
        description: 字典类型
        type: integer
      isDefault:
        description: 是否默认
        type: boolean
      name:
        description: 名称
        type: string
      type:
        allOf:
        - $ref: '#/definitions/constvar.MiniDictType'
        description: 字典类型
      value:
        description: 值
        type: string
    type: object
  request.FinishLocationProductAmount:
@@ -1492,6 +1670,13 @@
      type:
        type: integer
    type: object
  request.GetMiniDictList:
    properties:
      type:
        allOf:
        - $ref: '#/definitions/constvar.MiniDictType'
        description: 字典类型
    type: object
  request.GetMonthStats:
    properties:
      date:
@@ -1545,6 +1730,18 @@
        description: 产品id
        type: string
    type: object
  request.MiniDict:
    properties:
      isDefault:
        description: 是否默认
        type: boolean
      name:
        description: 名称
        type: string
      value:
        description: 值
        type: string
    type: object
  request.OperationAllList:
    properties:
      number:
@@ -1593,6 +1790,9 @@
      auxiliaryUnit:
        description: 辅助单位
        type: string
      cost:
        description: 成本单价
        type: number
      fromLocationId:
        description: |-
          Unit        string          `json:"unit" gorm:"type:varchar(31);comment:单位"`                    //单位
@@ -1601,6 +1801,11 @@
      productId:
        description: 产品id
        type: string
      remark:
        type: string
      salePrice:
        description: 销售单价
        type: number
      toLocationId:
        description: 目标位置id
        type: integer
@@ -1613,6 +1818,10 @@
    type: object
  request.OperationList:
    properties:
      baseOperationType:
        allOf:
        - $ref: '#/definitions/constvar.BaseOperationType'
        description: 1 入库 2 出库 3 内部调拨 4 报废 5 库存盘点
      number:
        type: string
      operationTypeId:
@@ -1670,6 +1879,17 @@
      productId:
        type: string
    type: object
  request.SaveMiniDict:
    properties:
      list:
        items:
          $ref: '#/definitions/request.MiniDict'
        type: array
      type:
        allOf:
        - $ref: '#/definitions/constvar.MiniDictType'
        description: 字典类型
    type: object
  request.SaveUnitDict:
    properties:
      data:
@@ -1677,11 +1897,55 @@
          $ref: '#/definitions/request.UnitDict'
        type: array
    type: object
  request.SystemConfig:
    properties:
      ID:
        type: integer
      configType:
        allOf:
        - $ref: '#/definitions/constvar.SystemConfigType'
        description: 1 每月库存结算时间点
      name:
        description: 设置名称
        type: string
      val:
        description: 设置值
        type: string
    type: object
  request.UnitDict:
    properties:
      isDefault:
        type: boolean
      name:
        type: string
    type: object
  request.UpdateAttribute:
    properties:
      dataType:
        description: 值类型(1字符串 2 int 3 下拉框 )
        type: integer
      entityType:
        description: 给谁用的 1 物料(产品)
        type: integer
      id:
        type: integer
      name:
        description: 属性名称
        type: string
      selectValues:
        items:
          type: string
        type: array
    type: object
  request.UpdateAttributeValue:
    properties:
      attributeId:
        type: integer
      entityId:
        type: string
      id:
        type: integer
      value:
        type: string
    type: object
  request.UpdateCompany:
@@ -2035,89 +2299,6 @@
info:
  contact: {}
paths:
  /api-s/v1/organize/department:
    get:
      parameters:
      - description: 页码
        in: query
        name: page
        type: integer
      - description: 每页大小
        in: query
        name: pageSize
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            allOf:
            - $ref: '#/definitions/util.ResponseList'
            - properties:
                data:
                  items:
                    $ref: '#/definitions/models.Department'
                  type: array
              type: object
      summary: 查询部门信息列表
      tags:
      - 部门信息
    post:
      parameters:
      - description: 部门信息信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.AddDepartment'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 添加部门信息
      tags:
      - 部门信息
  /api-s/v1/organize/department/{id}:
    delete:
      parameters:
      - description: 部门信息信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.UpdateDepartment'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 编辑部门信息
      tags:
      - 部门信息
    put:
      parameters:
      - description: 部门信息信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.UpdateDepartment'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 编辑部门信息
      tags:
      - 部门信息
  /api-wms/v1/attachment/uploadFiles:
    post:
      responses:
@@ -2128,6 +2309,186 @@
      summary: 上传附件
      tags:
      - 附件管理
  /api-wms/v1/attribute/attribute:
    get:
      parameters:
      - description: 属性值和对象信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.AttributeList'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 添加属性值和对象
      tags:
      - 属性值和对象
    post:
      parameters:
      - description: 属性信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.AddAttribute'
      - description: token
        in: header
        name: Authorization
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 添加属性
      tags:
      - 属性
  /api-wms/v1/attribute/delete/{id}:
    delete:
      parameters:
      - description: token
        in: header
        name: Authorization
        required: true
        type: string
      - description: 属性id
        in: path
        name: id
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 删除属性
      tags:
      - 属性
  /api-wms/v1/attribute/primary/{id}:
    get:
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 查询属性值和对象 通过主键ID查询
      tags:
      - 属性值和对象
  /api-wms/v1/attribute/updateAttribute/{id}:
    put:
      parameters:
      - description: 属性信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.UpdateAttribute'
      - description: 属性id
        in: path
        name: id
        required: true
        type: string
      - description: token
        in: header
        name: Authorization
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 编辑属性
      tags:
      - 属性
  /api-wms/v1/attributeValue/add:
    post:
      parameters:
      - description: 属性值和对象信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.AddAttributeValue'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 添加属性值和对象
      tags:
      - 属性值和对象
  /api-wms/v1/attributeValue/delete/{id}:
    delete:
      parameters:
      - description: id
        in: path
        name: id
        required: true
        type: string
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 删除属性值和对象
      tags:
      - 属性值和对象
  /api-wms/v1/attributeValue/list:
    post:
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 查询属性值和对象 分页条件筛选Value like '%v%' 模糊查询
      tags:
      - 属性值和对象
  /api-wms/v1/attributeValue/primary/{id}:
    get:
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 查询属性值和对象 通过主键ID查询
      tags:
      - 属性值和对象
  /api-wms/v1/attributeValue/update:
    post:
      parameters:
      - description: 属性值和对象信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.UpdateAttributeValue'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 更新属性值和对象
      tags:
      - 属性值和对象
  /api-wms/v1/code/getAutoCode:
    post:
      parameters:
@@ -2280,6 +2641,105 @@
      summary: 编辑公司
      tags:
      - 公司
  /api-wms/v1/dict/add:
    post:
      parameters:
      - description: 参数
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.AddMiniDict'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 添加字典信息
      tags:
      - 数据字典
  /api-wms/v1/dict/delete/{id}:
    delete:
      parameters:
      - description: id
        in: path
        name: id
        required: true
        type: string
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 删除字典信息
      tags:
      - 数据字典
  /api-wms/v1/dict/edit:
    post:
      parameters:
      - description: 参数
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.EditMiniDict'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 编辑字典信息
      tags:
      - 数据字典
  /api-wms/v1/dict/getDictList:
    post:
      parameters:
      - description: 参数
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.GetMiniDictList'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            allOf:
            - $ref: '#/definitions/util.ResponseList'
            - properties:
                data:
                  items:
                    $ref: '#/definitions/models.MiniDict'
                  type: array
              type: object
      summary: 获取字典信息列表
      tags:
      - 数据字典
  /api-wms/v1/dict/save:
    post:
      parameters:
      - description: 参数
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.SaveMiniDict'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 批量更新迷你字典(会删除原数据)
      tags:
      - 数据字典
  /api-wms/v1/forms/doMonthStats:
    post:
      parameters:
@@ -3242,6 +3702,89 @@
      summary: 编辑作业类型
      tags:
      - 业务类型
  /api-wms/v1/organize/department:
    get:
      parameters:
      - description: 页码
        in: query
        name: page
        type: integer
      - description: 每页大小
        in: query
        name: pageSize
        type: integer
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            allOf:
            - $ref: '#/definitions/util.ResponseList'
            - properties:
                data:
                  items:
                    $ref: '#/definitions/models.Department'
                  type: array
              type: object
      summary: 查询部门信息列表
      tags:
      - 部门信息
    post:
      parameters:
      - description: 部门信息信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.AddDepartment'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 添加部门信息
      tags:
      - 部门信息
  /api-wms/v1/organize/department/{id}:
    delete:
      parameters:
      - description: 部门信息信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.UpdateDepartment'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 编辑部门信息
      tags:
      - 部门信息
    put:
      parameters:
      - description: 部门信息信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.UpdateDepartment'
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 编辑部门信息
      tags:
      - 部门信息
  /api-wms/v1/product/addDisuse:
    post:
      parameters:
@@ -3332,7 +3875,25 @@
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 删除产品
      summary: 通过产品/商品/物料 ID删除产品
      tags:
      - 产品
  /api-wms/v1/product/deleteProductByBarCode/{barCode}:
    delete:
      parameters:
      - description: barCode
        in: path
        name: barCode
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 通过产品/商品/物料 条形码删除产品
      tags:
      - 产品
  /api-wms/v1/product/deleteProductCategory/{id}:
@@ -3423,6 +3984,11 @@
  /api-wms/v1/product/getProductDetails/{id}:
    get:
      parameters:
      - description: token
        in: header
        name: Authorization
        required: true
        type: string
      - description: id
        in: path
        name: id
@@ -3440,7 +4006,35 @@
                data:
                  $ref: '#/definitions/models.Material'
              type: object
      summary: 获取产品详情
      summary: 通过产品/商品/物料 ID获取产品详情
      tags:
      - 产品
  /api-wms/v1/product/getProductDetailsByBarCode/{barCode}:
    get:
      parameters:
      - description: token
        in: header
        name: Authorization
        required: true
        type: string
      - description: barCode
        in: path
        name: barCode
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            allOf:
            - $ref: '#/definitions/util.Response'
            - properties:
                data:
                  $ref: '#/definitions/models.Material'
              type: object
      summary: 通过产品/商品/物料 条形码 获取产品详情
      tags:
      - 产品
  /api-wms/v1/product/getProductList:
@@ -3506,6 +4100,31 @@
      summary: 获取登录用户信息
      tags:
      - 产品
  /api-wms/v1/product/inputProduct:
    post:
      consumes:
      - multipart/form-data
      parameters:
      - description: file
        in: formData
        name: file
        required: true
        type: file
      - description: token
        in: header
        name: Authorization
        required: true
        type: string
      produces:
      - application/xlsx
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 导入物料
      tags:
      - 物料管理
  /api-wms/v1/product/listDisuse:
    post:
      parameters:
@@ -3782,6 +4401,64 @@
      summary: 更新重订货规则
      tags:
      - 重订货规则
  /api-wms/v1/systemConfig/get:
    get:
      parameters:
      - description: 1 每月库存结算时间点
        enum:
        - 1
        in: query
        name: configType
        required: true
        type: integer
        x-enum-comments:
          SystemConfigTypeInventoryCutOffPoint: 库存结算时间点
        x-enum-varnames:
        - SystemConfigTypeInventoryCutOffPoint
      - description: token
        in: header
        name: Authorization
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            allOf:
            - $ref: '#/definitions/util.Response'
            - properties:
                data:
                  $ref: '#/definitions/models.SystemConfig'
              type: object
      summary: 根据设置类型查询系统设置
      tags:
      - 系统设置
  /api-wms/v1/systemConfig/save:
    post:
      parameters:
      - description: 系统设置信息
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.SystemConfig'
      - description: token
        in: header
        name: Authorization
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: 成功
          schema:
            $ref: '#/definitions/util.Response'
      summary: 保存系统设置
      tags:
      - 系统设置
  /api-wms/v1/warehouse/getWarehouseDetails/{id}:
    get:
      parameters: