Faza 3.3: Depozit — Furnizori + Catalog piese + Achiziții

Schema: - suppliers: name, contact, phone/email/website, pay_terms, delivery_days, rating (1-5), discount_pct, categories (JSON), is_active, notes - parts: name, article (UNIQUE per tenant), brand, category, qty/unit/min_qty, buy_price/sell_price, location (rack/bin), barcode, preferred_supplier_id, is_active. Index pe (company_id, category) și (company_id, is_active). - purchases: număr unique per tenant + an, supplier_id, status workflow (draft/ordered/received/cancelled), order/expected/received/paid_at, total - purchase_items: name, article, qty, unit, buy_price, total auto, received bool; link opțional la part_id - wo_parts + part_id: linkare opțională la catalog (alter migration) Modele cu logică: - Part::adjustStock($delta) — modifică qty cu validare ≥ 0 - Part::isLow() / isOut() helpers - Purchase::markReceived() — atomic: marchează items ca received + creste qty pe pieces din catalog (DB::transaction) - WorkOrderPart::updating event — la trecerea status='installed' decrementează stoc auto. La revenire (ex: storno) incrementează la loc. - PurchaseItem::saving — total = qty * buy_price; recalc parent total Filament resources (group Depozit): - SupplierResource: form 3 secțiuni, rating ★★★★★, TagsInput pentru categorii - PartResource: form 4 secțiuni, badge nav cu nr. piese sub stoc minim, filtre low_stock + out_of_stock, coloană qty colorată după stoc - PurchaseResource: form antet + RelationManager Items. Action 'Recepționează' care apelează markReceived() — un click = stoc actualizat WorkOrder PartsRelationManager updated: - Selector din catalog (Part::active) cu stoc afișat - Auto-fill name/article/brand/unit/buy_price/sell_price din piesa selectată - Helper text: la status='installed' se scade din stoc Widget low-stock: - TableWidget pe dashboard tenant, listează piesele cu qty <= min_qty - Span full, sortat după qty (cele mai critice sus) Seed: - 2 furnizori (AutoParts Moldova SRL ★5, Inter Cars Moldova ★4) - 5 piese demo: Ulei Shell, Filtru Mann, Plăcuțe Brembo, Antigel (qty=0!), Bujii NGK - 1 achiziție recepționată (P-26-0001) cu 2 articole linked la catalog Total Filament tenant routes: 63 (de la 31).
2026-05-06 21:58:30 +00:00
parent 51a0bab39e
commit 7264dccffa
26 changed files with 1123 additions and 3 deletions
@@ -0,0 +1,55 @@
+<?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\SoftDeletes;
+
+class Part extends Model
+{
+    use BelongsToTenant, SoftDeletes;
+
+    public const CATEGORIES = [
+        'Ulei', 'Filtre', 'Frâne', 'Suspensie', 'Lichide',
+        'Distribuție', 'Anvelope', 'Electrică', 'Caroserie', 'Altele',
+    ];
+
+    protected $fillable = [
+        'company_id', 'name', 'article', 'brand', 'category',
+        'qty', 'unit', 'min_qty',
+        'buy_price', 'sell_price',
+        'location', 'barcode', 'preferred_supplier_id',
+        'is_active', 'notes',
+    ];
+
+    protected $casts = [
+        'qty' => 'decimal:2',
+        'min_qty' => 'decimal:2',
+        'buy_price' => 'decimal:2',
+        'sell_price' => 'decimal:2',
+        'is_active' => 'boolean',
+    ];
+
+    public function preferredSupplier(): BelongsTo
+    {
+        return $this->belongsTo(Supplier::class, 'preferred_supplier_id');
+    }
+
+    public function isLow(): bool
+    {
+        return (float) $this->qty <= (float) $this->min_qty;
+    }
+
+    public function isOut(): bool
+    {
+        return (float) $this->qty <= 0;
+    }
+
+    public function adjustStock(float $delta, ?string $reason = null): void
+    {
+        $this->qty = max(0, (float) $this->qty + $delta);
+        $this->save();
+    }
+}
@@ -0,0 +1,83 @@
+<?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\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class Purchase extends Model
+{
+    use BelongsToTenant, SoftDeletes;
+
+    public const STATUSES = [
+        'draft' => 'Ciornă',
+        'ordered' => 'Comandată',
+        'received' => 'Recepționată',
+        'cancelled' => 'Anulată',
+    ];
+
+    protected $fillable = [
+        'company_id', 'number', 'supplier_id',
+        'order_date', 'expected_at', 'received_at', 'paid_at',
+        'status', 'total', 'notes',
+    ];
+
+    protected $casts = [
+        'order_date' => 'date',
+        'expected_at' => 'date',
+        'received_at' => 'date',
+        'paid_at' => 'date',
+        'total' => 'decimal:2',
+    ];
+
+    public function supplier(): BelongsTo
+    {
+        return $this->belongsTo(Supplier::class);
+    }
+
+    public function items(): HasMany
+    {
+        return $this->hasMany(PurchaseItem::class);
+    }
+
+    public function recalcTotal(): void
+    {
+        $this->total = (float) $this->items()->sum('total');
+        $this->save();
+    }
+
+    public static function generateNumber(int $companyId): string
+    {
+        $year = date('y');
+        $count = static::withoutGlobalScopes()
+            ->where('company_id', $companyId)
+            ->whereYear('created_at', date('Y'))
+            ->count();
+        return sprintf('P-%s-%04d', $year, $count + 1);
+    }
+
+    /**
+     * Mark all items received and increment Part.qty for linked items.
+     */
+    public function markReceived(): void
+    {
+        \Illuminate\Support\Facades\DB::transaction(function () {
+            foreach ($this->items as $item) {
+                if (! $item->received) {
+                    if ($item->part_id) {
+                        $part = Part::find($item->part_id);
+                        $part?->adjustStock((float) $item->qty);
+                    }
+                    $item->received = true;
+                    $item->save();
+                }
+            }
+            $this->status = 'received';
+            $this->received_at = now();
+            $this->save();
+        });
+    }
+}
@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Models\Tenant;
+
+use App\Models\Concerns\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class PurchaseItem extends Model
+{
+    use BelongsToTenant;
+
+    protected $fillable = [
+        'company_id', 'purchase_id', 'part_id',
+        'name', 'article', 'qty', 'unit', 'buy_price', 'total', 'received',
+    ];
+
+    protected $casts = [
+        'qty' => 'decimal:2',
+        'buy_price' => 'decimal:2',
+        'total' => 'decimal:2',
+        'received' => 'boolean',
+    ];
+
+    public function purchase(): BelongsTo
+    {
+        return $this->belongsTo(Purchase::class);
+    }
+
+    public function part(): BelongsTo
+    {
+        return $this->belongsTo(Part::class);
+    }
+
+    protected static function booted(): void
+    {
+        static::saving(function (self $row) {
+            $row->total = round((float) $row->qty * (float) $row->buy_price, 2);
+        });
+        static::saved(fn (self $row) => $row->purchase?->recalcTotal());
+        static::deleted(fn (self $row) => $row->purchase?->recalcTotal());
+    }
+}
@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Models\Tenant;
+
+use App\Models\Concerns\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+use Illuminate\Database\Eloquent\SoftDeletes;
+
+class Supplier extends Model
+{
+    use BelongsToTenant, SoftDeletes;
+
+    protected $fillable = [
+        'company_id', 'name', 'contact_name', 'phone', 'email', 'website',
+        'pay_terms', 'delivery_days', 'rating', 'discount_pct',
+        'categories', 'is_active', 'notes',
+    ];
+
+    protected $casts = [
+        'categories' => 'array',
+        'is_active' => 'boolean',
+        'discount_pct' => 'decimal:2',
+    ];
+
+    public function purchases(): HasMany
+    {
+        return $this->hasMany(Purchase::class);
+    }
+
+    public function parts(): HasMany
+    {
+        return $this->hasMany(Part::class, 'preferred_supplier_id');
+    }
+}
@@ -20,7 +20,7 @@ class WorkOrderPart extends Model
    ];

    protected $fillable = [
-        'company_id', 'work_order_id',
+        'company_id', 'work_order_id', 'part_id',
        'name', 'article', 'brand',
        'qty', 'unit', 'buy_price', 'sell_price',
        'discount_pct', 'total', 'status', 'notes',
@@ -39,6 +39,11 @@ class WorkOrderPart extends Model
        return $this->belongsTo(WorkOrder::class);
    }

+    public function part(): BelongsTo
+    {
+        return $this->belongsTo(Part::class);
+    }
+
    protected static function booted(): void
    {
        static::saving(function (self $row) {
@@ -46,6 +51,22 @@ class WorkOrderPart extends Model
            $disc = (float) $row->discount_pct;
            $row->total = round($sub * (1 - $disc / 100), 2);
        });
+
+        // When a part is marked installed, decrement catalog stock once.
+        static::updating(function (self $row) {
+            $wasInstalled = $row->getOriginal('status') === 'installed';
+            $isInstalled = $row->status === 'installed';
+            if (! $wasInstalled && $isInstalled && $row->part_id) {
+                $part = Part::find($row->part_id);
+                $part?->adjustStock(-(float) $row->qty);
+            }
+            // If reverting from installed → restore stock
+            if ($wasInstalled && ! $isInstalled && $row->part_id) {
+                $part = Part::find($row->part_id);
+                $part?->adjustStock((float) $row->qty);
+            }
+        });
+
        static::saved(fn (self $row) => $row->workOrder?->recalcTotal());
        static::deleted(fn (self $row) => $row->workOrder?->recalcTotal());
    }