功能描述和接口说明.md 2.9 KB

我的工单功能模块描述

1. 我创建的工单

功能描述

该模块用于展示当前登录用户创建的所有工单,包括维修工单和维保工单。系统会根据用户的创建者身份筛选出相关工单,并提供分页查询功能。对于非管理员用户,系统还会自动过滤掉已作废的工单。

接口描述

  • 接口地址: /gxt/orderMine/listMyCreate
  • 请求方法: GET
  • 功能说明: 查询当前用户创建的工单列表
  • 参数说明:
    • repairOrder: 维修工单查询条件对象
    • workOrder: 维保工单查询条件对象
  • 返回结果: TableDataInfo 分页数据
  • 权限控制: 非管理员用户会自动过滤作废工单
  • 2. 我处理的工单

    功能描述

    该模块展示当前登录用户作为处理人的所有工单。系统通过关联表(gxt_repair_order_flow和gxt_work_order_flow)查询用户参与处理的工单,并结合数据权限进行过滤。适用于需要跟踪自己处理过的工单场景。

    接口描述

    • 接口地址: /gxt/orderMine/listMyDone
    • 请求方法: GET
    • 功能说明: 查询当前用户处理过的工单列表
    • 参数说明:
      • repairOrder: 维修工单查询条件对象
      • workOrder: 维保工单查询条件对象
    • 返回结果: TableDataInfo 分页数据
    • 权限控制: 通过flow表关联查询处理人员,非管理员用户过滤作废工单
    • 3. 我相关的工单

      功能描述

      该模块展示与当前登录用户相关的所有工单,不仅限于创建人或处理人,还包括工单中涉及的其他相关人员。系统通过关联表(gxt_repair_order_person和gxt_work_order_person)查询用户关联的工单,适用场景更广泛。

      接口描述

      • 接口地址: /gxt/orderMine/listMyRelate
      • 请求方法: GET
      • 功能说明: 查询与当前用户相关的工单列表
      • 参数说明:
        • repairOrder: 维修工单查询条件对象
        • workOrder: 维保工单查询条件对象
      • 返回结果: TableDataInfo 分页数据
      • 权限控制: 通过person表关联查询相关人员,非管理员用户过滤作废工单
      • 4. 我的待办工单

        功能描述

        该模块展示当前登录用户的待办工单列表,即需要用户处理但尚未完成的工单。系统会根据用户的权限和工单状态进行智能过滤,只显示符合条件的待办事项,帮助用户快速定位需要处理的工作。

        接口描述

        • 接口地址: /gxt/orderMine/listMyTodo
        • 请求方法: GET
        • 功能说明: 查询当前用户的待办工单列表
        • 参数说明:
          • repairOrder: 维修工单查询条件对象
          • workOrder: 维保工单查询条件对象
        • 返回结果: TableDataInfo 分页数据
        • 权限控制: 根据用户权限构建过滤条件,确保只显示有权处理的工单