feat(storage): integrate Alibaba Cloud OSS for file persistence - Add OSSAdapter and LocalAdapter with StorageFactory pattern - Integrate PKB module with OSS upload - Rename difyDocumentId to storageKey - Create 4 OSS buckets and development specification

backend/src/modules/admin/routes/tenantRoutes.ts

@@ -88,3 +88,6 @@ export async function moduleRoutes(fastify: FastifyInstance) {
 
 
 
+
+
+

backend/src/modules/admin/types/tenant.types.ts

@@ -118,3 +118,6 @@ export interface PaginatedResponse<T> {
 
 
 
+
+
+

backend/src/modules/admin/types/user.types.ts

@@ -165,3 +165,6 @@ export const ROLE_DISPLAY_NAMES: Record<UserRole, string> = {
 
 
 
+
+
+

backend/src/modules/aia/controllers/agentController.ts

@@ -240,3 +240,6 @@ async function matchIntent(query: string): Promise<{
 
 
 
+
+
+

backend/src/modules/aia/controllers/attachmentController.ts

@@ -94,3 +94,6 @@ export async function uploadAttachment(
 
 
 
+
+
+

backend/src/modules/aia/index.ts

@@ -23,3 +23,6 @@ export { aiaRoutes };
 
 
 
+
+
+

backend/src/modules/asl/fulltext-screening/__tests__/api-integration-test.ts

@@ -363,6 +363,9 @@ runTests().catch((error) => {
 
 
 
+
+
+
 
 
 

backend/src/modules/asl/fulltext-screening/__tests__/e2e-real-test-v2.ts

@@ -304,6 +304,9 @@ runTest()
 
 
 
+
+
+
 
 
 

backend/src/modules/asl/fulltext-screening/__tests__/fulltext-screening-api.http

@@ -342,6 +342,9 @@ Content-Type: application/json
 
 
 
+
+
+
 
 
 

backend/src/modules/dc/tool-b/services/ConflictDetectionService.ts

@@ -278,6 +278,9 @@ export const conflictDetectionService = new ConflictDetectionService();
 
 
 
+
+
+
 
 
 

backend/src/modules/dc/tool-c/README.md

@@ -228,6 +228,9 @@ curl -X POST http://localhost:3000/api/v1/dc/tool-c/test/execute \
 
 
 
+
+
+
 
 
 

backend/src/modules/dc/tool-c/controllers/StreamAIController.ts

@@ -282,6 +282,9 @@ export const streamAIController = new StreamAIController();
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/agents/SessionMemory.ts

@@ -191,6 +191,9 @@ logger.info('[SessionMemory] 会话记忆管理器已启动', {
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/check-iit-table-structure.ts

@@ -125,6 +125,9 @@ checkTableStructure();
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/check-project-config.ts

@@ -112,6 +112,9 @@ checkProjectConfig().catch(console.error);
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/check-test-project-in-db.ts

@@ -94,6 +94,9 @@ main();
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/docs/微信服务号接入指南.md

@@ -551,6 +551,9 @@ URL: https://iit.xunzhengyixue.com/api/v1/iit/patient-wechat/callback
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/generate-wechat-tokens.ts

@@ -186,6 +186,9 @@ console.log('');
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/services/PatientWechatService.ts

@@ -503,6 +503,9 @@ export const patientWechatService = new PatientWechatService();
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/test-chatservice-dify.ts

@@ -148,6 +148,9 @@ testDifyIntegration().catch(error => {
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/test-iit-database.ts

@@ -177,6 +177,9 @@ testIitDatabase()
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/test-patient-wechat-config.ts

@@ -163,6 +163,9 @@ if (hasError) {
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/test-patient-wechat-url-verify.ts

@@ -189,6 +189,9 @@ async function testUrlVerification() {
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/test-redcap-query-from-db.ts

@@ -270,6 +270,9 @@ main().catch((error) => {
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/test-wechat-mp-local.ps1

@@ -154,6 +154,9 @@ Write-Host ""
 
 
 
+
+
+
 
 
 

backend/src/modules/iit-manager/types/index.ts

@@ -247,6 +247,9 @@ export interface CachedProtocolRules {
 
 
 
+
+
+
 
 
 

backend/src/modules/pkb/controllers/documentController.ts

@@ -1,5 +1,8 @@
 import type { FastifyRequest, FastifyReply } from 'fastify';
 import * as documentService from '../services/documentService.js';
+import { storage } from '../../../common/storage/index.js';
+import { randomUUID } from 'crypto';
+import path from 'path';
 
 /**
  * 获取用户ID（从JWT Token中获取）
@@ -12,6 +15,30 @@ function getUserId(request: FastifyRequest): string {
   return userId;
 }
 
+/**
+ * 获取租户ID（从JWT Token中获取）
+ */
+function getTenantId(request: FastifyRequest): string {
+  const tenantId = (request as any).user?.tenantId;
+  // 如果没有租户ID，使用默认值
+  return tenantId || 'default';
+}
+
+/**
+ * 生成 PKB 文档存储 Key
+ * 格式：tenants/{tenantId}/users/{userId}/pkb/{kbId}/{uuid}.{ext}
+ */
+function generatePkbStorageKey(
+  tenantId: string,
+  userId: string,
+  kbId: string,
+  filename: string
+): string {
+  const uuid = randomUUID().replace(/-/g, '').substring(0, 16);
+  const ext = path.extname(filename).toLowerCase();
+  return `tenants/${tenantId}/users/${userId}/pkb/${kbId}/${uuid}${ext}`;
+}
+
 /**
  * 上传文档
  */
@@ -45,15 +72,15 @@ export async function uploadDocument(
     const fileType = data.mimetype;
     const fileSizeBytes = file.length;
 
-    // 文件大小限制（10MB）
-    const maxSize = 10 * 1024 * 1024;
-    console.log(`📊 文件大小: ${(fileSizeBytes / 1024 / 1024).toFixed(2)}MB (限制: 10MB)`);
+    // 文件大小限制（30MB - 按 OSS 规范）
+    const maxSize = 30 * 1024 * 1024;
+    console.log(`📊 文件大小: ${(fileSizeBytes / 1024 / 1024).toFixed(2)}MB (限制: 30MB)`);
     
     if (fileSizeBytes > maxSize) {
       console.error(`❌ 文件太大: ${(fileSizeBytes / 1024 / 1024).toFixed(2)}MB`);
       return reply.status(400).send({
         success: false,
-        message: 'File size exceeds 10MB limit',
+        message: 'File size exceeds 30MB limit',
       });
     }
 
@@ -75,9 +102,30 @@ export async function uploadDocument(
       });
     }
 
-    // 上传文档（这里fileUrl暂时为空，实际应该上传到对象存储）
-    console.log(`⚙️ 调用文档服务上传文件...`);
+    // 获取用户信息
     const userId = getUserId(request);
+    const tenantId = getTenantId(request);
+
+    // 生成 OSS 存储 Key（包含 kbId）
+    const storageKey = generatePkbStorageKey(tenantId, userId, kbId, filename);
+    console.log(`📦 OSS 存储路径: ${storageKey}`);
+
+    // 上传到 OSS
+    console.log(`☁️ 上传文件到存储服务...`);
+    let fileUrl = '';
+    try {
+      fileUrl = await storage.upload(storageKey, file);
+      console.log(`✅ 文件已上传到存储服务`);
+    } catch (storageError) {
+      console.error(`❌ 存储服务上传失败:`, storageError);
+      return reply.status(500).send({
+        success: false,
+        message: 'Failed to upload file to storage',
+      });
+    }
+
+    // 调用文档服务处理（传入 storageKey）
+    console.log(`⚙️ 调用文档服务处理文件...`);
     const document = await documentService.uploadDocument(
       userId,
       kbId,
@@ -85,7 +133,8 @@ export async function uploadDocument(
       filename,
       fileType,
       fileSizeBytes,
-      '' // fileUrl - 可以上传到OSS后填入
+      fileUrl,
+      storageKey  // 新增：存储路径
     );
 
     console.log(`✅ 文档上传成功: ${document.id}`);

backend/src/modules/pkb/routes/health.ts

@@ -60,6 +60,9 @@ export default async function healthRoutes(fastify: FastifyInstance) {
 
 
 
+
+
+
 
 
 

backend/src/modules/pkb/services/documentService.ts

@@ -2,6 +2,7 @@ import { prisma } from '../../../config/database.js';
 import { logger } from '../../../common/logging/index.js';
 import { extractionClient } from '../../../common/document/ExtractionClient.js';
 import { ingestDocument as ragIngestDocument } from './ragService.js';
+import { storage } from '../../../common/storage/index.js';
 
 /**
  * 文档服务
@@ -11,6 +12,15 @@ import { ingestDocument as ragIngestDocument } from './ragService.js';
 
 /**
  * 上传文档到知识库
+ * 
+ * @param userId - 用户ID
+ * @param kbId - 知识库ID
+ * @param file - 文件内容 Buffer
+ * @param filename - 原始文件名
+ * @param fileType - MIME 类型
+ * @param fileSizeBytes - 文件大小（字节）
+ * @param fileUrl - 文件访问 URL（签名URL）
+ * @param storageKey - OSS 存储路径（新增）
  */
 export async function uploadDocument(
   userId: string,
@@ -19,7 +29,8 @@ export async function uploadDocument(
   filename: string,
   fileType: string,
   fileSizeBytes: number,
-  fileUrl: string
+  fileUrl: string,
+  storageKey?: string  // 新增：OSS 存储路径
 ) {
   // 1. 验证知识库权限
   const knowledgeBase = await prisma.knowledgeBase.findFirst({
@@ -65,7 +76,7 @@ export async function uploadDocument(
       fileType,
       fileSizeBytes,
       fileUrl,
-      difyDocumentId: '', // 不再使用
+      storageKey: storageKey || '',  // OSS 存储路径
       status: 'uploading',
       progress: 0,
     },
@@ -107,10 +118,10 @@ export async function uploadDocument(
     });
 
     // 7. 更新文档记录 - pgvector 模式立即完成
+    // 注意：storageKey 已在创建时设置，这里不需要更新
     const updatedDocument = await prisma.document.update({
       where: { id: document.id },
       data: {
-        difyDocumentId: ingestResult.documentId || '',
         status: 'completed',
         progress: 100,
         // 提取信息
@@ -234,13 +245,23 @@ export async function deleteDocument(userId: string, documentId: string) {
 
   logger.info(`[PKB] 删除文档: documentId=${documentId}`);
 
+  // 1.5 删除 OSS 文件
+  if (document.storageKey) {
+    try {
+      await storage.delete(document.storageKey);
+      logger.info(`[PKB] OSS 文件已删除: ${document.storageKey}`);
+    } catch (storageError) {
+      logger.warn(`[PKB] OSS 文件删除失败，继续删除数据库记录`, { storageError });
+    }
+  }
+
   // 2. 删除 EKB 中的文档和 Chunks
   try {
     // 查找 EKB 文档（通过 filename 和 kbId 匹配）
     const ekbDoc = await prisma.ekbDocument.findFirst({
       where: {
         filename: document.filename,
-        kb: {
+        knowledgeBase: {
           ownerId: userId,
           name: document.knowledgeBase.name,
         },
@@ -311,7 +332,7 @@ export async function reprocessDocument(userId: string, documentId: string) {
     const ekbDoc = await prisma.ekbDocument.findFirst({
       where: {
         filename: document.filename,
-        kb: {
+        knowledgeBase: {
           ownerId: userId,
           name: document.knowledgeBase.name,
         },

backend/src/modules/rvw/__tests__/api.http

@@ -140,5 +140,8 @@ Content-Type: application/json
 
 
 
+
+
+
 
 

backend/src/modules/rvw/__tests__/test-api.ps1

@@ -125,5 +125,8 @@ Write-Host "  - 删除任务: DELETE $BaseUrl/api/v1/rvw/tasks/{taskId}" -Foregr
 
 
 
+
+
+
 
 

backend/src/modules/rvw/index.ts

@@ -39,5 +39,8 @@ export * from './services/utils.js';
 
 
 
+
+
+
 
 

backend/src/modules/rvw/services/utils.ts

@@ -130,5 +130,8 @@ export function validateAgentSelection(agents: string[]): void {
 
 
 
+
+
+