Files
portal/app/tests/Feature/ClientTg/ResubmitJobTest.php
T
Дмитрий 6f469fb13d feat(телеграм-реклама): деньги на общем балансе + чистка СМС-фантазий + медиа объявления
Денежная модель (куски 1-2): реклама в Телеграме (МТС Маркетолог, робот-в-браузере)
оплачивается с ОБЩЕГО баланса тенанта (как СМС), наценка 40%. Списание при запуске,
возврат при отказе модерации/сбое/отмене (сальдо-идемпотентность tg_ad_charge/tg_ad_refund).
Старый рекламный кошелёк-заморозка убран из потока кампаний (таблицы ad_wallets НЕ удалены).
Новый TelegramCampaignChargeService (зеркало SmsChargeService); F5 money-safety сохранён
(сбой с mts_campaign_id → needs_review без возврата). Уборщик добивает зависшие queued с возвратом.

Чистка СМС-наследия (аудит модуля построчно 5 проверяющими): модуль ресейлит ПОКАЗЫ рекламы,
а не рассылку сообщений — вырезаны выдуманные сущности, механически скопированные из СМС:
- «имя/бренд отправителя» + помесячная абонплата (в телеге МТС имени отправителя нет):
  ChargeTgNameFeeJob, TelegramSenderService, SenderController, модели Sender/Setting,
  фронт-панель TelegramSenderPanel, админ-карточка, updateTgSettings, тип tg_name_fee.
  Таблицы client_tg_senders/_settings дропнуты.
- мёртвые таблицы client_tg_messages (доставка по номеру) и client_tg_templates (шаблоны
  сообщений) — без модели/использования, дропнуты (миграция 000017, create-миграции удалены).
- client_tg_optouts переосмыслен как ручной список «не показывать этим номерам» (не «отписки»).
- лексика рассылки → рекламы: «Авторассылка»→«Авто-реклама», «кошелёк/заморожено»→«общий баланс».

Медиа объявления (реальный пробел показов): новый POST /api/telegram/campaigns/{id}/media
(картинка/видео к черновику, png/jpg/gif/mp4 ≤50 МБ, замена удаляет старый файл) + поле
загрузки в форме кабинета. Робот уже принимал media_path (RunTelegramCampaignJob → mediaFile
→ cabinet.js fillAdMedia) — не хватало только приёма файла от клиента.

Схема: db/CHANGELOG_schema.md v8.94 (CHECK += tg_ad_charge/tg_ad_refund) + v8.95 (дроп
СМС-таблиц, tg_name_fee убран). Тесты зелёные поштучно (квирк партиций — гонять по одному):
Schema/Models/AdminTg/CampaignCharge/CampaignApi/Audience/Media; фронт advertising-telegram-view
19 + admin-tg/auto-rule 24. pint/deptrac(0) чисто; larastan исключён (Pest-$this шум). Робот
bots/mts-telegram-ads НЕ трогали.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-29 06:26:07 +03:00

179 lines
9.8 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
declare(strict_types=1);
use App\Jobs\ClientTg\ResubmitTelegramCampaignJob;
use App\Models\BalanceTransaction;
use App\Models\ClientTg\Campaign;
use App\Models\Tenant;
use App\Services\ClientTg\RobotResult;
use App\Services\ClientTg\TelegramCampaignChargeService;
use App\Services\ClientTg\TelegramRobotRunner;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
uses(RefreshDatabase::class);
/**
* Джоб ПЕРЕСДАЧИ отклонённой Telegram-кампании (связка Laravel → робот mode:'resubmit').
* Робот ЗАМОКАН. Пересдача ЧИНИТ ту же кампанию в кабинете (через «Исправить»), НЕ
* создаёт новую и НЕ грузит аудиторию заново. Песочница → submitMode=draft (не шлём);
* бой → submitMode=live (робот жмёт «без оплаты»). Приёмка —
* docs/superpowers/2026-07-28-resubmit-svyazka-ACCEPT.md.
*/
beforeEach(function () {
config()->set('client_tg.sandbox', true);
});
/** Кампания, поставленная контроллером в очередь на пересдачу (queued + id кабинета). */
function tgResubmitQueued(int $tenantId, array $overrides = []): Campaign
{
return Campaign::query()->create(array_merge([
'tenant_id' => $tenantId,
'status' => Campaign::STATUS_QUEUED,
'mts_campaign_id' => '2231134',
'ad_text' => 'Исправленный текст',
'ad_link' => 'https://t.me/new_channel',
'ord_category' => 'Размещение рекламы',
'moderator_file_path' => 'client_tg/moderator/licenziya.pdf',
'budget_cap_rub' => '1000.00',
'audience_kind' => Campaign::AUDIENCE_BASE,
'planned_count' => 400,
'estimated_cost_rub' => '0.00',
'created_by' => 1,
], $overrides));
}
/** Подменяет раннер моком, возвращающим $result; захватывает params. */
function mockResubmitRunner(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+resubmitted=false → draft_ready', function () {
$tenant = Tenant::factory()->create();
$campaign = tgResubmitQueued($tenant->id);
mockResubmitRunner(new RobotResult(ok: true, resubmitted: false, campaignId: '2231134'), $captured);
ResubmitTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
expect(Campaign::find($campaign->id)->status)->toBe(Campaign::STATUS_DRAFT_READY);
});
it('передаёт роботу mode=resubmit, id кабинета, submitMode, текст/ссылку/ОРД и документ', function () {
$tenant = Tenant::factory()->create();
$campaign = tgResubmitQueued($tenant->id);
$captured = null;
mockResubmitRunner(new RobotResult(ok: true, resubmitted: false, campaignId: '2231134'), $captured);
ResubmitTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
expect($captured)->not->toBeNull()
->and($captured['mode'])->toBe('resubmit')
->and($captured['campaignId'])->toBe('2231134')
->and($captured['submitMode'])->toBe('draft')
->and($captured['adText'])->toBe('Исправленный текст')
->and($captured['buttonUrl'])->toBe('https://t.me/new_channel')
->and($captured['ordCategory'])->toBe('Размещение рекламы')
->and($captured['moderatorFile'])->toBe('client_tg/moderator/licenziya.pdf');
});
it('бой: робот ok+resubmitted=true → moderating, id кабинета сохранён, submitMode=live', function () {
config()->set('client_tg.sandbox', false);
$tenant = Tenant::factory()->create();
$campaign = tgResubmitQueued($tenant->id);
$captured = null;
mockResubmitRunner(new RobotResult(ok: true, resubmitted: true, campaignId: '2231134'), $captured);
ResubmitTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
$fresh = Campaign::find($campaign->id);
expect($fresh->status)->toBe(Campaign::STATUS_MODERATING)
->and($fresh->mts_campaign_id)->toBe('2231134')
->and($captured['submitMode'])->toBe('live');
});
it('отказ робота (есть id кабинета) → needs_review, refund НЕ произошёл, списание держится, причина записана', function () {
config()->set('client_tg.sandbox', false);
$tenant = Tenant::factory()->create(['balance_rub' => '5000.00']);
DB::statement('SET LOCAL app.current_tenant_id = '.$tenant->id);
$campaign = tgResubmitQueued($tenant->id, ['estimated_cost_rub' => '1000.00']);
// «Уже списано»: списываем клиентскую смету с общего баланса тенанта.
app(TelegramCampaignChargeService::class)->charge($campaign, (string) $campaign->estimated_cost_rub);
expect((string) $tenant->fresh()->balance_rub)->toBe('4000.00');
mockResubmitRunner(RobotResult::failed('Не удалось войти в «Исправить»', 'resubmit-open'));
ResubmitTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
$fresh = Campaign::find($campaign->id);
expect($fresh->status)->toBe(Campaign::STATUS_NEEDS_REVIEW)
->and($fresh->status_reason)->toBe('Не удалось войти в «Исправить»');
// Refund НЕ произошёл (кампания могла уйти на модерацию) — списание держим,
// баланс не восстановлен, проводки возврата нет.
expect((string) $tenant->fresh()->balance_rub)->toBe('4000.00')
->and(BalanceTransaction::where('type', BalanceTransaction::TYPE_TG_AD_REFUND)
->where('related_id', $campaign->id)->count())->toBe(0);
});
it('перманентный сбой в queued (есть id кабинета) → failed + refund произошёл, баланс восстановлен (робот кабинет не трогал)', function () {
// Регресс I-1: у пересдачи queued ВСЕГДА с mts_campaign_id, но в queued Фаза A не
// закоммитила running → кабинет не тронут → безопасно failed + refund. Без правки
// кампания зависала бы в queued со списанными деньгами (уборщик queued не метёт).
config()->set('client_tg.sandbox', false);
$tenant = Tenant::factory()->create(['balance_rub' => '5000.00']);
DB::statement('SET LOCAL app.current_tenant_id = '.$tenant->id);
$campaign = tgResubmitQueued($tenant->id, ['estimated_cost_rub' => '1000.00']); // status queued + mts_campaign_id
// «Уже списано»: списываем клиентскую смету с общего баланса тенанта.
app(TelegramCampaignChargeService::class)->charge($campaign, (string) $campaign->estimated_cost_rub);
expect((string) $tenant->fresh()->balance_rub)->toBe('4000.00');
(new ResubmitTelegramCampaignJob($campaign->id, $tenant->id))->failed(new RuntimeException('воркер убит'));
expect(Campaign::find($campaign->id)->status)->toBe(Campaign::STATUS_FAILED);
// Refund произошёл — смета вернулась на общий баланс, проводка возврата записана.
expect((string) $tenant->fresh()->balance_rub)->toBe('5000.00')
->and(BalanceTransaction::where('type', BalanceTransaction::TYPE_TG_AD_REFUND)
->where('related_id', $campaign->id)->count())->toBe(1);
});
it('перманентный сбой в running (есть id кабинета) → needs_review, refund НЕ произошёл, списание держится (мог тронуть кабинет)', function () {
config()->set('client_tg.sandbox', false);
$tenant = Tenant::factory()->create(['balance_rub' => '5000.00']);
DB::statement('SET LOCAL app.current_tenant_id = '.$tenant->id);
$campaign = tgResubmitQueued($tenant->id, ['status' => Campaign::STATUS_RUNNING, 'estimated_cost_rub' => '1000.00']);
// «Уже списано»: списываем клиентскую смету с общего баланса тенанта.
app(TelegramCampaignChargeService::class)->charge($campaign, (string) $campaign->estimated_cost_rub);
expect((string) $tenant->fresh()->balance_rub)->toBe('4000.00');
(new ResubmitTelegramCampaignJob($campaign->id, $tenant->id))->failed(new RuntimeException('таймаут робота'));
expect(Campaign::find($campaign->id)->status)->toBe(Campaign::STATUS_NEEDS_REVIEW);
// Refund НЕ произошёл — списание держим до ручной сверки, баланс не восстановлен.
expect((string) $tenant->fresh()->balance_rub)->toBe('4000.00')
->and(BalanceTransaction::where('type', BalanceTransaction::TYPE_TG_AD_REFUND)
->where('related_id', $campaign->id)->count())->toBe(0);
});
it('идемпотентно: не-queued кампания — джоб no-op, робота не зовёт', function () {
$tenant = Tenant::factory()->create();
$campaign = tgResubmitQueued($tenant->id, ['status' => Campaign::STATUS_DRAFT_READY]);
$mock = Mockery::mock(TelegramRobotRunner::class);
$mock->shouldNotReceive('run');
app()->instance(TelegramRobotRunner::class, $mock);
ResubmitTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
expect(Campaign::find($campaign->id)->status)->toBe(Campaign::STATUS_DRAFT_READY);
});