erpsaas/app/Models/Setting/DocumentDefault.php

<?php

namespace App\Models\Setting;

use App\Casts\TrimLeadingZeroCast;
use App\Enums\{DocumentType, Font, PaymentTerms, Template};
use App\Traits\{Blamable, CompanyOwned};
use Database\Factories\Setting\DocumentDefaultFactory;
use Illuminate\Database\Eloquent\Casts\AsArrayObject;
use Illuminate\Database\Eloquent\Factories\{Factory, HasFactory};
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\{Builder, Model};
use Wallo\FilamentCompanies\FilamentCompanies;

class DocumentDefault extends Model
{
    use Blamable;
    use CompanyOwned;
    use HasFactory;

    protected $table = 'document_defaults';

    protected $fillable = [
        'company_id',
        'type',
        'logo',
        'show_logo',
        'number_prefix',
        'number_digits',
        'number_next',
        'payment_terms',
        'header',
        'subheader',
        'terms',
        'footer',
        'accent_color',
        'font',
        'template',
        'item_name',
        'unit_name',
        'price_name',
        'amount_name',
        'created_by',
        'updated_by',
    ];

    protected $casts = [
        'show_logo' => 'boolean',
        'number_next' => TrimLeadingZeroCast::class,
        'payment_terms' => PaymentTerms::class,
        'font' => Font::class,
        'template' => Template::class,
        'item_name' => AsArrayObject::class,
        'unit_name' => AsArrayObject::class,
        'price_name' => AsArrayObject::class,
        'amount_name' => AsArrayObject::class,
    ];

    public function company(): BelongsTo
    {
        return $this->belongsTo(FilamentCompanies::companyModel(), 'company_id');
    }

    public function createdBy(): BelongsTo
    {
        return $this->belongsTo(FilamentCompanies::userModel(), 'created_by');
    }

    public function updatedBy(): BelongsTo
    {
        return $this->belongsTo(FilamentCompanies::userModel(), 'updated_by');
    }

    public function scopeType(Builder $query, string | DocumentType $type): Builder
    {
        return $query->where($this->qualifyColumn('type'), $type);
    }

    public function scopeInvoice(Builder $query): Builder
    {
        return $query->scopes(['type' => [DocumentType::Invoice]]);
    }

    public function scopeBill(Builder $query): Builder
    {
        return $query->scopes(['type' => [DocumentType::Bill]]);
    }

    public static function availableNumberDigits(): array
    {
        return array_combine(range(1, 20), range(1, 20));
    }

    public static function getNumberNext(?bool $padded = null, ?bool $format = null, ?string $prefix = null, int | string | null $digits = null, int | string | null $next = null, ?string $type = null): string
    {
        $initializeAttributes = new static;

        [$number_prefix, $number_digits, $number_next] = $initializeAttributes->initializeAttributes($prefix, $digits, $next, $type);

        if ($format) {
            return $number_prefix . static::getPaddedNumberNext($number_next, $number_digits);
        }

        if ($padded) {
            return static::getPaddedNumberNext($number_next, $number_digits);
        }

        return $number_next;
    }

    public function initializeAttributes(?string $prefix, int | string | null $digits, int | string | null $next, ?string $type): array
    {
        $number_prefix = $prefix ?? $this->getAttributeFromArray('number_prefix');
        $number_digits = $digits ?? $this->getAttributeFromArray('number_digits');
        $number_next = $next ?? $this->getAttributeFromArray('number_next');

        if ($type) {
            $attributes = static::getAttributesByType($type);

            $number_prefix = $attributes['number_prefix'] ?? $number_prefix;
            $number_digits = $attributes['number_digits'] ?? $number_digits;
            $number_next = $attributes['number_next'] ?? $number_next;
        }

        return [$number_prefix, $number_digits, $number_next];
    }

    public static function getAttributesByType(?string $type): array
    {
        $model = new static;
        $attributes = $model->newQuery()->type($type)->first();

        return $attributes ? $attributes->toArray() : [];
    }

    /**
     * Get the next number with padding for dynamic display purposes.
     * Even if number_next is a string, it will be cast to an integer.
     */
    public static function getPaddedNumberNext(int | string | null $number_next, int | string | null $number_digits): string
    {
        return str_pad($number_next, $number_digits, '0', STR_PAD_LEFT);
    }

    public function getItemNameOptionAttribute(): ?string
    {
        return $this->item_name['option'] ?? null;
    }

    public function getItemNameCustomAttribute(): ?string
    {
        return $this->item_name['custom'] ?? null;
    }

    public function getItemNameOptions(): array
    {
        return $this->item_name ?? [];
    }

    public function getUnitNameOptionAttribute(): ?string
    {
        return $this->unit_name['option'] ?? null;
    }

    public function getUnitNameCustomAttribute(): ?string
    {
        return $this->unit_name['custom'] ?? null;
    }

    public function getUnitNameOptions(): array
    {
        return $this->unit_name ?? [];
    }

    public function getPriceNameOptionAttribute(): ?string
    {
        return $this->price_name['option'] ?? null;
    }

    public function getPriceNameCustomAttribute(): ?string
    {
        return $this->price_name['custom'] ?? null;
    }

    public function getPriceNameOptions(): array
    {
        return $this->price_name ?? [];
    }

    public function getAmountNameOptionAttribute(): ?string
    {
        return $this->amount_name['option'] ?? null;
    }

    public function getAmountNameCustomAttribute(): ?string
    {
        return $this->amount_name['custom'] ?? null;
    }

    public function getAmountNameOptions(): array
    {
        return $this->amount_name ?? [];
    }

    public static function getAvailableItemNameOptions(): array
    {
        return [
            'items' => 'Items',
            'products' => 'Products',
            'services' => 'Services',
            'other' => 'Other',
        ];
    }

    public static function getAvailableUnitNameOptions(): array
    {
        return [
            'quantity' => 'Quantity',
            'hours' => 'Hours',
            'other' => 'Other',
        ];
    }

    public static function getAvailablePriceNameOptions(): array
    {
        return [
            'price' => 'Price',
            'rate' => 'Rate',
            'other' => 'Other',
        ];
    }

    public static function getAvailableAmountNameOptions(): array
    {
        return [
            'amount' => 'Amount',
            'total' => 'Total',
            'other' => 'Other',
        ];
    }

    protected static function newFactory(): Factory
    {
        return DocumentDefaultFactory::new();
    }
}