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": "查询失败"
}
响应字段说明
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) |
业务逻辑说明
- 接收查询条件对象
ServiceDonatebaseinfoReport
- 根据传入的查询条件构建查询语句
- 执行分页查询,获取捐献上报基础信息列表
- 从分页结果中提取记录列表和总数
- 封装返回数据:
data:当前页的记录列表
total:符合条件的记录总数
- 返回查询结果
使用场景
此接口主要用于:
1. 查询捐献上报信息列表(支持分页)
2. 根据多条件筛选上报记录(姓名、案例编号、上报状态等)
3. 审核人员查看待审核的上报列表
4. 协调员查看自己提交的上报记录
5. 统计和管理捐献上报信息
请求示例
{
"name": "张",
"reportStatus": "1",
"coordinatorNo": "COORD001",
"pageNum": 1,
"pageSize": 10
}
注意事项
- 分页参数:
pageNum 和 pageSize 为必填参数
pageNum 从 1 开始
pageSize 建议值:10、20、50
- 模糊查询:部分字段支持模糊查询(如姓名),具体以后端实现为准
- 多条件查询:可同时传入多个查询条件,条件之间为 AND 关系
- 上报状态筛选:
- 传入
reportStatus 可筛选特定状态的记录
- 1:已上报
- 2:已阅读
- 3:已同意
- 4:已驳回
- 协调员筛选:可根据
coordinatorNo 或 coordinatorName 筛选特定协调员的上报记录
- 医院筛选:可根据
treatmenthospitalname 筛选特定医院的上报记录
- 日期筛选:可通过
params 参数传入日期范围进行筛选
- 权限控制:接口需要登录认证,返回结果可能受用户权限限制
- 响应数据:列表中不包含附件信息,如需获取附件,请调用详情接口
- 数据权限:根据用户角色和权限,可能只能查看特定范围的上报记录