portal/app/tests/Feature/ClientTg/KoshelekTelegramaTest.php

<?php

declare(strict_types=1);

use App\Exceptions\Billing\InsufficientBalanceException;
use App\Models\AdWallet;
use App\Models\AdWalletHold;
use App\Models\ClientTg\Campaign;
use App\Models\Tenant;
use App\Models\User;
use App\Services\Advertising\AdWalletService;
use App\Services\ClientTg\TelegramCampaignChargeService;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\DB;

uses(RefreshDatabase::class);

/**
 * Деньги Telegram-рекламы после переделки 03.08.2026: РЕКЛАМНЫЙ КОШЕЛЁК с заморозкой
 * вместо списания с общего баланса на запуске.
 *
 * 🔴 Зачем переделали. Прежний порядок списывал клиенту всю смету по РАЗМЕРУ СПИСКА
 * в момент запуска. При этом робот доводил кампанию до кассы кабинета МТС и уходил, не
 * заплатив, — кампания не уходила на модерацию и не показывалась НИ РАЗУ, а деньги
 * клиента уже были списаны и никем не возвращались.
 *
 * Новый порядок зеркалит сам МТС (билинг-модель — bots/mts-telegram-ads/FLOW-FINDINGS.md
 * «Задача 2.0»): запуск МОРОЗИТ смету, оплата у МТС даёт фактическую сумму, одобрение
 * списывает по факту и размораживает остаток, отказ размораживает всё.
 */
function tgWalletCampaign(int $tenantId, string $status = Campaign::STATUS_QUEUED): Campaign
{
    return 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' => '315.00',
        'created_by' => 1,
    ]);
}

/** Тенант с деньгами НА РЕКЛАМНОМ КОШЕЛЬКЕ (общий баланс тут ни при чём). */
function tgWalletTenant(string $walletRub = '1000.00'): Tenant
{
    $tenant = Tenant::factory()->create(['balance_rub' => '0.00']);
    DB::statement('SET LOCAL app.current_tenant_id = '.$tenant->id);
    app(AdWalletService::class)->topup($tenant->id, $walletRub, 'telegram', 'Пополнение для теста');

    return $tenant;
}

it('запуск МОРОЗИТ смету на рекламном кошельке, а не списывает', function () {
    $tenant = tgWalletTenant();
    $campaign = tgWalletCampaign($tenant->id);

    app(TelegramCampaignChargeService::class)->freeze($campaign, '315.00');

    $wallet = AdWallet::where('tenant_id', $tenant->id)->first();
    expect((string) $wallet->balance_rub)->toBe('1000.00')   // деньги на месте
        ->and((string) $wallet->frozen_rub)->toBe('315.00')  // но заняты
        ->and((string) $tenant->fresh()->balance_rub)->toBe('0.00'); // общий баланс не трогали
});

it('повторная заморозка той же кампании не морозит дважды', function () {
    $tenant = tgWalletTenant();
    $campaign = tgWalletCampaign($tenant->id);

    $svc = app(TelegramCampaignChargeService::class);
    $svc->freeze($campaign, '315.00');
    $svc->freeze($campaign->fresh(), '315.00');

    expect((string) AdWallet::where('tenant_id', $tenant->id)->first()->frozen_rub)->toBe('315.00');
});

it('свободных денег не хватает — бросает, кошелёк цел', function () {
    $tenant = tgWalletTenant('100.00');
    $campaign = tgWalletCampaign($tenant->id);

    expect(fn () => app(TelegramCampaignChargeService::class)->freeze($campaign, '315.00'))
        ->toThrow(InsufficientBalanceException::class);

    $wallet = AdWallet::where('tenant_id', $tenant->id)->first();
    expect((string) $wallet->balance_rub)->toBe('100.00')
        ->and((string) $wallet->frozen_rub)->toBe('0.00');
});

it('одобрение списывает ПО ФАКТУ и размораживает остаток', function () {
    $tenant = tgWalletTenant();
    $campaign = tgWalletCampaign($tenant->id);

    $svc = app(TelegramCampaignChargeService::class);
    $svc->freeze($campaign, '315.00');
    // МТС взял с нас 201,60 ₽ → клиенту 201,60 × 1,40 = 282,24 ₽.
    $svc->chargeByFact($campaign->fresh(), '282.24');

    $wallet = AdWallet::where('tenant_id', $tenant->id)->first();
    expect((string) $wallet->balance_rub)->toBe('717.76')  // 1000 − 282,24
        ->and((string) $wallet->frozen_rub)->toBe('0.00'); // остаток сметы отпущен
});

it('списание по факту идемпотентно — второй заход не списывает второй раз', function () {
    $tenant = tgWalletTenant();
    $campaign = tgWalletCampaign($tenant->id);

    $svc = app(TelegramCampaignChargeService::class);
    $svc->freeze($campaign, '315.00');
    $svc->chargeByFact($campaign->fresh(), '282.24');
    $svc->chargeByFact($campaign->fresh(), '282.24');

    expect((string) AdWallet::where('tenant_id', $tenant->id)->first()->balance_rub)->toBe('717.76');
});

it('отказ модерации размораживает всё, ни рубля не списано', function () {
    $tenant = tgWalletTenant();
    $campaign = tgWalletCampaign($tenant->id);

    $svc = app(TelegramCampaignChargeService::class);
    $svc->freeze($campaign, '315.00');
    $svc->release($campaign->fresh());

    $wallet = AdWallet::where('tenant_id', $tenant->id)->first();
    expect((string) $wallet->balance_rub)->toBe('1000.00')
        ->and((string) $wallet->frozen_rub)->toBe('0.00')
        ->and(AdWalletHold::where('tenant_id', $tenant->id)
            ->where('status', AdWalletHold::STATUS_ACTIVE)->count())->toBe(0);
});

it('разморозка без заморозки и повторная разморозка ничего не ломают', function () {
    $tenant = tgWalletTenant();
    $campaign = tgWalletCampaign($tenant->id);

    $svc = app(TelegramCampaignChargeService::class);
    $svc->release($campaign);          // заморозки не было
    $svc->freeze($campaign, '315.00');
    $svc->release($campaign->fresh());
    $svc->release($campaign->fresh()); // повтор

    $wallet = AdWallet::where('tenant_id', $tenant->id)->first();
    expect((string) $wallet->balance_rub)->toBe('1000.00')
        ->and((string) $wallet->frozen_rub)->toBe('0.00');
});

it('после отказа кампанию можно заморозить снова (пересдача)', function () {
    $tenant = tgWalletTenant();
    $campaign = tgWalletCampaign($tenant->id);

    $svc = app(TelegramCampaignChargeService::class);
    $svc->freeze($campaign, '315.00');
    $svc->release($campaign->fresh());
    $svc->freeze($campaign->fresh(), '315.00');

    expect((string) AdWallet::where('tenant_id', $tenant->id)->first()->frozen_rub)->toBe('315.00');
});

it('экран телеграм-рекламы показывает деньги РЕКЛАМНОГО кошелька, а не общий баланс', function () {
    // У клиента 700 ₽ на общем балансе и 1000 ₽ на рекламном кошельке, из них
    // 315 ₽ уже заняты под кампанию. Свободно на новую рекламу — 685 ₽.
    $tenant = tgWalletTenant();
    $user = User::factory()->create(['tenant_id' => $tenant->id]);
    $tenant->update(['balance_rub' => '700.00']);
    $campaign = tgWalletCampaign($tenant->id);
    app(TelegramCampaignChargeService::class)->freeze($campaign, '315.00');

    $this->actingAs($user)
        ->getJson('/api/telegram/campaigns')
        ->assertOk()
        // 🔴 Не 700 (общий баланс) и не 1000 (весь кошелёк) — именно свободное.
        ->assertJsonPath('balance_rub', '685.00')
        ->assertJsonPath('frozen_rub', '315.00');
});