HomePage_Interface_Description.md 1.9 KB

首页统计数据接口说明

接口概述

首页统计数据接口用于获取用户相关的工单统计数据,包括维修工单数、维保工单数、工时统计、工分统计以及排名信息等。

接口详情

  • 接口地址: /gxt/repairOrder/selectHomePageData
  • 请求方法: GET
  • 接口描述: 获取首页统计数据和个人排名信息

返回数据结构

接口返回一个 GxtOrderData 对象,包含以下主要信息:

基础统计信息

  • workOrderNum: 本月维保工单数
  • workOrderNumLast: 上月维保工单数
  • repairOrderNum: 本月维修工单数
  • repairOrderNumLast: 上月维修工单数
  • wxgs: 维修工时
  • wxgsLast: 上月维修工时
  • wbgs: 维保工时
  • wbgsLast: 上月维保工时
  • score: 本月工分
  • scoreLast: 上月工分

衍生计算数据

  • workOrderJsy: 维保工单较上月增长率
  • repairOrderJsy: 维修工单较上月增长率
  • wbjsy: 维保工时较上月增长率
  • wxjsy: 维修工时较上月增长率
  • gfjsy: 工分较上月增长率

状态信息

  • repairPending: 待处理维修工单数
  • workPending: 待处理维保工单数
  • hasCenter: 是否有中心查看权限
  • timeOutNum: 超时工单数

排名信息

  • scoreCompany: 公司排名列表
  • scoreDept: 部门排名列表
  • scoreCenter: 中心排名列表
  • companySort: 公司排名
  • deptSort: 部门排名
  • centerSort: 中心排名

排名数据结构

排名信息由 GxtUserScore 对象列表组成,每个对象包含:

  • userName: 用户名
  • nickName: 用户昵称
  • deptName: 部门名称
  • center: 中心名称
  • companyName: 公司名称
  • finalScore: 最终得分

实现逻辑

  1. 根据当前用户ID和月份查询各类工单统计数据
  2. 计算各项数据的环比增长率
  3. 查询个人在公司、中心、部门中的排名信息
  4. 整合所有数据返回给前端