文件存储

提供文件上传、存储和管理的完整能力，支持本地存储和七牛云 OSS 两种方式，含分片上传和类型安全验证。

概述

文件存储系统支持图片、视频、文档等多种文件类型的上传和管理。前端直传七牛云 OSS 获取 URL 后提交给服务端记录，大文件自动使用分片上传。

核心能力

1. 文件上传

特性	说明
上传方式	前端直传七牛云 OSS，服务端记录 URL
支持格式	图片（image/）、视频（video/）、文档、音频
大小限制	最大 200MB
分片上传	文件 > 4MB 自动分片
路径分类	按文件类型上传到不同目录

2. 文件管理

• 文件列表（分页、搜索、筛选）
• 按类型筛选（全部/图片/视频）
• 按状态筛选（上传中/已完成/失败）
• 文件预览（图片放大查看、视频播放）
• 文件链接一键复制

3. 文件删除

• 同时删除数据库记录和 OSS 文件
• 数据一致性保证（OSS 删除失败则保留记录）
• 删除前确认提示

数据库设计

file（文件表）

核心字段：user_id、original_name、storage_key、file_type（image/video/document/audio）、mime_type、size、storage_url、upload_status

相关文件

• src/services/file.mts — 文件业务逻辑
• src/services/qiniu.mts — 七牛云 OSS 集成
• src/controllers/file.mts — 文件接口控制器
• src/models/File.mts — 文件模型
• src/utils/FileUtils.mts — 文件工具函数
• src/utils/FileTypeUtils.mts — 文件类型校验