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

CPS 模块接口 API 说明文档

目录


通用说明

统一响应格式

所有接口返回统一的 JsonResult 结构:

{
  "success": true,
  "message": "成功",
  "data": []
}
字段 类型 说明
success Boolean 请求是否成功
message String 响应消息
data Object/Array 响应数据体

枚举值说明

季度枚举(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#-无 表示第三阶段未发现问题;其余任意非空值均表示第三阶段发现了一个问题。


1. AB类改善接口

1.1 获取所有AB类改善列表

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

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

请求参数: 无

响应数据: List<AbImprovement>

响应字段说明:

字段 类型 说明
id String 记录ID
createdAt Date 创建时间(yyyy-MM-dd HH:mm:ss)
lcslmc String 流程实例名称
dwcj String 单位车间id
sqr String 申请人
sqbm String 申请部门
sqrq Date 申请日期
lxr String 立项人
qnjyjz Double 全年节约价值
gslx String 改善类型
tdrs Double 团队人数

响应示例:

{
  "success": true,
  "message": "成功",
  "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,
  "message": "成功",
  "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 HH:mm:ss)
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,
  "message": "成功",
  "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,
  "message": "成功",
  "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 HH:mm:ss)
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,
  "message": "成功",
  "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 HH:mm:ss)
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,
  "message": "成功",
  "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 [HH:mm:ss],为空默认当前月1号 00:00:00
endTime String 否 结束时间,格式:yyyy-MM-dd [HH:mm:ss],为空默认当前月最后一天 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,
  "message": "成功",
  "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 [HH:mm:ss],为空默认当前月1号 00:00:00
endTime String 否 结束时间,格式:yyyy-MM-dd [HH:mm:ss],为空默认当前月最后一天 23:59:59
wtzrdwId String 是 责任单位id
status String 是 问题处理状态编号(#1#-待处理;#2#-处理中;#3#-已关闭;#4#-已逾期)

响应数据: List<CpsProblemDetailDTO>

响应字段说明:

字段 类型 说明
id String 记录ID
createdAt Date 创建时间(yyyy-MM-dd HH:mm:ss)
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 HH:mm:ss)
tntpvy Date 问题解决时间(yyyy-MM-dd HH:mm:ss)
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,
  "message": "成功",
  "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 [HH:mm:ss],为空默认当前月1号 00:00:00
endTime String 否 结束时间,格式:yyyy-MM-dd [HH:mm:ss],为空默认当前月最后一天 23:59:59

响应数据: List<CpsProblemSourceSummaryDTO>

响应字段说明:

字段 类型 说明
wtly String 问题来源编号
wtlyDesc String 问题来源中文名称
count Integer 该问题来源下的问题数

响应示例:

{
  "success": true,
  "message": "成功",
  "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 [HH:mm:ss],为空默认当前月1号 00:00:00
endTime String 否 结束时间,格式:yyyy-MM-dd [HH:mm:ss],为空默认当前月最后一天 23:59:59
wtly String 是 问题来源编号(#1#-开班;#2#-过程验证;#3#-过程确认;#4#-体系健康体检;#5#-单位自检)

响应数据: List<CpsProblemDetailDTO>

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

响应示例:

{
  "success": true,
  "message": "成功",
  "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 HH:mm:ss)
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,
  "message": "成功",
  "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 [HH:mm:ss],为空默认当前月 1 号 00:00:00
endTime String 否 结束时间,格式:yyyy-MM-dd [HH:mm:ss],为空默认当前日期前一天 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,
  "message": "成功",
  "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 [HH:mm:ss],为空默认当前月 1 号 00:00:00
endTime String 否 结束时间,格式:yyyy-MM-dd [HH:mm:ss],为空默认当前日期前一天 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 HH:mm:ss)
hdzxrq Date 活动执行日期(yyyy-MM-dd HH:mm:ss)
gqsj Date 过期时间(yyyy-MM-dd HH:mm:ss)
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,
  "message": "成功",
  "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 [HH:mm:ss],为空默认当前月 1 号 00:00:00
endTime String 否 结束时间,格式:yyyy-MM-dd [HH:mm:ss],为空默认当前日期前一天 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,
  "message": "成功",
  "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 [HH:mm:ss],为空默认当前月 1 号 00:00:00
endTime String 否 结束时间,格式:yyyy-MM-dd [HH:mm:ss],为空默认当前日期前一天 23:59:59
cj String 否 车间单位id
pjozxr String 否 人员id(PJO 执行人-组织用户)

响应数据: List<PjoExecDetailDTO>

响应字段说明:

字段 类型 说明
id String 记录ID
createdAt Date 创建时间(yyyy-MM-dd HH:mm:ss)
qkxdwk Date PJO开展日期(yyyy-MM-dd HH:mm:ss)
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,
  "message": "成功",
  "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
    }
  ]
}