Files
portal/app/tests/Feature/ClientTg/AudienceGateTest.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

126 lines
5.6 KiB
PHP

<?php
declare(strict_types=1);
use App\Jobs\ClientTg\RunTelegramCampaignJob;
use App\Models\ClientTg\Campaign;
use App\Models\ClientTg\Contact;
use App\Models\Tenant;
use App\Models\User;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Queue;
/**
* Предстартовый гейт аудитории (находка #2, план §Задача 1.5): в БОЕВОМ режиме
* (sandbox=false) `launch` обязан проверить число кандидатов ДО списания денег.
* Минимум у МТС Маркетолог — 367 (client_tg.auto_batch_threshold); <367 или пусто —
* робот всё равно упал бы, но деньги уже были бы заняты. В песочнице гейта
* нет (денег нет вообще).
*
* Деньги с 03.08.2026 идут с РЕКЛАМНОГО кошелька и на запуске не списываются, а
* морозятся. «Гейт отсёк — деньги не тронуты» = заморозки нет; «гейт пройден» =
* смета занята на кошельке.
*
* Auth/tenant как в CampaignApiTest: Tenant::factory + User(tenant_id) + actingAs.
* Синтетические номера 7999… — реальные НИКОГДА.
*/
uses(RefreshDatabase::class);
beforeEach(function () {
$this->tenant = Tenant::factory()->create();
$this->user = User::factory()->create(['tenant_id' => $this->tenant->id]);
$this->actingAs($this->user);
config(['client_tg.sandbox' => false]);
});
it('<367 кандидатов в бою → launch 422, списания НЕ было, статус остаётся draft', function () {
tgKoshelekTopup($this->tenant->id, '5000.00');
for ($i = 0; $i < 10; $i++) {
Contact::create([
'tenant_id' => $this->tenant->id,
'phone' => sprintf('7999%07d', $i),
'name' => null,
'operator' => null,
]);
}
$campaign = Campaign::create([
'tenant_id' => $this->tenant->id, 'status' => Campaign::STATUS_DRAFT,
'ad_text' => 'x', 'ad_link' => 'https://t.me/x', 'ord_category' => 'Размещение рекламы',
'budget_cap_rub' => '1000.00', 'audience_kind' => Campaign::AUDIENCE_BASE,
'planned_count' => 10, 'estimated_cost_rub' => '0.00', 'created_by' => $this->user->id,
]);
Queue::fake();
$this->postJson("/api/telegram/campaigns/{$campaign->id}/launch")->assertStatus(422);
expect(Campaign::find($campaign->id)->status)->toBe(Campaign::STATUS_DRAFT);
// Гейт отсёк ДО денег: ни одной проводки списания, баланс не тронут.
DB::statement('SET LOCAL app.current_tenant_id = '.$this->tenant->id);
expect(tgKoshelekFrozen($this->tenant->id))->toBe('0.00');
expect(tgKoshelekBalance($this->tenant->id))->toBe('5000.00');
Queue::assertNothingPushed();
});
it('0 кандидатов в бою → launch 422, статус остаётся draft', function () {
tgKoshelekTopup($this->tenant->id, '5000.00');
$campaign = Campaign::create([
'tenant_id' => $this->tenant->id, 'status' => Campaign::STATUS_DRAFT,
'ad_text' => 'x', 'ad_link' => 'https://t.me/x', 'ord_category' => 'Размещение рекламы',
'budget_cap_rub' => '1000.00', 'audience_kind' => Campaign::AUDIENCE_BASE,
'planned_count' => 0, 'estimated_cost_rub' => '0.00', 'created_by' => $this->user->id,
]);
Queue::fake();
$this->postJson("/api/telegram/campaigns/{$campaign->id}/launch")->assertStatus(422);
expect(Campaign::find($campaign->id)->status)->toBe(Campaign::STATUS_DRAFT);
// Списания не было.
DB::statement('SET LOCAL app.current_tenant_id = '.$this->tenant->id);
expect(tgKoshelekFrozen($this->tenant->id))->toBe('0.00');
Queue::assertNothingPushed();
});
it('≥367 кандидатов + денег хватает в бою → launch OK, draft→queued, джоб поставлен, списание произошло', function () {
tgKoshelekTopup($this->tenant->id, '5000.00');
for ($i = 0; $i < 400; $i++) {
Contact::create([
'tenant_id' => $this->tenant->id,
'phone' => sprintf('7999%07d', $i),
'name' => null,
'operator' => null,
]);
}
$campaign = Campaign::create([
'tenant_id' => $this->tenant->id, 'status' => Campaign::STATUS_DRAFT,
'ad_text' => 'x', 'ad_link' => 'https://t.me/x', 'ord_category' => 'Размещение рекламы',
'budget_cap_rub' => '1000.00', 'audience_kind' => Campaign::AUDIENCE_BASE,
'planned_count' => 400, 'estimated_cost_rub' => '0.00', 'created_by' => $this->user->id,
]);
Queue::fake();
$this->postJson("/api/telegram/campaigns/{$campaign->id}/launch")
->assertOk()
->assertJsonPath('status', Campaign::STATUS_QUEUED);
Queue::assertPushed(RunTelegramCampaignJob::class);
// Гейт пройден → заморозили клиентскую смету (база×1.40) на кошельке: занято
// больше нуля, а сами деньги ещё у клиента. Точную сумму не ассертим — она
// зависит от числа кандидатов (clientEstimateRub), достаточно факта заморозки.
expect(bccomp(tgKoshelekFrozen($this->tenant->id), '0', 2))->toBeGreaterThan(0);
expect(tgKoshelekBalance($this->tenant->id))->toBe('5000.00');
});