# 机构端报告库 · 原型对照与缺口说明

> 原型模块：`mod-institution-report-library`（`institution.html`）  
> OpenAPI（Apifox）：[`docs/openapi/机构端-安评报告库.openapi.yaml`](../openapi/机构端-安评报告库.openapi.yaml)  
> 库表增量：[`docs/db/alter-eval-report-library-fields.sql`](../db/alter-eval-report-library-fields.sql)

## 1. 原型展示与功能清单

| 区域 | 原型内容 | 后端 |
|------|----------|------|
| 页头 | 标题 +「上传历史报告」 | `POST /add` |
| 汇总卡 | 总数 / 近三年 / 已报送 / 待完善 / 抽查中 | `GET /summary` |
| 筛选 | 名称编号、年度、评价类型、行业、报送状态 | `GET /page` 参数 |
| 列表列 | 编号、名称、年度、类型、行业、被评价单位、签发日期、报送状态 | `EvalReportLibraryCO` |
| 操作 | 查看、下载 | `GET /get`（`fileUrl` 下载） |
| 上传弹窗 | 文件+编号/名称/年度/类型/行业/单位/签发日/页数/是否报送/保密/备注 | `POST /add` |
| 报送 | 未报送→已报送 | `POST /submit` |
| 抽查整改 | （列表详情联动） | `/eval-report-spotcheck/**` |

## 2. 字段映射

| 原型 | 字段 |
|------|------|
| 所属行业 | `industry_code` / `industry_name` |
| 被评价单位 | `evaluated_unit_name` |
| 签发日期 | `issue_date` |
| 页数 | `page_count` |
| 保密属性 | `secret_level_code` / `secret_level_name` |
| 是否报送监管 | `submit_flag`（1是 2否） |
| 列表报送状态文案 | `displayStatusName`（计算：未报送/已报送/抽查中/整改中/已复核） |
| 抽查流转状态 | `report_status_code`（1~4，既有） |

## 3. 接口一览

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/safetyEval/institution/eval-report/summary` | 汇总 |
| GET | `/safetyEval/institution/eval-report/page` | 分页 |
| GET | `/safetyEval/institution/eval-report/get` | 详情 |
| POST | `/safetyEval/institution/eval-report/add` | 上传历史报告 |
| POST | `/safetyEval/institution/eval-report/submit` | 报送监管 |
| GET | `/safetyEval/institution/eval-report-spotcheck/list` | 抽查列表 |
| GET | `/safetyEval/institution/eval-report-spotcheck/get` | 抽查详情 |
| POST | `/safetyEval/institution/eval-report-spotcheck/rectify` | 整改反馈 |

## 4. 上线注意

1. 执行 `alter-eval-report-library-fields.sql`（存量库）。
2. 历史数据 `submit_flag` 默认 2；过程控制归档/监管补录写入时置 1。
3. 上传文件走统一 OSS/文件上传拿 URL，本接口只存元数据与 URL。