Refactor attachment cropping functionality to support multiple variants

- Introduced AttachmentCrop model to manage crop variants for attachments.
- Updated Attachment model to remove direct crop fields and establish relationships with AttachmentCrop.
- Modified AttachmentService to handle storing and updating multiple crop variants (desktop and mobile).
- Adjusted validation rules to accommodate new crop structure.
- Updated database migration to create attachment_crops table and migrate existing crop data.
- Refactored tests to ensure compatibility with the new cropping structure and validate multiple crop variants.
- Enhanced documentation to reflect changes in attachment handling and cropping capabilities.

app/Domains/Attachable/Models/Attachment.php

@@ -6,7 +6,7 @@ use App\Domains\Attachable\Enums\AttachmentType;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\HasOne;
 use Illuminate\Support\Facades\Storage;
 use Illuminate\Support\Str;
@@ -19,9 +19,6 @@ use Illuminate\Support\Str;
     'mime_type',
     'extension',
     'size',
-    'crop_horizontal',
-    'crop_vertical',
-    'cropped_attachment_id',
 ])]
 class Attachment extends Model
 {
@@ -43,20 +40,29 @@ class Attachment extends Model
         return [
             'type' => AttachmentType::class,
             'size' => 'integer',
-            'crop_horizontal' => 'array',
-            'crop_vertical' => 'array',
-            'cropped_attachment_id' => 'integer',
         ];
     }
 
-    public function croppedAttachment(): BelongsTo
+    public function cropVariants(): HasMany
     {
-        return $this->belongsTo(self::class, 'cropped_attachment_id');
+        return $this->hasMany(AttachmentCrop::class);
     }
 
-    public function originalAttachment(): HasOne
+    public function desktopCrop(): HasOne
     {
-        return $this->hasOne(self::class, 'cropped_attachment_id');
+        return $this->hasOne(AttachmentCrop::class)
+            ->where('variant', AttachmentCrop::DESKTOP);
+    }
+
+    public function mobileCrop(): HasOne
+    {
+        return $this->hasOne(AttachmentCrop::class)
+            ->where('variant', AttachmentCrop::MOBILE);
+    }
+
+    public function cropSource(): HasOne
+    {
+        return $this->hasOne(AttachmentCrop::class, 'cropped_attachment_id');
     }
 
     /**