feat: finalize core modules and gateway

src/Modules/TakeoutSaaS.Module.Storage/Models/StorageUploadRequest.cs

@@ -0,0 +1,75 @@
+using System.Collections.Generic;
+using System.IO;
+
+namespace TakeoutSaaS.Module.Storage.Models;
+
+/// <summary>
+/// 对象存储上传请求参数。
+/// </summary>
+public sealed class StorageUploadRequest
+{
+    /// <summary>
+    /// 初始化上传请求。
+    /// </summary>
+    /// <param name="objectKey">对象键（含路径）。</param>
+    /// <param name="content">文件流。</param>
+    /// <param name="contentType">内容类型。</param>
+    /// <param name="contentLength">内容长度。</param>
+    /// <param name="generateSignedUrl">是否返回签名访问链接。</param>
+    /// <param name="signedUrlExpires">签名有效期。</param>
+    /// <param name="metadata">附加元数据。</param>
+    public StorageUploadRequest(
+        string objectKey,
+        Stream content,
+        string contentType,
+        long contentLength,
+        bool generateSignedUrl,
+        TimeSpan signedUrlExpires,
+        IDictionary<string, string>? metadata = null)
+    {
+        ObjectKey = objectKey;
+        Content = content;
+        ContentType = contentType;
+        ContentLength = contentLength;
+        GenerateSignedUrl = generateSignedUrl;
+        SignedUrlExpires = signedUrlExpires;
+        Metadata = metadata == null
+            ? new Dictionary<string, string>()
+            : new Dictionary<string, string>(metadata);
+    }
+
+    /// <summary>
+    /// 对象键。
+    /// </summary>
+    public string ObjectKey { get; }
+
+    /// <summary>
+    /// 文件流。
+    /// </summary>
+    public Stream Content { get; }
+
+    /// <summary>
+    /// 内容类型。
+    /// </summary>
+    public string ContentType { get; }
+
+    /// <summary>
+    /// 内容长度。
+    /// </summary>
+    public long ContentLength { get; }
+
+    /// <summary>
+    /// 是否需要签名访问链接。
+    /// </summary>
+    public bool GenerateSignedUrl { get; }
+
+    /// <summary>
+    /// 签名有效期。
+    /// </summary>
+    public TimeSpan SignedUrlExpires { get; }
+
+    /// <summary>
+    /// 元数据集合。
+    /// </summary>
+    public IReadOnlyDictionary<string, string> Metadata { get; }
+}