企业认证与附件简历功能开发

企业认证与附件简历功能开发

企业认证接口:事务 + 多文件上传
企业认证是今天新增的完整功能,它最能体现"真实业务"的复杂度:要同时写 3 张表、传 3 个文件(营业执照 + 法人身份证正反面)

接口:接收表单 + 三个文件:

这是一个 FastAPI POST 接口,功能:保存企业信息,同时接收表单参数 + 多文件上传

UploadFile 不传时变量是 None;
如果前端传了空文件(无文件名),file.filename=“”,校验可以拦截,


依赖层:


FastAPI 语法:… 代表必填参数,请求不传该字段直接返回 422 校验错误;
default=None 代表可选参数,前端不传时值为None。
Form 是 FastAPI 提供的表单数据接收工具。
区分两个极易混淆的:
Form() → 接收普通文本表单字段(字符串、数字等)
File() → 接收上传文件(UploadFile)

静态异步方法,用于更新求职者简历附件,支持 3 类操作:
仅修改简历名称
仅切换「是否默认简历」状态
同时更换简历文件 + 修改名称 + 设置默认
业务规则:同一求职者最多只能有 1 份默认简历。

文件上传操作放在数据库更新之前:
OSS 上传失败直接抛出异常,数据库不会执行更新,避免出现「文件没上传成功,但数据库数据改动」的数据不一致。
例如: