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

<?php

declare(strict_types=1);

namespace App\Support\Health\Checks;

use App\Models\Page;
use App\Models\Project;
use App\Support\Health\Check;
use App\Support\Health\Finding;

/**
 * Published work with nothing for a search result or a shared link to show.
 *
 * Without `meta_description` the frontend has nothing to put in the meta tag
 * and the snippet gets invented from the body; without a cover there is no
 * image when the link is pasted into a chat. For a collective whose whole
 * point is being found and shared, that is the difference between a project
 * being read and being scrolled past.
 */
class IncompleteSeo implements Check
{
    public function key(): string
    {
        return 'incomplete-seo';
    }

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

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

        foreach (Project::query()->published()->get(['id', 'title', 'meta_description', 'cover_image']) as $project) {
            $missing = [];

            if (blank($project->getTranslation('meta_description', $default, false))) {
                $missing[] = __('health.bits.description');
            }

            if (blank($project->cover_image)) {
                $missing[] = __('health.bits.cover');
            }

            if ($missing === []) {
                continue;
            }

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

        foreach (Page::query()->published()->get(['id', 'title', 'meta_description']) as $page) {
            if (filled($page->getTranslation('meta_description', $default, false))) {
                continue;
            }

            $count++;
            $samples[] = $page->getTranslation('title', $default, false).' ('.__('health.bits.description').')';
        }

        return Finding::problem($this->key(), $count, samples: $samples);
    }
}