# Уникальность текстов, трастовые ссылки в БД, сервис постинга — план реализации

> **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:** Генерация разнообразных текстов (шаблоны, персоны, углы, структура, банк ключей, контроль дублей), трастовые ссылки и параметры постинга в БД с админкой, мониторинг сервиса постинга.

**Architecture:** Новые сервисы в `app/Services/Generation` и `app/Services/Posting`, `GenerateTextJob` остаётся оркестратором. Настройки — spatie/laravel-settings (`GenerationSettings`, новая `PostingSettings`), справочники — Eloquent-модели с Filament-ресурсами.

**Tech Stack:** Laravel 11, Filament v3, spatie/laravel-settings 3, PHPUnit 11, MySQL 8, FastAPI (scripts/app.py).

**Spec:** `docs/superpowers/specs/2026-10-01-content-uniqueness-design.md`

## Global Constraints

- Тесты: `DatabaseTransactions` на локальной MySQL, никаких `RefreshDatabase`/truncate. Перед тестами новые миграции применяются `php artisan migrate`.
- Сеть в тестах запрещена: `Http::fake()`, моки `AiService`.
- Комментарии и сообщения — на русском, стиль кода как в `AiService`/`GenerateTextJob` (докблоки одной строкой, `declare` не используется).
- Коммиты на русском в стиле `feat: …` / `fix: …` / `test: …` / `refactor: …` с трейлером `Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>`.
- Filament v3: `Filament\Forms`, `Filament\Tables`, никакого `Filament\Schemas`.
- Навигация: группы «Контент», «Генерация», «Постинг».

## Review Focus

1. Проект без групп ссылок и без подходящих файлов/групп — генерация идёт без ссылок и не падает (`count = 0`, пустой блок).
2. Пустые справочники (нет активных шаблонов/персон/углов) — откат на `textPrompt`, пустые `{persona}`/`{angle}`.
3. Сервис постинга лежит — `postings:dispatch` не помечает посты `done`, `PostTextToSiteJob` не трогает `has_error` сайтов.
4. Импорт со строками-мусором, пробелами, BOM, дублями и `url;анкор` — корректные итоги, без исключений.
5. Ответ AI для банка ключей с нумерацией/переносами строк/дублями — чистый уникальный список.

Каждый пункт закрыт тестом в соответствующей задаче (2, 3, 6, 7, 8).

---

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

| Файл | Ответственность |
|---|---|
| `app/Settings/PostingSettings.php` | URL и таймауты сервиса постинга |
| `app/Services/Posting/PostingServiceClient.php` | HTTP-вызовы FastAPI |
| `app/Services/Posting/PostingServiceStatus.php` | DTO состояния |
| `app/Services/Posting/PostingServiceMonitor.php` | кеш состояния, `isAvailable()` |
| `app/Console/Commands/CheckPostingServiceHealth.php` | `posting:health` |
| `app/Filament/Widgets/PostingServiceWidget.php` + `resources/views/filament/widgets/posting-service-widget.blade.php` | виджет |
| `app/Filament/Pages/ManagePostingSettings.php` | страница настроек постинга |
| `app/Support/WeightedRandom.php` | взвешенный выбор |
| `app/Models/{PromptTemplate,PromptModifier,ProjectKeyword,TrustedLinkGroup,TrustedLink}.php` | модели |
| `app/Services/Generation/{ComposedPrompt,PromptComposer,KeywordBank,SimilarityChecker}.php` | генерация |
| `app/Services/TrustedLinksResolver.php` | переписан на БД |
| `app/Services/TrustedLinks/TrustedLinksImporter.php` | разбор и импорт строк |
| `app/Services/TrustedLinks/LegacyFileName.php` | разбор имени `.txt` для миграции |
| `database/seeders/GenerationContentSeeder.php` | стартовые шаблоны/персоны/углы |
| `app/Filament/Resources/{PromptTemplateResource,PromptModifierResource,TrustedLinkGroupResource}` | админка |
| `app/Filament/Resources/ProjectResource/RelationManagers/ProjectKeywordsRelationManager.php` | банк ключей |
| `tests/Support/FakesGenerationSettings.php` | общий набор дефолтов для `GenerationSettings::fake()` |

---

### Task 1: Удалить «Кракен», вынести URL сервиса постинга в PostingSettings и клиент

**Files:**
- Delete: `app/Console/Commands/InsertKrakenLinks.php`
- Create: `app/Settings/PostingSettings.php`, `database/settings/2026_10_01_100000_create_posting_settings.php`, `app/Services/Posting/PostingServiceClient.php`
- Modify: `config/settings.php` (регистрация `PostingSettings`), `app/Jobs/PostTextToSiteJob.php:90`, `app/Jobs/CheckSiteJob.php:39`
- Test: `tests/Feature/Posting/PostingServiceClientTest.php`

**Interfaces — Produces:**
```php
class PostingSettings extends Settings { public string $serviceUrl; public int $timeout; public int $healthTimeout; static group(): 'posting' }
class PostingServiceClient {
    public function __construct(PostingSettings $settings);
    public function publish(array $payload): \Illuminate\Http\Client\Response; // POST {serviceUrl}/publish, timeout
    public function check(array $payload): \Illuminate\Http\Client\Response;   // POST {serviceUrl}/check
    public function health(): PostingServiceStatus;                             // Task 2
    protected function url(string $path): string; // rtrim(serviceUrl,'/').'/'.ltrim(path,'/')
}
```

- [ ] Тесты: `publish` шлёт POST на `http://svc:9000/publish` из настроек (с завершающим `/` в URL тоже), с payload; `check` — на `/check`; таймаут берётся из настроек (`Http::fake` + `Http::assertSent`).
- [ ] Прогнать — FAIL (класса нет).
- [ ] Settings-миграция: `posting.serviceUrl = 'http://127.0.0.1:8001'`, `posting.timeout = 10`, `posting.healthTimeout = 5`. Класс и клиент. Джобы получают клиент через `handle(PostingServiceClient $client)`.
- [ ] Удалить `InsertKrakenLinks.php`, `grep -ri kraken app` — пусто.
- [ ] `php artisan migrate && php artisan test` — PASS.
- [ ] Commit `refactor: URL сервиса постинга в настройках, удалить kraken:inject`.

### Task 2: Мониторинг сервиса постинга и защита от простоя

**Files:**
- Create: `app/Services/Posting/PostingServiceStatus.php`, `app/Services/Posting/PostingServiceMonitor.php`, `app/Console/Commands/CheckPostingServiceHealth.php`
- Modify: `PostingServiceClient::health()`, `routes/console.php`, `app/Console/Commands/DispatchPlannedPostings.php`, `app/Jobs/PostTextToSiteJob.php`, `scripts/app.py`
- Test: `tests/Feature/Posting/PostingServiceMonitorTest.php`, `tests/Feature/Posting/PostingGateTest.php`

**Interfaces — Produces:**
```php
final class PostingServiceStatus {
    public function __construct(public bool $online, public ?int $latencyMs, public ?int $activeTasks, public ?int $uptimeSeconds, public ?string $error, public CarbonImmutable $checkedAt);
    public function toArray(): array; public static function fromArray(array $data): self;
}
class PostingServiceMonitor {
    const CACHE_KEY = 'posting_service:status';
    public function refresh(): PostingServiceStatus;   // client->health(), Cache::put(key, toArray, 10 мин)
    public function status(): ?PostingServiceStatus;
    public function isAvailable(): bool;               // свежий (<120 c) кеш → по нему, иначе refresh()
}
```
`health()`: GET `/health` с `healthTimeout`; `online = successful && json('status') === 'ok'`; latency через `hrtime`; исключение соединения → `online=false, error=message`.

- [ ] Тесты монитора: online с `active_tasks`/`uptime_seconds`; 500 → offline с ошибкой; `ConnectionException` (`Http::fake(fn () => throw new ConnectionException('refused'))`) → offline; `isAvailable` не делает HTTP при свежем кеше (`Http::assertNothingSent`), делает при устаревшем (`travel(3)->minutes()`).
- [ ] Тесты гейта (Review Focus #3): при offline `postings:dispatch` не диспатчит (`Queue::fake`), пост остаётся `pending`; `PostTextToSiteJob` при offline не создаёт pivot и не меняет `has_error` сайта, вызывает `release` (проверка через `$job->withFakeQueueInteractions()->handle(...)` и `assertReleased(120)`).
- [ ] Реализация. В `DispatchPlannedPostings::handle(PostingServiceMonitor $monitor)` — ранний выход с `Log::warning` и `$this->warn`. В `PostTextToSiteJob::handle` — ранний `release(120)` до блокировки.
- [ ] `routes/console.php`: `Schedule::command('posting:health')->everyMinute();`
- [ ] `scripts/app.py`: `START_TIME = time.time()`, `active_tasks = 0` + `tasks_lock = threading.Lock()`; функции `_task_started()`/`_task_finished()`; `background_publish`/`background_check` оборачиваются в `try/finally` с декрементом, инкремент перед `executor.submit`; `/health` → `{"status": "ok", "active_tasks": active_tasks, "uptime_seconds": int(time.time() - START_TIME)}`. Проверить `python3 -m py_compile scripts/app.py`.
- [ ] `php artisan test` — PASS. Commit `feat: мониторинг сервиса постинга и пауза публикаций при его простое`.

### Task 3: Виджет и страница настроек сервиса постинга

**Files:**
- Create: `app/Filament/Widgets/PostingServiceWidget.php`, `resources/views/filament/widgets/posting-service-widget.blade.php`, `app/Filament/Pages/ManagePostingSettings.php`
- Test: `tests/Feature/Filament/PostingServiceWidgetTest.php`

Виджет: `Filament\Widgets\Widget`, `$view`, `$sort = -10`, `$columnSpan = 'full'`, `$pollingInterval = '30s'` (через `wire:poll.30s` во вьюхе). Данные: `status()` монитора, `sendingCount = DB::table('text_site')->where('status','sending')->count()`, `errors24h = DB::table('text_site')->where('status','error')->where('updated_at','>=',now()->subDay())->count()`. Метод `checkNow()` → `refresh()` + Notification. Вьюха: `<x-filament-widgets::widget><x-filament::section>` с бейджем online/offline (`x-filament::badge` color success/danger), метриками в grid и кнопкой `<x-filament::button wire:click="checkNow">`.

Страница: `SettingsPage`, `$settings = PostingSettings::class`, группа «Постинг», поля `serviceUrl` (url, required), `timeout` (1–120), `healthTimeout` (1–30); `getFooterWidgets()` → `[PostingServiceWidget::class]`.

- [ ] Тесты: виджет рендерится offline без кеша («нет данных»); после `checkNow` с `Http::fake(['*/health' => ['status' => 'ok','active_tasks' => 3,'uptime_seconds' => 60]])` видит «online» и «3»; страница настроек сохраняет `serviceUrl`.
- [ ] Реализация, `php artisan test` — PASS. Commit `feat: виджет и страница настроек сервиса постинга`.

### Task 4: Новые поля GenerationSettings и AiService (диапазоны, теги, заголовок, банк ключей)

**Files:**
- Create: `database/settings/2026_10_01_110000_add_uniqueness_generation_settings.php`, `tests/Support/FakesGenerationSettings.php`
- Modify: `app/Settings/GenerationSettings.php`, `app/Services/Ai/AiService.php`, существующие тесты (`AiServiceTest`, `GenerateTextJobTest`, `ManageGenerationSettingsTest`) на общий трейт, `ManageGenerationSettings` (поле `temperature` → два поля, временно в той же вкладке; полная раскладка — Task 13)
- Test: `tests/Feature/Ai/AiServiceTest.php`

Settings-миграция: `temperatureMin/Max` = текущее `temperature` (через `$this->migrator->update`-подобное чтение: `$t = DB::table('settings')->where(['group'=>'generation','name'=>'temperature'])->value('payload')` → `json_decode`), `deleteIfExists('generation.temperature')`; остальные поля с дефолтами из спеки; `keywordsPrompt` заменяется на новый дефолт, если равен старому:
```
Ты SEO-спец. Придумай {count} разных ключевых фраз (1–4 слова) по теме "{topic}": высокочастотные, среднечастотные, низкочастотные, вопросы, с городами и уточнениями.
Только список через запятую. Без нумерации и пояснений.
Язык: {language}.
```
`getAvailableVariables()`: в `text` добавить `{persona}`, `{angle}`, `{structure}`, `{h2_count}`; в `keywords` — `{count}`.

**Interfaces — Produces (AiService):**
```php
public function chat(string $system, string $prompt, ?float $temperature = null, ?string $model = null, ?float $topP = null): string;
public function generateKeywordBank(string $topic, string $language, int $count): array; // list<string>, бросает AiException
public function parseKeywords(string $content): array; // разбор, lowercase, trim, без нумерации/кавычек/точек, уникальные, непустые
public function randomBetween(float $min, float $max): float; // равномерно, 2 знака; min>max → меняются местами
```
`generateKeywords()` удаляется. `cleanHtmlResponse($content, ?string $allowedTags = null)` → `settings->allowedTags`; `extractTitle` → `settings->defaultTitle`. В `withTemperature` → `withSampling($payload, $model, $temperature, $topP)`: для reasoning-моделей ни того ни другого.

- [ ] Трейт `FakesGenerationSettings::fakeGenerationSettings(array $overrides = [])` со всеми полями (значения из спеки, тестовые промпты). Перевести три существующих теста на него.
- [ ] Новые тесты: `parseKeywords("1. Казино онлайн,\n2) «Слоты»\nказино онлайн, ")` → `['казино онлайн','слоты']` (Review Focus #5); `randomBetween(1,1) === 1.0`, значение в границах; запрос `chat` содержит `temperature` и `top_p` в диапазонах для `gpt-4.1` и не содержит их для `gpt-5` (через подменённый `AiClients` с fake-клиентом `OpenAI\Testing\ClientFake` и `CreateStreamedResponse::fake`); `cleanHtmlResponse` уважает `allowedTags` из настроек; `extractTitle` — `defaultTitle`.
- [ ] `php artisan migrate && php artisan test` — PASS (тесты джобы на `generateKeywords` временно мокают `generateKeywordBank`? — нет: джоба переписывается в Task 9; до этого в джобе вызов `generateKeywords` заменить на `implode(',', $ai->generateKeywordBank($topic, $language, 7))` с try/catch → тема, а моки в тестах джобы — на `generateKeywordBank`).
- [ ] Commit `feat: диапазоны temperature/top_p, настраиваемые теги и заголовок, генерация банка ключей`.

### Task 5: Схема БД и модели

**Files:**
- Create: `database/migrations/2026_10_01_120000_create_generation_content_tables.php` (prompt_templates, prompt_modifiers, project_keywords), `2026_10_01_120100_create_trusted_links_tables.php` (trusted_link_groups, trusted_links, project_trusted_link_group, text_trusted_link, `projects.trusted_links_count`), `2026_10_01_120200_add_generation_meta_to_texts_table.php`
- Create: модели `PromptTemplate`, `PromptModifier` (константы `TYPE_PERSONA='persona'`, `TYPE_ANGLE='angle'`, скоупы `active()`, `persona()`, `angle()`), `ProjectKeyword`, `TrustedLinkGroup` (`links()`, `projects()`, скоуп `active()`), `TrustedLink` (`group()`, `texts()`, `saving` → `url = trim(url)`, `url_hash = hash('sha256', url)`, скоуп `active()`)
- Modify: `Project` (`trustedLinkGroups(): BelongsToMany`, `keywords(): HasMany`, fillable `trusted_links_count`), `Text` (`promptTemplate`, `persona`, `angle`, `similarText`, `trustedLinks(): BelongsToMany` через `text_trusted_link` с `created_at`; fillable новых полей, cast `similarity` → `float`)
- Test: `tests/Feature/Models/GenerationModelsTest.php`

- [ ] Тесты: `TrustedLink` заполняет `url_hash`, дубль URL в той же группе → `UniqueConstraintViolationException`, в другой — ок; удаление группы каскадно удаляет ссылки; связи проекта и текста работают; удаление шаблона обнуляет `texts.prompt_template_id`.
- [ ] Миграции, модели, `php artisan migrate`, PASS. Commit `feat: таблицы шаблонов, модификаторов, банка ключей и трастовых ссылок`.

### Task 6: Трастовые ссылки на БД, импорт и перенос `.txt`

**Files:**
- Create: `app/Services/TrustedLinks/LegacyFileName.php`, `app/Services/TrustedLinks/TrustedLinksImporter.php`, `database/migrations/2026_10_01_130000_import_trusted_links_from_files.php`
- Modify: `app/Services/TrustedLinksResolver.php` (полностью)
- Test: `tests/Unit/Services/LegacyFileNameTest.php`, `tests/Feature/TrustedLinks/TrustedLinksImporterTest.php`, `tests/Feature/TrustedLinks/TrustedLinksResolverTest.php` (старый unit-тест удаляется, тесты `detectTopicAndCity` переносятся)

**Interfaces — Produces:**
```php
final class LegacyFileName { public static function parse(string $basename): array; } // ['topic'=>..., 'city'=>?string, 'language'=>?string]
class TrustedLinksImporter {
    /** @return array{added:int, duplicates:int, invalid:int} */
    public function import(TrustedLinkGroup $group, string $raw): array;
}
class TrustedLinksResolver {
    public function pick(Project $project, string $topic, string $language, int $count): Collection; // Collection<TrustedLink>
    public function block(Collection $links): string;
    public function markUsed(Text $text, Collection $links): void;
    public function detectTopicAndCity(string $topic): array; // без изменений
    protected function groupIds(Project $project, string $topic, string $language): array;
}
```
Импорт: снять BOM, разбить по `\R`, `trim`, пустые и начинающиеся с `#` пропустить; строка делится по первому `;` или `,` за пределами URL — `preg_match('/^(\S+?)\s*[;,]\s*(.+)$/u')`, иначе вся строка — URL; валидность `filter_var(FILTER_VALIDATE_URL)` + схема http/https; дубли — по хешу внутри группы и внутри самого ввода. Вставка `insertOrIgnore` пачками по 500.

Fallback `groupIds`: выбранные активные группы проекта с `language IN (lang) OR NULL`; если пусто, но выбранные есть — все выбранные активные; если не выбрано ни одной — цепочка `[topic, city, lang]`, `[topic, null, lang]`, `[topic, any, any]`, `['general', null, lang]`, `['general', any, any]`, первая непустая по активным группам, где есть активные ссылки.
Выбор: `TrustedLink::active()->whereIn('trusted_link_group_id', $ids)->orderByRaw('used_count / GREATEST(weight, 1)')->inRandomOrder()->limit($count)->get()`.
`markUsed`: `$text->trustedLinks()->syncWithoutDetaching(ids)` + `TrustedLink::whereIn('id', ids)->increment('used_count')`.

Миграция данных: для каждого `storage_path('app/trusted_links/*.txt')` — `LegacyFileName::parse`, `TrustedLinkGroup::firstOrCreate(['name' => basename])`, `importer->import`. `down()` — удалить группы с именами, совпадающими с файлами.

- [ ] Тесты `LegacyFileName`: `escort-dubai-en.txt` → escort/dubai/en; `casino-ru` → casino/null/ru; `general` → general/null/null; `escort-new-york-en` → escort/new-york/en; `casino` → casino/null/null.
- [ ] Тесты импорта (Review Focus #4): BOM + пробелы + пустые + `#коммент` + `https://a.com;Анкор` + `https://b.com, Анкор Б` + `not a url` + `ftp://x` + дубль в вводе + дубль с уже существующей → `added=2, duplicates=2, invalid=2`, анкоры сохранены.
- [ ] Тесты резолвера: выбранные группы проекта имеют приоритет над fallback; фильтр по языку и откат на все выбранные группы; fallback-цепочка (город → тема+язык → general); неактивные группы и ссылки игнорируются; сначала наименее использованные; `count` больше доступного → все; проект без групп и без совпадений → пустая коллекция и `block()` → `''` (Review Focus #1); `markUsed` пишет pivot и инкрементирует.
- [ ] Реализация, `php artisan migrate` (на dev-базе перенесутся реальные файлы — проверить `TrustedLinkGroup::withCount('links')`), PASS. Commit `feat: трастовые ссылки в БД с импортом и переносом из файлов`.

### Task 7: Взвешенный выбор, PromptComposer и стартовые данные

**Files:**
- Create: `app/Support/WeightedRandom.php`, `app/Services/Generation/ComposedPrompt.php`, `app/Services/Generation/PromptComposer.php`, `database/seeders/GenerationContentSeeder.php`, `database/migrations/2026_10_01_130100_seed_generation_content.php`
- Test: `tests/Unit/Support/WeightedRandomTest.php`, `tests/Feature/Generation/PromptComposerTest.php`

**Interfaces — Produces:**
```php
class WeightedRandom {
    public function __construct(?Closure $random = null); // fn(int $min, int $max): int, по умолчанию random_int
    public function pick(iterable $items, string $weightKey = 'weight'): mixed; // null, если нет элементов с весом > 0
}
final class ComposedPrompt {
    public function __construct(public string $template, public array $variables, public ?int $templateId, public ?int $personaId, public ?int $angleId);
}
class PromptComposer {
    public function __construct(GenerationSettings $settings, WeightedRandom $random);
    /** @param array{template?: ?int, persona?: ?int, angle?: ?int} $exclude */
    public function compose(Project $project, ProjectLink $link, string $keywords, string $trustedLinksBlock, int $trustedLinksCount, array $exclude = []): ComposedPrompt;
    public function length(int $base): int;      // base ± lengthVariancePercent, минимум 1
    public function structure(int $h2Count): string;
    protected function chance(int $percent): bool;
}
```
`variables`: `project, topic, keywords, length, language, link_url, link_anchor, trusted_links, trusted_links_count, persona, angle, structure, h2_count`.
Исключение прошлой попытки работает, только если есть другие кандидаты (иначе берётся из всех).

Сидер: 7 шаблонов, 10 персон, 15 углов; вставляет в таблицу, только если она пуста. Шаблоны используют все переменные и сохраняют правила текущего `textPrompt` (H1 + абзац, одна основная ссылка не в заголовке, трастовые ссылки в разных местах тегом `<a>` без анкора, без `<body>/<html>/<em>/<strong>`, только HTML, язык). Миграция данных вызывает `(new GenerationContentSeeder)->run()`.

- [ ] Тесты `WeightedRandom`: детерминированный `random` → ожидаемый элемент на границах весов; нулевые веса не выбираются; пустой набор → null.
- [ ] Тесты композера (Review Focus #2): промпт проекта приоритетнее шаблонов (`templateId = null`); выбирается активный шаблон, неактивный — никогда; без шаблонов → `settings->textPrompt`; без персон/углов → `''`; исключение прошлого шаблона при наличии альтернативы и без неё; `structure` при вероятностях 0 и 100; `length(1000)` при 20% ∈ [800, 1200]; `h2_count` ∈ [h2Min, h2Max].
- [ ] Реализация, `php artisan migrate`, PASS. Commit `feat: пул шаблонов, персоны и углы подачи, случайная структура`.

### Task 8: Банк ключевых слов

**Files:**
- Create: `app/Services/Generation/KeywordBank.php`
- Test: `tests/Feature/Generation/KeywordBankTest.php`

**Interfaces — Produces:**
```php
class KeywordBank {
    public function __construct(AiService $ai, GenerationSettings $settings);
    public function take(Project $project, string $language): string; // 'k1,k2,...' или тема при пустом банке и ошибке
    public function fill(Project $project, string $language): int;     // догенерировать, вернуть кол-во добавленных
    public function regenerate(Project $project, string $language): int;
}
```
`take`: если ключей языка нет — `fill` (ошибка AI → `Log::warning`, вернуть тему). Затем `rand(min,max)` ключей `orderBy('used_count')->inRandomOrder()`, `increment('used_count')` по id, вернуть `shuffle` через запятую. `fill` сохраняет через `insertOrIgnore` (уникальный индекс).

- [ ] Тесты: пустой банк → один вызов `generateKeywordBank(topic, lang, keywordsBankSize)`, ключи сохранены; повторный `take` не зовёт AI; выдаются наименее использованные (подготовить used_count 0/5); количество в [min, max]; ошибка AI при пустом банке → тема; банки языков независимы; `regenerate` заменяет ключи.
- [ ] Реализация, PASS. Commit `feat: банк ключевых слов проекта`.

### Task 9: Контроль похожести

**Files:**
- Create: `app/Services/Generation/SimilarityChecker.php`
- Test: `tests/Feature/Generation/SimilarityCheckerTest.php`

**Interfaces — Produces:**
```php
class SimilarityChecker {
    public function __construct(GenerationSettings $settings);
    public function shingles(string $html): array;          // array<int,true>
    public function jaccard(array $a, array $b): float;     // 0..100, 2 знака; оба пустые → 0
    /** @return array{similarity: float, text_id: ?int} */
    public function mostSimilar(Text $text, string $html): array;
}
```
- [ ] Тесты: одинаковые тексты → 100; разные → < 10; половина общего → в разумных пределах (20–70); теги и регистр не влияют; сравнение только с текстами того же проекта и не с самим собой; учитываются последние `dedupCompareLast`.
- [ ] Реализация, PASS. Commit `feat: проверка похожести текстов по шинглам`.

### Task 10: Оркестрация в GenerateTextJob

**Files:**
- Modify: `app/Jobs/GenerateTextJob.php`, `tests/Feature/Jobs/GenerateTextJobTest.php`

`handle(AiService $ai, TrustedLinksResolver $trustedLinks, GenerationSettings $settings, KeywordBank $keywordBank, PromptComposer $composer, SimilarityChecker $similarity)`.
Поток — как в спеке (раздел «GenerateTextJob — новый порядок»). Лучшая попытка — с минимальным `similarity`. `generation_attempts` — число сделанных попыток. `markUsed` — после `update`. При `dedupEnabled=false` проверка не вызывается, `similarity` всё равно считается один раз (для колонки), без перегенераций.

- [ ] Переписать тесты джобы на моки `KeywordBank`, `PromptComposer` (или реальные с данными), `SimilarityChecker`, `TrustedLinksResolver::pick/block/markUsed`. Новые: дубль выше порога → вторая попытка с `exclude` прошлых id, сохраняется менее похожая; все попытки похожи → сохраняется лучшая, статус `generated`; мета-поля сохранены; `trusted_links_count` проекта приоритетнее глобального; ссылки выключены → `pick` не вызывается; ошибка AI → `markUsed` не вызывается.
- [ ] Реализация, PASS. Commit `feat: GenerateTextJob на шаблонах, банке ключей и контроле дублей`.

### Task 11: Админка шаблонов и модификаторов

**Files:**
- Create: `app/Filament/Resources/PromptTemplateResource.php` (+ Pages List/Create/Edit), `app/Filament/Resources/PromptModifierResource.php` (+ Pages; List с `getTabs()` «Все/Персоны/Углы»)
- Modify: `ManageGenerationSettings::$navigationGroup = 'Генерация'`
- Test: `tests/Feature/Filament/PromptResourcesTest.php`

Шаблон: `name` (required), `body` (Textarea rows 18, required, helper `variablesHelperText('text')`), `weight` (integer 0–100, default 1), `is_active`. Таблица: name, weight, `ToggleColumn is_active`, `texts_count` (`->counts('texts')`, нужна связь `PromptTemplate::texts()`), updated_at; действие `ReplicateAction` с суффиксом «(копия)». Модификатор: `type` (Select), `body` (Textarea rows 3), `weight`, `is_active`.

- [ ] Тесты: список рендерится; создание шаблона и модификатора; вкладка «Углы» фильтрует.
- [ ] Реализация, PASS. Commit `feat: админка шаблонов промптов, персон и углов`.

### Task 12: Админка трастовых ссылок

**Files:**
- Create: `app/Filament/Resources/TrustedLinkGroupResource.php` (+ Pages), `.../TrustedLinkGroupResource/RelationManagers/LinksRelationManager.php`
- Test: `tests/Feature/Filament/TrustedLinkGroupResourceTest.php`

Группа: name, topic (helper: «escort, casino, general…»), city (nullable), language (nullable, helper «пусто — любой язык»), is_active. Таблица: name, topic, city, language, `links_count` (активные: `->counts(['links' => fn ($q) => $q->where('is_active', true)])`), `links_sum_used_count` (`->sum('links', 'used_count')`), ToggleColumn. Действие «Импорт» в таблице и в шапке Edit: Textarea `raw` + FileUpload `file` (`acceptedFileTypes(['text/plain','text/csv'])`, `storeFiles(false)`), склейка содержимого, `TrustedLinksImporter::import`, Notification «Добавлено N, дублей M, невалидных K».
Links RM: url (url, required), anchor, weight, is_active, used_count (readonly), `texts_count` (`->counts('texts')`); bulk вкл/выкл/удалить; поиск по url. Использование: действие строки «Тексты» открывает модалку со списком (`modalContent` → view `filament.trusted-links.usage` с последними 50 текстами ссылки: id, заголовок, проект, дата из pivot). Отдельного RelationManager «Использование» нет — у группы нет прямой связи с текстами, а `used_count` + `texts_count` + модалка отвечают на вопрос «какие ссылки ушли в какой текст». Дополнительно в форме текста видны его трастовые ссылки (Task 13).
- Create также: `UsageRelationManager` не создаётся; `resources/views/filament/trusted-links/usage.blade.php`.

- [ ] Тесты: импорт через action на Edit-странице создаёт ссылки и шлёт уведомление; создание группы; список рендерится.
- [ ] Реализация, PASS. Commit `feat: админка трастовых ссылок с импортом`.

### Task 13: Проект, тексты и страница настроек генерации

**Files:**
- Modify: `app/Filament/Resources/ProjectResource.php`, `TextsRelationManager.php`, `TextResource.php`, `app/Filament/Pages/ManageGenerationSettings.php`
- Create: `app/Filament/Resources/ProjectResource/RelationManagers/ProjectKeywordsRelationManager.php`
- Test: `tests/Feature/Filament/ProjectResourceGenerationTest.php`, `tests/Feature/Filament/ManageGenerationSettingsTest.php`

Проект: секция «Трастовые ссылки» (collapsed): `Select::make('trustedLinkGroups')->relationship('trustedLinkGroups','name')->multiple()->preload()`, `trusted_links_count` (integer 0–10, placeholder из настроек). Keywords RM: keyword, language, used_count; Create/Delete; header action «Перегенерировать банк» (Select языка из `project->links()->distinct()->pluck('language')`) → `KeywordBank::regenerate`, Notification.
Тексты (RM и ресурс): колонка `similarity` (`->suffix('%')`, цвет по порогу из настроек, sortable), `promptTemplate.name` (toggleable), фильтр `Filter::make('similar')` (`similarity >= dedupThreshold`). В форме RM — Placeholder «Генерация»: шаблон, персона, угол, попытки, похожесть, трастовые ссылки.
Настройки: вкладки «Модель» (модели, `temperatureMin/Max`, `topPMin/Max`), «Системные промпты», «Текст» (+ подсказка «Используется, если нет активных шаблонов»), «Уникальность» (`lengthVariancePercent`, `h2Min/h2Max`, `listProbability`, `faqProbability`), «Дубли», «Ключевые слова» (`keywordsPrompt`, `keywordsBankSize`, `keywordsPerTextMin/Max`), «Трастовые ссылки» (toggle, count, ссылка на ресурс групп), «Вывод» (`allowedTags`, `defaultTitle`). Валидация пар min ≤ max через `->lte('…Max')`.

- [ ] Тесты: сохранение групп и `trusted_links_count` в проекте; settings-страница заполняется всеми полями и сохраняет `temperatureMin`; min > max → ошибка формы.
- [ ] Реализация, PASS. Commit `feat: трастовые ссылки и банк ключей в проекте, похожесть в текстах, вкладки настроек`.

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

- [ ] `php artisan test` — всё зелёное.
- [ ] `php artisan migrate:status` — все миграции Ran; `php artisan schedule:list` содержит `posting:health`.
- [ ] Ручной смоук админки в браузере: страницы «Шаблоны», «Персоны и углы», «Трастовые ссылки» (группы перенесены из файлов), проект (группы, ключи), настройки генерации, «Сервис постинга» + виджет на дашборде.
- [ ] `grep -ri "127.0.0.1:8001\|kraken" app` — пусто.
- [ ] Финальное ревью ветки.
