foodie-server/specs/034-stall-qualification/contracts/api.md

摊位审核接口（034）

数值状态：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,identityImageUrls,stallImageUrls,foodRegistrationNumber,foodRegistrationImageUrls}。不接收 storeId 或审核字段。附件数组内只允许本摊位私有附件引用。草稿允许不完整，提交必填四组资料。
• GET /stall/qualification/applications/{id}：仅本摊位可查看历史材料。
• GET /stall/qualification/market：仅有效 type=3 夜市主；返回己方摊位的 storeId/status/approved，不返回姓名、证件号、电话和附件。
• POST /stall/qualification/files：multipart file；返回私有引用 storeId/uuid.jpg 或 .png，不能当公开图片 URL 使用。
• GET /stall/qualification/files/{storeId}/{fileName}：只能查看本人摊位文件，返回图片二进制且 Cache-Control=no-store。

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

• GET /system/stallQualification：list 权限，显式 pageNum/pageSize/status/storeId；只返回申请摘要，不返回身份材料。
• 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 不匹配时返回冲突业务错误，前端提示重新加载，不自动重试覆盖他人资料。