ServiceDonatemaintenanceController - edit 接口文档

接口概述

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

请求信息

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

请求参数

Body 参数

参数名	类型	必填	示例值	描述

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)

{
  "code": 200,
  "msg": "操作成功",
  "rows": 1
}

失败响应 (非200)

{
  "code": 500,
  "msg": "操作失败"
}

响应字段说明

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

业务逻辑说明

接收供体维护记录对象 ServiceDonatemaintenance
根据 id 字段定位需要更新的记录
执行数据库更新操作
返回更新结果

使用场景

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

请求示例

{
  "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 字段可能包含不同的结构：

呼吸机维护

{
  "pressure": "16cmH2O",
  "frequency": "18次/分",
  "mode": "SIMV",
  "oxygen": "65%",
  "tidalVolume": "520ml"
}

药物维护

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

生命体征监测

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

注意事项

必填字段：

id：主键ID，用于定位需要更新的记录

防重复提交：接口使用 @RepeatSubmit 注解，防止用户重复提交相同的更新请求
操作日志：接口会自动记录操作日志（标题：供体维护记录，业务类型：UPDATE）
部分更新：只需要传入需要更新的字段和 id 字段，其他字段可以不传或传 null
JSON 格式：

itemDesc 字段存储的是 JSON 格式的维护详情
必须是有效的 JSON 字符串
具体结构根据维护项目类型而定

关联关系：

通过 infoid 关联到捐献基础信息表（service_donatebaseinfo）
修改时一般不建议更改 infoid

维护项目：

修改时可以更新维护项目的详细信息
建议保持维护项目类型（itemNo）的一致性

时间记录：

itemTime 记录维护项目的执行时间
格式为 yyyy-MM-dd HH:mm:ss
修改时可以调整为实际操作时间

数据完整性：

更新 itemDesc 时建议提供完整的 JSON 结构
避免部分更新导致数据不完整

权限控制：接口需要登录认证才能访问
返回值：成功时 rows 返回 1（表示更新了1条记录），失败时返回 0
业务建议：
- 重要的维护参数调整建议在 remark 中说明原因
- 便于后续追溯和审计
- 保持维护记录的完整性和可追溯性