# 政府监管系统 API 文档 (v1.1.0)

## 1. 接口概述

### 1.1 功能范围
- 防疫任务下发
- 补贴发放
- 检疫监管
- 任务状态跟踪

### 1.2 基础路径
`/api/v1/[系统名称]`

### 1.3 权限控制
- 公开接口（无需认证）：数据查询
- 管理接口（需要认证）：数据管理
- 系统接口（高级权限）：配置管理

### 1.4 全局错误码
| 状态码 | 说明               |
|--------|--------------------|
| 400    | 请求参数无效       |
| 401    | 未授权             |
| 403    | 权限不足           |
| 404    | 资源不存在         |
| 500    | 服务器内部错误     |
`/api/v1/gov`

## 2. 接口明细

### 2.1 创建防疫任务
```
POST /quarantines
```

**请求参数**:
| 字段          | 类型   | 必填 | 说明               |
|---------------|--------|------|--------------------|
| location      | string | 是   | GPS坐标(纬度,经度)|
| inspector_id  | number | 是   | 检疫员ID          |
| deadline      | string | 是   | 截止日期(YYYY-MM-DD)|
| task_type     | string | 是   | 任务类型(常规/紧急)|
| priority      | number | 否   | 优先级(1-5)       |

**响应示例**:
```json
{
  "status": "success",
  "data": {
    "task_id": "task_001",
    "location": "39.9042,116.4074",
    "inspector_id": 1001,
    "deadline": "2024-01-25",
    "task_type": "紧急",
    "priority": 1,
    "created_at": "2024-01-20T10:00:00Z"
  }
}
```

### 2.2 防疫任务状态查询
```
GET /quarantines/:id/status
```

**请求参数**:
| 参数        | 类型   | 必填 | 说明               |
|-------------|--------|------|--------------------|
| id          | string | 是   | 任务ID             |

**响应示例**:
```json
{
  "status": "success",
  "data": {
    "task_id": "task_001",
    "status": "进行中",
    "progress": 50,
    "inspector": "张三",
    "start_time": "2024-01-20T10:00:00Z",
    "estimated_completion": "2024-01-22T10:00:00Z"
  }
}
```

### 2.3 检疫监管
```
POST /inspections
```

**请求参数**:
| 字段          | 类型   | 必填 | 说明               |
|---------------|--------|------|--------------------|
| cattle_id     | string | 是   | 牛只ID            |
| inspector_id  | number | 是   | 检疫员ID          |
| result        | string | 是   | 检疫结果(合格/不合格)|

**响应示例**:
```json
{
  "status": "success",
  "data": {
    "inspection_id": "insp_001",
    "cattle_id": "cattle_123",
    "inspector_id": 1001,
    "result": "合格",
    "inspection_time": "2024-01-20T10:00:00Z",
    "certificate_number": "CERT-20240120-001"
  }
}
```

## 3. 审计要求
- 所有操作记录操作人IP和时间
- 敏感数据需RSA加密传输

## 4. 权限控制
- 防疫任务下发：政府管理员
- 检疫监管：检疫员
- 补贴发放：财务人员
## 3. 版本历史

### v1.0.0 (2024-01-20)
- 新增: 按照API文档规范标准统一格式
- 优化: 统一响应格式和错误处理
- 功能: 完成基础接口定义