Stage 6 — Purchase System: partial receipt + supplier analytics

Schema: - purchase_items.qty_received (backfilled from `received` boolean) - purchases.warehouse_id (target warehouse FK) - supplier_part_prices (price history per supplier/part with purchase ref) - New status `partial` between ordered and received Purchase ↔ Warehouse integration: - Purchase::receiveItem(item, qty, warehouse?) — routes through WarehouseService::receive: creates batch + receipt event + supplier price row - Purchase::receiveAllRemaining(warehouse?) — receives all outstanding lines - Purchase::recomputeStatus() — auto: ordered → partial → received Old flat markReceived() removed — every receipt now writes batches + ledger. Filament: - Purchase list: progress %, partial badge, warehouse picker on form - ItemsRelationManager: per-line "Recepționează" with qty + warehouse modal, qty_received shown as "X.XX / Y.YY" with colour - PartResource: new PriceHistoryRelationManager (supplier price history) - SupplierResource: derived columns onTimeRate / avgDeliveryDays / spend(90d) + "Rerating" action Analytics: - App\Services\Warehouse\SupplierAnalytics (onTimeRate, avgDeliveryDays, spend, count, computedRating) - `suppliers:rate` artisan command + weekly schedule (Mon 04:00) - Computed rating: 70% on-time + 20% volume + 10% speed bonus Tests (6 new, all pass): - Partial receipt of 3/10 → status=partial + 1 batch + 1 price row - receiveAllRemaining → status=received with received_at set - Over-receive throws InvalidArgumentException - Two partial receipts (4+6) → 2 batches FIFO + status=received - onTimeRate 50% with 1 on-time + 1 late - computedRating null when <2 deliveries Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-27 19:37:12 +00:00
parent 426156fe45
commit a2026f640a
14 changed files with 676 additions and 28 deletions
@@ -0,0 +1,51 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\Central\Company;
+use App\Models\Tenant\Supplier;
+use App\Services\Warehouse\SupplierAnalytics;
+use App\Tenancy\TenantManager;
+use Illuminate\Console\Command;
+
+class RateSuppliersCommand extends Command
+{
+    protected $signature = 'suppliers:rate
+                            {--days=90 : Look-back window in days}
+                            {--slug= : Only one tenant by slug}';
+
+    protected $description = 'Recompute auto-rating for every supplier based on on-time deliveries, speed and volume.';
+
+    public function handle(SupplierAnalytics $analytics): int
+    {
+        $query = Company::query()->where('status', '!=', 'archived');
+        if ($slug = $this->option('slug')) {
+            $query->where('slug', $slug);
+        }
+        $companies = $query->get();
+        $days = (int) $this->option('days');
+
+        $totalUpdated = 0;
+
+        foreach ($companies as $company) {
+            app(TenantManager::class)->setCurrent($company);
+
+            $suppliers = Supplier::where('is_active', true)->get();
+            $changed = 0;
+            foreach ($suppliers as $supplier) {
+                $score = $analytics->computedRating($supplier, $days);
+                if ($score !== null && $score !== (int) $supplier->rating) {
+                    $supplier->rating = $score;
+                    $supplier->saveQuietly();
+                    $changed++;
+                }
+            }
+
+            $this->info(sprintf('[%s] suppliers rated, %d updated', $company->slug, $changed));
+            $totalUpdated += $changed;
+        }
+
+        $this->info("Total suppliers updated: {$totalUpdated}");
+        return self::SUCCESS;
+    }
+}