VerificationReport.php

<?php

namespace App\Models;

use App\Services\EmailTemplateService;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

/**
 * A verification or site-visit report filed by a staff member.
 *
 * Status transitions (staff-driven):
 *   DRAFT → SUBMITTED → APPROVED | REJECTED
 *
 * Model observer: when status changes to SUBMITTED or APPROVED, the client
 * receives an automated email via EmailTemplateService ('report-released' /
 * 'report-approved' slugs).
 */
class VerificationReport extends Model
{
    protected $fillable = [
        'order_id', 'project_id', 'staff_id',
        'summary', 'findings', 'recommendations',
        'status',       // DRAFT | SUBMITTED | APPROVED | REJECTED
        'attachments',
    ];

    protected $casts = [
        'attachments' => 'array',
    ];

    // ── Relationships ─────────────────────────────────────────────────────────

    public function order(): BelongsTo
    {
        return $this->belongsTo(VerificationOrder::class, 'order_id');
    }

    public function project(): BelongsTo
    {
        return $this->belongsTo(Project::class, 'project_id');
    }

    public function staff(): BelongsTo
    {
        return $this->belongsTo(Staff::class, 'staff_id');
    }

    // ── Observer ──────────────────────────────────────────────────────────────

    protected static function booted(): void
    {
        static::updated(function (VerificationReport $report) {
            // On status change to SUBMITTED or APPROVED, resolve the client
            // from $report->order()->with('client') and dispatch the
            // appropriate email template via EmailTemplateService
            // ...
        });
    }
}