Stage 12 — Online Store: public catalog + cart + orders

Schema:
- online_orders (token-tracked, status workflow, delivery method/fee)
- online_order_items (price snapshot, fulfilled flag)
- part_cross_refs (OEM/equivalent codes for search)
- parts.is_published (shop visibility)

Storefront (ShopController, tenant subdomain, /shop):
- Catalog with search across name/article/brand/cross-refs, category +
  in-stock filters, live stock, white-label themed layout
- Part detail page with cross-ref codes
- VIN search → VinDecoder → guided catalog search
- Session cart (per-tenant key), guest checkout, order confirmation page
- Respects settings.shop.enabled (404 when off); tenant-guarded

Part::searchPublished matches cross-ref articles via whereHas.

Order notifications (ShopOrderNotifier, best-effort):
- Staff: Web Push to active users
- Customer: Telegram if phone matches a linked client

Filament (tenant):
- OnlineOrderResource under "Magazin" nav group, status workflow,
  items relation, "Onorează" action issues stock via WarehouseService (FIFO)
- PartResource: is_published toggle + column + bulk publish/unpublish +
  CrossRefsRelationManager
- Settings: shop section (enable, delivery methods, fee, free-over)
- Landing page: shop button when enabled

Tests (6 new):
- catalog 404 when disabled; lists published only; cross-ref search;
  order placement (token + items + total); fulfill issues stock;
  cross-tenant token isolation

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

app/Models/Tenant/OnlineOrder.php

@@ -0,0 +1,84 @@
+<?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;
+use Illuminate\Support\Str;
+
+class OnlineOrder extends Model
+{
+    use BelongsToTenant, SoftDeletes;
+
+    public const STATUSES = [
+        'new' => 'Nouă',
+        'confirmed' => 'Confirmată',
+        'packed' => 'Pregătită',
+        'shipped' => 'Expediată',
+        'delivered' => 'Livrată',
+        'cancelled' => 'Anulată',
+    ];
+
+    public const DELIVERY = [
+        'pickup' => 'Ridicare din service',
+        'courier' => 'Curier',
+        'post' => 'Poștă',
+    ];
+
+    protected $fillable = [
+        'company_id', 'number', 'tracking_token', 'client_id',
+        'customer_name', 'customer_phone', 'customer_email',
+        'delivery_method', 'address', 'status',
+        'subtotal', 'delivery_fee', 'total', 'notes',
+    ];
+
+    protected $casts = [
+        'subtotal' => 'decimal:2',
+        'delivery_fee' => 'decimal:2',
+        'total' => 'decimal:2',
+    ];
+
+    public function items(): HasMany
+    {
+        return $this->hasMany(OnlineOrderItem::class);
+    }
+
+    public function client(): BelongsTo
+    {
+        return $this->belongsTo(Client::class);
+    }
+
+    public function trackingUrl(): string
+    {
+        return url('/shop/order/' . $this->tracking_token);
+    }
+
+    public function recalcTotal(): void
+    {
+        $this->subtotal = (float) $this->items()->sum('total');
+        $this->total = round((float) $this->subtotal + (float) $this->delivery_fee, 2);
+        $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('SO-%s-%04d', $year, $count + 1);
+    }
+
+    protected static function booted(): void
+    {
+        static::creating(function (self $o) {
+            if (empty($o->tracking_token)) {
+                $o->tracking_token = Str::random(24);
+            }
+        });
+    }
+}

app/Models/Tenant/OnlineOrderItem.php

@@ -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 OnlineOrderItem extends Model
+{
+    use BelongsToTenant;
+
+    protected $fillable = [
+        'company_id', 'online_order_id', 'part_id',
+        'name', 'article', 'qty', 'price', 'total', 'fulfilled',
+    ];
+
+    protected $casts = [
+        'qty' => 'decimal:2',
+        'price' => 'decimal:2',
+        'total' => 'decimal:2',
+        'fulfilled' => 'boolean',
+    ];
+
+    public function order(): BelongsTo
+    {
+        return $this->belongsTo(OnlineOrder::class, 'online_order_id');
+    }
+
+    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->price, 2);
+        });
+        static::saved(fn (self $row) => $row->order?->recalcTotal());
+        static::deleted(fn (self $row) => $row->order?->recalcTotal());
+    }
+}

app/Models/Tenant/Part.php

@@ -22,7 +22,7 @@ class Part extends Model
         'qty', 'qty_reserved', 'unit', 'min_qty',
         'buy_price', 'sell_price',
         'location', 'barcode', 'preferred_supplier_id',
-        'is_active', 'notes',
+        'is_active', 'is_published', 'notes',
     ];
 
     protected $casts = [
@@ -32,6 +32,7 @@ class Part extends Model
         'buy_price' => 'decimal:2',
         'sell_price' => 'decimal:2',
         'is_active' => 'boolean',
+        'is_published' => 'boolean',
     ];
 
     public function preferredSupplier(): BelongsTo
@@ -59,6 +60,35 @@ class Part extends Model
         return $this->hasMany(SupplierPartPrice::class);
     }
 
+    public function crossRefs(): HasMany
+    {
+        return $this->hasMany(PartCrossRef::class);
+    }
+
+    public function scopePublished($q)
+    {
+        return $q->where('is_active', true)->where('is_published', true);
+    }
+
+    /**
+     * Search published parts by free text against name / article / brand and
+     * any registered cross-reference article. Returns a query builder.
+     */
+    public static function searchPublished(?string $term)
+    {
+        $q = static::published();
+        if ($term = trim((string) $term)) {
+            $like = '%' . $term . '%';
+            $q->where(function ($w) use ($like, $term) {
+                $w->where('name', 'like', $like)
+                  ->orWhere('article', 'like', $like)
+                  ->orWhere('brand', 'like', $like)
+                  ->orWhereHas('crossRefs', fn ($c) => $c->where('cross_article', 'like', $like));
+            });
+        }
+        return $q;
+    }
+
     /** Live total across all batches of all warehouses (source of truth). */
     public function qtyOnHand(?int $warehouseId = null): float
     {

app/Models/Tenant/PartCrossRef.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Models\Tenant;
+
+use App\Models\Concerns\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class PartCrossRef extends Model
+{
+    use BelongsToTenant;
+
+    protected $fillable = ['company_id', 'part_id', 'cross_article', 'brand'];
+
+    public function part(): BelongsTo
+    {
+        return $this->belongsTo(Part::class);
+    }
+}