From 9258bbc3363674b726bce53a2535ac1fd7feb576 Mon Sep 17 00:00:00 2001
From: gpu <gpu@server>
Date: Wed, 21 Jan 2026 23:55:41 +0800
Subject: [PATCH] 321

---
 .gitignore                                    |   6 +-
 .../Models/Upload/UploadModels.cs             | 119 ++++++++++++++++++
 2 files changed, 122 insertions(+), 3 deletions(-)
 create mode 100644 server/HoneyBox/src/HoneyBox.Admin.Business/Models/Upload/UploadModels.cs

diff --git a/.gitignore b/.gitignore
index 068756bd..7b6d4765 100644
--- a/.gitignore
+++ b/.gitignore
@@ -66,9 +66,9 @@ temp/
 *.sqlite
 *.db
 
-# 上传文件目录
-uploads/
-upload/
+# 上传文件目录（只忽略根目录下的）
+/uploads/
+/upload/
 
 # 小程序相关
 honey_box/unpackage/
diff --git a/server/HoneyBox/src/HoneyBox.Admin.Business/Models/Upload/UploadModels.cs b/server/HoneyBox/src/HoneyBox.Admin.Business/Models/Upload/UploadModels.cs
new file mode 100644
index 00000000..3ec978c2
--- /dev/null
+++ b/server/HoneyBox/src/HoneyBox.Admin.Business/Models/Upload/UploadModels.cs
@@ -0,0 +1,119 @@
+namespace HoneyBox.Admin.Business.Models.Upload;
+
+/// <summary>
+/// 上传响应模型
+/// </summary>
+public class UploadResponse
+{
+    /// <summary>
+    /// 文件URL
+    /// </summary>
+    public string Url { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 文件名
+    /// </summary>
+    public string FileName { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 文件大小(字节)
+    /// </summary>
+    public long FileSize { get; set; }
+}
+
+/// <summary>
+/// 获取预签名上传URL请求
+/// </summary>
+public class GetPresignedUrlRequest
+{
+    /// <summary>
+    /// 原始文件名
+    /// </summary>
+    public string FileName { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 文件MIME类型
+    /// </summary>
+    public string ContentType { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 文件大小(字节)
+    /// </summary>
+    public long FileSize { get; set; }
+}
+
+/// <summary>
+/// 预签名上传URL响应
+/// </summary>
+public class PresignedUrlResponse
+{
+    /// <summary>
+    /// 预签名上传URL
+    /// </summary>
+    public string UploadUrl { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 文件最终访问URL
+    /// </summary>
+    public string FileUrl { get; set; } = string.Empty;
+
+    /// <summary>
+    /// 对象Key（COS路径）
+    /// </summary>
+    public string ObjectKey { get; set; } = string.Empty;
+
+    /// <summary>
+    /// URL过期时间（秒）
+    /// </summary>
+    public int ExpiresIn { get; set; }
+
+    /// <summary>
+    /// 存储类型 (1=本地, 3=COS)
+    /// </summary>
+    public string StorageType { get; set; } = string.Empty;
+}
+
+/// <summary>
+/// 上传结果(内部使用)
+/// </summary>
+public class UploadResult
+{
+    /// <summary>
+    /// 是否成功
+    /// </summary>
+    public bool Success { get; set; }
+
+    /// <summary>
+    /// 文件URL
+    /// </summary>
+    public string? Url { get; set; }
+
+    /// <summary>
+    /// 错误信息
+    /// </summary>
+    public string? ErrorMessage { get; set; }
+
+    /// <summary>
+    /// 创建成功结果
+    /// </summary>
+    public static UploadResult Ok(string url)
+    {
+        return new UploadResult
+        {
+            Success = true,
+            Url = url
+        };
+    }
+
+    /// <summary>
+    /// 创建失败结果
+    /// </summary>
+    public static UploadResult Fail(string errorMessage)
+    {
+        return new UploadResult
+        {
+            Success = false,
+            ErrorMessage = errorMessage
+        };
+    }
+}