fix(aihr): clean up orphaned knowledge uploads

2026-07-14 21:43:27 +08:00
parent 30a473b365
commit 04b9b1bb96
4 changed files with 43 additions and 6 deletions
@@ -1,5 +1,6 @@
 # BRD 功能审查与未完成项记录

+- 2026-07-14 BRD G3 SOP 附件绑定补偿：同步/待处理图片文档此前在 `sys_oss` 上传成功后再写 `aihr_knowledge_attach`，附件写入失败时可能留下无业务引用对象；现仅对“附件尚未成功绑定”的异常路径做 OSS 补偿删除，解析失败后已存在的失败/待处理附件仍保留用于重试，不改变现有文档处理状态机。
 - 2026-07-14 BRD G3 OSS 生命周期补偿：候选资料和案例音频此前先写 `sys_oss`、再写业务记录，业务数据库写入失败时可能留下没有业务引用的对象；现对“本次上传新建且尚未绑定”的 `oss_id` 增加失败补偿删除，案例同时移除内存态，补充两条回归测试和 `demo-check` marker。该修复不触碰已有业务资源；SOP 分片/ASR 等复杂异步链路仍需按各自状态机单独核查，不能用本次补偿覆盖全部媒体生命周期。
 - 2026-07-14 BRD G3 文件名边界复核：候选资料、案例音频、同步 SOP 文档和 ASR 音频此前虽然分别校验或清理文件名，但仍有路径把原始 `MultipartFile` 直接交给 `sys_oss`，清理后的名字没有贯通到 OSS 元数据；现新增共用 `AihrMultipartFiles` 包装器，四条链路均以清理后的文件名上传/外发，并补单测与 `demo-check` marker。该修复不改变文件类型、大小、权限和业务状态，仍需正式环境抽查 OSS 原始文件名与下载响应头。