# 摊位审核接口（034）

商家 App 前端字段、页面状态及调用顺序见 [App 前端对接说明](../app-frontend-adjustment.md)。

数值状态：0 草稿、1 待审核、2 通过、3 驳回；-1 仅表示未创建申请，不入库。

## 商家 PC：token 请求头，@Auth 校验

- `GET /stall/qualification`：只允许有效 type=4 账号；storeId 从账号反推。返回 `storeId/stallName/stallAddress/nightMarketId/version/currentApplication/approvedApplication/history`；history 只有 id/applicationVersion/status/submittedAt/reviewedAt/rejectReason。
- `POST /stall/qualification/draft`、`POST /stall/qualification/submit`：JSON `{version,responsibleName,contactPhone,identityNumber,email?,stallIntroduction?,bankAccountName,bankName,bankAccountNo,identityImageUrls,stallImageUrls,bankProofImageUrls,businessRegistrationImageUrls?,directorScreenshotImageUrls?,uboDeclarationImageUrls?,foodRegistrationNumber?,foodRegistrationImageUrls?}`。不接收 storeId 或审核字段。图片数组传商品上传返回的 `/profile/upload/...` 路径，兼容本摊位旧私有附件引用。公共路径必须是系统实际存在的 JPEG/PNG（最多5MB、2000万像素），拒绝外部 URL/路径穿越/伪图片。草稿允许不完整；提交时负责人、证件、摊位照片和银行四项必填。电子邮箱填写时校验格式。
- `GET /stall/qualification/applications/{id}`：仅本摊位可查看历史材料。
- `GET /stall/qualification/market`：仅有效 type=3 夜市主；返回己方摊位的 `storeId/status/approved`，不返回姓名、证件号、电话和附件。
- 新图片：复用商品 `POST /utils/Upload`，multipart 的 `file`；返回 `{code:200,data:"/profile/upload/YYYY/MM/DD/文件名.png"}`，后端会把文件名中 `/ \ : * ? " < > | ; # % ,` 及控制字符规范为 `_`。商家前端用商品同款 `el-upload` 直传并按 `VUE_APP_BASE_URL + data` 展示，平台直接用共享 `ImagePreview` 解析路径。无需额外调用审核文件接口，图片 GET 无需登录，用户已确认包括证件在内的链接公开访问。
- `POST /stall/qualification/files`：保留兼容，multipart file 返回旧私有引用 `storeId/uuid.jpg` 或 `.png`；新版 PC 不再调用。
- `GET /stall/qualification/files/{storeId}/{fileName}`：仅兼容历史私有附件，只能查看本人摊位文件，返回图片二进制且 Cache-Control=no-store。

## 平台 PC：现有 Authorization 登录机制和权限

- `GET /system/stallQualification`：list 权限，显式 pageNum/pageSize/status/storeId；仅列出待审核、已通过、已驳回（status=1/2/3），清空筛选也不返回草稿，显式请求 status=0 拒绝。只返回申请摘要，不返回身份材料。
- `GET /system/stallQualification/applications/{id}`：query 权限，完整已提交申请材料及审核信息；草稿不可由平台查看。
- `POST /system/stallQualification/applications/{id}/review`：review 权限，JSON `{version,approved,rejectReason}`，approved 必须明确，驳回原因最长500字且必填。审核通过时复核银行等必填材料；旧待审核申请缺银行资料须驳回补齐重提。操作人来自平台登录，待审核记录只可处理一次。
- `GET /system/stallQualification/files/{storeId}/{fileName}`：仅兼容历史私有附件，query 权限，图片二进制且 Cache-Control=no-store；新公共路径直接使用商品图片预览，不请求此接口。

写入/审核失败使用项目国际化业务错误；不记录包含材料的请求/响应业务日志。JSON/绑定参数错误仅返回通用本地化参数错误，不把原始证件值、附件引用或解析异常交给全局日志。材料 Mapper WARN、Druid 材料 SQL 参数在慢日志及监控缓存中脱敏。
分页列表默认10、最多100条。主表/申请 version 不匹配时返回冲突业务错误，前端提示重新加载，不自动重试覆盖他人资料。