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

51 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

# 机构端报告库 · 原型对照与缺口说明
> 原型模块:`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。