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

CPS 模块接口 API 说明文档

目录


变更记录

标记说明:🆕 新增接口(本次新增的接口)| ✏️ 接口更新(接口路径不变,统计维度/出入参发生调整)

标记 章节 接口路径 变更类型 变更说明
🆕 1.3 GET /abImprovement/summary/dept 新增接口 以单位 + 年份为入参,查询该年度时间范围内该单位下的记录,按申请部门分组汇总 AB 类改善,含部门目标值与完成率
✏️ 2.2 GET /cImprovement/summary/quarter 接口更新 统计维度由「室组」调整为「单位车间」(按季度人员所在单位 shdw 分组),目标值改按单位车间 dwcj 匹配,返回字段以 dwcj/dwcjName/dwcjCode 为主
🆕 2.3 GET /cImprovement/summary/workshop 新增接口 按单位 + 季度查询,统计指定单位车间下各室组的 C 类改善发起率(即原 2.2 的室组维度逻辑,目标值按室组 szxx 匹配)
🆕 3.6 GET /cpsProblem/list/detail/condition 新增接口 按年份(为空默认当前年)、月份(1-12,为空默认当前月,按创建时间过滤)、区域 qy、处理状态筛选问题记录明细;线体、单位、班次无对应字段不作为条件
🆕 4.4 GET /processConfirmExec/list/problem 新增接口 入参同 4.3 但去掉状态 zt,返回这些执行记录来源发现的 CPS 问题记录明细
🆕 5.3 GET /pjoExec/list/detail/currentWeek 新增接口 按区域(qy,可选)查询当前时间所在周(周一~周日)的 PJO 执行记录明细,出参结构同 5.2
🆕 8.1 GET /stopRecord/list/all 新增接口 获取当前企业下所有停线记录信息列表
✏️ 8.2 `GET /stopRecord/summary/daily/{logistics\ equipment\ quality\
✏️ 8.3 `GET /stopRecord/summary/workstation/{logistics\ equipment\ quality\
✏️ 8.4 `GET /stopRecord/list/detail/{logistics\ equipment\ quality\
🆕 9.1 GET /processConfirmTeamPlan/list/currentWeek 新增接口 按区域(qyxx,可选)查询当前时间所在周(周一~周日)的过程确认班组计划明细,关联计划走访班组、工位的编号与名称

编号调整说明:因 2.3 新增了「按单位车间查室组」接口,原「2.3 根据年份、季度、室组id查询C类改善记录详情」顺延为 2.4(接口路径与内容未变)。


通用说明

环境域名

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 HH:mm:ss)
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
    }
  ]
}

1.3 根据单位和年份查询AB类改善部门汇总

🆕 新增接口(本次变更)

接口路径: GET /abImprovement/summary/dept

接口说明: 查询指定年份时间范围内、指定单位下的所有AB类改善记录,按申请部门分组汇总,包含各部门节约价值汇总、部门目标值及完成率。

请求参数:

参数名 类型 必传 说明
dwxx String 是 单位(组织架构ID)
year String 否 年份,格式:yyyy,为空时默认当前年

响应数据: List<AbImprovementDeptSummaryDTO>

响应字段说明:

字段 类型 说明
dwxx String 单位(组织架构ID)
dwxxName String 单位名称
sqbm String 申请部门(组织架构ID)
sqbmName String 申请部门名称
sqbmCode String 申请部门编号
year String 年份
totalQnjyjz Double 节约价值汇总
mb Double 目标值
completionRate Double 完成率(%)

响应示例:

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "dwxx": "org001",
      "dwxxName": "总装厂",
      "sqbm": "dept001",
      "sqbmName": "生产部",
      "sqbmCode": "SC001",
      "year": "2026",
      "totalQnjyjz": 80000.0,
      "mb": 100000.0,
      "completionRate": 80.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,
  "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类改善发起率汇总

✏️ 接口更新(本次变更):统计维度由「室组」调整为「单位车间」(按季度人员所在单位 shdw 分组),目标值改按单位车间 dwcj 匹配;接口路径与入参不变。原「室组维度」统计已拆分为新接口 2.3。

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

接口说明: 按单位车间维度统计指定年份季度的C类改善发起率,包含单位车间总人数、有改善记录人数、发起率及目标值(目标值按单位车间匹配)。

请求参数:

参数名 类型 必传 说明
year String 否 年份,格式:yyyy,为空时默认当前年
quarter String 是 季度枚举值(#1#-#4#)

响应数据: List<CImprovementSummaryDTO>

响应字段说明:

字段 类型 说明
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": [
    {
      "dwcj": "workshop001",
      "dwcjName": "总装车间",
      "dwcjCode": "ZZ001",
      "year": "2026",
      "quarter": "#3#",
      "quarterDesc": "第三季度",
      "totalPersonnel": 50,
      "improvementPersonnel": 35,
      "improvementRate": 70.0,
      "mb": 80.0
    }
  ]
}

2.3 根据年份、季度和单位车间查询C类改善发起率汇总

🆕 新增接口(本次变更):承接原 2.2 的「室组维度」统计逻辑,作用域限定为指定单位车间下的各室组。

接口路径: GET /cImprovement/summary/workshop

接口说明: 按室组维度统计指定单位车间下各室组在指定年份季度的C类改善发起率,包含室组总人数、有改善记录人数、发起率及目标值(目标值按室组匹配)。

请求参数:

参数名 类型 必传 说明
year String 否 年份,格式:yyyy,为空时默认当前年
quarter String 是 季度枚举值(#1#-#4#)
dwcj String 是 单位车间id

响应数据: 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": 20,
      "improvementPersonnel": 15,
      "improvementRate": 75.0,
      "mb": 30.0
    }
  ]
}

2.4 根据年份、季度、室组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,
  "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 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,
  "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 [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,
  "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 [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,
  "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 [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,
  "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 [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,
  "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.6 根据年月、区域、状态查询问题记录明细 🆕新增

🆕 新增接口(本次变更):所有条件均可为空,月份(1-12)未传默认当前月、年份未传默认当前年(按创建时间过滤),返回问题记录明细。

接口路径: GET /cpsProblem/list/detail/condition

接口说明: 按年月、区域、处理状态筛选问题记录明细(含关联实体名称与枚举中文描述),结果按创建时间降序。所有参数均非必填;year 为空时默认当前年,month(1-12)为空时默认当前月,按创建时间(createdAt)在该年月范围内过滤。线体、单位、班次在问题记录属性中无对应字段,故不作为查询条件。

请求参数:

参数名 类型 必传 说明
year Integer 否 年份(如 2026),为空默认当前年
month Integer 否 月份(1-12,分别代表 1~12 月),为空默认当前月;按创建时间范围过滤
qy String 否 区域id,为空则不限定
status String 否 问题处理状态编号(#1#-待处理;#2#-处理中;#3#-已关闭;#4#-已逾期),兼容传入 1~4 短形式,为空则不限定

响应数据: List<CpsProblemDetailDTO>

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

响应示例:

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "p123",
      "createdAt": "2026-10-05 09:00:00",
      "wtbh": "WT202610001",
      "wtms": "装配线设备故障",
      "qy": "area001",
      "qyName": "装配区域",
      "qyCode": "QY001",
      "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,
  "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 [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,
  "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 [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,
  "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"
    }
  ]
}

4.4 根据条件查询过程确认执行记录对应的问题记录明细列表

🆕 新增接口(本次变更):参照 4.3,入参相同但去掉状态 zt,返回执行记录来源发现的 CPS 问题记录明细。

接口路径: GET /processConfirmExec/list/problem

接口说明: 入参与 4.3 相同但去掉状态(zt)参数。先按活动执行日期范围、单位、人员类别过滤过程确认执行记录,再返回这些执行记录来源发现的 CPS 问题记录明细(含关联实体名称与枚举中文描述)。所有参数均非必填;开始时间为空时默认使用当前月 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)

响应数据: List<CpsProblemDetailDTO>(字段说明参见 3.4 CPS问题记录明细,按创建时间降序)

响应示例:

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "p8IaDbP2C79yQsAY6Vv",
      "createdAt": "2026-09-11 09:20:00",
      "wtbh": "WT20260911001",
      "wtms": "设备异常停机",
      "wtly": "#3#",
      "wtlyDesc": "过程确认",
      "gzdw": "ahImSLxXBuQkFtU8Ace",
      "gzdwName": "总装车间",
      "gzdwCode": "104",
      "wtzrdw": "ahImSLxXBuQkFtU8Ace",
      "wtzrdwName": "总装车间",
      "wtzrdwCode": "104",
      "wtclzt": "#1#",
      "wtclztDesc": "待处理"
    }
  ]
}

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,
  "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 [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,
  "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
    }
  ]
}

5.3 查询区域内当前周PJO执行记录明细列表

🆕 新增接口(本次变更)

接口路径: GET /pjoExec/list/detail/currentWeek

接口说明: 以当前时间所在自然周为准(周一为一周起始),查询 PJO 开展日期(qkxdwk)落在本周 周一 00:00:00.000 ~ 周日 23:59:59.999 范围内的 PJO 执行记录明细,可按区域过滤,并补充关联实体名称/编号、枚举中文描述及各阶段问题标记。区域为空时不限定区域;结果按 PJO 开展日期降序排列。

请求参数:

参数名 类型 必传 说明
qy String 否 区域id,为空时不限定区域

响应数据: List<PjoExecDetailDTO>

响应字段与 5.2 完全一致,此处不再重复。

响应示例:

{
  "success": true,
  "msg": "成功",
  "data": [
    {
      "id": "53DfARB8Lllis48Qc5S",
      "qkxdwk": "2026-10-07 08:00:00",
      "pjozxr": "jU1pkX6iMiZjUPP19MP",
      "pjozxrName": "陈工",
      "zt": "#3#",
      "ztDesc": "已执行",
      "problemCount": 0,
      "cjName": "总装车间",
      "cjCode": "104",
      "qy": "fmGDmYdCswHy1AfNO7R",
      "qyName": "底盘分装",
      "qyCode": "51",
      "bzName": "发动机分装班",
      "bzCode": "142",
      "xtName": "B线",
      "xtCode": "B"
    }
  ]
}

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
}

8. 停线记录接口

8.1 获取所有停线记录列表 🆕新增

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

接口说明: 获取当前企业下所有停线记录信息列表。

请求参数: 无

响应数据: List<StopRecord>

响应字段说明:

字段 类型 说明
id String 记录ID
cyxx String 成员信息
xtxx String 线体信息
bcxx String 班次信息
txqyxx String 停线区域信息
txbzxx String 停线班组信息
txgwxx String 停线工位信息
gwxz String 工位性质
startTime String 停线开始时间(yyyy-MM-dd HH:mm:ss)
endTime String 停线结束时间(yyyy-MM-dd HH:mm:ss)
txsc Double 停线时长(分钟)
txbkxx String 停线板块信息
txflxx String 停线分类信息
txms String 停线描述

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "SR20260901001",
      "corpCode": "qgutech",
      "xtxx": "XT001",
      "bcxx": "BC001",
      "txqyxx": "QY001",
      "txgwxx": "GW001",
      "startTime": "2026-09-01 08:30:00",
      "endTime": "2026-09-01 09:00:00",
      "txsc": 30.0,
      "txbkxx": "BK001"
    }
  ],
  "msg": "成功",
  "errCode": null
}

8.2 按月份按天汇总停线时长(按板块拆分) ✏️更新

✏️ 接口更新(本次变更:原单一 GET /stopRecord/summary/daily 按停线板块拆分为物流(W)/设备(M)/质量(Q)/其他 四个独立接口;板块不再作为入参,改由接口路径固定;year/month 改为可选,默认当前年/当前月;汇总结果新增板块信息字段)

接口路径: 四个板块各对应一个端点,其余入参、出参结构完全一致:

板块 板块编码 接口路径
物流 W GET /stopRecord/summary/daily/logistics
设备 M GET /stopRecord/summary/daily/equipment
质量 Q GET /stopRecord/summary/daily/quality
其他(非 W/M/Q) — GET /stopRecord/summary/daily/other

接口说明: 后端先根据板块编码(W/M/Q)定位板块信息 Id,再根据线体、班次、区域条件筛选指定年月范围内的停线记录,按天分组汇总每天的停线时长与记录数,结果按日期升序排列。「其他」端点筛选板块不属于物流/设备/质量三者的记录(含板块为空的记录)。year/month 为空时默认取当前年/当前月。

请求参数:

参数名 类型 必传 说明
xtxx String 否 线体信息(线体id),为空则不限定
bcxx String 否 班次信息(班次id),为空则不限定
txqyxx String 否 停线区域信息(区域id),为空则不限定
year Integer 否 年份,如 2026;为空时默认当前年
month Integer 否 月份(1-12);为空时默认当前月

响应数据: List<StopRecordDailySummaryDTO>

响应字段说明:

字段 类型 说明
date String 日期(yyyy-MM-dd)
totalTxsc Double 当日停线时长总计(分钟),单条记录 txsc 为 null 时按 0 计
totalCount Integer 当日停线记录数
bkbm String 板块编码(物流 W / 设备 M / 质量 Q;「其他」端点为 null)
bkmc String 板块名称(「其他」端点为 null)

响应示例(物流端点 /summary/daily/logistics):

{
  "success": true,
  "data": [
    {
      "date": "2026-09-01",
      "totalTxsc": 120.5,
      "totalCount": 3,
      "bkbm": "W",
      "bkmc": "物流"
    },
    {
      "date": "2026-09-02",
      "totalTxsc": 60.0,
      "totalCount": 1,
      "bkbm": "W",
      "bkmc": "物流"
    }
  ],
  "msg": "成功",
  "errCode": null
}

8.3 按工位汇总停线时长(按板块拆分) ✏️更新

✏️ 接口更新(本次变更:原单一 GET /stopRecord/summary/workstation 按停线板块拆分为物流(W)/设备(M)/质量(Q)/其他 四个独立接口;板块不再作为入参,改由接口路径固定;汇总结果新增板块信息字段)

接口路径: 四个板块各对应一个端点,其余入参、出参结构完全一致:

板块 板块编码 接口路径
物流 W GET /stopRecord/summary/workstation/logistics
设备 M GET /stopRecord/summary/workstation/equipment
质量 Q GET /stopRecord/summary/workstation/quality
其他(非 W/M/Q) — GET /stopRecord/summary/workstation/other

接口说明: 后端先根据板块编码定位板块信息 Id,再在线体、班次、区域条件基础上加上指定日期,按工位汇总停线时长(关联停线工位信息补充工位名称与编号),汇总结果按停线时长降序排列。date 为空时不限定日期。「其他」端点筛选板块不属于物流/设备/质量三者的记录。仅返回汇总结果,不含停线记录明细(明细查询见 8.4)。

请求参数:

参数名 类型 必传 说明
xtxx String 否 线体信息(线体id),为空则不限定
bcxx String 否 班次信息(班次id),为空则不限定
txqyxx String 否 停线区域信息(区域id),为空则不限定
date String 否 指定日期,格式:yyyy-MM-dd,为空时不限定日期

响应数据: List<StopRecordWorkstationSummaryDTO>

响应字段说明:

字段 类型 说明
txgwxx String 工位id
gwmc String 工位名称(关联停线工位信息)
gwbh String 工位编号(关联停线工位信息)
totalTxsc Double 该工位停线时长总计(分钟)
totalCount Integer 该工位停线记录数
bkbm String 板块编码(物流 W / 设备 M / 质量 Q;「其他」端点为 null)
bkmc String 板块名称(「其他」端点为 null)

响应示例(物流端点 /summary/workstation/logistics):

{
  "success": true,
  "data": [
    {
      "txgwxx": "GW001",
      "gwmc": "焊接工位",
      "gwbh": "01",
      "totalTxsc": 90.0,
      "totalCount": 1,
      "bkbm": "W",
      "bkmc": "物流"
    },
    {
      "txgwxx": "GW002",
      "gwmc": "装配工位",
      "gwbh": "02",
      "totalTxsc": 30.0,
      "totalCount": 1,
      "bkbm": "W",
      "bkmc": "物流"
    }
  ],
  "msg": "成功",
  "errCode": null
}

8.4 查询停线记录明细列表(按板块拆分) ✏️更新

✏️ 接口更新(本次变更:原单一 GET /stopRecord/list/detail 按停线板块拆分为物流(W)/设备(M)/质量(Q)/其他 四个独立接口;板块不再作为入参,改由接口路径固定)

接口路径: 四个板块各对应一个端点,其余入参、出参结构完全一致:

板块 板块编码 接口路径
物流 W GET /stopRecord/list/detail/logistics
设备 M GET /stopRecord/list/detail/equipment
质量 Q GET /stopRecord/list/detail/quality
其他(非 W/M/Q) — GET /stopRecord/list/detail/other

接口说明: 后端先根据板块编码定位板块信息 Id,再根据线体、班次、区域、工位条件及指定日期筛选停线记录,返回停线记录明细列表。「其他」端点筛选板块不属于物流/设备/质量三者的记录。除板块外的参数均为可选,date 为空时不限定日期。

请求参数:

参数名 类型 必传 说明
xtxx String 否 线体信息(线体id),为空则不限定
bcxx String 否 班次信息(班次id),为空则不限定
txqyxx String 否 停线区域信息(区域id),为空则不限定
txgwxx String 否 停线工位信息(工位id),为空则不限定
date String 否 指定日期,格式:yyyy-MM-dd,为空时不限定日期

响应数据: List<StopRecord>(结构同 8.1 的 StopRecord)

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "SR20260901001",
      "xtxx": "XT001",
      "bcxx": "BC001",
      "txqyxx": "QY001",
      "txgwxx": "GW001",
      "startTime": "2026-09-01 08:30:00",
      "endTime": "2026-09-01 10:00:00",
      "txsc": 90.0,
      "txbkxx": "BK001"
    }
  ],
  "msg": "成功",
  "errCode": null
}

9. 过程确认班组计划接口

9.1 按区域查询当前周过程确认班组计划明细列表 🆕新增

🆕 新增接口(本次变更):按区域查询当前时间所在周(周一至周日)的过程确认班组计划明细,关联计划走访班组、工位的编号与名称。

接口路径: GET /processConfirmTeamPlan/list/currentWeek

接口说明: 以当前时间所在自然周为准,查询计划日期(jhrq)在周一 00:00:00 ~ 周日 23:59:59 范围内的过程确认班组计划记录,关联计划走访班组(jhzfbz)、计划走访工位(jhzfgw)的编号与名称,结果按计划日期升序排列。qyxx 为空时不限定区域。

请求参数:

参数名 类型 必传 说明
qyxx String 否 区域信息(区域id),为空则不限定区域

响应数据: List<ProcessConfirmTeamPlanDetailDTO>

响应字段说明:

字段 类型 说明
id String 记录ID
createdAt String 创建时间(yyyy-MM-dd HH:mm:ss)
jhrq String 计划日期(yyyy-MM-dd HH:mm:ss)
zxr String 执行人
dwxx String 单位信息
xtxx String 线体信息
szxx String 室组信息
qyxx String 区域信息
zt String 状态(#1#-待确认;#2#-未执行;#3#-已执行;#4#-已逾期)
sffxwt Boolean 是否发现问题
bcxx String 班次信息
jhzfbz String 计划走访班组id
jhzfbzName String 计划走访班组名称
jhzfbzCode String 计划走访班组编号
jhzfgw String 计划走访工位id
jhzfgwName String 计划走访工位名称
jhzfgwCode String 计划走访工位编号

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "PCTP20261005001",
      "createdAt": "2026-10-05 08:00:00",
      "jhrq": "2026-10-06 00:00:00",
      "zxr": "user001",
      "dwxx": "workshop001",
      "xtxx": "XT001",
      "szxx": "rg001",
      "qyxx": "area001",
      "zt": "#1#",
      "sffxwt": false,
      "bcxx": "BC001",
      "jhzfbz": "team001",
      "jhzfbzName": "装配一班",
      "jhzfbzCode": "BZ001",
      "jhzfgw": "ws001",
      "jhzfgwName": "装配工位",
      "jhzfgwCode": "GW001"
    }
  ],
  "msg": "成功",
  "errCode": null
}