# Схема генерации контента: план реализации

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Вынести промпты, модель и параметры генерации текстов из `GenerateTextJob` в редактируемые настройки Filament с возможностью переопределить модель и промпт на уровне проекта.

**Architecture:** Провайдер выбирается именем модели (`gpt-4.1`, `xai:grok-4`) — `AiClients` роутит запрос нужному клиенту по префиксу из `config/ai.php`. `AiService` инкапсулирует общение с моделью (стриминг, ретраи, чистка HTML, подстановка `{переменных}`), `GenerationSettings` (spatie/laravel-settings) хранит промпты и параметры, `TrustedLinksResolver` — подбор трастовых ссылок. `GenerateTextJob` становится тонким оркестратором.

**Tech Stack:** Laravel 11, Filament 3, openai-php/laravel 0.18, spatie/laravel-settings 3.x, filament/spatie-laravel-settings-plugin 3.x, PHPUnit 11, Horizon/Redis.

**Спека:** `docs/superpowers/specs/2026-07-30-content-generation-settings-design.md`

---

## Структура файлов

**Создаются:**

| Файл | Ответственность |
| --- | --- |
| `config/ai.php` | Список дополнительных провайдеров (base_uri + ключ) |
| `app/Services/Ai/AiClients.php` | Какому клиенту уходит запрос для данной модели |
| `app/Services/Ai/AiService.php` | Общение с моделью: стриминг, ретраи, промпты, чистка HTML |
| `app/Exceptions/AiException.php` | Ошибка обращения к модели |
| `app/Settings/GenerationSettings.php` | Схема настроек генерации |
| `database/settings/2026_07_30_120000_create_generation_settings.php` | Дефолты настроек (= текущие захардкоженные промпты) |
| `app/Services/TrustedLinksResolver.php` | Подбор трастовых ссылок по теме/языку |
| `app/Filament/Pages/ManageGenerationSettings.php` | Страница настроек генерации |
| `database/migrations/2026_07_30_130000_add_generation_overrides_to_projects_table.php` | `ai_model`, `text_prompt` у проекта |
| `tests/Feature/Ai/AiClientsTest.php` | Роутинг моделей по провайдерам |
| `tests/Feature/Ai/AiServiceTest.php` | Чистые методы `AiService` |
| `tests/Unit/Services/TrustedLinksResolverTest.php` | Приоритет файлов и лимит ссылок |

**Меняются:**

| Файл | Что |
| --- | --- |
| `composer.json` | Два новых пакета |
| `config/settings.php` (публикуется) | Регистрация `GenerationSettings` |
| `app/Jobs/GenerateTextJob.php` | Ужимается до оркестрации (~70 строк вместо 240) |
| `app/Models/Project.php` | `$fillable` += `ai_model`, `text_prompt` |
| `app/Filament/Resources/ProjectResource.php` | Секция «Генерация» |
| `.env.example` | Ключи провайдеров |

**Ветка:** вся работа идёт в `feature/generation-settings`, коммиты после каждой задачи.

---

### Task 0: Ветка и коммит спеки

**Files:**
- Commit: `docs/superpowers/specs/2026-07-30-content-generation-settings-design.md`, `docs/superpowers/plans/2026-07-30-content-generation-settings.md`

- [ ] **Step 1: Создать ветку**

```bash
git checkout -b feature/generation-settings
```

- [ ] **Step 2: Закоммитить спеку и план**

```bash
git add docs/superpowers
git commit -m "docs: спека и план схемы генерации контента"
```

---

### Task 1: Пакеты настроек

**Files:**
- Modify: `composer.json`, `composer.lock`
- Create: `config/settings.php` (публикация), `database/migrations/*_create_settings_table.php` (публикация)

- [ ] **Step 1: Поставить пакеты**

```bash
composer require spatie/laravel-settings:"^3.6" filament/spatie-laravel-settings-plugin:"^3.0"
```

Ожидаемо: оба пакета встают без конфликтов (плагин v3 совместим с Filament 3 и spatie settings ^2.2|^3.0).

- [ ] **Step 2: Опубликовать конфиг и миграцию**

```bash
php artisan vendor:publish --provider="Spatie\LaravelSettings\LaravelSettingsServiceProvider" --tag="config"
php artisan vendor:publish --provider="Spatie\LaravelSettings\LaravelSettingsServiceProvider" --tag="migrations"
```

Появятся `config/settings.php` и `database/migrations/2022_12_14_083707_create_settings_table.php`.

- [ ] **Step 3: Создать каталог для миграций настроек**

```bash
mkdir -p database/settings
```

- [ ] **Step 4: Прогнать миграции**

```bash
php artisan migrate
```

Ожидаемо: создана таблица `settings`.

- [ ] **Step 5: Коммит**

```bash
git add composer.json composer.lock config/settings.php database/migrations
git commit -m "chore: подключить spatie/laravel-settings и Filament-плагин настроек"
```

---

### Task 2: Конфиг провайдеров и `AiClients`

**Files:**
- Create: `config/ai.php`, `app/Services/Ai/AiClients.php`, `tests/Feature/Ai/AiClientsTest.php`
- Modify: `.env.example`

- [ ] **Step 1: Написать падающий тест**

Создать `tests/Feature/Ai/AiClientsTest.php`:

```php
<?php

namespace Tests\Feature\Ai;

use App\Services\Ai\AiClients;
use Tests\TestCase;

class AiClientsTest extends TestCase
{
    public function test_bare_model_goes_to_the_default_client(): void
    {
        $clients = app(AiClients::class);

        $this->assertNull($clients->providerOf('gpt-4.1'));
        $this->assertSame('gpt-4.1', $clients->modelName('gpt-4.1'));
    }

    public function test_prefixed_model_is_routed_to_its_provider(): void
    {
        config()->set('ai.providers.xai', [
            'label' => 'xAI (Grok)',
            'base_uri' => 'api.x.ai/v1',
            'api_key' => 'test-key',
        ]);

        $clients = app(AiClients::class);

        $this->assertSame('xai', $clients->providerOf('xai:grok-4'));
        $this->assertSame('grok-4', $clients->modelName('xai:grok-4'));
    }

    public function test_unknown_prefix_is_not_treated_as_a_provider(): void
    {
        $clients = app(AiClients::class);

        $this->assertNull($clients->providerOf('foo:bar'));
        $this->assertSame('foo:bar', $clients->modelName('foo:bar'));
    }

    public function test_labels_come_from_config(): void
    {
        config()->set('ai.providers', [
            'xai' => ['label' => 'xAI (Grok)', 'base_uri' => 'api.x.ai/v1', 'api_key' => null],
            'deepseek' => ['base_uri' => 'api.deepseek.com/v1', 'api_key' => null],
        ]);

        $this->assertSame(
            ['xai' => 'xAI (Grok)', 'deepseek' => 'deepseek'],
            app(AiClients::class)->labels()
        );
    }

    public function test_provider_without_api_key_throws(): void
    {
        config()->set('ai.providers.xai', [
            'label' => 'xAI (Grok)',
            'base_uri' => 'api.x.ai/v1',
            'api_key' => null,
        ]);

        $this->expectException(\RuntimeException::class);

        app(AiClients::class)->for('xai:grok-4');
    }
}
```

- [ ] **Step 2: Убедиться, что тест падает**

```bash
php artisan test --filter=AiClientsTest
```

Ожидаемо: FAIL, `Class "App\Services\Ai\AiClients" does not exist`.

- [ ] **Step 3: Создать `config/ai.php`**

```php
<?php

return [
    /*
     | Дополнительные чат-провайдеры. Адресуются как "provider:model"
     | (например, `xai:grok-4`) везде, где принимается имя модели. Голое имя
     | модели — `gpt-4.1` — уходит в дефолтный OpenAI-клиент.
     |
     | Все они говорят по протоколу OpenAI chat-completions, поэтому отличаются
     | только базовым URI и ключом. Новый провайдер = новая строка здесь.
     */
    'providers' => [
        'xai' => [
            'label' => 'xAI (Grok)',
            'base_uri' => env('XAI_BASE_URL', 'api.x.ai/v1'),
            'api_key' => env('XAI_API_KEY'),
        ],

        'deepseek' => [
            'label' => 'DeepSeek',
            'base_uri' => env('DEEPSEEK_BASE_URL', 'api.deepseek.com/v1'),
            'api_key' => env('DEEPSEEK_API_KEY'),
        ],

        'openrouter' => [
            'label' => 'OpenRouter',
            'base_uri' => env('OPENROUTER_BASE_URL', 'openrouter.ai/api/v1'),
            'api_key' => env('OPENROUTER_API_KEY'),
        ],
    ],
];
```

- [ ] **Step 4: Создать `app/Services/Ai/AiClients.php`**

```php
<?php

namespace App\Services\Ai;

use OpenAI;
use OpenAI\Contracts\ClientContract;

/**
 * Определяет, какому чат-провайдеру принадлежит имя модели.
 *
 * Модель может быть записана как "provider:model" (например, `xai:grok-4`) —
 * тогда запрос уходит этому провайдеру из config/ai.php; голое имя продолжает
 * использовать дефолтный OpenAI-клиент. Все провайдеры говорят по протоколу
 * OpenAI chat-completions, поэтому меняются только базовый URI и ключ.
 *
 * Префикс учитывается ТОЛЬКО если он называет настроенного провайдера, так что
 * имя модели, в котором просто встретилось двоеточие, ни с чем не спутается.
 */
class AiClients
{
    /** @var array<string, ClientContract> */
    protected array $clients = [];

    /** Клиент, которому надо отправить запрос для этой модели. */
    public function for(?string $model): ClientContract
    {
        $provider = $this->providerOf($model);

        if ($provider === null) {
            // Дефолтный клиент, зарегистрированный openai-php/laravel —
            // НЕ фасад OpenAI, у него нет facade root в этом контексте.
            return app(ClientContract::class);
        }

        return $this->clients[$provider] ??= $this->build($provider);
    }

    /** Имя модели в том виде, в каком его знает провайдер (без префикса). */
    public function modelName(?string $model): ?string
    {
        $provider = $this->providerOf($model);

        return $provider === null ? $model : substr((string) $model, strlen($provider) + 1);
    }

    /** Настроенный провайдер этой модели или null для дефолтного клиента. */
    public function providerOf(?string $model): ?string
    {
        if (! $model || ! str_contains($model, ':')) {
            return null;
        }

        $prefix = strtok($model, ':');

        return is_string($prefix) && array_key_exists($prefix, (array) config('ai.providers'))
            ? $prefix
            : null;
    }

    /** @return array<string, string> ключ провайдера => человекочитаемая метка */
    public function labels(): array
    {
        $out = [];

        foreach ((array) config('ai.providers') as $key => $provider) {
            $out[$key] = $provider['label'] ?? $key;
        }

        return $out;
    }

    protected function build(string $provider): ClientContract
    {
        $config = (array) config("ai.providers.{$provider}");

        if (blank($config['api_key'] ?? null)) {
            throw new \RuntimeException("Не настроен API-ключ для AI-провайдера [{$provider}].");
        }

        return OpenAI::factory()
            ->withApiKey($config['api_key'])
            ->withBaseUri($config['base_uri'])
            ->make();
    }
}
```

- [ ] **Step 5: Прогнать тест**

```bash
php artisan test --filter=AiClientsTest
```

Ожидаемо: PASS, 5 тестов.

- [ ] **Step 6: Дописать ключи в `.env.example`**

Добавить в конец файла:

```
XAI_API_KEY=
DEEPSEEK_API_KEY=
OPENROUTER_API_KEY=
```

- [ ] **Step 7: Коммит**

```bash
git add config/ai.php app/Services/Ai/AiClients.php tests/Feature/Ai/AiClientsTest.php .env.example
git commit -m "feat: роутинг моделей по провайдерам через provider:model"
```

---

### Task 3: `GenerationSettings` и миграция настроек

**Files:**
- Create: `app/Settings/GenerationSettings.php`, `database/settings/2026_07_30_120000_create_generation_settings.php`
- Modify: `config/settings.php`

Дефолты промптов — дословно текущие строки из `app/Jobs/GenerateTextJob.php`, с заменой PHP-интерполяции на `{переменные}`. Поведение после миграции не меняется.

- [ ] **Step 1: Создать `app/Settings/GenerationSettings.php`**

```php
<?php

namespace App\Settings;

use Spatie\LaravelSettings\Settings;

class GenerationSettings extends Settings
{
    /** Модель генерации текста: `gpt-4.1` или `provider:model`. */
    public string $contentModel;

    /** Модель для ключевых слов; пусто — та же, что для текста. */
    public ?string $keywordsModel;

    /** Температура; для reasoning-моделей (gpt-5*, o1*, o3*, o4*) игнорируется. */
    public float $temperature;

    public string $systemPromptContent;

    public string $systemPromptKeywords;

    public string $textPrompt;

    public string $keywordsPrompt;

    public bool $trustedLinksEnabled;

    public int $trustedLinksCount;

    public static function group(): string
    {
        return 'generation';
    }

    /** Модель для ключевых слов с откатом на модель контента. */
    public function effectiveKeywordsModel(): string
    {
        return $this->keywordsModel ?: $this->contentModel;
    }

    /**
     * Переменные промптов для подсказок в формах.
     *
     * @return array<string, array<string, string>>
     */
    public static function getAvailableVariables(): array
    {
        return [
            'text' => [
                '{project}' => 'Название проекта',
                '{topic}' => 'Тематика проекта',
                '{keywords}' => 'Сгенерированные ключевые слова',
                '{length}' => 'Длина текста',
                '{language}' => 'Язык ссылки (ru/en/uk)',
                '{link_url}' => 'URL основной ссылки',
                '{link_anchor}' => 'Анкор основной ссылки',
                '{trusted_links}' => 'Блок трастовых ссылок',
                '{trusted_links_count}' => 'Сколько трастовых ссылок вставлено',
            ],
            'keywords' => [
                '{topic}' => 'Тематика проекта',
                '{language}' => 'Язык ссылки (ru/en/uk)',
            ],
        ];
    }
}
```

- [ ] **Step 2: Зарегистрировать класс в `config/settings.php`**

В массиве `settings` заменить пустой список на:

```php
    'settings' => [
        App\Settings\GenerationSettings::class,
    ],
```

- [ ] **Step 3: Создать `database/settings/2026_07_30_120000_create_generation_settings.php`**

```php
<?php

use Spatie\LaravelSettings\Migrations\SettingsMigration;

return new class extends SettingsMigration
{
    public function up(): void
    {
        $this->migrator->add('generation.contentModel', 'gpt-4.1');
        $this->migrator->add('generation.keywordsModel', null);
        $this->migrator->add('generation.temperature', 1.0);

        $this->migrator->add('generation.systemPromptContent', 'Ты SEO-копирайтер. Пиши HTML код SEO-оптимизированного контента.');
        $this->migrator->add('generation.systemPromptKeywords', 'Ты SEO-специалист. Отвечай только ключевыми словами.');

        $this->migrator->add('generation.textPrompt', <<<'PROMPT'
Сгенерируй SEO-текст на тему "{keywords}", длиной около {length} !слов!.
Обязательно используй следующие ключевые слова: {keywords}.
Пиши текст в новостном стиле, саму новость просто придумай что то уникальное и не повторяйся.
Текст должен начинаться с заголовка <h1> и параграфа после него, а структура (h2, h3, h4) тоже должна использовать "{keywords}".
Вставь органично в текст !!!одну!!! основную ссылку: <a href="{link_url}">{link_anchor}</a> (не в заголовок).
Также вставь эти {trusted_links_count} ссылки но органично в контенте страницы в разных местах, без изменения текста, без анкора но в теге <a>
и в разных местах в тексте а не вместе (что то по типу вот информация и тд):

{trusted_links}

Не используй <body>, <html>, <em>, <strong>, курсив.
Прислать только HTML.
Язык: {language}.
PROMPT);

        $this->migrator->add('generation.keywordsPrompt', <<<'PROMPT'
Ты SEO-спец. Придумай 6-7 высокочастотных ключевых слов по теме "{topic}".
Только список через запятую. Без нумерации.
Язык: {language}.
PROMPT);

        $this->migrator->add('generation.trustedLinksEnabled', true);
        $this->migrator->add('generation.trustedLinksCount', 2);
    }

    public function down(): void
    {
        $this->migrator->deleteIfExists('generation.contentModel');
        $this->migrator->deleteIfExists('generation.keywordsModel');
        $this->migrator->deleteIfExists('generation.temperature');
        $this->migrator->deleteIfExists('generation.systemPromptContent');
        $this->migrator->deleteIfExists('generation.systemPromptKeywords');
        $this->migrator->deleteIfExists('generation.textPrompt');
        $this->migrator->deleteIfExists('generation.keywordsPrompt');
        $this->migrator->deleteIfExists('generation.trustedLinksEnabled');
        $this->migrator->deleteIfExists('generation.trustedLinksCount');
    }
};
```

- [ ] **Step 4: Прогнать миграцию**

```bash
php artisan migrate
```

- [ ] **Step 5: Проверить, что настройки читаются**

```bash
php artisan tinker --execute="echo app(App\Settings\GenerationSettings::class)->contentModel;"
```

Ожидаемо: `gpt-4.1`.

- [ ] **Step 6: Коммит**

```bash
git add app/Settings config/settings.php database/settings
git commit -m "feat: настройки генерации с текущими промптами в дефолтах"
```

---

### Task 4: `AiException` и `AiService`

**Files:**
- Create: `app/Exceptions/AiException.php`, `app/Services/Ai/AiService.php`, `tests/Feature/Ai/AiServiceTest.php`

Тесты покрывают только чистые методы — в API не ходим.

- [ ] **Step 1: Написать падающий тест**

Создать `tests/Feature/Ai/AiServiceTest.php`:

```php
<?php

namespace Tests\Feature\Ai;

use App\Services\Ai\AiService;
use App\Settings\GenerationSettings;
use Tests\TestCase;

class AiServiceTest extends TestCase
{
    protected function service(array $overrides = []): AiService
    {
        GenerationSettings::fake(array_merge([
            'contentModel' => 'gpt-4.1',
            'keywordsModel' => null,
            'temperature' => 1.0,
            'systemPromptContent' => 'system content',
            'systemPromptKeywords' => 'system keywords',
            'textPrompt' => 'Тема {topic}, ключи {keywords}',
            'keywordsPrompt' => 'Ключи по теме {topic} на языке {language}',
            'trustedLinksEnabled' => true,
            'trustedLinksCount' => 2,
        ], $overrides));

        return app(AiService::class);
    }

    public function test_replaces_variables(): void
    {
        $result = $this->service()->replaceVariables(
            'Тема {topic}, язык {language}',
            ['topic' => 'казино', 'language' => 'ru']
        );

        $this->assertSame('Тема казино, язык ru', $result);
    }

    public function test_leaves_unknown_variables_untouched(): void
    {
        $result = $this->service()->replaceVariables('{topic} и {unknown}', ['topic' => 'казино']);

        $this->assertSame('казино и {unknown}', $result);
    }

    public function test_cleans_markdown_fence_and_disallowed_tags(): void
    {
        $html = "```html\n<h1>Заголовок</h1><p>Текст <strong>жирный</strong></p>\n```";

        $this->assertSame(
            '<h1>Заголовок</h1><p>Текст жирный</p>',
            $this->service()->cleanHtmlResponse($html)
        );
    }

    public function test_extracts_title_from_h1(): void
    {
        $this->assertSame(
            'Заголовок',
            $this->service()->extractTitle('<h1>Заголовок</h1><p>Текст</p>')
        );
    }

    public function test_falls_back_to_default_title_without_h1(): void
    {
        $this->assertSame('SEO Текст', $this->service()->extractTitle('<p>Текст</p>'));
    }

    public function test_extracts_body_without_h1(): void
    {
        $this->assertSame(
            '<p>Текст</p>',
            $this->service()->extractBody('<h1>Заголовок</h1><p>Текст</p>')
        );
    }

    public function test_keywords_model_falls_back_to_content_model(): void
    {
        $this->service();

        $this->assertSame('gpt-4.1', app(GenerationSettings::class)->effectiveKeywordsModel());

        GenerationSettings::fake([
            'contentModel' => 'gpt-4.1',
            'keywordsModel' => 'xai:grok-4',
            'temperature' => 1.0,
            'systemPromptContent' => 'a',
            'systemPromptKeywords' => 'b',
            'textPrompt' => 'c',
            'keywordsPrompt' => 'd',
            'trustedLinksEnabled' => true,
            'trustedLinksCount' => 2,
        ]);

        $this->assertSame('xai:grok-4', app(GenerationSettings::class)->effectiveKeywordsModel());
    }
}
```

- [ ] **Step 2: Убедиться, что тест падает**

```bash
php artisan test --filter=AiServiceTest
```

Ожидаемо: FAIL, `Class "App\Services\Ai\AiService" does not exist`.

- [ ] **Step 3: Создать `app/Exceptions/AiException.php`**

```php
<?php

namespace App\Exceptions;

use RuntimeException;

class AiException extends RuntimeException {}
```

- [ ] **Step 4: Создать `app/Services/Ai/AiService.php`**

```php
<?php

namespace App\Services\Ai;

use App\Exceptions\AiException;
use App\Settings\GenerationSettings;
use Illuminate\Support\Facades\Log;
use Throwable;

/**
 * Единственная точка общения с языковой моделью.
 *
 * Промпты и модель берутся из GenerationSettings, провайдер — из имени модели
 * (см. AiClients). Ответ всегда стримится: тексты длинные, на нестриминговом
 * запросе легко словить таймаут.
 */
class AiService
{
    protected int $retryTimes = 3;

    protected int $retrySleepMs = 1000;

    public function __construct(
        protected GenerationSettings $settings,
        protected AiClients $clients,
    ) {}

    /**
     * Один запрос к модели со стримингом и ретраями.
     *
     * @throws AiException
     */
    public function chat(string $system, string $prompt, ?float $temperature = null, ?string $model = null): string
    {
        $model = $model ?: $this->settings->contentModel;
        $temperature ??= $this->settings->temperature;
        $modelName = (string) $this->clients->modelName($model);

        return $this->withRetry(function () use ($system, $prompt, $temperature, $model, $modelName) {
            $stream = $this->clients->for($model)->chat()->createStreamed($this->withTemperature([
                'model' => $modelName,
                'messages' => [
                    ['role' => 'system', 'content' => $system],
                    ['role' => 'user', 'content' => $prompt],
                ],
            ], $modelName, $temperature));

            $content = '';

            foreach ($stream as $chunk) {
                $content .= $chunk->choices[0]->delta->content ?? '';
            }

            if (trim($content) === '') {
                throw new AiException('Модель вернула пустой ответ');
            }

            return $content;
        });
    }

    /**
     * Ключевые слова по теме. При любой ошибке возвращает саму тему —
     * из-за ключевиков генерация текста падать не должна.
     */
    public function generateKeywords(string $topic, string $language): string
    {
        $prompt = $this->replaceVariables($this->settings->keywordsPrompt, [
            'topic' => $topic,
            'language' => $language,
        ]);

        try {
            $content = $this->chat(
                system: $this->settings->systemPromptKeywords,
                prompt: $prompt,
                model: $this->settings->effectiveKeywordsModel(),
            );
        } catch (Throwable $e) {
            Log::warning('generateKeywords: '.$e->getMessage());

            return $topic;
        }

        $words = array_map('trim', explode(',', trim($content)));
        shuffle($words);

        return implode(',', $words);
    }

    /**
     * HTML-контент по промпту проекта или глобальному промпту из настроек.
     *
     * @param  array<string, mixed>  $variables
     *
     * @throws AiException
     */
    public function generateContent(array $variables, ?string $customPrompt = null, ?string $model = null): string
    {
        $prompt = $this->replaceVariables(
            $customPrompt ?: $this->settings->textPrompt,
            $variables
        );

        $content = $this->chat(
            system: $this->settings->systemPromptContent,
            prompt: $prompt,
            model: $model ?: $this->settings->contentModel,
        );

        return $this->cleanHtmlResponse($content);
    }

    /** Снять markdown-обёртку и вырезать лишние теги. */
    public function cleanHtmlResponse(string $content, string $allowedTags = '<h1><h2><h3><h4><p><ul><ol><li><br><a>'): string
    {
        $content = trim($content);
        $content = preg_replace('/^```html\s*/i', '', $content);
        $content = preg_replace('/^```\s*/i', '', $content);
        $content = preg_replace('/```$/', '', $content);

        return trim(strip_tags($content, $allowedTags));
    }

    /** Заголовок из H1 или значение по умолчанию. */
    public function extractTitle(string $html): string
    {
        preg_match('/<h1[^>]*>(.*?)<\/h1>/i', $html, $match);

        return trim($match[1] ?? '') ?: 'SEO Текст';
    }

    /** Тело текста без H1. */
    public function extractBody(string $html): string
    {
        return trim(preg_replace('/<h1[^>]*>.*?<\/h1>/is', '', $html) ?? '');
    }

    /**
     * Подстановка `{key}` в шаблоне.
     *
     * @param  array<string, mixed>  $variables
     */
    public function replaceVariables(string $template, array $variables): string
    {
        foreach ($variables as $key => $value) {
            $template = str_replace('{'.$key.'}', (string) $value, $template);
        }

        return $template;
    }

    /**
     * Температура добавляется в запрос, только если модель принимает
     * произвольное значение. Reasoning-модели (gpt-5*, o1*, o3*, o4*) принимают
     * лишь значение по умолчанию и на любом другом падают.
     *
     * @param  array<string, mixed>  $payload
     * @return array<string, mixed>
     */
    protected function withTemperature(array $payload, string $model, float $temperature): array
    {
        if ($this->supportsCustomTemperature($model)) {
            $payload['temperature'] = $temperature;
        }

        return $payload;
    }

    protected function supportsCustomTemperature(string $model): bool
    {
        $model = strtolower($model);

        foreach (['gpt-5', 'o1', 'o3', 'o4'] as $prefix) {
            if (str_starts_with($model, $prefix)) {
                return false;
            }
        }

        return true;
    }

    /**
     * Повтор запроса на временных ошибках с экспоненциальной паузой.
     *
     * @throws AiException
     */
    protected function withRetry(callable $callback): mixed
    {
        $attempts = 0;
        $lastException = null;

        while ($attempts < $this->retryTimes) {
            try {
                return $callback();
            } catch (Throwable $e) {
                $lastException = $e;
                $attempts++;

                $isRetryable = $this->isRetryableError($e);

                if (! $isRetryable || $attempts >= $this->retryTimes) {
                    Log::error('[AI] Запрос не удался', [
                        'attempt' => $attempts,
                        'error' => $e->getMessage(),
                        'retryable' => $isRetryable,
                    ]);

                    throw new AiException(
                        message: "Запрос к модели не удался после {$attempts} попыток: {$e->getMessage()}",
                        previous: $e
                    );
                }

                $sleepMs = $this->retrySleepMs * pow(2, $attempts - 1);

                Log::warning('[AI] Запрос не удался, повтор', [
                    'attempt' => $attempts,
                    'next_attempt_in_ms' => $sleepMs,
                    'error' => $e->getMessage(),
                ]);

                usleep($sleepMs * 1000);
            }
        }

        throw new AiException(
            message: 'Запрос к модели не удался: исчерпаны попытки',
            previous: $lastException
        );
    }

    /** Временная ли ошибка: лимиты, 5xx, обрыв связи. */
    protected function isRetryableError(Throwable $e): bool
    {
        $message = strtolower($e->getMessage());

        if (str_contains($message, '429') || str_contains($message, 'rate limit')) {
            return true;
        }

        if (preg_match('/5\d{2}/', $message)) {
            return true;
        }

        return str_contains($message, 'connection') || str_contains($message, 'timeout');
    }
}
```

- [ ] **Step 5: Прогнать тест**

```bash
php artisan test --filter=AiServiceTest
```

Ожидаемо: PASS, 7 тестов.

- [ ] **Step 6: Коммит**

```bash
git add app/Exceptions/AiException.php app/Services/Ai/AiService.php tests/Feature/Ai/AiServiceTest.php
git commit -m "feat: AiService со стримингом, ретраями и промптами из настроек"
```

---

### Task 5: `TrustedLinksResolver`

**Files:**
- Create: `app/Services/TrustedLinksResolver.php`, `tests/Unit/Services/TrustedLinksResolverTest.php`

Логика поиска файлов переносится из `GenerateTextJob` без изменений. Базовый путь принимается в конструкторе, чтобы тест не трогал реальный `storage`.

- [ ] **Step 1: Написать падающий тест**

Создать `tests/Unit/Services/TrustedLinksResolverTest.php`:

```php
<?php

namespace Tests\Unit\Services;

use App\Services\TrustedLinksResolver;
use PHPUnit\Framework\TestCase;

class TrustedLinksResolverTest extends TestCase
{
    protected string $dir;

    protected function setUp(): void
    {
        parent::setUp();

        $this->dir = sys_get_temp_dir().'/trusted_links_'.uniqid();
        mkdir($this->dir);
    }

    protected function tearDown(): void
    {
        foreach (glob($this->dir.'/*') ?: [] as $file) {
            unlink($file);
        }

        rmdir($this->dir);

        parent::tearDown();
    }

    protected function write(string $name, array $lines): void
    {
        file_put_contents($this->dir.'/'.$name, implode("\n", $lines));
    }

    public function test_detects_escort_topic_with_city(): void
    {
        $resolver = new TrustedLinksResolver($this->dir);

        $this->assertSame(
            ['topic' => 'escort', 'city' => 'moskva'],
            $resolver->detectTopicAndCity('Эскорт Moskva дорого')
        );
    }

    public function test_detects_casino_topic_without_city(): void
    {
        $resolver = new TrustedLinksResolver($this->dir);

        $this->assertSame(
            ['topic' => 'casino', 'city' => null],
            $resolver->detectTopicAndCity('Онлайн казино')
        );
    }

    public function test_falls_back_to_general_topic(): void
    {
        $resolver = new TrustedLinksResolver($this->dir);

        $this->assertSame(
            ['topic' => 'general', 'city' => null],
            $resolver->detectTopicAndCity('Ремонт квартир')
        );
    }

    public function test_prefers_the_most_specific_file(): void
    {
        $this->write('casino-ru.txt', ['https://specific.example']);
        $this->write('casino.txt', ['https://less-specific.example']);
        $this->write('general.txt', ['https://general.example']);

        $links = (new TrustedLinksResolver($this->dir))->resolve('Онлайн казино', 'ru', 5);

        $this->assertSame(['https://specific.example'], $links);
    }

    public function test_falls_back_to_general_file(): void
    {
        $this->write('general.txt', ['https://general.example']);

        $links = (new TrustedLinksResolver($this->dir))->resolve('Ремонт квартир', 'ru', 5);

        $this->assertSame(['https://general.example'], $links);
    }

    public function test_limits_the_number_of_links(): void
    {
        $this->write('general.txt', [
            'https://a.example',
            'https://b.example',
            'https://c.example',
            'https://c.example',
        ]);

        $links = (new TrustedLinksResolver($this->dir))->resolve('Ремонт квартир', 'ru', 2);

        $this->assertCount(2, $links);
        $this->assertSame($links, array_unique($links));
    }

    public function test_returns_empty_array_when_no_files_exist(): void
    {
        $this->assertSame([], (new TrustedLinksResolver($this->dir))->resolve('Что угодно', 'ru', 2));
    }

    public function test_builds_html_block(): void
    {
        $this->write('general.txt', ['https://a.example']);

        $block = (new TrustedLinksResolver($this->dir))->block('Ремонт квартир', 'ru', 1);

        $this->assertSame("- <a href='https://a.example'>https://a.example</a>\n", $block);
    }
}
```

- [ ] **Step 2: Убедиться, что тест падает**

```bash
php artisan test --filter=TrustedLinksResolverTest
```

Ожидаемо: FAIL, `Class "App\Services\TrustedLinksResolver" does not exist`.

- [ ] **Step 3: Создать `app/Services/TrustedLinksResolver.php`**

```php
<?php

namespace App\Services;

use Illuminate\Support\Str;

/**
 * Подбирает трастовые ссылки для вставки в текст.
 *
 * Файлы лежат в storage/app/trusted_links и выбираются от самого частного
 * имени к самому общему: {тема}-{город}-{язык} → {тема}-{язык} → {тема} →
 * general-{язык} → general.
 */
class TrustedLinksResolver
{
    protected string $basePath;

    public function __construct(?string $basePath = null)
    {
        $this->basePath = $basePath ?: storage_path('app/trusted_links');
    }

    /**
     * До $count случайных уникальных ссылок по теме и языку.
     *
     * @return array<int, string>
     */
    public function resolve(string $topic, string $language, int $count): array
    {
        $links = array_values(array_unique($this->readLinks($topic, $language)));

        if ($count <= 0) {
            return [];
        }

        if (count($links) <= $count) {
            return $links;
        }

        $keys = (array) array_rand($links, $count);

        return array_map(fn ($key) => $links[$key], $keys);
    }

    /** Готовый блок ссылок для подстановки в промпт. */
    public function block(string $topic, string $language, int $count): string
    {
        $block = '';

        foreach ($this->resolve($topic, $language, $count) as $link) {
            $block .= "- <a href='{$link}'>{$link}</a>\n";
        }

        return $block;
    }

    /**
     * Тематика и город, определённые по названию темы проекта.
     *
     * @return array{topic: string, city: string|null}
     */
    public function detectTopicAndCity(string $topic): array
    {
        $topic = trim($topic);
        $lower = Str::lower($topic);

        if (Str::contains($lower, ['эскорт', 'проститут'])) {
            $words = preg_split('/\s+/', $topic) ?: [];
            $cityRaw = count($words) > 1 ? $words[1] : null;

            return [
                'topic' => 'escort',
                'city' => $cityRaw ? Str::slug($cityRaw) : null,
            ];
        }

        if (Str::contains($lower, 'казино')) {
            return ['topic' => 'casino', 'city' => null];
        }

        return ['topic' => 'general', 'city' => null];
    }

    /** @return array<int, string> */
    protected function readLinks(string $topic, string $language): array
    {
        ['topic' => $slug, 'city' => $city] = $this->detectTopicAndCity($topic);

        $filenames = [];

        if ($city) {
            $filenames[] = "{$slug}-{$city}-{$language}.txt";
        }

        $filenames[] = "{$slug}-{$language}.txt";
        $filenames[] = "{$slug}.txt";
        $filenames[] = "general-{$language}.txt";
        $filenames[] = 'general.txt';

        foreach ($filenames as $file) {
            $path = $this->basePath.'/'.$file;

            if (file_exists($path)) {
                return file($path, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES) ?: [];
            }
        }

        return [];
    }
}
```

- [ ] **Step 4: Прогнать тест**

```bash
php artisan test --filter=TrustedLinksResolverTest
```

Ожидаемо: PASS, 8 тестов.

- [ ] **Step 5: Коммит**

```bash
git add app/Services/TrustedLinksResolver.php tests/Unit/Services/TrustedLinksResolverTest.php
git commit -m "feat: вынести подбор трастовых ссылок в отдельный сервис"
```

---

### Task 6: Переопределения на проекте

**Files:**
- Create: `database/migrations/2026_07_30_130000_add_generation_overrides_to_projects_table.php`
- Modify: `app/Models/Project.php:12-19` (массив `$fillable`)

- [ ] **Step 1: Создать миграцию**

`database/migrations/2026_07_30_130000_add_generation_overrides_to_projects_table.php`:

```php
<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

return new class extends Migration
{
    public function up(): void
    {
        Schema::table('projects', function (Blueprint $table) {
            $table->string('ai_model')->nullable()->after('topic');
            $table->text('text_prompt')->nullable()->after('ai_model');
        });
    }

    public function down(): void
    {
        Schema::table('projects', function (Blueprint $table) {
            $table->dropColumn(['ai_model', 'text_prompt']);
        });
    }
};
```

- [ ] **Step 2: Прогнать миграцию**

```bash
php artisan migrate
```

- [ ] **Step 3: Добавить поля в `$fillable`**

В `app/Models/Project.php` массив `$fillable` привести к виду:

```php
    protected $fillable = [
        'name',
        'topic',
        'ai_model',
        'text_prompt',
        'text_length',
        'status',
        'posts_per_day'
    ];
```

- [ ] **Step 4: Проверить, что колонки на месте**

```bash
php artisan tinker --execute="print_r(array_intersect(['ai_model','text_prompt'], Illuminate\Support\Facades\Schema::getColumnListing('projects')));"
```

Ожидаемо: массив с обоими именами.

- [ ] **Step 5: Коммит**

```bash
git add database/migrations app/Models/Project.php
git commit -m "feat: модель и промпт генерации на уровне проекта"
```

---

### Task 7: Рефакторинг `GenerateTextJob`

**Files:**
- Modify: `app/Jobs/GenerateTextJob.php` (заменяется целиком)

Это единственная задача, меняющая поведение приложения. Поведение остаётся эквивалентным: дефолты настроек равны прежним захардкоженным строкам.

- [ ] **Step 1: Заменить содержимое `app/Jobs/GenerateTextJob.php`**

```php
<?php

namespace App\Jobs;

use App\Models\Text;
use App\Services\Ai\AiService;
use App\Services\TrustedLinksResolver;
use App\Settings\GenerationSettings;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Queue\SerializesModels;
use Illuminate\Support\Facades\Log;
use Throwable;

class GenerateTextJob implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    public $tries = 3;

    public $backoff = [60, 120, 300];

    public function __construct(public int $textId) {}

    public function handle(
        AiService $ai,
        TrustedLinksResolver $trustedLinks,
        GenerationSettings $settings,
    ): void {
        $text = Text::with('project', 'link')->find($this->textId);

        if (! $text) {
            Log::warning("❌ Text ID={$this->textId} не найден");

            return;
        }

        if (! in_array($text->status, ['pending', 'error'])) {
            Log::info("⏭ Text ID={$text->id} имеет статус {$text->status}, пропускаем");

            return;
        }

        $project = $text->project;
        $link = $text->link;

        if (! $project || ! $link) {
            Log::error("❌ Text ID={$text->id}: отсутствует project или link");

            $text->update([
                'status' => 'error',
                'error_message' => 'Отсутствует связанный project или link',
            ]);

            return;
        }

        try {
            $topic = $project->topic ?? '';

            $keywords = $ai->generateKeywords($topic, $link->language);
            $text->keywords = $keywords;
            $text->save();

            $linksCount = $settings->trustedLinksEnabled ? $settings->trustedLinksCount : 0;

            $content = $ai->generateContent(
                variables: [
                    'project' => $project->name,
                    'topic' => $topic,
                    'keywords' => $keywords,
                    'length' => $project->text_length,
                    'language' => $link->language,
                    'link_url' => $link->target_url,
                    'link_anchor' => $link->anchor,
                    'trusted_links' => $linksCount > 0
                        ? $trustedLinks->block($topic, $link->language, $linksCount)
                        : '',
                    'trusted_links_count' => $linksCount,
                ],
                customPrompt: $project->text_prompt,
                model: $project->ai_model,
            );

            $text->update([
                'title' => $ai->extractTitle($content),
                'body_html' => $ai->extractBody($content),
                'status' => 'generated',
                'generated_at' => now(),
                'error_message' => null,
            ]);

            $project->checkAndUpdateGenerationStatus();
        } catch (Throwable $e) {
            $text->update([
                'status' => 'error',
                'error_message' => $e->getMessage(),
            ]);

            Log::error("❌ Ошибка ID={$text->id}: ".$e->getMessage());

            // Пробрасываем, чтобы сработали ретраи очереди.
            throw $e;
        }
    }
}
```

- [ ] **Step 2: Проверить синтаксис и прогнать все тесты**

```bash
php -l app/Jobs/GenerateTextJob.php && php artisan test
```

Ожидаемо: `No syntax errors detected`, все тесты PASS.

- [ ] **Step 3: Прогнать генерацию одного текста вручную**

```bash
php artisan tinker --execute="dispatch_sync(new App\Jobs\GenerateTextJob(App\Models\Text::where('status','pending')->value('id')));"
```

Ожидаемо: текст переходит в статус `generated`, `title` и `body_html` заполнены. Если `pending`-текстов нет — создать тестовый проект со ссылкой и одним текстом в админке и повторить.

- [ ] **Step 4: Коммит**

```bash
git add app/Jobs/GenerateTextJob.php
git commit -m "refactor: перевести GenerateTextJob на AiService и настройки"
```

---

### Task 8: Страница настроек в админке

**Files:**
- Create: `app/Filament/Pages/ManageGenerationSettings.php`

- [ ] **Step 1: Создать `app/Filament/Pages/ManageGenerationSettings.php`**

```php
<?php

namespace App\Filament\Pages;

use App\Services\Ai\AiClients;
use App\Settings\GenerationSettings;
use Filament\Forms\Components\Tabs;
use Filament\Forms\Components\Textarea;
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Toggle;
use Filament\Forms\Form;
use Filament\Pages\SettingsPage;

class ManageGenerationSettings extends SettingsPage
{
    protected static string $settings = GenerationSettings::class;

    protected static ?string $navigationIcon = 'heroicon-o-sparkles';

    protected static ?string $navigationGroup = 'Контент';

    protected static ?string $navigationLabel = 'Настройки генерации';

    protected static ?string $title = 'Настройки генерации';

    protected static ?int $navigationSort = 10;

    public function form(Form $form): Form
    {
        return $form->schema([
            Tabs::make('Настройки')
                ->tabs([
                    Tabs\Tab::make('Модель')
                        ->icon('heroicon-o-cpu-chip')
                        ->schema([
                            TextInput::make('contentModel')
                                ->label('Модель генерации текста')
                                ->required()
                                ->placeholder('gpt-4.1')
                                ->helperText($this->getModelHelperText()),

                            TextInput::make('keywordsModel')
                                ->label('Модель для ключевых слов')
                                ->placeholder('пусто — та же, что для текста')
                                ->helperText('Можно поставить модель подешевле: ключевые слова короткие.'),

                            TextInput::make('temperature')
                                ->label('Температура')
                                ->numeric()
                                ->required()
                                ->minValue(0)
                                ->maxValue(2)
                                ->step(0.1)
                                ->helperText('Для reasoning-моделей (gpt-5*, o1*, o3*, o4*) параметр не отправляется — они принимают только значение по умолчанию.'),
                        ]),

                    Tabs\Tab::make('Системные промпты')
                        ->icon('heroicon-o-command-line')
                        ->schema([
                            Textarea::make('systemPromptContent')
                                ->label('System для генерации текста')
                                ->required()
                                ->rows(3)
                                ->columnSpanFull(),

                            Textarea::make('systemPromptKeywords')
                                ->label('System для ключевых слов')
                                ->required()
                                ->rows(3)
                                ->columnSpanFull(),
                        ]),

                    Tabs\Tab::make('Текст')
                        ->icon('heroicon-o-document-text')
                        ->schema([
                            Textarea::make('textPrompt')
                                ->label('Промпт генерации текста')
                                ->required()
                                ->rows(18)
                                ->helperText($this->getVariablesHelperText('text'))
                                ->columnSpanFull(),
                        ]),

                    Tabs\Tab::make('Ключевые слова')
                        ->icon('heroicon-o-key')
                        ->schema([
                            Textarea::make('keywordsPrompt')
                                ->label('Промпт генерации ключевых слов')
                                ->required()
                                ->rows(8)
                                ->helperText($this->getVariablesHelperText('keywords'))
                                ->columnSpanFull(),
                        ]),

                    Tabs\Tab::make('Трастовые ссылки')
                        ->icon('heroicon-o-link')
                        ->schema([
                            Toggle::make('trustedLinksEnabled')
                                ->label('Вставлять трастовые ссылки')
                                ->helperText('Ссылки берутся из storage/app/trusted_links по тематике и языку.'),

                            TextInput::make('trustedLinksCount')
                                ->label('Сколько ссылок вставлять')
                                ->numeric()
                                ->required()
                                ->minValue(0)
                                ->maxValue(10),
                        ]),
                ])
                ->columnSpanFull(),
        ]);
    }

    protected function getModelHelperText(): string
    {
        $providers = app(AiClients::class)->labels();

        $parts = [];
        foreach ($providers as $key => $label) {
            $parts[] = "{$key}: {$label}";
        }

        return 'Голое имя модели (gpt-4.1) уходит в OpenAI. Формат provider:model направляет запрос другому провайдеру — '
            .implode(' | ', $parts)
            .'. Например: xai:grok-4. Ключ провайдера должен быть в .env.';
    }

    protected function getVariablesHelperText(string $type): string
    {
        $variables = GenerationSettings::getAvailableVariables()[$type] ?? [];

        $parts = [];
        foreach ($variables as $variable => $description) {
            $parts[] = "{$variable} — {$description}";
        }

        return 'Доступные переменные: '.implode(' | ', $parts);
    }
}
```

- [ ] **Step 2: Проверить, что страница регистрируется**

```bash
php artisan about --only=environment >/dev/null && php -l app/Filament/Pages/ManageGenerationSettings.php
```

Ожидаемо: `No syntax errors detected`.

- [ ] **Step 3: Проверить страницу в браузере**

Открыть `/admin`, в группе «Контент» открыть «Настройки генерации». Проверить: все пять вкладок открываются, значения подгружены из БД, изменение температуры сохраняется (кнопка Save → уведомление об успехе → перезагрузка страницы показывает новое значение).

- [ ] **Step 4: Коммит**

```bash
git add app/Filament/Pages/ManageGenerationSettings.php
git commit -m "feat: страница настроек генерации в админке"
```

---

### Task 9: Секция «Генерация» в проекте

**Files:**
- Modify: `app/Filament/Resources/ProjectResource.php:26-56` (метод `form`)

- [ ] **Step 1: Добавить импорт настроек**

В шапку `app/Filament/Resources/ProjectResource.php` добавить:

```php
use App\Settings\GenerationSettings;
```

- [ ] **Step 2: Добавить секцию в форму**

В методе `form()` перед `Forms\Components\Placeholder::make('progress')` вставить:

```php
            Forms\Components\Section::make('Генерация')
                ->description('Пусто — берутся глобальные настройки со страницы «Настройки генерации»')
                ->collapsed()
                ->schema([
                    Forms\Components\TextInput::make('ai_model')
                        ->label('Модель')
                        ->placeholder(fn () => app(GenerationSettings::class)->contentModel)
                        ->helperText('Голое имя модели уходит в OpenAI, формат provider:model — другому провайдеру (например, xai:grok-4).'),

                    Forms\Components\Textarea::make('text_prompt')
                        ->label('Промпт текста')
                        ->rows(14)
                        ->helperText(static::getPromptVariablesHelperText())
                        ->columnSpanFull(),
                ])
                ->columnSpanFull(),
```

- [ ] **Step 3: Добавить метод подсказки**

В конец класса `ProjectResource` добавить:

```php
    protected static function getPromptVariablesHelperText(): string
    {
        $variables = GenerationSettings::getAvailableVariables()['text'] ?? [];

        $parts = [];
        foreach ($variables as $variable => $description) {
            $parts[] = "{$variable} — {$description}";
        }

        return 'Доступные переменные: '.implode(' | ', $parts);
    }
```

- [ ] **Step 4: Проверить синтаксис**

```bash
php -l app/Filament/Resources/ProjectResource.php
```

Ожидаемо: `No syntax errors detected`.

- [ ] **Step 5: Проверить в браузере**

Открыть проект в админке, развернуть секцию «Генерация». Убедиться, что placeholder модели показывает глобальное значение, что оба поля сохраняются и что после сохранения пустые поля остаются пустыми (а не превращаются в пустые строки, ломающие откат на глобальные настройки — если такое случилось, добавить `->dehydrateStateUsing(fn (?string $state) => filled($state) ? $state : null)` обоим полям).

- [ ] **Step 6: Коммит**

```bash
git add app/Filament/Resources/ProjectResource.php
git commit -m "feat: переопределение модели и промпта в проекте"
```

---

### Task 10: Финальная проверка

- [ ] **Step 1: Прогнать весь набор тестов**

```bash
php artisan test
```

Ожидаемо: PASS, 20 тестов (5 `AiClientsTest` + 7 `AiServiceTest` + 8 `TrustedLinksResolverTest`).

- [ ] **Step 2: Проверить стиль**

```bash
./vendor/bin/pint --test app/Services/Ai app/Settings app/Filament/Pages app/Jobs/GenerateTextJob.php app/Services/TrustedLinksResolver.php
```

Если Pint ругается — прогнать без `--test` и закоммитить правки.

- [ ] **Step 3: Сгенерировать текст через очередь**

Запустить воркер и поставить задачу:

```bash
php artisan queue:work --queue=text-generate --once
```

Ожидаемо: текст переходит в `generated`, в логе нет ошибок.

- [ ] **Step 4: Проверить смену модели без деплоя**

В админке на странице настроек поменять модель на другую (например, `gpt-4o-mini`), сгенерировать ещё один текст, убедиться, что генерация прошла. Вернуть `gpt-4.1`.

- [ ] **Step 5: Финальный коммит, если что-то поправилось**

```bash
git add -A
git commit -m "chore: правки после финальной проверки"
```

---

## Проверка соответствия спеке

| Требование спеки | Задача |
| --- | --- |
| `config/ai.php` + ключи в `.env.example` | Task 2 |
| `AiClients` (роутинг `provider:model`) | Task 2 |
| `AiService` (стриминг, ретраи, температура, промпты, HTML) | Task 4 |
| `AiException` | Task 4 |
| `GenerationSettings` + миграция с текущими дефолтами | Task 3 |
| Страница настроек с пятью вкладками | Task 8 |
| `ai_model` и `text_prompt` у проекта + форма | Task 6, Task 9 |
| `TrustedLinksResolver` | Task 5 |
| Тонкий `GenerateTextJob` | Task 7 |
| Юнит-тесты без обращения к API | Task 2, 4, 5 |

## Отличие от спеки

В список переменных добавлена `{trusted_links_count}`: в текущем промпте число трастовых ссылок зашито словом «эти 2 ссылки», и без этой переменной настройка `trustedLinksCount` расходилась бы с текстом промпта.
