# ServiceMedicalevaluationController - add 接口文档

## 接口概述
- **接口路径**：`POST /project/medicalevaluation/add`
- **接口描述**：新增医学评估
- **API标签**：医疗评估管理

## 请求信息
- **请求方式**：POST
- **请求路径**：`/project/medicalevaluation/add`
- **内容类型**：application/json
- **认证要求**：需要登录认证（基于系统权限控制）

## 请求参数
### Body 参数
请求体为 ServiceMedicalevaluationVO 对象，包含以下字段：

| 参数名 | 类型 | 必填 | 示例值 | 描述 |
|--------|------|------|--------|------|
| id | Long | 否 | 1 | 主键ID |
| infoid | Long | 是 | 100 | 关联service_donatebaseinfo表的ID |
| caseNo | String | 否 | "CASE202602050001" | 案例编号 |
| donorno | String | 否 | "DN202602050001" | 捐献者编号 |
| diagnosisname | String | 否 | "脑出血" | 疾病诊断名称 |
| assessannex | String | 否 | "http://example.com/file.pdf" | 评估附件 |
| assessState | String | 否 | "1" | 评估状态：首次：1.评估通过  2评估不通过  最终：3.评估通过  4评估不通过 |
| assessFirstTime | Date | 否 | "2026-02-05 10:30:00" | 首次评估时间(默认评估时间)，格式：yyyy-MM-dd HH:mm:ss |
| assessSecondTime | Date | 否 | "2026-02-06 14:20:00" | 二次评估时间，格式：yyyy-MM-dd HH:mm:ss |
| coordinatorNo | String | 否 | "CD001" | 协调员编号 |
| coordinatorName | String | 否 | "张三" | 协调员姓名 |
| reporttime | Date | 否 | "2026-02-05 09:00:00" | 报告时间，格式：yyyy-MM-dd HH:mm:ss |
| serviceMedicalevaluationorganList | List<ServiceMedicalevaluationorgan> | 否 | 见下方详情 | 捐献器官评估列表 |

### ServiceMedicalevaluationorgan（捐献器官评估）参数详情
serviceMedicalevaluationorganList 是一个数组，每个元素包含以下字段：

| 参数名 | 类型 | 必填 | 示例值 | 描述 |
|--------|------|------|--------|------|
| id | Long | 否 | 1 | 主键ID |
| infoid | Long | 否 | 100 | 关联service_donatebaseinfo表的ID |
| medicalId | Long | 否 | 50 | 关联service_medicalevaluation表的ID |
| donorno | String | 否 | "DN202602050001" | 捐献者编号 |
| organno | String | 否 | "01" | 器官类别，详见字典sys_Organ |
| organname | String | 否 | "肝脏" | 器官类别名称，详见字典sys_Organ |
| organnumber | String | 否 | "ORG20260205001" | 器官编号 |
| gainhospitalno | String | 否 | "H001" | 器官获取机构编号，对应机构表 |
| gainhospitalname | String | 否 | "省人民医院" | 器官获取机构名称，对应机构表 |
| isbiopsybefore | String | 否 | "0" | 获取前活检，参见sys_0_1 |
| isbiopsyafter | String | 否 | "1" | 获取后活检，参见sys_0_1 |
| ismarginalorgan | String | 否 | "0" | 属于边缘器官，参见sys_0_1 |
| ispathogenpositive | String | 否 | "0" | 病原菌阳性，参见sys_0_1 |
| ispnf | String | 否 | "0" | 原发性无功能，参见sys_0_1 |
| isdgf | String | 否 | "0" | 功能延迟性恢复，参见sys_0_1 |
| assesscontent | String | 否 | "器官状态良好" | 多次评估意见 |

## 请求示例
```json
{
  "infoid": 100,
  "caseNo": "CASE202602050001",
  "donorno": "DN202602050001",
  "diagnosisname": "脑出血",
  "assessannex": "http://example.com/file.pdf",
  "assessState": "1",
  "assessFirstTime": "2026-02-05 10:30:00",
  "coordinatorNo": "CD001",
  "coordinatorName": "张三",
  "reporttime": "2026-02-05 09:00:00",
  "serviceMedicalevaluationorganList": [
    {
      "infoid": 100,
      "donorno": "DN202602050001",
      "organno": "01",
      "organname": "肝脏",
      "organnumber": "ORG20260205001",
      "gainhospitalno": "H001",
      "gainhospitalname": "省人民医院",
      "isbiopsybefore": "0",
      "isbiopsyafter": "1",
      "ismarginalorgan": "0",
      "ispathogenpositive": "0",
      "ispnf": "0",
      "isdgf": "0",
      "assesscontent": "器官状态良好"
    }
  ]
}
```

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

### 失败响应 - infoid已存在
```json
{
  "code": 500,
  "msg": "新增医学评估的infoid已存在,无法保存!"
}
```

### 失败响应 - 其他错误
```json
{
  "code": 500,
  "msg": "操作失败"
}
```

## 响应字段说明
| 字段名 | 类型 | 描述 |
|--------|------|------|
| code | Integer | 响应状态码，200表示成功 |
| msg | String | 响应消息 |
| data | Boolean | 操作结果，true表示新增成功 |

## 业务逻辑说明
1. 接收医学评估对象 `ServiceMedicalevaluationVO`（包含器官评估列表）
2. 通过 `@UniqueCheck` 注解校验 infoid 是否已存在
3. 如果 infoid 已存在，返回错误信息："新增医学评估的infoid已存在,无法保存!"
4. 如果校验通过，调用 service 层的 `add` 方法保存数据
5. 保存成功后返回 true，失败返回 false

## 使用场景
此接口主要用于：
1. 新增医学评估记录
2. 同时记录多个器官的评估信息
3. 关联捐献基础信息（通过infoid）
4. 记录协调员和评估时间信息

## 注意事项
- infoid 必须唯一，不能重复提交
- infoid 需要关联已存在的捐献基础信息记录
- serviceMedicalevaluationorganList 可以为空或包含多个器官评估记录
- 日期格式统一为：yyyy-MM-dd HH:mm:ss