safety-eval-service/docs/gbs/监管端报告数据库-原型对照.md

45 lines
2.1 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.

# 监管端安评报告数据库 · 原型对照
> 原型:`regulator.html` → `mod-report-library`
> OpenAPI[`docs/openapi/监管端-安评报告数据库.openapi.yaml`](../openapi/监管端-安评报告数据库.openapi.yaml)
> 机构端对照:[`docs/openapi/机构端-安评报告库.openapi.yaml`](../openapi/机构端-安评报告库.openapi.yaml)
## 1. 原型能力
| 区域 | 内容 | 后端策略 |
|------|------|----------|
| 说明 | 接收机构正式报告AI 辅助研判 | AI **不做后端** |
| 汇总 | 近三年 / 本年度 | `GET /summary` |
| 筛选 | 名称编号、报送机构、年度、类型、行业、报送时间起止 | `GET /page` |
| 列表 | 编号、名称、机构、类型、行业、签发日、报送时间 | CO 含 `orgName` 等 |
| 操作 | 查看报告、AI分析 | 查看=`/get`AI=前端静态 |
| 工具栏 | 批量下载、导出目录 | `POST /batch-download`ZIP、`POST /export-catalog`CSV |
| 补录 | (业务闭环需要) | `POST /add`,字段对齐机构端 |
| 抽查闭环 | 本页列表无直出按钮,但与机构整改对应 | `/eval-report-spotcheck/**` |
## 2. 与机构端对应关系
```text
机构上传/归档/报送(submit_flag=1)
监管报告数据库可见(默认仅已报送)
监管发起抽查 → 机构整改 → 监管复核
```
| 机构端 | 监管端 |
|--------|--------|
| `POST .../eval-report/add`(可仅存库) | 库中默认不可见直至报送 |
| `POST .../eval-report/submit` | 进入监管库 |
| 过程控制 archive | `submit_flag=1` 进入监管库 |
| `POST .../spotcheck/rectify` | `POST .../spotcheck/start` + `review` |
## 3. 本次相对原 P4 的补齐
- 汇总接口、关键词/机构名/行业/报送时间筛选
- 列表回填 `orgName`
- 补录字段与机构端上传对齐(行业、被评价单位、签发日、页数、保密等)
- **批量下载**:按勾选 ID 打包 ZIP最多 50 份,拉取各报告 `fileUrl`
- **导出目录**CSVExcel 可开);勾选优先,否则按当前筛选/全部已报送(最多 5000 行)
- 独立 Apifox OpenAPI含抽查闭环与上述导出下载