IPO看板接口API说明文档.md 105 KB

IPO 看板接口 API 说明文档

本文档梳理 2026-10-06 之后新建的看板相关接口,涵盖 板块信息、停线工位、停线记录、过程确认班组计划、PJO 计划执行、CPS 问题、质量缺陷、车间级工作任务、公告信息、多能工信息 10 个控制器下的看板相关端点。文档格式与《CPS 模块接口 API 说明文档》保持一致。

目录


变更记录

标记说明:🆕 新增接口(2026-10-06 之后新建的接口) ✏️ 接口更新(路径/参数/响应结构变更)

标记 章节 接口路径 变更类型 变更说明
🆕 1.1 GET /blockInfo/list/all 新增接口 获取当前企业下所有板块信息列表
🆕 2.1 GET /stopWorkstation/list/all 新增接口 获取当前企业下所有停线工位信息列表;响应含 gwxzDesc 工位性质中文描述
🆕 3.1 GET /stopRecord/list/all 新增接口 获取当前企业下所有停线记录信息列表;响应含 5 个枚举中文描述计算字段
✏️ 3.2 GET /stopRecord/summary/daily/{logistics,equipment,quality,other} 接口更新 原 /stopRecord/summary/daily 按板块拆分为 4 个专用端点;txbkxx 入参移除,改由端点区分;year/month 由必传改为可选(默认当前年/月);响应新增 bkbm/bkmc;每日记录新增 mrmbVal 每日目标(按区域、板块、年月查区域停线时长月度目标表取目标值)
✏️ 3.3 GET /stopRecord/summary/workstation/{logistics,equipment,quality,other} 接口更新 原 /stopRecord/summary/workstation 按板块拆分为 4 个专用端点;txbkxx 入参移除;响应新增 bkbm/bkmc
✏️ 3.4 GET /stopRecord/list/detail/{logistics,equipment,quality,other} 接口更新 原 /stopRecord/list/detail 按板块拆分为 4 个专用端点;txbkxx 入参移除;响应新增线体/班次/区域/板块/工位/班组共 12 个关联名称与编号字段
🆕 4.1 GET /processConfirmTeamPlan/list/all 新增接口 获取当前企业下所有过程确认班组计划列表;响应含 ztDesc 状态中文描述
🆕 4.2 GET /processConfirmTeamPlan/list/currentWeek 新增接口 按区域(qyxx,可选)查询当前时间所在周(周一~周日)的过程确认班组计划明细,关联计划走访班组、工位的编号与名称
🆕 5.1 GET /pjoExec/list/detail/currentWeek 新增接口 按区域(qy,可选)查询当前时间所在周(周一~周日)的 PJO 执行记录明细,含关联实体名称/编号、枚举中文描述及各阶段问题标记
🆕 6.1 GET /cpsProblem/list/detail/condition 新增接口 按年份(默认当前年)、月份(1-12,默认当前月,按创建时间过滤)、区域 qy、处理状态筛选问题记录明细,含关联实体名称与枚举中文描述;线体/单位/班次无对应字段不作条件
🆕 7.1 GET /qualityDefect/list/all 新增接口 获取当前企业下所有质量缺陷信息列表;响应含 5 个枚举中文描述计算字段,及关联停线工位/班次/区域名称与编号、责任人员/创建人/更新人姓名
🆕 7.2 GET /qualityDefect/summary/daily 新增接口 按责任区域、年月(默认当前年月,按提出日期过滤)统计每日质量缺陷记录数,按日期升序
🆕 7.3 GET /qualityDefect/summary/workstation 新增接口 按指定日期、责任区域汇总各停线工位缺陷次数与月度重复次数合计,关联工位名称/编号/性质,按次数降序
🆕 7.4 GET /qualityDefect/list/detail 新增接口 按指定日期、责任区域、问题工位查询质量缺陷明细,含关联实体名称/编号、枚举中文描述及人员姓名
🆕 8.1 GET /workshopWorkTask/list/all 新增接口 获取当前企业下所有车间级工作任务列表;响应含任务状态中文描述及关联工作计划/区域名称、任务负责人/计划负责人/创建人/更新人姓名
🆕 8.2 GET /workshopWorkTask/list/detail 新增接口 按区域、年月(默认当前年月,按创建时间过滤)查询工作任务明细,含关联实体名称与人员姓名
🆕 8.3 GET /workshopWorkTask/summary/status 新增接口 按区域、年月(默认当前年月,按创建时间过滤)统计各任务状态记录条数,含状态中文描述
🆕 9.1 GET /announcement/list/all 新增接口 获取当前企业下所有公告信息列表;响应含公告类型 gglxDesc、状态 ztDesc 中文描述计算字段
🆕 9.2 GET /announcement/list/enabled 新增接口 按线体/车间/室组/区域条件(均可选)查询启用状态的特色公告;无归属信息的公告恒返回,某维度入参为空或与之相等即匹配;响应补全线体/车间/室组/区域名称与编号
🆕 10.1 GET /multiSkilledWorker/list/all 新增接口 获取当前企业下所有多能工信息列表;响应含等级 levelDesc 中文描述计算字段
🆕 10.2 GET /multiSkilledWorker/summary/area 新增接口 按区域(qyxx,必传)查询多能工记录并补全完整关联信息,同时对员工、工位分别去重汇总;一个接口返回员工列表、工位列表、员工工位等级信息列表
🆕 11.1 GET /areaScorecard/list/all 新增接口 获取当前企业下所有区域记分卡列表;响应含月份中文描述计算字段
✏️ 11.2 GET /areaScorecard/list/byMonth 接口更新 新增 year 参数,对 year 字段做范围查询(默认当前年);修复原 month 参数查询条件未生效的问题
🆕 12.1 GET /areaBlockIndicator/list/all 新增接口 获取当前企业下所有区域板块指标信息列表;响应含状态中文描述计算字段
🆕 13.1 GET /areaBlockIndicatorDaily/list/all 新增接口 获取当前企业下所有区域板块指标每日明细列表
✏️ 13.2 GET /areaBlockIndicatorDaily/list/{safety,quality,cost,deliver}KanbanDaily 接口更新 新增交付(D)板块专用端点 deliverKanbanDaily,端点由安全(S)/质量(Q)/成本(C)3 个扩展为 4 个;其余查询逻辑与响应结构不变
🆕 14.1 GET /areaEmployeeAttendance/list/all 新增接口 获取当前企业下所有区域员工考勤信息列表
🆕 15.1 GET /areaEmployeeAttendanceDetail/list/all 新增接口 获取当前企业下所有区域员工考勤明细列表;响应含职位/假别中文描述计算字段
🆕 15.2 GET /areaEmployeeAttendanceDetail/summary/daily 新增接口 按区域(qyxx,必传)、月份(1-12,必传)查询该月每日考勤汇总信息,含应到人数、实到人数
🆕 15.3 GET /areaEmployeeAttendanceDetail/list/nonAttendance 新增接口 按区域(qyxx,必传)、日期(yyyy-MM-dd,必传)查询当日非出勤考勤明细列表,含完整关联信息
🆕 16.1 GET /areaEmployee/list/all 新增接口 获取当前企业下所有区域员工信息列表
🆕 17.1 GET /areaEmployeeChange/list/all 新增接口 获取当前企业下所有区域员工变化明细列表
🆕 18.1 GET /areaEmployeeResignation/list/all 新增接口 获取当前企业下所有区域员工离职明细列表
🆕 19.1 GET /fiveSMap/list/all 新增接口 获取当前企业下所有5S责任图列表
🆕 19.2 GET /fiveSMap/list/area 新增接口 按区域(qyxx,必传)查询该区域下的5S责任图列表
🆕 20.1 GET /safetyObservation/list/all 新增接口 获取当前企业下所有安全观察与履职检查列表
🆕 20.2 GET /safetyObservation/summary/daily 新增接口 按区域(qyxx,可选)、月份(1-12,可选,默认当前月)汇总每日安全观察与履职检查信息;每日记录条数为走访工位数,抽查结果异常(ccjg=#2#)记录条数为问题数;缺记录日期自动补工位数、问题数均为0的记录
🆕 20.3 GET /safetyObservation/list/detail 新增接口 按区域(qyxx,可选)、检查日期(jcrq,必填)查询安全履职检查明细,补全区域/班组/观察工位名称与编号
🆕 21.1 GET /workshopWorkPlan/list/all 新增接口 获取当前企业下所有车间级工作计划列表

通用说明

环境域名

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

统一响应格式

所有接口返回统一的 JsonResult 结构(字段顺序以实际序列化为准):

{
  "success": true,
  "data": [],
  "msg": "成功",
  "errCode": null
}
字段 类型 说明
success Boolean 请求是否成功
data Object/Array 响应数据体
msg String 响应消息
errCode String 错误码,成功时为 null

多企业数据隔离

所有实体均继承 BaseCorpModel(含 corpCode,对应列 corp_code),响应中的每条记录都带有 corpCode。服务端统一按当前请求上下文的企业编码过滤数据,前端无需传入。


1. 板块信息接口

1.1 获取所有板块信息列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有板块信息列表。

请求参数: 无

响应数据: List<BlockInfo>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
mc String 板块名称
bm String 板块编码
xh String 序号
qtdw String 牵头单位
qtdwfzr String 牵头单位负责人

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "BK20260901001",
      "corpCode": "hfca",
      "mc": "总装板块",
      "bm": "BK001",
      "xh": "1",
      "qtdw": "总装车间",
      "qtdwfzr": "张三"
    }
  ],
  "msg": "成功",
  "errCode": null
}

2. 停线工位接口

2.1 获取所有停线工位信息列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有停线工位信息列表。停线工位用于停线时长汇总(见 3.3)时补充工位名称与编号。

请求参数: 无

响应数据: List<StopWorkstation>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
xtxx String 线体信息(线体id)
qyxx String 区域信息(区域id)
bzxx String 班组信息(班组id)
gwmc String 工位名称
gwbh String 工位编号
gwxz String 工位性质编号(#1#-主线;#2#-辅线)
gwxzDesc String 工位性质中文描述(计算字段)

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "GW20260901001",
      "corpCode": "hfca",
      "xtxx": "XT001",
      "qyxx": "QY001",
      "bzxx": "BZ001",
      "gwmc": "焊接工位",
      "gwbh": "01",
      "gwxz": "#1#",
      "gwxzDesc": "主线"
    }
  ],
  "msg": "成功",
  "errCode": null
}

3. 停线记录接口

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

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有停线记录信息列表。响应中除持久化字段外,还包含 5 个枚举字段中文描述(计算型 getter,所有返回该实体的接口均自动生效);关联实体名称/编号(如 xtmc/xtbh 等 12 个字段)仅在 3.4 明细接口中由 Service 批量填充,本接口返回时为 null。

请求参数: 无

响应数据: List<StopRecord>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
createdAt String 创建时间(yyyy-MM-dd HH:mm:ss)
cyxx String 成员信息
xtxx String 线体信息(线体id)
bcxx String 班次信息(班次id)
txqyxx String 停线区域信息(区域id)
txbzxx String 停线班组信息(班组id)
txgwxx String 停线工位信息(工位id)
gwxz String 工位性质编号(#1#-主线;#2#-辅线)
gwxzDesc String 工位性质中文描述(计算字段)
startTime String 停线开始时间(yyyy-MM-dd HH:mm:ss)
endTime String 停线结束时间(yyyy-MM-dd HH:mm:ss)
txsc Double 停线时长(分钟)
txbkxx String 停线板块信息(板块id)
txflxx String 停线分类信息
txms String 停线描述
qgxtbxz String 前工序填报选择编号(#1#-是;#2#-否)
qgxtbxzDesc String 前工序填报选择中文描述(计算字段)
bsbqgxyy String 不申报前工序原因
zrbkfzr String 责任板块负责人
txwthf String 停线问题回复
sbtzxx String 设备台账信息
sbbm String 设备编码
sbmc String 设备名称
sbgzlx String 设备故障类型编号(#1#-机械故障;#2#-电气故障)
sbgzlxDesc String 设备故障类型中文描述(计算字段)
sbgzsfcf Boolean 设备故障是否重复
sbgzywbz String 设备故障有无标准编号(#1#-有;#2#-无)
sbgzywbzDesc String 设备故障有无标准中文描述(计算字段)
sbgzlxfj String 设备故障类型分解编号(#1#-非设备原因;#2#-安装调整不良;#3#-松动;#4#-磨损;#5#-腐蚀;#6#-断裂;#7#-老化;#8#-误操作;#9#-设计不合理;#10#-参数设置不合理;#11#-部件质量不良;#12#-介质污染;#13#-5S不良;#14#-原因不明)
sbgzlxfjDesc String 设备故障类型分解中文描述(计算字段)
sbgzyy String 设备故障原因
sblscs String 设备临时措施
sbyjcs String 设备永久措施
sbghbj String 设备更换备件
tbry String 填报人员
tbrygh String 填报人员工号
czry String 操作人员
czrygh String 操作人员工号
ylwtclfa String 遗留问题处理方案
xtmc / xtbh String 线体名称/编号(本接口为 null,仅 3.4 填充)
bcmc / bcbh String 班次名称/编号(同上)
txqymc / txqybh String 停线区域名称/编号(同上)
txbkmc / txbkbm String 停线板块名称/编码(同上)
txgwmc / txgwbh String 停线工位名称/编号(同上)
txbzmc / txbzbh String 停线班组名称/编号(同上)

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "SR20260901001",
      "corpCode": "hfca",
      "xtxx": "XT001",
      "bcxx": "BC001",
      "txqyxx": "QY001",
      "txgwxx": "GW001",
      "gwxz": "#1#",
      "gwxzDesc": "主线",
      "startTime": "2026-09-01 08:30:00",
      "endTime": "2026-09-01 09:00:00",
      "txsc": 30.0,
      "txbkxx": "BK001",
      "qgxtbxz": "#1#",
      "qgxtbxzDesc": "是",
      "sbgzlx": "#1#",
      "sbgzlxDesc": "机械故障"
    }
  ],
  "msg": "成功",
  "errCode": null
}

3.2 按天汇总统计停线时长(按板块拆分) ✏️更新

✏️ 接口更新:原 GET /stopRecord/summary/daily(板块 txbkxx 作为可选参数)已按板块拆分为 4 个专用端点,txbkxx 参数移除,改由端点区分板块;year/month 由必传改为可选,为空时默认当前年/当前月;响应新增 bkbm/bkmc 板块编码/名称字段("其他"板块为空);每日记录新增 mrmbVal 每日目标字段(按区域、板块、年月查询区域停线时长月度目标表 t_auto_hfca_zlujkl_ojjdug 取目标值)。

接口路径(按板块 4 个端点):

板块 端点 说明
物流(编码 W) GET /stopRecord/summary/daily/logistics 汇总物流板块的每日停线时长
设备(编码 M) GET /stopRecord/summary/daily/equipment 汇总设备板块的每日停线时长
质量(编码 Q) GET /stopRecord/summary/daily/quality 汇总质量板块的每日停线时长
其他 GET /stopRecord/summary/daily/other 汇总非 W/M/Q 三大板块(含板块为空)的每日停线时长

接口说明: 根据板块端点定位板块信息 Id,再按线体、班次、区域条件筛选停线记录,按天分组汇总每天的停线时长与记录数,结果按日期升序排列。year/month 为空时默认当前年/当前月。每日记录中的 mrmbVal(每日目标)按区域、板块、年份、月份查询区域停线时长月度目标记录取目标值:区域 txqyxx 为空或未匹配到目标记录时为 null;「其他」端点取板块不属于物流/设备/质量的目标记录(含板块为空)。

请求参数:

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

响应数据: List<StopRecordDailySummaryDTO>

响应字段说明:

字段 类型 说明
date String 日期(yyyy-MM-dd)
mrmbVal Double 每日目标值,按区域、板块、年份、月份查询区域停线时长月度目标记录取目标值,未匹配到时为 null
totalTxsc Double 当日停线时长总计(分钟),单条记录 txsc 为 null 时按 0 计
totalCount Integer 当日停线记录数
bkbm String 板块编码("其他"板块端点为 null)
bkmc String 板块名称("其他"板块端点为 null)

响应示例(物流板块 GET /stopRecord/summary/daily/logistics):

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

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

✏️ 接口更新:原 GET /stopRecord/summary/workstation(板块 txbkxx 作为可选参数)已按板块拆分为 4 个专用端点,txbkxx 参数移除;响应新增 bkbm/bkmc 板块编码/名称字段("其他"板块为空)。

接口路径(按板块 4 个端点):

板块 端点 说明
物流(编码 W) GET /stopRecord/summary/workstation/logistics 汇总物流板块的各工位停线时长
设备(编码 M) GET /stopRecord/summary/workstation/equipment 汇总设备板块的各工位停线时长
质量(编码 Q) GET /stopRecord/summary/workstation/quality 汇总质量板块的各工位停线时长
其他 GET /stopRecord/summary/workstation/other 汇总非 W/M/Q 三大板块(含板块为空)的各工位停线时长

接口说明: 在 3.2 相同的线体、班次、区域条件基础上,加上指定日期,按工位汇总停线时长(关联停线工位信息补充工位名称与编号),汇总结果按停线时长降序排列。date 为空时不限定日期。仅返回汇总结果,不含停线记录明细(明细查询见 3.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 板块编码("其他"板块端点为 null)
bkmc String 板块名称("其他"板块端点为 null)

响应示例(物流板块 GET /stopRecord/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
}

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

✏️ 接口更新:原 GET /stopRecord/list/detail(板块 txbkxx 作为可选参数)已按板块拆分为 4 个专用端点,txbkxx 参数移除;响应在 StopRecord 基础上补充线体、班次、区域、板块、工位、班组共 12 个关联实体的名称与编号(Service 批量 mapByIds 填充,避免 N+1 查询)。

接口路径(按板块 4 个端点):

板块 端点 说明
物流(编码 W) GET /stopRecord/list/detail/logistics 查询物流板块的停线记录明细
设备(编码 M) GET /stopRecord/list/detail/equipment 查询设备板块的停线记录明细
质量(编码 Q) GET /stopRecord/list/detail/quality 查询质量板块的停线记录明细
其他 GET /stopRecord/list/detail/other 查询非 W/M/Q 三大板块(含板块为空)的停线记录明细

接口说明: 根据线体、班次、区域、工位条件及指定日期筛选停线记录,返回停线记录明细列表;每条记录除持久化字段与枚举中文描述外,还包含关联实体(线体、班次、区域、板块、工位、班组)的名称与编号。所有参数均为可选,date 为空时不限定日期。

请求参数:

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

响应数据: List<StopRecord>(结构同 3.1 的 StopRecord,其中 12 个关联实体名称/编号字段在本接口中已填充)

响应关联实体字段(本接口专属填充):

字段 类型 说明
xtmc String 线体名称(关联 XtLine)
xtbh String 线体编号(关联 XtLine)
bcmc String 班次名称(关联 Shift)
bcbh String 班次编号(关联 Shift)
txqymc String 停线区域名称(关联 Area)
txqybh String 停线区域编号(关联 Area)
txbkmc String 停线板块名称(关联 BlockInfo)
txbkbm String 停线板块编码(关联 BlockInfo)
txgwmc String 停线工位名称(关联 StopWorkstation)
txgwbh String 停线工位编号(关联 StopWorkstation)
txbzmc String 停线班组名称(关联 Team)
txbzbh String 停线班组编号(关联 Team)

响应示例(物流板块 GET /stopRecord/list/detail/logistics):

{
  "success": true,
  "data": [
    {
      "id": "SR20260901001",
      "corpCode": "hfca",
      "xtxx": "XT001",
      "xtmc": "总装一线",
      "xtbh": "L01",
      "bcxx": "BC001",
      "bcmc": "白班",
      "bcbh": "BC001",
      "txqyxx": "QY001",
      "txqymc": "装配区域",
      "txqybh": "QY001",
      "txbkxx": "BK_W",
      "txbkmc": "物流板块",
      "txbkbm": "W",
      "txgwxx": "GW001",
      "txgwmc": "焊接工位",
      "txgwbh": "01",
      "txbzxx": "TEAM001",
      "txbzmc": "装配一班",
      "txbzbh": "BZ001",
      "gwxz": "#1#",
      "gwxzDesc": "主线",
      "startTime": "2026-09-01 08:30:00",
      "endTime": "2026-09-01 10:00:00",
      "txsc": 90.0,
      "qgxtbxz": "#1#",
      "qgxtbxzDesc": "是"
    }
  ],
  "msg": "成功",
  "errCode": null
}

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

4.1 获取所有过程确认班组计划列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有过程确认班组计划列表。

请求参数: 无

响应数据: List<ProcessConfirmTeamPlan>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
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 区域信息
jhzfbz String 计划走访班组id
jhzfgw String 计划走访工位id
zt String 状态(#1#-待确认;#2#-未执行;#3#-已执行;#4#-已逾期)
ztDesc String 状态中文描述(计算字段)
sffxwt Boolean 是否发现问题
bcxx String 班次信息

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "PCTP20261005001",
      "corpCode": "hfca",
      "createdAt": "2026-10-05 08:00:00",
      "jhrq": "2026-10-06 00:00:00",
      "zxr": "user001",
      "dwxx": "workshop001",
      "xtxx": "XT001",
      "szxx": "rg001",
      "qyxx": "area001",
      "jhzfbz": "team001",
      "jhzfgw": "ws001",
      "zt": "#1#",
      "ztDesc": "待确认",
      "sffxwt": false,
      "bcxx": "BC001"
    }
  ],
  "msg": "成功",
  "errCode": null
}

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

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

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

接口说明: 以当前时间所在自然周为准(周一为一周起始),查询计划日期(jhrq)在周一 00:00:00.000 ~ 周日 23:59:59.999 范围内的过程确认班组计划记录,关联计划走访班组(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#-已逾期)
ztDesc String 状态中文描述(由 BeanUtils.copyProperties 自动拷贝)
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#",
      "ztDesc": "待确认",
      "sffxwt": false,
      "bcxx": "BC001",
      "jhzfbz": "team001",
      "jhzfbzName": "装配一班",
      "jhzfbzCode": "BZ001",
      "jhzfgw": "ws001",
      "jhzfgwName": "装配工位",
      "jhzfgwCode": "GW001"
    }
  ],
  "msg": "成功",
  "errCode": null
}

5. PJO计划执行接口

5.1 查询区域内当前周PJO执行记录明细列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

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

请求参数:

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

响应数据: 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
drscbcName String 当日生产班次名称
drscbcCode String 当日生产班次编号
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,
  "data": [
    {
      "id": "53DfARB8Lllis48Qc5S",
      "createdAt": null,
      "qkxdwk": "2026-10-07 08:00:00",
      "drscbc": "04XZ79FFFNlMQvVRbNC",
      "drscbcName": "白班",
      "drscbcCode": "BC001",
      "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,
      "gcdwt": null,
      "lfwkuc": null,
      "zyczdwt": null,
      "zyczdwtDesc": null,
      "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"
    }
  ],
  "msg": "成功",
  "errCode": null
}

6. CPS问题接口

6.1 根据年月、区域、状态查询问题记录明细 🆕新增

🆕 新增接口(2026-10-06 之后新建):所有条件均可为空,月份(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>

响应字段说明:

字段 类型 说明
id String 记录ID
createdAt Date 创建时间(yyyy-MM-dd HH:mm:ss)
wtbh String 问题编号
wtms String 问题描述
wtly String 问题来源编号(#1#-开班;#2#-过程验证;#3#-过程确认;#4#-体系健康体检;#5#-单位自检)
wtlyDesc String 问题来源名称
wtssbk String 问题所属板块
wtlb String 问题类别编号(#1#-方针展开;#2#-标准化作业;#3#-目视化;#4#-时间数据处理;#5#-过程确认;#6#-持续改善)
wtlbDesc String 问题类别名称
wtxz String 问题性质编号(#1#-无标准;#2#-未执行标准;#3#-标准不足)
wtxzDesc String 问题性质名称
sfl String 6S分类编号(#1#-整理;#2#-整顿;#3#-清洁;#4#-清扫;#5#-素养;#6#-安全)
sflDesc String 6S分类名称
mbghlk String 问题层级编号(#1#-1;#2#-2;#3#-3;#4#-4;#5#-5;#0#-0)
mbghlkDesc String 问题层级名称
rylb String 人员类别编号(#1#-区长;#2#-班长;#3#-高级经理;#4#-经理;#5#-主管;#6#-专家;#7#-一般员工)
rylbDesc String 人员类别名称
wtsfgb Boolean 问题是否关闭
wtfj String 问题附件
wtzghfj String 问题整改后附件
wtjjcs String 问题解决措施
wtclfs String 问题处理方式编号(#1#-自己解决;#2#-工作安排/同级支持;#3#-问题升级至)
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 问题处理状态编号(#1#-待处理;#2#-处理中;#3#-已关闭;#4#-已逾期)
wtclztDesc String 问题处理状态名称

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "p123",
      "createdAt": "2026-10-05 09:00:00",
      "wtbh": "WT202610001",
      "wtms": "装配线设备故障",
      "wtly": "#2#",
      "wtlyDesc": "过程验证",
      "wtlb": "#5#",
      "wtlbDesc": "过程确认",
      "jhjjsj": "2026-10-10 18:00:00",
      "gzdw": "workshop001",
      "gzdwName": "总装车间",
      "gzdwCode": "104",
      "wtzrdw": "workshop001",
      "wtzrdwName": "总装车间",
      "wtzrdwCode": "104",
      "qy": "area001",
      "qyName": "装配区域",
      "qyCode": "QY001",
      "bz": "team001",
      "bzName": "装配一班",
      "bzCode": "BZ001",
      "wttcr": "user001",
      "wttcrName": "张三",
      "wtclr": "user002",
      "wtclrName": "李四",
      "wtclzt": "#2#",
      "wtclztDesc": "处理中"
    }
  ],
  "msg": "成功",
  "errCode": null
}

7. 质量缺陷接口

7.1 获取所有质量缺陷信息列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有质量缺陷信息列表。响应中除持久化字段外,还包含 5 个枚举字段中文描述(sjsxDesc/wttcdwDesc/wtsxDesc/pcwtyyDesc/kzahntDesc,计算型 getter,所有返回该实体的接口均自动生效),以及由 Service 批量 mapByIds 填充的关联实体名称/编号(停线工位、班次、区域)与人员姓名(责任人员、创建人、更新人)。

请求参数: 无

响应数据: List<QualityDefect>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
createdAt String 创建时间(yyyy-MM-dd HH:mm:ss)
createdBy String 创建人ID(组织用户)
createdByName String 创建人姓名(关联组织用户,Service 填充)
updatedAt String 更新时间(yyyy-MM-dd HH:mm:ss)
updatedBy String 更新人ID(组织用户)
updatedByName String 更新人姓名(关联组织用户,Service 填充)
sjsx String 事件属性编号(#0#-内部;#1#-外部)
sjsxDesc String 事件属性中文描述(计算字段)
tcrq String 提出日期(yyyy-MM-dd HH:mm:ss)
kzahnt String 车型编号(#1#-C928;#2#-S311)
kzahntDesc String 车型中文描述(计算字段)
vin String VIN码
wtbw String 问题部位
wtms String 问题描述
wtgwxx String 问题工位信息(停线工位id)
gwmc String 问题工位名称(关联停线工位,Service 填充)
gwbh String 问题工位编号(关联停线工位,Service 填充)
ydcfcs Double 月度重复次数
wtImg String 问题图片
wttcdw String 问题提出单位编号(#1#-检验区;#2#-出厂)
wttcdwDesc String 问题提出单位中文描述(计算字段)
wtsx String 问题属性编号(#1#-装配不良;#2#-钣金碰划伤;#3#-装配异常;#4#-零部件;#5#-错漏装;#6#-日异物;#7#-异物;#8#-无)
wtsxDesc String 问题属性中文描述(计算字段)
wtbcxx String 问题班次信息(班次id)
bcmc String 问题班次名称(关联班次,Service 填充)
bcbh String 问题班次编号(关联班次,Service 填充)
tzsj String 通知时间(yyyy-MM-dd HH:mm:ss)
tzry String 通知人员
zrqyxx String 责任区域信息(区域id)
qymc String 责任区域名称(关联区域,Service 填充)
qybh String 责任区域编号(关联区域,Service 填充)
zrqz String 责任区长
zrry String 责任人员ID(组织用户)
zrryName String 责任人员姓名(关联组织用户,Service 填充)
sfpc Boolean 是否排出
pcwtyy String 排出问题原因编号(#1#-40分问题;#2#-80分问题;#3#-300分问题)
pcwtyyDesc String 排出问题原因中文描述(计算字段)
pcts String 排查台数
sfnrqygk Boolean 是否纳入区域管理看板
ygh String 员工号
wtjzch String 问题基准车号
fsyy String 发生原因
gkcs String 管控措施

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "QD20260901001",
      "corpCode": "hfca",
      "createdAt": "2026-09-01 08:00:00",
      "createdBy": "user001",
      "createdByName": "张三",
      "updatedBy": "user002",
      "updatedByName": "李四",
      "sjsx": "#0#",
      "sjsxDesc": "0-对应内部",
      "tcrq": "2026-09-01 00:00:00",
      "kzahnt": "#1#",
      "kzahntDesc": "C928",
      "vin": "LSVAA1234567890",
      "wtbw": "前保险杠",
      "wtms": "保险杠表面划伤",
      "wtgwxx": "GW001",
      "gwmc": "焊接工位",
      "gwbh": "01",
      "ydcfcs": 2.0,
      "wttcdw": "#1#",
      "wttcdwDesc": "检验区",
      "wtsx": "#2#",
      "wtsxDesc": "钣金碰划伤",
      "wtbcxx": "BC001",
      "bcmc": "白班",
      "bcbh": "BC001",
      "zrqyxx": "QY001",
      "qymc": "装配区域",
      "qybh": "QY001",
      "zrry": "user003",
      "zrryName": "王五",
      "sfpc": true,
      "pcwtyy": "#1#",
      "pcwtyyDesc": "40分问题",
      "pcts": "10",
      "sfnrqygk": true
    }
  ],
  "msg": "成功",
  "errCode": null
}

7.2 按月份查询每日质量缺陷记录汇总数目 🆕新增

🆕 新增接口(2026-10-06 之后新建)

接口路径: GET /qualityDefect/summary/daily

接口说明: 按责任区域、年月统计每日质量缺陷记录数(按提出日期 tcrq 分组),结果按日期升序排列。year/month 为空时默认当前年/当前月;zrqyxx 为空时不限定区域。

请求参数:

参数名 类型 必传 说明
zrqyxx String 否 责任区域信息(区域id),为空则不限定
year Integer 否 年份(如 2026),为空默认当前年
month Integer 否 月份(1-12),为空默认当前月

响应数据: List<QualityDefectDailySummaryDTO>

响应字段说明:

字段 类型 说明
date String 日期(yyyy-MM-dd)
count Integer 当日缺陷记录数

响应示例:

{
  "success": true,
  "data": [
    {
      "date": "2026-09-01",
      "count": 3
    },
    {
      "date": "2026-09-02",
      "count": 1
    }
  ],
  "msg": "成功",
  "errCode": null
}

7.3 按指定日期和区域汇总各工位缺陷次数 🆕新增

🆕 新增接口(2026-10-06 之后新建)

接口路径: GET /qualityDefect/summary/workstation

接口说明: 按指定日期、责任区域汇总各停线工位的缺陷记录数与月度重复次数合计(关联停线工位信息补充工位名称、编号与性质),结果按缺陷次数降序排列。date 为必填;zrqyxx 为空时不限定区域。仅返回汇总结果,不含缺陷明细(明细查询见 7.4)。

请求参数:

参数名 类型 必传 说明
zrqyxx String 否 责任区域信息(区域id),为空则不限定
date String 是 指定日期,格式:yyyy-MM-dd

响应数据: List<QualityDefectWorkstationSummaryDTO>

响应字段说明:

字段 类型 说明
wtgwxx String 停线工位信息ID
gwmc String 工位名称(关联停线工位信息)
gwbh String 工位编号(关联停线工位信息)
gwxz String 工位性质编号(#1#-主线;#2#-辅线)
gwxzDesc String 工位性质中文描述(由 StopGwxzEnum 解析)
count Integer 该工位缺陷记录数
totalYdcfcs Double 该工位缺陷次数合计(ydcfcs 求和)

响应示例:

{
  "success": true,
  "data": [
    {
      "wtgwxx": "GW001",
      "gwmc": "焊接工位",
      "gwbh": "01",
      "gwxz": "#1#",
      "gwxzDesc": "主线",
      "count": 3,
      "totalYdcfcs": 5.0
    },
    {
      "wtgwxx": "GW002",
      "gwmc": "装配工位",
      "gwbh": "02",
      "gwxz": "#2#",
      "gwxzDesc": "辅线",
      "count": 1,
      "totalYdcfcs": 1.0
    }
  ],
  "msg": "成功",
  "errCode": null
}

7.4 按指定日期、区域、工位查询质量缺陷明细列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

接口路径: GET /qualityDefect/list/detail

接口说明: 按指定日期、责任区域、问题工位筛选质量缺陷记录,返回明细列表;每条记录除持久化字段与枚举中文描述外,还包含关联实体(停线工位、班次、区域)的名称与编号,以及责任人员、创建人、更新人姓名(Service 批量填充)。date 为必填;zrqyxx/wtgwxx 为空时不限定。

请求参数:

参数名 类型 必传 说明
zrqyxx String 否 责任区域信息(区域id),为空则不限定
date String 是 指定日期,格式:yyyy-MM-dd
wtgwxx String 否 问题工位信息(停线工位id),为空则不限定

响应数据: List<QualityDefect>(结构同 7.1 的 QualityDefect,关联实体名称/编号与人员姓名字段在本接口中已填充)

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "QD20260901001",
      "corpCode": "hfca",
      "sjsx": "#0#",
      "sjsxDesc": "0-对应内部",
      "tcrq": "2026-09-01 00:00:00",
      "kzahnt": "#1#",
      "kzahntDesc": "C928",
      "wtgwxx": "GW001",
      "gwmc": "焊接工位",
      "gwbh": "01",
      "wttcdw": "#1#",
      "wttcdwDesc": "检验区",
      "wtsx": "#2#",
      "wtsxDesc": "钣金碰划伤",
      "wtbcxx": "BC001",
      "bcmc": "白班",
      "bcbh": "BC001",
      "zrqyxx": "QY001",
      "qymc": "装配区域",
      "qybh": "QY001",
      "zrry": "user003",
      "zrryName": "王五",
      "createdBy": "user001",
      "createdByName": "张三",
      "updatedBy": "user002",
      "updatedByName": "李四"
    }
  ],
  "msg": "成功",
  "errCode": null
}

8. 车间级工作任务接口

8.1 获取所有车间级工作任务列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有车间级工作任务列表。响应中除持久化字段外,还包含任务状态中文描述(rwztDesc,计算型 getter),以及由 Service 批量 mapByIds 填充的关联实体名称(所属工作计划、区域)与人员姓名(任务负责人、计划负责人、创建人、更新人)。

请求参数: 无

响应数据: List<WorkshopWorkTask>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
createdAt String 创建时间(yyyy-MM-dd HH:mm:ss)
createdBy String 创建人ID(组织用户)
createdByName String 创建人姓名(关联组织用户,Service 填充)
updatedAt String 更新时间(yyyy-MM-dd HH:mm:ss)
updatedBy String 更新人ID(组织用户)
updatedByName String 更新人姓名(关联组织用户,Service 填充)
rwxh String 任务序号
rwmc String 任务名称
ssgzjh String 所属工作计划(工作计划id)
ssgzjhMc String 所属工作计划名称(关联工作计划,Service 填充)
rwfzr String 任务负责人ID(组织用户)
rwfzrName String 任务负责人姓名(关联组织用户,Service 填充)
endDate String 结束日期(yyyy-MM-dd HH:mm:ss)
rwzt String 任务状态编号(#1#-进行中;#2#-已完成;#3#-已逾期)
rwztDesc String 任务状态中文描述(计算字段)
gzjhxh String 工作计划序号
jhfzr String 计划负责人ID(组织用户)
jhfzrName String 计划负责人姓名(关联组织用户,Service 填充)
qyxx String 区域信息(区域id)
qymc String 区域名称(关联区域,Service 填充)
qybh String 区域编号(关联区域,Service 填充)
xh String 序号
rwmb String 任务目标
wcqk String 完成情况
wcqkfj String 完成情况附件
remark String 备注

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "WT20260901001",
      "corpCode": "hfca",
      "createdAt": "2026-09-01 08:00:00",
      "createdBy": "user001",
      "createdByName": "张三",
      "updatedBy": "user002",
      "updatedByName": "李四",
      "rwxh": "1",
      "rwmc": "装配线巡检",
      "ssgzjh": "PLAN001",
      "ssgzjhMc": "9月总装工作计划",
      "rwfzr": "user003",
      "rwfzrName": "王五",
      "endDate": "2026-09-30 18:00:00",
      "rwzt": "#1#",
      "rwztDesc": "进行中",
      "gzjhxh": "JH001",
      "jhfzr": "user004",
      "jhfzrName": "赵六",
      "qyxx": "QY001",
      "qymc": "装配区域",
      "qybh": "QY001",
      "xh": "1",
      "rwmb": "完成装配线每日巡检",
      "wcqk": "已完成 80%",
      "remark": "正常推进"
    }
  ],
  "msg": "成功",
  "errCode": null
}

8.2 根据区域、年份、月份查询工作任务明细列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

接口路径: GET /workshopWorkTask/list/detail

接口说明: 按区域、年月筛选工作任务明细(按创建时间 createdAt 在该年月范围内过滤),返回明细列表;每条记录除持久化字段与任务状态中文描述外,还包含关联实体(工作计划、区域)名称与人员姓名(Service 批量填充)。year/month 为空时默认当前年/当前月;qyxx 为空时不限定区域。

请求参数:

参数名 类型 必传 说明
qyxx String 否 区域信息(区域id),为空则不限定
year Integer 否 年份(如 2026),为空默认当前年
month Integer 否 月份(1-12),为空默认当前月;按创建时间范围过滤

响应数据: List<WorkshopWorkTask>(结构同 8.1 的 WorkshopWorkTask,关联实体名称与人员姓名字段在本接口中已填充)

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "WT20260901001",
      "corpCode": "hfca",
      "rwxh": "1",
      "rwmc": "装配线巡检",
      "ssgzjh": "PLAN001",
      "ssgzjhMc": "9月总装工作计划",
      "rwfzr": "user003",
      "rwfzrName": "王五",
      "jhfzr": "user004",
      "jhfzrName": "赵六",
      "endDate": "2026-09-30 18:00:00",
      "rwzt": "#1#",
      "rwztDesc": "进行中",
      "qyxx": "QY001",
      "qymc": "装配区域",
      "qybh": "QY001",
      "createdBy": "user001",
      "createdByName": "张三",
      "updatedBy": "user002",
      "updatedByName": "李四"
    }
  ],
  "msg": "成功",
  "errCode": null
}

8.3 按任务状态汇总各状态记录条数 🆕新增

🆕 新增接口(2026-10-06 之后新建)

接口路径: GET /workshopWorkTask/summary/status

接口说明: 按区域、年月(按创建时间过滤)统计各任务状态下的记录条数,含状态中文描述。year/month 为空时默认当前年/当前月;qyxx 为空时不限定区域。本接口仅返回状态汇总,不含关联实体名称填充。

请求参数:

参数名 类型 必传 说明
qyxx String 否 区域信息(区域id),为空则不限定
year Integer 否 年份(如 2026),为空默认当前年
month Integer 否 月份(1-12),为空默认当前月;按创建时间范围过滤

响应数据: List<WorkshopWorkTaskStatusSummaryDTO>

响应字段说明:

字段 类型 说明
rwzt String 任务状态编号(#1#-进行中;#2#-已完成;#3#-已逾期;无状态时为“未知”)
rwztDesc String 任务状态中文描述(由 RwztEnum 解析)
count Integer 该状态下的任务数量

响应示例:

{
  "success": true,
  "data": [
    {
      "rwzt": "#1#",
      "rwztDesc": "进行中",
      "count": 5
    },
    {
      "rwzt": "#2#",
      "rwztDesc": "已完成",
      "count": 3
    },
    {
      "rwzt": "#3#",
      "rwztDesc": "已逾期",
      "count": 1
    }
  ],
  "msg": "成功",
  "errCode": null
}

9. 公告信息接口

9.1 获取所有公告信息列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有公告信息列表。响应中除持久化字段外,还包含公告类型中文描述(gglxDesc)与状态中文描述(ztDesc)两个计算型 getter 字段;本接口不填充线体/车间/室组/区域等关联名称与编号(如需关联信息请使用 9.2)。

请求参数: 无

响应数据: List<Announcement>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
xtxx String 线体信息(线体id)
cjxx String 车间信息(车间/单位id)
szxx String 室组信息(室组id)
qyxx String 区域信息(区域id)
gglx String 公告类型编号(#1#-通知;#2#-提醒;#3#-警示;#4#-表彰)
gglxDesc String 公告类型中文描述(计算字段)
ggnr String 公告内容
zt String 状态编号(#1#-草稿;#2#-启用;#3#-停用)
ztDesc String 状态中文描述(计算字段)

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "GG20260901001",
      "corpCode": "hfca",
      "xtxx": "XT001",
      "cjxx": "CJ001",
      "szxx": "SZ001",
      "qyxx": "QY001",
      "gglx": "#1#",
      "gglxDesc": "通知",
      "ggnr": "本周五下午设备检修,请提前安排生产。",
      "zt": "#2#",
      "ztDesc": "启用"
    }
  ],
  "msg": "成功",
  "errCode": null
}

9.2 获取启用的特色公告列表(按线体/车间/室组/区域条件查询) 🆕新增

🆕 新增接口(2026-10-06 之后新建)

接口路径: GET /announcement/list/enabled

接口说明: 查询当前企业下状态为启用(zt = #2#)的特色公告列表,可按线体、车间、室组、区域四个维度筛选(均可不传)。四个维度独立判断,匹配规则:对每个维度,当「公告该维度为空」或「入参该维度为空」或「两者相等」时视为该维度匹配,四个维度全部匹配才返回。因此:无任何归属信息的公告(全局公告)恒返回;仅有某一维度信息的公告,在入参对应维度为空或与之相等时返回。返回列表会补全线体/车间/室组/区域的名称与编号(Service 批量填充)。

请求参数:

参数名 类型 必传 说明
xtxx String 否 线体id,为空则该维度不参与筛选
cjxx String 否 车间(单位)id,为空则该维度不参与筛选
szxx String 否 室组id,为空则该维度不参与筛选
qyxx String 否 区域id,为空则该维度不参与筛选

响应数据: List<Announcement>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
xtxx String 线体信息(线体id)
xtmc String 线体名称(关联线体,Service 填充)
xtbh String 线体编号(关联线体,Service 填充)
cjxx String 车间信息(车间/单位id)
dwmc String 车间(单位)名称(关联车间,Service 填充)
dwbh String 车间(单位)编号(关联车间,Service 填充)
szxx String 室组信息(室组id)
szmc String 室组名称(关联室组,Service 填充)
szbh String 室组编号(关联室组,Service 填充)
qyxx String 区域信息(区域id)
qymc String 区域名称(关联区域,Service 填充)
qybh String 区域编号(关联区域,Service 填充)
gglx String 公告类型编号(#1#-通知;#2#-提醒;#3#-警示;#4#-表彰)
gglxDesc String 公告类型中文描述(计算字段)
ggnr String 公告内容
zt String 状态编号(#1#-草稿;#2#-启用;#3#-停用),本接口固定为 #2#
ztDesc String 状态中文描述(计算字段)

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "GG20260901001",
      "corpCode": "hfca",
      "xtxx": "XT001",
      "xtmc": "B线",
      "xtbh": "B",
      "cjxx": "CJ001",
      "dwmc": "总装车间",
      "dwbh": "104",
      "szxx": "SZ001",
      "szmc": "总装室",
      "szbh": "201",
      "qyxx": "QY001",
      "qymc": "底盘分装",
      "qybh": "51",
      "gglx": "#1#",
      "gglxDesc": "通知",
      "ggnr": "本周五下午设备检修,请提前安排生产。",
      "zt": "#2#",
      "ztDesc": "启用"
    },
    {
      "id": "GG20260901002",
      "corpCode": "hfca",
      "xtxx": null,
      "xtmc": null,
      "xtbh": null,
      "cjxx": null,
      "dwmc": null,
      "dwbh": null,
      "szxx": null,
      "szmc": null,
      "szbh": null,
      "qyxx": null,
      "qymc": null,
      "qybh": null,
      "gglx": "#4#",
      "gglxDesc": "表彰",
      "ggnr": "全局公告:表彰本月优秀班组。",
      "zt": "#2#",
      "ztDesc": "启用"
    }
  ],
  "msg": "成功",
  "errCode": null
}

10. 多能工信息接口

10.1 获取所有多能工信息列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有多能工信息列表。响应中除持久化字段外,还包含等级中文描述(levelDesc,计算型 getter);本接口不填充线体/车间/室组/区域/班组/员工/工位/区域员工等关联名称与编号(如需完整关联信息与汇总请使用 10.2)。

请求参数: 无

响应数据: List<MultiSkilledWorker>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
xtxx String 线体信息(线体id)
cjxx String 车间信息(车间/单位id)
szxx String 室组信息(室组id)
qyxx String 区域信息(区域id)
bzxx String 班组信息(班组id)
ygxx String 员工信息(组织用户id)
gwxx String 工位信息(停线工位id)
level String 等级编号(#1#-1级;#2#-2级;#3#-3级;#4#-4级)
levelDesc String 等级中文描述(计算字段)
qyygxx String 区域员工信息(区域员工id)

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "DNG20260901001",
      "corpCode": "hfca",
      "xtxx": "XT001",
      "cjxx": "CJ001",
      "szxx": "SZ001",
      "qyxx": "QY001",
      "bzxx": "BZ001",
      "ygxx": "user001",
      "gwxx": "GW001",
      "level": "#3#",
      "levelDesc": "3级",
      "qyygxx": "QYYG001"
    }
  ],
  "msg": "成功",
  "errCode": null
}

10.2 按区域汇总多能工信息 🆕新增

🆕 新增接口(2026-10-06 之后新建)

接口路径: GET /multiSkilledWorker/summary/area

接口说明: 按区域(qyxx,必传)查询该区域下的多能工记录,先补全每条记录的完整关联信息(线体/车间/室组/区域/班组/员工/工位/区域员工的名称与编号,及等级中文描述),再对员工(按 ygxx 去重)、工位(按 gwxx 去重)分别汇总整合。一个接口同时返回三部分:员工列表、工位列表、员工工位等级信息列表(即补全后的多能工明细)。区域下无记录时三个列表均返回空数组;去重保留首次出现顺序。

请求参数:

参数名 类型 必传 说明
qyxx String 否 区域信息(区域id)

响应数据: MultiSkilledWorkerSummaryDTO

响应字段说明:

字段 类型 说明
employeeList Array 员工列表(按员工去重汇总)
employeeList[].qyygxx String 区域员工信息ID
employeeList[].qyygName String 区域员工姓名
employeeList[].qyygCode String 区域员工号
workstationList Array 工位列表(按工位去重汇总)
workstationList[].gwxx String 工位信息ID(停线工位ID)
workstationList[].gwmc String 工位名称(关联停线工位)
workstationList[].gwbh String 工位编号(关联停线工位)
workerLevelList Array 员工工位等级信息列表(多能工明细,含完整关联信息)
workerLevelList[].id String 记录ID
workerLevelList[].xtxx / xtmc / xtbh String 线体id / 名称 / 编号(关联线体,Service 填充)
workerLevelList[].cjxx / dwmc / dwbh String 车间id / 名称 / 编号(关联车间,Service 填充)
workerLevelList[].szxx / szmc / szbh String 室组id / 名称 / 编号(关联室组,Service 填充)
workerLevelList[].qyxx / qymc / qybh String 区域id / 名称 / 编号(关联区域,Service 填充)
workerLevelList[].bzxx / bzmc / bzbh String 班组id / 名称 / 编号(关联班组,Service 填充)
workerLevelList[].ygxx / ygName String 员工id / 姓名(关联组织用户,Service 填充)
workerLevelList[].gwxx / gwmc / gwbh String 工位id / 名称 / 编号(关联停线工位,Service 填充)
workerLevelList[].level / levelDesc String 等级编号 / 中文描述(计算字段)
workerLevelList[].qyygxx / qyygxm / qyygh String 区域员工id / 姓名 / 工号(关联区域员工,Service 填充)

响应示例:

{
  "success": true,
  "data": {
    "employeeList": [
      { "ygxx": "user001", "ygName": "张三" },
      { "ygxx": "user002", "ygName": "李四" }
    ],
    "workstationList": [
      { "gwxx": "GW001", "gwmc": "焊接工位", "gwbh": "01" },
      { "gwxx": "GW002", "gwmc": "装配工位", "gwbh": "02" }
    ],
    "workerLevelList": [
      {
        "id": "DNG20260901001",
        "corpCode": "hfca",
        "xtxx": "XT001",
        "xtmc": "B线",
        "xtbh": "B",
        "cjxx": "CJ001",
        "dwmc": "总装车间",
        "dwbh": "104",
        "szxx": "SZ001",
        "szmc": "总装室",
        "szbh": "201",
        "qyxx": "QY001",
        "qymc": "底盘分装",
        "qybh": "51",
        "bzxx": "BZ001",
        "bzmc": "发动机分装班",
        "bzbh": "142",
        "ygxx": "user001",
        "ygName": "张三",
        "gwxx": "GW001",
        "gwmc": "焊接工位",
        "gwbh": "01",
        "level": "#3#",
        "levelDesc": "3级",
        "qyygxx": "QYYG001",
        "qyygxm": "张三",
        "qyygh": "A1001"
      },
      {
        "id": "DNG20260901002",
        "corpCode": "hfca",
        "qymc": "底盘分装",
        "qybh": "51",
        "ygxx": "user002",
        "ygName": "李四",
        "gwxx": "GW002",
        "gwmc": "装配工位",
        "gwbh": "02",
        "level": "#4#",
        "levelDesc": "4级"
      }
    ]
  },
  "msg": "成功",
  "errCode": null
}

11. 区域记分卡接口

11.1 获取所有区域记分卡列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有区域记分卡列表。响应中除持久化字段外,还包含月份中文描述(yuefemDesc,计算型 getter)。

请求参数: 无

响应数据: List<AreaScorecard>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
year String 年份(yyyy-MM-dd HH:mm:ss)
xtxx String 线体信息
cjxx String 车间信息
szxx String 室组信息
qyxx String 区域信息(区域id)
bkxx String 板块信息(板块id)
zhibxx String 指标信息(指标id)
yuefem String 月份编号(#1#-1月;#2#-2月;...;#12#-12月)
yuefemDesc String 月份中文描述(计算字段)
sfdbFlag Boolean 是否达标
mbVal Double 目标值
realVal Double 实际值

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "JFK20261001001",
      "corpCode": "hfca",
      "year": "2026-01-01 00:00:00",
      "xtxx": "XT001",
      "cjxx": "CJ001",
      "szxx": "SZ001",
      "qyxx": "QY001",
      "bkxx": "BK001",
      "zhibxx": "ZB001",
      "yuefem": "#10#",
      "yuefemDesc": "10月",
      "sfdbFlag": true,
      "mbVal": 100.0,
      "realVal": 95.0
    }
  ],
  "msg": "成功",
  "errCode": null
}

11.2 按区域、年份和月份查询记分卡列表 ✏️更新

✏️ 接口更新(2026-10-16 更新):新增 year 参数,对实体属性字段 year 做范围查询(默认当前年开始时间~结束时间);修复原 month 参数查询条件未生效的问题。

接口路径: GET /areaScorecard/list/byMonth

接口说明: 按区域、年份、月份查询记分卡列表,结果按板块序号升序排列。响应中除持久化字段外,还包含月份中文描述(计算字段),以及由 Service 批量填充的关联信息(区域名称/编号、板块名称/编码/序号、指标名称)。

请求参数:

参数名 类型 必传 说明
qyxx String 否 区域信息(区域id),为空则不限定
year Integer 否 年份,为空默认当前年
month Integer 否 月份(1-12),为空默认当前月

响应数据: List<AreaScorecard>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
year String 年份(yyyy-MM-dd HH:mm:ss)
xtxx String 线体信息
cjxx String 车间信息
szxx String 室组信息
qyxx String 区域信息(区域id)
qymc String 区域名称(关联 Area,Service 填充)
qybh String 区域编号(关联 Area,Service 填充)
bkxx String 板块信息(板块id)
bkmc String 板块名称(关联 BlockInfo,Service 填充)
bkbm String 板块编码(关联 BlockInfo,Service 填充)
bkxh String 板块序号(关联 BlockInfo,Service 填充,用于排序)
zhibxx String 指标信息(指标id)
zhibmc String 指标名称(关联 AreaBlockIndicator,Service 填充)
yuefem String 月份编号(#1#-1月;#2#-2月;...;#12#-12月)
yuefemDesc String 月份中文描述(计算字段)
sfdbFlag Boolean 是否达标
mbVal Double 目标值
realVal Double 实际值

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "JFK20261001001",
      "corpCode": "hfca",
      "year": "2026-01-01 00:00:00",
      "xtxx": "XT001",
      "cjxx": "CJ001",
      "szxx": "SZ001",
      "qyxx": "QY001",
      "qymc": "装配区域",
      "qybh": "QY001",
      "bkxx": "BK001",
      "bkmc": "质量板块",
      "bkbm": "Q",
      "bkxh": "1",
      "zhibxx": "ZB001",
      "zhibmc": "缺陷率",
      "yuefem": "#10#",
      "yuefemDesc": "10月",
      "sfdbFlag": true,
      "mbVal": 100.0,
      "realVal": 95.0
    }
  ],
  "msg": "成功",
  "errCode": null
}

12. 区域板块指标信息接口

12.1 获取所有区域板块指标信息列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有区域板块指标信息列表。响应中除持久化字段外,还包含状态中文描述(ztDesc,计算型 getter)。

请求参数: 无

响应数据: List<AreaBlockIndicator>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
xtxx String 线体信息
cjxx String 车间信息
szxx String 室组信息
qyxx String 区域信息
bkxx String 板块信息
zhib String 指标
zt String 状态编号(#1#-草稿;#2#-启用;#3#-停用)
ztDesc String 状态中文描述(计算字段)

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "ZB20261001001",
      "corpCode": "hfca",
      "xtxx": "XT001",
      "cjxx": "CJ001",
      "szxx": "SZ001",
      "qyxx": "QY001",
      "bkxx": "BK001",
      "zhib": "缺陷率",
      "zt": "#2#",
      "ztDesc": "启用"
    }
  ],
  "msg": "成功",
  "errCode": null
}

13. 区域板块指标每日明细接口

13.1 获取所有区域板块指标每日明细列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有区域板块指标每日明细列表。

请求参数: 无

响应数据: List<AreaBlockIndicatorDaily>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
sjqkDate String 数据日期(yyyy-MM-dd HH:mm:ss)
xtxx String 线体信息
cjxx String 车间信息
szxx String 室组信息
qyxx String 区域信息
bkxx String 板块信息
zhibxx String 指标信息
mbVal Double 目标值
realVal Double 实际值
sfdbFlag Boolean 是否达标

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "MRJ20261001001",
      "corpCode": "hfca",
      "sjqkDate": "2026-10-01 00:00:00",
      "xtxx": "XT001",
      "cjxx": "CJ001",
      "szxx": "SZ001",
      "qyxx": "QY001",
      "bkxx": "BK001",
      "zhibxx": "ZB001",
      "mbVal": 100.0,
      "realVal": 95.0,
      "sfdbFlag": true
    }
  ],
  "msg": "成功",
  "errCode": null
}

13.2 获取指定板块下看板项目的区域板块指标每日明细(按指标分组) ✏️更新

✏️ 接口更新(本次变更:新增交付板块端点):原按板块拆分为安全、质量、成本 3 个专用端点,本次新增交付(编码 D)板块端点 deliverKanbanDaily,共 4 个端点;板块由端点区分,无需板块入参。

接口路径(按板块 4 个端点):

板块 端点 说明
安全(编码 S) GET /areaBlockIndicatorDaily/list/safetyKanbanDaily 获取安全板块下看板项目的区域板块指标每日明细
质量(编码 Q) GET /areaBlockIndicatorDaily/list/qualityKanbanDaily 获取质量板块下看板项目的区域板块指标每日明细
成本(编码 C) GET /areaBlockIndicatorDaily/list/costKanbanDaily 获取成本板块下看板项目的区域板块指标每日明细
交付(编码 D) GET /areaBlockIndicatorDaily/list/deliverKanbanDaily 获取交付板块下看板项目的区域板块指标每日明细

接口说明: 根据板块端点定位板块信息,查询该板块下是看板项目(sfkbxm=true)的区域板块指标信息列表,再根据列表中的指标到每日明细中按区域、月份获取明细记录。返回结果中每个指标对应一个列表,列表中是月份内每天的记录数据,每天每个指标多条记录的取第一条,没有记录的默认一条实际值为0的记录;指标信息及线体、车间、室组、区域、板块等关联信息均返回名称与编号。

请求参数:

参数名 类型 必传 说明
qyxx String 是 区域信息(区域id),为空时返回空列表
month Integer 否 月份(1-12),为空时默认当前月

响应数据: List<AreaBlockIndicatorDailyGroupDTO>

响应字段说明:

字段 类型 说明
zhibxx String 指标信息id(AreaBlockIndicator id)
zhibmc String 指标名称
bkxx String 板块信息id
bkmc String 板块名称
bkbm String 板块编码
qyxx String 区域信息id
qymc String 区域名称
qybh String 区域编号
xtxx String 线体信息id
xtmc String 线体名称
xtbh String 线体编号
cjxx String 车间信息id
dwmc String 车间名称
dwbh String 车间编号
szxx String 室组信息id
szmc String 室组名称
szbh String 室组编号
dailyList List 该指标在月份内每天的明细记录列表

dailyList 元素字段说明:

字段 类型 说明
id String 记录ID(默认记录无id)
corpCode String 企业编码
sjqkDate String 数据日期(yyyy-MM-dd HH:mm:ss)
xtxx String 线体信息
cjxx String 车间信息
szxx String 室组信息
qyxx String 区域信息
bkxx String 板块信息
zhibxx String 指标信息
realVal Double 实际值(无记录时默认为0)
xtmc String 线体名称(关联 XtLine)
xtbh String 线体编号(关联 XtLine)
dwmc String 车间名称(关联 Workshop)
dwbh String 车间编号(关联 Workshop)
szmc String 室组名称(关联 RoomGroup)
szbh String 室组编号(关联 RoomGroup)
qymc String 区域名称(关联 Area)
qybh String 区域编号(关联 Area)
bkmc String 板块名称(关联 BlockInfo)
bkbm String 板块编码(关联 BlockInfo)
zhibmc String 指标名称(关联 AreaBlockIndicator)

响应示例(安全板块 GET /areaBlockIndicatorDaily/list/safetyKanbanDaily,10月每天取第一条,无记录默认实际值为0):

{
  "success": true,
  "data": [
    {
      "zhibxx": "ZB001",
      "zhibmc": "安全事故数",
      "bkxx": "BK001",
      "bkmc": "安全",
      "bkbm": "S",
      "qyxx": "QY001",
      "qymc": "总装区域",
      "qybh": "QY001",
      "xtxx": "XT001",
      "xtmc": "总装线",
      "xtbh": "XT001",
      "cjxx": "CJ001",
      "dwmc": "总装车间",
      "dwbh": "CJ001",
      "szxx": "SZ001",
      "szmc": "总装室组",
      "szbh": "SZ001",
      "dailyList": [
        {
          "id": "MRJ20261001001",
          "corpCode": "hfca",
          "sjqkDate": "2026-10-01 00:00:00",
          "xtxx": "XT001",
          "cjxx": "CJ001",
          "szxx": "SZ001",
          "qyxx": "QY001",
          "bkxx": "BK001",
          "zhibxx": "ZB001",
          "realVal": 85.0,
          "xtmc": "总装线",
          "xtbh": "XT001",
          "dwmc": "总装车间",
          "dwbh": "CJ001",
          "szmc": "总装室组",
          "szbh": "SZ001",
          "qymc": "总装区域",
          "qybh": "QY001",
          "bkmc": "安全",
          "bkbm": "S",
          "zhibmc": "安全事故数"
        },
        {
          "id": null,
          "corpCode": null,
          "sjqkDate": "2026-10-02 00:00:00",
          "xtxx": "XT001",
          "cjxx": "CJ001",
          "szxx": "SZ001",
          "qyxx": "QY001",
          "bkxx": "BK001",
          "zhibxx": "ZB001",
          "realVal": 0.0,
          "xtmc": null,
          "xtbh": null,
          "dwmc": null,
          "dwbh": null,
          "szmc": null,
          "szbh": null,
          "qymc": null,
          "qybh": null,
          "bkmc": null,
          "bkbm": null,
          "zhibmc": null
        }
      ]
    }
  ],
  "msg": "成功",
  "errCode": null
}

14. 区域员工考勤信息接口

14.1 获取所有区域员工考勤信息列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有区域员工考勤信息列表。

请求参数: 无

响应数据: List<AreaEmployeeAttendance>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
kqrq String 考勤日期(yyyy-MM-dd HH:mm:ss)
xtxx String 线体信息
bcxx String 班次信息
cjxx String 车间信息
szxx String 室组信息
qyxx String 区域信息
bzxx String 班组信息
ydrs Integer 应到人数
sdrs Integer 实到人数
qqrs Integer 缺勤人数
bzrs Integer 病假人数
sjrs Integer 事假人数
njrs Integer 年假人数
cjrs Integer 产假人数
hjrs Integer 婚假人数
sangjrs Integer 丧假人数
tjrs Integer 调休人数
qtjrs Integer 其他假人数

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "KQ20261001001",
      "corpCode": "hfca",
      "kqrq": "2026-10-01 00:00:00",
      "xtxx": "XT001",
      "bcxx": "BC001",
      "cjxx": "CJ001",
      "szxx": "SZ001",
      "qyxx": "QY001",
      "bzxx": "BZ001",
      "ydrs": 20,
      "sdrs": 18,
      "qqrs": 2,
      "bzrs": 1,
      "sjrs": 1,
      "njrs": 0,
      "cjrs": 0,
      "hjrs": 0,
      "sangjrs": 0,
      "tjrs": 0,
      "qtjrs": 0
    }
  ],
  "msg": "成功",
  "errCode": null
}

15. 区域员工考勤明细接口

15.1 获取所有区域员工考勤明细列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有区域员工考勤明细列表。响应中除持久化字段外,还包含职位中文描述(zwDesc)、假别中文描述(jbemDesc)两个计算型 getter 字段。

请求参数: 无

响应数据: List<AreaEmployeeAttendanceDetail>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
kqrq String 考勤日期(yyyy-MM-dd HH:mm:ss)
qyygxx String 区域员工信息
qyxx String 区域信息
bzxx String 班组信息
ygxm String 员工姓名
ygh String 员工号
zw String 职位编号(#1#-区长;#2#-班长;#3#-员工;#4#-安全员;#5#-质量员;#6#-现场员)
zwDesc String 职位中文描述(计算字段)
gangw String 岗位
jbem String 假别编号(#1#-出勤;#2#-正常休息;#3#-离职;...)
jbemDesc String 假别中文描述(计算字段)
jbsc Double 假别时长(小时)
dgryxm String 顶岗人员姓名
stclsh String 首台车流水号
wtclsh String 尾台车流水号
qyygkqxx String 区域员工考勤信息
qyygbhmxxx String 区域员工离职明细
qyyglzmcxx String 区域员工变化明细

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "KQMX20261001001",
      "corpCode": "hfca",
      "kqrq": "2026-10-01 08:00:00",
      "qyygxx": "QYYG001",
      "qyxx": "QY001",
      "bzxx": "BZ001",
      "ygxm": "张三",
      "ygh": "A1001",
      "zw": "#3#",
      "zwDesc": "员工",
      "gangw": "装配工",
      "jbem": "#1#",
      "jbemDesc": "出勤",
      "jbsc": 8.0,
      "stclsh": "LSH001",
      "wtclsh": "LSH100"
    }
  ],
  "msg": "成功",
  "errCode": null
}

15.2 按区域、月份查询每日考勤汇总信息 🆕新增

🆕 新增接口(2026-10-06 之后新建)

接口路径: GET /areaEmployeeAttendanceDetail/summary/daily

接口说明: 按区域、月份查询该月每日考勤汇总信息(按考勤日期分组)。每日总记录条数为区域应到人数(ydrs),假别为出勤的记录条数为实到人数(sdrs)。年份固定取当前年。

请求参数:

参数名 类型 必传 说明
qyxx String 否 区域(Area)id
month Integer 否 月份(1-12),没传默认当前月

响应数据: List<AttendanceDailySummaryDTO>

响应字段说明:

字段 类型 说明
date String 日期(yyyy-MM-dd)
ydrs Integer 应到人数
sdrs Integer 实到人数

响应示例:

{
  "success": true,
  "data": [
    {
      "date": "2026-10-01",
      "ydrs": 20,
      "sdrs": 18
    },
    {
      "date": "2026-10-02",
      "ydrs": 20,
      "sdrs": 19
    }
  ],
  "msg": "成功",
  "errCode": null
}

15.3 按区域、日期查询非出勤考勤明细列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

接口路径: GET /areaEmployeeAttendanceDetail/list/nonAttendance

接口说明: 按区域、日期查询当日非出勤(假别不为出勤)的考勤明细列表,列表关联信息补充完整(区域名称/编号、班组名称/编号)。

请求参数:

参数名 类型 必传 说明
qyxx String 是 区域(Area)id
date String 是 考勤日期(yyyy-MM-dd)

响应数据: List<AreaEmployeeAttendanceDetail>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
kqrq String 考勤日期(yyyy-MM-dd HH:mm:ss)
qyygxx String 区域员工信息
qyxx String 区域信息(区域id)
qymc String 区域名称(关联 Area,Service 填充)
qybh String 区域编号(关联 Area,Service 填充)
bzxx String 班组信息(班组id)
bzmc String 班组名称(关联 Team,Service 填充)
bzbh String 班组编号(关联 Team,Service 填充)
ygxm String 员工姓名
ygh String 员工号
zw String 职位编号
zwDesc String 职位中文描述(计算字段)
gangw String 岗位
jbem String 假别编号
jbemDesc String 假别中文描述(计算字段)
jbsc Double 假别时长(小时)
dgryxm String 顶岗人员姓名
stclsh String 首台车流水号
wtclsh String 尾台车流水号

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "KQMX20261001001",
      "corpCode": "hfca",
      "kqrq": "2026-10-01 08:00:00",
      "qyygxx": "QYYG001",
      "qyxx": "QY001",
      "qymc": "装配区域",
      "qybh": "QY001",
      "bzxx": "BZ001",
      "bzmc": "装配一班",
      "bzbh": "BZ001",
      "ygxm": "张三",
      "ygh": "A1001",
      "zw": "#3#",
      "zwDesc": "员工",
      "gangw": "装配工",
      "jbem": "#4#",
      "jbemDesc": "病假",
      "jbsc": 8.0
    }
  ],
  "msg": "成功",
  "errCode": null
}

16. 区域员工信息接口

16.1 获取所有区域员工信息列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有区域员工信息列表。

请求参数: 无

响应数据: List<AreaEmployee>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
xtxx String 线体信息
cjxx String 车间信息
szxx String 室组信息
qyxx String 区域信息
bzxx String 班组信息
ygxm String 员工姓名
ygh String 员工号
zw String 职位
gangw String 岗位
rzsj String 入职时间
lzsj String 离职时间

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "YG20261001001",
      "corpCode": "hfca",
      "xtxx": "XT001",
      "cjxx": "CJ001",
      "szxx": "SZ001",
      "qyxx": "QY001",
      "bzxx": "BZ001",
      "ygxm": "张三",
      "ygh": "A1001",
      "zw": "员工",
      "gangw": "装配工",
      "rzsj": "2026-01-01 00:00:00"
    }
  ],
  "msg": "成功",
  "errCode": null
}

17. 区域员工变化明细接口

17.1 获取所有区域员工变化明细列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有区域员工变化明细列表。

请求参数: 无

响应数据: List<AreaEmployeeChange>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
qyygxx String 区域员工信息
qyxx String 区域信息
bzxx String 班组信息
zwem String 职位
bhmc String 变化名称
bhsj String 变化时间

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "BH20261001001",
      "corpCode": "hfca",
      "qyygxx": "QYYG001",
      "qyxx": "QY001",
      "bzxx": "BZ001",
      "zwem": "员工",
      "bhmc": "调入",
      "bhsj": "2026-10-01 00:00:00"
    }
  ],
  "msg": "成功",
  "errCode": null
}

18. 区域员工离职明细接口

18.1 获取所有区域员工离职明细列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有区域员工离职明细列表。

请求参数: 无

响应数据: List<AreaEmployeeResignation>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
qyygxx String 区域员工信息
qyxx String 区域信息
bzxx String 班组信息
zwem String 职位
lzrq String 离职日期
lzyy String 离职原因

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "LZ20261001001",
      "corpCode": "hfca",
      "qyygxx": "QYYG001",
      "qyxx": "QY001",
      "bzxx": "BZ001",
      "zwem": "员工",
      "lzrq": "2026-10-01 00:00:00",
      "lzyy": "个人原因"
    }
  ],
  "msg": "成功",
  "errCode": null
}

19. 5S责任图接口

19.1 获取所有5S责任图列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有5S责任图列表。

请求参数: 无

响应数据: List<FiveSMap>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
xtxx String 线体信息
cjxx String 车间信息
szxx String 室组信息
qyxx String 区域信息
bzxx String 班组信息
zrr String 责任人
zrdw String 责任单位
zrqy String 责任区域
zrgw String 责任工位

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "5S20261001001",
      "corpCode": "hfca",
      "xtxx": "XT001",
      "cjxx": "CJ001",
      "szxx": "SZ001",
      "qyxx": "QY001",
      "bzxx": "BZ001",
      "zrr": "张三",
      "zrdw": "总装车间",
      "zrqy": "装配区域",
      "zrgw": "装配工位"
    }
  ],
  "msg": "成功",
  "errCode": null
}

19.2 按区域查询5S责任图列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

接口路径: GET /fiveSMap/list/area

接口说明: 按区域查询该区域下的5S责任图列表。

请求参数:

参数名 类型 必传 说明
qyxx String 是 区域(Area)id

响应数据: List<FiveSMap>(结构同 19.1)

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "5S20261001001",
      "corpCode": "hfca",
      "xtxx": "XT001",
      "cjxx": "CJ001",
      "szxx": "SZ001",
      "qyxx": "QY001",
      "bzxx": "BZ001",
      "zrr": "张三",
      "zrdw": "总装车间",
      "zrqy": "装配区域",
      "zrgw": "装配工位"
    }
  ],
  "msg": "成功",
  "errCode": null
}

20. 安全观察与履职检查接口

20.1 获取所有安全观察与履职检查列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有安全观察与履职检查列表。

请求参数: 无

响应数据: List<SafetyObservation>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
jcrq String 检查日期
jcr String 检查人
jcdw String 检查单位
jcxt String 检查线体
jcqy String 检查区域
jcgw String 检查工位
jcnr String 检查内容
jcjg String 检查结果
zgcs String 整改措施
zgr String 整改人
zgsj String 整改时间

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "AQJC20261001001",
      "corpCode": "hfca",
      "jcrq": "2026-10-01 00:00:00",
      "jcr": "张三",
      "jcdw": "总装车间",
      "jcxt": "B线",
      "jcqy": "装配区域",
      "jcgw": "装配工位",
      "jcnr": "安全检查",
      "jcjg": "合格",
      "zgcs": "无",
      "zgr": "李四",
      "zgsj": "2026-10-01 00:00:00"
    }
  ],
  "msg": "成功",
  "errCode": null
}

20.2 按区域、月份汇总每日安全观察与履职检查信息 🆕新增

🆕 新增接口(2026-10-16 之后新建)

接口路径: GET /safetyObservation/summary/daily

接口说明: 以检查日期(jcrq)为条件月份范围内的明细记录,按天分组汇总:每日明细记录条数为走访工位数(gws),抽查结果(ccjg)为异常(#2#)的记录条数为问题数(wts)。返回每日汇总统计信息,从月初到当前日期(当前月)或月末(其他月份)中缺记录的日期自动补一条工位数和问题数都为0的记录,结果按日期升序。年份固定取当前年。

请求参数:

参数名 类型 必传 说明
qyxx String 否 区域信息(区域id),为空时不限定
month Integer 否 月份(1-12),为空默认当前月

响应数据: List<SafetyObservationDailySummaryDTO>

响应字段说明:

字段 类型 说明
date String 检查日期(yyyy-MM-dd)
gws Integer 走访工位数(当日明细记录条数,无记录时补0)
wts Integer 问题数(当日抽查结果为异常的记录条数,无记录时补0)

响应示例:

{
  "success": true,
  "data": [
    {
      "date": "2026-10-01",
      "gws": 5,
      "wts": 1
    },
    {
      "date": "2026-10-02",
      "gws": 0,
      "wts": 0
    }
  ],
  "msg": "成功",
  "errCode": null
}

20.3 按区域、检查日期查询安全履职检查明细列表 🆕新增

🆕 新增接口(2026-10-16 之后新建)

接口路径: GET /safetyObservation/list/detail

接口说明: 按检查日期(jcrq,必填)查询当日安全履职检查明细列表,区域(qyxx)为空时不限定。响应中除持久化字段外,还包含抽查结果中文描述(ccjgDesc,计算字段),以及由 Service 批量填充的关联信息(区域名称/编号、班组名称/编号、观察工位名称/编号)。

请求参数:

参数名 类型 必传 说明
qyxx String 否 区域信息(区域id),为空时不限定
jcrq String 是 检查日期,格式:yyyy-MM-dd

响应数据: List<SafetyObservation>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
jcrq String 检查日期(yyyy-MM-dd HH:mm:ss)
qyxx String 区域信息(区域id)
qymc String 区域名称(关联 Area,Service 填充)
qybh String 区域编号(关联 Area,Service 填充)
bzxx String 班组信息(班组id)
bzmc String 班组名称(关联 Team,Service 填充)
bzbh String 班组编号(关联 Team,Service 填充)
gcgw String 观察工位(工位id)
gwmc String 工位名称(关联 Workstation,Service 填充)
gwbh String 工位编号(关联 Workstation,Service 填充)
bgcr String 被观察人
ccxm String 抽查项目(枚举,多选)
ccjg String 抽查结果(#1#-正常,#2#-异常,#3#-不涉及)
glyjy String 鼓励与建议
ccjgDesc String 抽查结果中文描述(计算字段)
jlnryy String 记录以下内容及其原因
ibpfgw String 说明

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "AQGC20261001001",
      "corpCode": "hfca",
      "jcrq": "2026-10-01 09:00:00",
      "qyxx": "QY001",
      "qymc": "总装区域",
      "qybh": "QY001",
      "bzxx": "BZ001",
      "bzmc": "装配一班",
      "bzbh": "BZ001",
      "gcgw": "GW001",
      "gwmc": "装配工位",
      "gwbh": "01",
      "bgcr": "张三",
      "ccxm": "#1#,#4#",
      "ccjg": "#2#",
      "ccjgDesc": "异常",
      "jlnryy": "员工未正确佩戴劳保用品",
      "ibpfgw": ""
    }
  ],
  "msg": "成功",
  "errCode": null
}

21. 车间级工作计划接口

21.1 获取所有车间级工作计划列表 🆕新增

🆕 新增接口(2026-10-06 之后新建)

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

接口说明: 获取当前企业下所有车间级工作计划列表。

请求参数: 无

响应数据: List<WorkshopWorkPlan>

响应字段说明:

字段 类型 说明
id String 记录ID
corpCode String 企业编码
jhmc String 计划名称
jhxh String 计划序号
jhnf String 计划年份
jhyf String 计划月份
jhzt String 计划状态
jhfzr String 计划负责人
jhqy String 计划区域
jhksrq String 计划开始日期
jhjsrq String 计划结束日期

响应示例:

{
  "success": true,
  "data": [
    {
      "id": "JH20261001001",
      "corpCode": "hfca",
      "jhmc": "10月总装工作计划",
      "jhxh": "JH001",
      "jhnf": "2026",
      "jhyf": "10",
      "jhzt": "进行中",
      "jhfzr": "张三",
      "jhqy": "装配区域",
      "jhksrq": "2026-10-01 00:00:00",
      "jhjsrq": "2026-10-31 00:00:00"
    }
  ],
  "msg": "成功",
  "errCode": null
}