Vasyka
426156fe45
Schema: - warehouses (multi-warehouse, code unique per company, is_default) - part_batches (lot per receipt, qty_in/qty_remaining, buy_price, FIFO-indexed) - warehouse_events (immutable ledger: opening/receipt/issue/transfer/adjustment/write_off) - part_reservations (per-WO allocations from specific batches, active/consumed/released) - companies.default_warehouse_id + parts.qty_reserved Backfill: 1 default warehouse + 1 opening batch per existing part per company. WarehouseService: - receive / issue (FIFO) / reserve / release / consume / transfer / adjust - DB::transaction + lockForUpdate on batch rows - InsufficientStockException with requested + available context - Auto-syncs parts.qty as aggregate cache (source of truth = sum(qty_remaining)) WO integration: - WorkOrderPart created/updated → reserve from FIFO batches - WorkOrderPart deleted → release - WorkOrder status=done → consume reservations into issue events - WorkOrder status=cancelled → release reservations Filament: - WarehouseResource (CRUD) - BatchesRelationManager on PartResource (FIFO list with qty_remaining + cost) - "Recepție" action on parts list → calls WarehouseService::receive - qty_reserved column added on parts list Tests (8 new, all pass): - receipt creates batch + event - FIFO order verified across 3 batches with different received_at - InsufficientStockException on over-issue - Reservations block other reservations but don't deplete on-hand - WO done consumes; WO cancelled releases - Batches tenant-isolated - Transfer between warehouses with weighted-avg cost Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
64 lines
1.5 KiB
PHP
64 lines
1.5 KiB
PHP
<?php
|
|
|
|
namespace App\Models\Tenant;
|
|
|
|
use App\Models\Concerns\BelongsToTenant;
|
|
use Illuminate\Database\Eloquent\Model;
|
|
use Illuminate\Database\Eloquent\Relations\BelongsTo;
|
|
use Illuminate\Database\Eloquent\Relations\MorphTo;
|
|
|
|
/**
|
|
* Immutable ledger of every stock movement. The qty/cost reality of the
|
|
* warehouse can always be reconstructed by aggregating these events.
|
|
*/
|
|
class WarehouseEvent extends Model
|
|
{
|
|
use BelongsToTenant;
|
|
|
|
public const TYPES = [
|
|
'opening' => 'Stoc inițial',
|
|
'receipt' => 'Recepție',
|
|
'issue' => 'Consum',
|
|
'transfer_out' => 'Transfer (ieșire)',
|
|
'transfer_in' => 'Transfer (intrare)',
|
|
'adjustment' => 'Ajustare',
|
|
'write_off' => 'Casare',
|
|
'return' => 'Retur',
|
|
];
|
|
|
|
protected $fillable = [
|
|
'company_id', 'part_id', 'batch_id', 'warehouse_id',
|
|
'type', 'qty_delta', 'unit_cost',
|
|
'ref_type', 'ref_id', 'user_id',
|
|
'occurred_at', 'notes',
|
|
];
|
|
|
|
protected $casts = [
|
|
'qty_delta' => 'decimal:3',
|
|
'unit_cost' => 'decimal:2',
|
|
'occurred_at' => 'datetime',
|
|
];
|
|
|
|
public $timestamps = true;
|
|
|
|
public function part(): BelongsTo
|
|
{
|
|
return $this->belongsTo(Part::class);
|
|
}
|
|
|
|
public function batch(): BelongsTo
|
|
{
|
|
return $this->belongsTo(PartBatch::class, 'batch_id');
|
|
}
|
|
|
|
public function warehouse(): BelongsTo
|
|
{
|
|
return $this->belongsTo(Warehouse::class);
|
|
}
|
|
|
|
public function ref(): MorphTo
|
|
{
|
|
return $this->morphTo();
|
|
}
|
|
}
|