CPS模块接口API说明文档.md 60.5 KB

Raw Blame History Permalink



CPS 模块接口 API 说明文档


目录


1. AB类改善接口


1.1 获取所有AB类改善列表
1.2 根据年份查询AB类改善汇总


2. C类改善接口


2.1 获取所有C类改善列表
2.2 根据年份和季度查询C类改善发起率汇总
2.3 根据年份、季度、室组id查询C类改善记录详情


3. CPS问题接口


3.1 获取所有CPS问题列表
3.2 根据计划解决时间范围汇总各责任单位下各处理状态的问题数
3.3 根据计划解决时间范围、责任单位id、问题处理状态查询问题记录明细
3.4 根据创建时间范围汇总各问题来源对应的问题数
3.5 根据创建时间范围、问题来源查询问题记录明细


4. 过程确认执行接口


4.1 获取所有过程确认执行记录列表
4.2 根据活动执行日期范围汇总过程确认执行记录统计信息
4.3 根据条件查询过程确认执行记录明细列表


5. PJO计划执行接口


5.1 根据PJO开展日期范围汇总PJO计划执行统计信息
5.2 根据条件查询人员PJO计划明细列表


6. 枚举定义接口


6.1 获取所有枚举定义常量数组信息


7. 基础信息接口


7.1 获取所有启用的线体列表
7.2 获取所有启用的单位（车间）列表
7.3 获取所有启用的室组列表
7.4 获取所有启用的区域列表
7.5 获取所有启用的班组列表
7.6 获取所有启用的班次列表


通用说明


环境域名

uat3环境： https://uat3.qgutech.com/fkyycustom


统一响应格式

所有接口返回统一的 JsonResult 结构（字段顺序以实际序列化为准）：

{
  "success": true,
  "data": [],
  "msg": "成功",
  "errCode": null
}


字段
类型
说明


success
Boolean
请求是否成功


data
Object/Array
响应数据体


msg
String
响应消息


errCode
String
错误码，成功时为 null


枚举值说明


季度枚举（QuarterEnum）


编号
描述
起始日期
结束日期


#1#
第一季度
01-01
03-31


#2#
第二季度
04-01
06-30


#3#
第三季度
07-01
09-30


#4#
第四季度
10-01
12-31


问题处理状态枚举（WtclztEnum）


编号
描述


#1#
待处理


#2#
处理中


#3#
已关闭


#4#
已逾期


问题来源枚举（WtlyEnum）


编号
描述


#1#
开班


#2#
过程验证


#3#
过程确认


#4#
体系健康体检


#5#
单位自检（单位牵头）


问题类别枚举（WtlbEnum）


编号
描述


#1#
方针展开


#2#
标准化作业


#3#
目视化


#4#
时间数据处理


#5#
过程确认


#6#
持续改善


问题性质枚举（WtxzEnum）


编号
描述


#1#
无标准


#2#
未执行标准


#3#
标准不足


6S分类枚举（SflEnum）


编号
描述


#1#
整理


#2#
整顿


#3#
清洁


#4#
清扫


#5#
素养


#6#
安全


问题层级枚举（MbghlkEnum）


编号
描述


#0#
0


#1#
1


#2#
2


#3#
3


#4#
4


#5#
5


人员类别枚举（RylbEnum）


编号
描述


#1#
区长


#2#
班长


#3#
高级经理


#4#
经理


#5#
主管


#6#
专家


#7#
一般员工


问题处理方式枚举（WtclfsEnum）


编号
描述


#1#
自己解决


#2#
工作安排/同级支持


#3#
问题升级至


C类改善状态枚举（CImprovementStatusEnum）


编号
描述


#1#
草稿


#2#
已提交


#3#
已否决


#4#
已确认


过程确认状态枚举（GcqrZtEnum）


编号
描述


#1#
待确认


#2#
未执行


#3#
已执行


#4#
已逾期


未执行原因枚举（WzxyysEnum）


编号
描述


#1#
车间停产


#99#
其他


PJO执行状态枚举（PjoExecZtEnum）


编号
描述


#1#
待执行


#2#
执行中


#3#
已执行


#4#
已关闭


岗位性质枚举（GwxzEnum）


编号
描述


#1#
A类


#2#
B类


#3#
C类


组员存在的问题枚举（ZyczdwtEnum）


编号
描述


#1#
无


说明：zyczdwt 字段值为 #1#-无 表示第三阶段未发现问题；其余任意非空值均表示第三阶段发现了一个问题。


数据状态枚举（DataStatusEnum）


编号
描述


#1#
草稿


#2#
启用


#3#
停用


车间状态枚举（WorkshopStatusEnum）


编号
描述


#1#
草稿


#2#
启用


#3#
停用


PJO工位状态枚举（GwztEnum）


编号
描述


#1#
未选中


#2#
已选中


#3#
已释放


说明：以上全部枚举（含未在此列出的）均可通过 GET /enum/list/all 接口一次性获取。


1. AB类改善接口


1.1 获取所有AB类改善列表

接口路径： GET /abImprovement/list/all

接口说明： 获取系统中所有AB类改善记录列表。

请求参数： 无

响应数据： List<AbImprovement>

响应字段说明：


字段
类型
说明


id
String
记录ID


createdAt
Date
创建时间（yyyy-MM-dd HHss）


lcslmc
String
流程实例名称


dwcj
String
单位车间id


sqr
String
申请人


sqbm
String
申请部门


sqrq
Date
申请日期


lxr
String
立项人


qnjyjz
Double
全年节约价值


gslx
String
改善类型


tdrs
Double
团队人数


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "abc123",
      "createdAt": "2026-09-15 10:30:00",
      "lcslmc": "AB类改善流程-2026-001",
      "dwcj": "workshop001",
      "sqr": "张三",
      "sqbm": "生产部",
      "sqrq": "2026-09-10 09:00:00",
      "lxr": "李四",
      "qnjyjz": 50000.0,
      "gslx": "效率提升",
      "tdrs": 5.0
    }
  ]
}


1.2 根据年份查询AB类改善汇总

接口路径： GET /abImprovement/summary/year

接口说明： 按单位车间分组汇总指定年份的AB类改善记录，包含节约价值汇总、目标值及完成率。

请求参数：


参数名
类型
必传
说明


year
String
否
年份，格式：yyyy，为空时默认当前年


响应数据： List<AbImprovementSummaryDTO>

响应字段说明：


字段
类型
说明


dwcj
String
单位车间编码


dwcjName
String
单位车间名称


dwcjCode
String
单位车间编号


year
String
年份


totalQnjyjz
Double
节约价值汇总


mb
Double
目标值


completionRate
Double
完成率（%）


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "dwcj": "workshop001",
      "dwcjName": "总装车间",
      "dwcjCode": "ZZ001",
      "year": "2026",
      "totalQnjyjz": 150000.0,
      "mb": 200000.0,
      "completionRate": 75.0
    }
  ]
}


2. C类改善接口


2.1 获取所有C类改善列表

接口路径： GET /cImprovement/list/all

接口说明： 获取系统中所有C类改善记录列表。

请求参数： 无

响应数据： List<CImprovement>

响应字段说明：


字段
类型
说明


id
String
记录ID


createdAt
Date
创建时间（yyyy-MM-dd HHss）


ygh
String
员工号


lywt
String
来源问题记录id


wtbh
String
问题编号


bm
String
部门id


sfwtlg
Boolean
是否问题类改善


sfscjb
Boolean
是否是车间班组


bz
String
班组信息id


gsmc
String
改善名称


qzqr
String
区长确认-组织用户id


gsyqr
String
改善员确认-组织用户id


sftsyxal
Boolean
是否推送优秀案例


zt
String
状态（#1#-草稿;#2#-已提交;#3#-已否决;#4#-已确认）


wtsm
String
问题说明


gshxg
String
改善后效果


fqr
String
发起人


szmc
String
室组信息id


processInstanceId
String
流程实例ID


approvalStatus
String
审批状态


sftsjdz
Boolean
是否推送金点子


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "c123",
      "createdAt": "2026-09-15 14:20:00",
      "ygh": "YG001",
      "lywt": "wt001",
      "wtbh": "WT202609001",
      "bm": "org001",
      "sfwtlg": true,
      "sfscjb": true,
      "bz": "team001",
      "gsmc": "优化装配流程",
      "qzqr": "user001",
      "gsyqr": "user002",
      "sftsyxal": false,
      "zt": "#2#",
      "wtsm": "装配效率低",
      "gshxg": "效率提升20%",
      "fqr": "user003",
      "szmc": "rg001",
      "processInstanceId": "pi123",
      "approvalStatus": "approved",
      "sftsjdz": false
    }
  ]
}


2.2 根据年份和季度查询C类改善发起率汇总

接口路径： GET /cImprovement/summary/quarter

接口说明： 按室组维度统计指定年份季度的C类改善发起率，包含室组总人数、有改善记录人数、发起率及目标值。

请求参数：


参数名
类型
必传
说明


year
String
否
年份，格式：yyyy，为空时默认当前年


quarter
String
是
季度枚举值（#1#-#4#）


响应数据： List<CImprovementSummaryDTO>

响应字段说明：


字段
类型
说明


szxx
String
室组编码


szmc
String
室组名称


szbh
String
室组编号


dwcj
String
所属单位车间编码


dwcjName
String
所属单位车间名称


dwcjCode
String
所属单位车间编号


year
String
年份


quarter
String
季度


quarterDesc
String
季度描述


totalPersonnel
Integer
室组总人数


improvementPersonnel
Integer
有C类改善记录的人数


improvementRate
Double
C类改善发起率（%）


mb
Double
目标值


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "szxx": "rg001",
      "szmc": "装配一组",
      "szbh": "SZ001",
      "dwcj": "workshop001",
      "dwcjName": "总装车间",
      "dwcjCode": "ZZ001",
      "year": "2026",
      "quarter": "#3#",
      "quarterDesc": "第三季度",
      "totalPersonnel": 50,
      "improvementPersonnel": 35,
      "improvementRate": 70.0,
      "mb": 80.0
    }
  ]
}


2.3 根据年份、季度、室组id查询C类改善记录详情

接口路径： GET /cImprovement/list/detail

接口说明： 查询指定年份季度时间范围内、由该室组下人员发起的C类改善记录，并补充关联实体名称。

请求参数：


参数名
类型
必传
说明


year
String
否
年份，格式：yyyy，为空时默认当前年


quarter
String
是
季度枚举值（#1#-#4#）


roomGroupId
String
是
室组id


响应数据： List<CImprovementDetailDTO>

响应字段说明：


字段
类型
说明


id
String
记录ID


createdAt
Date
创建时间（yyyy-MM-dd HHss）


gsmc
String
改善名称


wtbh
String
问题编号


lywt
String
来源问题记录id


wtsm
String
问题说明


gshxg
String
改善后效果


zt
String
状态（#1#-草稿;#2#-已提交;#3#-已否决;#4#-已确认）


ztDesc
String
状态名称


sfwtlg
Boolean
是否问题类改善


sfscjb
Boolean
是否是车间班组


sftsyxal
Boolean
是否推送优秀案例


sftsjdz
Boolean
是否推送金点子


processInstanceId
String
流程实例ID


approvalStatus
String
审批状态


szqymc
String
室组区域名称（原始字段）


ygh
String
员工号


yh
String
员工id（组织用户）


yhName
String
员工姓名（组织用户）


fqr
String
发起人id/工号


fqrName
String
发起人姓名


bm
String
部门id（组织结构）


bmName
String
部门名称（组织结构）


szmc
String
室组信息id


szmcName
String
室组名称


szbh
String
室组编号


bz
String
班组信息id


bzName
String
班组名称


dwcj
String
单位车间id


dwcjName
String
单位车间名称


dwcjCode
String
单位车间编号


szqy
String
区域id


szqyName
String
区域名称


qzqr
String
区长确认-组织用户id


qzqrName
String
区长确认-姓名


gsyqr
String
改善员确认-组织用户id


gsyqrName
String
改善员确认-姓名


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "c123",
      "createdAt": "2026-09-15 14:20:00",
      "gsmc": "优化装配流程",
      "wtbh": "WT202609001",
      "lywt": "wt001",
      "wtsm": "装配效率低",
      "gshxg": "效率提升20%",
      "zt": "#2#",
      "ztDesc": "已提交",
      "sfwtlg": true,
      "sfscjb": true,
      "sftsyxal": false,
      "sftsjdz": false,
      "processInstanceId": "pi123",
      "approvalStatus": "approved",
      "szqymc": "装配区域",
      "ygh": "YG001",
      "yh": "user001",
      "yhName": "张三",
      "fqr": "user003",
      "fqrName": "王五",
      "bm": "org001",
      "bmName": "生产部",
      "szmc": "rg001",
      "szmcName": "装配一组",
      "szbh": "SZ001",
      "bz": "team001",
      "bzName": "装配一班",
      "dwcj": "workshop001",
      "dwcjName": "总装车间",
      "dwcjCode": "ZZ001",
      "szqy": "area001",
      "szqyName": "装配区域",
      "qzqr": "user001",
      "qzqrName": "张三",
      "gsyqr": "user002",
      "gsyqrName": "李四"
    }
  ]
}


3. CPS问题接口


3.1 获取所有CPS问题列表

接口路径： GET /cpsProblem/list/all

接口说明： 获取系统中所有CPS问题记录列表。

请求参数： 无

响应数据： List<CpsProblem>

响应字段说明：


字段
类型
说明


id
String
记录ID


createdAt
Date
创建时间（yyyy-MM-dd HHss）


wtbh
String
问题编号


wtly
String
问题来源（#1#-开班;#2#-过程验证;#3#-过程确认;#4#-体系健康体检;#5#-单位自检）


wttcr
String
问题提出人


gzdw
String
工作单位


rylb
String
人员类别（#1#-区长;#2#-班长;#3#-高级经理;#4#-经理;#5#-主管;#6#-专家;#7#-一般员工）


wtms
String
问题描述


wtzrdw
String
问题责任单位


wtfj
String
问题附件


wtssbk
String
问题所属板块


wtlb
String
问题类别（#1#-方针展开;#2#-标准化作业;#3#-目视化;#4#-时间数据处理;#5#-过程确认;#6#-持续改善）


wtxz
String
问题性质（#1#-无标准;#2#-未执行标准;#3#-标准不足）


sfl
String
6S分类（#1#-整理;#2#-整顿;#3#-清洁;#4#-清扫;#5#-素养;#6#-安全）


wtsfgb
Boolean
问题是否关闭


sz
String
室组


mbghlk
String
问题层级（#0#-0;#1#-1;#2#-2;#3#-3;#4#-4;#5#-5）


wtclfs
String
问题处理方式（#1#-自己解决;#2#-工作安排/同级支持;#3#-问题升级至）


tntpvy
Date
问题解决时间


gzap
String
工作安排/同级支持


wtsjz
String
问题升级至


wtjjcs
String
问题解决措施


wtzghfj
String
问题整改后附件


wtclr
String
问题处理人


wtclzt
String
问题处理状态（#1#-待处理;#2#-处理中;#3#-已关闭;#4#-已逾期）


qy
String
区域


bz
String
班组


jhjjsj
Date
计划解决时间


wtclfs2
String
问题处理方式2


gzap2
String
工作安排/同级支持2


wtsjz2
String
问题升级至2


wtclfs3
String
问题处理方式3


gzap3
String
工作安排/同级支持3


wtsjz3
String
问题升级至3


processInstanceId
String
流程实例ID


approvalStatus
String
审批状态


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "p123",
      "createdAt": "2026-09-15 09:00:00",
      "wtbh": "WT202609001",
      "wtly": "#1#",
      "wttcr": "user001",
      "gzdw": "workshop001",
      "rylb": "#1#",
      "wtms": "装配线设备故障",
      "wtzrdw": "workshop002",
      "wtfj": "file001",
      "wtssbk": "设备管理",
      "wtlb": "#2#",
      "wtxz": "#1#",
      "sfl": "#6#",
      "wtsfgb": false,
      "sz": "rg001",
      "mbghlk": "#1#",
      "wtclfs": "#1#",
      "tntpvy": "2026-09-20 18:00:00",
      "gzap": "安排维修",
      "wtsjz": "",
      "wtjjcs": "更换零件",
      "wtzghfj": "file002",
      "wtclr": "user002",
      "wtclzt": "#2#",
      "qy": "area001",
      "bz": "team001",
      "jhjjsj": "2026-09-25 18:00:00",
      "wtclfs2": "",
      "gzap2": "",
      "wtsjz2": "",
      "wtclfs3": "",
      "gzap3": "",
      "wtsjz3": "",
      "processInstanceId": "pi123",
      "approvalStatus": "processing"
    }
  ]
}


3.2 根据计划解决时间范围汇总各责任单位下各处理状态的问题数

接口路径： GET /cpsProblem/summary/status

接口说明： 按计划解决时间范围查询问题记录，按责任单位分组统计各处理状态下的问题数。

请求参数：


参数名
类型
必传
说明


startTime
String
否
开始时间，格式：yyyy-MM-dd [HHss]，为空默认当前月1号 00:00:00


endTime
String
否
结束时间，格式：yyyy-MM-dd [HHss]，为空默认当前月最后一天 23:59:59


响应数据： List<CpsProblemSummaryDTO>

响应字段说明：


字段
类型
说明


wtzrdw
String
责任单位id


wtzrdwName
String
责任单位名称


wtzrdwCode
String
责任单位编号


totalCount
Integer
该责任单位下问题总数


statusCounts
Array
各处理状态下的问题数明细


statusCounts[].statusCode
String
状态编号


statusCounts[].statusDesc
String
状态中文描述


statusCounts[].count
Integer
该状态下的问题数


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "wtzrdw": "workshop001",
      "wtzrdwName": "总装车间",
      "wtzrdwCode": "ZZ001",
      "totalCount": 25,
      "statusCounts": [
        {
          "statusCode": "#1#",
          "statusDesc": "待处理",
          "count": 5
        },
        {
          "statusCode": "#2#",
          "statusDesc": "处理中",
          "count": 10
        },
        {
          "statusCode": "#3#",
          "statusDesc": "已关闭",
          "count": 8
        },
        {
          "statusCode": "#4#",
          "statusDesc": "已逾期",
          "count": 2
        }
      ]
    }
  ]
}


3.3 根据计划解决时间范围、责任单位id、问题处理状态查询问题记录明细

接口路径： GET /cpsProblem/list/detail

接口说明： 按计划解决时间范围、责任单位id、问题处理状态查询问题记录明细，包含关联实体名称。

请求参数：


参数名
类型
必传
说明


startTime
String
否
开始时间，格式：yyyy-MM-dd [HHss]，为空默认当前月1号 00:00:00


endTime
String
否
结束时间，格式：yyyy-MM-dd [HHss]，为空默认当前月最后一天 23:59:59


wtzrdwId
String
是
责任单位id


status
String
是
问题处理状态编号（#1#-待处理;#2#-处理中;#3#-已关闭;#4#-已逾期）


响应数据： List<CpsProblemDetailDTO>

响应字段说明：


字段
类型
说明


id
String
记录ID


createdAt
Date
创建时间（yyyy-MM-dd HHss）


wtbh
String
问题编号


wtms
String
问题描述


wtly
String
问题来源编号


wtlyDesc
String
问题来源名称


wtssbk
String
问题所属板块


wtlb
String
问题类别编号


wtlbDesc
String
问题类别名称


wtxz
String
问题性质编号


wtxzDesc
String
问题性质名称


sfl
String
6S分类编号


sflDesc
String
6S分类名称


mbghlk
String
问题层级编号


mbghlkDesc
String
问题层级名称


rylb
String
人员类别编号


rylbDesc
String
人员类别名称


wtsfgb
Boolean
问题是否关闭


wtfj
String
问题附件


wtzghfj
String
问题整改后附件


wtjjcs
String
问题解决措施


wtclfs
String
问题处理方式编号


wtclfsDesc
String
问题处理方式名称


gzap
String
工作安排/同级支持


wtsjz
String
问题升级至


wtclfs2
String
问题处理方式2编号


wtclfs2Desc
String
问题处理方式2名称


gzap2
String
工作安排/同级支持2


wtsjz2
String
问题升级至2


wtclfs3
String
问题处理方式3编号


wtclfs3Desc
String
问题处理方式3名称


gzap3
String
工作安排/同级支持3


wtsjz3
String
问题升级至3


jhjjsj
Date
计划解决时间（yyyy-MM-dd HHss）


tntpvy
Date
问题解决时间（yyyy-MM-dd HHss）


processInstanceId
String
流程实例ID


approvalStatus
String
审批状态


gzdw
String
工作单位id


gzdwName
String
工作单位名称


gzdwCode
String
工作单位编号


wtzrdw
String
问题责任单位id


wtzrdwName
String
问题责任单位名称


wtzrdwCode
String
问题责任单位编号


sz
String
室组id


szName
String
室组名称


szCode
String
室组编号


qy
String
区域id


qyName
String
区域名称


qyCode
String
区域编号


bz
String
班组id


bzName
String
班组名称


bzCode
String
班组编号


wttcr
String
问题提出人id


wttcrName
String
问题提出人姓名


wtclr
String
问题处理人id


wtclrName
String
问题处理人姓名


wtclzt
String
问题处理状态编号


wtclztDesc
String
问题处理状态中文描述


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "p123",
      "createdAt": "2026-09-15 09:00:00",
      "wtbh": "WT202609001",
      "wtms": "装配线设备故障",
      "wtly": "#1#",
      "wtlyDesc": "开班",
      "wtssbk": "设备管理",
      "wtlb": "#2#",
      "wtlbDesc": "标准化作业",
      "wtxz": "#1#",
      "wtxzDesc": "无标准",
      "sfl": "#6#",
      "sflDesc": "安全",
      "mbghlk": "#1#",
      "mbghlkDesc": "1",
      "rylb": "#1#",
      "rylbDesc": "区长",
      "wtsfgb": false,
      "wtfj": "file001",
      "wtzghfj": "file002",
      "wtjjcs": "更换零件",
      "wtclfs": "#1#",
      "wtclfsDesc": "自己解决",
      "gzap": "安排维修",
      "wtsjz": "",
      "wtclfs2": "",
      "wtclfs2Desc": "",
      "gzap2": "",
      "wtsjz2": "",
      "wtclfs3": "",
      "wtclfs3Desc": "",
      "gzap3": "",
      "wtsjz3": "",
      "jhjjsj": "2026-09-25 18:00:00",
      "tntpvy": "2026-09-20 18:00:00",
      "processInstanceId": "pi123",
      "approvalStatus": "processing",
      "gzdw": "workshop001",
      "gzdwName": "总装车间",
      "gzdwCode": "ZZ001",
      "wtzrdw": "workshop002",
      "wtzrdwName": "维修车间",
      "wtzrdwCode": "WX001",
      "sz": "rg001",
      "szName": "装配一组",
      "szCode": "SZ001",
      "qy": "area001",
      "qyName": "装配区域",
      "qyCode": "QY001",
      "bz": "team001",
      "bzName": "装配一班",
      "bzCode": "BZ001",
      "wttcr": "user001",
      "wttcrName": "张三",
      "wtclr": "user002",
      "wtclrName": "李四",
      "wtclzt": "#2#",
      "wtclztDesc": "处理中"
    }
  ]
}


3.4 根据创建时间范围汇总各问题来源对应的问题数

接口路径： GET /cpsProblem/summary/source

接口说明： 按创建时间范围查询问题记录，按问题来源维度汇总问题数。

请求参数：


参数名
类型
必传
说明


startTime
String
否
开始时间，格式：yyyy-MM-dd [HHss]，为空默认当前月1号 00:00:00


endTime
String
否
结束时间，格式：yyyy-MM-dd [HHss]，为空默认当前月最后一天 23:59:59


响应数据： List<CpsProblemSourceSummaryDTO>

响应字段说明：


字段
类型
说明


wtly
String
问题来源编号


wtlyDesc
String
问题来源中文名称


count
Integer
该问题来源下的问题数


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "wtly": "#1#",
      "wtlyDesc": "开班",
      "count": 15
    },
    {
      "wtly": "#2#",
      "wtlyDesc": "过程验证",
      "count": 8
    },
    {
      "wtly": "#3#",
      "wtlyDesc": "过程确认",
      "count": 12
    },
    {
      "wtly": "#4#",
      "wtlyDesc": "体系健康体检",
      "count": 5
    },
    {
      "wtly": "#5#",
      "wtlyDesc": "单位自检（单位牵头）",
      "count": 3
    }
  ]
}


3.5 根据创建时间范围、问题来源查询问题记录明细

接口路径： GET /cpsProblem/list/detail/source

接口说明： 按创建时间范围、问题来源查询问题记录明细，包含关联实体名称。

请求参数：


参数名
类型
必传
说明


startTime
String
否
开始时间，格式：yyyy-MM-dd [HHss]，为空默认当前月1号 00:00:00


endTime
String
否
结束时间，格式：yyyy-MM-dd [HHss]，为空默认当前月最后一天 23:59:59


wtly
String
是
问题来源编号（#1#-开班;#2#-过程验证;#3#-过程确认;#4#-体系健康体检;#5#-单位自检）


响应数据： List<CpsProblemDetailDTO>

响应字段说明： 同 3.3 根据计划解决时间范围、责任单位id、问题处理状态查询问题记录明细

响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "p123",
      "createdAt": "2026-09-15 09:00:00",
      "wtbh": "WT202609001",
      "wtms": "装配线设备故障",
      "wtly": "#1#",
      "wtlyDesc": "开班",
      "wtssbk": "设备管理",
      "wtlb": "#2#",
      "wtlbDesc": "标准化作业",
      "wtxz": "#1#",
      "wtxzDesc": "无标准",
      "sfl": "#6#",
      "sflDesc": "安全",
      "mbghlk": "#1#",
      "mbghlkDesc": "1",
      "rylb": "#1#",
      "rylbDesc": "区长",
      "wtsfgb": false,
      "wtfj": "file001",
      "wtzghfj": "file002",
      "wtjjcs": "更换零件",
      "wtclfs": "#1#",
      "wtclfsDesc": "自己解决",
      "gzap": "安排维修",
      "wtsjz": "",
      "wtclfs2": "",
      "wtclfs2Desc": "",
      "gzap2": "",
      "wtsjz2": "",
      "wtclfs3": "",
      "wtclfs3Desc": "",
      "gzap3": "",
      "wtsjz3": "",
      "jhjjsj": "2026-09-25 18:00:00",
      "tntpvy": "2026-09-20 18:00:00",
      "processInstanceId": "pi123",
      "approvalStatus": "processing",
      "gzdw": "workshop001",
      "gzdwName": "总装车间",
      "gzdwCode": "ZZ001",
      "wtzrdw": "workshop002",
      "wtzrdwName": "维修车间",
      "wtzrdwCode": "WX001",
      "sz": "rg001",
      "szName": "装配一组",
      "szCode": "SZ001",
      "qy": "area001",
      "qyName": "装配区域",
      "qyCode": "QY001",
      "bz": "team001",
      "bzName": "装配一班",
      "bzCode": "BZ001",
      "wttcr": "user001",
      "wttcrName": "张三",
      "wtclr": "user002",
      "wtclrName": "李四",
      "wtclzt": "#2#",
      "wtclztDesc": "处理中"
    }
  ]
}


4. 过程确认执行接口


4.1 获取所有过程确认执行记录列表

接口路径： GET /processConfirmExec/list/all

接口说明： 获取系统中所有过程确认计划执行记录列表。

请求参数： 无

响应数据： List<ProcessConfirmExec>

响应字段说明：


字段
类型
说明


id
String
记录ID


createdAt
Date
创建时间（yyyy-MM-dd HHss）


hdzxrq
Date
活动执行日期


gcqrjhry
String
过程确认计划人员id


zxry
String
执行人员id


gh
String
工号


rylb
String
人员类别（#1#-区长;#2#-班长;#3#-高级经理;#4#-经理;#5#-主管;#6#-专家;#7#-一般员工）


dw
String
单位id


sz
String
室组id


qy
String
区域id


bz
String
班组id


xt
String
线体id


bc
String
班次id


gqsj
Date
过期时间


zt
String
状态（#1#-待确认;#2#-未执行;#3#-已执行;#4#-已逾期）


sfyzx
Boolean
是否已执行


wzxyysm
String
未执行原因说明


sffxwt
Boolean
是否发现问题


wzxyys
String
未执行原因（#1#-车间停产;#99#-其他）


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "a8IaDbP2C79yQsAY6Vv",
      "createdAt": "2026-09-11 01:47:47",
      "hdzxrq": "2026-09-11 01:47:47",
      "gcqrjhry": "XMOHi7joEhYbGCQ3JZ4",
      "zxry": "jU1pkX6iMiZjUPP19MP",
      "gh": "18326083100",
      "rylb": "#2#",
      "dw": "ahImSLxXBuQkFtU8Ace",
      "sz": "gjCsFTBShT36aQhnACN",
      "qy": "NpZtfnU8FcGXCXPUhEr",
      "bz": "6Lj0fH9rB5bXm19thta",
      "xt": "Uh0niQWd9MPKym55RvN",
      "bc": "rdFZ59DMjk5EzDV4uFo",
      "gqsj": "2026-09-11 15:59:59",
      "zt": "#3#",
      "sfyzx": true,
      "wzxyysm": null,
      "sffxwt": true,
      "wzxyys": null
    }
  ]
}


4.2 根据活动执行日期范围汇总过程确认执行记录统计信息

接口路径： GET /processConfirmExec/summary/exec

接口说明： 按活动执行日期范围查询过程确认执行记录，返回整体、各单位、各单位下各人员类别三个维度的统计信息。统计指标包括记录总数、已执行数量、执行率、问题发现数、问题发现率。开始时间为空时默认使用当前月 1 号，结束时间为空时默认使用当前日期前一天。

请求参数：


参数名
类型
必传
说明


startTime
String
否
开始时间，格式：yyyy-MM-dd [HHss]，为空默认当前月 1 号 00:00:00


endTime
String
否
结束时间，格式：yyyy-MM-dd [HHss]，为空默认当前日期前一天 23:59:59


响应数据： ProcessConfirmExecSummaryDTO

响应字段说明：


字段
类型
说明


dw
String
单位id（整体汇总时为 null）


dwName
String
单位名称（整体汇总时为 null）


dwCode
String
单位编号（整体汇总时为 null）


totalCount
Integer
记录总数


executedCount
Integer
已执行数量


execRate
Double
执行率（%）= 已执行数量 / 记录总数 × 100


problemCount
Integer
问题发现数


problemRate
Double
问题发现率（%）= 问题数 / 记录总数 × 100


rylbStats
Array
各人员类别下的统计明细


rylbStats[].rylb
String
人员类别编号


rylbStats[].rylbDesc
String
人员类别中文描述


rylbStats[].totalCount
Integer
该人员类别下记录总数


rylbStats[].executedCount
Integer
该人员类别下已执行数量


rylbStats[].execRate
Double
该人员类别下执行率（%）


rylbStats[].problemCount
Integer
该人员类别下问题发现数


rylbStats[].problemRate
Double
该人员类别下问题发现率（%）


dwStats
Array
各单位统计信息列表（结构同本 DTO，仅整体汇总时返回）


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": {
    "dw": null,
    "dwName": null,
    "dwCode": null,
    "totalCount": 8,
    "executedCount": 6,
    "execRate": 75,
    "problemCount": 4,
    "problemRate": 50,
    "rylbStats": [],
    "dwStats": [
      {
        "dw": "ahImSLxXBuQkFtU8Ace",
        "dwName": "总装车间",
        "dwCode": "104",
        "totalCount": 5,
        "executedCount": 4,
        "execRate": 80,
        "problemCount": 3,
        "problemRate": 60,
        "rylbStats": [
          {
            "rylb": "#1#",
            "rylbDesc": "区长",
            "totalCount": 0,
            "executedCount": 0,
            "execRate": 0,
            "problemCount": 0,
            "problemRate": 0
          },
          {
            "rylb": "#2#",
            "rylbDesc": "班长",
            "totalCount": 5,
            "executedCount": 4,
            "execRate": 80,
            "problemCount": 3,
            "problemRate": 60
          },
          {
            "rylb": "#3#",
            "rylbDesc": "高级经理",
            "totalCount": 0,
            "executedCount": 0,
            "execRate": 0,
            "problemCount": 0,
            "problemRate": 0
          },
          {
            "rylb": "#4#",
            "rylbDesc": "经理",
            "totalCount": 0,
            "executedCount": 0,
            "execRate": 0,
            "problemCount": 0,
            "problemRate": 0
          },
          {
            "rylb": "#5#",
            "rylbDesc": "主管",
            "totalCount": 0,
            "executedCount": 0,
            "execRate": 0,
            "problemCount": 0,
            "problemRate": 0
          },
          {
            "rylb": "#6#",
            "rylbDesc": "专家",
            "totalCount": 0,
            "executedCount": 0,
            "execRate": 0,
            "problemCount": 0,
            "problemRate": 0
          },
          {
            "rylb": "#7#",
            "rylbDesc": "一般员工",
            "totalCount": 0,
            "executedCount": 0,
            "execRate": 0,
            "problemCount": 0,
            "problemRate": 0
          }
        ],
        "dwStats": []
      },
      {
        "dw": "Iv9y56sXFNZyuPFPQ85",
        "dwName": "人力资源处",
        "dwCode": "108",
        "totalCount": 3,
        "executedCount": 2,
        "execRate": 66.67,
        "problemCount": 1,
        "problemRate": 33.33,
        "rylbStats": [
          {
            "rylb": "#1#",
            "rylbDesc": "区长",
            "totalCount": 3,
            "executedCount": 2,
            "execRate": 66.67,
            "problemCount": 1,
            "problemRate": 33.33
          }
        ],
        "dwStats": []
      }
    ]
  }
}


4.3 根据条件查询过程确认执行记录明细列表

接口路径： GET /processConfirmExec/list/detail

接口说明： 按条件查询过程确认执行记录明细（不含问题记录信息），并补充关联实体名称与枚举中文描述。所有参数均非必填；开始时间为空时默认使用当前月 1 号，结束时间为空时默认使用当前日期前一天。

请求参数：


参数名
类型
必传
说明


startTime
String
否
开始时间，格式：yyyy-MM-dd [HHss]，为空默认当前月 1 号 00:00:00


endTime
String
否
结束时间，格式：yyyy-MM-dd [HHss]，为空默认当前日期前一天 23:59:59


dw
String
否
单位id


rylb
String
否
人员类别编号（#1#-#7#，兼容 1 ~ 7）


zt
String
否
过程确认状态编号（#1#-#4#，兼容 1 ~ 4）


响应数据： List<ProcessConfirmExecDetailDTO>

响应字段说明：


字段
类型
说明


id
String
记录ID


createdAt
Date
创建时间（yyyy-MM-dd HHss）


hdzxrq
Date
活动执行日期（yyyy-MM-dd HHss）


gqsj
Date
过期时间（yyyy-MM-dd HHss）


gcqrjhry
String
过程确认计划人员id


gcqrjhryName
String
过程确认计划人员姓名


zxry
String
执行人员id


gh
String
工号


rylb
String
人员类别编号


rylbDesc
String
人员类别名称


zt
String
状态编号


ztDesc
String
状态名称


sfyzx
Boolean
是否已执行


sffxwt
Boolean
是否发现问题


wzxyys
String
未执行原因编号


wzxyysDesc
String
未执行原因名称


wzxyysm
String
未执行原因说明


dw
String
单位id


dwName
String
单位名称


dwCode
String
单位编号


sz
String
室组id


szName
String
室组名称


szCode
String
室组编号


qy
String
区域id


qyName
String
区域名称


qyCode
String
区域编号


bz
String
班组id


bzName
String
班组名称


bzCode
String
班组编号


xt
String
线体id


xtName
String
线体名称


xtCode
String
线体编号


bc
String
班次id


bcName
String
班次名称


bcCode
String
班次编号


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "a8IaDbP2C79yQsAY6Vv",
      "createdAt": null,
      "hdzxrq": "2026-09-11 01:47:47",
      "gqsj": "2026-09-11 15:59:59",
      "gcqrjhry": "XMOHi7joEhYbGCQ3JZ4",
      "gcqrjhryName": "陈工",
      "zxry": "jU1pkX6iMiZjUPP19MP",
      "gh": "18326083100",
      "rylb": "#2#",
      "rylbDesc": "班长",
      "zt": "#3#",
      "ztDesc": "已执行",
      "sfyzx": true,
      "sffxwt": true,
      "wzxyys": null,
      "wzxyysDesc": null,
      "wzxyysm": null,
      "dw": "ahImSLxXBuQkFtU8Ace",
      "dwName": "总装车间",
      "dwCode": "104",
      "sz": "gjCsFTBShT36aQhnACN",
      "szName": "制造室",
      "szCode": "76",
      "qy": "NpZtfnU8FcGXCXPUhEr",
      "qyName": "制造室",
      "qyCode": "76",
      "bz": "6Lj0fH9rB5bXm19thta",
      "bzName": "班组1",
      "bzCode": "999",
      "xt": "Uh0niQWd9MPKym55RvN",
      "xtName": "A线",
      "xtCode": "A",
      "bc": "rdFZ59DMjk5EzDV4uFo",
      "bcName": "一班",
      "bcCode": "1"
    }
  ]
}


5. PJO计划执行接口


5.1 根据PJO开展日期范围汇总PJO计划执行统计信息

接口路径： GET /pjoExec/summary/exec

接口说明： 按 PJO 开展日期（qkxdwk）范围查询 PJO 计划执行记录，返回 整体 → 各车间 → 各 PJO 执行人 三级维度的统计信息。统计指标包括 PJO 计划数、已执行数（状态 #3#-已执行）、执行率，以及第一/二/三阶段问题数与发现率、整体问题数与发现率。

问题按三个阶段分别判定：


第一阶段：观察的问题（gcdwt）有值 → 发现一个问题；

第二阶段：观察的改善点描述（lfwkuc）有值 → 发现一个问题；

第三阶段：组员存在的问题（zyczdwt）有值且不是 #1#-无 → 发现一个问题。


开始时间为空时默认使用当前月 1 号，结束时间为空时默认使用当前日期前一天。车间按编号升序、执行人按姓名升序排列。

请求参数：


参数名
类型
必传
说明


startTime
String
否
开始时间，格式：yyyy-MM-dd [HHss]，为空默认当前月 1 号 00:00:00


endTime
String
否
结束时间，格式：yyyy-MM-dd [HHss]，为空默认当前日期前一天 23:59:59


响应数据： PjoExecSummaryDTO

响应字段说明：

整体、cjStats[]、zxrStats[] 三级均包含下表相同的统计字段（公共统计指标）：


字段
类型
说明


totalCount
Integer
PJO计划数（记录总数）


executedCount
Integer
已执行数量（状态 #3#-已执行）


execRate
Double
执行率（%）= 已执行数量 / PJO计划数 × 100


stage1ProblemCount
Integer
第一阶段问题数（gcdwt 有值）


stage1ProblemRate
Double
第一阶段问题发现率（%）= 第一阶段问题数 / PJO计划数 × 100


stage2ProblemCount
Integer
第二阶段问题数（lfwkuc 有值）


stage2ProblemRate
Double
第二阶段问题发现率（%）= 第二阶段问题数 / PJO计划数 × 100


stage3ProblemCount
Integer
第三阶段问题数（zyczdwt 有值且非 #1#-无）


stage3ProblemRate
Double
第三阶段问题发现率（%）= 第三阶段问题数 / PJO计划数 × 100


problemCount
Integer
整体问题数（第一、二、三阶段合计）


problemRate
Double
整体问题发现率（%）= 整体问题数 / PJO计划数 × 100


注：单条记录最多可同时命中三个阶段（贡献 3 个问题），因此 problemRate 及各阶段发现率之和可能大于 100%。


各级额外字段：


字段
类型
说明


cjStats
Array
各车间统计信息列表（仅整体层返回）


cjStats[].cj
String
车间id


cjStats[].cjName
String
车间名称


cjStats[].cjCode
String
车间编号


cjStats[].zxrStats
Array
该车间下各 PJO 执行人统计信息列表


zxrStats[].pjozxr
String
PJO执行人id（组织用户）


zxrStats[].pjozxrName
String
PJO执行人姓名


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": {
    "totalCount": 6,
    "executedCount": 5,
    "execRate": 83.33,
    "stage1ProblemCount": 3,
    "stage1ProblemRate": 50,
    "stage2ProblemCount": 3,
    "stage2ProblemRate": 50,
    "stage3ProblemCount": 2,
    "stage3ProblemRate": 33.33,
    "problemCount": 8,
    "problemRate": 133.33,
    "cjStats": [
      {
        "cj": "ahImSLxXBuQkFtU8Ace",
        "cjName": "总装车间",
        "cjCode": "104",
        "totalCount": 5,
        "executedCount": 4,
        "execRate": 80,
        "stage1ProblemCount": 2,
        "stage1ProblemRate": 40,
        "stage2ProblemCount": 2,
        "stage2ProblemRate": 40,
        "stage3ProblemCount": 2,
        "stage3ProblemRate": 40,
        "problemCount": 6,
        "problemRate": 120,
        "zxrStats": [
          {
            "pjozxr": "cyTZZMgy3WliwVfM3LT",
            "pjozxrName": "周雪",
            "totalCount": 2,
            "executedCount": 2,
            "execRate": 100,
            "stage1ProblemCount": 2,
            "stage1ProblemRate": 100,
            "stage2ProblemCount": 2,
            "stage2ProblemRate": 100,
            "stage3ProblemCount": 2,
            "stage3ProblemRate": 100,
            "problemCount": 6,
            "problemRate": 300
          },
          {
            "pjozxr": "jU1pkX6iMiZjUPP19MP",
            "pjozxrName": "陈工",
            "totalCount": 3,
            "executedCount": 2,
            "execRate": 66.67,
            "stage1ProblemCount": 0,
            "stage1ProblemRate": 0,
            "stage2ProblemCount": 0,
            "stage2ProblemRate": 0,
            "stage3ProblemCount": 0,
            "stage3ProblemRate": 0,
            "problemCount": 0,
            "problemRate": 0
          }
        ]
      },
      {
        "cj": "Iv9y56sXFNZyuPFPQ85",
        "cjName": "人力资源处",
        "cjCode": "108",
        "totalCount": 1,
        "executedCount": 1,
        "execRate": 100,
        "stage1ProblemCount": 1,
        "stage1ProblemRate": 100,
        "stage2ProblemCount": 1,
        "stage2ProblemRate": 100,
        "stage3ProblemCount": 0,
        "stage3ProblemRate": 0,
        "problemCount": 2,
        "problemRate": 200,
        "zxrStats": [
          {
            "pjozxr": "cyTZZMgy3WliwVfM3LT",
            "pjozxrName": "周雪",
            "totalCount": 1,
            "executedCount": 1,
            "execRate": 100,
            "stage1ProblemCount": 1,
            "stage1ProblemRate": 100,
            "stage2ProblemCount": 1,
            "stage2ProblemRate": 100,
            "stage3ProblemCount": 0,
            "stage3ProblemRate": 0,
            "problemCount": 2,
            "problemRate": 200
          }
        ]
      }
    ]
  }
}


5.2 根据条件查询人员PJO计划明细列表

接口路径： GET /pjoExec/list/detail

接口说明： 按 PJO 开展日期（qkxdwk）范围查询人员 PJO 计划执行明细记录，可再按车间单位id、人员id（PJO 执行人）过滤，并补充关联实体名称/编号、枚举中文描述及各阶段问题标记。所有参数均非必填；开始时间为空时默认使用当前月 1 号，结束时间为空时默认使用当前日期前一天。结果按 PJO 开展日期降序排列。

请求参数：


参数名
类型
必传
说明


startTime
String
否
开始时间，格式：yyyy-MM-dd [HHss]，为空默认当前月 1 号 00:00:00


endTime
String
否
结束时间，格式：yyyy-MM-dd [HHss]，为空默认当前日期前一天 23:59:59


cj
String
否
车间单位id


pjozxr
String
否
人员id（PJO 执行人-组织用户）


响应数据： List<PjoExecDetailDTO>

响应字段说明：


字段
类型
说明


id
String
记录ID


createdAt
Date
创建时间（yyyy-MM-dd HHss）


qkxdwk
Date
PJO开展日期（yyyy-MM-dd HHss）


drscbc
String
当日生产班次id


pjozxr
String
PJO执行人id（组织用户）


pjozxrName
String
PJO执行人姓名


pjogcrxm
String
PJO观察人姓名


pjopc
String
PJO批次id


pjopcName
String
PJO批次名称


pjopcCode
String
PJO批次编号


gwxz
String
岗位性质编号（#1#-A类;#2#-B类;#3#-C类）


gwxzDesc
String
岗位性质名称


gwzx1
String
工位1-PJO工位执行情况记录id


gwzx1Name
String
工位1名称


gwzx1Code
String
工位1编号


gwzx2
String
工位2-PJO工位执行情况记录id


gwzx2Name
String
工位2名称


gwzx2Code
String
工位2编号


pjosfzckz
Boolean
PJO是否正常开展


gchtxzyyc
String
观察和填写主要异常


gchtxcyyc
String
观察和填写次要异常


gcdwt
String
观察的问题（第一阶段问题来源）


gcgjjh
String
观测改进机会


lfwkuc
String
观察的改善点描述（第二阶段问题来源）


zyczdwt
String
组员存在的问题编号（第三阶段问题来源，#1#-无）


zyczdwtDesc
String
组员存在的问题名称


zdbgwdgsjy
String
针对本工位的改善建议


lvqwyc
String
三个动作


zysfyjy
Boolean
组员是否有建议


cyjy
String
成员建议&意见处理人员id（组织用户）


cyjyName
String
成员建议&意见处理人员姓名


zyjy
String
组员建议&意见处理方案


zt
String
状态编号（#1#-待执行;#2#-执行中;#3#-已执行;#4#-已关闭）


ztDesc
String
状态名称


stage1Problem
Boolean
第一阶段是否发现问题（gcdwt 有值）


stage2Problem
Boolean
第二阶段是否发现问题（lfwkuc 有值）


stage3Problem
Boolean
第三阶段是否发现问题（zyczdwt 有值且非 #1#-无）


problemCount
Integer
该记录发现问题总数（三阶段合计，0~3）


cj
String
车间id


cjName
String
车间名称


cjCode
String
车间编号


qy
String
区域id


qyName
String
区域名称


qyCode
String
区域编号


bz
String
班组id


bzName
String
班组名称


bzCode
String
班组编号


xt
String
线体id


xtName
String
线体名称


xtCode
String
线体编号


响应示例：

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "53DfARB8Lllis48Qc5S",
      "createdAt": null,
      "qkxdwk": "2026-09-14 16:00:00",
      "drscbc": "04XZ79FFFNlMQvVRbNC",
      "pjozxr": "jU1pkX6iMiZjUPP19MP",
      "pjozxrName": "陈工",
      "pjogcrxm": "17",
      "pjopc": "Rx9pcihofirkRXKwp7U",
      "pjopcName": "1111",
      "pjopcCode": "103",
      "gwxz": "#1#",
      "gwxzDesc": "A类",
      "gwzx1": "sWIvFIxMCEIBPQe1vnp",
      "gwzx1Name": "PT-17",
      "gwzx1Code": "PT-17",
      "gwzx2": null,
      "gwzx2Name": null,
      "gwzx2Code": null,
      "pjosfzckz": true,
      "gchtxzyyc": "#5#",
      "gchtxcyyc": "#6#",
      "gcdwt": null,
      "gcgjjh": null,
      "lfwkuc": null,
      "zyczdwt": null,
      "zyczdwtDesc": null,
      "zdbgwdgsjy": null,
      "lvqwyc": "#3#",
      "zysfyjy": true,
      "cyjy": "jU1pkX6iMiZjUPP19MP",
      "cyjyName": "陈工",
      "zyjy": "12345788342",
      "zt": "#3#",
      "ztDesc": "已执行",
      "stage1Problem": false,
      "stage2Problem": false,
      "stage3Problem": false,
      "problemCount": 0,
      "cj": "ahImSLxXBuQkFtU8Ace",
      "cjName": "总装车间",
      "cjCode": "104",
      "qy": "fmGDmYdCswHy1AfNO7R",
      "qyName": "底盘分装",
      "qyCode": "51",
      "bz": "GQ8wL2PXGUutYA7HKks",
      "bzName": "发动机分装班",
      "bzCode": "142",
      "xt": "6J4vk1uvwmoj6e3AL2G",
      "xtName": "B线",
      "xtCode": "B"
    },
    {
      "id": "GqsLUmb6KPFbksGLCMy",
      "createdAt": null,
      "qkxdwk": "2026-09-10 16:00:00",
      "drscbc": "2wuZLNVlL697coAgZd9",
      "pjozxr": "jU1pkX6iMiZjUPP19MP",
      "pjozxrName": "陈工",
      "pjogcrxm": null,
      "pjopc": "Rx9pcihofirkRXKwp7U",
      "pjopcName": "1111",
      "pjopcCode": "103",
      "gwxz": "#1#",
      "gwxzDesc": "A类",
      "gwzx1": "qvyrMf6zeRTtOk20Oug",
      "gwzx1Name": "PT-18-FZ-02",
      "gwzx1Code": "PT-18-FZ-02",
      "gwzx2": null,
      "gwzx2Name": null,
      "gwzx2Code": null,
      "pjosfzckz": true,
      "gchtxzyyc": "#2#",
      "gchtxcyyc": "#2#",
      "gcdwt": null,
      "gcgjjh": null,
      "lfwkuc": null,
      "zyczdwt": null,
      "zyczdwtDesc": null,
      "zdbgwdgsjy": null,
      "lvqwyc": null,
      "zysfyjy": true,
      "cyjy": "cyTZZMgy3WliwVfM3LT",
      "cyjyName": "周雪",
      "zyjy": null,
      "zt": "#2#",
      "ztDesc": "执行中",
      "stage1Problem": false,
      "stage2Problem": false,
      "stage3Problem": false,
      "problemCount": 0,
      "cj": "ahImSLxXBuQkFtU8Ace",
      "cjName": "总装车间",
      "cjCode": "104",
      "qy": "fmGDmYdCswHy1AfNO7R",
      "qyName": "底盘分装",
      "qyCode": "51",
      "bz": "GQ8wL2PXGUutYA7HKks",
      "bzName": "发动机分装班",
      "bzCode": "142",
      "xt": null,
      "xtName": null,
      "xtCode": null
    }
  ]
}


6. 枚举定义接口


6.1 获取所有枚举定义常量数组信息

接口路径： GET /enum/list/all

接口说明： 统一返回项目中定义的所有业务枚举的常量数组信息，供前端下拉框、状态映射等场景使用。每个枚举返回枚举类名、业务标识、中文说明以及其全部常量项（常量名 + 编号 + 描述）。

请求参数： 无

响应数据： List<EnumDefinitionDTO>

响应字段说明：


字段
类型
说明


enumName
String
枚举类名，如 RylbEnum


enumKey
String
业务标识，如 rylb


description
String
枚举中文说明，如 人员类别


items
Array
枚举常量项数组


items[].name
String
枚举常量名，如 QIYONG


items[].code
String
常量编号，如 #2#


items[].desc
String
常量描述，如 启用


响应示例：

{
  "success": true,
  "data": [
    {
      "enumName": "RylbEnum",
      "enumKey": "rylb",
      "description": "人员类别",
      "items": [
        { "name": "QUZHANG", "code": "#1#", "desc": "区长" },
        { "name": "BANZHANG", "code": "#2#", "desc": "班长" },
        { "name": "YIBANYUANGONG", "code": "#7#", "desc": "一般员工" }
      ]
    },
    {
      "enumName": "DataStatusEnum",
      "enumKey": "dataStatus",
      "description": "数据状态",
      "items": [
        { "name": "CAOGAO", "code": "#1#", "desc": "草稿" },
        { "name": "QIYONG", "code": "#2#", "desc": "启用" },
        { "name": "TINGYONG", "code": "#3#", "desc": "停用" }
      ]
    },
    {
      "enumName": "GcqrZtEnum",
      "enumKey": "gcqrZt",
      "description": "过程确认状态",
      "items": [
        { "name": "DAIQUEREN", "code": "#1#", "desc": "待确认" },
        { "name": "WEIZHIXING", "code": "#2#", "desc": "未执行" },
        { "name": "YIZHIXING", "code": "#3#", "desc": "已执行" },
        { "name": "YIYUQI", "code": "#4#", "desc": "已逾期" }
      ]
    }
  ],
  "msg": "成功",
  "errCode": null
}


说明：示例仅列出部分枚举，实际返回包含项目中定义的全部枚举（人员类别、过程确认状态、未执行原因、数据状态、车间状态、C类改善状态、PJO执行状态、岗位性质、PJO工位状态、季度、问题层级、6S分类、问题处理方式、问题处理状态、问题类别、问题来源、问题性质、组员存在的问题等）。


7. 基础信息接口


本章节接口均返回对应实体中「状态为启用（#2#）」的数据记录列表。所有实体均继承基础字段：id（记录ID）、corpCode（企业编码）、createdAt（创建时间）、createdBy（创建人）、updatedAt（更新时间）、updatedBy（更新人）。


7.1 获取所有启用的线体列表

接口路径： GET /xtLine/list/enabled

接口说明： 获取所有启用状态（amoigs = #2#）的线体信息列表。

请求参数： 无

响应数据： List<XtLine>

响应字段说明：


字段
类型
说明


id
String
记录ID


xtmc
String
线体名称


xtbh
String
线体编号


xtfzr
String
线体负责人


amoigs
String
状态编号（#1#-草稿;#2#-启用;#3#-停用）


响应示例：

{
  "success": true,
  "data": [
    {
      "id": "6J4vk1uvwmoj6e3AL2G",
      "corpCode": "qgutech",
      "xtmc": "B线",
      "xtbh": "B",
      "xtfzr": "jU1pkX6iMiZjUPP19MP",
      "amoigs": "#2#",
      "createdAt": "2026-09-10 10:00:00",
      "updatedAt": null
    }
  ],
  "msg": "成功",
  "errCode": null
}


7.2 获取所有启用的单位（车间）列表

接口路径： GET /workshop/list/enabled

接口说明： 获取所有启用状态（ieiblp = #2#）的单位（车间）信息列表。

请求参数： 无

响应数据： List<Workshop>

响应字段说明：


字段
类型
说明


id
String
记录ID


dwmc
String
单位名称


dwbh
String
单位编号


ssxt
String
所属线体id


dwfzr
String
单位负责人


sszz
String
所属组织


ieiblp
String
状态编号（#1#-草稿;#2#-启用;#3#-停用）


statusDesc
String
状态中文描述（非数据库字段）


响应示例：

{
  "success": true,
  "data": [
    {
      "id": "ahImSLxXBuQkFtU8Ace",
      "corpCode": "qgutech",
      "dwmc": "总装车间",
      "dwbh": "104",
      "ssxt": "6J4vk1uvwmoj6e3AL2G",
      "dwfzr": "jU1pkX6iMiZjUPP19MP",
      "sszz": "orgXXX",
      "ieiblp": "#2#",
      "statusDesc": "启用",
      "createdAt": "2026-09-10 10:00:00",
      "updatedAt": null
    }
  ],
  "msg": "成功",
  "errCode": null
}


7.3 获取所有启用的室组列表

接口路径： GET /roomGroup/list/enabled

接口说明： 获取所有启用状态（zt = #2#）的室组信息列表。

请求参数： 无

响应数据： List<RoomGroup>

响应字段说明：


字段
类型
说明


id
String
记录ID


szmc
String
室组名称


szbh
String
室组编号


szfzr
String
室组负责人


ssdw
String
所属单位（车间）id


sszz
String
所属组织


zt
String
状态编号（#1#-草稿;#2#-启用;#3#-停用）


响应示例：

{
  "success": true,
  "data": [
    {
      "id": "rgXXX",
      "corpCode": "qgutech",
      "szmc": "总装室",
      "szbh": "201",
      "szfzr": "jU1pkX6iMiZjUPP19MP",
      "ssdw": "ahImSLxXBuQkFtU8Ace",
      "sszz": "orgXXX",
      "zt": "#2#",
      "createdAt": "2026-09-10 10:00:00",
      "updatedAt": null
    }
  ],
  "msg": "成功",
  "errCode": null
}


7.4 获取所有启用的区域列表

接口路径： GET /area/list/enabled

接口说明： 获取所有启用状态（zt = #2#）的区域信息列表。

请求参数： 无

响应数据： List<Area>

响应字段说明：


字段
类型
说明


id
String
记录ID


qymc
String
区域名称


qybh
String
区域编号


qyfzr
String
区域负责人


sscj
String
所属车间id


sssz
String
所属室组id


sszz
String
所属组织


zt
String
状态编号（#1#-草稿;#2#-启用;#3#-停用）


响应示例：

{
  "success": true,
  "data": [
    {
      "id": "fmGDmYdCswHy1AfNO7R",
      "corpCode": "qgutech",
      "qymc": "底盘分装",
      "qybh": "51",
      "qyfzr": "jU1pkX6iMiZjUPP19MP",
      "sscj": "ahImSLxXBuQkFtU8Ace",
      "sssz": "rgXXX",
      "sszz": "orgXXX",
      "zt": "#2#",
      "createdAt": "2026-09-10 10:00:00",
      "updatedAt": null
    }
  ],
  "msg": "成功",
  "errCode": null
}


7.5 获取所有启用的班组列表

接口路径： GET /team/list/enabled

接口说明： 获取所有启用状态（zt = #2#）的班组信息列表。

请求参数： 无

响应数据： List<Team>

响应字段说明：


字段
类型
说明


id
String
记录ID


bzmc
String
班组名称


bzbh
String
班组编号


bzfzr
String
班组负责人


ssqy
String
所属区域id


bc
String
班次id


iytfgx
String
是否同步工序


bzcy
String
班组成员


sszz
String
所属组织


zt
String
状态编号（#1#-草稿;#2#-启用;#3#-停用）


响应示例：

{
  "success": true,
  "data": [
    {
      "id": "GQ8wL2PXGUutYA7HKks",
      "corpCode": "qgutech",
      "bzmc": "发动机分装班",
      "bzbh": "142",
      "bzfzr": "jU1pkX6iMiZjUPP19MP",
      "ssqy": "fmGDmYdCswHy1AfNO7R",
      "bc": "04XZ79FFFNlMQvVRbNC",
      "iytfgx": null,
      "bzcy": "jU1pkX6iMiZjUPP19MP",
      "sszz": "orgXXX",
      "zt": "#2#",
      "createdAt": "2026-09-10 10:00:00",
      "updatedAt": null
    }
  ],
  "msg": "成功",
  "errCode": null
}


7.6 获取所有启用的班次列表

接口路径： GET /shift/list/enabled

接口说明： 获取所有启用状态（zt = #2#）的班次信息列表。

请求参数： 无

响应数据： List<Shift>

响应字段说明：


字段
类型
说明


id
String
记录ID


bcmc
String
班次名称


bcbh
String
班次编号


bclx
String
班次类型


zt
String
状态编号（#1#-草稿;#2#-启用;#3#-停用）


响应示例：

{
  "success": true,
  "data": [
    {
      "id": "04XZ79FFFNlMQvVRbNC",
      "corpCode": "qgutech",
      "bcmc": "白班",
      "bcbh": "1",
      "bclx": "正常班",
      "zt": "#2#",
      "createdAt": "2026-09-10 10:00:00",
      "updatedAt": null
    }
  ],
  "msg": "成功",
  "errCode": null
}