Files
autocrm/app/Models/Tenant/WorkOrderPart.php
T
Vasyka 426156fe45 Stage 5.1 — Warehouse ERP: batches + FIFO + reservations + multi-warehouse
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>
2026-05-27 19:29:19 +00:00

90 lines
2.9 KiB
PHP

<?php
namespace App\Models\Tenant;
use App\Models\Concerns\BelongsToTenant;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
class WorkOrderPart extends Model
{
use BelongsToTenant;
protected $table = 'wo_parts';
public const STATUSES = [
'needed' => 'Necesară',
'ordered' => 'Comandată',
'delivered' => 'Sosită',
'installed' => 'Montată',
];
protected $fillable = [
'company_id', 'work_order_id', 'part_id',
'name', 'article', 'brand',
'qty', 'unit', 'buy_price', 'sell_price',
'discount_pct', 'total', 'status', 'notes',
];
protected $casts = [
'qty' => 'decimal:2',
'buy_price' => 'decimal:2',
'sell_price' => 'decimal:2',
'discount_pct' => 'decimal:2',
'total' => 'decimal:2',
];
public function workOrder(): BelongsTo
{
return $this->belongsTo(WorkOrder::class);
}
public function part(): BelongsTo
{
return $this->belongsTo(Part::class);
}
protected static function booted(): void
{
static::saving(function (self $row) {
$sub = (float) $row->qty * (float) $row->sell_price;
$disc = (float) $row->discount_pct;
$row->total = round($sub * (1 - $disc / 100), 2);
});
// Reserve batches as soon as a catalog-linked part line is created.
// Reservations don't reduce on-hand qty, only block other reservations.
static::created(function (self $row) {
if ($row->part_id) {
try {
app(\App\Services\Warehouse\WarehouseService::class)->reserve($row);
} catch (\App\Services\Warehouse\InsufficientStockException $e) {
\Illuminate\Support\Facades\Log::warning('WO part reservation skipped: ' . $e->getMessage());
}
}
});
// If qty / part link changes, release old reservation and re-reserve.
static::updated(function (self $row) {
if ($row->wasChanged(['qty', 'part_id'])) {
$svc = app(\App\Services\Warehouse\WarehouseService::class);
$svc->release($row);
if ($row->part_id) {
try {
$svc->reserve($row);
} catch (\App\Services\Warehouse\InsufficientStockException $e) {
\Illuminate\Support\Facades\Log::warning('WO part re-reservation skipped: ' . $e->getMessage());
}
}
}
});
static::deleted(function (self $row) {
app(\App\Services\Warehouse\WarehouseService::class)->release($row);
});
static::saved(fn (self $row) => $row->workOrder?->recalcTotal());
static::deleted(fn (self $row) => $row->workOrder?->recalcTotal());
}
}