# 监督检查告知 / 通知 — 原型对照

## 模块映射

| 端 | 原型 | 后端 |
|----|------|------|
| 监管 | `mod-inspection-notice` 监督检查告知 | `/safetyEval/regulator/insp-notice/**` |
| 机构 | 消息入口 `mod-reg-message`（`pageCode=reg-message`，`bizType=insp_notice`）+ 告知办理 | `/safetyEval/institution/insp-notice/**` |

说明：机构端原型页「监督检查通知」是**监管消息中心**，除监督检查告知外，还包含风险预警产生的整改通知、核查函、补正通知等。后者属风险预警域，**不在本 insp_notice 接口范围内**。本接口仅覆盖 `insp_notice` 业务闭环。

## 监管端字段与能力

| 原型 | 后端 |
|------|------|
| 筛选：告知编号、评价机构、检查类型、来源方式、来源预警编号、检查负责人、检查时间起止、机构确认、材料反馈、办理状态 | `GET /page` 对应 query |
| 列表：编号/机构/类型/计划时间/来源/负责人/确认/反馈/状态 | `RegulatorInspNoticeCO`（含 `orgName`、`sourceRefNo`、`feedbackFlag`） |
| 新建 / 编辑待下发 | `POST /save`（status=0） |
| 下发 | `POST /issue`（新建直发，或传 `id` 下发草稿） |
| 查看 / 保存备注 | `GET /get`、`POST /remark` |
| 登记结果 | `POST /close` |
| 提醒 | `POST /urge` |
| 下载记录 | `GET /download-record`（CSV） |
| 导出台账 | `POST /export-ledger`（CSV） |
| 材料只读 | `GET /materials` |

### 状态

| 原型 | statusCode | statusName |
|------|------------|------------|
| 待下发 | 0 | 待下发 |
| 已下发 | 1 | 已下发 |
| （机构已确认，列表可仍归「已下发」类展示） | 2 | 已确认 |
| 已反馈 | 3 | 已反馈 |
| 已完成 | 4 | 已办结 |

### 来源方式

| 原型 | sourceTypeCode |
|------|----------------|
| 年度计划 | 1 |
| 专项安排 | 2 |
| 其他 | 3 |
| 风险预警 | 4 |

## 机构端（insp_notice）能力

| 能力 | 接口 |
|------|------|
| 本机构告知分页（不含草稿） | `GET /page` |
| 详情（含结果、监管备注） | `GET /get` |
| 确认 | `POST /confirm` |
| 上传材料 URL | `POST /material/upload` |
| 提交材料反馈 | `POST /feedback` |
| 材料列表 | `GET /materials` |

消息推送：下发/催办 → 机构消息（`pageCode=reg-message`）；反馈 → 监管消息（`pageCode=inspection-notice`）。详见 `plans/phase2-prototype-api/baseline/p3-insp-rules.md`。

## 库表增量

执行 `docs/db/alter-insp-notice-prototype-fields.sql`（`source_ref_no`、`notice_urls`）。