# ServiceMedicalevaluationController - medevaluateBaseInfolist 接口文档 ## 接口概述 - **接口路径**：`POST /project/medicalevaluation/medevaluateBaseInfolist` - **接口描述**：获取医疗评估患者基本信息列表 - **API标签**：医疗评估管理 ## 请求信息 - **请求方式**：POST - **请求路径**：`/project/medicalevaluation/medevaluateBaseInfolist` - **内容类型**：application/json - **认证要求**：需要登录认证（基于系统权限控制） ## 请求参数 ### Body 参数 | 参数名 | 类型 | 必填 | 示例值 | 描述 | |--------|------|------|--------|------| | medicalEvaluationWithBaseInfoVO | [MedicalEvaluationWithBaseInfoVO](file:///D:/daima/opo/opo-qd/ruoyi-project/src/main/java/com/ruoyi/project/domain/vo/MedicalEvaluationWithBaseInfoVO.java) | 是 | - | 查询条件对象 | ### MedicalEvaluationWithBaseInfoVO 参数详情 | 参数名 | 类型 | 必填 | 默认值 | 描述 | |--------|------|------|--------|------| | infoid | Long | 否 | - | baseInfo的ID | | recordstate | String | 否 | - | 记录状态 | | caseNo | String | 否 | - | 案例编号 | | donorno | String | 否 | - | 捐献者编号 | | treatmenthospitalname | String | 否 | - | 所在医疗机构名称 | | treatmenthospitalno | String | 否 | - | 所在医疗机构编码 | | sex | String | 否 | - | 性别 | | name | String | 否 | - | 姓名 | | age | Long | 否 | - | 年龄 | | bloodtype | String | 否 | - | 血型 | | idcardno | String | 否 | - | 证件号码 | | diagnosisname | String | 否 | - | 疾病诊断名称 | | coordinatorName | String | 否 | - | 协调员姓名 | | inpatientno | String | 否 | - | 住院号 | | assessTime | Date | 否 | - | 评估时间（格式：yyyy-MM-dd HH:mm:ss） | | assessState | String | 否 | - | 评估状态（1:评估通过 2:评估不通过） | | assessannex | 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 | 是 | - | 页码，从1开始 | | pageSize | Integer | 是 | - | 每页显示数量 | | params | Map | 否 | - | 请求参数（继承自BaseEntity） | ## 响应信息 ### 成功响应 (200) ```json { "code": 200, "msg": "查询成功", "data": [ { "id": 1, "donationcategory": "1", "infoid": 100, "recordstate": "01", "caseNo": "CASE20240129001", "donorno": "DONOR20240129001", "treatmenthospitalname": "某三甲医院", "treatmenthospitalno": "H001", "sex": "1", "age": 45, "bloodtype": "1", "idcardno": "110101197901011234", "diagnosisname": "脑外伤", "coordinatorName": "李协调员", "assessTime": "2024-01-29 10:00:00", "assessState": "1", "assessannex": "http://example.com/file.pdf", "serviceMedicalevaluationorgans": [ { "id": 1, "infoid": 100, "donorno": "DONOR20240129001", "organno": "01", "organname": "肾脏", "organnumber": "ORG001", "gainhospitalno": "H002", "gainhospitalname": "某器官获取医院", "isbiopsybefore": "1", "isbiopsyafter": "0", "ismarginalorgan": "0", "ispathogenpositive": "0", "ispnf": "0", "isdgf": "0", "assesscontent": "器官状态良好，适合移植", "searchValue": null, "createBy": "admin", "createTime": "2024-01-29 10:00:00", "updateBy": "admin", "updateTime": "2024-01-29 10:00:00", "remark": null, "delFlag": 0, "params": {} } ] } ], "total": 1 } ``` ### 失败响应 (非200) ```json { "code": 500, "msg": "查询失败" } ``` ## 响应字段说明 | 字段名 | 类型 | 描述 | |--------|------|------| | code | Integer | 响应状态码，200表示成功 | | msg | String | 响应消息 | | data | Array<[MedicalevaluationBaseInfoDTO](file:///D:/daima/opo/opo-qd/ruoyi-project/src/main/java/com/ruoyi/project/domain/dto/MedicalevaluationBaseInfoDTO.java)> | 医疗评估患者基本信息列表 | | total | Integer | 数据总条数 | ### MedicalevaluationBaseInfoDTO 响应字段 | 字段名 | 类型 | 描述 | |--------|------|------| | id | Long | 医学评估的id | | donationcategory | String | 捐献类别（根据字典sys_DonationCategory） | | infoid | Long | baseInfo的id | | recordstate | String | 记录状态 | | caseNo | String | 案例编号 | | donorno | String | 捐献者编号 | | treatmenthospitalname | String | 所在医疗机构名称 | | treatmenthospitalno | String | 所在医疗机构编码 | | sex | String | 性别 | | age | Long | 年龄 | | bloodtype | String | 血型 | | idcardno | String | 证件号码 | | diagnosisname | String | 疾病诊断名称 | | coordinatorName | String | 协调员姓名 | | assessTime | Date | 评估时间（格式：yyyy-MM-dd HH:mm:ss） | | assessState | String | 评估状态（1:待评估 2:评估中 3:已完成） | | assessannex | String | 评估附件 | | serviceMedicalevaluationorgans | List<[ServiceMedicalevaluationorgan](file:///D:/daima/opo/opo-qd/ruoyi-project/src/main/java/com/ruoyi/project/domain/ServiceMedicalevaluationorgan.java)> | 器官评估详情列表 | ### ServiceMedicalevaluationorgan 器官评估详情字段 | 字段名 | 类型 | 描述 | |--------|------|------| | id | Long | 主键ID | | infoid | Long | 关联service_donatebaseinfo表的ID | | donorno | String | 捐献者编号 | | organno | String | 器官类别编号（详见字典sys_Organ） | | organname | String | 器官类别名称（详见字典sys_Organ） | | organnumber | String | 器官编号 | | gainhospitalno | String | 器官获取机构编号 | | gainhospitalname | String | 器官获取机构名称 | | isbiopsybefore | String | 获取前活检（参见sys_0_1，0:否 1:是） | | isbiopsyafter | String | 获取后活检（参见sys_0_1，0:否 1:是） | | ismarginalorgan | String | 属于边缘器官（参见sys_0_1，0:否 1:是） | | ispathogenpositive | String | 病原菌阳性（参见sys_0_1，0:否 1:是） | | ispnf | String | 原发性无功能（参见sys_0_1，0:否 1:是） | | isdgf | String | 功能延迟性恢复（参见sys_0_1，0:否 1:是） | | assesscontent | String | 多次评估意见 | | searchValue | String | 搜索值（继承自BaseEntity） | | createBy | String | 创建者（继承自BaseEntity） | | createTime | Date | 创建时间（继承自BaseEntity，格式：yyyy-MM-dd HH:mm:ss） | | updateBy | String | 更新者（继承自BaseEntity） | | updateTime | Date | 更新时间（继承自BaseEntity，格式：yyyy-MM-dd HH:mm:ss） | | remark | String | 备注（继承自BaseEntity） | | delFlag | Integer | 状态（0正常 1删除）（继承自BaseEntity） | | pageNum | Integer | 页码（继承自BaseEntity） | | pageSize | Integer | 每页显示数量（继承自BaseEntity） | | params | Map | 请求参数（继承自BaseEntity） | ## 业务逻辑说明 1. 接收查询条件对象 `MedicalEvaluationWithBaseInfoVO` 2. 将前端传入的页码转换为数据库偏移量 3. 执行分页查询，获取医疗评估患者基本信息列表 4. 执行不分页查询，获取符合条件的所有数据用于统计总数 5. 封装返回数据： - `data`：分页查询结果列表（包含器官评估详情） - `total`：总记录数 6. 返回查询结果 ## 使用场景 此接口主要用于： 1. 查询医疗评估患者列表（支持分页） 2. 根据多条件筛选评估记录（姓名、案例编号、医疗机构、评估状态等） 3. 查看包含器官评估详情的综合评估信息 4. 医疗机构对评估进度的统计和管理 5. 协调员查看待评估或已评估的患者列表 ## 请求示例 ```json { "name": "张", "caseNo": "CASE20240129001", "treatmenthospitalname": "某三甲医院", "assessState": "1", "pageNum": 1, "pageSize": 10 } ``` ## 注意事项 1. **分页参数**：`pageNum` 和 `pageSize` 为必填参数 - `pageNum` 从 1 开始 - 系统会自动将页码转换为数据库偏移量 2. **多条件查询**：可同时传入多个查询条件，条件之间为 AND 关系 3. **器官评估详情**：返回结果中的 `serviceMedicalevaluationorgans` 字段包含该患者的所有器官评估详情 - 是一个数组，每个元素代表一个器官的评估信息 - 包含器官类型、获取机构、活检情况等详细信息 4. **评估状态说明**： - 1：待评估 - 2：评估中 - 3：已完成 5. **关联查询**：返回结果包含了患者的基本信息和医疗评估信息 - 通过 `infoid` 关联到捐献基础信息表 - 包含患者姓名、性别、年龄、血型等基本信息 6. **日期格式**：所有日期时间字段统一使用 `yyyy-MM-dd HH:mm:ss` 格式 7. **权限控制**：接口需要登录认证才能访问 8. **查询优化**：接口执行两次查询 - 第一次：获取分页数据 - 第二次：获取总数（不带分页参数） 9. **模糊查询**：部分字段可能支持模糊查询（如姓名），具体以后端实现为准 10. **数据权限**：根据用户角色和权限，可能只能查看特定范围的评估记录