编辑 | blame | 历史 | 原始文档

ServiceDonatebaseinfoReportController - list 接口文档

接口概述

  • 接口路径POST /project/donatebaseinforeport/list
  • 接口描述:查询捐献上报基础列表
  • API标签:捐献上报基础管理

请求信息

  • 请求方式:POST
  • 请求路径/project/donatebaseinforeport/list
  • 内容类型:application/json
  • 认证要求:需要登录认证(基于系统权限控制)

请求参数

Body 参数

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

| serviceDonatebaseinfoReport | ServiceDonatebaseinfoReport | 是 | - | 查询条件对象 |

ServiceDonatebaseinfoReport 查询条件详情

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

| id | Long | 否 | - | 主键ID |
| caseNo | String | 否 | - | 案例编号 |
| name | String | 否 | - | 姓名(支持模糊查询) |
| sex | String | 否 | - | 性别(根据字典sys_user_sex) |
| idcardtype | Long | 否 | - | 证件类型(根据字典sys_IDType) |
| idcardno | String | 否 | - | 证件号码 |
| age | Long | 否 | - | 年龄 |
| ageunit | String | 否 | - | 年龄单位(根据字典sys_AgeUnit) |
| birthday | Date | 否 | - | 出生日期(格式:yyyy-MM-dd) |
| phone | String | 否 | - | 联系电话 |
| nationality | String | 否 | - | 国籍 |
| nativeplace | String | 否 | - | 籍贯 |
| nation | String | 否 | - | 民族(根据字典sys_nation) |
| occupation | String | 否 | - | 职业(根据字典sys_occupation) |
| education | String | 否 | - | 学历(根据字典sys_education) |
| residenceaddress | String | 否 | - | 现住地址 |
| residenceprovince | String | 否 | - | 现住地址省代码 |
| residenceprovincename | String | 否 | - | 现住地址省名称 |
| residencetownname | String | 否 | - | 现住地址所属街道(镇)名称 |
| residencecommunity | String | 否 | - | 现住地址社区(村)编号 |
| residencecommunityname | String | 否 | - | 现住地址社区(村)名称 |
| residencecountycode | String | 否 | - | 现住地址所属区域编号 |
| residencecountyname | String | 否 | - | 现住地址所属区域名称 |
| registeraddress | String | 否 | - | 户籍地址 |
| registerprovince | String | 否 | - | 户籍地址省编号 |
| registerprovincename | String | 否 | - | 户籍地址省名称 |
| registercityname | String | 否 | - | 户籍地址市名称 |
| registertownname | String | 否 | - | 户籍地址所属街道(镇)名称 |
| registercommunityname | String | 否 | - | 户籍地址社区(村)名称 |
| treatmenthospitalname | String | 否 | - | 治疗医院名称 |
| treatmentdeptname | String | 否 | - | 治疗科室名称 |
| diagnosisname | String | 否 | - | 疾病诊断名称 |
| inpatientno | String | 否 | - | 住院号 |
| illnessoverview | String | 否 | - | 病情概况 |
| infectious | String | 否 | - | 传染病情况 |
| infectiousOther | String | 否 | - | 传染病其他情况 |
| patientstate | String | 否 | - | 病人状况 |
| infoNo | String | 否 | - | 报告者编号 |
| infoName | String | 否 | - | 报告者姓名 |
| reporterphone | String | 否 | - | 报告者联系电话 |
| reporttime | Date | 否 | - | 报告时间(格式:yyyy-MM-dd HH:mm:ss) |
| terminationCase | Integer | 否 | - | 终止案例:0开启 1终止 |
| deptNo | String | 否 | - | 部门编号 |
| deptName | String | 否 | - | 部门名称 |
| gcsScore | String | 否 | - | GSC评分 |
| bloodType | String | 否 | - | 血型(根据字典sys_BloodType) |
| rhYin | String | 否 | - | Rh阴性(0:否 1:是) |
| isTransport | String | 否 | - | 是否需要转运(1:不需要 2:需要) |
| reportStatus | String | 否 | - | 上报状态(1:已上报 2:已阅读 3:已同意 4:已驳回) |
| coordinatorNo | String | 否 | - | 协调员编号 |
| coordinatorName | String | 否 | - | 协调员姓名 |
| toHospital | 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,
      "caseNo": "1234567890123456789",
      "name": "张三",
      "sex": "1",
      "idcardtype": 1,
      "idcardno": "110101199001011234",
      "age": 34,
      "ageunit": "岁",
      "birthday": "1990-01-01",
      "phone": "13800138000",
      "nationality": "中国",
      "nation": "汉族",
      "occupation": "工人",
      "education": "本科",
      "residenceaddress": "北京市朝阳区某街道123号",
      "residenceprovincename": "北京市",
      "treatmenthospitalname": "某三甲医院",
      "treatmentdeptname": "神经外科",
      "diagnosisname": "脑外伤",
      "inpatientno": "IN20240129001",
      "illnessoverview": "患者因交通事故导致重度脑外伤",
      "patientstate": "危重",
      "gcsScore": "3分",
      "bloodType": "1",
      "rhYin": "0",
      "isTransport": "1",
      "reportStatus": "1",
      "coordinatorNo": "COORD001",
      "coordinatorName": "李协调员",
      "infoName": "李医生",
      "infoNo": "DOC001",
      "reporterphone": "13900139000",
      "reporttime": "2024-01-29 10:30:00",
      "terminationCase": 0,
      "createBy": "admin",
      "createTime": "2024-01-29 10:30:00",
      "updateBy": "admin",
      "updateTime": "2024-01-29 10:30:00",
      "delFlag": 0
    }
  ],
  "total": 1
}

失败响应 (非200)

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

响应字段说明

字段名 类型 描述
code Integer 响应状态码,200表示成功
msg String 响应消息
data Array<ServiceDonatebaseinfoReport> 捐献上报基础信息列表
total Integer 数据总条数

ServiceDonatebaseinfoReport 响应字段

字段名 类型 描述
id Long 主键ID
caseNo String 案例编号
name String 姓名
sex String 性别
idcardtype Long 证件类型
idcardno String 证件号码
age Long 年龄
ageunit String 年龄单位
birthday Date 出生日期(格式:yyyy-MM-dd)
phone String 联系电话
nationality String 国籍
nativeplace String 籍贯
nation String 民族
occupation String 职业
education String 学历
residenceaddress String 现住地址
residenceprovince String 现住地址省代码
residenceprovincename String 现住地址省名称
residencetownname String 现住地址所属街道(镇)名称
residencecommunity String 现住地址社区(村)编号
residencecommunityname String 现住地址社区(村)名称
residencecountycode String 现住地址所属区域编号
residencecountyname String 现住地址所属区域名称
registeraddress String 户籍地址
registerprovince String 户籍地址省编号
registerprovincename String 户籍地址省名称
registercityname String 户籍地址市名称
registertownname String 户籍地址所属街道(镇)名称
registercommunityname String 户籍地址社区(村)名称
treatmenthospitalname String 治疗医院名称
treatmentdeptname String 治疗科室名称
diagnosisname String 疾病诊断名称
inpatientno String 住院号
illnessoverview String 病情概况
infectious String 传染病情况
infectiousOther String 传染病其他情况
patientstate String 病人状况
infoNo String 报告者编号
infoName String 报告者姓名
reporterphone String 报告者联系电话
reporttime Date 报告时间(格式:yyyy-MM-dd HH:mm:ss)
terminationCase Integer 终止案例:0开启 1终止
deptNo String 部门编号
deptName String 部门名称
gcsScore String GSC评分
bloodType String 血型
rhYin String Rh阴性(0:否 1:是)
isTransport String 是否需要转运(1:不需要 2:需要)
reportStatus String 上报状态(1:已上报 2:已阅读 3:已同意 4:已驳回)
coordinatorNo String 协调员编号
coordinatorName String 协调员姓名
toHospital 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<String, Object> 请求参数(继承自BaseEntity)

业务逻辑说明

  1. 接收查询条件对象 ServiceDonatebaseinfoReport
  2. 根据传入的查询条件构建查询语句
  3. 执行分页查询,获取捐献上报基础信息列表
  4. 从分页结果中提取记录列表和总数
  5. 封装返回数据:
  • data:当前页的记录列表
  • total:符合条件的记录总数
  1. 返回查询结果

使用场景

此接口主要用于:
1. 查询捐献上报信息列表(支持分页)
2. 根据多条件筛选上报记录(姓名、案例编号、上报状态等)
3. 审核人员查看待审核的上报列表
4. 协调员查看自己提交的上报记录
5. 统计和管理捐献上报信息

请求示例

{
  "name": "张",
  "reportStatus": "1",
  "coordinatorNo": "COORD001",
  "pageNum": 1,
  "pageSize": 10
}

注意事项

  1. 分页参数pageNumpageSize 为必填参数
  • pageNum 从 1 开始
  • pageSize 建议值:10、20、50
  1. 模糊查询:部分字段支持模糊查询(如姓名),具体以后端实现为准
  2. 多条件查询:可同时传入多个查询条件,条件之间为 AND 关系
  3. 上报状态筛选
  • 传入 reportStatus 可筛选特定状态的记录
  • 1:已上报
  • 2:已阅读
  • 3:已同意
  • 4:已驳回
  1. 协调员筛选:可根据 coordinatorNocoordinatorName 筛选特定协调员的上报记录
  2. 医院筛选:可根据 treatmenthospitalname 筛选特定医院的上报记录
  3. 日期筛选:可通过 params 参数传入日期范围进行筛选
  4. 权限控制:接口需要登录认证,返回结果可能受用户权限限制
  5. 响应数据:列表中不包含附件信息,如需获取附件,请调用详情接口
  6. 数据权限:根据用户角色和权限,可能只能查看特定范围的上报记录