存储模块

public interface StorageService {
    
    /**
     * 上传文件
     * @param file 上传的文件
     * @param prefix 文件前缀
     * @return 存储结果
     */
    StorageResult upload(MultipartFile file, String prefix);
    
    /**
     * 下载文件
     * @param fileId 文件ID
     * @param response 响应对象
     */
    void download(String fileId, HttpServletResponse response);
    
    /**
     * 预览文件
     * @param fileId 文件ID
     * @param response 响应对象
     */
    void preview(String fileId, HttpServletResponse response);
    
    /**
     * 删除文件
     * @param fileId 文件ID
     */
    void delete(String fileId);
    
    /**
     * 获取文件信息
     * @param fileId 文件ID
     * @return 文件信息
     */
    FileInfo getFileInfo(String fileId);
}

@Service
@ConditionalOnProperty(name = "storage.type", havingValue = "local")
public class LocalStorageServiceImpl implements StorageService {
    
    @Value("${storage.local.base-path}")
    private String basePath;
    
    @Value("${storage.local.domain}")
    private String domain;
    
    @Override
    public StorageResult upload(MultipartFile file, String prefix) {
        // 本地存储上传实现
        // 1. 生成唯一文件名
        // 2. 创建存储目录
        // 3. 保存文件到本地磁盘
        // 4. 记录文件信息
        // 5. 返回存储结果
    }
    
    // 其他方法实现...
}

@Service
@ConditionalOnProperty(name = "storage.type", havingValue = "minio")
public class MinioStorageServiceImpl implements StorageService {
    
    @Autowired
    private MinioClient minioClient;
    
    @Value("${storage.minio.bucket-name}")
    private String bucketName;
    
    @Value("${storage.minio.domain}")
    private String domain;
    
    @Override
    public StorageResult upload(MultipartFile file, String prefix) {
        // MinIO 上传实现
        // 1. 生成唯一文件名
        // 2. 上传文件到 MinIO
        // 3. 记录文件信息
        // 4. 返回存储结果
    }
    
    // 其他方法实现...
}

# 本地存储配置
storage:
  type: local
  local:
    base-path: uploads       # 文件存储根目录
    domain: http://localhost:8080  # 文件访问域名
    max-size: 104857600      # 最大文件大小（100MB）
    allowed-types:           # 允许上传的文件类型
      - image/*
      - application/pdf
      - application/msword

# MinIO 配置
storage:
  type: minio
  minio:
    endpoint: http://minio:9000  # MinIO 服务地址
    access-key: minioadmin        # 访问密钥
    secret-key: minioadmin        # 秘密密钥
    bucket-name: tagtag           # 存储桶名称
    domain: http://minio:9000     # 文件访问域名
    max-size: 104857600           # 最大文件大小（100MB）
    allowed-types:                # 允许上传的文件类型
      - image/*
      - application/pdf

tagtag-module-storage
└── src
    └── main
        ├── java
        │   └── dev
        │       └── tagtag
        │           └── module
        │               └── storage
        │                   ├── config
        │                   │   ├── LocalStorageConfig.java
        │                   │   ├── MinioStorageConfig.java
        │                   │   └── StorageAutoConfiguration.java
        │                   ├── controller
        │                   │   └── StorageController.java
        │                   ├── entity
        │                   │   ├── FileInfoEntity.java
        │                   │   └── StorageConfigEntity.java
        │                   ├── mapper
        │                   │   ├── FileInfoMapper.java
        │                   │   └── StorageConfigMapper.java
        │                   ├── service
        │                   │   ├── StorageService.java
        │                   │   ├── impl
        │                   │   │   ├── LocalStorageServiceImpl.java
        │                   │   │   └── MinioStorageServiceImpl.java
        │                   │   └── FileInfoService.java
        │                   └── util
        │                       ├── FileUtil.java
        │                       └── StorageUtil.java
        └── resources
            ├── db
            │   ├── schema.sql
            │   └── data
            │       └── 01_storage_config.sql
            └── mapper
                └── storage
                    ├── FileInfoMapper.xml
                    └── StorageConfigMapper.xml

frontend/apps/tagtag/src/views/modules/storage
├── file
│   ├── data.ts
│   └── index.vue
└── config
    ├── data.ts
    └── index.vue

<template>
  <div class="file-uploader">
    <a-upload
      :action="uploadUrl"
      :headers="headers"
      :before-upload="beforeUpload"
      :on-success="handleSuccess"
      :on-error="handleError"
    >
      <a-button>
        <UploadOutlined /> 选择文件
      </a-button>
    </a-upload>
  </div>
</template>

<script setup lang="ts">
import { UploadOutlined } from '@ant-design/icons-vue';
import { message } from 'ant-design-vue';
import { useToken } from '@/hooks/useToken';

const emit = defineEmits<{
  (e: 'success', file: any): void;
  (e: 'error', error: any): void;
}>();

const { token } = useToken();
const uploadUrl = import.meta.env.VITE_API_BASE_URL + '/storage/upload';

const headers = {
  'Authorization': `Bearer ${token.value}`
};

const beforeUpload = (file: File) => {
  // 验证文件类型和大小
  const isImage = file.type.startsWith('image/');
  const isLt10M = file.size / 1024 / 1024 < 10;
  
  if (!isImage) {
    message.error('只允许上传图片文件！');
    return false;
  }
  if (!isLt10M) {
    message.error('文件大小不能超过 10MB！');
    return false;
  }
  return true;
};

const handleSuccess = (response: any) => {
  if (response.success) {
    message.success('文件上传成功！');
    emit('success', response.data);
  } else {
    message.error('文件上传失败：' + response.message);
    emit('error', response);
  }
};

const handleError = (error: any) => {
  message.error('文件上传失败：' + error.message);
  emit('error', error);
};
</script>