编辑 | blame | 历史 | 原始文档

ServiceMedicalevaluationController - edit 接口文档

接口概述

  • 接口路径POST /project/medicalevaluation/edit
  • 接口描述:修改医学评估
  • API标签:医疗评估管理

请求信息

  • 请求方式:POST
  • 请求路径/project/medicalevaluation/edit
  • 内容类型: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 "器官状态良好" 多次评估意见

请求示例

{
  "id": 1,
  "infoid": 100,
  "caseNo": "CASE202602050001",
  "donorno": "DN202602050001",
  "diagnosisname": "脑出血",
  "assessannex": "http://example.com/file.pdf",
  "assessState": "3",
  "assessFirstTime": "2026-02-05 10:30:00",
  "assessSecondTime": "2026-02-06 14:20:00",
  "coordinatorNo": "CD001",
  "coordinatorName": "张三",
  "reporttime": "2026-02-05 09:00:00",
  "serviceMedicalevaluationorganList": [
    {
      "id": 10,
      "infoid": 100,
      "medicalId": 1,
      "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": "操作成功",
  "rows": 1
}

失败响应 - 记录不存在

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

失败响应 - 参数错误

{
  "code": 500,
  "msg": "修改失败,请检查参数"
}

响应字段说明

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

业务逻辑说明

  1. 接收医学评估对象 ServiceMedicalevaluationVO(包含主键ID和器官评估列表)
  2. 将 VO 对象转换为 ServiceMedicalevaluation 实体对象
  3. 根据主键 ID 更新医学评估主表记录
  4. 如果更新成功且器官评估列表不为空,遍历列表更新每个器官评估记录
  5. 返回更新结果(成功返回true,失败返回false)

使用场景

此接口主要用于:
1. 修改已存在的医学评估记录
2. 更新评估状态(从首次评估到最终评估)
3. 补充或修改评估时间
4. 同时更新关联的器官评估信息
5. 修改协调员信息和评估附件

注意事项

  • 修改时必须提供医学评估的主键 id
  • 如果需要修改器官评估信息,器官评估记录也必须包含其主键 id
  • 不提供的字段将保持原值不变
  • serviceMedicalevaluationorganList 中的每条记录会独立更新
  • 日期格式统一为:yyyy-MM-dd HH:mm:ss
  • 修改操作会自动记录操作日志(通过 @Log 注解)

与新增接口的区别

  1. 修改接口必须提供主键 id,新增接口不需要
  2. 修改接口不校验 infoid 唯一性,新增接口会校验
  3. 修改接口更新器官评估列表中的现有记录,新增接口插入新记录
  4. 修改接口支持部分字段更新,新增接口需要完整信息