star-erp/app/Modules/Inventory/Models/Product.php

<?php

namespace App\Modules\Inventory\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Spatie\Activitylog\Traits\LogsActivity;
use Spatie\Activitylog\LogOptions;
use App\Modules\Procurement\Models\Vendor; // Cross-module dependency (Procurement)

class Product extends Model
{
    use HasFactory, LogsActivity, SoftDeletes;

    protected $fillable = [
        'code',
        'name',
        'category_id',
        'brand',
        'specification',
        'base_unit_id',
        'large_unit_id',
        'conversion_rate',
        'purchase_unit_id',
    ];

    protected $casts = [
        'conversion_rate' => 'decimal:4',
    ];

    /**
     * Get the category that owns the product.
     */
    public function category(): BelongsTo
    {
        return $this->belongsTo(Category::class);
    }

    public function baseUnit(): BelongsTo
    {
        return $this->belongsTo(Unit::class, 'base_unit_id');
    }

    public function largeUnit(): BelongsTo
    {
        return $this->belongsTo(Unit::class, 'large_unit_id');
    }

    public function purchaseUnit(): BelongsTo
    {
        return $this->belongsTo(Unit::class, 'purchase_unit_id');
    }

    public function vendors(): \Illuminate\Database\Eloquent\Relations\BelongsToMany
    {
        return $this->belongsToMany(Vendor::class)->withPivot('last_price')->withTimestamps();
    }

    public function inventories(): \Illuminate\Database\Eloquent\Relations\HasMany
    {
        return $this->hasMany(Inventory::class);
    }

    public function transactions(): HasMany
    {
        return $this->hasMany(InventoryTransaction::class);
    }

    public function getActivitylogOptions(): LogOptions
    {
        return LogOptions::defaults()
            ->logAll()
            ->logOnlyDirty()
            ->dontSubmitEmptyLogs();
    }

    public function tapActivity(\Spatie\Activitylog\Contracts\Activity $activity, string $eventName)
    {
        $properties = $activity->properties;
        $attributes = $properties['attributes'] ?? [];
        $snapshot = $properties['snapshot'] ?? [];
        
        // Handle Category Name Snapshot
        if (isset($attributes['category_id'])) {
            $category = Category::find($attributes['category_id']);
            $snapshot['category_name'] = $category ? $category->name : null;
        }
        
        // Handle Unit Name Snapshots
        $unitFields = ['base_unit_id', 'large_unit_id', 'purchase_unit_id'];
        foreach ($unitFields as $field) {
            if (isset($attributes[$field])) {
                $unit = Unit::find($attributes[$field]);
                $nameKey = str_replace('_id', '_name', $field);
                $snapshot[$nameKey] = $unit ? $unit->name : null;
            }
        }
        
        // Always snapshot self name for context (so logs always show "Cola")
        $snapshot['name'] = $this->name;

        $properties['attributes'] = $attributes;
        $properties['snapshot'] = $snapshot;
        $activity->properties = $properties;
    }

    public function warehouses(): \Illuminate\Database\Eloquent\Relations\BelongsToMany
    {
        return $this->belongsToMany(Warehouse::class, 'inventories')
            ->withPivot(['quantity', 'safety_stock', 'location'])
            ->withTimestamps();
    }
}