safety-eval-service/docs/gbs/机构端报告库-原型对照.md

51 lines
2.5 KiB
Markdown
Raw Normal View History

2026-07-28 09:09:27 +08:00
# 机构端报告库 · 原型对照与缺口说明
> 原型模块:`mod-institution-report-library``institution.html`
> OpenAPIApifox[`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。