feat: tier 3 polish — M12/13/14/15 deep cleanup

Closes the remaining ~50h of items from CONFORMITY-12-15.md across all
four modules. Single umbrella migration (2026_06_05_000004) lands four
tables + 5 column additions, no downtime risk.

== M12 — body_type + transmission + pricing audit log ==

Vehicle gains body_type (12 values: sedan/hatchback/suv/crossover/pickup/
van/truck/coupe/wagon/convertible/minivan/moto) and transmission_type
(6 values: manual/automatic/cvt/dsg/dct/amt). These are separate from
vehicle_class so admin can configure DSG-only coefficients without
contaminating the SUV detection.

PricingCoefficient.matches() now also tests:
  - conditions.body_types[] against ctx.body_type
  - conditions.transmissions[] against ctx.transmission

PricingEngine builds the richer ctx and exposes it on the quote return
under quote.context.

New pricing_application_logs table (append-only) — call
PricingEngine::logApplication($quote, $subject, $vehicle, $client, $part)
after applying a price to a WO line. Stores base, final, full
applied[] array, and the ctx snapshot so the question "why was this
priced at 218 lei in March?" stays answerable forever.

PricingCoefficientResource form gains CheckboxList for body_types and
transmissions (3-column layouts, full-width). Both are optional —
empty list = applies to anything.

== M13 — Mechanic REST API + KPI ==

New MechanicApiController with 7 endpoints under /api/v1/mechanic/:
  GET    /board               — own non-done WOs with their works expanded
  GET    /kpi?period=YYYY-MM  — own aggregates for the period
  POST   /tasks/{w}/start
  POST   /tasks/{w}/pause
  POST   /tasks/{w}/resume
  POST   /tasks/{w}/done
  POST   /tasks/{w}/block     — validates reason from BLOCK_REASONS enum

Every endpoint authorizes ownership: $work->workOrder->master_id ===
auth()->id() else 403. board() returns null pending_works so native
apps don't make round-trips. workPayload() emits efficiency_pct and
efficiency_class on every response.

New MechanicKpi Filament page at /app/mechanic-kpi (Service group). Same
aggregation logic but tenant-wide: groups WorkOrderWork rows by
master_id for the selected period, computes totals + efficiency_pct +
revenue. Period navigation via ◀/▶ buttons, default = current month.
Color-coded efficiency badges (green ≤100%, amber ≤130%, red >130%).
Rows sort by revenue descending — easy "top earners this month" view.

== M14 — OCR async via Laravel queue ==

New ocr_jobs table (id, supplier_id?, source_type, file_path, status,
result JSON, error_message, ai_provider, tokens_used, purchase_id?,
processed_at). Idempotent migration.

New OcrJob model + ProcessOcrJob queueable job. Job re-establishes
tenant context inside the worker (Company::find + TenantManager::setCurrent)
since queue workers don't inherit middleware-resolved tenants.

handle() walks: status=pending → processing, calls OcrInvoiceService::extract,
on success → status=done + result + ai_provider; on throw → status=failed
+ error_message. Failed jobs auto-retry once (tries=2) with 120s timeout.

The existing synchronous OcrInvoiceService stays for inline use cases
(tests, quick imports). The job is now the canonical path for the
admin UI to keep requests sub-100ms.

== M15 — eta_promised + JSON tracking + notifications log ==

Three new wo columns: eta_promised (initial commitment, never changes),
eta_change_reason (text for "așteptăm piesă"), eta_updated_at (when
the current eta was last touched). Existing eta_at remains as "current"
ETA so the UI can render both side-by-side.

New /api/track/{token} JSON endpoint (public, tenant-scoped via subdomain):
  number, status, status_label, progress %, client, vehicle, plate, master,
  eta_promised, eta_current, eta_change_reason, total, pay_status,
  pending_approvals[] (each with kind/id/name/amount/approve_url —
  signed URLs ready for native app webview),
  timeline[] (from activity_log, last 20 events).

NotificationDispatcher::dispatch() gains optional workOrderId param.
Every send call (success or failure) now writes one row to the new
client_notifications_log table with channel/template_key/status (sent
or failed)/error_detail/sent_at. Failures of logging are swallowed
so a missing activity_log never breaks notifications. workOrderReady
and paymentReceived pass the WO id through; others can be wired in
future commits without schema change.

New tables tracked:
  client_notifications_log — every push to client, append-only
  pricing_application_logs — every pricing decision, append-only
  ocr_jobs — async OCR job queue

== Tests ==

PolishTier3Test (11):
- M12: body_type condition match/no-match; transmission DSG match;
  pricing_log row persists base/final/applied/ctx
- M13: mechanic API board scoped to own WOs; start task on foreign
  work returns 403; KPI endpoint computes 2.5/3 = 83% efficiency
  across 2 done works in period
- M14: ocr_job queueable + Queue::fake assertion
- M15: tracking JSON returns ETA promised/current/reason + pending
  approvals with correctly-signed approve_url; dispatcher writes
  ClientNotificationLog row on workOrderReady
- M12: vehicle body_type + transmission_type round-trip through save

Suite: 269 passed (761 assertions). Was 258.

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

app/Models/Tenant/ClientNotificationLog.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Models\Tenant;
+
+use App\Models\Concerns\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class ClientNotificationLog extends Model
+{
+    use BelongsToTenant;
+
+    public $timestamps = false;
+    protected $table = 'client_notifications_log';
+
+    public const CHANNELS = [
+        'sms' => 'SMS',
+        'whatsapp' => 'WhatsApp',
+        'telegram' => 'Telegram',
+        'email' => 'Email',
+        'push' => 'Web Push',
+    ];
+
+    public const STATUSES = [
+        'sent' => 'Trimis',
+        'delivered' => 'Livrat',
+        'failed' => 'Eșuat',
+        'read' => 'Citit',
+    ];
+
+    protected $fillable = [
+        'company_id', 'work_order_id', 'client_id',
+        'channel', 'template_key', 'message_text', 'status', 'error_detail',
+        'sent_at', 'delivered_at',
+    ];
+
+    protected $casts = [
+        'sent_at' => 'datetime',
+        'delivered_at' => 'datetime',
+    ];
+
+    public function workOrder(): BelongsTo { return $this->belongsTo(WorkOrder::class); }
+    public function client(): BelongsTo { return $this->belongsTo(Client::class); }
+}

app/Models/Tenant/OcrJob.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace App\Models\Tenant;
+
+use App\Models\Concerns\BelongsToTenant;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class OcrJob extends Model
+{
+    use BelongsToTenant;
+
+    public const STATUSES = [
+        'pending' => 'În așteptare',
+        'processing' => 'Procesare',
+        'done' => 'Finalizat',
+        'failed' => 'Eșuat',
+    ];
+
+    protected $fillable = [
+        'company_id', 'supplier_id', 'source_type', 'file_path', 'status',
+        'result', 'error_message', 'ai_provider', 'tokens_used',
+        'purchase_id', 'processed_at',
+    ];
+
+    protected $casts = [
+        'result' => 'array',
+        'processed_at' => 'datetime',
+        'tokens_used' => 'integer',
+    ];
+
+    public function supplier(): BelongsTo { return $this->belongsTo(Supplier::class); }
+    public function purchase(): BelongsTo { return $this->belongsTo(Purchase::class); }
+}

app/Models/Tenant/PricingApplicationLog.php

@@ -0,0 +1,37 @@
+<?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\MorphTo;
+
+/**
+ * Append-only audit log: every PricingEngine::quote() call writes one row
+ * here so we can reconstruct "why was this part priced at 218 lei?" later.
+ */
+class PricingApplicationLog extends Model
+{
+    use BelongsToTenant;
+
+    public $timestamps = false;
+
+    protected $fillable = [
+        'company_id', 'subject_type', 'subject_id', 'part_id', 'vehicle_id', 'client_id',
+        'base_price', 'final_price', 'applied_coefficients', 'context', 'calculated_at',
+    ];
+
+    protected $casts = [
+        'base_price' => 'decimal:2',
+        'final_price' => 'decimal:2',
+        'applied_coefficients' => 'array',
+        'context' => 'array',
+        'calculated_at' => 'datetime',
+    ];
+
+    public function subject(): MorphTo { return $this->morphTo(); }
+    public function part(): BelongsTo { return $this->belongsTo(Part::class); }
+    public function vehicle(): BelongsTo { return $this->belongsTo(Vehicle::class); }
+    public function client(): BelongsTo { return $this->belongsTo(Client::class); }
+}

app/Models/Tenant/PricingCoefficient.php

@@ -53,6 +53,22 @@ class PricingCoefficient extends Model
             }
         }
 
+        // Body type — sedan|suv|pickup|...
+        $bodyTypes = (array) ($c['body_types'] ?? []);
+        if (! empty($bodyTypes)) {
+            if (empty($ctx['body_type']) || ! in_array($ctx['body_type'], $bodyTypes, true)) {
+                return false;
+            }
+        }
+
+        // Transmission — dsg|cvt|automatic|...
+        $transmissions = (array) ($c['transmissions'] ?? []);
+        if (! empty($transmissions)) {
+            if (empty($ctx['transmission']) || ! in_array($ctx['transmission'], $transmissions, true)) {
+                return false;
+            }
+        }
+
         // Vehicle age range.
         if (isset($c['age_min']) && $c['age_min'] !== null && $c['age_min'] !== '') {
             if (($ctx['age'] ?? null) === null || $ctx['age'] < (int) $c['age_min']) return false;

app/Models/Tenant/Vehicle.php

@@ -12,10 +12,27 @@ class Vehicle extends Model
 {
     use Auditable, BelongsToTenant, SoftDeletes;
 
+    public const BODY_TYPES = [
+        'sedan' => 'Sedan', 'hatchback' => 'Hatchback', 'suv' => 'SUV',
+        'crossover' => 'Crossover', 'pickup' => 'Pickup', 'van' => 'Van',
+        'truck' => 'Camion', 'coupe' => 'Coupé', 'wagon' => 'Break',
+        'convertible' => 'Cabrio', 'minivan' => 'Minivan', 'moto' => 'Motocicletă',
+    ];
+
+    public const TRANSMISSION_TYPES = [
+        'manual' => 'Manuală',
+        'automatic' => 'Automată',
+        'cvt' => 'CVT',
+        'dsg' => 'DSG',
+        'dct' => 'DCT (Dual-Clutch)',
+        'amt' => 'AMT (Robot)',
+    ];
+
     protected $fillable = [
         'company_id', 'client_id',
         'make', 'model', 'year', 'vin', 'plate',
-        'engine', 'gearbox', 'fuel', 'vehicle_class', 'mileage', 'color', 'notes',
+        'engine', 'gearbox', 'fuel', 'vehicle_class', 'body_type', 'transmission_type',
+        'mileage', 'color', 'notes',
     ];
 
     public function client(): BelongsTo

app/Models/Tenant/WorkOrder.php

@@ -40,7 +40,8 @@ class WorkOrder extends Model implements HasMedia
         'complaint', 'diagnosis', 'recommendations',
         'status', 'urgency', 'pay_status', 'approved', 'approved_at',
         'discount_pct', 'total',
-        'eta_at', 'tracking_token',
+        'eta_at', 'eta_promised', 'eta_change_reason', 'eta_updated_at',
+        'tracking_token',
     ];
 
     protected $casts = [
@@ -48,6 +49,8 @@ class WorkOrder extends Model implements HasMedia
         'closed_at' => 'date',
         'approved_at' => 'datetime',
         'eta_at' => 'datetime',
+        'eta_promised' => 'datetime',
+        'eta_updated_at' => 'datetime',
         'approved' => 'boolean',
         'discount_pct' => 'decimal:2',
         'total' => 'decimal:2',