ldc-showroom-bo/app/Models/Range.php

<?php

namespace App\Models;

use App\Enums\Width;
use App\Traits\Models\ActivityLog;
use App\Traits\Models\HasTranslations;
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\Support\Str;
use Stancl\Tenancy\Database\Concerns\BelongsToTenant;
use Uwil\LaravelCommon\Helpers\FileHelper;
use App\Lib\Helpers\ToolboxHelper;
use Illuminate\Http\UploadedFile;
use App\Helpers\ShowroomFileHelper;

/**
 * @property string                          $name            Name of the range.
 * @property string                          $slug            Slug of the name for the range.
 * @property string                          $picture         Picture path for the range.
 * @property string                          $color           HTML Color string.
 * @property integer                         $width           Width or the range to display
 *                                                            (1 or 2 columns, 2 is full width).
 * @property integer                         $order           Order for the range to display.
 * @property boolean                         $status          Visible ? (présent dans l'export).
 * @property string                          $tenant_id       Id of the related tenant.
 * @property-read \Illuminate\Support\Carbon $created_at      Created date.
 * @property-read \Illuminate\Support\Carbon $updated_at      Updated date.
 *
 * @property-read \App\Models\Brand                                             $brand    Brand Belongs-to.
 * @property-read \App\Models\Font                                              $font     Font Belongs-to.
 * @property-read \Illuminate\Database\Eloquent\Collection<\App\Models\Product> $products Products Has-many.
 */
class Range extends Model
{
    use HasFactory;
    use HasTranslations;
    use BelongsToTenant;
    use ActivityLog;

    /**
     * The attributes that are mass assignable.
     *
     * @var list<string>
     */
    protected $fillable = [
        'name',
        'picture',
        'brand_id',
        'font_id',
        'color',
        'width',
        'order',
        'status',
    ];

    /**
     * Translatable fields array
     *
     * @var array<int, string>
     */
    public $translatable = [
        'name',
        'slug',
    ];

    /**
     * The attributes that should be cast.
     *
     * @var array<string, string>
     */
    protected $casts = [
        'status' => 'bool',
        'width' => Width::class
    ];

    /**
     * Perform any actions required after the model boots.
     *
     * @return void
     */
    protected static function booted(): void
    {
        static::creating(function (self $model) {
            // * ASSERTIONS
            self::assertNameIsUnique($model->name);

            // * TRANSFORMATIONS
            $model->slug = Str::slug($model->name);
            /** @phpstan-ignore-next-line */
            if ($model->picture instanceof UploadedFile) {
                $model->picture = ShowroomFileHelper::storeFileWithUUIDName($model->picture, $model);
            }
            self::setOrder($model);
        });
        static::updating(function (self $model) {
            // * ASSERTIONS
            self::assertNameIsUnique($model->name, $model->id);

            // * TRANSFORMATIONS
            $model->slug = Str::slug($model->name);
            /** @phpstan-ignore-next-line */
            if ($model->picture instanceof UploadedFile) {
                $model->picture = ShowroomFileHelper::storeFileWithUUIDName($model->picture, $model);
            }
        });
        static::updated(function (self $model) {
            FileHelper::removeOldFile($model, 'picture');
            FileHelper::removeOldFile($model, 'font');
        });
        static::deleted(function (self $model) {
            FileHelper::removeFile($model, 'picture');
            FileHelper::removeFile($model, 'font');
        });
    }

    // * RELATIONSHIPS

    /**
     * Get the brand that owns the Range
     *
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function brand(): BelongsTo
    {
        return $this->belongsTo(Brand::class);
    }

    /**
     * Get the font that owns the Range
     *
     * @return \Illuminate\Database\Eloquent\Relations\BelongsTo
     */
    public function font(): BelongsTo
    {
        return $this->belongsTo(Font::class);
    }

    /**
     * Get all of the products for the Brand
     *
     * @return \Illuminate\Database\Eloquent\Relations\HasMany<\App\Models\Product, $this>
     */
    public function products(): HasMany
    {
        return $this->hasMany(Product::class);
    }

    // * METHODS

    /**
     * Asserts using validation that the name is unique
     *
     * @param string|null  $name
     * @param integer|null $id
     * @return void
     * @throws \Illuminate\Validation\ValidationException If name already exists.
     */
    private static function assertNameIsUnique(string|null $name, ?int $id = null)
    {
        $table = (new self())->getTable();
        ToolboxHelper::assertFieldIsUnique($table, 'name', $name, $id);
        ToolboxHelper::assertFieldIsUnique($table, 'slug', Str::slug($name), $id);
    }

    /**
     * Set order after the last element of the list.
     *
     * @param self $model
     * @return void
     */
    private static function setOrder(self $model): void
    {
        $model->order = \intval(self::query()->max('order')) + 1;
    }
}