IPO 看板接口 API 说明文档
本文档梳理 2026-10-06 之后新建的看板相关接口,涵盖 板块信息、停线工位、停线记录、过程确认班组计划、PJO 计划执行、CPS 问题、质量缺陷、车间级工作任务、公告信息、多能工信息 10 个控制器下的看板相关端点。文档格式与《CPS 模块接口 API 说明文档》保持一致。
目录
- 1. 板块信息接口
- 2. 停线工位接口
- 3. 停线记录接口
- 4. 过程确认班组计划接口
- 5. PJO计划执行接口
- 6. CPS问题接口
- 7. 质量缺陷接口
- 8. 车间级工作任务接口
- 9. 公告信息接口
- 10. 多能工信息接口
- 11. 区域记分卡接口
- 12. 区域板块指标信息接口
- 13. 区域板块指标每日明细接口
- 14. 区域员工考勤信息接口
- 15. 区域员工考勤明细接口
- 16. 区域员工信息接口
- 17. 区域员工变化明细接口
- 18. 区域员工离职明细接口
- 19. 5S责任图接口
- 20. 安全观察与履职检查接口
- 21. 车间级工作计划接口
变更记录
标记说明:🆕 新增接口(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
|
| ✏️ | 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}KanbanDaily |
新增接口 | 按板块拆分为安全(S)/质量(Q)/成本(C)3 个专用端点,获取对应板块下看板项目的区域板块指标每日明细;按指标分组返回,每个指标对应月份内每天的记录列表,每天多条记录取第一条,无记录默认实际值为0,关联信息返回名称与编号 |
| 🆕 | 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 |
| 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 |
| endTime | String | 停线结束时间(yyyy-MM-dd HH |
| 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板块编码/名称字段("其他"板块为空)。
接口路径(按板块 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 为空时默认当前年/当前月。
请求参数:
| 参数名 | 类型 | 必传 | 说明 |
|---|---|---|---|
| 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 | 板块编码("其他"板块端点为 null) |
| bkmc | String | 板块名称("其他"板块端点为 null) |
响应示例(物流板块 GET /stopRecord/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
}
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 |
| jhrq | String | 计划日期(yyyy-MM-dd HH |
| 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 |
| jhrq | String | 计划日期(yyyy-MM-dd HH |
| 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 |
| qkxdwk | Date | PJO开展日期(yyyy-MM-dd HH |
| 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 |
| 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 |
| tntpvy | Date | 问题解决时间(yyyy-MM-dd HH |
| 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 |
| createdBy | String | 创建人ID(组织用户) |
| createdByName | String | 创建人姓名(关联组织用户,Service 填充) |
| updatedAt | String | 更新时间(yyyy-MM-dd HH |
| updatedBy | String | 更新人ID(组织用户) |
| updatedByName | String | 更新人姓名(关联组织用户,Service 填充) |
| sjsx | String | 事件属性编号(#0#-内部;#1#-外部) |
| sjsxDesc | String | 事件属性中文描述(计算字段) |
| tcrq | String | 提出日期(yyyy-MM-dd HH |
| 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 |
| 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 |
| createdBy | String | 创建人ID(组织用户) |
| createdByName | String | 创建人姓名(关联组织用户,Service 填充) |
| updatedAt | String | 更新时间(yyyy-MM-dd HH |
| 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 |
| 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 |
| 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 |
| 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 |
| 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 获取指定板块下看板项目的区域板块指标每日明细(按指标分组) 🆕新增
🆕 新增接口(2026-10-16 新建):按板块拆分为 3 个专用端点(安全、质量、成本),板块由端点区分,无需板块入参。
接口路径(按板块 3 个端点):
| 板块 | 端点 | 说明 |
|---|---|---|
| 安全(编码 S) | GET /areaBlockIndicatorDaily/list/safetyKanbanDaily |
获取安全板块下看板项目的区域板块指标每日明细 |
| 质量(编码 Q) | GET /areaBlockIndicatorDaily/list/qualityKanbanDaily |
获取质量板块下看板项目的区域板块指标每日明细 |
| 成本(编码 C) | GET /areaBlockIndicatorDaily/list/costKanbanDaily |
获取成本板块下看板项目的区域板块指标每日明细 |
接口说明: 根据板块端点定位板块信息,查询该板块下是看板项目(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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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#-不涉及) |
| 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
}