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

150 lines
7.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\RunTelegramCampaignJob;
use App\Models\ClientTg\Campaign;
use App\Models\ClientTg\CampaignPhone;
use App\Models\Tenant;
use App\Models\User;
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);
/**
* Задача 2.3 — ОТПУСКАНИЕ заморозки на рекламном кошельке (с 03.08.2026; было — возврат
* на общий баланс тенанта, как в
* СМС) при отказе робота (finalize), перманентном сбое джоба (failed) и отмене
* кампании (cancel). Старого рекламного кошелька с freeze/frozen_rub больше нет:
* деньги списываются на запуске (charge) и возвращаются (refund) через
* TelegramCampaignChargeService. Источник правды идемпотентности — сальдо проводок
* balance_transactions (TYPE_TG_AD_CHARGE TYPE_TG_AD_REFUND по related Campaign).
*
* Ключевые развилки, которые проверяем:
* - отказ робота БЕЗ mts_campaign_id → failed + refund (деньги вернулись);
* - песочница → денег не списывали, refund не зовётся (сальдо 0);
* - cancel из draft → списания не было → refund no-op (баланс цел);
* - cancel из running → 422 (машина статусов);
* - cancel в песочнице → денег не трогали.
*
* Все денежные тесты по умолчанию в БОЕВОМ режиме (sandbox=false).
* Синтетические номера 7999… — реальные НИКОГДА.
*/
beforeEach(function () {
config()->set('client_tg.sandbox', false);
});
/** Кампания-список заданного статуса с двумя фейковыми номерами и ненулевой сметой. */
function refundCampaign(int $tenantId, string $status, string $estimatedCost = '315.00'): Campaign
{
$campaign = Campaign::query()->create([
'tenant_id' => $tenantId,
'status' => $status,
'ad_text' => 'Приходите к нам за услугой',
'ad_link' => 'https://example.test/promo',
'ord_category' => 'Размещение рекламы',
'budget_cap_rub' => '500.00',
'audience_kind' => Campaign::AUDIENCE_LIST,
'planned_count' => 2,
'estimated_cost_rub' => $estimatedCost,
'created_by' => 1,
]);
foreach (['79990000001', '79990000002'] as $phone) {
CampaignPhone::query()->create([
'tenant_id' => $tenantId,
'campaign_id' => $campaign->id,
'phone' => $phone,
]);
}
return $campaign;
}
/** Подменяет раннер моком, возвращающим $result. */
function refundMockRobot(RobotResult $result): void
{
$mock = Mockery::mock(TelegramRobotRunner::class);
$mock->shouldReceive('run')->andReturn($result);
app()->instance(TelegramRobotRunner::class, $mock);
}
it('отказ робота (без mts_id) отпускает замороженную смету', function () {
$tenant = Tenant::factory()->create(['balance_rub' => '0.00']);
DB::statement('SET LOCAL app.current_tenant_id = '.$tenant->id);
tgKoshelekTopup($tenant->id, '1000.00');
$campaign = refundCampaign($tenant->id, Campaign::STATUS_QUEUED, '315.00');
// На запуске смету заморозили (draft→queued это делает контроллер; здесь эмулируем).
app(TelegramCampaignChargeService::class)->freeze($campaign, (string) $campaign->estimated_cost_rub);
expect(tgKoshelekFrozen($tenant->id))->toBe('315.00');
// Робот падает без campaignId → черновик в кабинете НЕ создан → failed + возврат.
refundMockRobot(RobotResult::failed('Канал недоступен', 'upload'));
RunTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
expect(Campaign::find($campaign->id)->status)->toBe(Campaign::STATUS_FAILED)
->and(tgKoshelekFrozen($tenant->id))->toBe('0.00') // заморозка отпущена
->and(tgKoshelekBalance($tenant->id))->toBe('1000.00'); // и ничего не списано
});
it('в песочнице отказ робота НЕ трогает деньги (не списывали — нечего возвращать)', function () {
config()->set('client_tg.sandbox', true);
$tenant = Tenant::factory()->create(['balance_rub' => '1000.00']);
DB::statement('SET LOCAL app.current_tenant_id = '.$tenant->id);
$campaign = refundCampaign($tenant->id, Campaign::STATUS_QUEUED, '315.00');
// В песочнице списания на запуске нет — денег на кампании не трогали.
refundMockRobot(RobotResult::failed('Канал недоступен', 'upload'));
RunTelegramCampaignJob::dispatchSync($campaign->id, $tenant->id);
expect(tgKoshelekBalance($tenant->id))->toBe('0.00') // кошелька не заводили
->and(tgKoshelekFrozen($tenant->id))->toBe('0.00');
});
it('cancel из draft: не списывали → возврат no-op, баланс цел, статус cancelled', function () {
$tenant = Tenant::factory()->create(['balance_rub' => '1000.00']);
$user = User::factory()->create(['tenant_id' => $tenant->id]);
$this->actingAs($user);
DB::statement('SET LOCAL app.current_tenant_id = '.$tenant->id);
// Черновик деньги не списывал — cancel вызовет refund, но возвращать нечего (сальдо 0).
$campaign = refundCampaign($tenant->id, Campaign::STATUS_DRAFT, '300.00');
$this->postJson("/api/telegram/campaigns/{$campaign->id}/cancel")
->assertOk()
->assertJsonPath('status', Campaign::STATUS_CANCELLED);
expect(tgKoshelekFrozen($tenant->id))->toBe('0.00');
});
it('cancel из running запрещён 422, статус остаётся running', function () {
$tenant = Tenant::factory()->create(['balance_rub' => '1000.00']);
$user = User::factory()->create(['tenant_id' => $tenant->id]);
$this->actingAs($user);
$campaign = refundCampaign($tenant->id, Campaign::STATUS_RUNNING, '300.00');
$this->postJson("/api/telegram/campaigns/{$campaign->id}/cancel")->assertStatus(422);
expect(Campaign::find($campaign->id)->status)->toBe(Campaign::STATUS_RUNNING);
});
it('cancel в песочнице не трогает деньги (баланс цел, проводок нет)', function () {
config()->set('client_tg.sandbox', true);
$tenant = Tenant::factory()->create(['balance_rub' => '1000.00']);
$user = User::factory()->create(['tenant_id' => $tenant->id]);
$this->actingAs($user);
DB::statement('SET LOCAL app.current_tenant_id = '.$tenant->id);
$campaign = refundCampaign($tenant->id, Campaign::STATUS_DRAFT, '300.00');
$this->postJson("/api/telegram/campaigns/{$campaign->id}/cancel")
->assertOk()
->assertJsonPath('status', Campaign::STATUS_CANCELLED);
expect(tgKoshelekFrozen($tenant->id))->toBe('0.00');
});