zhangqian
2023-08-24 037900f7998925e0c8727338aef3a1b199daa898
docs/swagger.yaml
@@ -186,6 +186,26 @@
    - SalesRefundKeywordPrincipal
    - SalesRefundKeywordUpdateAt
    - SalesRefundKeywordPriceTotal
  constvar.SalesReturnKeywordType:
    enum:
    - 销售退货单编号
    - 客户名称
    - 退款日期
    - 状态
    - 退入仓库
    - 应退款
    - 已退款
    - 销售负责人
    type: string
    x-enum-varnames:
    - SalesReturnKeywordReturnNumber
    - SalesReturnKeywordClientName
    - SalesReturnKeywordReturnDate
    - SalesReturnKeywordStatus
    - SalesReturnKeywordRepository
    - SalesReturnKeywordAmountShouldRefund
    - SalesReturnKeywordAmountHasRefund
    - SalesReturnKeywordPrincipal
  constvar.SalesReturnSourceType:
    enum:
    - 1
@@ -250,6 +270,18 @@
    - ServiceContractQueryClassExpireAfter60Day
    - ServiceContractQueryClassExpiredBefore15Day
    - ServiceContractQueryClassExpiredBefore60Day
  constvar.ServiceContractStatusKeywordType:
    enum:
    - ""
    type: string
    x-enum-varnames:
    - ServiceContractStatusKeywordCustomerName
  constvar.ServiceContractStatusQueryClass:
    enum:
    - ""
    type: string
    x-enum-varnames:
    - ServiceContractStatusQueryClassExpireLessThen60Days
  constvar.ServiceFeeKeywordType:
    enum:
    - 客户名称
@@ -419,6 +451,11 @@
    type: object
  model.Client:
    properties:
      _:
        description: |-
          The date when the item was deleted
          example: 2023-08-10 15:48:25
        type: string
      business_scope:
        type: string
      city:
@@ -449,6 +486,13 @@
        $ref: '#/definitions/model.Country'
      country_id:
        type: integer
      created_at:
        description: |-
          The date when the item was created
          example: 2023-08-10 15:48:25
        type: string
      creator_id:
        type: integer
      detail_address:
        type: string
      enterprise_nature_id:
@@ -464,6 +508,9 @@
          $ref: '#/definitions/model.FollowRecord'
        type: array
      id:
        description: |-
          The ID of the item
          example: 1
        type: integer
      industry:
        $ref: '#/definitions/model.Industry'
@@ -501,6 +548,11 @@
        type: string
      service_member_id:
        type: integer
      updated_at:
        description: |-
          The date when the item was last updated
          example: 2023-08-10 15:48:25
        type: string
    type: object
  model.ClientLevel:
    properties:
@@ -659,6 +711,13 @@
      wechat:
        type: string
    type: object
  model.ContactInformation:
    properties:
      id:
        type: integer
      name:
        type: string
    type: object
  model.Contract:
    properties:
      _:
@@ -692,6 +751,8 @@
        $ref: '#/definitions/model.Quotation'
      quotationId:
        type: integer
      serviceContractStatus:
        $ref: '#/definitions/model.ServiceContractStatus'
      statusId:
        type: integer
      updated_at:
@@ -774,6 +835,8 @@
        $ref: '#/definitions/model.Contact'
      contact_id:
        type: integer
      contact_information:
        $ref: '#/definitions/model.ContactInformation'
      contact_information_id:
        type: integer
      content:
@@ -1095,6 +1158,10 @@
      bankAccountId:
        description: 账户id
        type: integer
      client:
        allOf:
        - $ref: '#/definitions/model.Client'
        description: 客户id
      clientId:
        description: 客户id
        type: integer
@@ -1352,6 +1419,8 @@
        type: integer
      signTime:
        type: string
      updateTime:
        type: string
      wechatOrderStatus:
        $ref: '#/definitions/model.WechatOrderStatus'
      wechatOrderStatusId:
@@ -1427,7 +1496,7 @@
      id:
        type: integer
      isInvoice:
        type: integer
        type: string
      member:
        $ref: '#/definitions/model.User'
      memberId:
@@ -1453,7 +1522,9 @@
      sourceType:
        allOf:
        - $ref: '#/definitions/constvar.RefundSourceType'
        description: 来源类型(1销售明细单2服务合同3销售发票4收款计划5出库单)
        description: 来源类型(1销售退货)
      updateTime:
        type: string
    type: object
  model.SalesReturn:
    properties:
@@ -1463,6 +1534,12 @@
        allOf:
        - $ref: '#/definitions/model.SalesReturnStatus'
        description: 退货状态
      amountHasRefund:
        description: 已退款金额
        type: number
      amountShouldRefund:
        description: 应退款金额
        type: number
      client:
        $ref: '#/definitions/model.Client'
      clientId:
@@ -1500,6 +1577,8 @@
        allOf:
        - $ref: '#/definitions/constvar.SalesReturnSourceType'
        description: 源单类型(1销售明细)
      updateTime:
        type: string
    type: object
  model.SalesReturnStatus:
    properties:
@@ -1601,10 +1680,16 @@
        $ref: '#/definitions/model.Contact'
      contactId:
        type: integer
      createTime:
        type: string
      creatorName:
        type: string
      endTime:
        type: string
      id:
        type: integer
      member:
        $ref: '#/definitions/model.User'
      memberId:
        type: integer
      number:
@@ -1640,6 +1725,8 @@
      startTime:
        type: string
      terms:
        type: string
      updateTime:
        type: string
    type: object
  model.ServiceContractStatus:
@@ -1685,6 +1772,10 @@
        $ref: '#/definitions/model.Contact'
      contactId:
        type: integer
      createTime:
        type: string
      creatorName:
        type: string
      file:
        type: string
      id:
@@ -1721,6 +1812,8 @@
        $ref: '#/definitions/model.TimelyRate'
      timelyRateId:
        type: integer
      updateTime:
        type: string
    type: object
  model.ServiceOrder:
    properties:
@@ -1748,6 +1841,10 @@
      contactId:
        description: 联系人id
        type: integer
      createTime:
        type: string
      creatorName:
        type: string
      expectTime:
        description: 希望处理时间
        type: string
@@ -1771,11 +1868,12 @@
      problemDesc:
        description: 问题描述
        type: string
      product:
        $ref: '#/definitions/model.Product'
      productId:
        description: 产品id
        type: integer
      productName:
        description: 产品名称
        type: string
      productTypeName:
        description: 产品分类名称
        type: string
      realTime:
        description: 实际处理时间
        type: string
@@ -1797,6 +1895,10 @@
      serviceContractId:
        description: 服务合同id
        type: integer
      serviceMan:
        allOf:
        - $ref: '#/definitions/model.User'
        description: 服务人员
      serviceManId:
        description: 服务人员
        type: integer
@@ -1829,6 +1931,8 @@
      timeSpentId:
        description: 花费时间
        type: integer
      updateTime:
        type: string
    type: object
  model.ServiceOrderStatus:
    properties:
@@ -2023,6 +2127,9 @@
        type: integer
      contact:
        $ref: '#/definitions/request.Contact'
      contact_id:
        description: 联系人ID
        type: integer
      country_id:
        type: integer
      detail_address:
@@ -2444,6 +2551,10 @@
      bankAccountId:
        description: 账户id
        type: integer
      client:
        allOf:
        - $ref: '#/definitions/model.Client'
        description: 客户id
      clientId:
        description: 客户id
        type: integer
@@ -2760,10 +2871,10 @@
    type: object
  request.AddServiceContractStatus:
    properties:
      id:
        type: integer
      name:
        type: string
    required:
    - name
    type: object
  request.AddServiceContractType:
    properties:
@@ -2793,6 +2904,9 @@
        type: integer
      contact:
        $ref: '#/definitions/request.Contact'
      contact_id:
        description: 联系人ID
        type: integer
      country_id:
        type: integer
      detail_address:
@@ -2913,9 +3027,12 @@
      problemDesc:
        description: 问题描述
        type: string
      productId:
        description: 产品id
        type: integer
      productName:
        description: 产品名称
        type: string
      productTypeName:
        description: 产品分类名称
        type: string
      realTime:
        description: 实际处理时间
        type: string
@@ -3101,6 +3218,11 @@
        description: 用户岗位
        type: string
    type: object
  request.CheckClientName:
    properties:
      name:
        type: string
    type: object
  request.CommonIds:
    properties:
      ids:
@@ -3173,6 +3295,13 @@
          type: integer
        type: array
    type: object
  request.DeleteContract:
    properties:
      ids:
        items:
          type: integer
        type: array
    type: object
  request.DeleteCountry:
    properties:
      id:
@@ -3186,7 +3315,28 @@
          type: integer
        type: array
    type: object
  request.DeleteMasterOrder:
    properties:
      ids:
        items:
          type: integer
        type: array
    type: object
  request.DeleteOrderManage:
    properties:
      ids:
        items:
          type: integer
        type: array
    type: object
  request.DeleteQuotation:
    properties:
      ids:
        items:
          type: integer
        type: array
    type: object
  request.DeleteSaleChance:
    properties:
      ids:
        items:
@@ -3208,6 +3358,13 @@
        type: array
    type: object
  request.DeleteServiceFollowup:
    properties:
      ids:
        items:
          type: integer
        type: array
    type: object
  request.DeleteSubOrder:
    properties:
      ids:
        items:
@@ -3298,7 +3455,8 @@
        additionalProperties: true
        description: '搜索条件: map[string]interface{}{"name": "xxx"}; {"name": "客户名称",
          "phone": "手机号码", "detail_address":"详细地址", "next_visit_time":"下回回访日期", "member_name":
          "销售负责人", "client_status": "客户状态", "client_level": "重要级别", "is_first": "是否是首要联系人"}'
          "销售负责人", "client_status": "客户状态", "client_level": "重要级别", "is_first": "是否是首要联系人",
          "client_id": "clientId 用于返回首要联系人"}'
        type: object
    type: object
  request.GetContractList:
@@ -3343,7 +3501,7 @@
        description: '搜索条件: map[string]interface{}{"name": "xxx"}; {"topic": "跟进主题",
          "member_name": "跟进人", "client_name": "客户名称", "client_status": "客户状态", "follow_time":
          "跟进时间", "next_follow_time": "下次跟进时间", "record": "跟进记录", "phone": "联系人电话",
          "contact_name": "联系人姓名"}'
          "contact_name": "联系人姓名", "sales_leads_id": "销售线索id", "sale_chance_id": "销售机会id"}'
        type: object
    type: object
  request.GetMasterOrderList:
@@ -3391,7 +3549,7 @@
      pageSize:
        description: 每页大小
        type: integer
      searchMap:
      search_map:
        additionalProperties: true
        description: '搜索条件: map[string]interface{}{"name": "xxx"}; {"sale_chance_id":
          销售线索id, "client_name": "客户名称", "member_name": "销售负责人", "contact_name": "联系人",
@@ -3459,6 +3617,8 @@
    properties:
      keyword:
        type: string
      keywordType:
        $ref: '#/definitions/constvar.SalesReturnKeywordType'
      page:
        description: 页码
        type: integer
@@ -3693,7 +3853,7 @@
      clientId:
        type: integer
      isInvoice:
        type: integer
        type: string
      memberId:
        type: integer
      number:
@@ -3715,7 +3875,10 @@
      sourceType:
        allOf:
        - $ref: '#/definitions/constvar.RefundSourceType'
        description: 来源类型(1销售明细单2服务合同3销售发票4收款计划5出库单)
        description: 来源类型(1销售退款单)
    required:
    - sourceId
    - sourceType
    type: object
  request.SalesReturn:
    properties:
@@ -3855,6 +4018,9 @@
        type: integer
      contact:
        $ref: '#/definitions/request.Contact'
      contact_id:
        description: 联系人ID
        type: integer
      country_id:
        type: integer
      detail_address:
@@ -4479,6 +4645,10 @@
      bankAccountId:
        description: 账户id
        type: integer
      client:
        allOf:
        - $ref: '#/definitions/model.Client'
        description: 客户id
      clientId:
        description: 客户id
        type: integer
@@ -4949,18 +5119,6 @@
        type: integer
      name:
        type: string
    required:
    - id
    - name
    type: object
  request.UpdateServiceContractStatuss:
    properties:
      service_contract_status:
        items:
          $ref: '#/definitions/request.UpdateServiceContractStatus'
        type: array
    required:
    - service_contract_status
    type: object
  request.UpdateServiceContractType:
    properties:
@@ -5002,6 +5160,9 @@
        type: integer
      contact:
        $ref: '#/definitions/request.Contact'
      contact_id:
        description: 联系人ID
        type: integer
      country_id:
        type: integer
      detail_address:
@@ -5126,9 +5287,12 @@
      problemDesc:
        description: 问题描述
        type: string
      productId:
        description: 产品id
        type: integer
      productName:
        description: 产品名称
        type: string
      productTypeName:
        description: 产品分类名称
        type: string
      realTime:
        description: 实际处理时间
        type: string
@@ -5340,6 +5504,13 @@
      list:
        items:
          $ref: '#/definitions/model.ClientType'
        type: array
    type: object
  response.ContactInformationResponse:
    properties:
      list:
        items:
          $ref: '#/definitions/model.ContactInformation'
        type: array
    type: object
  response.ContactResponse:
@@ -5818,13 +5989,6 @@
          $ref: '#/definitions/model.Satisfaction'
        type: array
    type: object
  response.ServiceContractStatusResponse:
    properties:
      list:
        items:
          $ref: '#/definitions/model.ServiceContractStatus'
        type: array
    type: object
  response.ServiceContractTypeResponse:
    properties:
      list:
@@ -6284,6 +6448,25 @@
          schema:
            $ref: '#/definitions/contextx.Response'
      summary: 添加客户
      tags:
      - Client
  /api/client/checkName:
    post:
      parameters:
      - description: 参数
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.CheckClientName'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/contextx.Response'
      summary: 检查客户名称是否重复
      tags:
      - Client
  /api/client/delete:
@@ -6798,6 +6981,23 @@
      summary: 更新联系人
      tags:
      - Contact
  /api/contactInformation/list:
    get:
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/contextx.Response'
            - properties:
                data:
                  $ref: '#/definitions/response.ContactInformationResponse'
              type: object
      summary: 联系方式列表
      tags:
      - ContactInformation
  /api/contract/add:
    post:
      parameters:
@@ -6817,14 +7017,15 @@
      summary: 添加合同
      tags:
      - Contract
  /api/contract/delete/{id}:
  /api/contract/delete:
    delete:
      parameters:
      - description: 查询参数
        in: path
        name: id
        in: body
        name: object
        required: true
        type: integer
        schema:
          $ref: '#/definitions/request.DeleteContract'
      produces:
      - application/json
      responses:
@@ -8310,14 +8511,15 @@
      summary: 添加主订单
      tags:
      - MasterOrder
  /api/masterOrder/delete/{id}:
  /api/masterOrder/delete:
    delete:
      parameters:
      - description: 查询参数
        in: path
        name: id
        in: body
        name: object
        required: true
        type: integer
        schema:
          $ref: '#/definitions/request.DeleteMasterOrder'
      produces:
      - application/json
      responses:
@@ -9055,14 +9257,15 @@
      summary: 添加报价单
      tags:
      - Quotation
  /api/quotation/delete/{id}:
  /api/quotation/delete:
    delete:
      parameters:
      - description: 查询参数
        in: path
        name: id
        in: body
        name: object
        required: true
        type: integer
        schema:
          $ref: '#/definitions/request.DeleteQuotation'
      produces:
      - application/json
      responses:
@@ -9767,14 +9970,15 @@
      summary: 添加销售机会
      tags:
      - SaleChance
  /api/saleChance/delete/{id}:
  /api/saleChance/delete:
    delete:
      parameters:
      - description: 查询参数
        in: path
        name: id
        in: body
        name: object
        required: true
        type: integer
        schema:
          $ref: '#/definitions/request.DeleteSaleChance'
      produces:
      - application/json
      responses:
@@ -10210,7 +10414,26 @@
            $ref: '#/definitions/contextx.Response'
      summary: 添加销售退款
      tags:
      - SalesRefund
      - 销售退款单
  /api/salesRefund/delete:
    delete:
      parameters:
      - description: 参数
        in: body
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.CommonIds'
      produces:
      - application/json
      responses:
        "200":
          description: OK
          schema:
            $ref: '#/definitions/contextx.Response'
      summary: 批量删除销售退款单
      tags:
      - 销售退款单
  /api/salesRefund/delete/{id}:
    delete:
      parameters:
@@ -10228,7 +10451,7 @@
            $ref: '#/definitions/contextx.Response'
      summary: 删除销售退款
      tags:
      - SalesRefund
      - 销售退款单
  /api/salesRefund/list:
    post:
      parameters:
@@ -10252,7 +10475,7 @@
              type: object
      summary: 销售退款单列表
      tags:
      - SalesRefund
      - 销售退款单
  /api/salesRefund/update:
    put:
      parameters:
@@ -10271,7 +10494,7 @@
            $ref: '#/definitions/contextx.Response'
      summary: 更新销售退款
      tags:
      - SalesRefund
      - 销售退款单
  /api/salesReturn/add:
    post:
      parameters:
@@ -10767,9 +10990,9 @@
          description: OK
          schema:
            $ref: '#/definitions/contextx.Response'
      summary: 添加服务合同状态
      summary: 添加合同状态
      tags:
      - ServiceContractStatus
      - 合同状态
  /api/serviceContractStatus/delete/{id}:
    delete:
      parameters:
@@ -10785,11 +11008,37 @@
          description: OK
          schema:
            $ref: '#/definitions/contextx.Response'
      summary: 删除服务合同状态
      summary: 删除合同状态
      tags:
      - ServiceContractStatus
      - 合同状态
  /api/serviceContractStatus/list:
    get:
      parameters:
      - in: query
        name: keyword
        type: string
      - enum:
        - ""
        in: query
        name: keywordType
        type: string
        x-enum-varnames:
        - ServiceContractStatusKeywordCustomerName
      - description: 页码
        in: query
        name: page
        type: integer
      - description: 每页大小
        in: query
        name: pageSize
        type: integer
      - enum:
        - ""
        in: query
        name: queryClass
        type: string
        x-enum-varnames:
        - ServiceContractStatusQueryClassExpireLessThen60Days
      produces:
      - application/json
      responses:
@@ -10797,14 +11046,16 @@
          description: OK
          schema:
            allOf:
            - $ref: '#/definitions/contextx.Response'
            - $ref: '#/definitions/response.ListResponse'
            - properties:
                data:
                  $ref: '#/definitions/response.ServiceContractStatusResponse'
                  items:
                    $ref: '#/definitions/model.ServiceContractStatus'
                  type: array
              type: object
      summary: 获取服务合同状态列表
      summary: 获取合同状态列表
      tags:
      - ServiceContractStatus
      - 合同状态
  /api/serviceContractStatus/update:
    put:
      parameters:
@@ -10813,7 +11064,7 @@
        name: object
        required: true
        schema:
          $ref: '#/definitions/request.UpdateServiceContractStatuss'
          $ref: '#/definitions/request.UpdateServiceContractStatus'
      produces:
      - application/json
      responses:
@@ -10821,9 +11072,9 @@
          description: OK
          schema:
            $ref: '#/definitions/contextx.Response'
      summary: 更新服务合同状态
      summary: 更新合同状态
      tags:
      - ServiceContractStatus
      - 合同状态
  /api/serviceContractType/add:
    post:
      parameters:
@@ -11571,14 +11822,15 @@
      summary: 添加子订单
      tags:
      - SubOrder
  /api/subOrder/delete/{id}:
  /api/subOrder/delete:
    delete:
      parameters:
      - description: 查询参数
        in: path
        name: id
        in: body
        name: object
        required: true
        type: integer
        schema:
          $ref: '#/definitions/request.DeleteSubOrder'
      produces:
      - application/json
      responses: