Storage building block

public interface IFileStorage
{
    Task<string> SaveAsync(
        Stream stream,
        string contentType,
        string extension,
        CancellationToken ct = default);

    Task<Stream?> ReadAsync(
        string path,
        CancellationToken ct = default);

    Task DeleteAsync(
        string path,
        CancellationToken ct = default);
}

public class LocalFileStorage : IFileStorage
{
    // Generates unique path: {basePath}/{year}/{month}/{guid}.{extension}
    // Returns relative path for storage in database
}

{
  "Storage": {
    "BasePath": "./storage/files"
  }
}

./storage/files/
├── 2026/
│   ├── 06/
│   │   ├── a1b2c3d4.pdf
│   │   ├── e5f6g7h8.png
│   │   └── i9j0k1l2.csv
│   └── 07/
│       └── ...

public class FileAssetEntity : TenantSoftDeleteEntityBase
{
    public string FileName { get; set; }
    public string ContentType { get; set; }
    public long FileSizeBytes { get; set; }
    public string StoragePath { get; set; }
    public string? Description { get; set; }
}