['en_route', 'cancelled', 'disputed'], 'en_route' => ['on_site', 'cancelled', 'disputed'], 'on_site' => ['in_progress', 'completed', 'disputed'], 'in_progress' => ['completed', 'disputed'], 'completed' => ['buyer_approved', 'disputed'], 'buyer_approved' => ['closed', 'disputed'], 'disputed' => ['closed'], 'closed' => [], 'cancelled' => [], ]; protected function casts(): array { return [ 'status_history' => 'array', 'scheduled_at' => 'datetime', 'checklist_items' => 'array', 'checklist_completed' => 'array', 'evidence_rules' => 'array', 'scope_snapshot' => 'array', 'contact_snapshot' => 'array', 'risk_flags' => 'array', 'change_requests' => 'array', 'en_route_at' => 'datetime', 'on_site_at' => 'datetime', 'started_at' => 'datetime', 'completed_at' => 'datetime', 'approved_at' => 'datetime', 'closed_at' => 'datetime', ]; } public function jobPost(): BelongsTo { return $this->belongsTo(JobPost::class); } public function buyer(): BelongsTo { return $this->belongsTo(User::class, 'buyer_id'); } public function provider(): BelongsTo { return $this->belongsTo(User::class, 'provider_id'); } public function acceptedQuote(): BelongsTo { return $this->belongsTo(Quote::class, 'accepted_quote_id'); } public function reviews(): HasMany { return $this->hasMany(Review::class); } public function disputes(): HasMany { return $this->hasMany(Dispute::class); } public function messages(): HasMany { return $this->hasMany(WorkOrderMessage::class); } public function attachments(): MorphMany { return $this->morphMany(Attachment::class, 'attachable'); } public function ratings(): MorphMany { return $this->morphMany(Rating::class, 'rateable'); } public function structuredChangeRequests(): HasMany { return $this->hasMany(WorkOrderChangeRequest::class); } public function contactEvents(): HasMany { return $this->hasMany(WorkOrderContactEvent::class); } public function providerTagVerification(): HasOne { return $this->hasOne(ProviderTagVerification::class); } public function canTransitionTo(string $status): bool { return in_array($status, self::ALLOWED_TRANSITIONS[$this->status] ?? [], true); } public function checklistItems(): array { if (is_array($this->checklist_items) && $this->checklist_items !== []) { return array_values(array_filter($this->checklist_items)); } return collect(preg_split('/\r\n|\r|\n/', (string) $this->deliverables_checklist)) ->map(fn (string $item): string => trim($item, " \t\n\r\0\x0B-[]")) ->filter() ->values() ->all(); } public function checklistCompleted(): array { return is_array($this->checklist_completed) ? $this->checklist_completed : []; } public function checklistProgress(): array { $items = $this->checklistItems(); $completed = $this->checklistCompleted(); $done = collect($items)->filter(fn (string $item): bool => (bool) ($completed[$item] ?? false))->count(); return [ 'done' => $done, 'total' => count($items), ]; } public function changeRequests(): array { $structured = $this->relationLoaded('structuredChangeRequests') ? $this->structuredChangeRequests : $this->structuredChangeRequests()->latest()->get(); if ($structured->isNotEmpty()) { return $structured ->map(fn (WorkOrderChangeRequest $request): array => [ 'id' => $request->id, 'summary' => $request->summary, 'details' => $request->details, 'reason_code' => $request->reason_code, 'reason_label' => WorkOrderChangeRequest::REASON_CODES[$request->reason_code] ?? $request->reason_code, 'scope_impact' => $request->scope_impact, 'schedule_impact' => $request->schedule_impact, 'terms_impact' => $request->terms_impact, 'requested_by_id' => $request->requester_id, 'requested_by_name' => $request->requester?->name, 'status' => $request->status, 'requested_at' => $request->created_at?->toIso8601String(), 'resolution_notes' => $request->resolution_notes, ]) ->values() ->all(); } return is_array($this->change_requests) ? array_values($this->change_requests) : []; } public function scopeSnapshotValue(string $key): ?string { $snapshot = is_array($this->scope_snapshot) ? $this->scope_snapshot : []; return $snapshot[$key] ?? $this->jobPost?->{$key}; } public function contactSnapshotValue(string $key): ?string { $snapshot = is_array($this->contact_snapshot) ? $this->contact_snapshot : []; return $snapshot[$key] ?? $this->jobPost?->{$key}; } public function contactFailureCount(): int { $events = $this->relationLoaded('contactEvents') ? $this->contactEvents : $this->contactEvents()->get(); return $events ->whereIn('event_type', ['contact_failed', 'support_unavailable', 'site_contact_unavailable']) ->count(); } public function technicianLevel(): array { $level = $this->scopeSnapshotValue('required_technician_level') ?? $this->jobPost?->required_technician_level ?? 1; return config('technician-levels')[(int) $level] ?? config('technician-levels')[1]; } }