# P26 接口清单

版本：V1.2
说明：统一前缀 `/api/supplier`，JSON 交互；鉴权沿用平台账号体系，平台侧接口需稽核/品质角色。

## 1 入驻与档案

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| POST | /profile/submit | 提交入驻资料（基础信息 + 工艺范围） |
| GET | /profile/detail | 供应商档案详情（含资质、星级、标签） |
| POST | /cert/upload | 上传资质证书（文件先走存储，再登记地址） |
| POST | /profile/review | 平台初审通过/驳回（附不符合项） |

关键字段：`supplier_id`、`company_name`、`factory_address`、`supplier_level(L1/L2)`、`process_tags[]`、`certs[]`、`capacity`。

## 2 稽核任务

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| POST | /audit/create | 新建稽核任务（online/site/annual/special） |
| GET | /audit/list | 稽核任务列表（按供应商、状态、类型筛选） |
| GET | /audit/detail | 稽核报告与 NC 明细 |
| POST | /audit/nc/add | 新增 NC（等级 major/minor/observation） |
| POST | /audit/fix/submit | 供应商提交整改方案与证据 |
| POST | /audit/fix/review | 平台复查，关闭或退回 |

状态机：待启动 → 稽核中 → 待整改 → 复查中 → 关闭。

## 3 评级与年审

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| POST | /star/calc | 按权重重算星级，写入历史快照 |
| GET | /star/history | 评级历史（前后星级、原因、关联稽核） |
| POST | /star/weight | 修改权重（品质/交期/服务/资质） |
| GET | /audit/remind | 年审与证书到期预警列表 |
| POST | /audit/annual | 发起年审，结果写回等级与状态 |

## 4 黑名单

| 方法 | 路径 | 说明 |
| --- | --- | --- |
| POST | /blacklist/save | 拉黑或解除，必须填写原因与证据 |
| GET | /blacklist/list | 黑名单列表与历史操作 |

## 5 返回约定

- 统一 `{ code, message, data }`，`code=0` 表示成功。
- 名单类接口支持分页：`page`、`page_size`（默认 20，上限 100）。
- 敏感操作写入审计日志：操作人、时间、变更前后值、IP。
- 供应商侧接口只返回自身数据，越权一律拒绝，不返回空壳 200。