landing-api/app/Support/Health/Checks/MissingTranslations.php

<?php

declare(strict_types=1);

namespace App\Support\Health\Checks;

use App\Filament\Resources\Pages\PageResource;
use App\Models\Call;
use App\Models\Page;
use App\Models\Project;
use App\Support\Health\Check;
use App\Support\Health\Finding;
use Illuminate\Database\Eloquent\Builder;

/**
 * Published content with no title in one of the supported languages.
 *
 * The site does not break — the API simply omits that language from the
 * record's `alternates` — but a visitor browsing in Catalan finds the section
 * half empty and no one editing in Spanish ever sees it.
 */
class MissingTranslations implements Check
{
    public function key(): string
    {
        return 'missing-translations';
    }

    public function permission(): ?string
    {
        return null;
    }

    public function run(): Finding
    {
        $locales = array_keys((array) config('locales.supported'));
        $count = 0;
        $samples = [];

        foreach ([Page::class, Project::class, Call::class] as $model) {
            $records = $model::query()
                ->when($model === Call::class, fn (Builder $q) => $q->open())
                ->unless($model === Call::class, fn (Builder $q) => $q->published())
                ->get(['id', 'title']);

            foreach ($records as $record) {
                $missing = collect($locales)
                    ->reject(fn (string $locale) => filled($record->getTranslation('title', $locale, false)));

                if ($missing->isEmpty()) {
                    continue;
                }

                $count++;
                $samples[] = $record->getTranslation('title', (string) config('locales.default'), false)
                    .' ('.$missing->implode(', ').')';
            }
        }

        return Finding::problem(
            $this->key(),
            $count,
            url: PageResource::getUrl('index'),
            samples: $samples,
        );
    }
}