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>
This commit is contained in:
2026-05-27 19:29:19 +00:00
parent edcdba9d53
commit 426156fe45
17 changed files with 1360 additions and 12 deletions
@@ -3,6 +3,7 @@
namespace App\Filament\Tenant\Resources;
use App\Filament\Tenant\Resources\PartResource\Pages;
use App\Filament\Tenant\Resources\PartResource\RelationManagers;
use App\Models\Tenant\Part;
use App\Models\Tenant\Supplier;
use Filament\Actions;
@@ -112,6 +113,12 @@ class PartResource extends Resource
->alignRight()
->color(fn ($state, $record) => $record->qty <= 0 ? 'danger' : ($record->qty <= $record->min_qty ? 'warning' : null))
->weight(fn ($state, $record) => $record->qty <= $record->min_qty ? 'bold' : null),
Tables\Columns\TextColumn::make('qty_reserved')
->label('Rezervat')
->numeric(decimalPlaces: 2)
->alignRight()
->color(fn ($state) => (float) $state > 0 ? 'info' : null)
->toggleable(),
Tables\Columns\TextColumn::make('unit')->label('UM'),
Tables\Columns\TextColumn::make('location')->label('Loc.')->placeholder('—'),
Tables\Columns\TextColumn::make('sell_price')->label('Preț vz.')->money('MDL')->alignRight(),
@@ -128,6 +135,42 @@ class PartResource extends Resource
->query(fn ($q) => $q->where('qty', '<=', 0)),
])
->actions([
Actions\Action::make('receive')
->label('Recepție')
->icon('heroicon-m-arrow-down-tray')
->color('success')
->schema([
Forms\Components\TextInput::make('qty')->label('Cantitate')->numeric()->required()->minValue(0.001),
Forms\Components\TextInput::make('buy_price')->label('Preț unitar')->numeric()->required(),
Forms\Components\Select::make('supplier_id')
->label('Furnizor')
->options(fn () => \App\Models\Tenant\Supplier::pluck('name', 'id')),
Forms\Components\Select::make('warehouse_id')
->label('Depozit')
->options(fn () => \App\Models\Tenant\Warehouse::where('is_active', true)->pluck('name', 'id'))
->default(fn () => \App\Models\Tenant\Warehouse::where('is_default', true)->value('id')),
Forms\Components\TextInput::make('batch_ref')->label('Ref. lot/factură')->maxLength(64),
])
->action(function (Part $record, array $data) {
$warehouse = $data['warehouse_id']
? \App\Models\Tenant\Warehouse::find($data['warehouse_id'])
: null;
$supplier = $data['supplier_id']
? \App\Models\Tenant\Supplier::find($data['supplier_id'])
: null;
app(\App\Services\Warehouse\WarehouseService::class)->receive(
part: $record,
qty: (float) $data['qty'],
buyPrice: (float) $data['buy_price'],
warehouse: $warehouse,
supplier: $supplier,
batchRef: $data['batch_ref'] ?? null,
);
\Filament\Notifications\Notification::make()
->title('Stoc adăugat')
->success()
->send();
}),
Actions\EditAction::make(),
Actions\DeleteAction::make(),
])
@@ -137,6 +180,13 @@ class PartResource extends Resource
->defaultSort('name');
}
public static function getRelations(): array
{
return [
RelationManagers\BatchesRelationManager::class,
];
}
public static function getPages(): array
{
return [
@@ -0,0 +1,45 @@
<?php
namespace App\Filament\Tenant\Resources\PartResource\RelationManagers;
use Filament\Resources\RelationManagers\RelationManager;
use Filament\Tables;
use Filament\Tables\Table;
class BatchesRelationManager extends RelationManager
{
protected static string $relationship = 'batches';
protected static ?string $title = 'Loturi (FIFO)';
public function table(Table $table): Table
{
return $table
->columns([
Tables\Columns\TextColumn::make('received_at')
->label('Recepție')
->dateTime('d.m.Y H:i')
->sortable(),
Tables\Columns\TextColumn::make('warehouse.code')->label('Depozit')->placeholder('—'),
Tables\Columns\TextColumn::make('batch_ref')->label('Ref.')->placeholder('—'),
Tables\Columns\TextColumn::make('supplier.name')->label('Furnizor')->placeholder('—'),
Tables\Columns\TextColumn::make('qty_in')
->label('Intrat')
->numeric(decimalPlaces: 2)
->alignRight(),
Tables\Columns\TextColumn::make('qty_remaining')
->label('Rămas')
->numeric(decimalPlaces: 2)
->alignRight()
->weight('bold')
->color(fn ($state) => (float) $state <= 0 ? 'gray' : 'success'),
Tables\Columns\TextColumn::make('buy_price')
->label('Preț unit.')
->money('MDL')
->alignRight(),
])
->defaultSort('received_at')
->emptyStateHeading('Niciun lot înregistrat')
->emptyStateDescription('Apasă „Recepție" pe lista de piese pentru a înregistra prima intrare în depozit.');
}
}
@@ -0,0 +1,76 @@
<?php
namespace App\Filament\Tenant\Resources;
use App\Filament\Tenant\Resources\WarehouseResource\Pages;
use App\Models\Tenant\Warehouse;
use Filament\Actions;
use Filament\Forms;
use Filament\Resources\Resource;
use Filament\Schemas;
use Filament\Schemas\Schema;
use Filament\Tables;
use Filament\Tables\Table;
class WarehouseResource extends Resource
{
protected static ?string $model = Warehouse::class;
protected static string|\BackedEnum|null $navigationIcon = 'heroicon-o-building-storefront';
protected static ?string $navigationLabel = 'Depozite';
protected static string|\UnitEnum|null $navigationGroup = 'Depozit';
protected static ?string $modelLabel = 'depozit';
protected static ?string $pluralModelLabel = 'depozite';
protected static ?int $navigationSort = 38;
public static function form(Schema $schema): Schema
{
return $schema->components([
Schemas\Components\Section::make()->columns(2)->schema([
Forms\Components\TextInput::make('code')->label('Cod')->required()->maxLength(32),
Forms\Components\TextInput::make('name')->label('Denumire')->required()->maxLength(120),
Forms\Components\TextInput::make('address')->label('Adresă')->columnSpanFull()->maxLength(200),
Forms\Components\Toggle::make('is_default')->label('Depozit implicit'),
Forms\Components\Toggle::make('is_active')->label('Activ')->default(true),
]),
]);
}
public static function table(Table $table): Table
{
return $table
->columns([
Tables\Columns\TextColumn::make('code')->searchable()->sortable(),
Tables\Columns\TextColumn::make('name')->searchable()->sortable(),
Tables\Columns\TextColumn::make('address')->placeholder('—')->toggleable(),
Tables\Columns\IconColumn::make('is_default')->label('Implicit')->boolean(),
Tables\Columns\IconColumn::make('is_active')->label('Activ')->boolean(),
Tables\Columns\TextColumn::make('batches_count')
->counts('batches')
->label('Loturi')
->alignRight(),
])
->actions([
Actions\EditAction::make(),
Actions\DeleteAction::make(),
])
->emptyStateHeading('Niciun depozit')
->emptyStateDescription('Un depozit implicit a fost creat la migrare. Adaugă altele dacă ai locații fizice separate (sucursală, hală, mobil).')
->emptyStateIcon('heroicon-o-building-storefront')
->defaultSort('code');
}
public static function getPages(): array
{
return [
'index' => Pages\ListWarehouses::route('/'),
'create' => Pages\CreateWarehouse::route('/create'),
'edit' => Pages\EditWarehouse::route('/{record}/edit'),
];
}
}
@@ -0,0 +1,11 @@
<?php
namespace App\Filament\Tenant\Resources\WarehouseResource\Pages;
use App\Filament\Tenant\Resources\WarehouseResource;
use Filament\Resources\Pages\CreateRecord;
class CreateWarehouse extends CreateRecord
{
protected static string $resource = WarehouseResource::class;
}
@@ -0,0 +1,17 @@
<?php
namespace App\Filament\Tenant\Resources\WarehouseResource\Pages;
use App\Filament\Tenant\Resources\WarehouseResource;
use Filament\Actions;
use Filament\Resources\Pages\EditRecord;
class EditWarehouse extends EditRecord
{
protected static string $resource = WarehouseResource::class;
protected function getHeaderActions(): array
{
return [Actions\DeleteAction::make()];
}
}
@@ -0,0 +1,17 @@
<?php
namespace App\Filament\Tenant\Resources\WarehouseResource\Pages;
use App\Filament\Tenant\Resources\WarehouseResource;
use Filament\Actions;
use Filament\Resources\Pages\ListRecords;
class ListWarehouses extends ListRecords
{
protected static string $resource = WarehouseResource::class;
protected function getHeaderActions(): array
{
return [Actions\CreateAction::make()];
}
}