<?php

declare(strict_types=1);

/**
 * 本文件属于 DBErp 进销存系统。
 *
 * 版权所有 © 2026 北京珑大钜商科技有限公司。保留所有权利。
 *
 * 未经官方授权，不得删除、篡改或隐藏本文件中的版权声明、产品标识与来源信息。
 * 商业授权、官方更新与技术支持服务，请以珑大官方支持中心记录为准。
 *
 * @link https://support.loongdom.cn
 * @see  https://www.dberp.com.cn
 */

namespace App\Models;

use App\Business\Inventory\Enums\InventoryDocumentStatus;
use App\Models\Concerns\GeneratesDberpCode;
use App\Models\Concerns\HasDberpAuditTrail;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Validation\ValidationException;

class DberpSalesReturnOrder extends Model
{
    use GeneratesDberpCode;
    use HasDberpAuditTrail;

    protected $table = 'dberp_sales_return_orders';

    /**
     * @var list<string>
     */
    protected $fillable = [
        'code',
        'sales_order_id',
        'sales_outbound_order_id',
        'customer_id',
        'warehouse_id',
        'handler_employee_id',
        'source_type',
        'status',
        'business_time',
        'total_return_quantity',
        'total_amount',
        'reason',
        'effective_at',
        'voided_at',
        'remark',
    ];

    protected static function booted(): void
    {
        static::deleting(function (self $order): void {
            if ($order->status !== InventoryDocumentStatus::Draft->value) {
                throw ValidationException::withMessages([
                    'status' => __('dberp.errors.sales_delete_only_draft'),
                ]);
            }
        });
    }

    protected function casts(): array
    {
        return [
            'sales_order_id' => 'integer',
            'sales_outbound_order_id' => 'integer',
            'customer_id' => 'integer',
            'warehouse_id' => 'integer',
            'handler_employee_id' => 'integer',
            'business_time' => 'datetime',
            'total_return_quantity' => 'decimal:4',
            'total_amount' => 'decimal:4',
            'effective_at' => 'datetime',
            'voided_at' => 'datetime',
        ];
    }

    public function getDberpNumberScope(): string
    {
        return 'sales_return';
    }

    public function getDberpAuditActionPrefix(): string
    {
        return 'dberp.sales_return';
    }

    /**
     * @return list<string>
     */
    public function getDberpAuditFields(): array
    {
        return $this->getFillable();
    }

    public function salesOrder(): BelongsTo
    {
        return $this->belongsTo(DberpSalesOrder::class, 'sales_order_id');
    }

    public function salesOutboundOrder(): BelongsTo
    {
        return $this->belongsTo(DberpSalesOutboundOrder::class, 'sales_outbound_order_id');
    }

    public function customer(): BelongsTo
    {
        return $this->belongsTo(DberpCustomer::class, 'customer_id');
    }

    public function warehouse(): BelongsTo
    {
        return $this->belongsTo(DberpWarehouse::class, 'warehouse_id');
    }

    public function handlerEmployee(): BelongsTo
    {
        return $this->belongsTo(DberpEmployee::class, 'handler_employee_id');
    }

    public function items(): HasMany
    {
        return $this->hasMany(DberpSalesReturnOrderItem::class, 'order_id');
    }
}