@spacecorexdev/core 0.0.2 → 0.0.5

package/src/ui/FileManager/types.ts

@@ -0,0 +1,184 @@
+/** 文件列表排序字段。 */
+export type FileSortBy = 'fileName' | 'fileType' | 'fileSize' | 'uploadTime';
+
+/** 项目文件或文件夹节点。 */
+export interface ProjectFile {
+  /** 文件唯一标识。 */
+  id: string;
+  /** 是否为受保护文件。 */
+  isSecure: boolean;
+  /** 所属项目 ID。 */
+  projectId: string;
+  /** 子文件或子文件夹列表。 */
+  children?: ProjectFile[];
+  /** 父级文件夹 ID，根节点为空。 */
+  parentId?: string | null;
+  /** 文件名称。 */
+  fileName: string;
+  /** 文件展示或业务路径。 */
+  filePath: string;
+  /** 文件类型或扩展名。 */
+  fileType: string;
+  /** 文件大小，单位通常为字节。 */
+  fileSize: number;
+  /** 文件CRC32校验值。 */
+  crc32: number;
+  /** 是否有本地缓存。 */
+  hasLocalCache?: boolean;
+  /** 文件资源实际存储路径。 */
+  fileResourcePath: string;
+  /** 文件或文件夹备注。 */
+  descs?: string;
+  /** 上传人名称。 */
+  uploaderName: string;
+  /** 上传时间。 */
+  uploadTime: Date;
+  /** 创建时间。 */
+  createTime: Date;
+  /** 更新时间。 */
+  updateTime: Date;
+  /** 创建人 ID。 */
+  createBy: string;
+  /** 更新人 ID。 */
+  updateBy: string;
+  /** 层级，根节点为 0。 */
+  level?: number;
+  /** 本地文件唯一 ID：仅本地文件（从未上传）或服务器文件未同步修改时存在 */
+  localId?: string;
+  /** 是否为仅本地存在（从未上传到服务器） */
+  isLocalOnly?: boolean;
+  /** 是否有未同步的本地修改 */
+  hasUnsyncedChanges?: boolean;
+  /** 是否为合同附件链接文件（虚拟文件，仅支持查看和下载） */
+  isContractLink?: boolean;
+  /** 是否为虚拟合同文件夹（绿色置顶，显示名"合同"，服务器名 __contracts__） */
+  isVirtualContractFolder?: boolean;
+  /** 是否为合同子文件夹（以合同名称命名的虚拟文件夹，不可重命名/删除/移动） */
+  isContractSubfolder?: boolean;
+  /** 关联合同是否已签约（仅合同相关虚拟节点存在；false 表示未签约，显示时弱化） */
+  contractSigned?: boolean;
+  /** 合同分类标签（仅合同相关虚拟节点存在；"按类型"排序时用于分组） */
+  contractTag?: string;
+  /** 是否为合同分类标签虚拟文件夹（"按类型"排序时生成，位于合同文件夹一级） */
+  isContractTagFolder?: boolean;
+}
+/** 项目成员角色（统一由 core 的 types/projectRole 提供，避免重复定义）。 */
+export { ProjectRole } from '../../types/projectRole';
+
+/** 文件接口通用响应形状。 */
+export interface FileManagerApiResponse<T = undefined> {
+  code: number;
+  message?: string;
+  data?: T;
+}
+
+/** 新建文件/文件夹提交的数据。 */
+export interface FileManagerAddFileInput {
+  fileName: string;
+  filePath: string;
+  isSecure?: boolean;
+  descs?: string;
+  fileType?: string;
+  fileSize?: number;
+  crc32?: number;
+  fileResourcePath: string;
+}
+
+/** 移动/重命名提交的数据。 */
+export interface FileManagerMoveFileInput {
+  oldFileName: string;
+  oldFilePath: string;
+  newFileName: string;
+  newFilePath: string;
+}
+
+/** 文件夹打包下载任务状态。 */
+export type FolderDownloadStatus = 'pending' | 'success' | 'failed';
+
+/** 文件夹打包下载任务状态详情。 */
+export interface FolderDownloadJobStatus {
+  jobId: string;
+  status: FolderDownloadStatus;
+  /** 打包成功后的下载地址（相对文件根路径） */
+  url?: string;
+  /** 下载文件名 */
+  fileName?: string;
+  /** 失败原因或提示 */
+  message?: string;
+  /** 下载地址过期时间戳（毫秒） */
+  expireAt?: number;
+}
+
+/** 全量更新文件内容提交的数据。 */
+export interface FileManagerUpdateDataInput {
+  fileId: string;
+  fileSize?: number;
+  crc32?: number;
+  fileName: string;
+  fileResourcePath: string;
+  /** 是否记录历史版本，默认 true；笔记等高频保存场景可传 false */
+  recordVersion?: boolean;
+}
+
+/** 差分更新文件内容提交的数据。 */
+export interface FileManagerUpdateDeltaInput {
+  fileId: string;
+  deltaData: string;
+  deltaSize: number;
+  newFileSize: number;
+  crc32?: number;
+  /** 是否记录历史版本，默认 true；笔记等高频保存场景可传 false */
+  recordVersion?: boolean;
+}
+
+/**
+ * 文件管理器数据接口适配器。
+ * 默认实现为项目文件 API（见 projectFileManagerApi）；
+ * CRM 客户附件等场景注入自定义实现以复用同一套文件管理 UI。
+ */
+export interface FileManagerApi {
+  /** 获取文件列表，scopeId 为项目 ID 或客户 ID 等业务作用域 */
+  listFiles: (scopeId: string) => Promise<FileManagerApiResponse<ProjectFile[]>>;
+  /** 获取文件详情 */
+  getDetail: (fileId: string) => Promise<FileManagerApiResponse<ProjectFile>>;
+  /** 新建文件/文件夹 */
+  addFile: (scopeId: string, data: FileManagerAddFileInput) => Promise<FileManagerApiResponse<{ fileId: string; fileName: string }>>;
+  /** 删除文件/文件夹 */
+  removeFile: (fileId: string) => Promise<FileManagerApiResponse<boolean>>;
+  /** 移动/重命名 */
+  moveFile: (scopeId: string, data: FileManagerMoveFileInput) => Promise<FileManagerApiResponse<string>>;
+  /** 更新备注 */
+  updateFileDescs: (data: { fileId: string; descs?: string }) => Promise<FileManagerApiResponse<boolean>>;
+  /** 全量更新文件内容 */
+  updateFile: (data: FileManagerUpdateDataInput) => Promise<FileManagerApiResponse<string>>;
+  /** 差分更新文件内容；不提供时前端自动回退为全量上传 */
+  updateFileDelta?: (data: FileManagerUpdateDeltaInput) => Promise<FileManagerApiResponse<string>>;
+  /** 复制副本/复制到其他项目；不提供时隐藏相关入口 */
+  copyFileToProject?: (scopeId: string, fileId: string) => Promise<FileManagerApiResponse<string>>;
+  /** 生成临时访问令牌；不提供时隐藏「临时访问链接」入口 */
+  generateTempAccessToken?: (fileId: string, expireSeconds: number) => Promise<FileManagerApiResponse<string>>;
+  /** 发起文件夹异步打包下载（需管理权限）；不提供时隐藏「下载文件夹」入口 */
+  downloadFolder?: (
+    scopeId: string,
+    folderPath: string,
+    folderName: string,
+  ) => Promise<FileManagerApiResponse<{ jobId: string }>>;
+  /** 查询文件夹打包下载任务状态；与 downloadFolder 同时提供时才启用下载文件夹 */
+  getFolderDownloadStatus?: (jobId: string) => Promise<FileManagerApiResponse<FolderDownloadJobStatus>>;
+  /** 判定当前用户是否具备管理能力（控制加密文件夹等入口），缺省视为 false */
+  resolveIsManager?: (scopeId: string) => Promise<boolean>;
+}
+
+/** FileManager 功能开关：缺省全部开启（项目场景）；CRM 等场景按需关闭。 */
+export interface FileManagerFeatures {
+  /** 合同虚拟文件夹与合同附件联动，默认 true */
+  contracts?: boolean;
+  /** 移动/复制到其他项目（含复制副本），默认 true */
+  moveCopyToProject?: boolean;
+  /** 分享到微信，默认 true */
+  shareToWechat?: boolean;
+  /** 查看历史版本，默认 true */
+  versionHistory?: boolean;
+  /** 复制链接/在新窗口打开（指向 /filepreview 路由），默认 true */
+  externalLink?: boolean;
+}

package/src/ui/FileManager/utils/fileDeltaWorker.ts

@@ -0,0 +1,193 @@
+/**
+ * 文件差分计算 Web Worker
+ * 
+ * 功能：
+ * - 在 Worker 线程中执行 bsdiff 差分计算
+ * - 定期向主线程报告计算进度
+ * - 支持中止计算
+ * 
+ * 使用方式：
+ * const worker = new Worker(new URL('./fileDeltaWorker.ts', import.meta.url));
+ * worker.postMessage({ type: 'computeDelta', oldBuffer, newBuffer });
+ * worker.onmessage = (e) => { ... };
+ */
+
+import pako from 'pako';
+
+// ==================== WASM 模块加载 ====================
+let wasmInstance: WebAssembly.Instance | null = null;
+let wasmMemory: WebAssembly.Memory | null = null;
+
+interface BsdiffExports {
+  memory: WebAssembly.Memory;
+  alloc: (len: number) => number;
+  dealloc: (ptr: number, len: number) => void;
+  create_patch: (basePtr: number, baseLen: number, nextPtr: number, nextLen: number) => number;
+  output_ptr: () => number;
+  output_len: () => number;
+  free_output: () => void;
+}
+
+const loadWasm = async (): Promise<BsdiffExports> => {
+  if (wasmInstance) return wasmInstance.exports as unknown as BsdiffExports;
+  
+  // 从 public/wasm 目录加载 WASM 文件
+  const response = await fetch('/wasm/hdiff.wasm');
+  const wasmBuffer = await response.arrayBuffer();
+  const wasmModule = new WebAssembly.Module(wasmBuffer);
+  const instance = await WebAssembly.instantiate(wasmModule);
+  
+  wasmInstance = instance;
+  wasmMemory = instance.exports.memory as unknown as WebAssembly.Memory;
+  
+  return instance.exports as unknown as BsdiffExports;
+};
+
+// ==================== 差分计算 ====================
+/**
+ * 在 Worker 中创建补丁
+ */
+const createPatch = async (base: Uint8Array, next: Uint8Array): Promise<Uint8Array> => {
+  const wasm = await loadWasm();
+  
+  const basePtr = wasm.alloc(base.byteLength);
+  const nextPtr = wasm.alloc(next.byteLength);
+  
+  try {
+    new Uint8Array(wasm.memory.buffer, basePtr, base.byteLength).set(base);
+    new Uint8Array(wasm.memory.buffer, nextPtr, next.byteLength).set(next);
+    
+    const status = wasm.create_patch(basePtr, base.byteLength, nextPtr, next.byteLength);
+    
+    if (status !== 0) {
+      throw new Error(`BSDiff failed with status: ${status}`);
+    }
+    
+    const outPtr = wasm.output_ptr();
+    const outLen = wasm.output_len();
+    
+    if (outLen === 0) {
+      wasm.free_output();
+      return new Uint8Array();
+    }
+    
+    const output = new Uint8Array(wasm.memory.buffer, outPtr, outLen);
+    const copied = new Uint8Array(output);
+    wasm.free_output();
+    return copied;
+  } finally {
+    if (base.byteLength > 0) wasm.dealloc(basePtr, base.byteLength);
+    if (next.byteLength > 0) wasm.dealloc(nextPtr, next.byteLength);
+  }
+};
+
+/**
+ * 带进度的差分计算
+ * @param oldArray 旧文件数据
+ * @param newArray 新文件数据
+ * @param onProgress 进度回调
+ */
+const computeDeltaWithProgress = async (
+  oldArray: Uint8Array,
+  newArray: Uint8Array,
+  onProgress: (percent: number) => void
+): Promise<Uint8Array> => {
+  onProgress(0.1);
+  
+  // 加载 WASM（如果尚未加载）
+  await loadWasm();
+  
+  onProgress(0.2);
+  
+  // 执行差分计算
+  const patch = await createPatch(oldArray, newArray);
+  
+  onProgress(0.6);
+  
+  // 压缩
+  const compressed = pako.deflate(patch);
+  
+  onProgress(0.9);
+  
+  return new Uint8Array(compressed);
+};
+
+// ==================== Worker 消息处理 ====================
+let currentTask: { oldArray: Uint8Array; newArray: Uint8Array } | null = null;
+
+self.onmessage = async (e: MessageEvent) => {
+  const { type, id, data } = e.data;
+  
+  switch (type) {
+    case 'computeDelta':
+      try {
+        const { oldBuffer, newBuffer, taskId } = data;
+        
+        const oldArray = new Uint8Array(oldBuffer);
+        const newArray = new Uint8Array(newBuffer);
+        
+        currentTask = { oldArray, newArray };
+        
+        // 发送开始消息
+        self.postMessage({
+          type: 'progress',
+          id: taskId,
+          data: { stage: 'loading', percent: 0, message: '正在加载差分计算模块...' }
+        });
+        
+        const compressedPatch = await computeDeltaWithProgress(
+          oldArray,
+          newArray,
+          (percent) => {
+            self.postMessage({
+              type: 'progress',
+              id: taskId,
+              data: { 
+                stage: 'computing', 
+                percent, 
+                message: percent < 0.2 ? '加载中...' : 
+                        percent < 0.6 ? '计算文件差异...' : 
+                        percent < 0.9 ? '压缩差异数据...' : '即将完成...'
+              }
+            });
+          }
+        );
+        
+        currentTask = null;
+        
+        // 发送完成消息
+        self.postMessage({
+          type: 'success',
+          id: taskId,
+          data: {
+            compressedPatch: compressedPatch.buffer,
+            patchSize: compressedPatch.length
+          }
+        });
+        
+      } catch (error) {
+        currentTask = null;
+        self.postMessage({
+          type: 'error',
+          id: data.taskId,
+          error: error instanceof Error ? error.message : '未知错误'
+        });
+      }
+      break;
+      
+    case 'abort':
+      // 终止当前任务（如果需要）
+      currentTask = null;
+      self.postMessage({
+        type: 'aborted',
+        id: data.taskId
+      });
+      break;
+      
+    default:
+      console.warn('Unknown message type:', type);
+  }
+};
+
+// 通知主线程 Worker 已就绪
+self.postMessage({ type: 'ready' });

package/src/ui/FileManager/utils/fileTree.ts

@@ -0,0 +1,178 @@
+import { ProjectFile, FileSortBy } from '../types';
+
+const assignLevel = (items: ProjectFile[], level: number = 0): void => {
+  items.forEach((item) => {
+    (item as any).level = level;
+    if (item.children && item.children.length > 0) {
+      assignLevel(item.children, level + 1);
+    }
+  });
+};
+
+export const buildFileTree = (items: ProjectFile[]): ProjectFile[] => {
+  const map = new Map<string, ProjectFile>();
+  const roots: ProjectFile[] = [];
+
+  items.forEach((item) => {
+    const newItem = { ...item, children: [] };
+    map.set(item.id, newItem);
+  });
+
+  const pathMap = new Map<string, string>();
+  items.forEach((item) => {
+    if (item.fileType === 'folder') {
+      pathMap.set(item.filePath + item.fileName + '/', item.id);
+    }
+  });
+
+  items.forEach((item) => {
+    const newItem = map.get(item.id)!;
+    const parentPath = item.filePath;
+    const parentId = pathMap.get(parentPath) || null;
+
+    if (parentId) {
+      newItem.parentId = parentId;
+      const parent = map.get(parentId);
+      if (parent && parent.children) {
+        parent.children.push(newItem);
+      } else {
+        roots.push(newItem);
+      }
+    } else {
+      roots.push(newItem);
+    }
+  });
+
+  assignLevel(roots);
+  return roots;
+};
+
+export const getDescendantIds = (item: ProjectFile, files: ProjectFile[]): string[] => {
+  const ids: string[] = [];
+  const stack: ProjectFile[] = [item];
+
+  while (stack.length) {
+    const node = stack.pop()!;
+    const children = files.filter((child) => child.parentId === node.id);
+    for (const c of children) {
+      ids.push(c.id);
+      stack.push(c);
+    }
+  }
+
+  return ids;
+};
+
+export const getDescendantIdsOptimized = (item: ProjectFile, files: ProjectFile[]): string[] => {
+  const ids: string[] = [];
+  const parentIdMap = new Map<string, ProjectFile[]>();
+  
+  files.forEach((file) => {
+    if (file.parentId) {
+      const children = parentIdMap.get(file.parentId) || [];
+      children.push(file);
+      parentIdMap.set(file.parentId, children);
+    }
+  });
+
+  const stack: ProjectFile[] = [item];
+  while (stack.length) {
+    const node = stack.pop()!;
+    const children = parentIdMap.get(node.id) || [];
+    for (const c of children) {
+      ids.push(c.id);
+      stack.push(c);
+    }
+  }
+
+  return ids;
+};
+
+export const getFileDescendants = (folder: ProjectFile, files: ProjectFile[]): ProjectFile[] => {
+  let items: ProjectFile[] = [];
+  if (folder && folder.fileType === 'folder') {
+    const folderPath = folder.filePath + folder.fileName + '/';
+    items = files.filter((item) => 
+      item.id === folder.id || 
+      (item.filePath && item.filePath.startsWith(folderPath))
+    );
+  }
+  return items;
+};
+
+export const sortFiles = (files: ProjectFile[]): ProjectFile[] => {
+  return [...files].sort((a: ProjectFile, b: ProjectFile) => {
+    // 虚拟合同文件夹始终置顶
+    if (a.isVirtualContractFolder && !b.isVirtualContractFolder) return -1;
+    if (!a.isVirtualContractFolder && b.isVirtualContractFolder) return 1;
+
+    if (a.fileType === 'folder' && b.fileType !== 'folder') {
+      return -1;
+    }
+    if (a.fileType !== 'folder' && b.fileType === 'folder') {
+      return 1;
+    }
+    if (a.isSecure && !b.isSecure) {
+      return -1;
+    }
+    if (!a.isSecure && b.isSecure) {
+      return 1;
+    }
+    return a.fileName.localeCompare(b.fileName);
+  });
+};
+
+// 递归排序函数（支持按文件名、类型、大小、上传时间排序）
+export const sortTree = (
+  items: ProjectFile[],
+  by: FileSortBy,
+  order: 'asc' | 'desc'
+): ProjectFile[] => {
+  const sorted = [...items].sort((a, b) => {
+    // 虚拟合同文件夹始终置顶
+    if (a.isVirtualContractFolder && !b.isVirtualContractFolder) return -1;
+    if (!a.isVirtualContractFolder && b.isVirtualContractFolder) return 1;
+
+    // 文件夹始终排在文件前面
+    if (a.fileType === 'folder' && b.fileType !== 'folder') return -1;
+    if (a.fileType !== 'folder' && b.fileType === 'folder') return 1;
+
+    // 安全文件排前面
+    if (a.isSecure && !b.isSecure) return -1;
+    if (!a.isSecure && b.isSecure) return 1;
+
+    let comparison = 0;
+    if (by === 'fileName') {
+      comparison = a.fileName.localeCompare(b.fileName, 'zh-CN');
+    } else if (by === 'uploadTime') {
+      const timeA = a.uploadTime instanceof Date ? a.uploadTime.getTime() : new Date(a.uploadTime).getTime();
+      const timeB = b.uploadTime instanceof Date ? b.uploadTime.getTime() : new Date(b.uploadTime).getTime();
+      comparison = timeA - timeB;
+    } else if (by === 'fileSize') {
+      comparison = (a.fileSize || 0) - (b.fileSize || 0);
+      // 大小相同时再按文件名排序
+      if (comparison === 0) {
+        comparison = a.fileName.localeCompare(b.fileName, 'zh-CN');
+      }
+    } else {
+      // 按文件类型排序（通过文件名后缀判断）
+      const extA = a.fileType === 'folder' ? 'folder' : (a.fileName.split('.').pop() || '').toLowerCase();
+      const extB = b.fileType === 'folder' ? 'folder' : (b.fileName.split('.').pop() || '').toLowerCase();
+      comparison = extA.localeCompare(extB, 'zh-CN');
+      // 类型相同时再按文件名排序
+      if (comparison === 0) {
+        comparison = a.fileName.localeCompare(b.fileName, 'zh-CN');
+      }
+    }
+
+    return order === 'asc' ? comparison : -comparison;
+  });
+
+  // 递归排序子节点
+  return sorted.map(item => ({
+    ...item,
+    children: item.children && item.children.length > 0
+      ? sortTree(item.children, by, order)
+      : item.children
+  }));
+};