ServiceDonatemaintenanceController - add 接口文档

接口概述

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

请求信息

请求方式：POST
请求路径：/project/donatemaintenance/add
内容类型：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
校验必填字段（特别是 infoid，用于关联捐献基础信息）
执行数据库插入操作
返回操作结果

使用场景

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

请求示例

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

呼吸机维护

{
  "pressure": "15cmH2O",
  "frequency": "16次/分",
  "mode": "SIMV",
  "oxygen": "60%",
  "tidalVolume": "500ml"
}

药物维护

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

生命体征监测

{
  "bloodPressure": "120/80mmHg",
  "heartRate": "75次/分",
  "temperature": "36.5℃",
  "oxygenSaturation": "98%"
}

注意事项

必填字段：

infoid：关联service_donatebaseinfo表的ID，必须提供且必须是有效的捐献基础信息ID

防重复提交：接口使用 @RepeatSubmit 注解，防止用户重复提交相同的维护记录
操作日志：接口会自动记录操作日志（标题：供体维护记录，业务类型：INSERT）
JSON 格式：

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

关联关系：

通过 infoid 关联到捐献基础信息表（service_donatebaseinfo）
可选填写 caseNo 和 donorno 用于快速检索

维护项目：

itemNo 和 itemName 建议从系统字典或配置中获取
确保维护项目的一致性和规范性

时间记录：

itemTime 记录维护项目的执行时间
格式为 yyyy-MM-dd HH:mm:ss
建议记录实际操作时间

数据完整性：

建议同时填写 itemNo、itemName、itemTime 和 itemDesc
确保维护记录的完整性和可追溯性

权限控制：接口需要登录认证才能访问
业务建议：
- 每次维护操作建议单独记录一条
- 便于后续查询和统计
- 方便追溯维护历史