# ServiceDonatebaseinfoController - edit 接口文档 ## 接口概述 - **接口路径**:`POST /project/donatebaseinfo/edit` - **接口描述**:修改潜在捐献信息 - **API标签**:潜在捐献信息管理 ## 请求信息 - **请求方式**:POST - **请求路径**:`/project/donatebaseinfo/edit` - **内容类型**:application/json - **认证要求**:需要登录认证(基于系统权限控制) - **防重复提交**:使用 @RepeatSubmit 注解防止重复提交 ## 请求参数 ### Body 参数 | 参数名 | 类型 | 必填 | 示例值 | 描述 | |--------|------|------|--------|------| | serviceDonatebaseinfo | [ServiceDonatebaseinfo](file:///D:/daima/opo/opo-qd/ruoyi-project/src/main/java/com/ruoyi/project/domain/ServiceDonatebaseinfo.java) | 是 | - | 捐献基础信息对象 | ### 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 | 否 | - | 请求参数(继承自BaseEntity) | ## 响应信息 ### 成功响应 (200) ```json { "code": 200, "msg": "操作成功", "rows": 1 } ``` ### 失败响应 (非200) ```json { "code": 500, "msg": "操作失败" } ``` ## 响应字段说明 | 字段名 | 类型 | 描述 | |--------|------|------| | code | Integer | 响应状态码,200表示成功 | | msg | String | 响应消息 | | rows | Integer | 影响的行数(成功更新的记录数) | ## 业务逻辑说明 1. 接收完整的捐献基础信息对象 `ServiceDonatebaseinfo` 2. 根据 `id` 字段定位需要更新的记录 3. 调用 `updateById` 方法执行数据库更新操作 4. 返回更新结果(影响的行数) ## 使用场景 此接口主要用于: 1. 修改已存在的潜在捐献者基础信息 2. 更新捐献者的个人信息(姓名、性别、年龄、证件信息等) 3. 更新捐献者的地址信息(现住地址、户籍地址等) 4. 更新医疗相关信息(医院、科室、诊断信息等) 5. 更新捐献流程相关信息(工作流状态、终止案例状态等) 6. 更新亲属关系及意愿信息 7. 更新报告者及协调员信息 ## 请求示例 ```json { "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-终止 8. **权限控制**:接口需要登录认证,但具体权限校验已注释(代码中 `@PreAuthorize` 被注释) 9. **返回值**:成功时 `rows` 返回 1(表示更新了1条记录),失败时返回 0 10. **级联更新**:修改基础信息不会影响关联的其他业务表数据(如医疗评估、器官分配等)