Phases 201-205: Field Service Module — 18 tests passing

5 migrations (service_orders, service_order_items, service_checklists,
service_checklist_items, service_order_checklist_results), 5 models
(ServiceOrder with FS-YYYY-NNNNN numbering + start/complete/cancel workflow,
ServiceOrderItem, ServiceChecklist/Item, ChecklistResult), FieldServicePolicy,
3 controllers (Dashboard/Order/Checklist), 6 React pages (Dashboard, Orders
CRUD+Show with checklist, Checklists), Sidebar Field Service section.
18/18 feature tests passing.

https://claude.ai/code/session_01RdUGwo74JXChRCF88Yu27d

Author: claude

erp/app/Models/User.php

@@ -8,6 +8,7 @@
 use Illuminate\Contracts\Auth\MustVerifyEmail;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Foundation\Auth\User as Authenticatable;
 use Illuminate\Notifications\Notifiable;
 use Spatie\Permission\Traits\HasRoles;
@@ -50,6 +51,11 @@ public function tenant(): BelongsTo
         return $this->belongsTo(Tenant::class);
     }
 
+    public function assignedServiceOrders(): HasMany
+    {
+        return $this->hasMany(\App\Modules\FieldService\Models\ServiceOrder::class, 'assigned_to');
+    }
+
     public function getInitialsAttribute(): string
     {
         return collect(explode(' ', $this->name))

erp/app/Modules/Core/Providers/CoreServiceProvider.php

@@ -17,6 +17,7 @@
 use App\Modules\Accounting\Providers\AccountingServiceProvider;
 use App\Modules\Fleet\Providers\FleetServiceProvider;
 use App\Modules\Marketing\Providers\MarketingServiceProvider;
+use App\Modules\FieldService\Providers\FieldServiceProvider;
 use Illuminate\Support\Facades\Gate;
 use Illuminate\Support\ServiceProvider;
 
@@ -35,6 +36,7 @@ public function register(): void
         $this->app->register(AccountingServiceProvider::class);
         $this->app->register(FleetServiceProvider::class);
         $this->app->register(MarketingServiceProvider::class);
+        $this->app->register(FieldServiceProvider::class);
     }
 
     public function boot(): void

erp/app/Modules/FieldService/Http/Controllers/FieldServiceDashboardController.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Modules\FieldService\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Models\User;
+use App\Modules\FieldService\Models\ServiceOrder;
+use Inertia\Inertia;
+use Inertia\Response;
+
+class FieldServiceDashboardController extends Controller
+{
+    public function index(): Response
+    {
+        $pendingCount = ServiceOrder::where('status', 'pending')->count();
+
+        $inProgressCount = ServiceOrder::where('status', 'in_progress')->count();
+
+        $completedTodayCount = ServiceOrder::where('status', 'completed')
+            ->whereDate('completed_at', today())
+            ->count();
+
+        $overdueCount = ServiceOrder::where('scheduled_at', '<', now())
+            ->whereNotIn('status', ['completed', 'cancelled'])
+            ->count();
+
+        // Orders by technician breakdown
+        $technicianBreakdown = User::whereHas('assignedServiceOrders', function ($q) {
+            $q->whereNotIn('status', ['completed', 'cancelled']);
+        })
+            ->withCount(['assignedServiceOrders as active_orders_count' => function ($q) {
+                $q->whereNotIn('status', ['completed', 'cancelled']);
+            }])
+            ->orderByDesc('active_orders_count')
+            ->get(['id', 'name']);
+
+        $recentOrders = ServiceOrder::with('technician')
+            ->orderByDesc('created_at')
+            ->limit(10)
+            ->get();
+
+        return Inertia::render('FieldService/Dashboard', [
+            'stats' => [
+                'pending'        => $pendingCount,
+                'inProgress'     => $inProgressCount,
+                'completedToday' => $completedTodayCount,
+                'overdue'        => $overdueCount,
+            ],
+            'technicianBreakdown' => $technicianBreakdown,
+            'recentOrders'        => $recentOrders,
+        ]);
+    }
+}

erp/app/Modules/FieldService/Http/Controllers/ServiceChecklistController.php

@@ -0,0 +1,92 @@
+<?php
+
+namespace App\Modules\FieldService\Http\Controllers;
+
+use App\Http\Controllers\Controller;
+use App\Modules\FieldService\Models\ServiceChecklist;
+use Illuminate\Http\RedirectResponse;
+use Illuminate\Http\Request;
+use Inertia\Inertia;
+use Inertia\Response;
+
+class ServiceChecklistController extends Controller
+{
+    public function index(): Response
+    {
+        $checklists = ServiceChecklist::withCount('items')
+            ->orderBy('name')
+            ->get();
+
+        return Inertia::render('FieldService/Checklists/Index', [
+            'checklists' => $checklists,
+        ]);
+    }
+
+    public function store(Request $request): RedirectResponse
+    {
+        $validated = $request->validate([
+            'name'              => 'required|string|max:255',
+            'description'       => 'nullable|string',
+            'is_active'         => 'boolean',
+            'items'             => 'nullable|array',
+            'items.*.label'     => 'required_with:items|string|max:255',
+            'items.*.sequence'  => 'nullable|integer|min:0',
+        ]);
+
+        $checklist = ServiceChecklist::create([
+            'tenant_id'   => auth()->user()->tenant_id,
+            'name'        => $validated['name'],
+            'description' => $validated['description'] ?? null,
+            'is_active'   => $validated['is_active'] ?? true,
+        ]);
+
+        if (!empty($validated['items'])) {
+            foreach ($validated['items'] as $index => $item) {
+                $checklist->items()->create([
+                    'label'    => $item['label'],
+                    'sequence' => $item['sequence'] ?? $index,
+                ]);
+            }
+        }
+
+        return redirect()->back()->with('success', 'Checklist created.');
+    }
+
+    public function update(Request $request, ServiceChecklist $checklist): RedirectResponse
+    {
+        $validated = $request->validate([
+            'name'              => 'required|string|max:255',
+            'description'       => 'nullable|string',
+            'is_active'         => 'boolean',
+            'items'             => 'nullable|array',
+            'items.*.label'     => 'required_with:items|string|max:255',
+            'items.*.sequence'  => 'nullable|integer|min:0',
+        ]);
+
+        $checklist->update([
+            'name'        => $validated['name'],
+            'description' => $validated['description'] ?? null,
+            'is_active'   => $validated['is_active'] ?? $checklist->is_active,
+        ]);
+
+        // Sync items
+        $checklist->items()->delete();
+        if (!empty($validated['items'])) {
+            foreach ($validated['items'] as $index => $item) {
+                $checklist->items()->create([
+                    'label'    => $item['label'],
+                    'sequence' => $item['sequence'] ?? $index,
+                ]);
+            }
+        }
+
+        return redirect()->back()->with('success', 'Checklist updated.');
+    }
+
+    public function destroy(ServiceChecklist $checklist): RedirectResponse
+    {
+        $checklist->delete();
+
+        return redirect()->back()->with('success', 'Checklist deleted.');
+    }
+}