zcloud_gbs_safetyDutyList/docs/前端联调接口文档.md

安全责任清单 - 前端联调接口文档

基于模板与实例分离的新模型，同一清单可下发给多个公司。

核心变更：清单（task_list）和任务（task_detail）为模板，下发（task_list_issue）和执行（task_execution）为实例。

---

变更总览

序号	接口	变更类型	主要变更点
1	获取清单列表	重构	主表由 task_list_issue 改为 task_list，返回 TaskListCO（纯模板），新增 status 字段
2	新增清单	不变	-
3	修改清单	新增	修改清单模板信息
4	删除清单	新增	删除清单模板
5	开关切换	新增	开启/关闭清单
6	获取任务列表	重构	主表由 task_execution 改为 task_detail，返回 TaskDetailCO（纯模板），传参由 taskIssueId 改为 taskListId，新增 taskStatus 字段
7	批量保存任务	新增	批量新增/修改任务模板
8	获取任务详情	不变	-
9	企业落实情况	重构	路径由 /taskList/issueList 改为 /taskListIssue/list，以 task_list_issue 为主表
10	获取下发记录详情	新增	通过 taskIssueId 获取下发记录详情
11	任务执行列表	重构	路径由 /taskDetail/executionList 改为 /taskExecution/list
12	获取执行记录详情	新增	通过 taskExecutionId 获取执行记录详情
13	反馈周期分组	不变	传参 taskExecutionId
14	反馈列表	不变	传参 taskExecutionId + feedbackPeriodFlag
15	反馈详情	修改	返回 FeedbackInfoCO（含任务信息+反馈信息），非 FeedbackCO
16	编辑反馈	新增	修改反馈内容
17	删除反馈	新增	删除反馈记录
18	企业评价列表	不变	-
19	更新任务评分	重构	路径由 /taskDetail/updateScore 改为 /taskExecution/updateScore
20	提交反馈	不变	-
21	企业任务下发统计	不变	-
22	企业统计（股份端）	新增	按企业统计已完成/已关闭/总任务数
23	关闭清单	修改	传参 taskListId，同步关闭下发表+执行表状态
24	关闭任务	修改	传参 taskDetailId，同步关闭执行表状态
25	任务下发	新增	新增 executeDepartmentId 字段

---

枚举值

枚举	值	说明
task_level	1/2/3	企业级/部门级/班组级
switch_flag	0/1	关闭/开启
task_list.status	1/2/3	进行中/已完成/已关闭
task_detail.task_status	1/2/3	进行中/已完成/已关闭
task_list_issue.status	1/2/3	进行中/已完成/已关闭
issue_status	0/1	未下发/已下发
task_execution.task_status	1/2/3	进行中/已完成/已关闭
task_execution.feedback_status	1/2	正常/异常
feedback_cycle_type	1/2/3/4	每月/每季度/每半年/每年

---

一、获取任务清单列表

POST /safetyDutyList/taskList/list

请求参数

{
  "pageIndex": 1,
  "pageSize": 10,
  "taskListName": "安全",
  "taskLevel": 1
}

字段	类型	必填	说明
pageIndex	Integer	否	页码（默认1）
pageSize	Integer	否	每页条数（默认10）
taskListName	String	否	清单名称（模糊查询）
taskLevel	Integer	否	任务级别：1-企业级 2-部门级 3-班组级

响应字段

{
  "success": true,
  "data": [
    {
      "id": 1,
      "taskListId": "uuid-xxx",
      "taskListName": "安全生产责任清单",
      "taskLevel": 1,
      "responsibilityPost": "安全主管",
      "switchFlag": 1,
      "status": 1,
      "createCorpId": 100,
      "createDepartmentId": 200,
      "createUserId": 300
    }
  ],
  "totalCount": 1,
  "pageSize": 10,
  "pageIndex": 1
}

字段	类型	说明
id	Long	主键
taskListId	String	清单UUID（业务主键）
taskListName	String	清单名称
taskLevel	Integer	任务级别：1-企业级 2-部门级 3-班组级
responsibilityPost	String	责任岗位
switchFlag	Integer	是否启用：0-关 1-开
status	Integer	状态：1-进行中 2-已完成 3-已关闭
createCorpId	Long	创建公司ID
createDepartmentId	Long	创建部门ID
createUserId	Long	创建人ID

---

二、新增任务清单

POST /safetyDutyList/taskList/save

请求参数

{
  "taskListName": "安全生产责任清单",
  "taskLevel": 1,
  "responsibilityPost": "安全主管",
  "switchFlag": 1
}

字段	类型	必填	说明
taskListName	String	是	清单名称
taskLevel	Integer	是	任务级别：1-企业级 2-部门级 3-班组级
responsibilityPost	String	是	责任岗位
switchFlag	Integer	是	是否启用：1-启用 0-不启用

响应字段

同接口一的单条 TaskListCO 对象。

---

三、修改任务清单

POST /safetyDutyList/taskList/edit

请求参数

{
  "taskListId": "uuid-xxx",
  "taskListName": "安全生产责任清单（修改）",
  "taskLevel": 2,
  "responsibilityPost": "安全总监",
  "switchFlag": 1
}

字段	类型	必填	说明
taskListId	String	是	清单UUID（业务主键）
taskListName	String	是	清单名称
taskLevel	Integer	是	任务级别：1-企业级 2-部门级 3-班组级
responsibilityPost	String	是	责任岗位
switchFlag	Integer	是	是否启用：1-启用 0-不启用

响应

{
  "success": true
}

---

四、删除任务清单

POST /safetyDutyList/taskList/delete/{id}

请求参数

字段	类型	必填	说明
id	Long	是	清单主键ID（路径参数）

响应

{
  "success": true
}

---

五、开启/关闭任务清单

POST /safetyDutyList/taskList/switchFlag

调用此接口即表示要关闭任务清单（switchFlag 传 0 关闭）

请求参数

{
  "taskListId": "uuid-xxx",
  "switchFlag": 0
}

字段	类型	必填	说明
taskListId	String	是	清单UUID（业务主键）
switchFlag	Integer	是	开启/关闭：0-关 1-开

响应

{
  "success": true
}

---

六、获取任务列表（模板）

POST /safetyDutyList/taskDetail/list

请求参数

{
  "pageIndex": 1,
  "pageSize": 10,
  "taskListId": "uuid-xxx",
  "taskContent": "巡检",
  "feedbackCycleType": 1
}

字段	类型	必填	说明
pageIndex	Integer	否	页码（默认1）
pageSize	Integer	否	每页条数（默认10）
taskListId	String	是	清单表主键ID
taskContent	String	否	执行内容（模糊查询）
feedbackCycleType	Integer	否	反馈周期类型：1-每月 2-季度 3-半年 4-年

响应字段

{
  "success": true,
  "data": [
    {
      "id": 1,
      "taskDetailId": "uuid-detail-1",
      "taskListId": "uuid-xxx",
      "executeContent": "每日安全巡检",
      "feedbackCycleType": 1,
      "feedbackCycleName": "每月",
      "taskScore": 10.00,
      "taskStatus": 1,
      "taskListName": "安全生产责任清单",
      "taskLevel": 1,
      "responsibilityPost": "安全主管"
    }
  ],
  "totalCount": 1,
  "pageSize": 10,
  "pageIndex": 1
}

字段	类型	说明
id	Long	主键
taskDetailId	String	任务模板UUID
taskListId	String	清单UUID
executeContent	String	执行内容
feedbackCycleType	Integer	反馈周期类型：1-每月 2-季度 3-半年 4-年
feedbackCycleName	String	反馈周期名称
taskScore	BigDecimal	任务分值
taskStatus	Integer	任务状态：1-进行中 2-已完成 3-已关闭
taskListName	String	清单名称
taskLevel	Integer	任务级别
responsibilityPost	String	责任岗位

---

七、批量保存任务

POST /safetyDutyList/taskDetail/saveBatch

传入数组，批量新增/修改任务模板。有 id 为修改，无 id 为新增。

请求参数

[
  {
    "taskListId": "uuid-xxx",
    "taskDetailId": "uuid-detail-1",
    "executeContent": "每日安全巡检",
    "feedbackCycleType": 1,
    "taskScore": 10.00
  },
  {
    "taskListId": "uuid-xxx",
    "executeContent": "每周安全会议",
    "feedbackCycleType": 2,
    "taskScore": 15.00
  }
]

字段	类型	必填	说明
id	Long	否	主键ID（有值则修改，无值则新增）
taskListId	String	是	清单表主键ID
taskDetailId	String	否	任务表ID（修改时传入）
executeContent	String	否	执行内容
feedbackCycleType	Integer	是	反馈周期类型：1-每月 2-季度 3-半年 4-年
taskScore	BigDecimal	否	任务分值

响应字段

返回 TaskDetailCO 数组，字段同接口六的单条对象。

---

八、获取任务详情

GET /safetyDutyList/taskDetail/{detailId}

请求参数

字段	类型	必填	说明
detailId	String	是	任务模板UUID（路径参数）

响应字段

{
  "success": true,
  "data": {
    "id": 1,
    "taskDetailId": "uuid-detail-1",
    "taskListId": "uuid-xxx",
    "taskListName": "安全生产责任清单",
    "taskLevel": 1,
    "responsibilityPost": "安全主管",
    "feedbackCycleType": 1,
    "taskScore": 10.00,
    "executeContent": "每日安全巡检"
  }
}

字段	类型	说明
id	Long	主键ID
taskDetailId	String	任务详情UUID
taskListId	String	清单表主键ID
taskListName	String	清单名称
taskLevel	Integer	任务级别
responsibilityPost	String	责任岗位
feedbackCycleType	Integer	反馈周期类型
taskScore	BigDecimal	任务分值
executeContent	String	执行内容

---

九、企业落实情况（获取所有下发清单列表）

POST /safetyDutyList/taskListIssue/list

请求参数

{
  "pageIndex": 1,
  "pageSize": 10,
  "taskListId": "uuid-xxx",
  "executeCorpId": 100,
  "executeUserId": 300,
  "taskListName": "安全",
  "taskLevel": 1,
  "issueStatus": 1,
  "status": 1,
  "feedbackStatus": 2,
  "scoreStatus": 0
}

字段	类型	必填	说明
pageIndex	Integer	否	页码（默认1）
pageSize	Integer	否	每页条数（默认10）
taskListId	String	否	清单UUID
executeCorpId	Long	否	执行公司ID
executeUserId	Long	否	执行人ID
taskListName	String	否	清单名称（模糊查询）
taskLevel	Integer	否	任务级别：1-企业级 2-部门级 3-班组级
issueStatus	Integer	否	下发状态：0-未下发 1-已下发
status	Integer	否	状态：1-进行中 2-已完成 3-已关闭
feedbackStatus	Integer	否	反馈状态：1-正常 2-异常
scoreStatus	Integer	否	评分状态：0-未评分 1-已评分

响应字段

{
  "success": true,
  "data": [
    {
      "id": 1,
      "taskIssueId": "uuid-issue-1",
      "taskListId": "uuid-xxx",
      "taskListName": "安全生产责任清单",
      "taskLevel": 1,
      "responsibilityPost": "安全主管",
      "executeCorpId": 100,
      "executeCorpName": "XX公司",
      "executeDepartmentId": 200,
      "executeDepartmentName": "安全部",
      "executeUserId": 300,
      "executeUserName": "张三",
      "issueStatus": 1,
      "issueTime": "2026-01-01 00:00:00",
      "periodStartTime": "2026-01-01 00:00:00",
      "periodEndTime": "2026-12-31 23:59:59",
      "status": 1,
      "closeTime": null,
      "ratingScore": 85.50,
      "ratingUserId": 400,
      "ratingUserName": "李四",
      "ratingDepartmentId": 500,
      "ratingDepartmentName": "考核部",
      "taskCount": 5,
      "feedbackStatus": 1,
      "switchFlag": 1
    }
  ],
  "totalCount": 1,
  "pageSize": 10,
  "pageIndex": 1
}

字段	类型	说明
id	Long	主键
taskIssueId	String	下发记录UUID（业务主键）
taskListId	String	清单UUID
taskListName	String	任务清单名称
taskLevel	Integer	任务级别
responsibilityPost	String	责任岗位
executeCorpId	Long	执行公司ID
executeCorpName	String	执行公司名称
executeDepartmentId	Long	执行部门ID
executeDepartmentName	String	执行部门名称
executeUserId	Long	执行人员ID
executeUserName	String	执行人员名称
issueStatus	Integer	下发状态：0-未下发 1-已下发
issueTime	String	下发时间
periodStartTime	String	执行周期开始时间
periodEndTime	String	执行周期结束时间
status	Integer	状态：1-进行中 2-已完成 3-已关闭
closeTime	String	关闭时间
ratingScore	BigDecimal	评分数
ratingUserId	Long	评分人ID
ratingUserName	String	评分人姓名
ratingDepartmentId	Long	评分部门ID
ratingDepartmentName	String	评分部门名称
taskCount	Integer	任务数
feedbackStatus	Integer	反馈状态：1-正常 2-异常
switchFlag	Integer	是否启用：0-关 1-开

---

十、获取清单下发记录详情

GET /safetyDutyList/taskListIssue/{taskIssueId}

请求参数

字段	类型	必填	说明
taskIssueId	String	是	下发记录UUID（路径参数）

响应字段

同接口九的单条 TaskListIssueCO 对象。

---

十一、获取任务执行记录列表

POST /safetyDutyList/taskExecution/list

请求参数

{
  "pageIndex": 1,
  "pageSize": 10,
  "taskIssueId": "uuid-issue-1",
  "taskListId": "uuid-xxx",
  "taskContent": "巡检",
  "feedbackCycleType": "1",
  "feedbackStatus": "1",
  "taskStatus": "1"
}

字段	类型	必填	说明
pageIndex	Integer	否	页码（默认1）
pageSize	Integer	否	每页条数（默认10）
taskIssueId	String	否	清单下发记录UUID
taskListId	String	否	清单UUID
taskContent	String	否	执行内容（模糊查询）
feedbackCycleType	String	否	反馈周期类型：1-每月 2-季度 3-半年 4-年
feedbackStatus	String	否	反馈状态：1-正常 2-异常
taskStatus	String	否	任务状态：1-进行中 2-已完成 3-已关闭

注意：feedbackCycleType、feedbackStatus、taskStatus 类型为 String，非 Integer。

响应字段

{
  "success": true,
  "data": [
    {
      "id": 1,
      "taskExecutionId": "uuid-exec-1",
      "taskIssueId": "uuid-issue-1",
      "taskDetailId": "uuid-detail-1",
      "taskListId": "uuid-xxx",
      "taskStatus": 1,
      "feedbackStatus": 1,
      "taskRating": 8.00,
      "ratingTime": "2026-06-01 10:00:00",
      "ratingDepartmentId": 500,
      "ratingDepartmentName": "考核部",
      "ratingUserId": 400,
      "ratingUserName": "李四",
      "executeContent": "每日安全巡检",
      "feedbackCycleType": 1,
      "taskScore": 10.00,
      "taskListName": "安全生产责任清单",
      "taskLevel": 1,
      "responsibilityPost": "安全主管",
      "feedbackCount": 3,
      "currentPeriodFeedback": 1
    }
  ],
  "totalCount": 1,
  "pageSize": 10,
  "pageIndex": 1
}

字段	类型	说明
id	Long	主键
taskExecutionId	String	任务执行UUID（业务主键）
taskIssueId	String	清单下发记录UUID
taskDetailId	String	任务模板UUID
taskListId	String	清单UUID
taskStatus	Integer	任务状态：1-进行中 2-已完成 3-已关闭
feedbackStatus	Integer	反馈状态：1-正常 2-异常
taskRating	BigDecimal	任务评分
ratingTime	String	评分时间
ratingDepartmentId	Long	评分部门ID
ratingDepartmentName	String	评分部门名称
ratingUserId	Long	评分人ID
ratingUserName	String	评分人姓名
executeContent	String	执行内容
feedbackCycleType	Integer	反馈周期类型
taskScore	BigDecimal	任务分值
taskListName	String	清单名称
taskLevel	Integer	任务级别
responsibilityPost	String	责任岗位
feedbackCount	Integer	反馈次数
currentPeriodFeedback	Integer	当前周期是否已反馈：0-否 1-是

---

十二、获取任务执行记录详情

GET /safetyDutyList/taskExecution/{taskExecutionId}

请求参数

字段	类型	必填	说明
taskExecutionId	String	是	任务执行UUID（路径参数）

响应字段

同接口十一的单条 TaskExecutionCO 对象。

---

十三、获取反馈周期分组列表

POST /safetyDutyList/feedback/periodGroupList

请求参数

{
  "taskExecutionId": "uuid-exec-1",
  "feedbackTimeStart": "2026-01-01",
  "feedbackTimeEnd": "2026-06-30"
}

字段	类型	必填	说明
taskExecutionId	String	是	任务执行业务ID
feedbackTimeStart	String	否	反馈时间开始（格式：yyyy-MM-dd）
feedbackTimeEnd	String	否	反馈时间结束（格式：yyyy-MM-dd）

响应字段

{
  "success": true,
  "data": [
    {
      "taskExecutionId": "uuid-exec-1",
      "feedbackPeriodStartTime": "2026-05-01 00:00:00",
      "feedbackPeriodEndTime": "2026-05-31 23:59:59",
      "feedbackCount": 3,
      "feedbackUserName": "张三",
      "feedbackPeriodFlag": "2026-05"
    }
  ]
}

字段	类型	说明
taskExecutionId	String	任务执行业务ID
feedbackPeriodStartTime	String	反馈周期开始时间
feedbackPeriodEndTime	String	反馈周期结束时间
feedbackCount	Integer	反馈次数（以周期标识为维度统计）
feedbackUserName	String	反馈人姓名
feedbackPeriodFlag	String	周期标识

---

十四、获取反馈列表

POST /safetyDutyList/feedback/list

请求参数

{
  "pageIndex": 1,
  "pageSize": 10,
  "taskExecutionId": "uuid-exec-1",
  "feedbackPeriodFlag": "2026-05"
}

字段	类型	必填	说明
pageIndex	Integer	否	页码（默认1）
pageSize	Integer	否	每页条数（默认10）
taskExecutionId	String	是	任务执行业务ID
feedbackPeriodFlag	String	是	周期标识

响应字段

{
  "success": true,
  "data": [
    {
      "id": 1,
      "feedbackId": "uuid-fb-1",
      "taskDetailId": "uuid-detail-1",
      "taskExecutionId": "uuid-exec-1",
      "taskListId": "uuid-xxx",
      "taskIssueId": "uuid-issue-1",
      "feedbackTime": "2026-05-15 14:30:00",
      "feedbackPeriodStartTime": "2026-05-01 00:00:00",
      "feedbackPeriodEndTime": "2026-05-31 23:59:59",
      "feedbackPeriodFlag": "2026-05",
      "feedbackCycleType": 1,
      "feedbackContent": "已完成本月安全巡检",
      "feedbackUserId": 300,
      "feedbackUserName": "张三",
      "feedbackCorpId": 100,
      "feedbackCorpName": "XX公司",
      "feedbackDepartmentId": 200,
      "feedbackDepartmentName": "安全部",
      "executeContent": "每日安全巡检",
      "taskListName": "安全生产责任清单",
      "createTime": "2026-05-15 14:30:00"
    }
  ],
  "totalCount": 1,
  "pageSize": 10,
  "pageIndex": 1
}

字段	类型	说明
id	Long	主键
feedbackId	String	反馈UUID（业务主键）
taskDetailId	String	任务详情UUID
taskExecutionId	String	任务执行UUID
taskListId	String	任务清单UUID
taskIssueId	String	清单下发记录UUID
feedbackTime	String	反馈时间
feedbackPeriodStartTime	String	反馈周期开始时间
feedbackPeriodEndTime	String	反馈周期结束时间
feedbackPeriodFlag	String	反馈周期标识
feedbackCycleType	Integer	反馈周期类型
feedbackContent	String	反馈内容
feedbackUserId	Long	反馈人ID
feedbackUserName	String	反馈人姓名
feedbackCorpId	Long	反馈人公司ID
feedbackCorpName	String	反馈人公司名称
feedbackDepartmentId	Long	反馈人部门ID
feedbackDepartmentName	String	反馈人部门名称
executeContent	String	执行内容
taskListName	String	清单名称
createTime	String	创建时间

---

十五、获取反馈详情

GET /safetyDutyList/feedback/{feedbackId}

请求参数

字段	类型	必填	说明
feedbackId	String	是	反馈UUID（路径参数）

响应字段

返回 FeedbackInfoCO，包含任务信息和反馈信息。

{
  "success": true,
  "data": {
    "id": 1,
    "feedbackId": "uuid-fb-1",
    "taskDetailId": "uuid-detail-1",
    "executeContent": "每日安全巡检",
    "feedbackCycleType": 1,
    "feedbackContent": "已完成本月安全巡检",
    "feedbackTime": "2026-05-15 14:30:00",
    "feedbackPeriodStartTime": "2026-05-01 00:00:00",
    "feedbackPeriodEndTime": "2026-05-31 23:59:59"
  }
}

字段	类型	说明
id	Long	主键ID
feedbackId	String	反馈UUID
taskDetailId	String	任务详情ID
executeContent	String	执行内容
feedbackCycleType	Integer	反馈周期类型
feedbackContent	String	反馈内容
feedbackTime	String	反馈时间
feedbackPeriodStartTime	String	反馈周期开始时间
feedbackPeriodEndTime	String	反馈周期结束时间

---

十六、编辑反馈

POST /safetyDutyList/feedback/edit

请求参数

{
  "feedbackId": "uuid-fb-1",
  "feedbackContent": "已完成本月安全巡检（修改）"
}

字段	类型	必填	说明
feedbackId	String	是	反馈UUID
feedbackContent	String	是	反馈内容

响应

{
  "success": true
}

---

十七、删除反馈

POST /safetyDutyList/feedback/delete/{id}

请求参数

字段	类型	必填	说明
id	Long	是	反馈主键ID（路径参数）

响应

{
  "success": true
}

---

十八、获取企业评价列表

POST /safetyDutyList/statistics/evaluationList

请求参数

{
  "pageIndex": 1,
  "pageSize": 10,
  "corpName": "XX公司",
  "scoreStatus": 0
}

字段	类型	必填	说明
pageIndex	Integer	否	页码（默认1）
pageSize	Integer	否	每页条数（默认10）
corpName	String	否	企业名称（模糊查询）
scoreStatus	Integer	否	评分状态：0-未评分 1-已评分

响应字段

{
  "success": true,
  "data": [
    {
      "corpId": 100,
      "corpName": "XX公司",
      "pendingScoreCount": 3,
      "scoredCount": 5
    }
  ],
  "totalCount": 1,
  "pageSize": 10,
  "pageIndex": 1
}

字段	类型	说明
corpId	Long	公司ID
corpName	String	企业名称
pendingScoreCount	Integer	待评分清单数量（清单分数为0或空的）
scoredCount	Integer	已评分清单数量（清单分数不为0且不为空的）

---

十九、更新任务评分

POST /safetyDutyList/taskExecution/updateScore

请求参数

{
  "taskExecutionId": "uuid-exec-1",
  "taskRating": 8.00
}

字段	类型	必填	说明
taskExecutionId	String	是	任务执行UUID
taskRating	BigDecimal	是	分数（不能超过任务分值）

响应

{
  "success": true
}

---

二十、提交反馈

POST /safetyDutyList/feedback/save

请求参数

{
  "taskExecutionId": "uuid-exec-1",
  "feedbackContent": "已完成本月安全巡检"
}

字段	类型	必填	说明
taskExecutionId	String	是	任务执行ID
feedbackContent	String	是	反馈内容

响应

{
  "success": true,
  "data": {
    "id": 1,
    "feedbackId": "uuid-fb-1",
    "taskDetailId": "uuid-detail-1",
    "taskExecutionId": "uuid-exec-1",
    "taskListId": "uuid-xxx",
    "taskIssueId": "uuid-issue-1",
    "feedbackTime": "2026-05-15 14:30:00",
    "feedbackPeriodStartTime": "2026-05-01 00:00:00",
    "feedbackPeriodEndTime": "2026-05-31 23:59:59",
    "feedbackPeriodFlag": "2026-05",
    "feedbackCycleType": 1,
    "feedbackContent": "已完成本月安全巡检",
    "feedbackUserId": 300,
    "feedbackUserName": "张三",
    "feedbackCorpId": 100,
    "feedbackCorpName": "XX公司",
    "feedbackDepartmentId": 200,
    "feedbackDepartmentName": "安全部",
    "executeContent": "每日安全巡检",
    "taskListName": "安全生产责任清单",
    "createTime": "2026-05-15 14:30:00"
  }
}

响应为完整 FeedbackCO 对象，字段同接口十四。

---

二十一、获取企业任务下发统计数

POST /safetyDutyList/statistics/issueStatistics

请求参数

{
  "pageIndex": 1,
  "pageSize": 10,
  "corpName": "XX公司"
}

字段	类型	必填	说明
pageIndex	Integer	否	页码（默认1）
pageSize	Integer	否	每页条数（默认10）
corpName	String	否	企业名称（模糊查询）

响应字段

{
  "success": true,
  "data": [
    {
      "corpId": 100,
      "corpName": "XX公司",
      "issueCount": 8
    }
  ],
  "totalCount": 1,
  "pageSize": 10,
  "pageIndex": 1
}

字段	类型	说明
corpId	Long	公司ID
corpName	String	公司名称
issueCount	Integer	任务清单下发数

---

二十二、获取企业统计（股份端）

POST /safetyDutyList/statistics/corpStatistics

请求参数

{
  "pageIndex": 1,
  "pageSize": 10,
  "corpName": "XX公司"
}

字段	类型	必填	说明
pageIndex	Integer	否	页码（默认1）
pageSize	Integer	否	每页条数（默认10）
corpName	String	否	企业名称（模糊查询）

响应字段

{
  "success": true,
  "data": [
    {
      "corpId": 100,
      "corpName": "XX公司",
      "completedTaskCount": 15,
      "closedTaskCount": 3,
      "totalTaskCount": 20
    }
  ],
  "totalCount": 1,
  "pageSize": 10,
  "pageIndex": 1
}

字段	类型	说明
corpId	Long	公司ID
corpName	String	公司名称
completedTaskCount	Integer	已完成任务数
closedTaskCount	Integer	已关闭任务数
totalTaskCount	Integer	年度执行任务总数

---

二十三、关闭清单

POST /safetyDutyList/taskList/close

请求参数

{
  "taskListId": "uuid-xxx"
}

字段	类型	必填	说明
taskListId	String	是	清单业务ID

响应

{
  "success": true
}

业务逻辑

1. 将 task_list.status 更新为 3（已关闭）
2. 同步关闭该清单下所有进行中的下发记录（task_list_issue.status → 3）
3. 同步关闭所有下发记录下进行中的任务执行记录（task_execution.task_status → 3）

---

二十四、关闭任务

POST /safetyDutyList/taskDetail/close

请求参数

{
  "taskDetailId": "uuid-detail-1"
}

字段	类型	必填	说明
taskDetailId	String	是	任务业务ID

响应

{
  "success": true
}

业务逻辑

1. 将 task_detail.task_status 更新为 3（已关闭）
2. 同步关闭关联的所有进行中的任务执行记录（task_execution.task_status → 3）

---

二十五、任务下发

POST /safetyDutyList/taskList/issue

请求参数

{
  "taskListId": "uuid-xxx",
  "executeCorpId": 100,
  "executeDepartmentId": 200,
  "executeUserId": 300,
  "periodStartTime": "2026-01-01 00:00:00",
  "periodEndTime": "2026-12-31 23:59:59"
}

字段	类型	必填	说明
taskListId	String	是	清单UUID（业务主键），需为开启状态的清单
executeCorpId	Long	是	执行公司ID
executeDepartmentId	Long	是	执行部门ID
executeUserId	Long	是	执行人员ID
periodStartTime	LocalDateTime	是	执行周期开始时间（格式：yyyy-MM-dd HH:mm:ss）
periodEndTime	LocalDateTime	是	执行周期结束时间（格式：yyyy-MM-dd HH:mm:ss）

响应

{
  "success": true
}

业务逻辑

1. 在 task_list_issue 表创建下发记录
2. 根据 task_list 关联的 task_detail 模板，在 task_execution 表创建对应的任务执行记录
3. 下发记录的 issue_status 设为 1（已下发）

---

接口路径汇总

序号	接口	路径	Controller
1	获取清单列表	POST /taskList/list	TaskListController
2	新增清单	POST /taskList/save	TaskListController
3	修改清单	POST /taskList/edit	TaskListController
4	删除清单	POST /taskList/delete/{id}	TaskListController
5	开关切换	POST /taskList/switchFlag	TaskListController
6	获取任务列表	POST /taskDetail/list	TaskDetailController
7	批量保存任务	POST /taskDetail/saveBatch	TaskDetailController
8	获取任务详情	GET /taskDetail/{detailId}	TaskDetailController
9	企业落实情况	POST /taskListIssue/list	TaskListIssueController
10	下发记录详情	GET /taskListIssue/{taskIssueId}	TaskListIssueController
11	任务执行列表	POST /taskExecution/list	TaskExecutionController
12	执行记录详情	GET /taskExecution/{taskExecutionId}	TaskExecutionController
13	反馈周期分组	POST /feedback/periodGroupList	FeedbackController
14	反馈列表	POST /feedback/list	FeedbackController
15	反馈详情	GET /feedback/{feedbackId}	FeedbackController
16	编辑反馈	POST /feedback/edit	FeedbackController
17	删除反馈	POST /feedback/delete/{id}	FeedbackController
18	企业评价列表	POST /statistics/evaluationList	StatisticsController
19	更新任务评分	POST /taskExecution/updateScore	TaskExecutionController
20	提交反馈	POST /feedback/save	FeedbackController
21	企业下发统计	POST /statistics/issueStatistics	StatisticsController
22	企业统计（股份端）	POST /statistics/corpStatistics	StatisticsController
23	关闭清单	POST /taskList/close	TaskListController
24	关闭任务	POST /taskDetail/close	TaskDetailController
25	任务下发	POST /taskList/issue	TaskListController

所有路径前缀为 /safetyDutyList。