zcloud_gbs
/
zcloud_gbs_safetyDutyList
16
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
zcloud_gbs_safetyDutyList/docs/安全责任清单应用数据库设计文档.md

33 KiB
Raw Permalink Blame History

安全责任清单应用数据库设计文档

1. 概述

本文档描述了安全责任清单应用的数据库设计。该系统用于管理企业安全责任清单的全流程，包括清单模板管理、任务模板管理、清单下发、任务执行、执行反馈、反馈异常检测等功能。系统采用模板与实例分离的设计，清单与任务作为模板可下发给多个公司，支持多租户、多组织、数据权限控制，涵盖清单创建、下发、执行、反馈、评分、异常检测等核心业务。

1.1 核心设计思路

  • 模板与实例分离：task_list（清单模板）与 task_list_issue（下发记录）分离，task_detail（任务模板）与 task_execution（执行记录）分离
  • 一对多关系：一个清单模板可下发给多个公司，生成多条下发记录；一个任务模板对应多条执行记录
  • 反馈周期机制：根据反馈周期类型（月/季/半年/年）自动生成周期标识，用于分组统计和异常检测
  • 异常自动检测：定时任务每月1日0时检测上一周期是否有反馈，无反馈则记录异常

1.2 表关系概览

task_list (清单模板)
  ├── task_detail (任务模板，一对多)
  └── task_list_issue (下发记录，一对多)
        ├── task_execution (执行记录，一对多)
        ├── feedback (反馈记录，一对多)
        └── feedback_exception (反馈异常，一对多)

2. 数据库表设计

2.1 safety_accountability_task_list（任务清单表）

任务清单表用于存储安全责任清单的模板信息，包括清单名称、任务级别、责任岗位、开关状态等。作为模板，可被多次下发给不同公司。

2.1.1 表结构

字段名 类型 长度 允许空 说明 备注
id BIGINT - 否 主键 ID 自增
task_list_id VARCHAR 64 否 清单 UUID 业务主键，UUID 生成
task_list_name VARCHAR 255 否 清单名称
task_level TINYINT - 否 任务级别 1-企业级 2-部门级 3-班组级
responsibility_post VARCHAR 255 否 责任岗位
switch_flag TINYINT 1 否 开启/关闭 0-关 1-开，默认1
create_corp_id BIGINT - 是 创建公司 ID 外键
create_department_id BIGINT - 是 创建部门 ID 外键
create_user_id BIGINT - 是 创建人 ID 外键
status TINYINT - 否 状态 1-进行中 2-已完成 3-已关闭，默认1
delete_enum VARCHAR 32 是 删除标识 TRUE-已删除，FALSE-未删除
remarks VARCHAR 500 是 备注
create_name VARCHAR 50 是 创建人姓名 冗余字段
update_name VARCHAR 50 是 更新人姓名 冗余字段
tenant_id BIGINT - 是 租户 ID 多租户字段
org_id BIGINT - 是 组织 ID 组织字段
version INT - 是 版本号 乐观锁版本号，默认0
create_time DATETIME - 是 创建时间 默认当前时间
update_time DATETIME - 是 更新时间 自动更新
create_id BIGINT - 是 创建人 ID 外键
update_id BIGINT - 是 更新人 ID 外键
env VARCHAR 50 是 环境标识

2.1.2 建表语句

CREATE TABLE `safety_accountability_task_list` (
    `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
    `task_list_id` varchar(64) NOT NULL COMMENT '清单UUID（业务主键）',
    `task_list_name` varchar(255) NOT NULL COMMENT '清单名称',
    `task_level` tinyint NOT NULL COMMENT '任务级别：1-企业级 2-部门级 3-班组级',
    `responsibility_post` varchar(255) NOT NULL COMMENT '责任岗位',
    `switch_flag` tinyint(1) NOT NULL DEFAULT '1' COMMENT '开启/关闭：0-关 1-开',
    `create_corp_id` bigint DEFAULT NULL COMMENT '创建公司ID',
    `create_department_id` bigint DEFAULT NULL COMMENT '创建部门ID',
    `create_user_id` bigint DEFAULT NULL COMMENT '创建人ID',
    `status` tinyint NOT NULL DEFAULT '1' COMMENT '状态：1-进行中 2-已完成 3-已关闭',
    `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_list_id` (`task_list_id`),
    KEY `idx_create_corp_id` (`create_corp_id`),
    KEY `idx_status_task_list_id` (`task_list_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='任务清单表';

2.1.3 索引设计

索引名 索引类型 字段 说明
PRIMARY 主键索引 id 主键
uk_task_list_id 唯一索引 task_list_id 清单业务主键唯一
idx_create_corp_id 普通索引 create_corp_id 按创建公司查询
idx_status_task_list_id 普通索引 task_list_id 按状态和清单ID查询

2.2 safety_accountability_task_detail（任务清单详细表）

任务清单详细表用于存储清单下的任务模板信息，包括执行内容、反馈周期类型、任务分值等。每个清单可包含多个任务模板。

2.2.1 表结构

字段名 类型 长度 允许空 说明 备注
id BIGINT - 否 主键 ID 自增
task_detail_id VARCHAR 64 否 任务详情 UUID 业务主键，UUID 生成
task_list_id VARCHAR 64 否 任务清单主键 外键，关联 task_list 表
execute_content TEXT - 是 执行内容
feedback_cycle_type TINYINT - 否 反馈周期类型 1-每月 2-季度 3-半年 4-年
task_score DECIMAL 5,2 是 任务分值
task_status TINYINT - 否 任务状态 1-进行中 2-已完成 3-已关闭，默认1
delete_enum VARCHAR 32 是 删除标识 TRUE-已删除，FALSE-未删除
remarks VARCHAR 500 是 备注
create_name VARCHAR 50 是 创建人姓名 冗余字段
update_name VARCHAR 50 是 更新人姓名 冗余字段
tenant_id BIGINT - 是 租户 ID 多租户字段
org_id BIGINT - 是 组织 ID 组织字段
version INT - 是 版本号 乐观锁版本号，默认0
create_time DATETIME - 是 创建时间 默认当前时间
update_time DATETIME - 是 更新时间 自动更新
create_id BIGINT - 是 创建人 ID 外键
update_id BIGINT - 是 更新人 ID 外键
env VARCHAR 50 是 环境标识

2.2.2 建表语句

CREATE TABLE `safety_accountability_task_detail` (
    `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
    `task_detail_id` varchar(64) NOT NULL COMMENT '任务详情UUID（业务主键）',
    `task_list_id` varchar(64) NOT NULL COMMENT '任务清单主键（关联任务清单表）',
    `execute_content` text COMMENT '执行内容',
    `feedback_cycle_type` tinyint NOT NULL COMMENT '反馈周期类型：1-每月 2-季度 3-半年 4-年',
    `task_score` decimal(5,2) DEFAULT NULL COMMENT '任务分值',
    `task_status` tinyint NOT NULL DEFAULT '1' COMMENT '任务状态：1-进行中 2-已完成 3-已关闭',
    `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_detail_id` (`task_detail_id`),
    KEY `idx_task_list_id` (`task_list_id`),
    KEY `idx_task_list_status` (`task_list_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='任务清单详细表';

2.2.3 索引设计

索引名 索引类型 字段 说明
PRIMARY 主键索引 id 主键
uk_task_detail_id 唯一索引 task_detail_id 任务详情业务主键唯一
idx_task_list_id 普通索引 task_list_id 按清单ID查询任务
idx_task_list_status 普通索引 task_list_id 按清单ID和状态查询

2.3 safety_accountability_task_list_issue（清单下发记录表）

清单下发记录表用于存储清单下发给具体公司/部门/人员的记录信息，包括执行周期、下发状态、评分等。一个清单模板可下发给多个公司，每条下发记录对应一组任务执行记录。

2.3.1 表结构

字段名 类型 长度 允许空 说明 备注
id BIGINT - 否 主键 ID 自增
task_issue_id VARCHAR 64 否 下发记录 UUID 业务主键，UUID 生成
task_list_id VARCHAR 64 否 清单 UUID 外键，关联 task_list 表
execute_corp_id BIGINT - 是 执行公司 ID 外键
execute_department_id BIGINT - 是 执行部门 ID 外键
execute_user_id BIGINT - 是 执行人员 ID 外键
issue_status TINYINT - 是 下发状态 0-未下发 1-已下发，默认0
issue_time DATETIME - 是 下发时间
issue_corp_id BIGINT - 是 下发公司 ID 外键
issue_department_id BIGINT - 是 下发部门 ID 外键
issue_user_id BIGINT - 是 下发人员 ID 外键
period_start_time DATETIME - 是 执行周期开始时间
period_end_time DATETIME - 是 执行周期结束时间
status TINYINT - 否 状态 1-进行中 2-已完成 3-已关闭，默认1
close_time DATETIME - 是 关闭时间
rating_score DECIMAL 5,2 是 评分数 汇总所有任务执行评分
rating_user_id BIGINT - 是 评分人 ID 外键
rating_department_id BIGINT - 是 评分部门 ID 外键
delete_enum VARCHAR 32 是 删除标识 TRUE-已删除，FALSE-未删除
remarks VARCHAR 500 是 备注
create_name VARCHAR 50 是 创建人姓名 冗余字段
update_name VARCHAR 50 是 更新人姓名 冗余字段
tenant_id BIGINT - 是 租户 ID 多租户字段
org_id BIGINT - 是 组织 ID 组织字段
version INT - 是 版本号 乐观锁版本号，默认0
create_time DATETIME - 是 创建时间 默认当前时间
update_time DATETIME - 是 更新时间 自动更新
create_id BIGINT - 是 创建人 ID 外键
update_id BIGINT - 是 更新人 ID 外键
env VARCHAR 50 是 环境标识

2.3.2 建表语句

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 '下发时间',
    `issue_corp_id` bigint DEFAULT NULL COMMENT '下发公司ID',
    `issue_department_id` bigint DEFAULT NULL COMMENT '下发部门ID',
    `issue_user_id` bigint DEFAULT NULL COMMENT '下发人员ID',
    `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_tenant_org_status` (`tenant_id`,`org_id`,`status`),
    KEY `idx_task_list_id` (`task_list_id`),
    KEY `idx_execute_corp_dept_user` (`execute_corp_id`, `execute_department_id`, `execute_user_id`),
    KEY `idx_period_start` (`period_start_time`),
    KEY `idx_issue_time` (`issue_time`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='清单下发记录表';

2.3.3 索引设计

索引名 索引类型 字段 说明
PRIMARY 主键索引 id 主键
uk_task_issue_id 唯一索引 task_issue_id 下发记录业务主键唯一
idx_tenant_org_status 联合索引 tenant_id, org_id, status 按租户组织状态查询
idx_task_list_id 普通索引 task_list_id 按清单ID查询下发记录
idx_execute_corp_dept_user 联合索引 execute_corp_id, execute_department_id, execute_user_id 重复下发校验
idx_period_start 普通索引 period_start_time 按执行周期查询
idx_issue_time 普通索引 issue_time 按下发时间查询

2.4 safety_accountability_task_execution（任务执行记录表）

任务执行记录表用于存储任务模板下发给具体公司后的执行实例记录，包括任务状态、反馈状态、评分等。每条下发记录中的每个任务模板对应一条执行记录。

2.4.1 表结构

字段名 类型 长度 允许空 说明 备注
id BIGINT - 否 主键 ID 自增
task_execution_id VARCHAR 64 否 任务执行 UUID 业务主键，UUID 生成
task_issue_id VARCHAR 64 否 清单下发记录 UUID 外键，关联 task_list_issue 表
task_detail_id VARCHAR 64 否 任务模板 UUID 外键，关联 task_detail 表
task_list_id VARCHAR 64 否 清单 UUID 冗余字段，便于查询
task_status TINYINT - 否 任务状态 1-进行中 2-已完成 3-已关闭，默认1
feedback_status TINYINT - 是 反馈状态 1-正常 2-异常，默认1
task_rating DECIMAL 5,2 是 任务评分
rating_time DATETIME - 是 评分时间
rating_department_id BIGINT - 是 评分部门 ID 外键
rating_user_id BIGINT - 是 评分人 ID 外键
delete_enum VARCHAR 32 是 删除标识 TRUE-已删除，FALSE-未删除
remarks VARCHAR 500 是 备注
create_name VARCHAR 50 是 创建人姓名 冗余字段
update_name VARCHAR 50 是 更新人姓名 冗余字段
tenant_id BIGINT - 是 租户 ID 多租户字段
org_id BIGINT - 是 组织 ID 组织字段
version INT - 是 版本号 乐观锁版本号，默认0
create_time DATETIME - 是 创建时间 默认当前时间
update_time DATETIME - 是 更新时间 自动更新
create_id BIGINT - 是 创建人 ID 外键
update_id BIGINT - 是 更新人 ID 外键
env VARCHAR 50 是 环境标识

2.4.2 建表语句

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_tenant_org_task` (`tenant_id`,`org_id`,`task_status`),
    KEY `idx_task_issue_id` (`task_issue_id`),
    KEY `idx_task_detail_id` (`task_detail_id`),
    KEY `idx_task_list_id` (`task_list_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='任务执行记录表';

2.4.3 索引设计

索引名 索引类型 字段 说明
PRIMARY 主键索引 id 主键
uk_task_execution_id 唯一索引 task_execution_id 执行记录业务主键唯一
idx_tenant_org_task 联合索引 tenant_id, org_id, task_status 按租户组织任务状态查询
idx_task_issue_id 普通索引 task_issue_id 按下发记录ID查询执行记录
idx_task_detail_id 普通索引 task_detail_id 按任务模板ID查询执行记录
idx_task_list_id 普通索引 task_list_id 按清单ID查询执行记录

2.5 safety_accountability_feedback（执行反馈表）

执行反馈表用于存储任务执行的反馈信息，包括反馈内容、反馈时间、反馈周期标识等。通过周期标识可按月/季/半年/年分组统计反馈记录。

2.5.1 表结构

字段名 类型 长度 允许空 说明 备注
id BIGINT - 否 主键 ID 自增
feedback_id VARCHAR 64 否 反馈 UUID 业务主键，UUID 生成
task_detail_id VARCHAR 64 否 任务详情 UUID 外键，关联 task_detail 表
task_execution_id VARCHAR 64 是 任务执行 UUID 外键，关联 task_execution 表
task_list_id VARCHAR 64 否 任务清单 UUID 冗余字段，便于查询
task_issue_id VARCHAR 64 是 清单下发记录 UUID 冗余字段
feedback_time DATETIME - 否 反馈时间
feedback_period_start_time DATETIME - 否 反馈周期开始时间 用于回显
feedback_period_end_time DATETIME - 否 反馈周期结束时间 用于回显
feedback_period_flag VARCHAR 20 否 反馈周期标识 格式：2026-05月、2026-Q1季、2026-H1半年、2026年
feedback_content TEXT - 是 反馈内容
feedback_corp_id BIGINT - 是 反馈人公司 ID 外键
feedback_department_id BIGINT - 是 反馈人部门 ID 外键
feedback_user_id BIGINT - 是 反馈人 ID 外键
delete_enum VARCHAR 32 是 删除标识 TRUE-已删除，FALSE-未删除
remarks VARCHAR 500 是 备注
create_name VARCHAR 50 是 创建人姓名 冗余字段
update_name VARCHAR 50 是 更新人姓名 冗余字段
tenant_id BIGINT - 是 租户 ID 多租户字段
org_id BIGINT - 是 组织 ID 组织字段
version INT - 是 版本号 乐观锁版本号，默认0
create_time DATETIME - 是 创建时间 默认当前时间
update_time DATETIME - 是 更新时间 自动更新
create_id BIGINT - 是 创建人 ID 外键
update_id BIGINT - 是 更新人 ID 外键
env VARCHAR 50 是 环境标识

2.5.2 建表语句

CREATE TABLE `safety_accountability_feedback` (
    `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
    `feedback_id` varchar(64) NOT NULL COMMENT '反馈UUID（业务主键）',
    `task_detail_id` varchar(64) NOT NULL COMMENT '任务详情UUID（关联任务清单详细表）',
    `task_execution_id` varchar(64) DEFAULT NULL COMMENT '任务执行UUID（关联任务执行表）',
    `task_list_id` varchar(64) NOT NULL COMMENT '任务清单UUID（冗余字段，便于查询）',
    `task_issue_id` varchar(64) DEFAULT NULL COMMENT '清单下发记录UUID（冗余）',
    `feedback_time` datetime NOT NULL COMMENT '反馈时间',
    `feedback_period_start_time` datetime NOT NULL COMMENT '反馈周期开始时间（用于回显）',
    `feedback_period_end_time` datetime NOT NULL COMMENT '反馈周期结束时间（用于回显）',
    `feedback_period_flag` varchar(20) NOT NULL COMMENT '反馈周期标识（格式：2026-05表示月，2026-Q1表示季度，2026-H1表示半年，2026表示年）',
    `feedback_content` text COMMENT '反馈内容',
    `feedback_corp_id` bigint DEFAULT NULL COMMENT '反馈人公司ID',
    `feedback_department_id` bigint DEFAULT NULL COMMENT '反馈人部门ID',
    `feedback_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_feedback_id` (`feedback_id`),
    KEY `idx_task_detail_id` (`task_detail_id`),
    KEY `idx_task_list_id` (`task_list_id`),
    KEY `idx_feedback_time` (`feedback_time`),
    KEY `idx_feedback_user_id` (`feedback_user_id`),
    KEY `idx_taskdetail_period` (`task_detail_id`,`feedback_period_flag`),
    KEY `idx_task_execution_id` (`task_execution_id`),
    KEY `idx_task_issue_id` (`task_issue_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='执行反馈表';

2.5.3 索引设计

索引名 索引类型 字段 说明
PRIMARY 主键索引 id 主键
uk_feedback_id 唯一索引 feedback_id 反馈业务主键唯一
idx_task_detail_id 普通索引 task_detail_id 按任务详情ID查询反馈
idx_task_list_id 普通索引 task_list_id 按清单ID查询反馈
idx_feedback_time 普通索引 feedback_time 按反馈时间查询
idx_feedback_user_id 普通索引 feedback_user_id 按反馈人查询
idx_taskdetail_period 联合索引 task_detail_id, feedback_period_flag 按任务和周期标识查询
idx_task_execution_id 普通索引 task_execution_id 按执行记录ID查询反馈
idx_task_issue_id 普通索引 task_issue_id 按下发记录ID查询反馈

2.6 safety_accountability_feedback_exception（反馈异常信息表）

反馈异常信息表用于存储反馈异常记录，由定时任务每月1日0时自动检测生成。检测逻辑：根据任务的反馈周期类型判断上一阶段是否有反馈记录，无记录则判定为异常并写入此表。

2.6.1 表结构

字段名 类型 长度 允许空 说明 备注
id BIGINT - 否 主键 ID 自增
feedback_exception_id VARCHAR 64 否 反馈异常 UUID 业务主键，UUID 生成
task_detail_id VARCHAR 64 否 任务详情主键 外键，关联 task_detail 表
task_execution_id VARCHAR 64 是 任务执行 UUID 外键，关联 task_execution 表
task_list_id VARCHAR 64 是 任务清单主键 冗余字段
task_issue_id VARCHAR 64 是 清单下发记录 UUID 冗余字段
exception_period_flag VARCHAR 20 否 异常周期标识 同 feedback_period_flag 格式
exception_period_start_time DATETIME - 是 反馈周期开始时间 用于回显
exception_period_end_time DATETIME - 是 反馈周期结束时间 用于回显
exception_type TINYINT - 是 异常类型 1-未按时反馈 2-反馈内容异常 3-其他，默认1
exception_content TEXT - 是 反馈异常信息
exception_time DATETIME - 是 异常时间
delete_enum VARCHAR 32 是 删除标识 TRUE-已删除，FALSE-未删除
remarks VARCHAR 500 是 备注
create_name VARCHAR 50 是 创建人姓名 冗余字段
update_name VARCHAR 50 是 更新人姓名 冗余字段
tenant_id BIGINT - 是 租户 ID 多租户字段
org_id BIGINT - 是 组织 ID 组织字段
version INT - 是 版本号 乐观锁版本号，默认0
create_time DATETIME - 是 创建时间 默认当前时间
update_time DATETIME - 是 更新时间 自动更新
create_id BIGINT - 是 创建人 ID 外键
update_id BIGINT - 是 更新人 ID 外键
env VARCHAR 50 是 环境标识

2.6.2 建表语句

CREATE TABLE `safety_accountability_feedback_exception` (
    `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
    `feedback_exception_id` varchar(64) NOT NULL COMMENT '反馈异常UUID（业务主键）',
    `task_detail_id` varchar(64) NOT NULL COMMENT '任务详情主键（关联任务清单详细表）',
    `task_execution_id` varchar(64) DEFAULT NULL COMMENT '任务执行UUID（关联任务执行表）',
    `task_list_id` varchar(64) DEFAULT NULL COMMENT '任务清单主键（冗余字段）',
    `task_issue_id` varchar(64) DEFAULT NULL COMMENT '清单下发记录UUID（冗余）',
    `exception_period_flag` varchar(20) NOT NULL COMMENT '异常周期标识',
    `exception_period_start_time` datetime DEFAULT NULL COMMENT '反馈周期开始时间（用于回显）',
    `exception_period_end_time` datetime DEFAULT NULL COMMENT '反馈周期结束时间（用于回显）',
    `exception_type` tinyint DEFAULT '1' COMMENT '异常类型：1-未按时反馈 2-反馈内容异常 3-其他',
    `exception_content` text COMMENT '反馈异常信息',
    `exception_time` datetime DEFAULT NULL COMMENT '异常时间',
    `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_feedback_exception_id` (`feedback_exception_id`),
    KEY `idx_task_detail_id` (`task_detail_id`),
    KEY `idx_task_list_id` (`task_list_id`),
    KEY `idx_taskdetail_ex_period` (`task_detail_id`,`exception_period_flag`),
    KEY `idx_taskdetail_ex_type` (`task_detail_id`,`exception_type`),
    KEY `idx_task_execution_id` (`task_execution_id`),
    KEY `idx_task_issue_id` (`task_issue_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='反馈异常信息表';

2.6.3 索引设计

索引名 索引类型 字段 说明
PRIMARY 主键索引 id 主键
uk_feedback_exception_id 唯一索引 feedback_exception_id 异常记录业务主键唯一
idx_task_detail_id 普通索引 task_detail_id 按任务详情ID查询异常
idx_task_list_id 普通索引 task_list_id 按清单ID查询异常
idx_taskdetail_ex_period 联合索引 task_detail_id, exception_period_flag 按任务和周期标识查询异常
idx_taskdetail_ex_type 联合索引 task_detail_id, exception_type 按任务和异常类型查询
idx_task_execution_id 普通索引 task_execution_id 按执行记录ID查询异常
idx_task_issue_id 普通索引 task_issue_id 按下发记录ID查询异常

3. 视图设计

3.1 corp_info（公司信息视图）

公司信息视图，跨库引用基础信息服务中的公司信息表，过滤已删除数据。

3.2 department（部门信息视图）

部门信息视图，跨库引用基础信息服务中的部门信息表，过滤已删除数据。

3.3 user（用户信息视图）

用户信息视图，跨库引用基础信息服务中的用户信息表，过滤已删除数据。

以上三个视图均为只读视图，数据来源于 jjb-saas-zcloud-basic-info 库，本系统仅做联表查询使用，不对其进行增删改操作。

4. 枚举值说明

4.1 任务级别（task_level）

值 说明
1 企业级
2 部门级
3 班组级

4.2 开启/关闭（switch_flag）

值 说明
0 关闭
1 开启

4.3 状态（status）

值 说明
1 进行中
2 已完成
3 已关闭

4.4 反馈周期类型（feedback_cycle_type）

值 说明 周期标识格式 示例
1 每月 yyyy-MM 2026-05
2 每季度 yyyy-QN 2026-Q1
3 每半年 yyyy-HN 2026-H1
4 每年 yyyy 2026

4.5 反馈状态（feedback_status）

值 说明
1 正常
2 异常

4.6 下发状态（issue_status）

值 说明
0 未下发
1 已下发

4.7 异常类型（exception_type）

值 说明
1 未按时反馈
2 反馈内容异常
3 其他

4.8 删除标识（delete_enum）

值 说明
FALSE 未删除
TRUE 已删除

5. 公共字段说明

所有业务表均包含以下公共字段，用于多租户隔离、数据审计和乐观锁控制：

字段名 类型 说明
delete_enum VARCHAR(32) 逻辑删除标识，TRUE-已删除，FALSE-未删除
remarks VARCHAR(500) 备注
create_name VARCHAR(50) 创建人姓名（冗余）
update_name VARCHAR(50) 更新人姓名（冗余）
tenant_id BIGINT 租户ID，用于多租户数据隔离
org_id BIGINT 组织ID，用于组织级数据权限
version INT 乐观锁版本号
create_time DATETIME 创建时间，默认当前时间
update_time DATETIME 更新时间，自动更新
create_id BIGINT 创建人ID
update_id BIGINT 更新人ID
env VARCHAR(50) 环境标识