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,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();
+        });
+    }
+}