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

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

原型模块：mod-institution-report-library（institution.html）
OpenAPI（Apifox）：docs/openapi/机构端-安评报告库.openapi.yaml
库表增量：docs/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。