上传服务

后台管理提供通用文件上传能力，默认将文件存储在后端服务器的 uploads 目录下，并按小时分桶。

上传文件

• Method：POST
• Path：/upload
• Content-Type：multipart/form-data
• 字段：

字段名	类型	必填	说明
file	File	✓	要上传的文件。

控制器使用 FileInterceptor('file')，文件大小限制为 5 MB。

存储规则

• 目标路径：uploads/<yyyy-MM-dd-HH>/随机文件名.ext。
• 当目录不存在时会自动创建。
• 文件名格式：<timestamp>-<随机数>.<原始扩展名>。

响应

{
  "code": 0,
  "data": {
    "filename": "poster.png",
    "path": "/uploads/2025-10-16-21/1729102748937-123456789.png"
  },
  "message": "OK"
}

前端可将返回的 path 拼接服务器域名作为访问地址：https://admin-api.movie.example/uploads/...。

对象存储扩展

UploadService 中预留了 uploadToCloud 方法，后续可根据需求接入 OSS/S3 等对象存储。建议：

1. 上传成功后返回云端地址 cloudPath。
2. 提供开关选择本地存储或云存储。
3. 将上传凭证等配置透出到后台管理界面。