<?php

declare(strict_types=1);

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

namespace App\Models;

use App\Models\Concerns\HasDberpAuditTrail;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

class DberpInventoryReplenishmentSuggestion extends Model
{
    use HasDberpAuditTrail;

    protected $table = 'dberp_inventory_replenishment_suggestions';

    /**
     * @var list<string>
     */
    protected $fillable = [
        'product_id',
        'warehouse_id',
        'system_suggested_quantity',
        'adjusted_quantity',
        'trigger_reason',
        'status',
        'generated_at',
        'processed_at',
        'metric_snapshot',
        'remark',
    ];

    protected function casts(): array
    {
        return [
            'product_id' => 'integer',
            'warehouse_id' => 'integer',
            'system_suggested_quantity' => 'decimal:4',
            'adjusted_quantity' => 'decimal:4',
            'generated_at' => 'datetime',
            'processed_at' => 'datetime',
            'metric_snapshot' => 'array',
        ];
    }

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

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

    public function product(): BelongsTo
    {
        return $this->belongsTo(DberpProduct::class, 'product_id');
    }

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

    public function markReviewed(?string $remark = null): self
    {
        $this->forceFill([
            'status' => 'reviewed',
            'remark' => $remark ?: $this->remark,
        ])->save();

        return $this->refresh();
    }

    public function markProcessed(?string $remark = null): self
    {
        $this->forceFill([
            'status' => 'processed',
            'processed_at' => now(),
            'remark' => $remark ?: $this->remark,
        ])->save();

        return $this->refresh();
    }

    public function markIgnored(?string $remark = null): self
    {
        $this->forceFill([
            'status' => 'ignored',
            'remark' => $remark ?: $this->remark,
        ])->save();

        return $this->refresh();
    }
}