ServiceDonatebaseinfoController - donateBaseInfoProgressList 接口文档

接口概述

• 接口路径：POST /project/donatebaseinfo/donateBaseInfoProgressList
• 接口描述：捐献进度基本信息列表
• API标签：潜在捐献信息管理

请求信息

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

请求参数

Body 参数

| donatebaseinfoProgressVO | DonatebaseinfoProgressVO | 是 | - | 查询条件对象 |

DonatebaseinfoProgressVO 参数详情

| id | Long | 否 | - | 主键ID |
| inpatientNo | String | 否 | - | 住院号 |
| caseNo | String | 否 | - | 案例编号 |
| terminationCase | Integer | 否 | - | 终止案例：0开启 1终止 默认0 |
| diagnosisName | String | 否 | - | 疾病诊断名称 |
| workflow | Long | 否 | - | 工作流 |
| treatmentHospitalName | String | 否 | - | 上报医院 |
| startAge | Long | 否 | - | 开始年龄 |
| endAge | Long | 否 | - | 结束年龄 |
| name | String | 否 | - | 姓名 |
| reportId | Long | 否 | - | 案例上报ID |
| idcardno | String | 否 | - | 证件号码 |
| recordstate | String | 否 | - | 记录状态 |
| searchValue | String | 否 | - | 搜索值 |
| createBy | String | 否 | - | 创建者 |
| createTime | Date | 否 | - | 创建时间 |
| updateBy | String | 否 | - | 更新者 |
| updateTime | Date | 否 | - | 更新时间 |
| remark | String | 否 | - | 备注 |
| delFlag | Integer | 否 | - | 状态（0正常 1删除） |
| pageNum | Integer | 是 | - | 页码，从1开始 |
| pageSize | Integer | 是 | - | 每页显示数量 |
| params | Map<String, Object> | 否 | - | 请求参数 |

响应信息

成功响应 (200)

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "terminationCase": {
      "0": 5,
      "1": 2
    },
    "donatebaseinfoProgressDTOS": [
      {
        "id": 1,
        "treatmenthospitalno": "H001",
        "inpatientNo": "IN20211115001",
        "treatmenthospitalname": "某三甲医院",
        "donorno": "DONOR20211115001",
        "caseNo": "CASE20211115001",
        "name": "张三",
        "sex": "1",
        "recordstate": "01",
        "age": 45,
        "workflow": 3,
        "ageunit": "岁",
        "bloodtype": "A",
        "reporttime": "2021-11-15 10:30:00",
        "diagnosisname": "脑外伤",
        "coordinatorNo": "COORD001",
        "coordinatorName": "李协调员",
        "assessState": "1",
        "assessTime": "2021-11-15 14:00:00",
        "signDate": "2021-11-16 15:00:00",
        "expertConclusion": "同意",
        "expertTime": "2021-11-17 10:00:00",
        "organCount": 2,
        "operationBegTime": "2021-11-18 08:00:00",
        "completeTime": "2021-11-18 17:00:00",
        "terminationCase": 0,
        "searchValue": null,
        "createBy": "admin",
        "createTime": "2021-11-15 10:30:00",
        "updateBy": "admin",
        "updateTime": "2021-11-15 10:30:00",
        "remark": null,
        "delFlag": 0,
        "params": {}
      }
    ]
  },
  "total": 1
}

失败响应 (非200)

{
  "code": 500,
  "msg": "错误信息描述"
}

响应字段说明

DonatebaseinfoProgressDTO 响应字段

业务逻辑说明

1. 接收查询条件对象 DonatebaseinfoProgressVO
2. 将前端传入的页码转换为数据库偏移量
3. 执行分页查询，获取捐献进度基本信息列表
4. 执行不分页查询，获取符合条件的所有数据用于统计
5. 根据终止案例状态进行分组统计，统计各状态下的案例数量
6. 封装返回数据：

• terminationCase：终止案例统计信息（Map格式，key为状态值，value为数量）
• donatebaseinfoProgressDTOS：分页查询结果列表
• total：总记录数

使用场景

此接口主要用于：
1. 捐献进度信息的列表查询
2. 医疗机构对捐献进度情况的统计和管理
3. 捐献流程各阶段状态跟踪
4. 相关统计数据的获取（特别是终止案例统计）
5. 支持多条件组合筛选查询

注意事项

1. 该接口支持分页查询，pageNum 和 pageSize 为必填参数
2. 可根据多个条件进行筛选查询（住院号、案例编号、姓名、年龄范围、工作流状态等）
3. 返回结果包含终止案例统计信息，用于数据分析
4. 接口会执行两次数据库查询：一次用于分页数据，一次用于总数及统计
5. 需要系统登录权限才能访问
6. 日期时间字段统一使用 yyyy-MM-dd HH:mm:ss 格式
7. terminationCase 统计结果为 Map 结构，key 为终止案例状态（0或1），value 为该状态的案例数量