💥 ♻️ Refactor cloud files' references, and loading system

DysonNetwork.Sphere/Storage/CloudFile.cs

@@ -20,10 +20,28 @@ public class RemoteStorageConfig
     public string? AccessProxy { get; set; }
 }
 
-public class CloudFile : ModelBase
+/// <summary>
+/// The class that used in jsonb columns which referenced the cloud file.
+/// The aim of this class is to store some properties that won't change to a file to reduce the database load.
+/// </summary>
+public class CloudFileReferenceObject : ICloudFile
+{
+    public string Id { get; set; } = null!;
+    public string Name { get; set; } = string.Empty;
+    public Dictionary<string, object>? FileMeta { get; set; } = null!;
+    public Dictionary<string, object>? UserMeta { get; set; } = null!;
+    public string? MimeType { get; set; }
+    public string? Hash { get; set; }
+    public long Size { get; set; }
+    public bool HasCompression { get; set; } = false;
+}
+
+public class CloudFile : ModelBase, ICloudFile, IIdentifiedResource
 {
     /// The id generated by TuS, basically just UUID remove the dash lines
-    [MaxLength(32)] public string Id { get; set; } = Guid.NewGuid().ToString();
+    [MaxLength(32)]
+    public string Id { get; set; } = Guid.NewGuid().ToString();
+
     [MaxLength(1024)] public string Name { get; set; } = string.Empty;
     [MaxLength(4096)] public string? Description { get; set; }
     [Column(TypeName = "jsonb")] public Dictionary<string, object>? FileMeta { get; set; } = null!;
@@ -33,29 +51,42 @@ public class CloudFile : ModelBase
     [MaxLength(256)] public string? Hash { get; set; }
     public long Size { get; set; }
     public Instant? UploadedAt { get; set; }
-    public Instant? ExpiredAt { get; set; }
     [MaxLength(128)] public string? UploadedTo { get; set; }
-    public bool HasCompression { get; set; }= false;
-    
+    public bool HasCompression { get; set; } = false;
+
     /// The object name which stored remotely,
     /// multiple cloud file may have same storage id to indicate they are the same file
     /// 
     /// If the storage id was null and the uploaded at is not null, means it is an embedding file,
     /// The embedding file means the file is store on another site,
     /// or it is a webpage (based on mimetype)
-    [MaxLength(32)] public string? StorageId { get; set; }
+    [MaxLength(32)]
+    public string? StorageId { get; set; }
+
     /// This field should be null when the storage id is filled
     /// Indicates the off-site accessible url of the file
-    [MaxLength(4096)] public string? StorageUrl { get; set; }
-
-    /// Metrics
-    /// When this used count keep zero, it means it's not used by anybody, so it can be recycled
-    public int UsedCount { get; set; } = 0;
-    /// An optional package identifier that indicates the cloud file's usage
-    [MaxLength(1024)] public string? Usage { get; set; }
+    [MaxLength(4096)]
+    public string? StorageUrl { get; set; }
 
     [JsonIgnore] public Account.Account Account { get; set; } = null!;
     public Guid AccountId { get; set; }
+
+    public CloudFileReferenceObject ToReferenceObject()
+    {
+        return new CloudFileReferenceObject
+        {
+            Id = Id,
+            Name = Name,
+            FileMeta = FileMeta,
+            UserMeta = UserMeta,
+            MimeType = MimeType,
+            Hash = Hash,
+            Size = Size,
+            HasCompression = HasCompression
+        };
+    }
+
+    public string ResourceIdentifier => $"file/{Id}";
 }
 
 public enum CloudFileSensitiveMark
@@ -73,4 +104,18 @@ public enum CloudFileSensitiveMark
     SelfHarm,
     ChildAbuse,
     Other
+}
+
+public class CloudFileReference : ModelBase
+{
+    public Guid Id { get; set; } = Guid.NewGuid();
+    [MaxLength(32)] public string FileId { get; set; } = null!;
+    public CloudFile File { get; set; } = null!;
+    [MaxLength(1024)] public string Usage { get; set; } = null!;
+    [MaxLength(1024)] public string ResourceId { get; set; } = null!;
+
+    /// <summary>
+    /// Optional expiration date for the file reference
+    /// </summary>
+    public Instant? ExpiredAt { get; set; }
 }