ServiceMedicalevaluationController - medevaluateBaseInfolist 接口文档

接口概述

• 接口路径：POST /project/medicalevaluation/medevaluateBaseInfolist
• 接口描述：获取医疗评估患者基本信息列表
• API标签：医疗评估管理

请求信息

• 请求方式：POST
• 请求路径：/project/medicalevaluation/medevaluateBaseInfolist
• 内容类型：application/json
• 认证要求：需要登录认证（基于系统权限控制）

请求参数

Body 参数

| medicalEvaluationWithBaseInfoVO | MedicalEvaluationWithBaseInfoVO | 是 | - | 查询条件对象 |

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<String, Object> | 否 | - | 请求参数（继承自BaseEntity） |

响应信息

成功响应 (200)

{
  "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)

{
  "code": 500,
  "msg": "查询失败"
}

响应字段说明

MedicalevaluationBaseInfoDTO 响应字段

ServiceMedicalevaluationorgan 器官评估详情字段

业务逻辑说明

1. 接收查询条件对象 MedicalEvaluationWithBaseInfoVO
2. 将前端传入的页码转换为数据库偏移量
3. 执行分页查询，获取医疗评估患者基本信息列表
4. 执行不分页查询，获取符合条件的所有数据用于统计总数
5. 封装返回数据：

• data：分页查询结果列表（包含器官评估详情）
• total：总记录数

1. 返回查询结果

使用场景

此接口主要用于：
1. 查询医疗评估患者列表（支持分页）
2. 根据多条件筛选评估记录（姓名、案例编号、医疗机构、评估状态等）
3. 查看包含器官评估详情的综合评估信息
4. 医疗机构对评估进度的统计和管理
5. 协调员查看待评估或已评估的患者列表

请求示例

{
  "name": "张",
  "caseNo": "CASE20240129001",
  "treatmenthospitalname": "某三甲医院",
  "assessState": "1",
  "pageNum": 1,
  "pageSize": 10
}

注意事项

1. 分页参数：pageNum 和 pageSize 为必填参数

• pageNum 从 1 开始
• 系统会自动将页码转换为数据库偏移量

1. 多条件查询：可同时传入多个查询条件，条件之间为 AND 关系
2. 器官评估详情：返回结果中的 serviceMedicalevaluationorgans 字段包含该患者的所有器官评估详情

• 是一个数组，每个元素代表一个器官的评估信息
• 包含器官类型、获取机构、活检情况等详细信息

1. 评估状态说明：

• 1：待评估
• 2：评估中
• 3：已完成

1. 关联查询：返回结果包含了患者的基本信息和医疗评估信息

• 通过 infoid 关联到捐献基础信息表
• 包含患者姓名、性别、年龄、血型等基本信息

1. 日期格式：所有日期时间字段统一使用 yyyy-MM-dd HH:mm:ss 格式
2. 权限控制：接口需要登录认证才能访问
3. 查询优化：接口执行两次查询

• 第一次：获取分页数据
• 第二次：获取总数（不带分页参数）

1. 模糊查询：部分字段可能支持模糊查询（如姓名），具体以后端实现为准
2. 数据权限：根据用户角色和权限，可能只能查看特定范围的评估记录