Files
portal/app/tests/Feature/ClientTg/PollModerationTest.php
T
Дмитрий f70527c3df fix,деньги: телеграм-реклама переведена на рекламный кошелёк с заморозкой — робот наконец платит МТС
🔴 Найдено чтением кода, а не по памяти: робот НИКОГДА не оплачивал кампанию.
finalize доводил боевой запуск до кассы кабинета и уходил (launched:false,
stoppedAt:'payment'), денежные кнопки ему были запрещены наглухо, а «реальная
оплата» отложена на «Сессию 6», которой не случилось. Песочницу при этом
выключили 02.08 в 07:40.

Итог на бою: клиент жал «Запустить» → у него списывалась ВСЯ смета по размеру
списка → в кабинете оставался неоплаченный черновик → на модерацию он не уходил
→ реклама не показывалась ни разу → деньги не возвращались никогда (статус
draft_ready терминальный, возврата не имеет).

То есть беда была не «клиент переплачивает разницу», как записали накануне, а
«клиент платит сто процентов ни за что». Слепки установленного у владельца
робота совпали с веткой до буквы — на боевой машине тот же код.

Владелец решил: боевой не трогать (стоит как стоит), роботу денежную кнопку
разрешить, но с потолком.

── Робот теперь платит ────────────────────────────────────────────────────────

submitWithPayment на шаге /payment: сперва ЧИТАЕТ сумму к оплате, потом гонит её
через гейт против меньшего из двух потолков (лимит кампании и общий потолок
робота), и только потом ищет кнопку и жмёт. Сумма не прочиталась — не платим:
не знаем, что списываем. Не ушли со /payment после клика — падаем громко, портал
по отказу отпустит заморозку.

Общий чёрный список денежных кнопок НЕ ослаблен: та же кнопка остаётся запретной
для всех прочих путей, включая пересдачу. Разрешение точечное.

Прочитанная сумма — это НАШИ расходы у МТС; она едет в портал полем
actualCostRub, которое до сих пор было пустой заготовкой.

── Кошелёк вместо общего баланса ──────────────────────────────────────────────

Порядок зеркалит сам МТС (билинг снят живьём 27–28.07, FLOW-FINDINGS «Задача
2.0»: кабинет резервирует сумму, окончательно списывает по факту показов,
остаток возвращает):

  запуск          → морозим смету на ad_wallets (канал telegram)
  робот заплатил  → фактическая сумма легла в кампанию (mts_cost_rub, v9.66)
  модерация «да»  → списываем по факту × наценка, остаток отпускаем
  модерация «нет» → отпускаем всё, ни рубля не списано
  сбой до кабинета → отпускаем всё

Заморозка была убрана 29.07 намеренно — тогда рассуждали «сумма известна в момент
запуска, морозить нечего». Рассуждение верно ровно до вопроса владельца: сумма
известна, а сколько человек из списка вообще есть в телеграме — нет.

Факта нет, а модерация одобрила — НЕ списываем ничего и кричим в журнал. Списать
«по оценке» значило бы вернуть ровно ту беду, ради которой всё и делалось.

Идемпотентность больше не самодельная: бронь уникальна по кампании, списание — по
ключу события. Прежнее «сальдо проводок» стало не нужно, CampaignChargeServiceTest
удалён — его предмет (charge/refund по общему балансу) больше не существует,
замена KoshelekTelegramaTest.

── Экран ──────────────────────────────────────────────────────────────────────

Карточка денег показывала общий баланс портала. После переезда это стало прямым
враньём: клиент видел бы «денег хватает» там, где запуск отвечает 409. Теперь
ручка отдаёт СВОБОДНЫЕ деньги кошелька (баланс минус заморозка) и заморозку
отдельной графой, а кнопка пополнения ведёт в рекламный кошелёк — прежняя клала
бы деньги в общий баланс, и запустить рекламу всё равно было бы нельзя.

── Проверено вырезанием, а не только зелёным ─────────────────────────────────

- убрал запрет «сумма не прочитана» — покраснели 2 датчика оплаты;
- вернул списание по смете вместо факта — датчик поймал 315 ₽ там, где должно
  быть 210 ₽.

Замеры: телеграм-модуль 330/330, вместе с рекламой и СМС 1078/1078, экраны
251 файл / 2033 теста / 0 падений, робот 160/160, статанализ 0, типы 0, формат чисто.

Сторож денег под боевой ролью переписан: класс «тихий ноль» закрылся сам —
AdWalletService ставит контекст клиента сам, а не надеется на вызывающего.

🔴 На боевой НЕ выкачено. Осталось открытым: показать клиенту строкой
«заморожено / списано по факту / возвращено» на карточке кампании; пересдача
по-прежнему шлёт «без оплаты» (кампания вернётся на модерацию неоплаченной);
числа 0,720 и 0,816 за показ с медиа так и не замерены живьём.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-08-03 12:31:21 +03:00

186 lines
9.4 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\PollTelegramModerationJob;
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 App\Services\NotificationService;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
use Mockery\MockInterface;
use Tests\Concerns\SharesSupplierPdo;
// Опросчик перечисляет moderating-кампании через pgsql_supplier (BYPASSRLS).
// Шарим PDO, иначе данные транзакции RefreshDatabase не видны supplier-соединению.
uses(RefreshDatabase::class, SharesSupplierPdo::class);
/**
* Задача 3.4 — PollTelegramModerationJob: опросчик вердикта модерации МТС.
*
* Живая отправка робота ставит `moderating` (задача 3.2). Опросчик раз в цикл
* читает кабинет роботом-читалкой (в тестах — мок) по `mts_campaign_id` и применяет
* вердикт:
* — `rejected` → статус `rejected` + причина; ВОЗВРАТ списанной сметы на ОБЩИЙ
* баланс тенанта (в бою); уведомление «отклонена»;
* — `approved` → `launched`; СПИСАНИЕ ПО ФАКТУ кабинета МТС (mts_cost_rub × наценка),
* остаток замороженной сметы отпускается; уведомление «одобрена»;
* — `moderating` (ещё не проверено) / робот не смог прочитать → НЕ трогаем, ждём
* следующего цикла (деньги/статус без изменений).
*
* Денежная модель с 03.08.2026 — РЕКЛАМНЫЙ КОШЕЛЁК с заморозкой: запуск морозит смету,
* этот узел (и только он) превращает заморозку в списание по факту либо отпускает её.
*/
/** Кампания в заданном статусе (self-contained), смета ненулевая. */
function pollCampaign(int $tenantId, string $status, ?string $mtsId = null, string $estimatedCost = '315.00', ?string $mtsCost = '150.00'): Campaign
{
return Campaign::query()->create([
'tenant_id' => $tenantId,
'status' => $status,
'mts_campaign_id' => $mtsId,
// Факт с кассы кабинета: столько кампания стоила НАМ. Клиенту 150 × 1,40 = 210 ₽.
'mts_cost_rub' => $mtsCost,
'ad_text' => 'Опрос-тест',
'ord_category' => 'Размещение рекламы',
'budget_cap_rub' => '1000.00',
'audience_kind' => Campaign::AUDIENCE_LIST,
'planned_count' => 0,
'estimated_cost_rub' => $estimatedCost,
'created_by' => 1,
]);
}
/** «Уже заморожено при запуске»: морозит смету кампании на рекламном кошельке. */
function pollChargeCampaign(Tenant $tenant, Campaign $campaign): void
{
DB::statement('SET LOCAL app.current_tenant_id = '.$tenant->id);
tgKoshelekTopup($tenant->id, '5000.00');
app(TelegramCampaignChargeService::class)->freeze($campaign, (string) $campaign->estimated_cost_rub);
}
/** Подменяет робота-читалку мок-результатом. */
function pollMockRobot(RobotResult $result): void
{
$mock = Mockery::mock(TelegramRobotRunner::class);
$mock->shouldReceive('readModeration')->andReturn($result);
app()->instance(TelegramRobotRunner::class, $mock);
}
/** Мок NotificationService для проверки, какое уведомление ушло. */
function pollMockNotifications(): MockInterface
{
$mock = Mockery::mock(NotificationService::class);
app()->instance(NotificationService::class, $mock);
return $mock;
}
it('RobotResult знает moderationStatus и разбирает его из JSON робота', function () {
$r = RobotResult::fromRobotJson(['ok' => true, 'moderationStatus' => 'rejected', 'reason' => 'нельзя']);
expect($r->moderationStatus)->toBe('rejected')
->and($r->reason)->toBe('нельзя');
// Отсутствие поля → null (робот его пока не прислал).
expect(RobotResult::fromRobotJson(['ok' => true])->moderationStatus)->toBeNull();
});
it('вердикт «отклонена» → rejected + причина, заморозка отпущена целиком, уведомление «отклонена»', function () {
config()->set('client_tg.sandbox', false);
$t = Tenant::factory()->create(['balance_rub' => '5000.00']);
$c = pollCampaign($t->id, Campaign::STATUS_MODERATING, '2231134', '315.00');
// Уже заморожено при запуске кампании → смета занята.
pollChargeCampaign($t, $c);
expect(tgKoshelekFrozen($t->id))->toBe('315.00');
pollMockRobot(new RobotResult(ok: true, moderationStatus: 'rejected', reason: 'Ссылка недоступна'));
$notify = pollMockNotifications();
$notify->shouldReceive('notifyTelegramCampaignRejected')->once();
$notify->shouldReceive('notifyTelegramCampaignApproved')->never();
PollTelegramModerationJob::dispatchSync();
$fresh = Campaign::find($c->id);
expect($fresh->status)->toBe(Campaign::STATUS_REJECTED)
->and($fresh->status_reason)->toBe('Ссылка недоступна')
// Отказ отпустил всю заморозку — ни рубля не списано.
->and(tgKoshelekFrozen($t->id))->toBe('0.00')
->and(tgKoshelekBalance($t->id))->toBe('5000.00');
});
it('вердикт «одобрена» → launched, списание ПО ФАКТУ, остаток сметы отпущен', function () {
config()->set('client_tg.sandbox', false);
$t = Tenant::factory()->create(['balance_rub' => '5000.00']);
$c = pollCampaign($t->id, Campaign::STATUS_MODERATING, '2231140', '315.00');
// Заморожено при запуске; одобрение превращает заморозку в списание по факту.
pollChargeCampaign($t, $c);
pollMockRobot(new RobotResult(ok: true, moderationStatus: 'approved'));
$notify = pollMockNotifications();
$notify->shouldReceive('notifyTelegramCampaignApproved')->once();
$notify->shouldReceive('notifyTelegramCampaignRejected')->never();
PollTelegramModerationJob::dispatchSync();
// Списано 150 × 1,40 = 210 ₽ (факт кабинета), а не 315 ₽ сметы по размеру списка.
expect(Campaign::find($c->id)->status)->toBe(Campaign::STATUS_LAUNCHED)
->and((string) Campaign::find($c->id)->actual_cost_rub)->toBe('210.00')
->and(tgKoshelekBalance($t->id))->toBe('4790.00')
->and(tgKoshelekFrozen($t->id))->toBe('0.00');
});
it('вердикт «ещё на модерации» → остаётся moderating, без уведомлений и без денег', function () {
config()->set('client_tg.sandbox', false);
$t = Tenant::factory()->create(['balance_rub' => '5000.00']);
$c = pollCampaign($t->id, Campaign::STATUS_MODERATING, '2231150', '315.00');
pollChargeCampaign($t, $c);
pollMockRobot(new RobotResult(ok: true, moderationStatus: 'moderating'));
$notify = pollMockNotifications();
$notify->shouldReceive('notifyTelegramCampaignRejected')->never();
$notify->shouldReceive('notifyTelegramCampaignApproved')->never();
PollTelegramModerationJob::dispatchSync();
expect(Campaign::find($c->id)->status)->toBe(Campaign::STATUS_MODERATING)
// Ни списания, ни разморозки — смета как была занята, так и осталась.
->and(tgKoshelekFrozen($t->id))->toBe('315.00')
->and(tgKoshelekBalance($t->id))->toBe('5000.00');
});
it('робот не смог прочитать вердикт (moderationStatus=null) → moderating без изменений', function () {
config()->set('client_tg.sandbox', false);
$t = Tenant::factory()->create();
$c = pollCampaign($t->id, Campaign::STATUS_MODERATING, '2231160');
pollMockRobot(new RobotResult(ok: false, reason: 'кабинет не открылся'));
$notify = pollMockNotifications();
$notify->shouldReceive('notifyTelegramCampaignRejected')->never();
$notify->shouldReceive('notifyTelegramCampaignApproved')->never();
PollTelegramModerationJob::dispatchSync();
expect(Campaign::find($c->id)->status)->toBe(Campaign::STATUS_MODERATING);
});
it('moderating без mts_campaign_id не опрашивается (робот не зовётся)', function () {
config()->set('client_tg.sandbox', false);
$t = Tenant::factory()->create();
$c = pollCampaign($t->id, Campaign::STATUS_MODERATING, null);
// Робот-мок вернул бы approved, но кампанию без id опросчик даже не берёт.
pollMockRobot(new RobotResult(ok: true, moderationStatus: 'approved'));
$notify = pollMockNotifications();
$notify->shouldReceive('notifyTelegramCampaignApproved')->never();
PollTelegramModerationJob::dispatchSync();
expect(Campaign::find($c->id)->status)->toBe(Campaign::STATUS_MODERATING);
});