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	否	"器官状态良好"	多次评估意见

请求示例

{
  "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)

{
  "code": 200,
  "msg": "操作成功",
  "data": true
}

失败响应 - infoid已存在

{
  "code": 500,
  "msg": "新增医学评估的infoid已存在,无法保存!"
}

失败响应 - 其他错误

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

响应字段说明

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

业务逻辑说明

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

使用场景

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

注意事项

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