# 西安应急综合执法
## 接口对接/提供APP接口/综合执法/执法机构管理
### 根据ID查询执法机构
系统接口设计
| 请求地址 | /api/lawenforcement/agencies/{agencyId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **路径参数** | |
| `agencyId` | 执法机构ID |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | object | 执法机构信息 |
| ├ `clientId` | string | 客户端ID 或者说 临时ID |
| ├ `agencyId` | string | 执法机构唯一ID（ULID） |
| ├ `agencyName` | string | 执法机构名称 |
| ├ `agencyCode` | string | 执法机构代码（唯一标识） |
| ├ `agencySimpleCode` | string | 执法机构简码(去偶数0) |
| ├ `agencyLevel` | integer | 执法机构级别 |
| ├ `leaf` | boolean | 是否为最下级 |
| ├ `orderNum` | integer | 排序号 |
| ├ `agencyPath` | string | 路径 |
| ├ `parent` | object | 父级机构 |
| └ `children` | array | 子级机构列表 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": false,
  "msg": "",
  "data": {
    "clientId": "",
    "agencyId": "",
    "agencyName": "",
    "agencyCode": "",
    "agencySimpleCode": "",
    "agencyLevel": 0,
    "leaf": false,
    "orderNum": 0,
    "agencyPath": "",
    "parent": {},
    "children": [
      {
        "clientId": "",
        "agencyId": "",
        "agencyName": "",
        "agencyCode": "",
        "agencySimpleCode": "",
        "agencyLevel": 0,
        "leaf": false,
        "orderNum": 0,
        "agencyPath": "",
        "parent": {},
        "children": [
          {}
        ]
      }
    ]
  }
}
```
### 分页查询执法机构
系统接口设计
| 请求地址 | /api/lawenforcement/agencies |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **Query 参数** | |
| `page` | integer | 当前页 |
| `pagesize` | integer | 每页记录数 |
| `total` | integer | 总记录数 |
| `sort` | string | 排序字段 |
| `dir` | string | 排序方向 |
| `limit` | boolean | 是否限制查询 |
| `agencyId` | string | 执法机构ID |
| `agencyCode` | string | 执法机构代码 |
| `agencyName` | string | 执法机构名称 |
| `parentId` | string | 上级机构ID |
| `agencyLevel` | string | 机构级别 |
| `contactPhone` | string | 联系电话 |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | array | 执法机构信息列表 |
| `total` | integer | 总记录数 |
| `page` | integer | 当前页 |
| `limit` | integer | 每页记录数 |
| `totalPages` | integer | 总页数 |
| `relation` | string | 数量关系 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": false,
  "msg": "",
  "data": [
    {
      "clientId": "",
      "agencyId": "",
      "agencyName": "",
      "agencyCode": "",
      "agencySimpleCode": "",
      "agencyLevel": 0,
      "leaf": false,
      "orderNum": 0,
      "agencyPath": "",
      "parent": {
        "clientId": "",
        "agencyId": "",
        "agencyName": "",
        "agencyCode": "",
        "agencySimpleCode": "",
        "agencyLevel": 0,
        "leaf": false,
        "orderNum": 0,
        "agencyPath": "",
        "parent": {},
        "children": [
          {}
        ]
      },
      "children": [
        {
          "clientId": "",
          "agencyId": "",
          "agencyName": "",
          "agencyCode": "",
          "agencySimpleCode": "",
          "agencyLevel": 0,
          "leaf": false,
          "orderNum": 0,
          "agencyPath": "",
          "parent": {},
          "children": [
            {}
          ]
        }
      ]
    }
  ],
  "total": 0,
  "page": 0,
  "limit": 0,
  "totalPages": 0,
  "relation": ""
}
```
### 查询执法机构列表
系统接口设计
| 请求地址 | /api/lawenforcement/agencies/list |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **Query 参数** | |
| `page` | integer | 当前页 |
| `pagesize` | integer | 每页记录数 |
| `total` | integer | 总记录数 |
| `sort` | string | 排序字段 |
| `dir` | string | 排序方向 |
| `limit` | boolean | 是否限制查询 |
| `agencyId` | string | 执法机构ID |
| `agencyCode` | string | 执法机构代码 |
| `agencyName` | string | 执法机构名称 |
| `parentId` | string | 上级机构ID |
| `agencyLevel` | string | 机构级别 |
| `contactPhone` | string | 联系电话 |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | array | 执法机构信息列表 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": false,
  "msg": "",
  "data": [
    {
      "clientId": "",
      "agencyId": "",
      "agencyName": "",
      "agencyCode": "",
      "agencySimpleCode": "",
      "agencyLevel": 0,
      "leaf": false,
      "orderNum": 0,
      "agencyPath": "",
      "parent": {
        "clientId": "",
        "agencyId": "",
        "agencyName": "",
        "agencyCode": "",
        "agencySimpleCode": "",
        "agencyLevel": 0,
        "leaf": false,
        "orderNum": 0,
        "agencyPath": "",
        "parent": {},
        "children": [
          {}
        ]
      },
      "children": [
        {
          "clientId": "",
          "agencyId": "",
          "agencyName": "",
          "agencyCode": "",
          "agencySimpleCode": "",
          "agencyLevel": 0,
          "leaf": false,
          "orderNum": 0,
          "agencyPath": "",
          "parent": {},
          "children": []
        }
      ]
    }
  ]
}
```
## 接口对接/提供APP接口/综合执法/执法信息
### 分页查询执法信息
系统接口设计
| 请求地址 | /api/lawenforcement/enforcements |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **Query 参数** | |
| `page` | integer | 当前页 |
| `pagesize` | integer | 每页记录数 |
| `sort` | string | 排序字段 |
| `dir` | string | 排序方向 |
| `enforcementId` | string | 执法信息ID |
| `agencyCode` | string | 机构代码 |
| `unitName` | string | 单位名称 |
| `startTime` | string | 开始时间 |
| `endTime` | string | 结束时间 |
| `currentNodeCode` | string | 当前节点code |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | array | 执法信息列表 |
| ├ `enforcementId` | string | 执法信息唯一ID |
| ├ `enterpriseId` | string | 企业ID |
| ├ `enterprise` | object | 企业信息 |
| ├ `agencyId` | string | 机构ID |
| ├ `agency` | object | 机构信息 |
| ├ `examineReportId` | string | 案件审查报告ID |
| ├ `examineReport` | object | 案件审查报告 |
| ├ `currentNodeCode` | string | 当前节点代码 |
| ├ `currentNode` | string | 当前节点 |
| ├ `createTime` | string | 创建时间 |
| ├ `updateTime` | string | 更新时间 |
| ├ `enforceChecks` | array | 现场检查记录列表 |
| ├ `checkItems` | array | 检查事项列表 |
| └ `caseInfo` | object | 案件信息 |
| `total` | integer | 总记录数 |
| `page` | integer | 当前页 |
| `limit` | integer | 每页记录数 |
| `totalPages` | integer | 总页数 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": [
    {
      "enforcementId": "enforce-id-123",
      "enterpriseId": "enterprise-id-456",
      "enterprise": {
        "unitName": "示例企业名称",
        "unifiedSocialCode": "91370100MA3W2T4J1X"
      },
      "agencyId": "agency-id-789",
      "agency": {
        "agencyName": "示例执法机构"
      },
      "examineReportId": "report-id-abc",
      "examineReport": {},
      "currentNodeCode": "NODE_01",
      "currentNode": "立案审批",
      "createTime": "2023-10-26T10:00:00",
      "updateTime": "2023-10-26T10:00:00",
      "enforceChecks": [],
      "checkItems": [],
      "caseInfo": {}
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10,
  "totalPages": 1
}
```
### 根据id查询执法信息
系统接口设计
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **路径参数** | |
| `enforcementId` | string | 执法信息id |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | object | 执法信息 |
| ├ `enforcementId` | string | 执法信息唯一ID |
| ├ `enterpriseId` | string | 企业ID |
| ├ `enterprise` | object | 企业信息 |
| ├ `agencyId` | string | 机构ID |
| ├ `agency` | object | 机构信息 |
| ├ `examineReportId` | string | 案件审查报告ID |
| ├ `examineReport` | object | 案件审查报告 |
| ├ `currentNodeCode` | string | 当前节点代码 |
| ├ `currentNode` | string | 当前节点 |
| ├ `createTime` | string | 创建时间 |
| ├ `updateTime` | string | 更新时间 |
| ├ `enforceChecks` | array | 现场检查记录列表 |
| ├ `checkItems` | array | 检查事项列表 |
| └ `caseInfo` | object | 案件信息 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": {
    "enforcementId": "enforce-id-123",
    "enterpriseId": "enterprise-id-456",
    "enterprise": {
      "unitName": "示例企业名称",
      "unifiedSocialCode": "91370100MA3W2T4J1X"
    },
    "agencyId": "agency-id-789",
    "agency": {
      "agencyName": "示例执法机构"
    },
    "examineReportId": "report-id-abc",
    "examineReport": {},
    "currentNodeCode": "NODE_01",
    "currentNode": "立案审批",
    "createTime": "2023-10-26T10:00:00",
    "updateTime": "2023-10-26T10:00:00",
    "enforceChecks": [],
    "checkItems": [],
    "caseInfo": {}
  }
}
```

## 接口对接/提供APP接口/综合执法/行政处罚流程
### 分页查询案件信息
系统接口设计
| 请求地址 | /api/lawenforcement/cases |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **Query 参数** | |
| **参数名称** | **类型** | **说明** |
| `page` | integer | 当前页 |
| `pagesize` | integer | 每页记录数 |
| `sort` | string | 排序字段 |
| `dir` | string | 排序方向 |
| `caseName` | string | 案件名称 |
| `caseNum` | string | 案件号 |
| `fillingDate` | array | 立案时间 (数组, e.g., ["2023-01-01", "2023-01-31"]) |
| `caseClosingDate` | array | 结案时间 (数组) |
| `archiveDate` | array | 归档时间 (数组) |
| `status` | string | 案件状态 |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | array | 案件信息列表 |
| `total` | integer | 总记录数 |
| `page` | integer | 当前页 |
| `limit` | integer | 每页记录数 |
| `totalPages` | integer | 总页数 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": [
    {
      "caseId": "case-id-123",
      "caseNum": "XZCF-2023-001",
      "caseName": "关于XX企业的违法案件",
      "caseCause": "违反安全生产法",
      "fillingDate": "2023-10-01",
      "status": "已立案"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10,
  "totalPages": 1
}
```

### 查询案件信息（单条）
系统接口设计
| 请求地址 | /api/lawenforcement/cases/{caseId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **路径参数** | |
| `caseId` | 案件id |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | object | 案件信息 |
| ├ `caseId` | string | 案件ID |
| ├ `caseNum` | string | 案件号 |
| ├ `caseName` | string | 案件名称 |
| ├ `caseCause` | string | 案由 |
| ├ `disposition` | string | 处理结果 |
| ├ `enterpriseId` | string | 企业ID |
| ├ `filedUserName` | string | 立案人姓名 |
| ├ `filedUserId` | string | 立案人ID |
| ├ `fillingDate` | string | 立案日期 |
| ├ `caseClosingDate` | string | 结案日期 |
| ├ `caseHandler` | string | 案件处理人 |
| ├ `archiveDate` | string | 归档日期 |
| ├ `caseSource` | string | 案件来源 |
| ├ `archivalNum` | string | 档案号 |
| ├ `shelfLife` | integer | 保存期限 |
| ├ `createdTime` | string | 创建时间 |
| ├ `updatedTime` | string | 更新时间 |
| ├ `status` | string | 案件状态 |
| ├ `enforcementId` | string | 执法信息ID |
| ├ `enforcementInfo` | object | 关联的执法信息 |
| └ `documents` | array | 关联的文书列表 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": false,
  "msg": "",
  "data": {
    "clientId": "",
    "caseId": "case-id-123",
    "caseNum": "XZCF-2023-001",
    "caseName": "关于XX企业的违法案件",
    "caseCause": "违反安全生产法",
    "disposition": "罚款2000元",
    "enterpriseId": "enterprise-id-456",
    "filedUserName": "张三",
    "filedUserId": "user-id-111",
    "fillingDate": "2023-10-01",
    "caseClosingDate": "2023-10-20",
    "caseHandler": "李四",
    "archiveDate": "2023-10-25",
    "caseSource": "群众举报",
    "archivalNum": "ARCH-2023-001",
    "shelfLife": 10,
    "createdTime": "2023-10-01T10:00:00",
    "updatedTime": "2023-10-25T14:00:00",
    "status": "已结案",
    "enforcementId": "enforce-id-123",
    "enforcementInfo": {},
    "documents": []
  }
}
```

## 接口对接/提供APP接口/综合执法/执法文书管理
### 分页查询文书信息
系统接口设计
| 请求地址 | /api/lawenforcement/documents |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **Query 参数** | |
| **参数名称** | **类型** | **说明** |
| `page` | integer | 当前页 |
| `pagesize` | integer | 每页记录数 |
| `sort` | string | 排序字段 |
| `dir` | string | 排序方向 |
| `caseId` | string | 案件id |
| `documentNo` | integer | 文书序号 |
| `caseName` | string | 案件名称 |
| `caseNum` | string | 案件id |
| `documentCode` | integer | 文书编号 |
| `documentName` | string | 文书名称 |
| `documentDate` | array | 发件时间 (数组, e.g., ["2023-01-01", "2023-01-31"]) |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | array | 文书信息列表 |
| ├ `documentId` | string | 文书ID |
| ├ `documentCode` | string | 文书编号 |
| ├ `documentNo` | integer | 文书序号 |
| ├ `documentName` | string | 文书名称 |
| ├ `documentType` | string | 文书类型 |
| ├ `documentDate` | string | 发件时间 |
| ├ `filePath` | string | 文书文件地址 |
| ├ `fileName` | string | 文书文件名称 |
| ├ `caseId` | string | 案件ID |
| ├ `caseInfo` | object | 关联的案件信息 |
| ├ `status` | string | 文书状态 |
| └ `downloadUrl` | string | 下载地址 |
| `total` | integer | 总记录数 |
| `page` | integer | 当前页 |
| `limit` | integer | 每页记录数 |
| `totalPages` | integer | 总页数 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": [
    {
      "documentId": "doc-id-123",
      "documentCode": "WJ-2023-001",
      "documentNo": 1,
      "documentName": "行政处罚决定书",
      "documentType": "处罚决定书",
      "documentDate": "2023-10-20",
      "filePath": "/path/to/file.pdf",
      "fileName": "行政处罚决定书.pdf",
      "caseId": "case-id-123",
      "caseInfo": {
          "caseName": "关于XX企业的违法案件"
      },
      "status": "done",
      "downloadUrl": "http://example.com/download/doc-id-123"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10,
  "totalPages": 1
}
```

### 查询文书信息（单条）
系统接口设计
| 请求地址 | /api/lawenforcement/documents/getOneByCaseIdAndDocumentName |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **Query 参数** | |
| **参数名称** | **类型** | **说明** |
| `caseId` | string | 案件id |
| `documentName` | string | 文书名称 |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | object | 文书详细信息 |
| ├ `documentId` | string | 文书ID |
| ├ `documentCode` | string | 文书编号 |
| ├ `documentNo` | integer | 文书序号 |
| ├ `documentName` | string | 文书名称 |
| ├ `documentType` | string | 文书类型 |
| ├ `documentDate` | string | 发件时间 |
| ├ `documenContent` | object | 文书内容 (JSON格式) |
| ├ `filePath` | string | 文书文件地址 |
| ├ `fileName` | string | 文书文件名称 |
| ├ `caseId` | string | 案件ID |
| ├ `caseInfo` | object | 关联的案件信息 |
| ├ `status` | string | 文书状态 |
| └ `downloadUrl` | string | 下载地址 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": {
    "documentId": "doc-id-456",
    "documentCode": "WJ-2023-002",
    "documentNo": 2,
    "documentName": "现场检查记录",
    "documentType": "检查记录",
    "documentDate": "2023-10-21",
    "documenContent": {
      "checkLocation": "XX工厂车间",
      "checkItems": [
        {"item": "消防设施", "result": "合格"},
        {"item": "安全出口", "result": "畅通"}
      ]
    },
    "filePath": "/path/to/file2.pdf",
    "fileName": "现场检查记录.pdf",
    "caseId": "case-id-123",
    "caseInfo": {
      "caseName": "关于XX企业的违法案件"
    },
    "status": "done",
    "downloadUrl": "http://example.com/download/doc-id-456"
  }
}
```

## 接口对接/提供APP接口/综合执法/执法检查
### 分页查询执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/enforceChecks |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **Query 参数** | |
| **参数名称** | **类型** | **说明** |
| `page` | integer | 当前页 |
| `pagesize` | integer | 每页记录数 |
| `sort` | string | 排序字段 |
| `dir` | string | 排序方向 |
| `enforcementId` | string | 执法ID |
| `enterpriseId` | string | 企业ID |
| `checkDate` | array | 检查日期 (数组, e.g., ["2023-01-01", "2023-01-31"]) |
| `createTime` | array | 创建时间 (数组, e.g., ["2023-01-01", "2023-01-31"]) |
| `supplementVerifyResult` | string | 补充验证结果 |
| `period` | string | 周期 |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | array | 检查记录列表 |
| ├ `enforceCheckId` | string | 检查记录ID |
| ├ `checkDate` | string | 检查日期 |
| ├ `checkPlace` | string | 检查场所 |
| ├ `checkStatusMsg` | string | 检查状态 |
| ├ `checkResultMsg` | string | 检查结果 |
| ├ `rectificationDate` | string | 整改日期 |
| ├ `officerList` | array | 执法人员列表 |
| ├ `enforcementInfo` | object | 关联的执法信息 |
| │ └ `enterprise` | object | 关联的企业信息 |
| │   └ `unitName` | string | 企业名称 |
| └ `supplementVerifyResult` | string | 补充验证结果 |
| `total` | integer | 总记录数 |
| `page` | integer | 当前页 |
| `limit` | integer | 每页记录数 |
| `totalPages` | integer | 总页数 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": [
    {
      "enforceCheckId": "check-id-123",
      "checkDate": "2023-10-25",
      "checkPlace": "XX企业生产车间",
      "checkStatusMsg": "已检查",
      "checkResultMsg": "发现隐患",
      "rectificationDate": "2023-11-10",
      "officerList": [
        { "officerName": "王五" }
      ],
      "enforcementInfo": {
        "enterprise": {
          "unitName": "XX安全生产有限公司"
        }
      },
      "supplementVerifyResult": "待验证"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10,
  "totalPages": 1
}
```

### 根据ID查询执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/enforceChecks/{enforceCheckId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **Path 参数** | |
| **参数名称** | **类型** | **说明** |
| `enforceCheckId` | string | 执法检查记录ID |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | object | 检查记录详情 |
| ├ `enforceCheckId` | string | 检查记录ID |
| ├ `checkDate` | string | 检查日期 |
| ├ `checkPlace` | string | 检查场所 |
| ├ `checkStatusMsg` | string | 检查状态 |
| ├ `checkResultMsg` | string | 检查结果 |
| ├ `rectificationDate` | string | 整改日期 |
| ├ `rectificationMeasures` | string | 整改措施 |
| ├ `officerList` | array | 执法人员列表 |
| │ └ `officerName` | string | 执法人员姓名 |
| ├ `enforcementInfo` | object | 关联的执法信息 |
| │ └ `enterprise` | object | 关联的企业信息 |
| │   └ `unitName` | string | 企业名称 |
| ├ `checkItems` | array | 检查项列表 |
| │ ├ `itemName` | string | 检查项名称 |
| │ ├ `enforcementBasis` | string | 执法依据 |
| │ └ `checkNote` | string | 检查说明 |
| └ `urls` | array | 附件URL列表 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": {
    "enforceCheckId": "check-id-123",
    "checkDate": "2023-10-25",
    "checkPlace": "XX企业生产车间",
    "checkStatusMsg": "已检查",
    "checkResultMsg": "发现隐患",
    "rectificationDate": "2023-11-10",
    "rectificationMeasures": "立即停用相关设备，并进行维修。",
    "officerList": [
      { "officerName": "王五" },
      { "officerName": "李六" }
    ],
    "enforcementInfo": {
      "enterprise": {
        "unitName": "XX安全生产有限公司"
      }
    },
    "checkItems": [
      {
        "itemName": "消防通道是否畅通",
        "enforcementBasis": "《消防法》第二十八条",
        "checkNote": "发现杂物堆积，已责令整改"
      }
    ],
    "urls": [
      "http://example.com/path/to/photo1.jpg"
    ]
  }
}
```
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | array | 案件信息列表 |
| ├ `caseId` | string | 案件ID |
| ├ `caseNum` | string | 案件号 |
| ├ `caseName` | string | 案件名称 |
| ├ `caseCause` | string | 案由 |
| ├ `fillingDate` | string | 立案日期 |
| ├ `caseClosingDate` | string | 结案日期 |
| ├ `archiveDate` | string | 归档日期 |
| ├ `status` | string | 案件状态 |
| ├ `enforcementId` | string | 关联的执法信息ID |
| ├ `enforcementInfo` | object | 关联的执法信息 (结构复杂, 参考“根据id查询执法信息”接口) |
| ├ `documents` | array | 案件相关文书列表 |
| `total` | integer | 总记录数 |
| `page` | integer | 当前页 |
| `limit` | integer | 每页记录数 |
| `totalPages` | integer | 总页数 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": [
    {
      "caseId": "case-id-001",
      "caseNum": "XA-YJ-2023-001",
      "caseName": "关于XX企业安全生产违规的案件",
      "caseCause": "未按规定进行安全培训",
      "fillingDate": "2023-10-01",
      "caseClosingDate": "2023-10-20",
      "archiveDate": "2023-10-25",
      "status": "closed",
      "enforcementId": "enforce-id-123",
      "enforcementInfo": {
        "enterprise": {
          "unitName": "示例企业名称"
        }
      },
      "documents": []
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10,
  "totalPages": 1
}
```

## 接口对接/提供APP接口/综合执法/现场检查
### 创建检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/enforceChecks |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **请求体** | |
| **参数名称** | **类型** | **说明** |
| `enforcementId` | string | 关联的执法ID | 
| `checkDate` | string | 检查日期 (格式: yyyy-MM-dd) |
| `checkPlace` | string | 检查场所 |
| `remark` | string | 备注 |
| `checkStatus` | string | 检查状态（1.待检查 2.已检查） |
| `checkResult` | string | 检查结果 |
| `rectificationDate` | string | 整改完成日期 (格式: yyyy-MM-dd) |
| `rectificationMeasures` | string | 整改措施 |
| `officerIds` | string | 执法人员ID列表逗号分隔 |
| `checkType` | string | 检查类型 |
| `supplement` | object | 检查补充内容json串 |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | object | 创建的检查记录信息 (结构同请求体) |
| **返回示例** | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "enforceCheckId": "ulid-generated-id",
    "enforcementId": "enforce-id-123",
    "checkDate": "2024-07-30",
    "checkPlace": "企业A生产车间",
    "remark": "现场检查备注信息",
    "checkStatus": "2",
    "checkResult": "1",
    "rectificationDate": "2024-08-15",
    "rectificationMeasures": "要求立即停产整改",
    "officerIds": "officer-id-1,officer-id-2",
    "checkType": "01",
    "createdBy": "张三",
    "createdAccountBy": "zhangsan",
    "createTime": "2024-07-30T10:00:00",
    "updateTime": "2024-07-30T10:00:00",
    "supplement": {
      "zdyhs": 1,
      "ybyhs": 2
    },
    "supplementVerifyResult": "2"
  }
}
```

### 根据ID查询执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/enforceChecks/{enforceCheckId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **路径参数** | |
| **参数名称** | **类型** | **说明** |
| `enforceCheckId` | string | 执法检查记录ID |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | object | 执法检查记录信息 (结构同创建接口) |
| **返回示例** | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": {
    "enforceCheckId": "ulid-generated-id",
    "enforcementId": "enforce-id-123",
    "checkDate": "2024-07-30",
    "checkPlace": "企业A生产车间",
    "remark": "现场检查备注信息",
    "checkStatus": "2",
    "checkResult": "1",
    "rectificationDate": "2024-08-15",
    "rectificationMeasures": "要求立即停产整改",
    "officerIds": "officer-id-1,officer-id-2",
    "checkType": "01",
    "createdBy": "张三",
    "createdAccountBy": "zhangsan",
    "createTime": "2024-07-30T10:00:00",
    "updateTime": "2024-07-30T10:00:00",
    "supplement": {
      "zdyhs": 1,
      "ybyhs": 2
    },
    "supplementVerifyResult": "2"
  }
}
```

### 分页查询执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/enforceChecks |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| **Query 参数** | |
| **参数名称** | **类型** | **说明** |
| `page` | integer | 当前页 |
| `pagesize` | integer | 每页记录数 |
| `sort` | string | 排序字段 |
| `dir` | string | 排序方向 |
| `enforcementId` | string | 关联的执法ID |
| `enterpriseId` | string | 企业ID |
| `checkDate` | array | 检查日期范围 (e.g., ["2023-01-01", "2023-01-31"]) |
| `createTime` | array | 创建时间范围 (e.g., ["2023-01-01T00:00:00", "2023-01-31T23:59:59"]) |
| `supplementVerifyResult` | string | 检查补充内容审核结果 |
| `tag` | string | 查询判断 |
| **响应结果** | |
| **参数名称** | **类型** | **说明** |
| `code` | integer | 状态码 |
| `success` | boolean | 是否成功 |
| `msg` | string | 消息 |
| `data` | array | 执法检查记录列表 (结构同创建接口) |
| `total` | integer | 总记录数 |
| `page` | integer | 当前页 |
| `limit` | integer | 每页记录数 |
| `totalPages` | integer | 总页数 |
| **返回示例** | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": [
    {
      "enforceCheckId": "ulid-generated-id",
      "enforcementId": "enforce-id-123",
      "checkDate": "2024-07-30",
      "checkPlace": "企业A生产车间",
      "remark": "现场检查备注信息",
      "checkStatus": "2",
      "checkResult": "1",
      "rectificationDate": "2024-08-15",
      "rectificationMeasures": "要求立即停产整改",
      "officerIds": "officer-id-1,officer-id-2",
      "checkType": "01",
      "createdBy": "张三",
      "createdAccountBy": "zhangsan",
      "createTime": "2024-07-30T10:00:00",
      "updateTime": "2024-07-30T10:00:00",
      "supplement": {
        "zdyhs": 1,
        "ybyhs": 2
      },
      "supplementVerifyResult": "2"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10,
  "totalPages": 1
}
```

## 接口对接/提供大屏展示接口
### 查询当月执法对象数量
系统接口设计
| 请求地址 | /api/lawenforcement/big-screen-system/zfdxsl |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数| |
| 无 | |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | long | 当月执法对象数量 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": 128
}
```
### 查询当月执法人员数量
系统接口设计
| 请求地址 | /api/lawenforcement/big-screen-system/zfrysl |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数| |
| 无 | |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | long | 当月执法人员数量 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": 88
}
```
### 查询当月执法信息数量
系统接口设计
| 请求地址 | /api/lawenforcement/big-screen-system/zfxxsl |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数| |
| 无 | |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | long | 当月执法信息数量 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": 210
}
```
### 查询当月执法检查数量
系统接口设计
| 请求地址 | /api/lawenforcement/big-screen-system/zfjcsl |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数| |
| 无 | |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | long | 当月执法检查数量 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": 55
}
```
### 查询当月事故单位报告、公众举报、下级部门报告、媒体舆情监测、其他部分移送数量（当月举报统计）
系统接口设计
| 请求地址 | /api/lawenforcement/big-screen-system/dytjs |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数| |
| 无 | |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 举报统计结果 |
| ├ rcjdfxs | integer | 日常检查发现 |
| ├ jgjcbgs | integer | 机构监测报告 |
| ├ jbtss | integer | 举报投诉 |
| ├ sjjbs | integer | 上级交办 |
| ├ xjqbs | integer | 下级情报 |
| ├ ygbmyss | integer | 有关部门移送 |
| └ qts | integer | 其他 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "rcjdfxs": 10,
    "jgjcbgs": 5,
    "jbtss": 20,
    "sjjbs": 2,
    "xjqbs": 8,
    "ygbmyss": 4,
    "qts": 1
  }
}
```

### 查询当月执法文书数量
系统接口设计
| 请求地址 | /api/lawenforcement/big-screen-system/getDocumentNum |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数| |
| 无 | |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | long | 当月执法文书数量 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": 123
}
```

### 查询当月案卷数量
系统接口设计
| 请求地址 | /api/lawenforcement/big-screen-system/getDossiersNum |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数| |
| 无 | |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | long | 当月案卷数量 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": 45
}
```

### 查询当月受理、调查、决定、执行数量
系统接口设计
| 请求地址 | /api/lawenforcement/big-screen-system/getCaseNodeNum |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数| |
| 无 | |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 节点统计结果 |
| ├ slNum | integer | 受理数 |
| ├ dcNum | integer | 调查数 |
| ├ jdNum | integer | 决定数 |
| └ zxNum | integer | 执行数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "slNum": 10,
    "dcNum": 5,
    "jdNum": 3,
    "zxNum": 2
  }
}
```

## 综合执法 / 执法机构管理

### 创建执法机构
系统接口设计
| 请求地址 | /api/lawenforcement/agencies |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| Agency | 执法机构对象 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后机构信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "agencyId": "ULID123",
    "agencyName": "高新区应急局",
    "agencyCode": "610100000",
    "agencyLevel": 3,
    "leaf": true
  }
}
```

### 根据ID查询执法机构
系统接口设计
| 请求地址 | /api/lawenforcement/agencies/{agencyId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| agencyId | string | 执法机构ID |
| 请求体参数 | |
| 无 | |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 执法机构信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "agencyId": "ULID123",
    "agencyName": "高新区应急局",
    "agencyCode": "610100000",
    "agencyLevel": 3,
    "leaf": true
  }
}
```

### 更新执法机构
系统接口设计
| 请求地址 | /api/lawenforcement/agencies/{agencyId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| agencyId | string | 执法机构ID |
| 请求体参数 | |
| Agency | 执法机构对象 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后机构信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "agencyId": "ULID123",
    "agencyName": "高新区应急局",
    "agencyLevel": 3
  }
}
```

### 根据ID删除执法机构
系统接口设计
| 请求地址 | /api/lawenforcement/agencies/{agencyId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| agencyId | string | 执法机构ID |
| 请求体参数 | |
| 无 | |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | null | 无数据 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功",
  "data": null
}
```

### 查询执法机构列表
系统接口设计
| 请求地址 | /api/lawenforcement/agencies/list |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| page & pagesize | integer | 分页参数，可选 |
| agencyName | string | 机构名称，可选 |
| agencyCode | string | 机构代码，可选 |
| parentId | string | 上级机构ID，可选 |
| agencyLevel | string | 机构级别，可选 |
| 请求体参数 | |
| 无 | |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 机构列表 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "agencyId": "ULID123",
      "agencyName": "高新区应急局"
    }
  ]
}
```

## 综合执法 / 执法人员管理

### 创建执法人员
系统接口设计
| 请求地址 | /api/lawenforcement/officers |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| Officer | 执法人员对象 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后人员信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "officerId": "ULID456",
    "officerName": "张三",
    "certificateNo": "XA123456",
    "agencyId": "ULID123"
  }
}
```

### 根据ID查询执法人员
系统接口设计
| 请求地址 | /api/lawenforcement/officers/{officerId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| officerId | string | 执法人员ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 执法人员信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "officerId": "ULID456",
    "officerName": "张三",
    "certificateNo": "XA123456",
    "agencyId": "ULID123"
  }
}
```

### 根据执法证号查询执法人员
系统接口设计
| 请求地址 | /api/lawenforcement/officers/certificate/{certificateNo} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| certificateNo | string | 执法证号 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 执法人员信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "officerId": "ULID456",
    "officerName": "张三",
    "certificateNo": "XA123456",
    "agencyId": "ULID123"
  }
}
```

### 根据所属执法机构ID查询执法人员列表
系统接口设计
| 请求地址 | /api/lawenforcement/officers/agency/{agencyId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| agencyId | string | 执法机构ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 执法人员列表 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "officerId": "ULID456",
      "officerName": "张三"
    }
  ]
}
```

### 更新执法人员
系统接口设计
| 请求地址 | /api/lawenforcement/officers/{officerId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| officerId | string | 执法人员ID |
| 请求体参数 | |
| Officer | 执法人员对象 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后人员信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "officerId": "ULID456",
    "officerName": "张三",
    "certificateNo": "XA123456"
  }
}
```

## 综合执法 / 执法检查

### 根据ID查询执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/enforceChecks/{enforceCheckId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| enforceCheckId | string | 执法检查记录ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 执法检查记录详情 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "enforceCheckId": "ULID789",
    "checkDate": "2025-06-21",
    "checkPlace": "高新区某化工厂",
    "writerName": "李四",
    "checkResult": "合格",
    "officerList": [
      {
        "officerId": "ULID456",
        "officerName": "张三"
      }
    ]
  }
}
```

### 分页查询执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/enforceChecks |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| page | integer | 当前页码 |
| pagesize | integer | 每页数量 |
| enforcementId | string | 执法信息ID，可选 |
| enterpriseId | string | 企业ID，可选 |
| checkDate | array<string> | 检查日期范围，可选 |
| sort | string | 排序字段，可选 |
| dir | string | 排序方向 asc/desc，可选 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 执法检查记录列表 |
| total | integer | 总记录数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "enforceCheckId": "ULID789",
      "checkDate": "2025-06-21",
      "checkPlace": "高新区某化工厂",
      "checkResult": "合格"
    },
    {
      "enforceCheckId": "ULID790",
      "checkDate": "2025-06-20",
      "checkPlace": "碑林区某工地",
      "checkResult": "不合格"
    }
  ],
  "total": 2
}
```

## 综合执法 / 企业管理

### 创建企业信息
系统接口设计
| 请求地址 | /api/lawenforcement/enterprises |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| Enterprise | 企业信息对象 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后企业信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "enterpriseId": "ULID901",
    "unitName": "西安示例化工有限公司",
    "unifiedSocialCode": "91610100MA6XXXXXXX"
  }
}
```

### 根据ID查询企业信息
系统接口设计
| 请求地址 | /api/lawenforcement/enterprises/{enterpriseId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| enterpriseId | string | 企业ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 企业信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "enterpriseId": "ULID901",
    "unitName": "西安示例化工有限公司",
    "unifiedSocialCode": "91610100MA6XXXXXXX",
    "agencyId": "ULID123"
  }
}
```

### 更新企业信息
系统接口设计
| 请求地址 | /api/lawenforcement/enterprises/{enterpriseId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| enterpriseId | string | 企业ID |
| 请求体参数 | |
| Enterprise | 企业信息对象 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后企业信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "enterpriseId": "ULID901",
    "unitName": "西安示例化工有限公司 (更新)",
    "unifiedSocialCode": "91610100MA6XXXXXXX"
  }
}
```

### 根据ID删除企业信息
系统接口设计
| 请求地址 | /api/lawenforcement/enterprises/{enterpriseId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| enterpriseId | string | 企业ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}
```

### 查询企业信息列表
系统接口设计
| 请求地址 | /api/lawenforcement/enterprises |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| page | integer | 当前页 |
| pagesize | integer | 每页数量 |
| unitName | string | 企业名称，模糊匹配，可选 |
| agencyId | string | 所属机构ID，可选 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 企业信息列表 |
| total | integer | 总记录数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "enterpriseId": "ULID901",
      "unitName": "西安示例化工有限公司"
    }
  ],
  "total": 1
}
```

### 企业信息统计
系统接口设计
| 请求地址 | /api/lawenforcement/enterprises/statistics |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| agencyId | string | 机构ID，可选 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 统计结果 |
| ├ total | integer | 企业总数 |
| └ byAgency | array<object> | 各机构企业数量 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "total": 123,
    "byAgency": [
      { "agencyId": "ULID123", "count": 60 },
      { "agencyId": "ULID124", "count": 63 }
    ]
  }
}
```

### 导出企业信息 Excel
系统接口设计
| 请求地址 | /api/lawenforcement/enterprises/exportExcel |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | octet-stream |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| agencyId | string | 机构ID，可选 |
| unitName | string | 企业名称，可选 |
| 响应结果 | 文件流 | 下载 Excel 文件。

### 批量导入企业信息(importFile)
系统接口设计
| 请求地址 | /api/lawenforcement/enterprises/importFile |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| file | file | Excel 文件 (multipart/form-data) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "导入成功"
}
```

### 根据机构查询企业列表
系统接口设计
| 请求地址 | /api/lawenforcement/enterprises/agency/{agencyId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| agencyId | string | 机构ID |
| 查询参数 | |
| page | integer | 当前页 |
| pagesize | integer | 每页数量 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 企业信息列表 |
| total | integer | 总记录数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "enterpriseId": "ULID901",
      "unitName": "西安示例化工有限公司"
    }
  ],
  "total": 1
}
```

## 综合执法 / 投诉举报

### 创建投诉举报
系统接口设计
| 请求地址 | /api/lawenforcement/complaints |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| Complaint | 投诉举报对象 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后投诉举报 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "complaintId": "ULID1001",
    "enterpriseId": "ULID901",
    "title": "安全隐患举报"
  }
}
```

### 根据ID查询投诉举报
系统接口设计
| 请求地址 | /api/lawenforcement/complaints/{complaintId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| complaintId | string | 投诉举报ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 投诉举报详情 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "complaintId": "ULID1001",
    "enterpriseId": "ULID901",
    "title": "安全隐患举报",
    "status": "待处理"
  }
}
```

### 根据被投诉企业ID查询投诉举报列表
系统接口设计
| 请求地址 | /api/lawenforcement/complaints/enterprise/{enterpriseId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| enterpriseId | string | 企业ID |
| 查询参数 | |
| page | integer | 当前页 |
| pagesize | integer | 每页数量 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 投诉举报列表 |
| total | integer | 总记录数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "complaintId": "ULID1001",
      "title": "安全隐患举报",
      "status": "待处理"
    }
  ],
  "total": 1
}
```

### 更新投诉举报
系统接口设计
| 请求地址 | /api/lawenforcement/complaints/{complaintId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| complaintId | string | 投诉举报ID |
| 请求体参数 | |
| Complaint | 投诉举报对象 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后投诉举报 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "complaintId": "ULID1001",
    "status": "已处理"
  }
}
```

### 根据ID删除投诉举报
系统接口设计
| 请求地址 | /api/lawenforcement/complaints/{complaintId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| complaintId | string | 投诉举报ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}
```

## 综合执法 / 举报核查管理

### 创建举报核查信息
系统接口设计
| 请求地址 | /api/lawenforcement/reportChecks |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| ReportCheck | 举报核查对象 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后举报核查信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "reportCheckId": "ULID1101",
    "complaintId": "ULID1001",
    "status": "待核查"
  }
}
```

### 更新举报核查信息
系统接口设计
| 请求地址 | /api/lawenforcement/reportChecks/{reportCheckId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| reportCheckId | string | 举报核查ID |
| 请求体参数 | |
| ReportCheck | 举报核查对象 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后举报核查信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "reportCheckId": "ULID1101",
    "status": "已核查"
  }
}
```

### 转交举报核查
系统接口设计
| 请求地址 | /api/lawenforcement/reportChecks/{reportCheckId}/transfer |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| reportCheckId | string | 举报核查ID |
| 请求体参数 | |
| targetAgencyId | string | 转交目标机构ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "转交成功"
}
```

### 反馈举报核查
系统接口设计
| 请求地址 | /api/lawenforcement/reportChecks/{reportCheckId}/feedback |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| reportCheckId | string | 举报核查ID |
| 请求体参数 | |
| feedback | string | 反馈内容 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "反馈成功"
}
```

## 综合执法 / 执法文书管理

### 分页查询文书信息
系统接口设计
| 请求地址 | /api/lawenforcement/documents |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| pageNo | integer | 页码 |
| pageSize | integer | 每页记录数 |
| agencyId | string | 执法机构ID（可选） |
| documentType | string | 文书类型（可选） |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 文书信息列表 |
| total | integer | 总记录数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "documentId": "ULID2001",
      "documentName": "行政处罚告知书",
      "documentType": "告知书"
    }
  ],
  "total": 1
}
```

### 根据ID查询文书信息
系统接口设计
| 请求地址 | /api/lawenforcement/documents/{documentId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| documentId | string | 文书ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 文书信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "documentId": "ULID2001",
    "documentName": "行政处罚告知书",
    "documentType": "告知书",
    "contentUrl": "/files/doc/ULID2001.pdf"
  }
}
```

## 综合执法 / 行政处罚流程

### 分页查询案件信息
系统接口设计
| 请求地址 | /api/lawenforcement/cases |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| pageNo | integer | 页码 |
| pageSize | integer | 每页记录数 |
| agencyId | string | 执法机构ID（可选） |
| status | string | 案件状态（可选） |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 案件列表 |
| total | integer | 总记录数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "caseId": "ULID3001",
      "title": "危险化学品违规储存"
    }
  ],
  "total": 1
}
```

### 查询案件信息（单条）
系统接口设计
| 请求地址 | /api/lawenforcement/cases/{caseId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| caseId | string | 案件ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 案件信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "caseId": "ULID3001",
    "title": "危险化学品违规储存",
    "status": "调查中"
  }
}
```

### 查询案件信息（不分页）
系统接口设计
| 请求地址 | /api/lawenforcement/cases/list |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| agencyId | string | 执法机构ID（可选） |
| status | string | 案件状态（可选） |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 案件列表 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "caseId": "ULID3001",
      "title": "危险化学品违规储存"
    }
  ]
}
```

### 根据案件ID修改
系统接口设计
| 请求地址 | /api/lawenforcement/cases/{caseId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| caseId | string | 案件ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| title | string | 案件标题 |
| caseNum | string | 案件编号 |
| enterpriseId | string | 企业ID |
| violationDesc | string | 违法行为描述 |
| status | string | 案件状态 |
| penaltyType | string | 处罚类型 |
| penaltyAmount | number | 罚款金额 |
| happenedDate | string | 发生日期(yyyy-MM-dd) |
| attachments | array<object> | 附件列表 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后案件 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "caseId": "ULID3001",
    "status": "已立案"
  }
}
```

### 调查取证
系统接口设计
| 请求地址 | /api/lawenforcement/cases/{caseId}/evidence |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| caseId | string | 案件ID |
| 请求体参数 | |
| evidenceUrls | array<string> | 证据文件路径数组 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "取证保存成功"
}
```

### 分析研判
系统接口设计
| 请求地址 | /api/lawenforcement/cases/{caseId}/analysis |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| caseId | string | 案件ID |
| 请求体参数 | |
| analysis | string | 分析研判内容 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "分析研判成功"
}
```

### 生成案卷文件并下载
系统接口设计
| 请求地址 | /api/lawenforcement/cases/{caseId}/download |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | application/octet-stream |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| caseId | string | 案件ID |
| 响应结果 | |
| application/octet-stream | 文件流 | 案卷压缩包 |

## 综合执法 / 执法信息

### 创建执法信息
系统接口设计
| 请求地址 | /api/lawenforcement/enforcements |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| enterpriseId | string | 企业ID |
| agencyId | string | 执法机构ID |
| title | string | 执法主题 |
| planDate | string | 计划执法日期(yyyy-MM-dd) |
| description | string | 执法说明 |
| officerIds | array<string> | 执法人员ID列表 |
| attachments | array<object> | 附件列表 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后执法信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "enforcementId": "ULID4001",
    "title": "安全检查"
  }
}
```

### 根据ID查询执法信息
系统接口设计
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| enforcementId | string | 执法信息ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 执法信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "enforcementId": "ULID4001",
    "title": "安全检查",
    "status": "草稿"
  }
}
```

### 更新执法信息
系统接口设计
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| enforcementId | string | 执法信息ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| enterpriseId | string | 企业ID |
| agencyId | string | 执法机构ID |
| title | string | 执法主题 |
| planDate | string | 计划执法日期(yyyy-MM-dd) |
| description | string | 执法说明 |
| officerIds | array<string> | 执法人员ID列表 |
| attachments | array<object> | 附件列表 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后执法信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "enforcementId": "ULID4001",
    "status": "已提交"
  }
}
```

### 根据ID删除执法信息
系统接口设计
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| enforcementId | string | 执法信息ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}
```

### 执法信息方案审批
系统接口设计
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId}/approve |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| enforcementId | string | 执法信息ID |
| 请求体参数 | |
| approval | string | 审批意见 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "审批成功"
}
```

### 执法信息总结
系统接口设计
| 请求地址 | /api/lawenforcement/enforcements/{enforcementId}/summary |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| enforcementId | string | 执法信息ID |
| 请求体参数 | |
| summary | string | 总结内容 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "总结成功"
}
```

## 综合执法 / 监督检查（现场检查）

### 创建执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| enforcementId | string | 关联的执法信息ID |
| checkDate | string | 检查日期(yyyy-MM-dd) |
| checkPlace | string | 检查场所 |
| remark | string | 备注 |
| checkStatus | string | 检查状态（1.待检查 2.已检查） |
| checkResult | string | 检查结果 |
| rectificationDate | string | 整改完成日期(yyyy-MM-dd) |
| rectificationMeasures | string | 整改措施 |
| officerIds | array<string> | 执法人员ID列表 |
| checkType | string | 检查类型 |
| supplement | object | 检查补充内容 |

| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后检查记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "inspectionId": "ULID5001",
    "enforcementId": "ULID4001",
    "checkDate": "2025-07-02"
  }
}
```

### 根据ID查询执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| inspectionId | string | 检查记录ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 检查记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "inspectionId": "ULID5001",
    "enforcementId": "ULID4001",
    "status": "进行中"
  }
}
```

### 分页查询执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| pageNo | integer | 页码 |
| pageSize | integer | 每页记录数 |
| enforcementId | string | 执法信息ID（可选） |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 检查记录列表 |
| total | integer | 总记录数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "inspectionId": "ULID5001",
      "enforcementId": "ULID4001"
    }
  ],
  "total": 1
}
```

### 更新执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| inspectionId | string | 检查记录ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| enforcementId | string | 关联的执法信息ID |
| checkDate | string | 检查日期(yyyy-MM-dd) |
| checkPlace | string | 检查场所 |
| remark | string | 备注 |
| checkStatus | string | 检查状态（1.待检查 2.已检查） |
| checkResult | string | 检查结果 |
| rectificationDate | string | 整改完成日期(yyyy-MM-dd) |
| rectificationMeasures | string | 整改措施 |
| officerIds | array<string> | 执法人员ID列表 |
| checkType | string | 检查类型 |
| supplement | object | 检查补充内容 |

| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后检查记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "inspectionId": "ULID5001",
    "status": "已完成"
  }
}
```

### 根据ID删除执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| inspectionId | string | 检查记录ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}
```

## 综合执法 / 文书送达记录

### 创建文书送达记录
系统接口设计
| 请求地址 | /api/lawenforcement/delivery-records |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| documentId | string | 文书ID |
| recipientId | string | 受送人ID |
| deliverMethodId | string | 送达方式ID |
| deliverDate | string | 送达日期(yyyy-MM-dd) |
| deliverAddress | string | 送达地址 |
| status | string | 送达状态（1.已送达 2.未送达） |
| remark | string | 备注 |
| attachments | array<object> | 送达附件列表 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "recordId": "ULID7001",
    "documentId": "DOC123"
  }
}
```

### 根据ID查询文书送达记录
系统接口设计
| 请求地址 | /api/lawenforcement/delivery-records/{recordId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| recordId | string | 送达记录ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 文书送达记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "recordId": "ULID7001",
    "documentId": "DOC123",
    "status": "1"
  }
}
```

### 分页查询文书送达记录
系统接口设计
| 请求地址 | /api/lawenforcement/delivery-records |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| pageNo | integer | 页码 |
| pageSize | integer | 每页记录数 |
| status | string | 送达状态(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 送达记录列表 |
| total | integer | 总数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "recordId": "ULID7001",
      "documentId": "DOC123"
    }
  ],
  "total": 1
}
```

### 更新文书送达记录
系统接口设计
| 请求地址 | /api/lawenforcement/delivery-records/{recordId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| recordId | string | 送达记录ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| deliverMethodId | string | 送达方式ID |
| deliverDate | string | 送达日期(yyyy-MM-dd) |
| deliverAddress | string | 送达地址 |
| status | string | 送达状态 |
| remark | string | 备注 |
| attachments | array<object> | 送达附件列表 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "recordId": "ULID7001",
    "status": "1"
  }
}
```

### 根据ID删除文书送达记录
系统接口设计
| 请求地址 | /api/lawenforcement/delivery-records/{recordId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| recordId | string | 送达记录ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}
```

## 综合执法 / 自动执法计划信息

### 创建自动执法计划
系统接口设计
| 请求地址 | /api/lawenforcement/auto-enforce-plans |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| title | string | 计划名称 |
| cron | string | 执行Cron表达式 |
| targetAgencyIds | array<string> | 目标执法机构ID列表 |
| description | string | 计划说明 |
| enabled | boolean | 是否启用 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后计划 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "planId": "ULID6001",
    "title": "季度安全检查计划"
  }
}
```

### 根据ID查询自动执法计划
系统接口设计
| 请求地址 | /api/lawenforcement/auto-enforce-plans/{planId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| planId | string | 计划ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 自动执法计划 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "planId": "ULID6001",
    "title": "季度安全检查计划",
    "enabled": true
  }
}
```

### 分页查询自动执法计划
系统接口设计
| 请求地址 | /api/lawenforcement/auto-enforce-plans |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| pageNo | integer | 页码 |
| pageSize | integer | 每页记录数 |
| enabled | boolean | 是否启用(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 计划列表 |
| total | integer | 总记录数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "planId": "ULID6001",
      "title": "季度安全检查计划"
    }
  ],
  "total": 1
}
```

### 更新自动执法计划
系统接口设计
| 请求地址 | /api/lawenforcement/auto-enforce-plans/{planId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| planId | string | 计划ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| title | string | 计划名称 |
| cron | string | 执行Cron表达式 |
| targetAgencyIds | array<string> | 目标执法机构ID列表 |
| description | string | 计划说明 |
| enabled | boolean | 是否启用 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后计划 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "planId": "ULID6001",
    "enabled": false
  }
}
```

### 根据ID删除自动执法计划
系统接口设计
| 请求地址 | /api/lawenforcement/auto-enforce-plans/{planId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| planId | string | 计划ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}
```

## 综合执法 / 文书送达方式

### 创建送达方式
系统接口设计
| 请求地址 | /api/lawenforcement/delivery-methods |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| methodName | string | 送达方式名称 |
| description | string | 说明 |
| enabled | boolean | 是否启用 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "methodId": "ULID7101",
    "methodName": "邮寄送达"
  }
}
```

### 根据ID查询送达方式
系统接口设计
| 请求地址 | /api/lawenforcement/delivery-methods/{methodId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| methodId | string | 送达方式ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 送达方式 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "methodId": "ULID7101",
    "methodName": "邮寄送达",
    "enabled": true
  }
}
```

### 分页查询送达方式
系统接口设计
| 请求地址 | /api/lawenforcement/delivery-methods |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| pageNo | integer | 页码 |
| pageSize | integer | 每页记录数 |
| enabled | boolean | 是否启用(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 送达方式列表 |
| total | integer | 总数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "methodId": "ULID7101",
      "methodName": "邮寄送达"
    }
  ],
  "total": 1
}
```

### 更新送达方式
系统接口设计
| 请求地址 | /api/lawenforcement/delivery-methods/{methodId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| methodId | string | 送达方式ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| methodName | string | 送达方式名称 |
| description | string | 说明 |
| enabled | boolean | 是否启用 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "methodId": "ULID7101",
    "enabled": false
  }
}
```

### 根据ID删除送达方式
系统接口设计
| 请求地址 | /api/lawenforcement/delivery-methods/{methodId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| methodId | string | 送达方式ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}
```

## 综合执法 / 受送人管理

### 创建受送人
系统接口设计
| 请求地址 | /api/lawenforcement/recipients |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| name | string | 受送人姓名 |
| phone | string | 联系电话 |
| address | string | 联系地址 |
| idNumber | string | 身份证号 |
| remark | string | 备注 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "recipientId": "ULID7201",
    "name": "张三"
  }
}
```

### 根据ID查询受送人
系统接口设计
| 请求地址 | /api/lawenforcement/recipients/{recipientId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| recipientId | string | 受送人ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 受送人信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "recipientId": "ULID7201",
    "name": "张三",
    "phone": "13800000000"
  }
}
```

### 分页查询受送人
系统接口设计
| 请求地址 | /api/lawenforcement/recipients |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| pageNo | integer | 页码 |
| pageSize | integer | 每页记录数 |
| name | string | 姓名(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 受送人列表 |
| total | integer | 总数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "recipientId": "ULID7201",
      "name": "张三"
    }
  ],
  "total": 1
}
```

### 更新受送人
系统接口设计
| 请求地址 | /api/lawenforcement/recipients/{recipientId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| recipientId | string | 受送人ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| name | string | 受送人姓名 |
| phone | string | 联系电话 |
| address | string | 联系地址 |
| idNumber | string | 身份证号 |
| remark | string | 备注 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "recipientId": "ULID7201",
    "name": "李四"
  }
}
```

### 根据ID删除受送人
系统接口设计
| 请求地址 | /api/lawenforcement/recipients/{recipientId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| recipientId | string | 受送人ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}
```

## 综合执法 / 检查事项

### 创建检查事项
系统接口设计
| 请求地址 | /api/lawenforcement/check-items |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| itemName | string | 检查事项名称 |
| category | string | 所属类别 |
| basis | string | 法律依据 |
| enabled | boolean | 是否启用 |
| remark | string | 备注 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "checkItemId": "ULID7301",
    "itemName": "安全生产制度落实情况"
  }
}
```

### 根据ID查询检查事项
系统接口设计
| 请求地址 | /api/lawenforcement/check-items/{checkItemId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| checkItemId | string | 检查事项ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 检查事项信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "checkItemId": "ULID7301",
    "itemName": "安全生产制度落实情况",
    "enabled": true
  }
}
```

### 分页查询检查事项
系统接口设计
| 请求地址 | /api/lawenforcement/check-items |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 查询参数 | |
| pageNo | integer | 页码 |
| pageSize | integer | 每页记录数 |
| itemName | string | 事项名称(可选) |
| category | string | 类别(可选) |
| enabled | boolean | 是否启用(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 检查事项列表 |
| total | integer | 总数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "checkItemId": "ULID7301",
      "itemName": "安全生产制度落实情况"
    }
  ],
  "total": 1
}
```

### 更新检查事项
系统接口设计
| 请求地址 | /api/lawenforcement/check-items/{checkItemId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| checkItemId | string | 检查事项ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| itemName | string | 检查事项名称 |
| category | string | 所属类别 |
| basis | string | 法律依据 |
| enabled | boolean | 是否启用 |
| remark | string | 备注 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "checkItemId": "ULID7301",
    "enabled": false
  }
}
```

### 根据ID删除检查事项
系统接口设计
| 请求地址 | /api/lawenforcement/check-items/{checkItemId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| checkItemId | string | 检查事项ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}
```

## 综合执法 / 检查表
### 创建检查表
系统接口设计
| 请求地址 | /api/lawenforcement/checklists |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| checklistName | string | 检查表名称 |
| description | string | 描述 |
| enabled | boolean | 是否启用 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "checklistId": "ULID1001",
    "checklistName": "企业安全检查表",
    "enabled": true
  }
}
```

### 根据ID查询检查表
系统接口设计
| 请求地址 | /api/lawenforcement/checklists/{checklistId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| checklistId | string | 检查表ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 检查表信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "checklistId": "ULID1001",
    "checklistName": "企业安全检查表",
    "description": "用于企业安全生产日常检查",
    "enabled": true
  }
}
```

### 查询检查表列表
系统接口设计
| 请求地址 | /api/lawenforcement/checklists/list |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| Query 参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| page | integer | 当前页 |
| pagesize | integer | 每页记录数 |
| checklistName | string | 检查表名称(可选) |
| enabled | boolean | 是否启用(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 检查表列表 |
| total | integer | 总数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": [
    {
      "checklistId": "ULID1001",
      "checklistName": "企业安全检查表",
      "enabled": true
    }
  ],
  "total": 1
}
```

### 更新检查表
系统接口设计
| 请求地址 | /api/lawenforcement/checklists/{checklistId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| checklistId | string | 检查表ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| checklistName | string | 检查表名称 |
| description | string | 描述 |
| enabled | boolean | 是否启用 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": {
    "checklistId": "ULID1001",
    "enabled": false
  }
}
```

### 根据ID删除检查表
系统接口设计
| 请求地址 | /api/lawenforcement/checklists/{checklistId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| checklistId | string | 检查表ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}
```

## 综合执法 / 扫码入企
### 生成二维码
系统接口设计
| 请求地址 | /api/qrcode/generate |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求参数 | 无 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | string | 二维码信息(base64或URL) |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "操作成功",
  "data": "https://example.com/qr/xxxxx"
}
```

### 校验二维码
系统接口设计
| 请求地址 | /api/qrcode/validate |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| Query 参数 | |
| 参数名称 | 类型 | 是否必填 | 说明 |
| -- | -- | -- | -- |
| token | string | 是 | 二维码token |
| enforcementId | string | 是 | 企业ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 校验结果 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "校验成功",
  "data": {
    "valid": true,
    "enterpriseName": "西安应急有限公司"
  }
}
```

### 检查二维码状态
系统接口设计
| 请求地址 | /api/qrcode/check-status |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| Query 参数 | |
| 参数名称 | 类型 | 是否必填 | 说明 |
| -- | -- | -- | -- |
| token | string | 是 | 二维码token |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | string | 状态信息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": "已使用"
}
```

## 综合执法 / 法制审核

### 根据ID查询执法信息
系统接口设计
| 请求地址 | /api/legal-review/{enforcementId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| enforcementId | string | 执法信息ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 执法信息详情 |
| ├ enforcementId | string | 执法信息ID |
| ├ enterprise | object | 企业信息 |
| ├ agency | object | 执法机构信息 |
| ├ status | string | 当前状态 |
| ├ createTime | string | 创建时间 |
| ├ updateTime | string | 更新时间 |
| └ attachments | array<object> | 附件列表 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": {
    "enforcementId": "ULID4001",
    "enterprise": { "unitName": "西安示例化工有限公司" },
    "agency": { "agencyName": "高新区应急局" },
    "status": "draft",
    "createTime": "2025-07-01T09:00:00",
    "updateTime": "2025-07-01T09:00:00",
    "attachments": []
  }
}
```

### 查询执法信息
系统接口设计
| 请求地址 | /api/legal-review/info |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| Query 参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| page | integer | 当前页 |
| pagesize | integer | 每页记录数 |
| enterpriseName | string | 企业名称(可选) |
| status | string | 状态(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 执法信息列表 |
| total | integer | 总记录数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": [
    {
      "enforcementId": "ULID4001",
      "enterpriseName": "西安示例化工有限公司",
      "status": "pending",
      "createTime": "2025-07-01T09:00:00"
    }
  ],
  "total": 1
}
```

### 法制审核
系统接口设计
| 请求地址 | /api/legal-review/audit |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| enforcementId | string | 执法信息ID |
| auditResult | string | 审核结果(approve / reject) |
| auditOpinion | string | 审核意见 |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 审核结果 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "审核完成",
  "data": {
    "enforcementId": "ULID4001",
    "auditResult": "approved"
  }
}
```

### 新增调查报告
系统接口设计
| 请求地址 | /api/legal-review |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| enforcementId | string | 执法信息ID |
| title | string | 报告标题 |
| content | string | 报告内容 |
| attachments | array<object> | 附件列表(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建结果 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "新增成功",
  "data": {
    "reportId": "ULID5002",
    "enforcementId": "ULID4001"
  }
}
```

## 综合执法 / 执法信息现场检查

### 创建执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| enforcementId | string | 执法信息ID |
| checkDate | string | 检查日期(yyyy-MM-dd) |
| checkPlace | string | 检查地点 |
| remark | string | 备注 |
| officerIds | array<string> | 执法人ID列表 |
| checkType | string | 检查类型代码 |
| attachments | array<object> | 附件列表(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "创建成功",
  "data": {
    "inspectionId": "ULID6001",
    "enforcementId": "ULID4001"
  }
}
```

### 根据ID查询执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| inspectionId | string | 检查记录ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 检查记录详情 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": {
    "inspectionId": "ULID6001",
    "enforcementId": "ULID4001",
    "checkDate": "2025-07-02",
    "checkPlace": "企业A生产车间"
  }
}
```

### 分页查询执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| Query 参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| page | integer | 当前页 |
| pagesize | integer | 每页记录数 |
| enforcementId | string | 执法信息ID(可选) |
| checkDate | array<string> | 检查日期范围(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 检查记录列表 |
| total | integer | 总记录数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": [
    {
      "inspectionId": "ULID6001",
      "enforcementId": "ULID4001",
      "checkDate": "2025-07-02"
    }
  ],
  "total": 1
}
```

### 更新执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| inspectionId | string | 检查记录ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| checkDate | string | 检查日期(yyyy-MM-dd) |
| checkPlace | string | 检查地点 |
| remark | string | 备注 |
| checkStatus | string | 检查状态(1.待检查 2.已检查) |
| checkResult | string | 检查结果代码 |
| rectificationDate | string | 整改完成日期(yyyy-MM-dd) |
| rectificationMeasures | string | 整改措施 |
| officerIds | array<string> | 执法人ID列表 |
| attachments | array<object> | 附件列表(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后记录 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "更新成功",
  "data": {
    "inspectionId": "ULID6001",
    "checkStatus": "2"
  }
}
```

### 根据ID删除执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId} |
| -- | -- |
| 请求方式 | DELETE |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| inspectionId | string | 检查记录ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "删除成功"
}
```
### 分页查询历史执法检查记录
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections/history |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| Query 参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| page | integer | 当前页 |
| pagesize | integer | 每页记录数 |
| enforcementId | string | 执法信息ID(可选) |
| officerId | string | 执法人ID(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 历史检查记录列表 |
| total | integer | 总记录数 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": [
    {
      "inspectionId": "ULID6000",
      "enforcementId": "ULID3999",
      "checkDate": "2024-06-30"
    }
  ],
  "total": 1
}
```

### 添加抽样数据
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId}/samples |
| -- | -- |
| 请求方式 | POST |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| inspectionId | string | 检查记录ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| sampleCode | string | 样品编码 |
| sampleName | string | 样品名称 |
| sampleNumber | integer | 样品数量 |
| unit | string | 计量单位 |
| remark | string | 备注(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 创建后抽样数据 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "新增成功",
  "data": {
    "sampleId": "ULID7001",
    "inspectionId": "ULID6001"
  }
}
```

### 修改抽样数据
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId}/samples/{sampleId} |
| -- | -- |
| 请求方式 | PUT |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| inspectionId | string | 检查记录ID |
| sampleId | string | 抽样数据ID |
| 请求体参数 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| sampleNumber | integer | 样品数量 |
| remark | string | 备注(可选) |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | object | 更新后抽样数据 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "更新成功",
  "data": {
    "sampleId": "ULID7001",
    "sampleNumber": 5
  }
}
```

### 根据执法信息ID查询抽样数据
系统接口设计
| 请求地址 | /api/lawenforcement/site-inspections/{inspectionId}/samples |
| -- | -- |
| 请求方式 | GET |
| 认证方式 | Bearer Auth |
| 响应格式 | json |
| 请求头参数 | |
| Authorization | access_token |
| 路径参数 | |
| inspectionId | string | 检查记录ID |
| 响应结果 | |
| 参数名称 | 类型 | 说明 |
| -- | -- | -- |
| code | integer | 状态码 |
| success | boolean | 是否成功 |
| msg | string | 消息 |
| data | array<object> | 抽样数据列表 |
| 返回示例 | |
```json
{
  "code": 0,
  "success": true,
  "msg": "查询成功",
  "data": [
    {
      "sampleId": "ULID7001",
      "sampleName": "水样",
      "sampleNumber": 3,
      "unit": "瓶"
    }
  ]
}
```