feat(aihr): decouple batch upload from processing via async queue

批量上传治本:POST /doc/upload-async 只暂存+入队即秒回,后台 worker
(并发2)复用 saveDocument 链路逐条解析/归类/向量化;队列表
aihr_knowledge_upload_item 状态机 0/1/2/3,完成/失败 CAS 写入,同名
文件串行防撞 attach 唯一键,卡住30分钟清扫重置,失败暂存保留72h。
新增 GET /doc/upload-items 批次查询与 POST /doc/upload-items/{id}/retry
单文件重试。资料处理页批量导入改走异步:提交即返回,新增本批次
进度面板(排队/加工中/完成/失败+进度条+单条重试),轮询防过期回写。
同步接口保留给 SOP 页单文件即时预览。

backend/script/sql/aihr_knowledge_mysql8.sql

@@ -124,3 +124,22 @@ VALUES
 ON DUPLICATE KEY UPDATE
   `content` = VALUES(`content`),
   `update_time` = NOW();
+
+-- 知识库批量上传队列：上传秒回后由后台 worker 加工，支持单文件重试
+CREATE TABLE IF NOT EXISTS `aihr_knowledge_upload_item` (
+  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '主键',
+  `tenant_id` varchar(20) DEFAULT '000000' COMMENT '租户编号',
+  `batch_id` varchar(64) NOT NULL COMMENT '上传批次',
+  `file_name` varchar(255) NOT NULL COMMENT '文件名',
+  `category` varchar(100) DEFAULT '' COMMENT '目标分类',
+  `staging_path` varchar(500) NOT NULL COMMENT '暂存文件路径',
+  `status` tinyint NOT NULL DEFAULT 0 COMMENT '0待处理 1处理中 2完成 3失败',
+  `error` varchar(500) DEFAULT NULL COMMENT '失败原因',
+  `doc_id` varchar(80) DEFAULT NULL COMMENT '入库文档ID',
+  `fragment_count` int DEFAULT NULL COMMENT '片段数',
+  `create_time` datetime DEFAULT NULL COMMENT '创建时间',
+  `update_time` datetime DEFAULT NULL COMMENT '更新时间',
+  PRIMARY KEY (`id`),
+  KEY `idx_aihr_upload_item_batch` (`tenant_id`, `batch_id`, `id`),
+  KEY `idx_aihr_upload_item_status` (`tenant_id`, `status`, `update_time`)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_0900_ai_ci COMMENT='知识库批量上传队列';