Files
portal/app/tests/Feature/ClientTg/RunCampaignJobTest.php
T
Дмитрий b23d380d69 feat(телеграм-модуль): мост Laravel → Node-робот — статус-машина, обёртка робота, джоб, песочница
Сессия 2 плана docs/superpowers/plans/2026-07-27-client-telegram-ads-module.md.
Сердце модуля: по кампании запускаем браузер-робота кабинета МТС (у МТС нет API),
парсим его JSON и ведём статус-машину. В тестах робот замокан node-скриптами.

- Статус-машина Campaign: draft → queued → running → (draft_ready | launched |
  failed | rejected); недопустимый переход — DomainException, статус не меняется
  (глобальное исключение, а не доменный класс: deptrac Model: [], ADR-005).
  Терминальные статусы без исходящих (resubmit — Сессия 5).
- TelegramRobotRunner: формирует task.json и запускает `node bin/run.js --task <file>`
  через Symfony Process, разбирает {ok,matched,launched,campaignId}. Таймаут и
  непарсабельный вывод → аккуратный RobotResult::failed, воркер не падает.
- RunTelegramCampaignJob: queued → running, собирает кандидатов, пишет временный
  файл номеров (ПДн, чистится в finally), зовёт робота ВНЕ транзакции, итог пишет
  под tenant-контекстом (SET LOCAL). ok+draft → draft_ready + matched; ошибка → failed
  (причина в журнал — колонки нет, как у СМС-близнеца; показ клиенту — Сессия 5).
  Идемпотентно: работает только со статусом queued. Денег в песочнице не трогает.
- Песочница config/client_tg.php + .env.example: TG_SANDBOX (по умолчанию ВКЛ) —
  робот только draft, деньги/запуск выключены. Живой режим — осознанно в Сессии 6.

Реальная точка входа робота — bin/run.js --task (в плане текст «src/runner.js» —
вольная стенография). Живое списание отложено на Сессию 6: робот пока не возвращает
фактическую стоимость.

Проверки: 50 из 50 Pest зелёные (24 новых), phpstan 0 по своему коду, робот в тестах
замокан (кабинет МТС не тронут).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-27 16:51:12 +03:00

142 lines
5.7 KiB
PHP

<?php
declare(strict_types=1);
use App\Jobs\ClientTg\RunTelegramCampaignJob;
use App\Models\AdWallet;
use App\Models\ClientTg\Campaign;
use App\Models\ClientTg\CampaignPhone;
use App\Models\Tenant;
use App\Services\Advertising\AdWalletService;
use App\Services\ClientTg\RobotResult;
use App\Services\ClientTg\TelegramRobotRunner;
use Illuminate\Foundation\Testing\RefreshDatabase;
uses(RefreshDatabase::class);
/**
* Джоб запуска Telegram-кампании (план §Сессия 2, задача 2.3). Робот ЗАМОКАН.
* Песочница по умолчанию (TG_SANDBOX=true): mode=draft, деньги не списываются.
* queued → (робот ok+draft) → draft_ready + matched; ошибка робота → failed;
* идемпотентно по campaign_id (не-queued статус — джоб no-op).
*/
beforeEach(function () {
config()->set('client_tg.sandbox', true);
});
/** Кампания-список с двумя фейковыми номерами (ПДн в тестах не используем). */
function tgQueuedCampaign(int $tenantId): Campaign
{
$campaign = Campaign::query()->create([
'tenant_id' => $tenantId,
'status' => Campaign::STATUS_QUEUED,
'ad_text' => 'Приходите к нам за услугой',
'ad_link' => 'https://example.test/promo',
'ord_category' => 'Размещение рекламы',
'budget_cap_rub' => '1500.00',
'audience_kind' => Campaign::AUDIENCE_LIST,
'planned_count' => 2,
'estimated_cost_rub' => '0.00',
'created_by' => 1,
]);
foreach (['79990000001', '79990000002'] as $phone) {
CampaignPhone::query()->create([
'tenant_id' => $tenantId,
'campaign_id' => $campaign->id,
'phone' => $phone,
]);
}
return $campaign;
}
/** Подменяет раннер моком, возвращающим $result; захватывает переданные params. */
function mockRobot(RobotResult $result, ?array &$captured = null): void
{
$mock = Mockery::mock(TelegramRobotRunner::class);
$mock->shouldReceive('run')->andReturnUsing(function (array $params) use ($result, &$captured) {
$captured = $params;
return $result;
});
app()->instance(TelegramRobotRunner::class, $mock);
}
it('queued → робот ok+draft → draft_ready + matched записан', function () {
$tenant = Tenant::factory()->create();
$campaign = tgQueuedCampaign($tenant->id);
mockRobot(new RobotResult(ok: true, matched: 400, launched: false, campaignId: 'draft'), $captured);
RunTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
$fresh = Campaign::find($campaign->id);
expect($fresh->status)->toBe(Campaign::STATUS_DRAFT_READY)
->and($fresh->matched_count)->toBe(400);
});
it('в песочнице передаёт роботу mode=draft, бюджет-cap, текст, ссылку, ОРД и файл номеров', function () {
$tenant = Tenant::factory()->create();
$campaign = tgQueuedCampaign($tenant->id);
$captured = null;
mockRobot(new RobotResult(ok: true, matched: 400), $captured);
RunTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
expect($captured)->not->toBeNull()
->and($captured['mode'])->toBe('draft')
->and($captured['budgetRub'])->toBe('1500.00')
->and($captured['adText'])->toBe('Приходите к нам за услугой')
->and($captured['buttonUrl'])->toBe('https://example.test/promo')
->and($captured['ordCategory'])->toBe('Размещение рекламы')
->and($captured['phonesFile'])->toBeString()->not->toBeEmpty();
});
it('в песочнице деньги НЕ списываются', function () {
$tenant = Tenant::factory()->create();
app(AdWalletService::class)->topup($tenant->id, '5000.00', 'telegram', 'Пополнение');
$campaign = tgQueuedCampaign($tenant->id);
mockRobot(new RobotResult(ok: true, matched: 400));
RunTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
$wallet = AdWallet::where('tenant_id', $tenant->id)->first();
expect((string) $wallet->balance_rub)->toBe('5000.00')
->and((string) $wallet->frozen_rub)->toBe('0.00');
});
it('ошибка робота → статус failed', function () {
$tenant = Tenant::factory()->create();
$campaign = tgQueuedCampaign($tenant->id);
mockRobot(RobotResult::failed('Недостаточно номеров «не МТС»', 'upload'));
RunTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
expect(Campaign::find($campaign->id)->status)->toBe(Campaign::STATUS_FAILED);
});
it('идемпотентно: не-queued кампания — джоб no-op, робота не зовёт', function () {
$tenant = Tenant::factory()->create();
$campaign = tgQueuedCampaign($tenant->id);
$campaign->update(['status' => Campaign::STATUS_DRAFT_READY]);
$mock = Mockery::mock(TelegramRobotRunner::class);
$mock->shouldNotReceive('run');
app()->instance(TelegramRobotRunner::class, $mock);
RunTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
expect(Campaign::find($campaign->id)->status)->toBe(Campaign::STATUS_DRAFT_READY);
});
it('чистит временный файл номеров после запуска (ПДн)', function () {
$tenant = Tenant::factory()->create();
$campaign = tgQueuedCampaign($tenant->id);
$captured = null;
mockRobot(new RobotResult(ok: true, matched: 400), $captured);
RunTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
expect(file_exists($captured['phonesFile']))->toBeFalse();
});