feat(phase-3,4): 证据件服务端落点与两前端大档分片接线

- 后端新增 evidence 模块(V182 证据表/独立桶/超管读取面/内部登记)与
  application.yml evidence 块;管理员四端点逐个 requireSuperAdmin。
- 分片通道补 @Scheduled 回收与 LocalTempCleanupService 的 chunk-uploads 覆盖;
  版本/教程 confirm 接受 file_key,把拼装件搬进 client 桶后落库。
- 用户端 9MB 视频改走 uploadTempFileToJava 分片;后管版本/教程 >8MB 走分片,
  小文件仍走原 presign 直传。
- 激活 Phase 3/4 后端与两前端预置契约。
This commit is contained in:
2026-10-31 03:45:50 +08:00
parent 5c283a79fc
commit 6fe5c8c8d0
30 changed files with 1016 additions and 54 deletions
@@ -36,6 +36,11 @@ AIIMAGE_DIGITAL_HUMAN_OSS_BUCKET=nanri-ai-digital-human
AIIMAGE_OSS_ACCESS_KEY_ID=change-me
AIIMAGE_OSS_ACCESS_KEY_SECRET=change-me
# 任务异常现场证据件(v1.2 Phase 3):独立桶与保留期必须显式配置;桶不得复用 nanri-ai-images。
AIIMAGE_EVIDENCE_OSS_BUCKET=task-evidence
AIIMAGE_EVIDENCE_RETENTION_DAYS=7
AIIMAGE_EVIDENCE_KEY_PREFIX=task-evidence/
# 工作台客户端包直传预签名有效期(秒);90MB 级包在慢公网入口需要更长窗口。
AIIMAGE_WORKBENCH_CLIENT_PRESIGN_EXPIRY_SECONDS=3600
@@ -153,8 +153,9 @@ aiimage:
digital-human-bucket: ${AIIMAGE_DIGITAL_HUMAN_OSS_BUCKET:nanri-ai-digital-human}
template-bucket: ${AIIMAGE_TEMPLATE_OSS_BUCKET:aiimage-templates}
software-version-bucket: ${AIIMAGE_OSS_SOFTWARE_VERSION_BUCKET:client}
# 店铺数据采集累计档独立桶:默认桶 nanri-ai-images 带 30 天全桶过期规则,
# 而店铺数据记录约定「无更新则一直保留、只准人工删」,故单独成桶且不设过期规则。
# 店铺数据采集累计档独立桶:默认桶 nanri-ai-images 带 7 天整桶过期规则(铁律 17,
# 2026-10-26 产品确认),而店铺数据记录约定「无更新则一直保留、只准人工删」,
# 故单独成桶且不设过期规则。
shop-data-bucket: ${AIIMAGE_OSS_SHOP_DATA_BUCKET:shufu-shop-data}
access-key-id: ${AIIMAGE_OSS_ACCESS_KEY_ID:}
access-key-secret: ${AIIMAGE_OSS_ACCESS_KEY_SECRET:}
@@ -167,6 +168,15 @@ aiimage:
access-key-id: ${AIIMAGE_DEVICE_LOG_OSS_ACCESS_KEY_ID:}
access-key-secret: ${AIIMAGE_DEVICE_LOG_OSS_ACCESS_KEY_SECRET:}
retention-days: ${AIIMAGE_DEVICE_LOG_RETENTION_DAYS:7}
# 任务异常现场证据件(v1.2 Phase 3/AC-7/AC-13):独立桶 + 独立保留期。
# 桶必须与业务桶 nanri-ai-images 隔离(那边是 7 天整桶 ILM,证据保留策略不得被它绑死);
# key-prefix 之后实际 key = <prefix><taskId>/<UUID><扩展名>(铁律 10:key 必带 UUID)。
evidence:
bucket: ${AIIMAGE_EVIDENCE_OSS_BUCKET:task-evidence}
retention-days: ${AIIMAGE_EVIDENCE_RETENTION_DAYS:7}
key-prefix: ${AIIMAGE_EVIDENCE_KEY_PREFIX:task-evidence/}
max-file-bytes: ${AIIMAGE_EVIDENCE_MAX_FILE_BYTES:67108864}
retention-cron: ${AIIMAGE_EVIDENCE_RETENTION_CRON:0 30 3 * * *}
transient-storage:
enabled: ${AIIMAGE_TRANSIENT_STORAGE_ENABLED:true}
endpoint: ${AIIMAGE_TRANSIENT_STORAGE_ENDPOINT:http://121.196.149.225:9000}
@@ -224,6 +234,8 @@ aiimage:
max-parts: ${AIIMAGE_FILE_CHUNK_UPLOAD_MAX_PARTS:4096}
# 未完成会话与残留片的驻留小时数:超时由清理动作回收,避免断掉的上传永久占盘
stale-hours: ${AIIMAGE_FILE_CHUNK_UPLOAD_STALE_HOURS:24}
# 周期回收 cron(AC-10):断掉的上传不会再 init,不能只靠 init 时顺手清
cleanup-cron: ${AIIMAGE_FILE_CHUNK_UPLOAD_CLEANUP_CRON:0 15 * * * *}
temp-dir:
retention-hours: ${AIIMAGE_TEMP_DIR_RETENTION_HOURS:24}
capacity-plan:
@@ -0,0 +1,29 @@
-- V182: 任务异常现场证据件(AC-7/AC-13,v1.2 Phase 3)
--
-- 背景:客户端在任务异常时会把现场件(JSON 快照+窗口/页面截图)上传到独立证据桶;
-- 本表只登记「哪份证据属于哪个任务」,对象本体留在对象存储,按 retention-days 单独回收。
--
-- 设计口径(蓝图 §3.3):
-- * 按 task_id 关联但**不建外键**(全库唯一 FK 是 V80 的 columns.parent_id);
-- * 与 device_log_file(无 task_id/content_type)和 biz_file_result(业务交付物语义)分表,
-- 避免把文本日志通道或业务交付物的保留策略绑死;
-- * object_key 带 UUID(铁律 10),库内只存 key,不存任何直链/预签名 URL(AC-13)。
--
-- 回滚(手工):
-- DROP TABLE `biz_task_evidence`;
CREATE TABLE IF NOT EXISTS `biz_task_evidence` (
`id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '主键',
`task_id` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '业务任务号(客户端字符串口径)',
`uid` BIGINT NULL COMMENT '任务归属用户(未知时为空)',
`evidence_type` VARCHAR(32) NOT NULL DEFAULT 'client' COMMENT '证据类型:client/crash/brand 等',
`source` VARCHAR(64) NOT NULL DEFAULT '' COMMENT '来源入口(崩溃记录器/商品采集等)',
`object_key` VARCHAR(512) NOT NULL COMMENT '证据桶内对象 key(含 UUID)',
`byte_size` BIGINT NOT NULL DEFAULT 0 COMMENT '对象字节数',
`content_type` VARCHAR(128) NOT NULL DEFAULT 'application/octet-stream' COMMENT '对象媒体类型',
`sha256` CHAR(64) NOT NULL DEFAULT '' COMMENT '对象 sha256(防篡改/去重)',
`created_at` DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '登记时间',
PRIMARY KEY (`id`),
KEY idx_task_evidence_task_id (task_id, created_at),
KEY idx_task_evidence_uid (uid)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='任务异常现场证据件登记';