construction_management/web/docs/swagger.yaml

definitions:
  viewmodels.FolderContract:
    properties:
      bidsectionId:
        type: string
      children:
        items:
          $ref: '#/definitions/viewmodels.FolderContract'
        type: array
      childsTotal:
        type: integer
      contracts:
        type: integer
      contractsIncome:
        type: string
      contractsIncomeProgress:
        type: string
      contractsPaid:
        type: string
      contractsPay:
        type: string
      contractsPayProgress:
        type: string
      contractsReturned:
        type: string
      csrf:
        type: string
      hasFolder:
        description: Leaf        bool    `json:"leaf" `
        type: boolean
      id:
        type: string
      isBid:
        type: boolean
      isEnd:
        type: boolean
      isfolder:
        type: integer
      name:
        type: string
      parentId:
        type: string
      projectId:
        type: string
    type: object
  viewmodels.Project:
    properties:
      code:
        type: string
      id:
        type: string
      name:
        type: string
    type: object
  viewmodels.ProjectAccount:
    properties:
      account:
        type: string
      accountGroup:
        type: integer
      company:
        type: string
      csrf:
        type: string
      enable:
        type: integer
      id:
        type: string
      isAdmin:
        type: integer
      mobile:
        type: string
      name:
        type: string
      password:
        type: string
      position:
        type: string
      projectId:
        type: string
      role:
        type: string
      telephone:
        type: string
    type: object
  viewmodels.Tree:
    properties:
      ancounts:
        type: integer
      attribution:
        type: string
      bidsectionId:
        type: string
      children:
        items:
          $ref: '#/definitions/viewmodels.Tree'
        type: array
      childsTotal:
        type: integer
      createTime:
        type: string
      csrf:
        type: string
      depth:
        type: integer
      hasFolder:
        description: Leaf        bool    `json:"leaf" `
        type: boolean
      id:
        type: string
      isBid:
        type: boolean
      isEnd:
        type: boolean
      isfolder:
        type: integer
      name:
        type: string
      parentId:
        type: string
      projectId:
        type: string
      serial:
        type: string
      targetFolderId:
        type: string
      updateTime:
        type: string
    type: object
  viewmodels.TreeSectionContract:
    properties:
      attribution:
        type: string
      bidsectionId:
        type: string
      children:
        items:
          $ref: '#/definitions/viewmodels.TreeSectionContract'
        type: array
      code:
        type: string
      contractCode:
        type: string
      contractId:
        type: string
      contractName:
        type: string
      contractPrice:
        type: string
      contractReturned:
        type: string
      contractStatus:
        type: integer
      contractsPaid:
        type: string
      createTime:
        type: string
      depth:
        type: integer
      elderBrother:
        type: boolean
      id:
        type: string
      isEnd:
        type: boolean
      name:
        type: string
      operation:
        type: string
      parentId:
        type: string
      projectId:
        type: string
      serial:
        type: integer
      templateNumber:
        type: integer
    type: object
info:
  contact:
    name: CP Support
  description: 工程项目管理系统-接口
  license: {}
  title: 工程项目管理系统 API
  version: "1.0"
paths:
  /api/bidsection/create:
    post:
      consumes:
      - application/json
      description: 新增标段
      parameters:
      - description: 目录ID
        in: body
        name: folderId
        required: true
        schema:
          type: string
      - description: 名称
        in: body
        name: name
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 新增标段
      tags:
      - 目录相关-管理员
  /api/contract/folder:
    get:
      consumes:
      - application/json
      description: 获得合同目录和标段
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            $ref: '#/definitions/viewmodels.FolderContract'
      security:
      - ApiKeyAuth: []
      summary: 获得合同目录和标段
      tags:
      - 合同管理
  /api/contract/income:
    get:
      consumes:
      - application/json
      description: 获得合同详情和项目节详情
      parameters:
      - description: 项目节ID
        in: path
        name: id
        required: true
        type: string
      - description: 标段ID
        in: path
        name: bidsectionId
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,isContract:是否有合同（包含孩子们）,section:viewmodels.TreeSectionContract,msg:错误信息}'
          schema:
            $ref: '#/definitions/viewmodels.TreeSectionContract'
      security:
      - ApiKeyAuth: []
      summary: 单个合同详情和项目节详情
      tags:
      - 合同管理
  /api/contract/income/section/all:
    get:
      consumes:
      - application/json
      description: 未设置合同项目节 返回项目节模板信息
      parameters:
      - description: 标段ID
        in: path
        name: bidsectionId
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.TreeSectionContract,msg:错误信息}'
          schema:
            $ref: '#/definitions/viewmodels.TreeSectionContract'
      security:
      - ApiKeyAuth: []
      summary: 获得标段收入-项目节信息
      tags:
      - 合同管理
  /api/contract/section:
    delete:
      consumes:
      - application/json
      description: 删除 合同项目节
      parameters:
      - description: 项目节ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: 标段ID
        in: body
        name: bidsectionId
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 删除 合同项目节
      tags:
      - 合同管理
  /api/contract/section/add:
    post:
      consumes:
      - application/json
      description: 新增 合同项目节
      parameters:
      - description: 项目节ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: 标段ID
        in: body
        name: bidsectionId
        required: true
        schema:
          type: string
      - description: 项目节名称
        in: body
        name: name
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 新增 合同项目节
      tags:
      - 合同管理
  /api/contract/section/depth:
    post:
      consumes:
      - application/json
      description: operation{upDepth,downDepth}
      parameters:
      - description: 项目节ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: 标段ID
        in: body
        name: bidsectionId
        required: true
        schema:
          type: string
      - default: upDepth
        description: 操作名称
        in: body
        name: operation
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 升级降级合同项目节
      tags:
      - 合同管理
  /api/contract/section/save:
    post:
      consumes:
      - application/json
      description: 修改合同项目节 名称
      parameters:
      - description: 项目节ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: 标段ID
        in: body
        name: bidsectionId
        required: true
        schema:
          type: string
      - description: 项目节名称
        in: body
        name: name
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 修改合同项目节 名称
      tags:
      - 合同管理
  /api/contract/section/serial:
    post:
      consumes:
      - application/json
      description: operation{upSerial,downSerial}
      parameters:
      - description: 项目节ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: 标段ID
        in: body
        name: bidsectionId
        required: true
        schema:
          type: string
      - default: upSerial
        description: 操作名称
        in: body
        name: operation
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 上移下移合同项目节
      tags:
      - 合同管理
  /api/contract/section/serial/update:
    post:
      consumes:
      - application/json
      parameters:
      - description: 项目节ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: 标段ID
        in: body
        name: bidsectionId
        required: true
        schema:
          type: string
      - description: 操作名称
        in: body
        name: serial
        required: true
        schema:
          type: integer
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 更新合同节序号
      tags:
      - 合同管理
  /api/contract/section/template:
    post:
      consumes:
      - application/json
      description: 设置合同项目节模板
      parameters:
      - default: 1
        description: 模板号
        in: body
        name: templateNumber
        required: true
        schema:
          type: integer
      - description: 标段ID
        in: body
        name: bidsectionId
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 设置合同项目节模板
      tags:
      - 合同管理
  /api/login:
    post:
      consumes:
      - application/json
      description: 登录接口
      parameters:
      - default: "234"
        description: 项目编号
        in: body
        name: code
        required: true
        schema:
          type: string
      - default: caipin
        description: 项目账号
        in: body
        name: account
        required: true
        schema:
          type: string
      - default: "123456"
        description: 密码
        in: body
        name: password
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,data:viewmodels.ProjectAccount,msg:}'
          schema:
            $ref: '#/definitions/viewmodels.ProjectAccount'
        "400":
          description: '{code:-1参数类错误,msg:错误信息}'
          schema:
            type: string
      summary: 登录
      tags:
      - 登录/登出
  /api/login/out:
    post:
      consumes:
      - application/json
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0,msg:string}'
          schema:
            type: string
        "400":
          description: '{code:-1,msg:string}'
          schema:
            type: string
      summary: 登出
      tags:
      - 登录/登出
  /api/login/project/name:
    get:
      consumes:
      - application/json
      parameters:
      - default: '{code:2}'
        description: 项目编号
        in: query
        name: code
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,data:viewmodels.Project,msg:}'
          schema:
            $ref: '#/definitions/viewmodels.Project'
        "400":
          description: '{code:-1,msg:string}'
          schema:
            type: string
      summary: 获得项目名称
      tags:
      - 登录/登出
  /api/project:
    get:
      consumes:
      - application/json
      description: 获得登陆项目信息
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            $ref: '#/definitions/viewmodels.Project'
      security:
      - ApiKeyAuth: []
      summary: 获得登陆项目信息
      tags:
      - 项目相关
  /api/projectAccount:
    get:
      description: 获得登陆账号相关信息
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 获得登陆账号信息相关
      tags:
      - 项目账号相关
  /api/projectAccount/list:
    get:
      description: 获得项目账号列表
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 获得项目账号列表
      tags:
      - 项目账号相关
  /api/projectSetting/account:
    get:
      consumes:
      - application/json
      description: id获得单条信息<br/>
      parameters:
      - description: 账号ID
        in: body
        name: id
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            $ref: '#/definitions/viewmodels.ProjectAccount'
      security:
      - ApiKeyAuth: []
      summary: 获得项目账号列表
      tags:
      - 项目设置-管理员
  /api/projectSetting/account/change:
    post:
      consumes:
      - application/json
      description: 设置账号密码
      parameters:
      - default: PcqqGsn1O0jBSmLqkuOTwQ
        description: 账号ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - default: textoopd
        description: 账号
        in: body
        name: account
        required: true
        schema:
          type: string
      - default: ww123456
        description: 密码
        in: body
        name: password
        required: true
        schema:
          type: string
      - description: csrf
        in: header
        name: X-CSRF-Token
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 设置账号密码
      tags:
      - 项目设置-管理员
  /api/projectSetting/account/create:
    post:
      consumes:
      - application/json
      description: 新增账号
      parameters:
      - description: 账号
        in: body
        name: account
        required: true
        schema:
          type: string
      - description: 密码
        in: body
        name: password
        required: true
        schema:
          type: string
      - description: 姓名
        in: body
        name: name
        required: true
        schema:
          type: string
      - description: 公司
        in: body
        name: company
        required: true
        schema:
          type: string
      - description: 职位
        in: body
        name: position
        required: true
        schema:
          type: string
      - description: 手机
        in: body
        name: mobile
        required: true
        schema:
          type: string
      - description: 座机
        in: body
        name: telephone
        required: true
        schema:
          type: string
      - description: 账号组
        in: body
        name: accountGroup
        required: true
        schema:
          type: integer
      - description: csrf
        in: header
        name: X-CSRF-Token
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 创建账号
      tags:
      - 项目设置-管理员
  /api/projectSetting/account/delete:
    post:
      consumes:
      - application/json
      description: 删除账号
      parameters:
      - default: PcqqGsn1O0jBSmLqkuOTwQ
        description: 账号ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: csrf
        in: header
        name: X-CSRF-Token
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 删除账号
      tags:
      - 项目设置-管理员
  /api/projectSetting/account/enable:
    post:
      consumes:
      - application/json
      description: 账号启用/禁用
      parameters:
      - default: PcqqGsn1O0jBSmLqkuOTwQ
        description: 账号ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: 启用/禁用
        in: body
        name: enable
        required: true
        schema:
          type: integer
      - description: csrf
        in: header
        name: X-CSRF-Token
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 账号启用/禁用
      tags:
      - 项目设置-管理员
  /api/projectSetting/account/save:
    post:
      consumes:
      - application/json
      description: 编辑账号
      parameters:
      - default: PcqqGsn1O0jBSmLqkuOTwQ
        description: 账号ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: 姓名
        in: body
        name: name
        required: true
        schema:
          type: string
      - description: 公司
        in: body
        name: company
        required: true
        schema:
          type: string
      - description: 职位
        in: body
        name: position
        required: true
        schema:
          type: string
      - description: 座机
        in: body
        name: telephone
        required: true
        schema:
          type: string
      - description: 账号组
        in: body
        name: accountGroup
        required: true
        schema:
          type: integer
      - description: csrf
        in: header
        name: X-CSRF-Token
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 编辑账号
      tags:
      - 项目设置-管理员
  /api/projectSetting/account/search:
    get:
      consumes:
      - application/json
      description: 检索字段：账号 姓名 单位 手机 前匹配
      parameters:
      - description: 检索内容
        in: body
        name: name
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            $ref: '#/definitions/viewmodels.ProjectAccount'
      security:
      - ApiKeyAuth: []
      summary: 检索账号信息
      tags:
      - 项目设置-管理员
  /api/projectSetting/bid/account:
    delete:
      consumes:
      - application/json
      description: 移除标段成员-账号
      parameters:
      - description: 标段ID
        in: body
        name: bidsectionId
        schema:
          type: string
      - description: 账号ID
        in: body
        name: accountId
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 移除标段成员-账号
      tags:
      - 项目设置-标段成员权限-管理员
    get:
      consumes:
      - application/json
      description: 获得标段账号
      parameters:
      - description: 标段ID
        in: path
        name: bidsectionId
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            $ref: '#/definitions/viewmodels.ProjectAccount'
      security:
      - ApiKeyAuth: []
      summary: 获得标段账号
      tags:
      - 项目设置-标段成员权限-管理员
  /api/projectSetting/bid/account/create:
    post:
      consumes:
      - application/json
      description: 标段中添加成员-账号
      parameters:
      - description: 标段ID
        in: body
        name: bidsectionId
        schema:
          type: string
      - description: 账号ID
        in: body
        name: accountId
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 标段中添加成员-账号
      tags:
      - 项目设置-标段成员权限-管理员
  /api/projectSetting/project/save:
    post:
      consumes:
      - application/json
      description: 保存项目信息
      parameters:
      - default: 红旗大桥
        description: 账号ID
        in: body
        name: name
        required: true
        schema:
          type: string
      - description: csrf
        in: header
        name: X-CSRF-Token
        required: true
        type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,data:viewmodels.ProjectAccount,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 保存项目信息
      tags:
      - 项目设置-管理员
  /api/tree:
    delete:
      consumes:
      - application/json
      description: 删除目录下的目录以及其他内容
      parameters:
      - description: 目录ID
        in: body
        name: id
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 删除目录
      tags:
      - 目录相关-管理员
    get:
      consumes:
      - application/json
      description: 获得目录和数据
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,data:viewmodels.Tree,msg:}'
          schema:
            $ref: '#/definitions/viewmodels.Tree'
        "400":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 获得目录和数据
      tags:
      - 目录相关-管理员
  /api/tree/create:
    post:
      consumes:
      - application/json
      description: 新增目录
      parameters:
      - description: 目录ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: 目录深度 顶级目录(-1)其他级目录(0)
        in: body
        name: depth
        required: true
        schema:
          type: integer
      - description: 目录名称
        in: body
        name: name
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 新增目录
      tags:
      - 目录相关-管理员
  /api/tree/move:
    post:
      consumes:
      - application/json
      description: 移动文件夹
      parameters:
      - description: 目录ID
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: 被放置的目录ID
        in: body
        name: moveId
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 移动文件夹
      tags:
      - 目录相关-管理员
  /api/tree/rename:
    post:
      consumes:
      - application/json
      description: 重命名-文件夹或者标段
      parameters:
      - description: treeId
        in: body
        name: id
        required: true
        schema:
          type: string
      - description: 重命名的名称
        in: body
        name: name
        required: true
        schema:
          type: string
      produces:
      - application/json
      responses:
        "200":
          description: '{code:0成功,-1参数类错误,-2服务端内部错误,msg:错误信息}'
          schema:
            type: string
      security:
      - ApiKeyAuth: []
      summary: 重命名
      tags:
      - 目录相关-管理员
securityDefinitions:
  ApiKeyAuth:
    in: header
    name: X-CSRF-Token
    type: apiKey
swagger: "2.0"