zcloud_gbs_safetyDutyList/docs/多公司下发改动分析.md

# 安全责任清单 - 多公司下发改动分析

## 一、需求变更说明

| 项目 | 原需求 | 新需求 |
|------|--------|--------|
| 下发对象 | 一张清单只能下发给一个公司/部门/人员 | 一张清单（含所有任务）作为整体，可下发给多个公司 |
| 数据关系 | 清单与执行方是一对一关系 | 清单与执行方是一对多关系 |
| 表职责 | 清单表和任务表混合了模板定义与执行数据 | 清单表/任务表纯粹作为模板定义，执行数据独立到下发表和任务执行表 |

## 二、当前数据模型分析

### 2.1 当前表结构

```
safety_accountability_task_list（清单表 - 模板+执行混合）
├── task_list_id           → 清单UUID
├── task_list_name         → 清单名称
├── task_level             → 任务级别
├── responsibility_post    → 责任岗位
├── switch_flag            → 开关
├── status                 → 状态（执行相关）
├── period_start_time      → 周期开始时间（执行相关）
├── period_end_time        → 周期结束时间（执行相关）
├── execute_corp_id        → 执行公司ID（执行相关）
├── execute_department_id  → 执行部门ID（执行相关）
├── execute_user_id        → 执行人员ID（执行相关）
├── issue_status           → 下发状态（执行相关）
├── issue_time             → 下发时间（执行相关）
├── rating_score           → 评分数（执行相关）
├── rating_user_id         → 评分人ID（执行相关）
├── rating_department_id   → 评分部门ID（执行相关）
├── close_time             → 关闭时间（执行相关）

safety_accountability_task_detail（任务详情表 - 模板+执行混合）
├── task_detail_id         → 任务UUID
├── task_list_id           → 关联清单UUID
├── execute_content        → 执行内容（模板）
├── feedback_cycle_type    → 反馈周期类型（模板）
├── task_score             → 任务分值（模板）
├── task_status            → 任务状态（执行相关）
├── feedback_status        → 反馈状态（执行相关）
├── task_rating            → 任务评分（执行相关）
├── rating_time            → 评分时间（执行相关）
├── rating_department_id   → 评分部门ID（执行相关）
├── rating_user_id         → 评分人ID（执行相关）

safety_accountability_feedback（反馈表）
├── feedback_id            → 反馈UUID
├── task_detail_id         → 关联任务详情UUID
├── task_list_id           → 关联清单UUID（冗余）
└── ...

safety_accountability_feedback_exception（反馈异常表）
├── feedback_exception_id  → 反馈异常UUID
├── task_detail_id         → 关联任务详情UUID
├── task_list_id           → 关联清单UUID（冗余）
└── ...
```

### 2.2 当前模型的问题

1. **清单表混合了模板定义和执行数据**：`execute_corp_id`、`issue_status`、`status`、`period_*`、`rating_*` 等执行相关字段与模板定义字段混在一起
2. **任务详情表混合了模板定义和执行数据**：`task_status`、`feedback_status`、`task_rating`、`rating_*` 等执行相关字段与模板定义字段混在一起
3. **清单与执行方是一对一关系**：无法支持多公司下发
4. **反馈和异常表直接关联任务模板**：应关联到具体的任务执行实例

## 三、新数据模型设计

### 3.1 核心思路：模板与实例分离

将现有模型拆分为**模板层**和**实例层**：

```
模板层（定义"是什么"）          实例层（定义"执行得怎样"）
┌──────────────┐              ┌──────────────────────┐
│  task_list   │ 1 ────── N  │  task_list_issue     │
│  清单模板     │              │  清单下发记录         │
└──────┬───────┘              └──────────┬───────────┘
       │ 1                               │ 1
       │                                 │
       │ N                               │ N
┌──────┴───────┐              ┌──────────┴───────────┐
│ task_detail  │ 1 ────── N  │  task_execution      │
│ 任务模板      │              │  任务执行记录          │
└──────────────┘              └──────────┬───────────┘
                                         │ 1
                                         │
                                         │ N
                              ┌──────────┴───────────┐
                              │  feedback            │
                              │  执行反馈             │
                              └──────────────────────┘
                                         │ 1
                                         │
                                         │ N
                              ┌──────────┴───────────┐
                              │  feedback_exception  │
                              │  反馈异常             │
                              └──────────────────────┘
```

**关键原则**：
- **清单表（task_list）**：纯粹的清单模板定义，不含任何执行相关字段
- **任务详情表（task_detail）**：纯粹的任务模板定义，不含任何执行相关字段
- **清单下发记录表（task_list_issue）**：清单的一次下发实例，包含执行方、周期、状态、评分
- **任务执行表（task_execution）**：任务的一次执行实例，包含执行状态、反馈状态、评分
- **反馈表/异常表**：直接关联任务执行表，不再关联任务模板表

### 3.2 新增表：清单下发记录表

```sql
CREATE TABLE `safety_accountability_task_list_issue` (
    `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
    `task_issue_id` varchar(64) NOT NULL COMMENT '下发记录UUID（业务主键）',
    `task_list_id` varchar(64) NOT NULL COMMENT '清单UUID（关联清单模板表）',
    `execute_corp_id` bigint DEFAULT NULL COMMENT '执行公司ID',
    `execute_department_id` bigint DEFAULT NULL COMMENT '执行部门ID',
    `execute_user_id` bigint DEFAULT NULL COMMENT '执行人员ID',
    `issue_status` tinyint DEFAULT '0' COMMENT '下发状态：0-未下发 1-已下发',
    `issue_time` datetime DEFAULT NULL COMMENT '下发时间',
    `period_start_time` datetime DEFAULT NULL COMMENT '执行周期开始时间',
    `period_end_time` datetime DEFAULT NULL COMMENT '执行周期结束时间',
    `status` tinyint NOT NULL DEFAULT '1' COMMENT '状态：1-进行中 2-已完成 3-已关闭',
    `close_time` datetime DEFAULT NULL COMMENT '关闭时间',
    `rating_score` decimal(5,2) DEFAULT NULL COMMENT '评分数（汇总所有任务执行评分）',
    `rating_user_id` bigint DEFAULT NULL COMMENT '评分人ID',
    `rating_department_id` bigint DEFAULT NULL COMMENT '评分部门ID',
    `delete_enum` varchar(32) DEFAULT 'FALSE' COMMENT '删除标识：TRUE/FALSE',
    `remarks` varchar(500) DEFAULT NULL COMMENT '备注',
    `create_name` varchar(50) DEFAULT NULL COMMENT '创建人姓名',
    `update_name` varchar(50) DEFAULT NULL COMMENT '更新人姓名',
    `tenant_id` bigint DEFAULT NULL COMMENT '租户ID',
    `org_id` bigint DEFAULT NULL COMMENT '单位ID',
    `version` int DEFAULT '0' COMMENT '版本',
    `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间',
    `create_id` bigint DEFAULT NULL COMMENT '创建人ID',
    `update_id` bigint DEFAULT NULL COMMENT '修改人ID',
    `env` varchar(50) DEFAULT NULL COMMENT '环境标识',
    PRIMARY KEY (`id`),
    UNIQUE KEY `uk_task_issue_id` (`task_issue_id`),
    KEY `idx_task_list_id` (`task_list_id`),
    KEY `idx_execute_corp_id` (`execute_corp_id`),
    KEY `idx_execute_user_id` (`execute_user_id`),
    KEY `idx_status` (`status`),
    KEY `idx_period_time` (`period_start_time`, `period_end_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='清单下发记录表';
```

### 3.3 新增表：任务执行表

```sql
CREATE TABLE `safety_accountability_task_execution` (
    `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
    `task_execution_id` varchar(64) NOT NULL COMMENT '任务执行UUID（业务主键）',
    `task_issue_id` varchar(64) NOT NULL COMMENT '清单下发记录UUID（关联下发记录表）',
    `task_detail_id` varchar(64) NOT NULL COMMENT '任务模板UUID（关联任务详情模板表）',
    `task_list_id` varchar(64) NOT NULL COMMENT '清单UUID（冗余，便于查询）',
    `task_status` tinyint NOT NULL DEFAULT '1' COMMENT '任务状态：1-进行中 2-已完成 3-已关闭',
    `feedback_status` tinyint DEFAULT '1' COMMENT '反馈状态：1-正常 2-异常',
    `task_rating` decimal(5,2) DEFAULT NULL COMMENT '任务评分',
    `rating_time` datetime DEFAULT NULL COMMENT '评分时间',
    `rating_department_id` bigint DEFAULT NULL COMMENT '评分部门ID',
    `rating_user_id` bigint DEFAULT NULL COMMENT '评分人ID',
    `delete_enum` varchar(32) DEFAULT 'FALSE' COMMENT '删除标识：TRUE/FALSE',
    `remarks` varchar(500) DEFAULT NULL COMMENT '备注',
    `create_name` varchar(50) DEFAULT NULL COMMENT '创建人姓名',
    `update_name` varchar(50) DEFAULT NULL COMMENT '更新人姓名',
    `tenant_id` bigint DEFAULT NULL COMMENT '租户ID',
    `org_id` bigint DEFAULT NULL COMMENT '单位ID',
    `version` int DEFAULT '0' COMMENT '版本',
    `create_time` datetime DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
    `update_time` datetime DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '修改时间',
    `create_id` bigint DEFAULT NULL COMMENT '创建人ID',
    `update_id` bigint DEFAULT NULL COMMENT '修改人ID',
    `env` varchar(50) DEFAULT NULL COMMENT '环境标识',
    PRIMARY KEY (`id`),
    UNIQUE KEY `uk_task_execution_id` (`task_execution_id`),
    KEY `idx_task_issue_id` (`task_issue_id`),
    KEY `idx_task_detail_id` (`task_detail_id`),
    KEY `idx_task_list_id` (`task_list_id`),
    KEY `idx_task_status` (`task_status`),
    KEY `idx_feedback_status` (`feedback_status`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='任务执行记录表';
```

### 3.4 修改表：清单表（瘦身为纯模板）

```sql
-- 从 safety_accountability_task_list 中移除执行相关字段：
ALTER TABLE `safety_accountability_task_list`
    DROP COLUMN `execute_corp_id`,
    DROP COLUMN `execute_department_id`,
    DROP COLUMN `execute_user_id`,
    DROP COLUMN `issue_status`,
    DROP COLUMN `issue_time`,
    DROP COLUMN `period_start_time`,
    DROP COLUMN `period_end_time`,
    DROP COLUMN `rating_score`,
    DROP COLUMN `rating_user_id`,
    DROP COLUMN `rating_department_id`,
    DROP COLUMN `status`,
    DROP COLUMN `close_time`;
```

瘦身后的清单表只保留：
```
safety_accountability_task_list（清单模板表）
├── id
├── task_list_id           → 清单UUID
├── task_list_name         → 清单名称
├── task_level             → 任务级别：1-企业级 2-部门级 3-班组级
├── responsibility_post    → 责任岗位
├── switch_flag            → 开启/关闭：0-关 1-开
├── create_corp_id         → 创建公司ID
├── create_department_id   → 创建部门ID
├── create_user_id         → 创建人ID
└── （基础审计字段）
```

### 3.5 修改表：任务详情表（瘦身为纯模板）

```sql
-- 从 safety_accountability_task_detail 中移除执行相关字段：
ALTER TABLE `safety_accountability_task_detail`
    DROP COLUMN `task_status`,
    DROP COLUMN `feedback_status`,
    DROP COLUMN `task_rating`,
    DROP COLUMN `rating_time`,
    DROP COLUMN `rating_department_id`,
    DROP COLUMN `rating_user_id`;
```

瘦身后的任务详情表只保留：
```
safety_accountability_task_detail（任务模板表）
├── id
├── task_detail_id         → 任务UUID
├── task_list_id           → 关联清单UUID
├── execute_content        → 执行内容
├── feedback_cycle_type    → 反馈周期类型：1-每月 2-季度 3-半年 4-年
├── task_score             → 任务分值
└── （基础审计字段）
```

### 3.6 修改表：反馈表（关联任务执行表）

```sql
-- 反馈表改为关联任务执行表
ALTER TABLE `safety_accountability_feedback`
    ADD COLUMN `task_execution_id` varchar(64) DEFAULT NULL COMMENT '任务执行UUID（关联任务执行表）' AFTER `task_detail_id`,
    ADD COLUMN `task_issue_id` varchar(64) DEFAULT NULL COMMENT '清单下发记录UUID（冗余）' AFTER `task_list_id`,
    ADD KEY `idx_task_execution_id` (`task_execution_id`),
    ADD KEY `idx_task_issue_id` (`task_issue_id`);
```

> `task_detail_id` 和 `task_list_id` 可保留作为冗余字段便于查询，也可后续移除。

### 3.7 修改表：反馈异常表（关联任务执行表）

```sql
-- 反馈异常表改为关联任务执行表
ALTER TABLE `safety_accountability_feedback_exception`
    ADD COLUMN `task_execution_id` varchar(64) DEFAULT NULL COMMENT '任务执行UUID（关联任务执行表）' AFTER `task_detail_id`,
    ADD COLUMN `task_issue_id` varchar(64) DEFAULT NULL COMMENT '清单下发记录UUID（冗余）' AFTER `task_list_id`,
    ADD KEY `idx_task_execution_id` (`task_execution_id`),
    ADD KEY `idx_task_issue_id` (`task_issue_id`);
```

## 四、新数据模型总览

### 4.1 表结构变更总览

| 表名 | 变更类型 | 定位 | 说明 |
|------|----------|------|------|
| `safety_accountability_task_list` | **修改** | 模板层 | 移除执行方、下发、周期、状态、评分相关字段，仅保留清单定义 |
| `safety_accountability_task_detail` | **修改** | 模板层 | 移除状态、反馈状态、评分相关字段，仅保留任务定义 |
| `safety_accountability_task_list_issue` | **新增** | 实例层 | 清单下发记录，承载执行方/下发/周期/状态/评分 |
| `safety_accountability_task_execution` | **新增** | 实例层 | 任务执行记录，承载任务执行状态/反馈状态/评分 |
| `safety_accountability_feedback` | **修改** | 实例层 | 新增 `task_execution_id`、`task_issue_id` 字段 |
| `safety_accountability_feedback_exception` | **修改** | 实例层 | 新增 `task_execution_id`、`task_issue_id` 字段 |

### 4.2 字段迁移对照

**清单表 → 下发记录表**

| 原位置（task_list） | 新位置（task_list_issue） | 说明 |
|---------------------|--------------------------|------|
| execute_corp_id | execute_corp_id | 执行公司ID |
| execute_department_id | execute_department_id | 执行部门ID |
| execute_user_id | execute_user_id | 执行人员ID |
| issue_status | issue_status | 下发状态 |
| issue_time | issue_time | 下发时间 |
| period_start_time | period_start_time | 周期开始时间 |
| period_end_time | period_end_time | 周期结束时间 |
| status | status | 状态 |
| close_time | close_time | 关闭时间 |
| rating_score | rating_score | 评分数 |
| rating_user_id | rating_user_id | 评分人ID |
| rating_department_id | rating_department_id | 评分部门ID |

**任务详情表 → 任务执行表**

| 原位置（task_detail） | 新位置（task_execution） | 说明 |
|-----------------------|-------------------------|------|
| task_status | task_status | 任务状态 |
| feedback_status | feedback_status | 反馈状态 |
| task_rating | task_rating | 任务评分 |
| rating_time | rating_time | 评分时间 |
| rating_department_id | rating_department_id | 评分部门ID |
| rating_user_id | rating_user_id | 评分人ID |

### 4.3 完整数据模型关系图

```
┌─────────────────────────┐
│  task_list（清单模板）    │
│  - task_list_id (UK)     │
│  - task_list_name        │
│  - task_level            │
│  - responsibility_post   │
│  - switch_flag           │
│  - create_corp_id        │
└────────┬────────────────┘
         │ 1:N
         │
┌────────┴────────────────┐        ┌──────────────────────────────┐
│  task_detail（任务模板）  │        │  task_list_issue（下发记录）   │
│  - task_detail_id (UK)   │        │  - task_issue_id (UK)         │
│  - task_list_id (FK)     │        │  - task_list_id (FK→模板)     │
│  - execute_content       │        │  - execute_corp_id            │
│  - feedback_cycle_type   │        │  - execute_department_id      │
│  - task_score            │        │  - execute_user_id            │
└──────────────────────────┘        │  - issue_status              │
                                    │  - issue_time                │
         │ 1:N                      │  - period_start_time         │
         │                          │  - period_end_time           │
         │                          │  - status                    │
         │                          │  - close_time                │
         │                          │  - rating_score              │
         │                          │  - rating_user_id            │
         │                          │  - rating_department_id      │
         │                          └──────────┬───────────────────┘
         │                                     │ 1:N
         │                                     │
         │           ┌─────────────────────────┴───────────────────┐
         │           │  task_execution（任务执行记录）                 │
         │           │  - task_execution_id (UK)                    │
         ├───────────│  - task_issue_id (FK→下发记录)                │
         │  N:1      │  - task_detail_id (FK→任务模板)              │
         │           │  - task_list_id (冗余FK→清单模板)             │
         │           │  - task_status                               │
         │           │  - feedback_status                           │
         │           │  - task_rating                               │
         │           │  - rating_time                               │
         │           │  - rating_department_id                      │
         │           │  - rating_user_id                            │
         │           └──────────────────────┬──────────────────────┘
         │                                  │ 1:N
         │                                  │
         │                   ┌──────────────┴──────────────┐
         │                   │                             │
         │           ┌───────┴────────┐          ┌────────┴──────────┐
         │           │  feedback      │          │  feedback_        │
         │           │  （执行反馈）    │          │  exception        │
         │           │  - feedback_id │          │  （反馈异常）       │
         │           │  - task_       │          │  - feedback_      │
         │           │    execution_id│          │    exception_id   │
         │           │  - task_list_  │          │  - task_          │
         │           │    issue_id    │          │    execution_id   │
         │           │  - task_detail_│          │  - task_list_     │
         │           │    id (冗余)   │          │    issue_id       │
         │           │  - task_list_id│          │  - task_detail_id │
         │           │    (冗余)      │          │    (冗余)         │
         │           └────────────────┘          └───────────────────┘
         │
  （task_detail 与 task_execution 通过 task_detail_id 关联，
    同一任务模板可被多个下发记录实例化为多条执行记录）
```

## 五、代码改动点

### 5.1 领域层（web-domain）

| 文件 | 改动类型 | 说明 |
|------|----------|------|
| `domain/model/tasklist/TaskListE.java` | 修改 | 移除执行方、下发、周期、状态、评分相关字段 |
| `domain/model/tasklist/TaskDetailE.java` | 修改 | 移除状态、反馈状态、评分相关字段，仅保留模板字段 |
| `domain/model/tasklist/TaskListIssueE.java` | **新增** | 清单下发记录领域模型 |
| `domain/model/tasklist/TaskExecutionE.java` | **新增** | 任务执行记录领域模型 |
| `domain/gateway/tasklist/TaskListIssueGateway.java` | **新增** | 清单下发记录网关接口 |
| `domain/gateway/tasklist/TaskExecutionGateway.java` | **新增** | 任务执行记录网关接口 |
| `domain/gateway/tasklist/TaskListGateway.java` | 修改 | 移除 `listExpiredInProgress`、`listIssuedWithPeriod` 等方法（迁移到 TaskListIssueGateway） |
| `domain/gateway/tasklist/TaskDetailGateway.java` | 修改 | 移除 `listInProgress` 等方法（迁移到 TaskExecutionGateway） |
| `domain/model/tasklist/FeedbackE.java` | 修改 | 新增 `taskExecutionId`、`taskListIssueId` 字段 |
| `domain/model/tasklist/FeedbackExceptionE.java` | 修改 | 新增 `taskExecutionId`、`taskListIssueId` 字段 |

### 5.2 基础设施层（web-infrastructure）

| 文件 | 改动类型 | 说明 |
|------|----------|------|
| `persistence/dataobject/tasklist/TaskListDO.java` | 修改 | 移除执行方、下发、周期、状态、评分相关字段 |
| `persistence/dataobject/tasklist/TaskDetailDO.java` | 修改 | 移除状态、反馈状态、评分相关字段 |
| `persistence/dataobject/tasklist/TaskListIssueDO.java` | **新增** | 清单下发记录数据对象 |
| `persistence/dataobject/tasklist/TaskExecutionDO.java` | **新增** | 任务执行记录数据对象 |
| `persistence/dataobject/tasklist/FeedbackDO.java` | 修改 | 新增 `taskExecutionId`、`taskListIssueId` 字段 |
| `persistence/dataobject/tasklist/FeedbackExceptionDO.java` | 修改 | 新增 `taskExecutionId`、`taskListIssueId` 字段 |
| `persistence/mapper/tasklist/TaskListMapper.xml` | 修改 | 移除执行方相关联表查询和统计SQL |
| `persistence/mapper/tasklist/TaskDetailMapper.xml` | 修改 | 移除执行状态相关查询 |
| `persistence/mapper/tasklist/TaskListIssueMapper.java` | **新增** | 清单下发记录Mapper接口 |
| `persistence/mapper/tasklist/TaskListIssueMapper.xml` | **新增** | 清单下发记录Mapper XML（含联表查询和统计SQL） |
| `persistence/mapper/tasklist/TaskExecutionMapper.java` | **新增** | 任务执行记录Mapper接口 |
| `persistence/mapper/tasklist/TaskExecutionMapper.xml` | **新增** | 任务执行记录Mapper XML |
| `persistence/repository/tasklist/TaskListIssueRepository.java` | **新增** | 清单下发记录Repository |
| `persistence/repository/tasklist/TaskExecutionRepository.java` | **新增** | 任务执行记录Repository |
| `gatewayimpl/tasklist/TaskListIssueGatewayImpl.java` | **新增** | 清单下发记录网关实现 |
| `gatewayimpl/tasklist/TaskExecutionGatewayImpl.java` | **新增** | 任务执行记录网关实现 |
| `gatewayimpl/tasklist/TaskListGatewayImpl.java` | 修改 | 移除与执行方相关的方法实现 |
| `gatewayimpl/tasklist/TaskDetailGatewayImpl.java` | 修改 | 移除与执行状态相关的方法实现 |

### 5.3 客户端层（web-client）

| 文件 | 改动类型 | 说明 |
|------|----------|------|
| `dto/clientobject/tasklist/TaskListCO.java` | 修改 | 移除执行方、下发、周期、状态、评分相关字段 |
| `dto/clientobject/tasklist/TaskDetailCO.java` | 修改 | 移除状态、反馈状态、评分相关字段 |
| `dto/clientobject/tasklist/TaskListIssueCO.java` | **新增** | 清单下发记录客户端对象 |
| `dto/clientobject/tasklist/TaskExecutionCO.java` | **新增** | 任务执行记录客户端对象 |
| `dto/tasklist/TaskListIssueCmd.java` | 修改 | 改为支持多公司下发（接收公司列表） |
| `dto/tasklist/TaskListPageQry.java` | 修改 | 移除 executeCorpId、executeUserId 查询条件 |
| `dto/tasklist/TaskListIssuePageQry.java` | **新增** | 下发记录分页查询参数 |
| `dto/tasklist/TaskExecutionPageQry.java` | **新增** | 任务执行记录分页查询参数 |
| `dto/tasklist/TaskDetailUpdateScoreCmd.java` | 修改 | 改为传 `taskExecutionId` 而非 `taskDetailId` |

### 5.4 应用层（web-app）

| 文件 | 改动类型 | 说明 |
|------|----------|------|
| `command/tasklist/TaskListIssueExe.java` | **重写** | 核心改动：下发时为每个公司创建一条下发记录，并为每条记录复制所有任务模板为任务执行记录 |
| `command/tasklist/TaskListCloseExe.java` | 修改 | 关闭下发记录而非清单 |
| `command/tasklist/TaskListStatusUpdateExe.java` | 修改 | 定时任务1：查询并更新过期的下发记录和任务执行记录 |
| `command/tasklist/FeedbackExceptionCheckExe.java` | 修改 | 定时任务2：查询已下发的下发记录，检查任务执行记录的反馈 |
| `command/tasklist/TaskDetailUpdateScoreExe.java` | 修改 | 评分操作的是任务执行记录，评分汇总同步到下发记录 |
| `command/tasklist/TaskListAddExe.java` | 修改 | 新增清单时不再设置下发相关字段 |
| `command/tasklist/TaskListUpdateExe.java` | 修改 | 修改清单时不再涉及执行方字段 |
| `command/tasklist/TaskListSwitchExe.java` | 修改 | 关闭清单时需考虑是否影响所有下发记录 |
| `command/tasklist/TaskListRemoveExe.java` | 修改 | 删除清单时需级联删除下发记录和任务执行记录 |
| `command/tasklist/TaskDetailSaveExe.java` | 修改 | 保存任务模板，不再涉及执行状态 |
| `command/tasklist/TaskDetailSaveBatchExe.java` | 修改 | 批量保存任务模板 |
| `command/tasklist/TaskDetailEditExe.java` | 修改 | 编辑任务模板 |
| `command/tasklist/TaskDetailCloseExe.java` | 修改 | 关闭任务执行记录而非任务模板 |
| `command/tasklist/FeedbackAddExe.java` | 修改 | 反馈关联到任务执行记录 |
| `command/tasklist/FeedbackDeleteExe.java` | 修改 | 删除反馈关联到任务执行记录 |
| `command/tasklist/FeedbackEditExe.java` | 修改 | 编辑反馈关联到任务执行记录 |
| `command/query/tasklist/TaskListQueryExe.java` | 修改 | 清单列表查询不再关联执行方信息 |
| `command/query/tasklist/TaskDetailQueryExe.java` | 修改 | 任务查询拆分为模板查询和执行记录查询 |
| `command/query/tasklist/TaskListIssueQueryExe.java` | **新增** | 下发记录查询执行器 |
| `command/query/tasklist/TaskExecutionQueryExe.java` | **新增** | 任务执行记录查询执行器 |
| `command/query/tasklist/StatisticsQueryExe.java` | 修改 | 统计SQL改为基于下发记录表 |
| `command/query/tasklist/FeedbackQueryExe.java` | 修改 | 反馈查询关联到任务执行记录 |

### 5.5 适配层（web-adapter）

| 文件 | 改动类型 | 说明 |
|------|----------|------|
| `web/tasklist/TaskListController.java` | 修改 | 下发接口参数变更，清单CRUD仅操作模板 |
| `web/tasklist/TaskListIssueController.java` | **新增** | 清单下发记录控制器（查询/关闭下发记录等） |
| `web/tasklist/TaskDetailController.java` | 修改 | 任务模板CRUD + 评分/关闭改为操作任务执行记录 |
| `web/tasklist/TaskExecutionController.java` | **新增** | 任务执行记录控制器（查询/关闭/评分等） |
| `web/tasklist/FeedbackController.java` | 修改 | 反馈接口关联到任务执行记录 |

## 六、核心业务逻辑变更

### 6.1 下发流程（变更最大）

**原流程**：
1. 选择清单 → 选择一个公司/部门/人员 → 设置周期 → 更新清单的执行方字段和下发状态

**新流程**：
1. 选择清单 → 选择多个公司 → 设置周期
2. 为每个公司创建一条 `task_list_issue` 记录（含执行方、周期、下发状态）
3. 为每条下发记录，遍历清单下所有 `task_detail`（任务模板），创建对应的 `task_execution`（任务执行记录）
4. 清单模板本身不变

### 6.2 反馈流程

**原流程**：反馈关联到 `task_detail_id`

**新流程**：反馈关联到 `task_execution_id`（任务执行记录），同时冗余 `task_issue_id` 和 `task_detail_id`

### 6.3 评分流程

**原流程**：对任务评分 → 汇总到清单的 `rating_score`

**新流程**：
1. 对任务执行记录（`task_execution`）评分
2. 检查该下发记录下所有任务执行记录是否都已评分
3. 若全部已评分 → 汇总到下发记录（`task_list_issue`）的 `rating_score`

### 6.4 定时任务1（过期状态更新）

**原流程**：查询 `task_list` 中 `status=1` 且过期的清单 → 更新清单和任务状态

**新流程**：查询 `task_issue` 中 `status=1` 且过期的下发记录 → 更新下发记录状态和对应任务执行记录状态

### 6.5 定时任务2（反馈异常检测）

**原流程**：查询已下发的清单 → 检查任务反馈

**新流程**：查询已下发的下发记录 → 检查对应任务执行记录的反馈

### 6.6 统计查询

**原流程**：按 `task_list.execute_corp_id` 分组统计

**新流程**：按 `task_issue.execute_corp_id` 分组统计

### 6.7 清单修改对已下发记录的影响

修改清单模板（增删改任务）时，需要考虑是否影响已下发的记录：
- **方案A（推荐）**：已下发的记录不受影响，修改模板只影响后续新下发
- **方案B**：修改模板时同步更新所有进行中的下发记录（复杂度高）

## 七、接口变更

### 7.1 清单模板接口（简化）

| 接口 | 变更类型 | 说明 |
|------|----------|------|
| `POST /taskList/list` | 修改 | 返回数据移除执行方相关字段 |
| `POST /taskList/save` | 修改 | 仅保存清单模板 |
| `POST /taskList/edit` | 修改 | 仅修改清单模板 |
| `POST /taskList/delete/{id}` | 修改 | 删除时级联检查下发记录 |
| `POST /taskList/switchFlag` | 修改 | 开关仅影响模板 |
| `POST /taskList/issue` | **重写** | 参数从单个公司改为公司列表 |

### 7.2 清单下发记录接口（新增）

| 接口 | 变更类型 | 说明 |
|------|----------|------|
| `POST /taskListIssue/list` | **新增** | 查询下发记录列表 |
| `GET /taskListIssue/{issueId}` | **新增** | 获取下发记录详情 |
| `POST /taskListIssue/close` | **新增** | 关闭某条下发记录 |

### 7.3 任务模板接口（简化）

| 接口 | 变更类型 | 说明 |
|------|----------|------|
| `POST /taskDetail/save` | 修改 | 仅保存任务模板 |
| `POST /taskDetail/saveBatch` | 修改 | 仅批量保存任务模板 |
| `GET /taskDetail/{detailId}` | 修改 | 获取任务模板详情 |

### 7.4 任务执行记录接口（新增）

| 接口 | 变更类型 | 说明 |
|------|----------|------|
| `POST /taskExecution/list` | **新增** | 查询任务执行记录列表 |
| `GET /taskExecution/{executionId}` | **新增** | 获取任务执行记录详情 |
| `POST /taskExecution/close` | **新增** | 关闭任务执行记录 |
| `POST /taskExecution/updateScore` | **新增** | 对任务执行记录评分 |

### 7.5 反馈接口（修改）

| 接口 | 变更类型 | 说明 |
|------|----------|------|
| `POST /feedback/add` | 修改 | 关联到 `taskExecutionId` |
| `POST /feedback/edit` | 修改 | 关联到 `taskExecutionId` |
| `POST /feedback/list` | 修改 | 按 `taskExecutionId` 查询 |

### 7.6 统计接口（修改）

| 接口 | 变更类型 | 说明 |
|------|----------|------|
| 统计相关接口 | 修改 | 改为基于下发记录表统计 |

## 八、数据迁移方案

```sql
-- =============================================
-- 1. 创建新表
-- =============================================

-- 1.1 创建清单下发记录表（见 3.2）
-- 1.2 创建任务执行记录表（见 3.3）

-- =============================================
-- 2. 迁移清单执行数据 → 下发记录表
-- =============================================
INSERT INTO safety_accountability_task_list_issue (
    task_issue_id, task_list_id,
    execute_corp_id, execute_department_id, execute_user_id,
    issue_status, issue_time, period_start_time, period_end_time,
    status, close_time, rating_score, rating_user_id, rating_department_id,
    delete_enum, remarks, create_name, update_name,
    tenant_id, org_id, version, create_time, update_time, create_id, update_id, env
)
SELECT
    task_list_id AS task_issue_id,  -- 用原task_list_id作为下发记录ID，保持兼容
    task_list_id,
    execute_corp_id, execute_department_id, execute_user_id,
    issue_status, issue_time, period_start_time, period_end_time,
    status, close_time, rating_score, rating_user_id, rating_department_id,
    delete_enum, remarks, create_name, update_name,
    tenant_id, org_id, version, create_time, update_time, create_id, update_id, env
FROM safety_accountability_task_list
WHERE issue_status = 1 AND delete_enum = 'FALSE';

-- =============================================
-- 3. 迁移任务执行数据 → 任务执行记录表
-- =============================================
INSERT INTO safety_accountability_task_execution (
    task_execution_id, task_issue_id, task_detail_id, task_list_id,
    task_status, feedback_status, task_rating, rating_time,
    rating_department_id, rating_user_id,
    delete_enum, remarks, create_name, update_name,
    tenant_id, org_id, version, create_time, update_time, create_id, update_id, env
)
SELECT
    td.task_detail_id AS task_execution_id,  -- 用原task_detail_id作为执行记录ID
    td.task_list_id AS task_issue_id,         -- 关联到下发记录
    td.task_detail_id,                        -- 关联到任务模板
    td.task_list_id,
    td.task_status, td.feedback_status, td.task_rating, td.rating_time,
    td.rating_department_id, td.rating_user_id,
    td.delete_enum, td.remarks, td.create_name, td.update_name,
    td.tenant_id, td.org_id, td.version, td.create_time, td.update_time, td.create_id, td.update_id, td.env
FROM safety_accountability_task_detail td
INNER JOIN safety_accountability_task_list tl ON td.task_list_id = tl.task_list_id
WHERE tl.issue_status = 1 AND td.delete_enum = 'FALSE';

-- =============================================
-- 4. 补充反馈表关联字段
-- =============================================
UPDATE safety_accountability_feedback fb
INNER JOIN safety_accountability_task_execution te ON fb.task_detail_id = te.task_detail_id
SET fb.task_execution_id = te.task_execution_id,
    fb.task_issue_id = te.task_issue_id
WHERE fb.delete_enum = 'FALSE';

-- =============================================
-- 5. 补充反馈异常表关联字段
-- =============================================
UPDATE safety_accountability_feedback_exception fe
INNER JOIN safety_accountability_task_execution te ON fe.task_detail_id = te.task_detail_id
SET fe.task_execution_id = te.task_execution_id,
    fe.task_issue_id = te.task_issue_id
WHERE fe.delete_enum = 'FALSE';

-- =============================================
-- 6. 迁移完成后，清理原表中的执行相关字段
-- =============================================
-- 见 3.4 和 3.5 的 ALTER TABLE 语句
```

## 九、改动优先级与建议

### 高优先级（核心改动）
1. 创建 `task_list_issue` 表和 `task_execution` 表及对应的领域模型、网关、Repository
2. 重写 `TaskListIssueExe`（下发逻辑：创建下发记录 + 复制任务模板为执行记录）
3. 新增 `TaskExecutionUpdateScoreExe`（评分操作任务执行记录，汇总同步到下发记录）
4. 修改 `TaskListStatusUpdateExe`（定时任务1：操作下发记录和任务执行记录）
5. 修改 `FeedbackExceptionCheckExe`（定时任务2：操作下发记录和任务执行记录）

### 中优先级（查询和统计）
6. 修改所有 Mapper XML 中的联表查询和统计 SQL
7. 修改查询执行器（TaskListQueryExe、TaskDetailQueryExe、StatisticsQueryExe）
8. 新增下发记录和任务执行记录的查询接口
9. 修改反馈相关查询（关联到任务执行记录）

### 低优先级（DTO和前端适配）
10. 修改所有 DTO/CO 对象
11. 修改 Controller 接口
12. 前端页面适配