青岛opo项目
编辑 | blame | 历史 | 原始文档

ServiceDonatebaseinfoController - edit 接口文档

接口概述

  • 接口路径：POST /project/donatebaseinfo/edit
  • 接口描述：修改潜在捐献信息
  • API标签：潜在捐献信息管理

请求信息

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

请求参数

Body 参数

参数名 类型 必填 示例值 描述

| serviceDonatebaseinfo | ServiceDonatebaseinfo | 是 | - | 捐献基础信息对象 |

ServiceDonatebaseinfo 参数详情

参数名 类型 必填 默认值 描述

| id | Long | 是 | - | 主键ID（更新必填） |
| caseNo | String | 否 | - | 案例编号 |
| name | String | 否 | - | 姓名 |
| sex | String | 否 | - | 性别（0:未知 1:男 2:女） |
| idcardtype | Long | 否 | - | 证件类型（1:身份证 2:军人证 3:护照等） |
| reportId | Long | 否 | - | 案例上报ID |
| idcardno | String | 否 | - | 证件号码 |
| age | Long | 否 | - | 年龄 |
| ageunit | String | 否 | - | 年龄单位 |
| age2 | Long | 否 | - | 年龄（辅助字段） |
| ageunit2 | String | 否 | - | 年龄单位（辅助字段） |
| birthday | Date | 否 | - | 出生日期（格式：yyyy-MM-dd HH:mm:ss） |
| phone | String | 否 | - | 联系电话 |
| residenceaddress | String | 否 | - | 现住地址 |
| nationality | String | 否 | - | 国籍 |
| residenceprovince | String | 否 | - | 现住地址省(区/市) |
| nativeplace | String | 否 | - | 籍贯 |
| residenceprovincename | String | 否 | - | 现住地址省名称 |
| nation | String | 否 | - | 民族 |
| occupation | String | 否 | - | 职业 |
| residencecity | String | 否 | - | 现住地址市(州) |
| residencecityname | String | 否 | - | 现住地址市名称 |
| education | String | 否 | - | 学历 |
| residencetown | String | 否 | - | 现住地址县（市/区） |
| residencetownname | String | 否 | - | 现住地址所属街道（镇）名称 |
| residencecommunity | String | 否 | - | 现住地址社区（村）编号 |
| residencecommunityname | String | 否 | - | 现住地址社区（村）名称 |
| residencecountycode | String | 否 | - | 现住地址所属区域编号 |
| residencecountyname | String | 否 | - | 现住地址所属区域名称 |
| registeraddress | String | 否 | - | 户籍地址 |
| registerprovince | String | 否 | - | 户籍地址省(区/市) |
| registerprovincename | String | 否 | - | 户籍地址省名称 |
| registercity | String | 否 | - | 户籍地址市(州) |
| registercityname | String | 否 | - | 户籍地址市名称 |
| registertown | String | 否 | - | 户籍地址县（市/区） |
| registertownname | String | 否 | - | 户籍地址所属街道（镇）名称 |
| registercommunity | String | 否 | - | 户籍地址社区（村）编号 |
| registercommunityname | String | 否 | - | 户籍地址社区（村）名称 |
| registercountycode | String | 否 | - | 户籍地址所属区域编号 |
| registercountyname | String | 否 | - | 户籍地址所属区域名称 |
| recordstate | String | 否 | - | 记录状态 |
| treatmenthospitalno | String | 否 | - | 治疗医院编号 |
| treatmenthospitalname | String | 否 | - | 所在医疗机构 |
| treatmentdeptname | String | 否 | - | 科室 |
| diagnosisno | String | 否 | - | 疾病诊断编号 |
| diagnosisname | String | 否 | - | 疾病诊断名称 |
| bloodtype | String | 否 | - | 血型（1:A型 2:B型 3:O型 4:AB型） |
| inpatientno | String | 否 | - | 住院号 |
| rhyin | String | 否 | - | Rh阴性（1:是） |
| donorno | String | 否 | - | 捐献者编号 |
| donationcategory | String | 否 | - | 捐献类别 |
| illnessoverview | String | 否 | - | 病情概况 |
| diseasetype | String | 否 | - | 疾病类型 |
| infectious | String | 否 | - | 传染病情况 |
| selfwill | String | 否 | - | 本人意愿 |
| othercases | String | 否 | - | 其他情况 |
| kinshipwill | Long | 否 | - | 亲属意愿 |
| diseasetypeOther | String | 否 | - | 疾病类型其他 |
| kinship | String | 否 | - | 亲属关系状况 |
| infosources | String | 否 | - | 信息来源 |
| redorganno | String | 否 | - | 红十字会机构编号 |
| redorganname | String | 否 | - | 红十字会机构名称 |
| contactperson | String | 否 | - | 红十字会联系人 |
| infectiousOther | String | 否 | - | 传染病情况其他 |
| contactnumber | String | 否 | - | 红十字会联系电话 |
| reporterno | String | 否 | - | 报告者编号 |
| reportername | String | 否 | - | 报告者姓名 |
| patientstate | String | 否 | - | 病人状况 |
| reporterphone | String | 否 | - | 报告者联系电话 |
| infosourcesOther | String | 否 | - | 信息来源其他 |
| reporttime | Date | 否 | - | 报告时间（格式：yyyy-MM-dd HH:mm:ss） |
| kinshipOther | String | 否 | - | 亲属关系状况其他 |
| majorrelatives | String | 否 | - | 主要亲属 |
| familyrelations | String | 否 | - | 与捐赠者关系 |
| acquisitiontissueno | String | 否 | - | 获取组织编号 |
| acquisitiontissuename | String | 否 | - | 获取组织名称 |
| infoName | String | 否 | - | 信息员姓名 |
| infoNo | String | 否 | - | 信息员编号 |
| infophone | String | 否 | - | 信息员联系方式 |
| contacttime | Date | 否 | - | 联系时间（格式：yyyy-MM-dd HH:mm:ss） |
| starttime | Date | 否 | - | 开始时间（格式：yyyy-MM-dd HH:mm:ss） |
| endtime | Date | 否 | - | 结束时间（格式：yyyy-MM-dd HH:mm:ss） |
| city | String | 否 | - | 城市 |
| deptid | Long | 否 | - | 部门ID |
| deptname | String | 否 | - | 部门名称 |
| leaderno | String | 否 | - | 组长编码 |
| leadername | String | 否 | - | 组长名称 |
| businessarea | String | 否 | - | 业务地区 |
| annexfiles | String | 否 | - | 附件地址（供者评估各项记录） |
| workflow | Integer | 否 | - | 工作流 |
| terminationCase | Integer | 否 | 0 | 终止案例：0开启，1终止 |
| terminationResult | Integer | 否 | - | 终止原因 |
| currentHospital | String | 否 | - | 当前医院 |
| reportHospital | String | 否 | - | 上报医院 |
| donatetime | Date | 否 | - | 案例时间（格式：yyyy-MM-dd HH:mm:ss） |
| donateno | String | 否 | - | 案例序号 |
| currentMedicalInstitution | String | 否 | - | 当前医疗机构 |
| firstMedicalInstitution | String | 否 | - | 首次医疗机构 |
| currentDept | String | 否 | - | 当前医疗机构科室 |
| firstDept | String | 否 | - | 首次医疗机构科室 |
| gcsScore | String | 否 | - | GSC评分 |
| coordinatorNo | String | 否 | - | 协调员编号 |
| coordinatorName | 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） |

响应信息

成功响应 (200)

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

失败响应 (非200)

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

响应字段说明

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

业务逻辑说明

  1. 接收完整的捐献基础信息对象 ServiceDonatebaseinfo
  2. 根据 id 字段定位需要更新的记录
  3. 调用 updateById 方法执行数据库更新操作
  4. 返回更新结果（影响的行数）

使用场景

此接口主要用于：
1. 修改已存在的潜在捐献者基础信息
2. 更新捐献者的个人信息（姓名、性别、年龄、证件信息等）
3. 更新捐献者的地址信息（现住地址、户籍地址等）
4. 更新医疗相关信息（医院、科室、诊断信息等）
5. 更新捐献流程相关信息（工作流状态、终止案例状态等）
6. 更新亲属关系及意愿信息
7. 更新报告者及协调员信息

请求示例

{
  "id": 1,
  "name": "张三",
  "sex": "1",
  "idcardtype": 1,
  "idcardno": "110101199001011234",
  "birthday": "1990-01-01 00:00:00",
  "phone": "13800138000",
  "bloodtype": "1",
  "inpatientno": "IN20211115001",
  "treatmenthospitalname": "某三甲医院",
  "treatmentdeptname": "神经外科",
  "diagnosisname": "脑外伤",
  "recordstate": "01",
  "workflow": 2,
  "terminationCase": 0,
  "coordinatorNo": "COORD001",
  "coordinatorName": "李协调员",
  "residenceaddress": "北京市朝阳区某街道123号",
  "residenceprovincename": "北京市",
  "residencecityname": "北京市",
  "residencetownname": "朝阳区",
  "remark": "信息已更新"
}

注意事项

  1. 必填字段：id 字段必须提供，用于定位需要更新的记录
  2. 防重复提交：接口使用 @RepeatSubmit 注解，防止用户重复提交相同的更新请求
  3. 操作日志：接口会自动记录操作日志（标题：捐献基础，业务类型：UPDATE）
  4. 数据校验：建议在前端进行必要的数据校验（如证件号码格式、电话号码格式等）
  5. 部分更新：只需要传入需要更新的字段和 id 字段，其他字段可以不传或传 null
  6. 日期格式：所有日期时间字段统一使用 yyyy-MM-dd HH:mm:ss 格式
  7. 枚举值：
  • 性别：0-未知 1-男 2-女
  • 血型：1-A型 2-B型 3-O型 4-AB型
  • 终止案例：0-开启 1-终止
  1. 权限控制：接口需要登录认证，但具体权限校验已注释（代码中 @PreAuthorize 被注释）
  2. 返回值：成功时 rows 返回 1（表示更新了1条记录），失败时返回 0
  3. 级联更新：修改基础信息不会影响关联的其他业务表数据（如医疗评估、器官分配等）