# 综合执法
## 动态数据管理
### 企业信息管理
#### 功能说明
企业信息管理模块负责对企业的基本信息进行全生命周期管理，包括企业信息的增删改查、导入导出、审核等功能。该模块是系统的基础数据来源，为其他业务模块提供企业基础数据支持。

#### 类定义

| 类名 | EnterpriseController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createEnterprise(Enterprise enterprise, RemoteUserInfo userInfo): Result<Enterprise> |
| 描述 | 创建企业信息 |
| 定义 | getEnterpriseById(String enterpriseId): Result<Enterprise> |
| 描述 | 根据ID查询企业信息 |
| 定义 | updateEnterprise(String enterpriseId, Enterprise enterprise, RemoteUserInfo user): Result<Enterprise> |
| 描述 | 更新企业信息 |
| 定义 | deleteEnterpriseById(String enterpriseId, RemoteUserInfo user): Result<Void> |
| 描述 | 根据ID删除企业信息 |
| 定义 | deleteEnterprisesByIds(List<String> enterpriseIds, RemoteUserInfo user): Result<Void> |
| 描述 | 批量删除企业信息 |

| 类名 | EnterpriseService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveEnterprise(Enterprise enterprise, RemoteUserInfo user): Enterprise |
| 描述 | 保存企业信息 |
| 定义 | findEnterpriseById(String enterpriseId): Optional<Enterprise> |
| 描述 | 根据ID查询企业信息 |
| 定义 | deleteEnterpriseById(String enterpriseId, RemoteUserInfo user): void |
| 描述 | 根据ID删除企业信息 |
| 定义 | deleteEnterprisesByIds(List<String> enterpriseIds, RemoteUserInfo user): void |
| 描述 | 批量删除企业信息 |
| 定义 | operateEnterprise(Enterprise enterprise, RemoteUserInfo user): Enterprise |
| 描述 | 操作企业信息（加入/移出计划清单等） |

| 类名 | EnterpriseRepository |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.repository |
| 定义 | findByUnifiedSocialCode(String unifiedSocialCode): Optional<Enterprise> |
| 描述 | 根据统一社会信用代码查询企业 |
| 定义 | findByUnitNameContaining(String unitName): List<Enterprise> |
| 描述 | 根据单位名称模糊查询企业列表 |
| 定义 | existsByUnifiedSocialCode(String unifiedSocialCode): boolean |
| 描述 | 判断统一社会信用代码是否存在 |
| 定义 | countByAgencyId(String agencyId): long |
| 描述 | 根据机构ID统计企业数量 |

| 类名 | Enterprise |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | - |
| 描述 | 企业信息实体类，包含企业基本信息和业务属性 |

| 类名 | EnterpriseDto |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.dto |
| 定义 | - |
| 描述 | 企业信息数据传输对象 |

| 类名 | EnterpriseQuery |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.query |
| 定义 | - |
| 描述 | 企业信息查询条件封装类 |

#### 界面设计

### 企业信息查询
#### 功能说明
企业信息查询功能提供对企业信息的多样化查询和筛选，支持按企业名称、统一社会信用代码、所属行业等多种条件进行精确或模糊查询。

#### 类定义

| 类名 | EnterpriseController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getEnterprisesPage(EnterpriseQuery query, RemoteUserInfo user): PageResult<EnterpriseDto> |
| 描述 | 分页查询企业信息 |
| 定义 | getEnterprisesByAgencyId(String agencyId, RemoteUserInfo user): Result<List<Enterprise>> |
| 描述 | 根据机构ID查询企业列表 |
| 定义 | enterpriseExport(ExportExcelParam<EnterpriseQuery> excelParam, HttpServletResponse response, RemoteUserInfo user): void |
| 描述 | 导出企业信息 |

| 类名 | EnterpriseService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | findEnterprisesPage(EnterpriseQuery query, RemoteUserInfo user): Page<EnterpriseDto> |
| 描述 | 分页查询企业信息 |
| 定义 | findEnterprisesByAgencyId(String agencyId, RemoteUserInfo user): List<Enterprise> |
| 描述 | 根据机构ID查询企业列表 |
| 定义 | findAllEnterprises(EnterpriseQuery query, RemoteUserInfo user): List<EnterpriseDto> |
| 描述 | 查询所有企业信息（用于导出） |

| 类名 | EnterpriseQuery |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.query |
| 定义 | - |
| 描述 | 企业信息查询条件封装类，包含分页、排序等参数 |

#### 界面设计

### 企业信息上报审核
#### 功能说明
企业信息上报审核模块负责处理企业信息的审核流程，确保企业信息的准确性和合规性。

#### 类定义

| 类名 | EnterpriseAuditController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createEnterpriseAudit(EnterpriseAudit enterpriseAudit): Result<EnterpriseAudit> |
| 描述 | 创建企业审核信息 |
| 定义 | getEnterpriseAuditById(String enterpriseId): Result<EnterpriseAudit> |
| 描述 | 根据ID查询企业审核信息 |
| 定义 | updateEnterpriseAudit(String enterpriseId, EnterpriseAudit enterpriseAudit): Result<EnterpriseAudit> |
| 描述 | 更新企业审核信息 |
| 定义 | taskExport(ExportExcelParam<EnterpriseQuery> excelParam, HttpServletResponse response): void |
| 描述 | 导出审核任务 |

| 类名 | EnterpriseAuditService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveEnterpriseAudit(EnterpriseAudit enterpriseAudit): EnterpriseAudit |
| 描述 | 保存企业审核信息 |
| 定义 | findEnterpriseAuditById(String enterpriseId): Optional<EnterpriseAudit> |
| 描述 | 根据ID查询企业审核信息 |
| 定义 | findAllEnterpriseAudits(EnterpriseQuery query): List<EnterpriseAudit> |
| 描述 | 查询所有企业审核信息（用于导出） |

| 类名 | EnterpriseAudit |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | - |
| 描述 | 企业审核信息实体类 |

| 类名 | EnterpriseAuditRepository |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.repository |
| 定义 | existsByUnifiedSocialCodeAndDelFlag(String unifiedSocialCode, Short delFlag): boolean |
| 描述 | 判断统一社会信用代码是否存在 |
| 定义 | existsByUnifiedSocialCodeAndDelFlagAndEnterpriseIdNot(String unifiedSocialCode, Short delFlag, String enterpriseId): boolean |
| 描述 | 判断统一社会信用代码是否存在（排除指定ID） |

#### 界面设计

### 企业分级分类
#### 功能说明
企业分级分类模块根据企业的风险等级、行业特点等因素对企业进行分级分类管理。

#### 类定义

| 类名 | EnterpriseController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | updateEnterpriseGrade(String enterpriseId, Enterprise enterprise, RemoteUserInfo user): Result<Enterprise> |
| 描述 | 更新企业分级信息 |

| 类名 | EnterpriseService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | updateEnterpriseGrade(Enterprise enterprise, RemoteUserInfo user): Enterprise |
| 描述 | 更新企业分级信息 |
| 定义 | getEnterpriseGradeStatistics(EnterpriseQuery query): Map<String, Object> |
| 描述 | 获取企业分级统计信息 |

| 类名 | Enterprise |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | - |
| 描述 | 包含企业分级相关字段：businessRating(企业分级), riskLevel(风险等级)等 |

#### 界面设计

### 企业信息统计
#### 功能说明
企业信息统计模块提供对企业基础数据的统计分析功能，生成各类统计报表。

#### 类定义

| 类名 | EnterpriseStatisticsController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getEnterpriseStatistics(EnterpriseQuery query): Result<Map<String, Object>> |
| 描述 | 获取企业统计信息 |
| 定义 | exportEnterpriseStatistics(EnterpriseQuery query, HttpServletResponse response): void |
| 描述 | 导出企业统计报表 |

| 类名 | EnterpriseStatisticsService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | getEnterpriseStatistics(EnterpriseQuery query): Map<String, Object> |
| 描述 | 获取企业统计信息 |
| 定义 | exportEnterpriseStatistics(EnterpriseQuery query, HttpServletResponse response): void |
| 描述 | 导出企业统计报表 |

| 类名 | EnterpriseStatisticsVo |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.vo |
| 定义 | - |
| 描述 | 企业统计视图对象 |

#### 界面设计

## 行政执法管理
### 执法管理
#### 功能说明
执法管理模块是行政执法管理的核心模块，负责执法流程的统一管理和监控。主要功能包括：
- 执法任务分配与跟踪
- 执法人员管理
- 执法流程监控
- 执法数据统计与分析

#### 类定义

| 类名 | EnforceCheckController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createEnforceCheck(EnforceCheck enforceCheck, RemoteUserInfo user): Result<EnforceCheck> |
| 描述 | 创建执法检查记录 |
| 定义 | getEnforceCheckById(String checkId): Result<EnforceCheck> |
| 描述 | 根据ID查询执法检查记录 |
| 定义 | updateEnforceCheck(String checkId, EnforceCheck enforceCheck): Result<EnforceCheck> |
| 描述 | 更新执法检查记录 |
| 定义 | getEnforceChecksPage(EnforceCheckQuery query, RemoteUserInfo user): PageResult<EnforceCheck> |
| 描述 | 分页查询执法检查记录 |

| 类名 | EnforceCheckService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveEnforceCheck(EnforceCheck enforceCheck, RemoteUserInfo user, String operate): List<Object> |
| 描述 | 保存执法检查记录 |
| 定义 | findEnforceCheckById(String checkId): Optional<EnforceCheck> |
| 描述 | 根据ID查询执法检查记录 |
| 定义 | findEnforceChecksPage(EnforceCheckQuery query, RemoteUserInfo user): Page<EnforceCheck> |
| 描述 | 分页查询执法检查记录 |

| 类名 | EnforceCheck |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.entity |
| 定义 | id: String |
| 描述 | 主键ID |
| 定义 | checkNo: String |
| 描述 | 检查编号 |
| 定义 | checkType: String |
| 描述 | 检查类型（1:日常检查 2:专项检查 3:随机抽查） |
| 定义 | checkTypeName: String |
| 描述 | 检查类型名称 |
| 定义 | enterpriseId: String |
| 描述 | 企业ID |
| 定义 | enterpriseName: String |
| 描述 | 企业名称 |
| 定义 | creditCode: String |
| 描述 | 统一社会信用代码 |
| 定义 | checkTime: Date |
| 描述 | 检查时间 |
| 定义 | checkUserIds: String |
| 描述 | 检查人员ID，多个用逗号分隔 |
| 定义 | checkUserNames: String |
| 描述 | 检查人员姓名，多个用逗号分隔 |
| 定义 | checkContent: String |
| 描述 | 检查内容 |
| 定义 | checkResult: String |
| 描述 | 检查结果（0:正常 1:异常） |
| 定义 | checkResultDesc: String |
| 描述 | 检查结果描述 |
| 定义 | checkStatus: String |
| 描述 | 状态（0:草稿 1:待审核 2:已审核 3:已归档） |
| 定义 | attachmentIds: String |
| 描述 | 附件ID，多个用逗号分隔 |
| 定义 | createUserId: String |
| 描述 | 创建人ID |
| 定义 | createUserName: String |
| 描述 | 创建人姓名 |
| 定义 | createTime: Date |
| 描述 | 创建时间 |
| 定义 | updateUserId: String |
| 描述 | 更新人ID |
| 定义 | updateUserName: String |
| 描述 | 更新人姓名 |
| 定义 | updateTime: Date |
| 描述 | 更新时间 |
| 定义 | deptId: String |
| 描述 | 部门ID |
| 定义 | deptName: String |
| 描述 | 部门名称 |
| 定义 | isDeleted: Integer |
| 描述 | 是否删除（0:未删除 1:已删除） |

| 类名 | EnforceCheckQuery |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.query |
| 定义 | checkNo: String |
| 描述 | 检查编号 |
| 定义 | checkType: String |
| 描述 | 检查类型 |
| 定义 | enterpriseId: String |
| 描述 | 企业ID |
| 定义 | enterpriseName: String |
| 描述 | 企业名称 |
| 定义 | checkStartTime: Date |
| 描述 | 检查开始时间 |
| 定义 | checkEndTime: Date |
| 描述 | 检查结束时间 |
| 定义 | checkResult: String |
| 描述 | 检查结果 |
| 定义 | checkStatus: String |
| 描述 | 状态 |
| 定义 | createUserId: String |
| 描述 | 创建人ID |
| 定义 | deptId: String |
| 描述 | 部门ID |

##### 界面设计

#### 执法检查项管理
##### 功能说明
执法检查项管理模块负责对执法检查中的检查项进行管理，包括检查项的创建、查询、更新和删除。支持常规检查项和自定义检查项两种类型，并提供了检查项的批量导入导出功能。

##### 类定义

| 类名 | EnforceCheckItemController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getEnforceCheckItemById(String itemId): Result<EnforceCheckItem> |
| 描述 | 根据ID获取检查项信息 |
| 定义 | getEnforceCheckItemsPage(Page<EnforceCheckItem> page, EnforceCheckItemQuery query): PageResult<EnforceCheckItem> |
| 描述 | 分页查询检查项信息 |
| 定义 | getEnforceCheckItemsByCheckId(String checkId): Result<List<EnforceCheckItem>> |
| 描述 | 根据检查ID查询检查项列表 |
| 定义 | createEnforceCheckItem(EnforceCheckItem item, RemoteUserInfo user): Result<EnforceCheckItem> |
| 描述 | 创建检查项 |
| 定义 | batchCreateEnforceCheckItems(List<EnforceCheckItem> items, RemoteUserInfo user): Result<Void> |
| 描述 | 批量创建检查项 |
| 定义 | updateEnforceCheckItem(EnforceCheckItem item, RemoteUserInfo user): Result<EnforceCheckItem> |
| 描述 | 更新检查项 |
| 定义 | deleteEnforceCheckItem(String itemId): Result<Void> |
| 描述 | 删除检查项 |

| 类名 | EnforceCheckItemService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | getEnforceCheckItemById(String itemId): EnforceCheckItem |
| 描述 | 根据ID获取检查项信息 |
| 定义 | getEnforceCheckItemsByCheckId(String checkId): List<EnforceCheckItem> |
| 描述 | 根据检查ID获取检查项列表 |
| 定义 | getEnforceCheckItemsPage(Page<EnforceCheckItem> page, EnforceCheckItemQuery query): IPage<EnforceCheckItem> |
| 描述 | 分页查询检查项信息 |
| 定义 | createEnforceCheckItem(EnforceCheckItem item): boolean |
| 描述 | 创建检查项 |
| 定义 | batchCreateEnforceCheckItems(List<EnforceCheckItem> items): boolean |
| 描述 | 批量创建检查项 |
| 定义 | updateEnforceCheckItem(EnforceCheckItem item): boolean |
| 描述 | 更新检查项 |
| 定义 | deleteEnforceCheckItem(String itemId): boolean |
| 描述 | 删除检查项 |

| 类名 | EnforceCheckItem |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.entity |
| 定义 | id: String |
| 描述 | 主键ID |
| 定义 | checkId: String |
| 描述 | 检查ID |
| 定义 | itemName: String |
| 描述 | 检查项名称 |
| 定义 | itemCode: String |
| 描述 | 检查项编码 |
| 定义 | itemType: String |
| 描述 | 检查项类型（1:常规检查项 2:自定义检查项） |
| 定义 | checkContent: String |
| 描述 | 检查内容 |
| 定义 | checkBasis: String |
| 描述 | 检查依据 |
| 定义 | checkResult: String |
| 描述 | 检查结果（0:正常 1:异常） |
| 定义 | checkResultDesc: String |
| 描述 | 检查结果描述 |
| 定义 | itemSort: Integer |
| 描述 | 排序号 |
| 定义 | createUserId: String |
| 描述 | 创建人ID |
| 定义 | createUserName: String |
| 描述 | 创建人姓名 |
| 定义 | createTime: Date |
| 描述 | 创建时间 |
| 定义 | updateUserId: String |
| 描述 | 更新人ID |
| 定义 | updateUserName: String |
| 描述 | 更新人姓名 |
| 定义 | updateTime: Date |
| 描述 | 更新时间 |

| 类名 | EnforceCheckItemQuery |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.query |
| 定义 | checkId: String |
| 描述 | 检查ID |
| 定义 | itemName: String |
| 描述 | 检查项名称 |
| 定义 | itemType: String |
| 描述 | 检查项类型 |
| 定义 | checkResult: String |
| 描述 | 检查结果 |

#### 执法检查记录管理
##### 功能说明
执法检查记录管理模块负责对执法检查过程中的详细记录进行管理，包括记录的创建、查询、更新和删除。支持检查结果的记录、整改要求的设置和整改进度的跟踪。

##### 类定义

| 类名 | EnforceCheckRecordController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getEnforceCheckRecordById(String recordId): Result<EnforceCheckRecord> |
| 描述 | 根据ID获取检查记录信息 |
| 定义 | getEnforceCheckRecordsPage(Page<EnforceCheckRecord> page, EnforceCheckRecordQuery query): PageResult<EnforceCheckRecord> |
| 描述 | 分页查询检查记录信息 |
| 定义 | getEnforceCheckRecordsByCheckId(String checkId): Result<List<EnforceCheckRecord>> |
| 描述 | 根据检查ID查询检查记录列表 |
| 定义 | createEnforceCheckRecord(EnforceCheckRecord record, RemoteUserInfo user): Result<EnforceCheckRecord> |
| 描述 | 创建检查记录 |
| 定义 | batchCreateEnforceCheckRecords(List<EnforceCheckRecord> records, RemoteUserInfo user): Result<Void> |
| 描述 | 批量创建检查记录 |
| 定义 | updateEnforceCheckRecord(EnforceCheckRecord record, RemoteUserInfo user): Result<EnforceCheckRecord> |
| 描述 | 更新检查记录 |
| 定义 | deleteEnforceCheckRecord(String recordId): Result<Void> |
| 描述 | 删除检查记录 |

| 类名 | EnforceCheckRecord |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.entity |
| 定义 | id: String |
| 描述 | 主键ID |
| 定义 | checkId: String |
| 描述 | 检查ID |
| 定义 | checkItemId: String |
| 描述 | 检查项ID |
| 定义 | checkItemName: String |
| 描述 | 检查项名称 |
| 定义 | checkResult: String |
| 描述 | 检查结果（0:正常 1:异常） |
| 定义 | checkResultDesc: String |
| 描述 | 检查结果描述 |
| 定义 | rectificationRequirement: String |
| 描述 | 整改要求 |
| 定义 | rectificationDeadline: Date |
| 描述 | 整改期限 |
| 定义 | rectificationStatus: String |
| 描述 | 整改状态（0:未整改 1:整改中 2:已整改 3:已超期） |
| 定义 | rectificationCompleteTime: Date |
| 描述 | 整改完成时间 |
| 定义 | rectificationRemark: String |
| 描述 | 整改说明 |
| 定义 | rectificationAttachmentIds: String |
| 描述 | 整改附件ID，多个用逗号分隔 |
| 定义 | createUserId: String |
| 描述 | 创建人ID |
| 定义 | createUserName: String |
| 描述 | 创建人姓名 |
| 定义 | createTime: Date |
| 描述 | 创建时间 |
| 定义 | updateUserId: String |
| 描述 | 更新人ID |
| 定义 | updateUserName: String |
| 描述 | 更新人姓名 |
| 定义 | updateTime: Date |
| 描述 | 更新时间 |

| 类名 | EnforceCheckRecordQuery |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.query |
| 定义 | checkId: String |
| 描述 | 检查ID |
| 定义 | checkItemId: String |
| 描述 | 检查项ID |
| 定义 | checkItemName: String |
| 描述 | 检查项名称 |
| 定义 | checkResult: String |
| 描述 | 检查结果 |
| 定义 | rectificationStatus: String |
| 描述 | 整改状态 |
| 定义 | rectificationStartTime: Date |
| 描述 | 整改开始时间 |
| 定义 | rectificationEndTime: Date |
| 描述 | 整改结束时间 |

##### 界面设计

#### 现场执法检查
##### 功能说明
现场执法检查模块负责执法人员在实际执法过程中的现场检查工作，包括检查记录的创建、查询、更新和删除，以及检查项的管理。主要功能包括：
- 执法检查记录的创建与维护
- 检查项的管理与关联
- 检查结果的记录与查询
- 检查记录的统计与分析

##### 类定义

| 类名 | EnforceCheckController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createEnforceCheck(EnforceCheck enforceCheck, RemoteUserInfo user): Result<EnforceCheck> |
| 描述 | 创建执法检查记录 |
| 定义 | getEnforceCheckById(String id): Result<EnforceCheck> |
| 描述 | 根据ID获取执法检查记录 |
| 定义 | getEnforceChecksPage(EnforceCheckQuery query, Pageable pageable): PageResult<EnforceCheck> |
| 描述 | 分页查询执法检查记录 |
| 定义 | updateEnforceCheck(String id, EnforceCheck enforceCheck): Result<EnforceCheck> |
| 描述 | 更新执法检查记录 |
| 定义 | deleteEnforceCheck(String id): Result<Void> |
| 描述 | 删除执法检查记录 |

| 类名 | EnforceCheckService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveEnforceCheck(EnforceCheck enforceCheck, RemoteUserInfo user, String operate): List<Object> |
| 描述 | 保存执法检查记录 |
| 定义 | findEnforceCheckById(String id): Optional<EnforceCheck> |
| 描述 | 根据ID查询执法检查记录 |
| 定义 | findEnforceChecksPage(EnforceCheckQuery query, Pageable pageable): Page<EnforceCheck> |
| 描述 | 分页查询执法检查记录 |
| 定义 | deleteEnforceCheck(String id): void |
| 描述 | 删除执法检查记录 |

| 类名 | EnforceCheck |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | id: String |
| 描述 | 主键ID |
| 定义 | enforcementId: String |
| 描述 | 执法信息ID |
| 定义 | checkDate: LocalDate |
| 描述 | 检查日期 |
| 定义 | checkTime: String |
| 描述 | 检查时间 |
| 定义 | checkAddress: String |
| 描述 | 检查地点 |
| 定义 | checkResult: String |
| 描述 | 检查结果 |
| 定义 | checkNote: String |
| 描述 | 检查说明 |
| 定义 | checkItems: List<CheckItem> |
| 描述 | 检查项列表 |
| 定义 | createTime: LocalDateTime |
| 描述 | 创建时间 |
| 定义 | updateTime: LocalDateTime |
| 描述 | 更新时间 |

| 类名 | CheckItem |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | itemId: String |
| 描述 | 检查项ID |
| 定义 | itemName: String |
| 描述 | 检查项名称 |
| 定义 | itemTable: String |
| 描述 | 检查表ID |
| 定义 | eligibility: Short |
| 描述 | 是否合格 |
| 定义 | checkNote: String |
| 描述 | 检查说明 |
| 定义 | urls: List<String> |
| 描述 | 附件URL列表 |

| 类名 | EnforceCheckQuery |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.query |
| 定义 | enforcementId: String |
| 描述 | 执法信息ID |
| 定义 | enterpriseId: String |
| 描述 | 企业ID |
| 定义 | checkDate: LocalDate[] |
| 描述 | 检查日期范围 |
| 定义 | createTime: LocalDateTime[] |
| 描述 | 创建时间范围 |
| 定义 | supplementVerifyResult: String |
| 描述 | 补充验证结果 |

##### 界面设计

#### 总结
##### 功能说明
总结模块提供对执法检查、案件处理等数据的统计和分析功能，支持按不同维度进行数据汇总和报表生成。主要功能包括：
- 执法检查数据统计
- 案件处理情况分析
- 执法效能评估
- 数据报表导出

##### 类定义

| 类名 | EnforcementInfoController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getEnforcementInfoPage(EnforcementInfoQuery query, Pageable pageable): PageResult<EnforcementInfo> |
| 描述 | 分页查询执法信息 |
| 定义 | getEnforcementInfoById(String id): Result<EnforcementInfo> |
| 描述 | 根据ID获取执法信息 |
| 定义 | createEnforcementInfo(EnforcementInfoDto enforcementInfoDto, RemoteUserInfo user): Result<Void> |
| 描述 | 创建执法信息 |
| 定义 | updateEnforcementInfo(String id, EnforcementInfoDto enforcementInfoDto): Result<Void> |
| 描述 | 更新执法信息 |

| 类名 | CaseController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getCasesPage(CaseQuery query, RemoteUserInfo user): PageResult<Case> |
| 描述 | 分页查询案件信息 |
| 定义 | getCaseById(String caseId): Result<Case> |
| 描述 | 根据ID获取案件信息 |
| 定义 | createCase(Case caseInfo): Result<Case> |
| 描述 | 创建案件信息 |
| 定义 | updateCase(String id, Case caseInfo): Result<Case> |
| 描述 | 更新案件信息 |

| 类名 | EnforcementInfoService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | findEnforcementInfoPage(EnforcementInfoQuery query, Pageable pageable): Page<EnforcementInfo> |
| 描述 | 分页查询执法信息 |
| 定义 | findEnforcementInfoById(String id): Optional<EnforcementInfo> |
| 描述 | 根据ID查询执法信息 |
| 定义 | saveEnforcementInfo(EnforcementInfoDto enforcementInfoDto, RemoteUserInfo user): void |
| 描述 | 保存执法信息 |

| 类名 | CaseService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | findCasesPage(CaseQuery query, RemoteUserInfo user): Page<Case> |
| 描述 | 分页查询案件信息 |
| 定义 | findCaseById(String caseId): Optional<Case> |
| 描述 | 根据ID查询案件信息 |
| 定义 | saveCase(Case caseInfo): Case |
| 描述 | 保存案件信息 |

| 类名 | EnforcementInfo |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | enforcementId: String |
| 描述 | 执法信息ID |
| 定义 | enterpriseId: String |
| 描述 | 企业ID |
| 定义 | enforcementType: String |
| 描述 | 执法类型 |
| 定义 | enforcementStatus: String |
| 描述 | 执法状态 |
| 定义 | createTime: LocalDateTime |
| 描述 | 创建时间 |
| 定义 | updateTime: LocalDateTime |
| 描述 | 更新时间 |

| 类名 | Case |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | caseId: String |
| 描述 | 案件ID |
| 定义 | enforcementId: String |
| 描述 | 关联的执法信息ID |
| 定义 | caseNo: String |
| 描述 | 案件编号 |
| 定义 | caseTitle: String |
| 描述 | 案件标题 |
| 定义 | caseType: String |
| 描述 | 案件类型 |
| 定义 | caseStatus: String |
| 描述 | 案件状态 |
| 定义 | fillingDate: LocalDate |
| 描述 | 立案日期 |
| 定义 | supplement: Map<String, Object> |
| 描述 | 补充信息（包含各类统计指标） |

##### 界面设计

### 行政处罚
#### 立案
##### 功能说明
立案模块负责行政处罚案件的立案管理，包括案件的创建、查询、更新和删除等操作。主要功能包括：
- 案件信息的创建与维护
- 案件的分页查询与筛选
- 案件状态的更新与流转
- 相关文书的管理与关联
- 案件进度的跟踪与管理

##### 类定义

| 类名 | CaseController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getCasesPage(CaseQuery query, RemoteUserInfo user): PageResult<Case> |
| 描述 | 分页查询案件信息 |
| 定义 | getCaseById(String caseId): Result<Case> |
| 描述 | 根据ID获取案件信息 |
| 定义 | createCase(Case caseInfo): Result<Case> |
| 描述 | 创建案件信息 |
| 定义 | updateCase(String caseId, Case caseInfo): Result<Case> |
| 描述 | 更新案件信息 |
| 定义 | deleteCase(String caseId): Result<Void> |
| 描述 | 删除案件信息 |
| 定义 | uploadEvidenceFile(FormDataDto formData): Result<Case> |
| 描述 | 上传案件证据文件 |

| 类名 | CaseService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | findCasesPage(CaseQuery query, RemoteUserInfo user): Page<Case> |
| 描述 | 分页查询案件信息 |
| 定义 | findCaseById(String caseId): Optional<Case> |
| 描述 | 根据ID查询案件信息 |
| 定义 | saveCase(Case caseInfo): Case |
| 描述 | 保存案件信息 |
| 定义 | deleteCase(String caseId): void |
| 描述 | 删除案件信息 |
| 定义 | saveEvidence(FormDataDto formData): Case |
| 描述 | 保存案件证据 |

| 类名 | Case |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | caseId: String |
| 描述 | 案件ID |
| 定义 | enforcementId: String |
| 描述 | 关联的执法信息ID |
| 定义 | caseNo: String |
| 描述 | 案件编号 |
| 定义 | caseTitle: String |
| 描述 | 案件标题 |
| 定义 | caseType: String |
| 描述 | 案件类型 |
| 定义 | caseStatus: String |
| 描述 | 案件状态 |
| 定义 | fillingDate: LocalDate |
| 描述 | 立案日期 |
| 定义 | caseClosingDate: LocalDate |
| 描述 | 结案日期 |
| 定义 | archiveDate: LocalDate |
| 描述 | 归档日期 |
| 定义 | supplement: Map<String, Object> |
| 描述 | 补充信息（包含各类统计指标） |
| 定义 | enforcementInfo: EnforcementInfo |
| 描述 | 关联的执法信息 |
| 定义 | documents: List<Document> |
| 描述 | 关联的文书列表 |

| 类名 | CaseQuery |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.query |
| 定义 | caseName: String |
| 描述 | 案件名称 |
| 定义 | caseNum: String |
| 描述 | 案件号 |
| 定义 | fillingDate: LocalDate[] |
| 描述 | 立案时间范围 |
| 定义 | caseClosingDate: LocalDate[] |
| 描述 | 结案时间范围 |
| 定义 | archiveDate: LocalDate[] |
| 描述 | 归档时间范围 |
| 定义 | caseStatus: String |
| 描述 | 案件状态 |
| 定义 | specialCondition: String |
| 描述 | 特殊查询条件 |
| 定义 | supplementVerifyResult: String |
| 描述 | 补充验证结果 |

| 类名 | Document |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | documentId: String |
| 描述 | 文书ID |
| 定义 | documentCode: String |
| 描述 | 文书编号 |
| 定义 | documentNo: Integer |
| 描述 | 文书序号 |
| 定义 | documentName: String |
| 描述 | 文书名称 |
| 定义 | documentType: String |
| 描述 | 文书类型 |
| 定义 | documentPath: String |
| 描述 | 文书存储路径 |
| 定义 | status: DocumentStatus |
| 描述 | 文书状态 |
| 定义 | caseId: String |
| 描述 | 关联的案件ID |
| 定义 | createTime: LocalDateTime |
| 描述 | 创建时间 |
| 定义 | updateTime: LocalDateTime |
| 描述 | 更新时间 |

##### 界面设计

#### 调查取证
##### 功能说明
调查取证模块负责行政处罚案件中的证据收集与管理，包括证据文件的上传、关联、查询和管理等功能。主要功能包括：
- 证据文件的上传与存储
- 证据与案件的关联管理
- 证据信息的查询与展示
- 证据文件的下载与查看
- 证据状态的跟踪与管理

##### 类定义

| 类名 | CaseController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | addEvidenceFile(FormDataDto formData): Result<Case> |
| 描述 | 上传案件证据文件 |
| 定义 | saveEvidence(String caseId, Case caseInfo): Result<Case> |
| 描述 | 保存案件证据信息 |

| 类名 | CaseService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveEvidence(FormDataDto formData): Case |
| 描述 | 保存调查取证材料，包括文件上传和元数据保存 |
| 定义 | saveEvidence(Case caseInfo): List<Object> |
| 描述 | 保存案件证据信息，更新案件状态 |

| 类名 | Case |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | evidence: Map<String, Object> |
| 描述 | 案件调查取证内容，以JSON格式存储 |
| 定义 | filePath: String |
| 描述 | 案卷文件地址 |
| 定义 | downUrl: String |
| 描述 | 案件文件下载地址 |

| 类名 | FormDataDto |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.dto |
| 定义 | formDataJson: String |
| 描述 | 表单数据JSON字符串 |
| 定义 | files: MultipartFile[] |
| 描述 | 上传的文件数组 |
| 定义 | fileIds: String[] |
| 描述 | 文件ID数组 |
| 定义 | file1: MultipartFile |
| 描述 | 文件1 |
| 定义 | file2: MultipartFile |
| 描述 | 文件2 |
| 方法 | getFilesMap(): Map<String, MultipartFile> |
| 描述 | 获取文件ID到文件对象的映射 |

##### 界面设计

#### 分析研判
##### 功能说明
分析研判模块负责对案件调查取证结果进行分析和评估，确定案件的处理方向和后续流程。主要功能包括：
- 对调查取证结果进行专业分析和评估
- 确定案件是否符合立案条件
- 更新案件状态和流程节点
- 记录分析研判结果和意见
- 支持案件流程的流转控制

##### 类定义

| 类名 | CaseController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | fxyp(String caseId, Case caseInfo): Result<Case> |
| 描述 | 处理分析研判请求，更新案件状态 |

| 类名 | CaseService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | fxyp(Case c): List<Object> |
| 描述 | 执行分析研判业务逻辑，更新案件状态和流程节点 |

| 类名 | Case |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | status: CaseStatus |
| 描述 | 案件状态，包含analyze_judge(分析研判)等状态 |
| 定义 | evidence: Map<String, Object> |
| 描述 | 分析研判结果和意见，包含shjg(审核结果)等字段 |

| 类名 | FlowNode |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.enums |
| 定义 | analyze_judge |
| 描述 | 流程节点枚举，表示分析研判节点 |

##### 处理流程
1. 前端提交分析研判请求，包含案件ID和分析结果
2. 控制器接收请求，调用服务层方法处理
3. 服务层根据分析结果更新案件状态和流程节点：
   - 如果审核通过(shjg=true)，将案件状态更新为analyze_judge，流程节点更新为"分析研判"
   - 如果审核不通过，将案件状态更新为investigating，流程节点更新为"调查取证中"
4. 返回处理结果，前端根据结果更新界面

##### 数据模型
```json
{
  "caseId": "案件ID",
  "evidence": {
    "shjg": true,
    "opinion": "分析研判意见"
  },
  "status": "analyze_judge"
}
```

##### 界面设计

#### 案件调查终结
##### 功能说明
案件调查终结模块标志着调查取证阶段的完成，主要功能包括：
- 确认调查取证工作已完成
- 更新案件状态为调查取证完成
- 记录调查取证结果和结论
- 准备进入下一阶段（分析研判）

##### 类定义

| 类名 | CaseService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveEvidence(Case c): List<Object> |
| 描述 | 处理调查取证完成状态更新，包括案件状态和流程节点的更新 |

| 类名 | Case |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | status: CaseStatus |
| 描述 | 案件状态，包含investigation_done(调查取证完成)等状态 |

| 类名 | FlowNode |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.enums |
| 定义 | investigation_done |
| 描述 | 流程节点枚举，表示调查取证完成节点 |

##### 处理流程
1. 前端提交调查取证完成请求，包含案件ID和调查结果
2. 控制器接收请求，调用服务层方法处理
3. 服务层更新案件状态为investigation_done，流程节点更新为"调查取证完成"
4. 返回处理结果，前端根据结果更新界面

##### 数据模型
```json
{
  "caseId": "案件ID",
  "status": "investigation_done",
  "evidence": {
    "filesData": [
      {
        "name": "文件名",
        "savePathName": "文件保存路径",
        "dowloadUrl": "文件下载地址"
      }
    ],
    "conclusion": "调查结论"
  }
}
```

##### 界面设计

#### 法治审核
##### 功能说明
法治审核模块负责对案件进行法律合规性审查，主要功能包括：
- 对案件材料进行法律合规性审核
- 记录审核意见和结果
- 更新案件审核状态
- 支持审核通过/不通过操作
- 记录审核人和审核时间

##### 类定义

| 类名 | CaseController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | updateSupplementVerify(String caseId, Case caseInfo, RemoteUserInfo user): Result<Case> |
| 描述 | 处理案件审核请求，更新审核结果 |

| 类名 | CaseService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | updateSupplementVerify(Case c, RemoteUserInfo user): Case |
| 描述 | 更新案件审核信息，包括审核结果、审核意见、审核人和审核时间 |

| 类名 | Case |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | supplementVerifyResult: String |
| 描述 | 补充内容审核结果（0：不通过，1：通过：2：已填报） |
| 定义 | supplementVerifyDesc: String |
| 描述 | 补充内容审核描述 |
| 定义 | supplementVerifyUserName: String |
| 描述 | 补充内容审核人 |
| 定义 | supplementVerifyTime: LocalDateTime |
| 描述 | 补充内容审核时间 |
| 定义 | supplement: Map<String, Object> |
| 描述 | 案件补充内容JSON串 |

##### 处理流程
1. 前端提交案件审核请求，包含案件ID、审核结果和审核意见
2. 控制器接收请求，调用服务层方法处理
3. 服务层更新案件审核信息：
   - 设置审核结果(supplementVerifyResult)
   - 设置审核描述(supplementVerifyDesc)
   - 记录审核人(supplementVerifyUserName)
   - 记录审核时间(supplementVerifyTime)
4. 返回处理结果，前端根据结果更新界面

##### 数据模型
```json
{
  "caseId": "案件ID",
  "supplementVerifyResult": "1",
  "supplementVerifyDesc": "审核通过，符合法律规定",
  "supplementVerifyUserName": "审核人姓名",
  "supplementVerifyTime": "2023-01-01 12:00:00",
  "supplement": {
    "tbr": "填报人",
    "tbsj": "2023-01-01 12:00:00",
    "opinion": "补充意见"
  }
}
```

##### 状态说明
- 0: 审核不通过
- 1: 审核通过
- 2: 已填报（待审核）

##### 界面设计

#### 集体讨论
##### 功能说明
集体讨论模块用于对案件进行集体讨论和决策，主要功能包括：
- 记录集体讨论的过程和结果
- 支持讨论通过后结案或继续下一流程
- 记录讨论人、讨论时间和讨论内容
- 更新案件当前节点状态

##### 类定义

| 类名 | EnforcementInfoController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createBrainstorm(EnforcementInfoDto enforcementInfoDto): Result |
| 描述 | 处理集体讨论提交请求 |

| 类名 | EnforcementInfoService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveBrainstorm(EnforcementInfoDto enforcementInfoDto): void |
| 描述 | 保存集体讨论信息，更新案件状态 |

| 类名 | EnforcementInfo |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | brainstormDesc: String |
| 描述 | 集体讨论描述 |
| 定义 | brainstormUserId: String |
| 描述 | 集体讨论人ID |
| 定义 | brainstormUserName: String |
| 描述 | 集体讨论人姓名 |
| 定义 | brainstormTime: LocalDateTime |
| 描述 | 集体讨论时间 |
| 定义 | currentNodeCode: FlowNode |
| 描述 | 当前节点代码 |
| 定义 | currentNode: String |
| 描述 | 当前节点名称 |

| 类名 | FlowNode |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.enums |
| 定义 | brainstorm("brainstorm") |
| 描述 | 集体讨论节点 |
| 定义 | closed("closed") |
| 描述 | 结案节点 |

##### 处理流程
1. 前端提交集体讨论信息，包括讨论描述、讨论人信息等
2. 控制器接收请求，调用服务层方法处理
3. 服务层根据是否结案更新案件状态：
   - 如果结案(isRegister=1)，设置当前节点为"结案"，记录结案时间
   - 否则，设置当前节点为"集体讨论"
4. 保存讨论相关信息：
   - 讨论描述(brainstormDesc)
   - 讨论人ID(brainstormUserId)
   - 讨论人姓名(brainstormUserName)
   - 讨论时间(brainstormTime)
5. 返回处理结果

##### 数据模型
```json
{
  "enforcementId": "执法信息ID",
  "isRegister": "1", // 是否结案 1:是 其他:否
  "brainstormDesc": "集体讨论内容描述",
  "brainstormUserId": "讨论人ID",
  "brainstormUserName": "讨论人姓名",
  "brainstormTime": "2023-01-01 12:00:00"
}
```

##### 状态流转
- 讨论通过并结案：当前节点 → "结案" (closed)
- 讨论通过不结案：当前节点 → "集体讨论" (brainstorm)

##### 界面设计

#### 结案
##### 功能说明
结案是行政处罚流程的最终环节，表示案件处理完成。当案件经过集体讨论后，如果讨论决定结案，系统将更新案件状态为"结案"，并记录结案时间。

##### 类定义

| 类名 | EnforcementInfoController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createBrainstorm(EnforcementInfoDto enforcementInfoDto): Result |
| 描述 | 处理集体讨论提交请求，包含结案处理逻辑 |

| 类名 | EnforcementInfoService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveBrainstorm(EnforcementInfoDto enforcementInfoDto): void |
| 描述 | 保存集体讨论信息，处理结案逻辑 |

| 类名 | EnforcementInfo |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | caseClosingTime: LocalDateTime |
| 描述 | 结案时间 |
| 定义 | currentNodeCode: FlowNode |
| 描述 | 当前节点代码 |
| 定义 | currentNode: String |
| 描述 | 当前节点名称 |

| 类名 | FlowNode |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.enums |
| 定义 | closed("closed") |
| 描述 | 结案节点 |

##### 处理流程
1. 在集体讨论环节，如果讨论决定结案，前端设置isRegister="1"并提交
2. 后端接收请求，调用EnforcementInfoService.saveBrainstorm方法处理
3. 服务层更新案件状态：
   - 设置当前节点为"结案"（FlowNode.closed）
   - 记录结案时间（caseClosingTime）
4. 返回处理结果

##### 数据模型
```json
{
  "enforcementId": "执法信息ID",
  "isRegister": "1", // 是否结案 1:是 其他:否
  "brainstormDesc": "集体讨论内容描述",
  "brainstormUserId": "讨论人ID",
  "brainstormUserName": "讨论人姓名",
  "brainstormTime": "2023-01-01 12:00:00"
}
```

##### 状态流转
- 当前节点：集体讨论 (brainstorm) → 结案 (closed)

##### 界面设计

### 自动执法计划
#### 重点检查企业清单
##### 功能说明
重点检查企业清单是自动执法计划的一种类型，用于管理需要重点检查的企业列表。主要功能包括：

- 创建重点检查企业清单
- 查看重点检查企业详情
- 编辑重点检查企业信息
- 删除重点检查企业清单
- 分页查询重点检查企业清单
- 按任务名称、任务描述、任务日期等条件筛选

##### 类定义

| 类名 | AutoEnforcementPlan |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | planId: String |
| 描述 | 计划ID |
| 定义 | taskName: String |
| 描述 | 任务名称 |
| 定义 | taskDescription: String |
| 描述 | 任务描述 |
| 定义 | taskStatus: String |
| 描述 | 任务状态 |
| 定义 | taskDateFrom: LocalDate |
| 描述 | 任务开始日期 |
| 定义 | taskDateTo: LocalDate |
| 描述 | 任务结束日期 |
| 定义 | enterpriseIds: String |
| 描述 | 企业ID列表(逗号分隔) |
| 定义 | kind: String |
| 描述 | 计划类型(1:重点检查企业清单, 2:双重双随机一公开清单) |
| 定义 | entryTime: LocalDateTime |
| 描述 | 录入时间 |
| 定义 | distTime: LocalDateTime |
| 描述 | 派发时间 |
| 定义 | enterpriseList: List<Enterprise> |
| 描述 | 企业列表(Transient) |

| 类名 | AutoEnforcementPlanController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createAutoEnforcementPlan(AutoEnforcementPlan, RemoteUserInfo): Result<AutoEnforcementPlan> |
| 描述 | 创建自动执法计划 |
| 定义 | getAutoEnforcementPlanById(String): Result<AutoEnforcementPlan> |
| 描述 | 根据ID查询自动执法计划 |
| 定义 | getAutoEnforcementPlansPage(AutoEnforcementPlanQuery): PageResult<AutoEnforcementPlan> |
| 描述 | 分页查询自动执法计划 |
| 定义 | updateAutoEnforcementPlan(String, AutoEnforcementPlan, RemoteUserInfo): Result<AutoEnforcementPlan> |
| 描述 | 更新自动执法计划 |
| 定义 | deleteAutoEnforcementPlanById(String): Result<Void> |
| 描述 | 根据ID删除自动执法计划 |
| 定义 | deleteAutoEnforcementPlansByIds(List<String>): Result<Void> |
| 描述 | 批量删除自动执法计划 |
| 定义 | dispatchedAutoEnforcementPlan(String, AutoEnforcementPlan, RemoteUserInfo): Result<AutoEnforcementPlan> |
| 描述 | 派发自动执法计划 |

| 类名 | AutoEnforcementPlanService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveAutoEnforcementPlan(AutoEnforcementPlan, RemoteUserInfo, String): AutoEnforcementPlan |
| 描述 | 保存自动执法计划 |
| 定义 | findAutoEnforcementPlanById(String): Optional<AutoEnforcementPlan> |
| 描述 | 根据ID查询自动执法计划 |
| 定义 | findAutoEnforcementPlansPage(AutoEnforcementPlanQuery): Page<AutoEnforcementPlan> |
| 描述 | 分页查询自动执法计划 |
| 定义 | deleteAutoEnforcementPlanById(String): void |
| 描述 | 根据ID删除自动执法计划 |
| 定义 | deleteAutoEnforcementPlansByIds(List<String>): void |
| 描述 | 批量删除自动执法计划 |

##### 处理流程

1. **创建自动执法计划流程**
   - 验证请求参数
   - 设置录入时间和任务状态为"pending"
   - 保存自动执法计划
   - 返回创建结果

2. **查询自动执法计划流程**
   - 构建查询条件(任务名称、任务描述、任务日期范围等)
   - 执行分页查询
   - 返回查询结果

3. **更新自动执法计划流程**
   - 验证计划是否存在
   - 更新计划信息
   - 保存更新后的计划
   - 返回更新结果

4. **删除自动执法计划流程**
   - 验证计划是否存在
   - 执行删除操作
   - 返回删除结果

5. **派发自动执法计划流程**
   - 验证计划是否存在
   - 更新计划状态为"dispatched"
   - 设置派发时间
   - 如果包含企业ID，生成执法信息
   - 返回派发结果

##### 数据模型

```json
// 创建/更新自动执法计划请求
{
  "taskName": "重点企业季度检查",
  "taskDescription": "2023年第四季度重点企业检查计划",
  "taskDateFrom": "2023-10-01",
  "taskDateTo": "2023-12-31",
  "enterpriseIds": "ent1,ent2,ent3",
  "kind": "1"
}

// 查询参数
{
  "taskName": "季度检查",
  "taskDateFrom": "2023-01-01",
  "taskDateTo": "2023-12-31",
  "page": 1,
  "pageSize": 10,
  "sort": "entryTime",
  "dir": "desc"
}

// 响应结果
{
  "code": 0,
  "msg": "success",
  "data": {
    "content": [
      {
        "planId": "plan123",
        "taskName": "重点企业季度检查",
        "taskDescription": "2023年第四季度重点企业检查计划",
        "taskStatus": "pending",
        "taskDateFrom": "2023-10-01",
        "taskDateTo": "2023-12-31",
        "kind": "1",
        "entryTime": "2023-09-01T10:00:00",
        "distTime": null,
        "enterpriseList": [
          {
            "enterpriseId": "ent1",
            "enterpriseName": "示例企业1"
          },
          {
            "enterpriseId": "ent2",
            "enterpriseName": "示例企业2"
          }
        ]
      }
    ],
    "totalElements": 1,
    "totalPages": 1,
    "size": 10,
    "number": 0
  }
}
```

##### 界面设计

#### 双重双随机一公开清单
##### 功能说明
双重双随机一公开清单是自动执法计划的另一种类型，用于实现"双随机、一公开"监管机制。主要功能包括：

- 创建双随机检查任务
- 随机抽取检查对象
- 随机选派执法检查人员
- 公开检查结果
- 任务管理（启动、暂停、完成）
- 检查记录查询

##### 类定义

| 类名 | AutoEnforcementPlan |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | kind: String = "2" |
| 描述 | 计划类型为2表示双重双随机一公开清单 |

（其他类定义与重点检查企业清单相同）

##### 处理流程

1. **创建双随机检查任务流程**
   - 设置任务类型为"2"
   - 设置任务状态为"draft"
   - 保存任务信息
   - 返回创建结果

2. **随机抽取检查对象流程**
   - 从企业库中随机抽取指定数量的企业
   - 更新任务中的企业列表
   - 保存更新后的任务

3. **随机选派检查人员流程**
   - 从执法人员库中随机选派检查人员
   - 更新任务中的检查人员列表
   - 保存更新后的任务

4. **启动检查任务流程**
   - 验证任务状态是否为"draft"
   - 更新任务状态为"in_progress"
   - 设置启动时间
   - 保存更新后的任务

5. **完成检查任务流程**
   - 验证任务状态是否为"in_progress"
   - 更新任务状态为"completed"
   - 设置完成时间
   - 保存更新后的任务
   - 公开检查结果

##### 数据模型

```json
// 创建双随机检查任务请求
{
  "taskName": "2023年第四季度双随机检查",
  "taskDescription": "2023年第四季度双随机检查计划",
  "taskDateFrom": "2023-10-01",
  "taskDateTo": "2023-12-31",
  "kind": "2",
  "enterpriseCount": 10,
  "inspectorCount": 3
}

// 响应结果
{
  "code": 0,
  "msg": "success",
  "data": {
    "planId": "random123",
    "taskName": "2023年第四季度双随机检查",
    "taskStatus": "draft",
    "taskDateFrom": "2023-10-01",
    "taskDateTo": "2023-12-31",
    "kind": "2",
    "enterpriseCount": 10,
    "inspectorCount": 3,
    "entryTime": "2023-09-01T10:00:00"
  }
}
```

##### 界面设计

#### 执法计划任务管理
##### 功能说明
执法计划任务管理模块提供对自动执法计划任务的统一管理功能，包括：

- 任务列表展示
- 任务状态管理
- 任务进度跟踪
- 任务统计报表
- 任务提醒通知

##### 类定义

（使用与前面相同的类定义）

##### 处理流程

1. **任务列表查询流程**
   - 构建查询条件（任务名称、状态、日期范围等）
   - 执行分页查询
   - 返回查询结果

2. **任务状态更新流程**
   - 验证任务是否存在
   - 验证状态转换是否合法
   - 更新任务状态
   - 保存更新后的任务
   - 发送状态变更通知

3. **任务进度跟踪流程**
   - 查询任务关联的检查记录
   - 计算完成比例
   - 返回进度信息

4. **任务统计报表生成流程**
   - 按时间范围统计任务数量
   - 按状态统计任务分布
   - 按类型统计任务比例
   - 生成统计报表

##### 数据模型

```json
// 任务统计请求
{
  "startDate": "2023-01-01",
  "endDate": "2023-12-31",
  "statType": "monthly"
}

// 任务统计响应
{
  "code": 0,
  "msg": "success",
  "data": {
    "totalTasks": 120,
    "completedTasks": 85,
    "inProgressTasks": 25,
    "pendingTasks": 10,
    "monthlyStats": [
      {"month": "2023-01", "count": 10},
      {"month": "2023-02", "count": 12},
      // ... 其他月份数据
    ],
    "typeDistribution": [
      {"type": "重点检查", "count": 80, "percentage": 66.67},
      {"type": "双随机检查", "count": 40, "percentage": 33.33}
    ]
  }
}
```

##### 界面设计

### 督导检查
#### 功能说明
督导检查模块用于管理和执行上级部门对下级执法机构的监督检查工作，确保执法工作的规范性和有效性。主要功能包括：

- **督导检查任务管理**：创建、查询、更新和删除督导检查任务
- **检查任务分派**：将检查任务分派给具体的执法机构或人员
- **检查状态跟踪**：跟踪检查任务的执行状态（待完成/已完结）
- **检查结果记录**：记录检查的详细情况和结果
- **统计分析**：提供督导检查数据的统计和分析功能
- **多维度查询**：支持按企业、机构、时间等多维度查询检查记录

#### 类定义

| 类名 | SupervisionCheck |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | checkId: String |
| 描述 | 督导检查ID（ULID） |
| 定义 | enterpriseId: String |
| 描述 | 被检查企业ID |
| 定义 | agencyId: String |
| 描述 | 执法机构ID |
| 定义 | enforcementId: String |
| 描述 | 关联的执法信息ID |
| 定义 | deliverTime: LocalDateTime |
| 描述 | 转交时间 |
| 定义 | deliverAgencyId: String |
| 描述 | 转交机构ID |
| 定义 | deliverAgencyLevel: Integer |
| 描述 | 转交机构级别 |
| 定义 | deliverPerson: String |
| 描述 | 转交人 |
| 定义 | checkStatus: CheckStatus |
| 描述 | 检查状态（pending/completed） |
| 定义 | description: String |
| 描述 | 检查总体描述 |
| 定义 | checkType: String |
| 描述 | 检查类型 |
| 定义 | enterprise: Enterprise |
| 描述 | 被检查企业信息（关联） |
| 定义 | agency: Agency |
| 描述 | 执法机构信息（关联） |
| 定义 | deliverAgency: Agency |
| 描述 | 转交机构信息（关联） |

| 类名 | SupervisionCheckDto |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.dto |
| 定义 | agency: Agency |
| 描述 | 执法机构信息 |
| 定义 | type: String |
| 描述 | 类型（single/multiple） |
| 定义 | enterprise: Enterprise |
| 描述 | 被检查企业信息（单企业） |
| 定义 | description: String |
| 描述 | 检查描述 |
| 定义 | checkType: String |
| 描述 | 检查类型 |
| 定义 | enterprises: List<Enterprise> |
| 描述 | 被检查企业列表（多企业） |
| 定义 | supervisionChecks: List<SupervisionCheck> |
| 描述 | 督导检查列表 |
| 定义 | supervisionCheck: SupervisionCheck |
| 描述 | 单条督导检查信息 |
| 定义 | checkItemIds: List<String> |
| 描述 | 检查项ID列表 |

| 类名 | SupervisionCheckStatisticsDto |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.dto |
| 定义 | jurisdictionCode: String |
| 描述 | 管辖单位编码 |
| 定义 | jurisdictionName: String |
| 描述 | 管辖单位名称 |
| 定义 | jurisdictionLevel: Integer |
| 描述 | 管辖单位级别 |
| 定义 | hasChildren: Integer |
| 描述 | 是否有子节点（0-无，1-有） |
| 定义 | checks: Integer |
| 描述 | 检查总数 |
| 定义 | steers: Integer |
| 描述 | 督导检查数 |
| 定义 | crosss: Integer |
| 描述 | 交叉检查数 |
| 定义 | reports: Integer |
| 描述 | 举报核查数 |

| 类名 | SupervisionCheckController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getSupervisionChecksPage(SupervisionCheckQuery, RemoteUserInfo): PageResult<SupervisionCheck> |
| 描述 | 分页查询督导检查信息 |
| 定义 | saveSupervisionChecks(SupervisionCheckDto, RemoteUserInfo): Result<Void> |
| 描述 | 保存督导检查信息 |
| 定义 | getSupervisionCheckById(String): Result<SupervisionCheck> |
| 描述 | 根据ID查询督导检查详情 |
| 定义 | updateSupervisionCheck(String, SupervisionCheck): Result<SupervisionCheck> |
| 描述 | 更新督导检查信息 |
| 定义 | deleteSupervisionCheck(String): Result<Void> |
| 描述 | 删除督导检查 |
| 定义 | updateSupervisionCheckStatus(String, CheckStatus): Result<SupervisionCheck> |
| 描述 | 更新督导检查状态 |
| 定义 | checkStatistics(SupervisionCheckQuery, RemoteUserInfo): Result<List<SupervisionCheckStatisticsDto>> |
| 描述 | 督导检查统计 |
| 定义 | sdywStatistics(SupervisionCheckQuery, RemoteUserInfo): Result<List<SupervisionCheckStatisticsDto>> |
| 描述 | 督导业务统计 |

| 类名 | SupervisionCheckService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveSupervisionChecks(SupervisionCheckDto, RemoteUserInfo): void |
| 描述 | 保存督导检查信息（单条或批量） |
| 定义 | saveSupervisionCheck(SupervisionCheck): SupervisionCheck |
| 描述 | 保存单条督导检查 |
| 定义 | findSupervisionCheckById(String): Optional<SupervisionCheck> |
| 描述 | 根据ID查询督导检查 |
| 定义 | addEnforcementInfoCheck(SupervisionCheckDto, RemoteUserInfo): void |
| 描述 | 添加执法信息和检查项 |
| 定义 | findSupervisionChecksPage(SupervisionCheckQuery, RemoteUserInfo): Page<SupervisionCheck> |
| 描述 | 分页查询督导检查 |
| 定义 | deleteSupervisionCheckById(String): void |
| 描述 | 删除督导检查 |
| 定义 | updateSupervisionCheckStatus(String, CheckStatus): Optional<SupervisionCheck> |
| 描述 | 更新督导检查状态 |
| 定义 | checkStatistics(SupervisionCheckQuery, RemoteUserInfo): List<SupervisionCheckStatisticsDto> |
| 描述 | 督导检查统计 |

| 类名 | SupervisionCheckRepository |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.repository |
| 定义 | findByEnterpriseId(String): List<SupervisionCheck> |
| 描述 | 根据企业ID查询督导检查 |
| 定义 | findByAgencyId(String): List<SupervisionCheck> |
| 描述 | 根据机构ID查询督导检查 |
| 定义 | findByCheckStatus(CheckStatus): List<SupervisionCheck> |
| 描述 | 根据状态查询督导检查 |
| 定义 | findByEnterpriseIdAndCheckStatus(String, CheckStatus): List<SupervisionCheck> |
| 描述 | 根据企业和状态查询督导检查 |
| 定义 | checkStatistics(String, Integer): List<SupervisionCheckStatisticsDto> |
| 描述 | 督导检查统计查询 |

#### 处理流程

1. **创建督导检查流程**
   - 选择检查类型（单企业/多企业）
   - 填写检查基本信息（检查类型、描述等）
   - 选择被检查企业和负责机构
   - 系统生成检查任务并保存
   - 返回创建结果

2. **督导检查查询流程**
   - 构建查询条件（企业、机构、状态、时间等）
   - 执行分页查询
   - 关联查询企业和机构信息
   - 返回分页结果

3. **督导检查更新流程**
   - 验证检查ID是否存在
   - 更新检查信息
   - 保存更新结果
   - 返回更新后的检查信息

4. **督导检查删除流程**
   - 验证检查ID是否存在
   - 删除检查记录
   - 返回操作结果

5. **督导检查统计流程**
   - 按管辖单位分组统计
   - 计算检查总数、督导检查数、交叉检查数、举报核查数
   - 返回统计结果

### 举报核查
#### 功能说明
举报核查模块用于管理和处理来自各渠道的举报信息，确保举报内容得到及时、有效的核查和处理。主要功能包括：

- **举报信息管理**：创建、查询、更新和删除举报核查信息
- **举报受理**：记录举报来源、举报人信息、举报内容等
- **核查处理**：分配核查人员、记录核查过程和处理结果
- **状态跟踪**：跟踪举报处理状态（待处理/处理中/已反馈）
- **材料管理**：上传、查看和下载举报相关材料
- **统计分析**：提供举报数据的统计和分析功能
- **多维度查询**：支持按企业、举报类型、处理状态等多维度查询

#### 类定义

| 类名 | ReportCheck |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | pcid: String |
| 描述 | 举报核查ID（ULID） |
| 定义 | enterpriseId: String |
| 描述 | 被举报企业ID |
| 定义 | reporterName: String |
| 描述 | 举报人姓名 |
| 定义 | reporterSex: String |
| 描述 | 举报人性别 |
| 定义 | reporterPhone: String |
| 描述 | 举报人电话 |
| 定义 | briefFact: String |
| 描述 | 简要情况 |
| 定义 | reportCategory: String |
| 描述 | 投诉类别 |
| 定义 | reportCanal: String |
| 描述 | 举报渠道 |
| 定义 | processStatus: String |
| 描述 | 处理状态（0-待处理，1-处理中，2-已反馈） |
| 定义 | dataSource: String |
| 描述 | 数据来源（1-系统新增，2-12350投诉举报系统抽取） |
| 定义 | agency: Agency |
| 描述 | 派发机构信息（关联） |
| 定义 | enterprise: Enterprise |
| 描述 | 被举报企业信息（关联） |
| 定义 | filelIds: Set<String> |
| 描述 | 文件ID集合 |
| 定义 | dzcls: List<Materials> |
| 描述 | 电子材料列表 |

| 类名 | ReportCheckOper |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | id: String |
| 描述 | 记录唯一ID |
| 定义 | pcid: String |
| 描述 | 关联的举报核查ID |
| 定义 | operType: String |
| 描述 | 操作类型 |
| 定义 | operBy: String |
| 描述 | 操作人 |
| 定义 | operAccountBy: String |
| 描述 | 操作人账户 |
| 定义 | operTime: LocalDateTime |
| 描述 | 操作时间 |

| 类名 | ReportCheckController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createReportCheck(FormDataDto, RemoteUserInfo): Result<ReportCheck> |
| 描述 | 创建举报核查信息 |
| 定义 | getReportCheckById(String): Result<ReportCheck> |
| 描述 | 根据ID查询举报核查信息 |
| 定义 | getReportChecksPage(ReportCheckQuery, RemoteUserInfo): PageResult<ReportCheck> |
| 描述 | 分页查询举报核查信息 |
| 定义 | updateReportCheck(String, FormDataDto, RemoteUserInfo): Result<ReportCheck> |
| 描述 | 更新举报核查信息 |
| 定义 | deleteReportChecksByIds(List<String>): Result<Void> |
| 描述 | 批量删除举报核查信息 |
| 定义 | transferReportChecksByIds(List<String>, RemoteUserInfo): Result<Void> |
| 描述 | 批量转交举报核查 |
| 定义 | backReportCheck(String, ReportCheck, RemoteUserInfo): Result<ReportCheck> |
| 描述 | 反馈举报核查结果 |

| 类名 | ReportCheckService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveReportCheck(FormDataDto, RemoteUserInfo, String): ReportCheck |
| 描述 | 保存举报核查信息 |
| 定义 | findReportCheckById(String): Optional<ReportCheck> |
| 描述 | 根据ID查询举报核查信息 |
| 定义 | findReportChecksPage(ReportCheckQuery, RemoteUserInfo): Page<ReportCheck> |
| 描述 | 分页查询举报核查信息 |
| 定义 | deleteReportChecksByIds(List<String>): void |
| 描述 | 批量删除举报核查信息 |
| 定义 | transferReportChecksByIds(List<String>, RemoteUserInfo): void |
| 描述 | 批量转交举报核查 |
| 定义 | backReportCheck(String, ReportCheck, RemoteUserInfo): Optional<ReportCheck> |
| 描述 | 反馈举报核查结果 |
| 定义 | transferReportChecksById(ReportCheck, RemoteUserInfo): void |
| 描述 | 转交举报核查 |

#### 处理流程

1. **创建举报核查流程**
   - 用户填写举报信息（举报人信息、被举报企业、举报内容等）
   - 上传相关材料
   - 系统验证必填信息
   - 保存举报信息
   - 返回创建结果

2. **举报核查分页查询流程**
   - 用户设置查询条件（举报人、举报渠道、处理状态等）
   - 系统根据权限过滤数据
   - 返回分页查询结果

3. **举报核查转交流程**
   - 选择需要转交的举报记录
   - 选择目标机构
   - 更新处理状态为"处理中"
   - 记录操作日志
   - 返回转交结果

4. **举报核查反馈流程**
   - 查询待反馈的举报记录
   - 填写核查结果和反馈内容
   - 更新处理状态为"已反馈"
   - 记录操作日志
   - 返回反馈结果

5. **举报核查删除流程**
   - 选择需要删除的举报记录
   - 验证删除权限
   - 删除相关数据和文件
   - 返回删除结果

#### 数据模型

1. **举报核查信息**
```json
{
  "pcid": "举报核查ID",
  "enterpriseId": "被举报企业ID",
  "enterprise": {
    "enterpriseId": "企业ID",
    "enterpriseName": "企业名称",
    "creditCode": "统一社会信用代码"
  },
  "reporterName": "举报人姓名",
  "reporterSex": "性别",
  "reporterPhone": "联系电话",
  "briefFact": "简要情况",
  "reportCategory": "投诉类别",
  "reportCanal": "举报渠道",
  "processStatus": "处理状态",
  "dataSource": "数据来源",
  "agency": {
    "agencyId": "机构ID",
    "agencyName": "机构名称"
  },
  "dzcls": [
    {
      "id": "材料ID",
      "name": "材料名称",
      "url": "文件URL",
      "downloadUrl": "下载URL"
    }
  ]
}
```

2. **举报核查操作记录**
```json
{
  "id": "记录ID",
  "pcid": "关联的举报核查ID",
  "operType": "操作类型",
  "operBy": "操作人",
  "operAccountBy": "操作人账户",
  "operTime": "操作时间"
}
```

3. **举报核查查询条件**
```json
{
  "reporterName": "举报人姓名",
  "reportCanal": "举报渠道",
  "dataSource": "数据来源",
  "page": 1,
  "pageSize": 10,
  "sort": "createTime",
  "dir": "desc"
}
```

#### 界面设计

#### 数据模型

```json
// 创建/更新督导检查请求
{
  "type": "single",
  "enterprise": {
    "enterpriseId": "ent1234567890abcdefghijklmn"
  },
  "agency": {
    "agencyId": "age1234567890abcdefghijklmn"
  },
  "description": "2023年第四季度例行督导检查",
  "checkType": "routine"
}

// 批量创建督导检查请求
{
  "type": "multiple",
  "enterprises": [
    {"enterpriseId": "ent1234567890abcdefghijklm1"},
    {"enterpriseId": "ent1234567890abcdefghijklm2"}
  ],
  "agency": {
    "agencyId": "age1234567890abcdefghijklmn"
  },
  "description": "2023年第四季度批量督导检查",
  "checkType": "special"
}

// 查询参数
{
  "enterpriseId": "ent1234567890abcdefghijklmn",
  "agencyId": "age1234567890abcdefghijklmn",
  "checkStatus": "pending",
  "deliverTime": ["2023-01-01T00:00:00", "2023-12-31T23:59:59"],
  "page": 1,
  "pageSize": 10,
  "sort": "deliverTime",
  "dir": "desc"
}

// 统计查询参数
{
  "gxdwbm": "123456",
  "ilevel": 3
}

// 统计响应结果
{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "jurisdictionCode": "123456",
      "jurisdictionName": "XX市局",
      "jurisdictionLevel": 3,
      "hasChildren": 1,
      "checks": 120,
      "steers": 80,
      "crosss": 30,
      "reports": 10
    },
    {
      "jurisdictionCode": "123457",
      "jurisdictionName": "XX分局",
      "jurisdictionLevel": 4,
      "hasChildren": 0,
      "checks": 50,
      "steers": 30,
      "crosss": 15,
      "reports": 5
    }
  ]
}
```

#### 界面设计

### 交叉互查
#### 功能说明
交叉互查功能是督导检查模块的一部分，用于实现不同执法机构之间的相互检查和监督。主要功能包括：
- 创建和分配交叉检查任务
- 跟踪检查任务的执行状态
- 记录检查结果和整改情况
- 统计和分析交叉检查数据

#### 类定义

| 类名 | SupervisionCheckController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getSupervisionChecksPage(SupervisionCheckQuery query, RemoteUserInfo user): PageResult<SupervisionCheck> |
| 描述 | 分页查询督导检查信息 |
| 定义 | createSupervisionCheck(@RequestBody SupervisionCheckDto supervisionCheckDto, @CurrentUser RemoteUserInfo user): Result<Void> |
| 描述 | 创建督导检查任务 |
| 定义 | getSupervisionCheckById(@PathVariable String checkId): Result<SupervisionCheck> |
| 描述 | 根据ID查询督导检查详情 |
| 定义 | updateSupervisionCheckStatus(@PathVariable String checkId, @RequestParam CheckStatus checkStatus): Result<SupervisionCheck> |
| 描述 | 更新督导检查状态 |
| 定义 | checkStatistics(SupervisionCheckQuery query, @CurrentUser RemoteUserInfo user): Result<List<SupervisionCheckStatisticsDto>> |
| 描述 | 督导检查统计 |

| 类名 | SupervisionCheckService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveSupervisionChecks(SupervisionCheckDto supervisionCheckDto, RemoteUserInfo user): void |
| 描述 | 保存督导检查信息 |
| 定义 | findSupervisionCheckById(String checkId): Optional<SupervisionCheck> |
| 描述 | 根据ID查询督导检查信息 |
| 定义 | updateSupervisionCheckStatus(String checkId, CheckStatus checkStatus): Optional<SupervisionCheck> |
| 描述 | 更新督导检查状态 |
| 定义 | checkStatistics(SupervisionCheckQuery query, RemoteUserInfo user): List<SupervisionCheckStatisticsDto> |
| 描述 | 督导检查统计 |

| 类名 | SupervisionCheck |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | checkId: String |
| 描述 | 督导检查ID |
| 定义 | enterpriseId: String |
| 描述 | 被检查企业ID |
| 定义 | agencyId: String |
| 描述 | 执法机构ID |
| 定义 | enforcementId: String |
| 描述 | 执法信息ID |
| 定义 | deliverTime: LocalDateTime |
| 描述 | 转交时间 |
| 定义 | deliverAgencyId: String |
| 描述 | 转交机构ID |
| 定义 | deliverAgencyLevel: Integer |
| 描述 | 转交机构级别 |
| 定义 | deliverPerson: String |
| 描述 | 转交人 |
| 定义 | checkStatus: CheckStatus |
| 描述 | 检查状态 |
| 定义 | description: String |
| 描述 | 检查描述 |
| 定义 | checkType: String |
| 描述 | 检查类型 |

#### 界面设计

### 扫码入企
#### 功能说明
扫码入企功能提供企业二维码生成和验证服务，用于执法人员快速记录企业访问信息。主要功能包括：
- 生成临时的企业访问二维码
- 验证二维码有效性
- 检查二维码状态
- 记录企业访问信息

#### 类定义

| 类名 | QrCodeController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | generateQrCode(): Result<String> |
| 描述 | 生成新的二维码token，返回包含token的完整URL |
| 定义 | validateToken(String token, String enforcementId): Result<Void> |
| 描述 | 验证二维码token，并与企业ID关联 |
| 定义 | checkStatus(String token): Result<String> |
| 描述 | 检查二维码的当前状态 |

| 类名 | QrCodeService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | generateQrCode(): String |
| 描述 | 生成唯一的二维码token并存储到Redis，设置10分钟过期时间 |
| 定义 | validateToken(String token, String enforcementId): void |
| 描述 | 验证token有效性并关联企业ID |
| 定义 | checkStatus(String token): String |
| 描述 | 检查token状态，返回"pending"或验证后的企业信息 |

#### 界面设计

### 检查表管理
#### 功能说明
检查表管理模块用于创建、维护和管理执法检查过程中使用的检查表模板。检查表包含多个检查项，用于规范执法检查过程，确保检查的全面性和一致性。主要功能包括：
- 检查表的创建、编辑、删除和查询
- 检查表的启用/禁用管理
- 检查表与检查项的关联管理
- 检查表的分类和检索

#### 类定义

| 类名 | ChecklistController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createChecklist(Checklist checklist, RemoteUserInfo user): Result<Checklist> |
| 描述 | 创建检查表 |
| 定义 | getChecklistById(String checklistId): Result<Checklist> |
| 描述 | 根据ID查询检查表 |
| 定义 | updateChecklist(String checklistId, Checklist checklist, RemoteUserInfo user): Result<Checklist> |
| 描述 | 更新检查表 |
| 定义 | deleteChecklistById(String checklistId): Result<Void> |
| 描述 | 删除检查表 |
| 定义 | deleteChecklistByIds(List<String> checklistIds): Result<Void> |
| 描述 | 批量删除检查表 |
| 定义 | getChecklistList(ChecklistQuery query): Result<Page<Checklist>> |
| 描述 | 分页查询检查表列表 |

| 类名 | ChecklistService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveChecklist(Checklist checklist, RemoteUserInfo user, String type): Checklist |
| 描述 | 保存检查表信息 |
| 定义 | findChecklistById(String checklistId): Optional<Checklist> |
| 描述 | 根据ID查询检查表 |
| 定义 | deleteChecklistById(String checklistId): void |
| 描述 | 删除检查表 |
| 定义 | deleteChecklistByIds(List<String> checklistIds): void |
| 描述 | 批量删除检查表 |
| 定义 | getChecklistList(ChecklistQuery query): List<Checklist> |
| 描述 | 获取检查表列表 |

| 类名 | Checklist |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | checklistId: String |
| 描述 | 检查表ID |
| 定义 | checklistName: String |
| 描述 | 检查表名称 |
| 定义 | description: String |
| 描述 | 检查表描述 |
| 定义 | enabled: Boolean |
| 描述 | 是否启用 |
| 定义 | isRemove: Boolean |
| 描述 | 是否删除 |
| 定义 | removeTime: LocalDateTime |
| 描述 | 删除时间 |
| 定义 | createTime: LocalDateTime |
| 描述 | 创建时间 |

| 类名 | CheckItem |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | itemId: String |
| 描述 | 检查项ID |
| 定义 | itemName: String |
| 描述 | 检查项名称 |
| 定义 | checklist: Checklist |
| 描述 | 所属检查表 |
| 定义 | itemTable: String |
| 描述 | 检查项表名 |
| 定义 | sort: Integer |
| 描述 | 排序号 |
| 定义 | enabled: Boolean |
| 描述 | 是否启用 |

#### 处理流程

1. **创建检查表**
   - 用户填写检查表基本信息（名称、描述等）
   - 系统验证信息完整性
   - 保存检查表信息
   - 返回创建结果

2. **更新检查表**
   - 用户修改检查表信息
   - 系统验证检查表存在
   - 更新检查表信息
   - 返回更新结果

3. **删除检查表**
   - 用户选择要删除的检查表
   - 系统验证检查表是否被使用
   - 标记检查表为删除状态
   - 更新删除时间和操作人

4. **查询检查表**
   - 用户输入查询条件
   - 系统根据条件检索检查表
   - 返回分页结果

#### 数据模型

```json
{
  "checklistId": "检查表ID",
  "checklistName": "安全生产检查表",
  "description": "用于企业安全生产检查的标准检查表",
  "enabled": true,
  "isRemove": false,
  "createTime": "2023-01-01 12:00:00",
  "createdBy": "创建人",
  "createdAccountBy": "创建账号",
  "updateTime": "2023-01-01 12:00:00"
}
```

#### 状态流转
- 新建 → 已保存
- 已保存 → 已启用/已停用
- 已启用/已停用 → 已删除

#### 界面设计

### 自定义检查事项
#### 功能说明
自定义检查事项模块允许用户根据实际需求创建和管理个性化的检查项目，用于执法检查过程中。主要功能包括：
- 检查事项的创建、编辑、删除和查询
- 检查事项的启用/禁用管理
- 检查事项与检查表的关联管理
- 检查事项的分类和检索

#### 类定义

| 类名 | CheckItemController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createCheckItem(CheckItem checkItem, RemoteUserInfo user): Result<CheckItem> |
| 描述 | 创建检查项 |
| 定义 | getCheckItemById(String itemId): Result<CheckItem> |
| 描述 | 根据ID查询检查项 |
| 定义 | updateCheckItem(String itemId, CheckItem checkItem, RemoteUserInfo user): Result<CheckItem> |
| 描述 | 更新检查项 |
| 定义 | deleteCheckItemById(String itemId): Result<Void> |
| 描述 | 删除检查项 |
| 定义 | deleteCheckItemByIds(List<String> itemIds): Result<Void> |
| 描述 | 批量删除检查项 |
| 定义 | getCheckItems(CheckItemQuery query): Result<List<CheckItem>> |
| 描述 | 查询检查项列表 |

| 类名 | CheckItemService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveCheckItem(CheckItem checkItem, RemoteUserInfo user, String type): CheckItem |
| 描述 | 保存检查项信息 |
| 定义 | findCheckItemById(String itemId): Optional<CheckItem> |
| 描述 | 根据ID查询检查项 |
| 定义 | deleteCheckItemById(String itemId): void |
| 描述 | 删除检查项 |
| 定义 | deleteCheckItemByIds(List<String> itemIds): void |
| 描述 | 批量删除检查项 |
| 定义 | findCheckItems(CheckItemQuery query): List<CheckItem> |
| 描述 | 查询检查项列表 |

| 类名 | CheckItem |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | itemId: String |
| 描述 | 检查项ID |
| 定义 | itemName: String |
| 描述 | 检查项名称 |
| 定义 | itemTable: String |
| 描述 | 检查项表名 |
| 定义 | sort: Integer |
| 描述 | 排序号 |
| 定义 | enabled: Boolean |
| 描述 | 是否启用 |
| 定义 | createTime: LocalDateTime |
| 描述 | 创建时间 |
| 定义 | updateTime: LocalDateTime |
| 描述 | 更新时间 |
| 定义 | createdBy: String |
| 描述 | 创建人 |
| 定义 | createdAccountBy: String |
| 描述 | 创建账号 |

| 类名 | CheckItemQuery |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.query |
| 定义 | itemTable: String |
| 描述 | 检查项表名 |
| 定义 | enabled: Boolean |
| 描述 | 是否启用 |

#### 处理流程

1. **创建检查项**
   - 用户填写检查项基本信息（名称、表名等）
   - 系统验证信息完整性
   - 保存检查项信息
   - 返回创建结果

2. **更新检查项**
   - 用户修改检查项信息
   - 系统验证检查项存在
   - 更新检查项信息
   - 返回更新结果

3. **删除检查项**
   - 用户选择要删除的检查项
   - 系统验证检查项是否被使用
   - 删除检查项
   - 返回删除结果

4. **查询检查项**
   - 用户输入查询条件
   - 系统根据条件检索检查项
   - 返回结果列表

#### 数据模型

```json
{
  "itemId": "检查项ID",
  "itemName": "安全出口检查",
  "itemTable": "safety_check",
  "sort": 1,
  "enabled": true,
  "createTime": "2023-01-01 12:00:00",
  "updateTime": "2023-01-01 12:00:00",
  "createdBy": "创建人",
  "createdAccountBy": "创建账号"
}
```

#### 状态流转
- 新建 → 已保存
- 已保存 → 已启用/已停用
- 已启用/已停用 → 已删除

#### 界面设计

### 执法文书管理
#### 功能说明
执法文书管理模块负责管理执法过程中产生的各类法律文书，包括文书的创建、上传、查询、下载和状态管理。主要功能包括：
- 文书信息的新增、编辑、删除和查询
- 文书状态管理（进行中、完成）
- 文书文件上传和下载
- 文书与案件关联管理
- 文书编号和序号管理

#### 类定义

| 类名 | DocumentController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getDocumentPage(DocumentQuery query): PageResult<Document> |
| 描述 | 分页查询文书信息 |
| 定义 | geDocumentList(DocumentQuery query): Result<List<Document>> |
| 描述 | 查询文书信息列表（不分页） |
| 定义 | getDocumentById(String documentId): Result<Document> |
| 描述 | 根据ID查询文书信息 |
| 定义 | findByCaseIdAndDocumentName(DocumentQuery query): Result<Document> |
| 描述 | 根据案件ID和文书名称查询文书 |
| 定义 | createDocument(Document document): Result<Document> |
| 描述 | 创建文书信息 |
| 定义 | updateDocument(String documentId, Document document): Result<Document> |
| 描述 | 更新文书信息 |
| 定义 | deleteDocumentById(String documentId): Result<Void> |
| 描述 | 删除文书信息 |
| 定义 | deleteDocumentsByIds(List<String> documentIds): Result<Void> |
| 描述 | 批量删除文书信息 |
| 定义 | addDocumentFile(FormDataDto formData): Result<Document> |
| 描述 | 上传执法文书文件 |

| 类名 | DocumentService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | findDocumentsPage(DocumentQuery query): Page<Document> |
| 描述 | 分页查询文书信息 |
| 定义 | listDocuments(DocumentQuery query): List<Document> |
| 描述 | 查询文书信息列表 |
| 定义 | findDocumentById(String documentId): Optional<Document> |
| 描述 | 根据ID查询文书信息 |
| 定义 | findByCaseIdAndDocumentName(String caseId, String documentName): Optional<Document> |
| 描述 | 根据案件ID和文书名称查询文书 |
| 定义 | saveDocument(Document document): Document |
| 描述 | 保存文书信息 |
| 定义 | deleteDocumentById(String documentId): void |
| 描述 | 删除文书信息 |
| 定义 | deleteDocumentsByIds(List<String> documentIds): void |
| 描述 | 批量删除文书信息 |
| 定义 | addDocumentFile(FormDataDto formData): Document |
| 描述 | 上传文书文件 |

| 类名 | Document |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | documentId: String |
| 描述 | 文书ID |
| 定义 | documentCode: String |
| 描述 | 文书编号 |
| 定义 | documentNo: Integer |
| 描述 | 文书序号 |
| 定义 | documentName: String |
| 描述 | 文书名称 |
| 定义 | documentDate: LocalDateTime |
| 描述 | 文书日期 |
| 定义 | filePath: String |
| 描述 | 文件路径 |
| 定义 | caseId: String |
| 描述 | 关联案件ID |
| 定义 | caseInfo: Case |
| 描述 | 关联案件信息 |
| 定义 | status: DocumentStatus |
| 描述 | 文书状态 |
| 定义 | downloadUrl: String |
| 描述 | 下载地址 |
| 定义 | DocumentStatus 枚举 |
| 描述 | 文书状态枚举，包含：afoot(进行中)、done(完成) |

| 类名 | DocumentQuery |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.query |
| 定义 | caseId: String |
| 描述 | 案件ID |
| 定义 | documentNo: Integer |
| 描述 | 文书序号 |
| 定义 | conditionlike: String |
| 描述 | 模糊查询条件 |
| 定义 | caseName: String |
| 描述 | 案件名称 |
| 定义 | caseNum: String |
| 描述 | 案件编号 |
| 定义 | documentCode: Integer |
| 描述 | 文书编号 |
| 定义 | documentName: String |
| 描述 | 文书名称 |
| 定义 | documentDate: LocalDateTime[] |
| 描述 | 文书日期范围 |

#### 处理流程

1. **文书创建**
   - 用户填写文书基本信息（名称、编号等）
   - 系统验证信息完整性
   - 保存文书信息
   - 返回创建结果

2. **文书上传**
   - 用户选择文书文件
   - 系统验证文件格式和大小
   - 上传文件到文件服务器
   - 保存文件路径到文书信息
   - 更新文书状态

3. **文书查询**
   - 用户输入查询条件（案件ID、文书名称等）
   - 系统根据条件检索文书
   - 返回查询结果

4. **文书下载**
   - 用户选择要下载的文书
   - 系统根据文件路径获取文件流
   - 返回文件流给前端

5. **文书状态更新**
   - 用户更新文书状态
   - 系统验证状态变更是否合法
   - 更新文书状态
   - 返回更新结果

#### 数据模型

```json
{
  "documentId": "文书ID",
  "documentCode": "WS20230001",
  "documentNo": 1,
  "documentName": "立案审批表",
  "documentDate": "2023-01-01 12:00:00",
  "filePath": "/documents/WS20230001.pdf",
  "caseId": "案件ID",
  "status": "afoot",
  "downloadUrl": "http://example.com/api/documents/WS20230001/download"
}
```

#### 状态流转
- 新建 → 进行中
- 进行中 → 完成
- 完成 → 归档

#### 界面设计

### 案卷资料清单
#### 功能说明
案卷资料清单模块用于管理执法案件相关的所有文书和资料，确保案件材料的完整性和可追溯性。主要功能包括：
- 案卷文书的创建、编辑、删除和查询
- 文书文件的上传和下载
- 文书状态的跟踪和管理
- 案卷资料的完整性检查
- 文书与案件的关联管理

#### 类定义

| 类名 | DocumentController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getDocumentPage(DocumentQuery query): PageResult<Document> |
| 描述 | 分页查询文书信息 |
| 定义 | geDocumentList(DocumentQuery query): Result<List<Document>> |
| 描述 | 查询文书信息（不分页） |
| 定义 | findByCaseIdAndDocumentName(DocumentQuery query): Result<Document> |
| 描述 | 根据案件ID和文书名称查询文书 |
| 定义 | createOfficer(@RequestBody Document document): Result<Document> |
| 描述 | 创建文书 |
| 定义 | updateDocument(String documentId, @RequestBody Document document): Result<Document> |
| 描述 | 更新文书信息 |
| 定义 | deleteDocumentById(String documentId): Result<Void> |
| 描述 | 根据ID删除文书 |
| 定义 | deleteDocumentsByIds(List<String> documentIds): Result<Void> |
| 描述 | 批量删除文书 |
| 定义 | addDocumentFile(FormDataDto formData): Result<Document> |
| 描述 | 上传文书文件 |

| 类名 | DocumentService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | findDocumentsPage(DocumentQuery query): Page<Document> |
| 描述 | 分页查询文书信息 |
| 定义 | listDocuments(DocumentQuery query): List<Document> |
| 描述 | 查询文书列表 |
| 定义 | findByCaseIdAndDocumentName(String caseId, String documentName): Optional<Document> |
| 描述 | 根据案件ID和文书名称查询文书 |
| 定义 | saveDocument(Document document): Document |
| 描述 | 保存文书信息 |
| 定义 | deleteDocumentById(String documentId): void |
| 描述 | 根据ID删除文书 |
| 定义 | deleteDocumentsByIds(List<String> documentIds): void |
| 描述 | 批量删除文书 |
| 定义 | addDocumentFile(FormDataDto formData): Document |
| 描述 | 上传文书文件 |

| 类名 | Document |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | documentId: String |
| 描述 | 文书ID |
| 定义 | documentCode: String |
| 描述 | 文书编号 |
| 定义 | documentNo: Integer |
| 描述 | 文书序号 |
| 定义 | documentName: String |
| 描述 | 文书名称 |
| 定义 | documentType: String |
| 描述 | 文书类型 |
| 定义 | documentDate: LocalDateTime |
| 描述 | 文书日期 |
| 定义 | documenContent: Map<String,Object> |
| 描述 | 文书内容(JSON) |
| 定义 | filePath: String |
| 描述 | 文件路径 |
| 定义 | fileName: String |
| 描述 | 文件名称 |
| 定义 | caseId: String |
| 描述 | 关联案件ID |
| 定义 | caseInfo: Case |
| 描述 | 关联案件信息 |
| 定义 | status: DocumentStatus |
| 描述 | 文书状态(afoot:进行中, done:完成) |
| 定义 | downloadUrl: String |
| 描述 | 下载地址 |

| 类名 | DocumentQuery |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.query |
| 定义 | caseId: String |
| 描述 | 案件ID |
| 定义 | documentNo: Integer |
| 描述 | 文书序号 |
| 定义 | conditionlike: String |
| 描述 | 模糊查询条件 |
| 定义 | caseName: String |
| 描述 | 案件名称 |
| 定义 | caseNum: String |
| 描述 | 案件编号 |
| 定义 | documentCode: Integer |
| 描述 | 文书编号 |
| 定义 | documentName: String |
| 描述 | 文书名称 |
| 定义 | documentDate: LocalDateTime[] |
| 描述 | 文书日期范围 |

#### 处理流程

1. **文书创建**
   - 用户填写文书基本信息（名称、编号、类型等）
   - 系统验证信息完整性
   - 保存文书信息
   - 返回创建结果

2. **文书上传**
   - 用户选择文书文件
   - 系统验证文件格式和大小
   - 上传文件到文件服务器
   - 保存文件路径到文书信息
   - 更新文书状态

3. **文书查询**
   - 用户输入查询条件（案件ID、文书名称、日期范围等）
   - 系统根据条件检索文书
   - 返回查询结果（支持分页）

4. **文书下载**
   - 用户选择要下载的文书
   - 系统根据文件路径获取文件流
   - 返回文件流给前端

5. **文书状态更新**
   - 用户更新文书状态
   - 系统验证状态变更是否合法
   - 更新文书状态
   - 返回更新结果

#### 数据模型

```json
{
  "documentId": "doc_1234567890abcdefghijklmn",
  "documentCode": "WS20230001",
  "documentNo": 1,
  "documentName": "立案审批表",
  "documentType": "APPROVAL",
  "documentDate": "2023-01-01T12:00:00",
  "documenContent": {
    "caseName": "XX公司违法经营案",
    "caseReason": "无证经营",
    "applicant": "张某某",
    "approvalOpinion": "同意立案"
  },
  "filePath": "/documents/WS20230001.pdf",
  "fileName": "立案审批表.pdf",
  "caseId": "case_1234567890abcdefghijklmn",
  "status": "done",
  "downloadUrl": "http://example.com/api/documents/WS20230001/download"
}
```

#### 状态流转
- 新建 → 进行中（afoot）
- 进行中 → 完成（done）
- 完成 → 归档

#### 界面设计
- 案卷资料列表页：展示案件相关的所有文书，支持按状态、类型、日期等筛选
- 文书详情页：展示文书详细信息和内容，支持在线预览和下载
- 文书上传页：上传文书文件，填写文书信息
- 文书编辑页：编辑文书信息和内容
- 文书状态管理页：管理文书的状态流转

## 非现场执法管理
### 非现场执法管理（统计）
#### 功能说明
非现场执法管理模块提供在线巡查、企业预警、执法统计等功能，支持执法人员通过网络远程开展执法检查工作，提高执法效率。

主要功能包括：
- 企业接入情况统计
- 企业类型接入统计
- 非现场执法总数统计
- 企业预警信息管理
- 非现场执法数据统计
- 监控预警信息查询

#### 类定义

| 类名 | OffSiteLawEnforceController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getQyjrtj(): Result<Long> |
| 描述 | 获取企业接入统计 |
| 定义 | getQyjrlxtj(): Result<Map> |
| 描述 | 获取企业类型接入统计 |
| 定义 | getFxczfzs(): Result<Map> |
| 描述 | 获取非现场执法总数 |
| 定义 | getQyyjtj(): Result<List> |
| 描述 | 获取企业预警统计 |
| 定义 | getFxczftj(String type): Result<List> |
| 描述 | 获取非现场执法统计 |

| 类名 | OffSiteLawEnforceService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | getQyjrtj(): Long |
| 描述 | 获取企业接入数量统计 |
| 定义 | getQyjrlxtj(): Map<String, Long> |
| 描述 | 获取企业类型接入统计 |
| 定义 | getFxczfzs(): Map<String, Long> |
| 描述 | 获取非现场执法总数 |
| 定义 | getQyyjtj(): List<Map<String, Object>> |
| 描述 | 获取企业预警统计 |
| 定义 | getFxczftj(String type): List<Map<String, Object>> |
| 描述 | 获取非现场执法统计 |

| 类名 | EnterpriseWarn |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | - |
| 描述 | 企业预警信息实体类 |

| 类名 | OnlinePatrol |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | - |
| 描述 | 在线巡查信息实体类 |

#### 处理流程

1. **企业接入统计**
   - 查询企业接入总数
   - 按企业类型分类统计
   - 返回统计结果

2. **非现场执法统计**
   - 按时间范围查询执法数据
   - 按机构分类统计执法次数
   - 生成统计报表

3. **企业预警处理**
   - 接收企业预警信息
   - 保存预警记录
   - 通知相关人员处理
   - 更新处理状态

4. **在线巡查**
   - 创建在线巡查任务
   - 上传巡查记录和附件
   - 提交审批
   - 审批通过后生成执法记录

#### 数据模型

```json
// 在线巡查信息
{
  "onlinePatrolId": "patrol_1234567890abcdefghijklmn",
  "enterpriseId": "ent_1234567890abcdefghijklmn",
  "agencyId": "agency_1234567890abcdefghijklmn",
  "description": "在线巡查情况说明",
  "createTime": "2023-01-01T12:00:00",
  "createUserId": "user_1234567890abcdefghijklmn",
  "createUserName": "张三",
  "approvalStatus": "1",
  "approvalUserId": "user_1234567890abcdefghijklmn",
  "approvalUserName": "李四",
  "approvalReceipt": "同意",
  "isCreateEnforce": "1",
  "enforcementId": "enforce_1234567890abcdefghijklmn"
}

// 企业预警信息
{
  "id": "warn_1234567890abcdefghijklmn",
  "alarmId": "1001",
  "apiType": "2001",
  "eventDesc": "人员聚集",
  "cameraName": "大门摄像头01",
  "address": "XX公司大门",
  "imageUrl": "http://example.com/images/alert_001.jpg",
  "time": "2023-01-01T12:00:00",
  "videoUrl": "http://example.com/videos/alert_001.mp4",
  "confidence": "0.95",
  "judgment": 2
}
```

#### 状态流转

1. **在线巡查状态**
   - 待提交(0) → 待审批(1) → 已通过(2)/已拒绝(3)
   - 审批通过后可选择是否创建执法记录

2. **企业预警状态**
   - 未处理(2) → 处理中(1) → 已处理(0)
   - 支持标记为误报

#### 界面设计

### 在线巡查审批
#### 功能说明
在线巡查审批模块负责处理执法人员提交的在线巡查记录的审批流程，确保巡查工作的规范性和有效性。

主要功能包括：
- 巡查记录提交与审批
- 审批流程管理
- 审批意见填写
- 审批状态跟踪
- 巡查记录查询
- 附件管理

#### 类定义

| 类名 | OnlinePatrolController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createOnlinePatrol(OnlinePatrolDto onlinePatrolDto): Result<Void> |
| 描述 | 创建在线巡查记录 |
| 定义 | getOnlinePatrolPage(OnlinePatrolQuery query): PageResult<OnlinePatrol> |
| 描述 | 分页查询在线巡查记录 |
| 定义 | createOnlinePatrolApproval(OnlinePatrolDto onlinePatrolDto, RemoteUserInfo user): Result<Void> |
| 描述 | 处理在线巡查审批 |

| 类名 | OnlinePatrolService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveOnlinePatrol(OnlinePatrolDto onlinePatrolDto): void |
| 描述 | 保存在线巡查记录 |
| 定义 | saveOnlinePatrolApproval(OnlinePatrolDto onlinePatrolDto, RemoteUserInfo user): void |
| 描述 | 处理在线巡查审批 |
| 定义 | findOnlinePatrolPage(OnlinePatrolQuery query): Page<OnlinePatrol> |
| 描述 | 分页查询在线巡查记录 |

| 类名 | OnlinePatrol |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | onlinePatrolId: String |
| 描述 | 在线巡查信息唯一ID |
| 定义 | enterpriseId: String |
| 描述 | 被巡查企业ID |
| 定义 | agencyId: String |
| 描述 | 执法机构ID |
| 定义 | description: String |
| 描述 | 巡查情况说明 |
| 定义 | annexs: List<Map<String, Object>> |
| 描述 | 附件列表 |
| 定义 | createTime: LocalDateTime |
| 描述 | 创建时间 |
| 定义 | createUserId: String |
| 描述 | 创建人ID |
| 定义 | createUserName: String |
| 描述 | 创建人姓名 |
| 定义 | approvalStatus: String |
| 描述 | 审批状态(0待审批,1通过,2拒绝) |
| 定义 | approvalUserId: String |
| 描述 | 审批人ID |
| 定义 | approvalUserName: String |
| 描述 | 审批人姓名 |
| 定义 | approvalReceipt: String |
| 描述 | 审批意见 |
| 定义 | isCreateEnforce: String |
| 描述 | 是否创建执法信息(1创建,2不创建) |
| 定义 | enforcementId: String |
| 描述 | 关联的执法信息ID |

#### 处理流程

1. **巡查记录提交**
   - 执法人员填写巡查信息
   - 上传相关附件
   - 提交巡查记录
   - 系统生成待审批状态记录

2. **审批处理**
   - 审批人查看待审批的巡查记录
   - 填写审批意见
   - 选择通过或拒绝
   - 如通过可选择是否创建执法信息
   - 更新巡查记录状态

3. **审批结果处理**
   - 如审批通过且选择创建执法信息，则生成执法信息记录
   - 如审批拒绝，则记录拒绝原因
   - 更新相关企业档案

4. **记录查询**
   - 支持按企业名称、巡查时间等条件查询
   - 支持分页显示
   - 可查看巡查详情及审批记录

#### 数据模型

```json
// 在线巡查记录
{
  "onlinePatrolId": "patrol_1234567890abcdefghijklmn",
  "enterpriseId": "ent_1234567890abcdefghijklmn",
  "enterprise": {
    "unitName": "XX公司",
    "unifiedSocialCode": "91310101MA1ABCDEFG"
  },
  "agencyId": "agency_1234567890abcdefghijklmn",
  "agency": {
    "agencyName": "XX执法大队"
  },
  "description": "巡查发现企业存在...问题",
  "createTime": "2023-01-01T10:00:00",
  "createUserId": "user_1234567890abcdefghijklmn",
  "createUserName": "张三",
  "approvalStatus": "1",
  "approvalUserId": "user_9876543210zyxwvutsrqpo",
  "approvalUserName": "李四",
  "approvalReceipt": "情况属实，同意处理",
  "isCreateEnforce": "1",
  "enforcementId": "enforce_1234567890abcdefghijklmn"
}
```

#### 界面设计

### 非现场执法统计
#### 功能说明
非现场执法统计模块提供对在线巡查和执法数据的综合统计分析功能，帮助管理人员全面掌握执法工作情况和趋势。

主要功能包括：
- 企业接入情况统计
- 企业类型分布统计
- 非现场执法总数统计
- 企业预警统计
- 非现场执法趋势分析
- 按机构统计执法数据

#### 类定义

| 类名 | OffSiteLawEnforceController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getQyjrtj(): Result<Long> |
| 描述 | 获取企业接入统计 |
| 定义 | getQyjrlxtj(): Result<Map> |
| 描述 | 获取企业类型统计 |
| 定义 | getFxczfzs(): Result<Map> |
| 描述 | 获取非现场执法总数 |
| 定义 | getQyyjtj(): Result<List> |
| 描述 | 获取企业预警统计 |
| 定义 | getFxczftj(String type): Result<List> |
| 描述 | 获取非现场执法统计 |

| 类名 | OffSiteLawEnforceService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | getQyjrtj(): Long |
| 描述 | 查询企业接入总数 |
| 定义 | getQyjrlxtj(): Map<String, Long> |
| 描述 | 查询企业类型分布统计 |
| 定义 | getFxczfzs(): Map<String, Long> |
| 描述 | 获取非现场执法总数统计 |
| 定义 | getQyyjtj(): List<Map<String, Object>> |
| 描述 | 获取企业预警统计 |
| 定义 | getFxczftj(String type): List<Map<String, Object>> |
| 描述 | 获取非现场执法统计 |

| 类名 | OnlinePatrolRepository |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.repository |
| 定义 | getSumNum(): Long |
| 描述 | 获取巡查记录总数 |
| 定义 | getNumByCreatTime(LocalDateTime, LocalDateTime): Long |
| 描述 | 获取指定时间范围内的巡查记录数 |
| 定义 | getFxczftjByAgency(): List<Map<String, Object>> |
| 描述 | 按机构统计巡查记录 |
| 定义 | getfxczftjByMonth(LocalDateTime, LocalDateTime): List<Map<String, Object>> |
| 描述 | 按月统计巡查记录 |

#### 处理流程

1. **企业接入统计**
   - 查询企业总数
   - 返回企业数量

2. **企业类型统计**
   - 按企业类型分组统计
   - 返回各类型企业数量
   - 包括：矿山、危化、冶金、工贸、建筑施工、交通运输、其他等

3. **非现场执法总数统计**
   - 获取总巡查记录数
   - 获取近一周新增记录数
   - 获取近一月新增记录数
   - 获取近一年新增记录数
   - 返回统计结果

4. **企业预警统计**
   - 按预警类型分组统计
   - 返回各类型预警数量
   - 按数量降序排序

5. **非现场执法趋势分析**
   - 按类型参数区分统计方式
   - 按机构统计：返回各机构执法数量
   - 按月统计：返回近12个月每月执法数量
   - 支持图表展示

6. **数据更新**
   - 定时任务自动更新统计数据
   - 数据变更时增量更新

#### 数据模型

```json
// 企业类型统计
{
  "ks": 120,  // 矿山企业
  "wh": 85,   // 危化企业
  "jyz": 65,  // 冶金企业
  "gm": 230,  // 工贸企业
  "aqsc": 150, // 安全生产企业
  "jzsg": 95, // 建筑施工企业
  "yy": 110   // 运输企业
}

// 非现场执法总数统计
{
  "sumNum": 1560,   // 总数量
  "weekNum": 45,     // 本周新增
  "monthNum": 180,   // 本月新增
  "yearNum": 620     // 本年新增
}

// 企业预警统计
[
  {
    "eventDesc": "超员作业",
    "num": 45
  },
  {
    "eventDesc": "设备异常",
    "num": 32
  },
  // ...
]

// 按机构统计
[
  {
    "agency_name": "XX分局",
    "zs": 120
  },
  // ...
]

// 按月统计
[
  {
    "date": "2023-01",
    "zs": 25
  },
  // ...
]
```

#### 界面设计

## 执法文书送达
### 执法文书信息
#### 功能说明
执法文书信息模块负责管理执法过程中产生的各类法律文书，包括文书的创建、编辑、查询、删除等操作。主要功能包括：

- 文书信息管理：支持文书的增删改查操作
- 文书模板管理：支持不同类型的文书模板管理
- 文书编号生成：自动生成符合规范的文书编号
- 文书状态管理：跟踪文书的审批和完成状态
- 文书附件管理：支持上传、下载文书相关附件
- 文书查询统计：支持多条件组合查询和统计分析

#### 类定义

| 类名 | Document |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | documentId: String |
| 描述 | 文书ID |
| 定义 | documentCode: String |
| 描述 | 文书编号 |
| 定义 | documentNo: Integer |
| 描述 | 文书序号 |
| 定义 | documentName: String |
| 描述 | 文书名称 |
| 定义 | documentType: String |
| 描述 | 文书类型 |
| 定义 | documentDate: LocalDateTime |
| 描述 | 发件时间 |
| 定义 | documenContent: Map<String,Object> |
| 描述 | 文书内容JSON |
| 定义 | filePath: String |
| 描述 | 文书文件地址 |
| 定义 | fileName: String |
| 描述 | 文书文件名称 |
| 定义 | caseId: String |
| 描述 | 关联的案件ID |
| 定义 | status: DocumentStatus |
| 描述 | 文书状态(afoot:进行中, done:完成) |

| 类名 | DocumentController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | getDocumentPage(DocumentQuery): PageResult<Document> |
| 描述 | 分页查询文书信息 |
| 定义 | geDocumentList(DocumentQuery): Result<List<Document>> |
| 描述 | 查询文书列表(不分页) |
| 定义 | findByCaseIdAndDocumentName(DocumentQuery): Result<Document> |
| 描述 | 根据案件ID和文书名称查询文书 |
| 定义 | createOfficer(Document): Result<Document> |
| 描述 | 创建文书 |
| 定义 | updateDocument(String, Document): Result<Document> |
| 描述 | 更新文书信息 |
| 定义 | deleteDocumentById(String): Result<Void> |
| 描述 | 删除文书 |
| 定义 | deleteDocumentsByIds(List<String>): Result<Void> |
| 描述 | 批量删除文书 |
| 定义 | addDocumentFile(FormDataDto): Result<Document> |
| 描述 | 上传文书附件 |

| 类名 | DocumentService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | findDocumentsPage(DocumentQuery): Page<Document> |
| 描述 | 分页查询文书 |
| 定义 | listDocuments(DocumentQuery): List<Document> |
| 描述 | 查询文书列表 |
| 定义 | saveDocument(Document): Document |
| 描述 | 保存文书 |
| 定义 | deleteDocumentById(String): void |
| 描述 | 删除文书 |
| 定义 | deleteDocumentsByIds(List<String>): void |
| 描述 | 批量删除文书 |
| 定义 | addDocumentFile(FormDataDto): Document |
| 描述 | 上传文书附件 |

#### 处理流程

1. **文书创建流程**
   - 选择文书模板
   - 填写文书基本信息
   - 上传相关附件
   - 保存文书信息
   - 生成文书编号
   - 更新文书状态为"进行中"

2. **文书编辑流程**
   - 查询待编辑的文书
   - 修改文书内容
   - 更新附件（如需要）
   - 保存修改
   - 记录操作日志

3. **文书查询流程**
   - 设置查询条件（案件编号、文书类型、时间范围等）
   - 执行查询
   - 返回分页/列表结果
   - 支持导出查询结果

4. **文书删除流程**
   - 选择要删除的文书
   - 校验权限
   - 删除文书记录
   - 删除关联的附件
   - 记录操作日志

5. **附件管理流程**
   - 上传附件
   - 文件类型校验
   - 文件大小限制
   - 生成文件存储路径
   - 保存文件元数据
   - 提供文件下载

#### 数据模型

```json
// 文书信息
{
  "documentId": "doc_1234567890abcdefghijklmn",
  "documentCode": "WS20230001",
  "documentNo": 1,
  "documentName": "行政处罚决定书",
  "documentType": "PUNISH_DECISION",
  "documentDate": "2023-06-01T10:00:00",
  "documenContent": {
    "caseName": "XX公司违法案",
    "punishBasis": "《中华人民共和国XX法》第XX条",
    "punishContent": "罚款人民币10万元整",
    "executionDeadline": "2023-07-01"
  },
  "filePath": "/documents/2023/06/01/abc123.pdf",
  "fileName": "行政处罚决定书-XX公司.pdf",
  "caseId": "case_1234567890abcdefghijklm",
  "status": "done"
}

// 文书查询条件
{
  "caseId": "case_1234567890abcdefghijklm",
  "documentType": "PUNISH_DECISION",
  "documentDate": ["2023-01-01T00:00:00", "2023-12-31T23:59:59"],
  "status": "done",
  "page": 1,
  "pageSize": 10,
  "sort": "documentDate",
  "dir": "desc"
}
```

#### 界面设计

### 受送达人管理
#### 功能说明
受送达人管理模块负责管理法律文书送达的接收人信息，包括受送达人的基本信息和联系方式。主要功能包括：

- 受送达人信息管理：支持受送达人信息的增删改查操作
- 批量操作：支持批量删除受送达人记录
- 信息查询：支持按姓名、电话、地址等多条件组合查询
- 数据导出：支持将受送达人信息导出为Excel等格式
- 数据统计：统计受送达人相关数据，便于分析

#### 类定义

| 类名 | RecipientInfo |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model |
| 定义 | recipientId: String |
| 描述 | 送达人唯一标识 |
| 定义 | name: String |
| 描述 | 送达人姓名 |
| 定义 | sex: String |
| 描述 | 送达人性别 |
| 定义 | phone: String |
| 描述 | 送达人电话号码 |
| 定义 | email: String |
| 描述 | 送达人电子邮件地址 |
| 定义 | address: String |
| 描述 | 送达人住址 |
| 定义 | wechatId: String |
| 描述 | 送达人微信ID |
| 定义 | isDeleted: Boolean |
| 描述 | 删除标志 |
| 定义 | updateTime: LocalDateTime |
| 描述 | 更新时间 |
| 定义 | createdBy: String |
| 描述 | 创建人 |
| 定义 | createdAccountBy: String |
| 描述 | 创建人账户 |
| 定义 | createTime: LocalDateTime |
| 描述 | 创建时间 |

| 类名 | RecipientInfoController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | createRecipientInfo(RecipientInfo, RemoteUserInfo): Result<RecipientInfo> |
| 描述 | 创建受送达人信息 |
| 定义 | getRecipientInfoById(String): Result<RecipientInfo> |
| 描述 | 根据ID查询受送达人 |
| 定义 | getRecipientInfoPage(DeliveryQuery): PageResult<RecipientInfo> |
| 描述 | 分页查询受送达人 |
| 定义 | getRecipientInfoList(DeliveryQuery): Result<List<RecipientInfo>> |
| 描述 | 查询受送达人列表 |
| 定义 | updateRecipientInfo(String, RecipientInfo, RemoteUserInfo): Result<RecipientInfo> |
| 描述 | 更新受送达人信息 |
| 定义 | deleteRecipientInfoById(String): Result<Void> |
| 描述 | 删除受送达人 |
| 定义 | deleteRecipientInfoByIds(List<String>): Result<Void> |
| 描述 | 批量删除受送达人 |

| 类名 | RecipientInfoService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | saveRecipientInfo(RecipientInfo, RemoteUserInfo, String): RecipientInfo |
| 描述 | 保存受送达人信息 |
| 定义 | findRecipientInfoById(String): Optional<RecipientInfo> |
| 描述 | 根据ID查询受送达人 |
| 定义 | findRecipientInfoPage(DeliveryQuery): Page<RecipientInfo> |
| 描述 | 分页查询受送达人 |
| 定义 | getRecipientInfoList(DeliveryQuery): List<RecipientInfo> |
| 描述 | 查询受送达人列表 |
| 定义 | deleteRecipientInfoById(String): void |
| 描述 | 删除受送达人 |
| 定义 | deleteRecipientInfoByIds(List<String>): void |
| 描述 | 批量删除受送达人 |
| 定义 | existsRecipientInfoById(String): boolean |
| 描述 | 检查受送达人是否存在 |

#### 处理流程

1. **受送达人创建流程**
   - 填写受送达人基本信息（姓名、性别、电话等）
   - 验证必填字段
   - 保存受送达人信息
   - 记录操作日志

2. **受送达人查询流程**
   - 设置查询条件（姓名、电话、地址等）
   - 执行查询
   - 返回分页/列表结果
   - 支持导出查询结果

3. **受送达人更新流程**
   - 查询待更新的受送达人信息
   - 修改需要更新的字段
   - 保存更新
   - 记录操作日志

4. **受送达人删除流程**
   - 选择要删除的受送达人记录
   - 执行删除操作（逻辑删除）
   - 更新删除标志位
   - 记录操作日志

5. **批量删除流程**
   - 选择多条受送达人记录
   - 执行批量删除操作
   - 更新所有选中记录的删除标志位
   - 记录批量操作日志

#### 数据模型

```json
// 受送达人信息
{
  "recipientId": "rec_1234567890abcdefghijklm",
  "name": "张三",
  "sex": "1",
  "phone": "13800138000",
  "email": "zhangsan@example.com",
  "address": "北京市朝阳区某某街道123号",
  "wechatId": "zhangsan_wechat",
  "isDeleted": false,
  "updateTime": "2023-06-15T14:30:00",
  "createdBy": "管理员",
  "createdAccountBy": "admin",
  "createTime": "2023-06-10T09:15:00"
}

// 受送达人查询条件
{
  "name": "张",
  "phone": "1380013",
  "address": "北京",
  "page": 1,
  "pageSize": 10,
  "sort": "createTime",
  "dir": "desc"
}
```

#### 界面设计

### 送达业务统计
#### 功能说明
送达业务统计模块提供对文书送达业务数据的统计和分析功能，帮助管理人员了解送达业务的情况。主要功能包括：

- 按机构统计：按不同机构统计送达记录数量
- 按送达方式统计：统计不同送达方式的使用情况
- 时间范围统计：支持按不同时间范围进行统计
- 多维度分析：支持按机构层级、送达状态等多维度进行数据分析
- 数据导出：支持将统计结果导出为Excel等格式

#### 类定义

| 类名 | DeliveryRecordStatisticsDto |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.model.dto |
| 定义 | agencyCode: String |
| 描述 | 机构编码 |
| 定义 | deliveryMethodId: String |
| 描述 | 送达方式ID |
| 定义 | num: Long |
| 描述 | 统计数量 |

| 类名 | DeliveryRecordController |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.controller |
| 定义 | statistics(DeliveryQuery, RemoteUserInfo): Result<List<Map<String, Object>>> |
| 描述 | 送达业务统计接口 |

| 类名 | DeliveryRecordService |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.service |
| 定义 | statistics(DeliveryQuery, RemoteUserInfo): List<Map<String, Object>> |
| 描述 | 送达业务统计服务 |
| 定义 | categories(): Set<String> |
| 描述 | 获取所有启用的送达方式ID |

| 类名 | DeliveryRecordRepository |
| ---- | ---- |
| 包路径 | com.aisino.iles.lawenforcement.repository |
| 定义 | statistics(String): List<DeliveryRecordStatisticsDto> |
| 描述 | 按机构统计送达记录 |

#### 处理流程

1. **统计查询流程**
   - 设置查询条件（机构编码、时间范围等）
   - 调用统计服务获取数据
   - 按机构层级和送达方式聚合数据
   - 返回统计结果

2. **数据聚合流程**
   - 获取所有启用的送达方式
   - 按机构编码分组统计
   - 计算各机构下不同送达方式的数量
   - 汇总总数量

3. **结果返回流程**
   - 构建包含机构信息和统计数据的返回结果
   - 格式化数据供前端展示
   - 返回分页/列表形式的统计结果

#### 数据模型

```json
// 统计请求参数
{
  "agencyCode": "110000",
  "agencyLevel": 2,
  "startTime": "2023-01-01 00:00:00",
  "endTime": "2023-12-31 23:59:59"
}

// 统计结果
[
  {
    "agencyCode": "110000",
    "agencyName": "北京市公安局",
    "agencyLevel": 1,
    "hasChildren": 1,
    "method_1": 10,
    "method_2": 5,
    "method_3": 8,
    "total": 23
  },
  {
    "agencyCode": "110101",
    "agencyName": "东城分局",
    "agencyLevel": 2,
    "hasChildren": 0,
    "method_1": 5,
    "method_2": 2,
    "method_3": 3,
    "total": 10
  },
  {
    "agencyCode": "110102",
    "agencyName": "西城分局",
    "agencyLevel": 2,
    "hasChildren": 0,
    "method_1": 5,
    "method_2": 3,
    "method_3": 5,
    "total": 13
  }
]
```

#### 界面设计