# ServiceDonatebaseinfoReportController - list 接口文档

## 接口概述
- **接口路径**：`POST /project/donatebaseinforeport/list`
- **接口描述**：查询捐献上报基础列表
- **API标签**：捐献上报基础管理

## 请求信息
- **请求方式**：POST
- **请求路径**：`/project/donatebaseinforeport/list`
- **内容类型**：application/json
- **认证要求**：需要登录认证（基于系统权限控制）

## 请求参数
### Body 参数
| 参数名 | 类型 | 必填 | 示例值 | 描述 |
|--------|------|------|--------|------|
| serviceDonatebaseinfoReport | [ServiceDonatebaseinfoReport](file:///D:/daima/opo/opo-qd/ruoyi-project/src/main/java/com/ruoyi/project/domain/ServiceDonatebaseinfoReport.java) | 是 | - | 查询条件对象 |

### 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)
```json
{
  "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)
```json
{
  "code": 500,
  "msg": "查询失败"
}
```

## 响应字段说明
| 字段名 | 类型 | 描述 |
|--------|------|------|
| code | Integer | 响应状态码，200表示成功 |
| msg | String | 响应消息 |
| data | Array&lt;[ServiceDonatebaseinfoReport](file:///D:/daima/opo/opo-qd/ruoyi-project/src/main/java/com/ruoyi/project/domain/ServiceDonatebaseinfoReport.java)&gt; | 捐献上报基础信息列表 |
| 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`：符合条件的记录总数
6. 返回查询结果

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

## 请求示例
```json
{
  "name": "张",
  "reportStatus": "1",
  "coordinatorNo": "COORD001",
  "pageNum": 1,
  "pageSize": 10
}
```

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