6f469fb13d
Денежная модель (куски 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>
179 lines
9.8 KiB
PHP
179 lines
9.8 KiB
PHP
<?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);
|
||
});
|