# ServiceDonatemaintenanceController - add 接口文档

## 接口概述
- **接口路径**：`POST /project/donatemaintenance/add`
- **接口描述**：新增供体维护记录
- **API标签**：供体维护记录管理

## 请求信息
- **请求方式**：POST
- **请求路径**：`/project/donatemaintenance/add`
- **内容类型**：application/json
- **认证要求**：需要登录认证（基于系统权限控制）
- **防重复提交**：使用 @RepeatSubmit 注解防止重复提交

## 请求参数
### Body 参数
| 参数名 | 类型 | 必填 | 示例值 | 描述 |
|--------|------|------|--------|------|
| serviceDonatemaintenance | [ServiceDonatemaintenance](file:///D:/daima/opo/opo-qd/ruoyi-project/src/main/java/com/ruoyi/project/domain/ServiceDonatemaintenance.java) | 是 | - | 供体维护记录对象 |

### ServiceDonatemaintenance 参数详情
| 参数名 | 类型 | 必填 | 默认值 | 描述 |
|--------|------|------|--------|------|
| id | Long | 否 | - | 主键ID（新增时不需要传） |
| infoid | Long | 是 | - | 关联service_donatebaseinfo表的ID |
| caseNo | String | 否 | - | 案例编号 |
| donorno | String | 否 | - | 捐献者编号 |
| itemNo | String | 否 | - | 维护项目编号 |
| itemName | String | 否 | - | 维护项目名称 |
| itemTime | Date | 否 | - | 维持项目时间（格式：yyyy-MM-dd HH:mm:ss） |
| itemDesc | String | 否 | - | 项目维护详情（json结构） |
| searchValue | String | 否 | - | 搜索值（继承自BaseEntity） |
| createBy | String | 否 | - | 创建者（继承自BaseEntity） |
| createTime | Date | 否 | - | 创建时间（继承自BaseEntity） |
| updateBy | String | 否 | - | 更新者（继承自BaseEntity） |
| updateTime | Date | 否 | - | 更新时间（继承自BaseEntity） |
| remark | String | 否 | - | 备注（继承自BaseEntity） |
| delFlag | Integer | 否 | - | 状态（0正常 1删除）（继承自BaseEntity） |
| pageNum | Integer | 否 | - | 页码（继承自BaseEntity） |
| pageSize | Integer | 否 | - | 每页显示数量（继承自BaseEntity） |
| params | Map<String, Object> | 否 | - | 请求参数（继承自BaseEntity） |

## 响应信息
### 成功响应 (200)
```json
{
  "code": 200,
  "msg": "操作成功",
  "rows": 1
}
```

### 失败响应 (非200)
```json
{
  "code": 500,
  "msg": "操作失败"
}
```

## 响应字段说明
| 字段名 | 类型 | 描述 |
|--------|------|------|
| code | Integer | 响应状态码，200表示成功 |
| msg | String | 响应消息 |
| rows | Integer | 影响的行数（成功新增的记录数） |

## 业务逻辑说明
1. 接收供体维护记录对象 `ServiceDonatemaintenance`
2. 校验必填字段（特别是 `infoid`，用于关联捐献基础信息）
3. 执行数据库插入操作
4. 返回操作结果

## 使用场景
此接口主要用于：
1. 新增供体维护记录
2. 记录供体维护项目的执行情况
3. 记录呼吸机、药物、监测等维护项目的详细信息
4. 医疗人员记录供体维护操作
5. 建立供体维护的完整记录链

## 请求示例
```json
{
  "infoid": 100,
  "caseNo": "CASE20240129001",
  "donorno": "DONOR20240129001",
  "itemNo": "ITEM001",
  "itemName": "呼吸机维护",
  "itemTime": "2024-01-29 10:00:00",
  "itemDesc": "{\"pressure\":\"15cmH2O\",\"frequency\":\"16次/分\",\"mode\":\"SIMV\",\"oxygen\":\"60%\"}",
  "remark": "供体呼吸机参数调整"
}
```

## itemDesc JSON 结构示例
根据不同的维护项目，`itemDesc` 字段可能包含不同的结构：

### 呼吸机维护
```json
{
  "pressure": "15cmH2O",
  "frequency": "16次/分",
  "mode": "SIMV",
  "oxygen": "60%",
  "tidalVolume": "500ml"
}
```

### 药物维护
```json
{
  "drugName": "多巴胺",
  "dosage": "5μg/kg/min",
  "route": "静脉滴注",
  "startTime": "2024-01-29 08:00:00",
  "endTime": "2024-01-29 12:00:00"
}
```

### 生命体征监测
```json
{
  "bloodPressure": "120/80mmHg",
  "heartRate": "75次/分",
  "temperature": "36.5℃",
  "oxygenSaturation": "98%"
}
```

## 注意事项
1. **必填字段**：
   - `infoid`：关联service_donatebaseinfo表的ID，必须提供且必须是有效的捐献基础信息ID
2. **防重复提交**：接口使用 `@RepeatSubmit` 注解，防止用户重复提交相同的维护记录
3. **操作日志**：接口会自动记录操作日志（标题：供体维护记录，业务类型：INSERT）
4. **JSON 格式**：
   - `itemDesc` 字段存储的是 JSON 格式的维护详情
   - 必须是有效的 JSON 字符串
   - 具体结构根据维护项目类型而定
5. **关联关系**：
   - 通过 `infoid` 关联到捐献基础信息表（`service_donatebaseinfo`）
   - 可选填写 `caseNo` 和 `donorno` 用于快速检索
6. **维护项目**：
   - `itemNo` 和 `itemName` 建议从系统字典或配置中获取
   - 确保维护项目的一致性和规范性
7. **时间记录**：
   - `itemTime` 记录维护项目的执行时间
   - 格式为 `yyyy-MM-dd HH:mm:ss`
   - 建议记录实际操作时间
8. **数据完整性**：
   - 建议同时填写 `itemNo`、`itemName`、`itemTime` 和 `itemDesc`
   - 确保维护记录的完整性和可追溯性
9. **权限控制**：接口需要登录认证才能访问
10. **业务建议**：
    - 每次维护操作建议单独记录一条
    - 便于后续查询和统计
    - 方便追溯维护历史