TenantAtlas/apps/platform/app/Models/TenantReviewSection.php

<?php

declare(strict_types=1);

namespace App\Models;

use App\Support\TenantReviewCompletenessState;
use App\Support\Governance\Controls\ComplianceEvidenceMappingV1;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

class TenantReviewSection extends Model
{
    use HasFactory;

    protected $guarded = [];

    /**
     * @return array<string, string>
     */
    protected function casts(): array
    {
        return [
            'required' => 'boolean',
            'summary_payload' => 'array',
            'render_payload' => 'array',
            'measured_at' => 'datetime',
        ];
    }

    /**
     * @return BelongsTo<TenantReview, $this>
     */
    public function tenantReview(): BelongsTo
    {
        return $this->belongsTo(TenantReview::class);
    }

    /**
     * @return BelongsTo<Workspace, $this>
     */
    public function workspace(): BelongsTo
    {
        return $this->belongsTo(Workspace::class);
    }

    /**
     * @return BelongsTo<Tenant, $this>
     */
    public function tenant(): BelongsTo
    {
        return $this->belongsTo(Tenant::class);
    }

    /**
     * @param  Builder<self>  $query
     * @return Builder<self>
     */
    public function scopeRequired(Builder $query): Builder
    {
        return $query->where('required', true);
    }

    public function completenessEnum(): TenantReviewCompletenessState
    {
        return TenantReviewCompletenessState::tryFrom((string) $this->completeness_state)
            ?? TenantReviewCompletenessState::Missing;
    }

    public function isControlInterpretation(): bool
    {
        return (string) $this->section_key === ComplianceEvidenceMappingV1::SECTION_KEY;
    }

    /**
     * @return list<array<string, mixed>>
     */
    public function controlInterpretationEntries(): array
    {
        if (! $this->isControlInterpretation()) {
            return [];
        }

        $renderPayload = is_array($this->render_payload) ? $this->render_payload : [];
        $entries = $renderPayload['entries'] ?? [];

        return is_array($entries)
            ? array_values(array_filter($entries, static fn (mixed $entry): bool => is_array($entry)))
            : [];
    }
}