ServiceDonatebaseinfoReportController - edit 接口文档

接口概述

• 接口路径：POST /project/donatebaseinforeport/edit
• 接口描述：修改捐献上报基础
• API标签：捐献上报基础管理

请求信息

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

请求参数

Body 参数

| serviceDonatebaseinfoReport | ServiceDonatebaseinfoReport | 是 | - | 捐献上报基础信息对象 |

ServiceDonatebaseinfoReport 参数详情

| id | Long | 是 | - | 主键ID（更新必填） |
| caseNo | String | 否 | - | 案例编号 |
| name | String | 否 | - | 姓名 |
| sex | String | 否 | - | 性别（根据字典sys_user_sex） |
| idcardtype | Long | 否 | - | 证件类型（根据字典sys_IDType） |
| idcardno | String | 否 | - | 证件号码 |
| age | Long | 否 | - | 年龄 |
| ageunit | String | 否 | - | 年龄单位（根据字典sys_AgeUnit） |
| birthday | Date | 否 | - | 出生日期（格式：yyyy-MM-dd） |
| phone | String | 否 | - | 联系电话 |
| nationality | String | 否 | - | 国籍 |
| nativeplace | String | 否 | - | 籍贯 |
| nation | String | 否 | - | 民族（根据字典sys_nation） |
| occupation | String | 否 | - | 职业（根据字典sys_occupation） |
| education | String | 否 | - | 学历（根据字典sys_education） |
| residenceaddress | String | 否 | - | 现住地址 |
| residenceprovince | String | 否 | - | 现住地址省代码 |
| residenceprovincename | String | 否 | - | 现住地址省名称 |
| residencetownname | String | 否 | - | 现住地址所属街道（镇）名称 |
| residencecommunity | String | 否 | - | 现住地址社区（村）编号 |
| residencecommunityname | String | 否 | - | 现住地址社区（村）名称 |
| residencecountycode | String | 否 | - | 现住地址所属区域编号 |
| residencecountyname | String | 否 | - | 现住地址所属区域名称 |
| registeraddress | String | 否 | - | 户籍地址 |
| registerprovince | String | 否 | - | 户籍地址省编号 |
| registerprovincename | String | 否 | - | 户籍地址省名称 |
| registercityname | String | 否 | - | 户籍地址市名称 |
| registertownname | String | 否 | - | 户籍地址所属街道（镇）名称 |
| registercommunityname | String | 否 | - | 户籍地址社区（村）名称 |
| treatmenthospitalname | String | 否 | - | 治疗医院名称 |
| treatmentdeptname | String | 否 | - | 治疗科室名称 |
| diagnosisname | String | 否 | - | 疾病诊断名称 |
| inpatientno | String | 否 | - | 住院号 |
| illnessoverview | String | 否 | - | 病情概况 |
| infectious | String | 否 | - | 传染病情况 |
| infectiousOther | String | 否 | - | 传染病其他情况 |
| patientstate | String | 否 | - | 病人状况 |
| infoNo | String | 否 | - | 报告者编号 |
| infoName | String | 否 | - | 报告者姓名 |
| reporterphone | String | 否 | - | 报告者联系电话 |
| reporttime | Date | 否 | - | 报告时间（格式：yyyy-MM-dd HH:mm:ss） |
| terminationCase | Integer | 否 | 0 | 终止案例：0开启 1终止 |
| deptNo | String | 否 | - | 部门编号 |
| deptName | String | 否 | - | 部门名称 |
| gcsScore | String | 否 | - | GSC评分 |
| bloodType | String | 否 | - | 血型（根据字典sys_BloodType） |
| rhYin | String | 否 | - | Rh阴性（0:否 1:是） |
| isTransport | String | 否 | 1 | 是否需要转运（1:不需要 2:需要） |
| reportStatus | String | 否 | - | 上报状态（1:已上报 2:已阅读 3:已同意 4:已驳回） |
| annexfilesList | List<ServiceDonatebaseinfoReportFile> | 否 | - | 附件文件地址集合 |
| serviceTransport | List<ServiceTransport> | 否 | - | 转运信息 |
| coordinatorNo | String | 否 | - | 协调员编号 |
| coordinatorName | String | 否 | - | 协调员姓名 |
| toHospital | String | 否 | - | 上报的医院（患者需要转运到的医院） |
| 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） |

annexfilesList 附件列表字段说明

响应信息

成功响应 (200)

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

失败响应 (非200)

{
  "code": 500,
  "msg": "案例编号为空，请检查后再修改"
}

响应字段说明

业务逻辑说明

1. 接收捐献上报基础信息对象 ServiceDonatebaseinfoReport
2. 校验 caseNo（案例编号）是否为空，为空则抛出异常
3. 根据 id 更新捐献上报基础信息
4. 如果更新成功，同步更新附件信息

• 根据 annexfilesList 更新附件列表
• 关联 id 和 caseNo
• 记录操作人昵称

1. 特殊业务逻辑：如果 reportStatus 为 "3"（已同意），则自动创建捐献档案

• 调用 createDocument 方法
• 将上报信息同步到 ServiceDonatebaseinfo 表（正式建档）

1. 返回更新结果

使用场景

此接口主要用于：
1. 修改已提交的捐献上报信息
2. 更新患者的基本信息和医疗信息
3. 更新附件材料
4. 审核人员修改上报状态（已阅读、已同意、已驳回）
5. 重要场景：审核通过时（reportStatus=3）自动创建正式捐献档案

请求示例

{
  "id": 1,
  "caseNo": "1234567890123456789",
  "name": "张三",
  "sex": "1",
  "idcardno": "110101199001011234",
  "phone": "13800138000",
  "treatmenthospitalname": "某三甲医院",
  "treatmentdeptname": "神经外科",
  "diagnosisname": "脑外伤",
  "gcsScore": "3分",
  "reportStatus": "3",
  "annexfilesList": [
    {
      "name": "更新的病历.pdf",
      "url": "http://localhost:8093/upload/2024/01/29/updated_record.pdf"
    }
  ],
  "remark": "审核通过，同意上报"
}

注意事项

1. 必填字段：

• id：主键ID，用于定位需要更新的记录
• caseNo：案例编号，必须提供且不能为空，否则会抛出异常

1. 防重复提交：接口使用 @RepeatSubmit 注解，防止用户重复提交相同的更新请求
2. 操作日志：接口会自动记录操作日志（标题：捐献上报基础，业务类型：UPDATE）
3. 附件更新：

• 传入 annexfilesList 会更新整个附件列表
• 需要提供完整的附件列表，系统会根据列表进行增删改操作

1. 自动建档逻辑：

• 当 reportStatus 更新为 "3"（已同意）时
• 系统会自动调用 createDocument 方法
• 将上报信息同步到正式的捐献基础信息表（ServiceDonatebaseinfo）
• 这是从"上报"到"建档"的关键转换点

1. 上报状态说明：

• 1：已上报（初始提交状态）
• 2：已阅读（审核人员已查看）
• 3：已同意（审核通过，会触发建档）
• 4：已驳回（审核不通过）

1. 日期格式：

• birthday 使用 yyyy-MM-dd 格式
• reporttime 使用 yyyy-MM-dd HH:mm:ss 格式

1. 字典值参考：与新增接口相同，参考系统字典配置
2. 异常处理：

• 案例编号为空时抛出 BaseException 异常
• 前端需要捕获并处理该异常

1. 权限说明：接口需要登录认证才能访问