# ServiceDonatemaintenanceController - edit 接口文档

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

## 请求信息
- **请求方式**：POST
- **请求路径**：`/project/donatemaintenance/edit`
- **内容类型**：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. 根据 `id` 字段定位需要更新的记录
3. 执行数据库更新操作
4. 返回更新结果

## 使用场景
此接口主要用于：
1. 修改已存在的供体维护记录
2. 更新维护项目的详细信息
3. 修正错误的维护记录
4. 补充维护项目的详细参数
5. 更新维护时间或备注信息

## 请求示例
```json
{
  "id": 1,
  "infoid": 100,
  "caseNo": "CASE20240129001",
  "donorno": "DONOR20240129001",
  "itemNo": "ITEM001",
  "itemName": "呼吸机维护",
  "itemTime": "2024-01-29 10:30:00",
  "itemDesc": "{\"pressure\":\"16cmH2O\",\"frequency\":\"18次/分\",\"mode\":\"SIMV\",\"oxygen\":\"65%\",\"tidalVolume\":\"520ml\"}",
  "remark": "调整呼吸机参数，提高氧浓度"
}
```

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

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

### 药物维护
```json
{
  "drugName": "多巴胺",
  "dosage": "8μg/kg/min",
  "route": "静脉滴注",
  "startTime": "2024-01-29 08:00:00",
  "endTime": "2024-01-29 14:00:00",
  "adjustReason": "血压偏低，增加剂量"
}
```

### 生命体征监测
```json
{
  "bloodPressure": "115/75mmHg",
  "heartRate": "78次/分",
  "temperature": "36.8℃",
  "oxygenSaturation": "99%",
  "note": "生命体征平稳"
}
```

## 注意事项
1. **必填字段**：
   - `id`：主键ID，用于定位需要更新的记录
2. **防重复提交**：接口使用 `@RepeatSubmit` 注解，防止用户重复提交相同的更新请求
3. **操作日志**：接口会自动记录操作日志（标题：供体维护记录，业务类型：UPDATE）
4. **部分更新**：只需要传入需要更新的字段和 `id` 字段，其他字段可以不传或传 null
5. **JSON 格式**：
   - `itemDesc` 字段存储的是 JSON 格式的维护详情
   - 必须是有效的 JSON 字符串
   - 具体结构根据维护项目类型而定
6. **关联关系**：
   - 通过 `infoid` 关联到捐献基础信息表（`service_donatebaseinfo`）
   - 修改时一般不建议更改 `infoid`
7. **维护项目**：
   - 修改时可以更新维护项目的详细信息
   - 建议保持维护项目类型（`itemNo`）的一致性
8. **时间记录**：
   - `itemTime` 记录维护项目的执行时间
   - 格式为 `yyyy-MM-dd HH:mm:ss`
   - 修改时可以调整为实际操作时间
9. **数据完整性**：
   - 更新 `itemDesc` 时建议提供完整的 JSON 结构
   - 避免部分更新导致数据不完整
10. **权限控制**：接口需要登录认证才能访问
11. **返回值**：成功时 `rows` 返回 1（表示更新了1条记录），失败时返回 0
12. **业务建议**：
    - 重要的维护参数调整建议在 `remark` 中说明原因
    - 便于后续追溯和审计
    - 保持维护记录的完整性和可追溯性