Files
portal/app/tests/Feature/ClientSms/AdminSenderTest.php
T
Дмитрий f25c2f550d feat(смс-клиент): имя, отключённое за долг, возвращается само — за один месяц вперёд
Строка листа 4.4, Этап 4 Task 3.

Раньше ночной работник смотрел только на работающие имена, поэтому имя,
отключённое за долг, не возвращалось само никогда и ни при каких деньгах.
Теперь у него есть второй проход: как только у клиента хватило СВОБОДНЫХ денег
(с учётом замороженных под рассылки), имя включается, а плата берётся за один
месяц вперёд от сегодняшнего дня. Старый долг прощается — решение владельца
В-133: за месяцы, когда имя не работало, брать не за что. Документы заново не
запрашиваются: заявка не пересоздаётся, меняются только состояние и срок оплаты.

Сумма нигде не зашита — берётся из карточки имени. Она уже считается как
«цена за оператора × число операторов», и когда подключим остальных операторов,
вырастет сама.

Плана оказалось мало (журнал В-140). Он предлагал возвращать всё, что
«отключено и с долгом», но имя отключает и владелец руками из админки —
и такое имя погашено у МТС, оно не работает. Портал включал бы его обратно
и списывал за это деньги клиента, отменяя решение владельца. Отличать по тексту
записки нельзя: текст — не признак. Поэтому у имени появилась графа «почему
отключено» (за долг / рукой владельца); сам портал возвращает только первое.
Схема v9.18, миграция 2026_08_01_100600, прав не требует.

Второй правкой плана (В-141) переписан его тест на двойное списание: он проходил
вхолостую, потому что после первого прогона имя уже работает и второй проход его
не видит. Настоящая опасность — кнопка клиента (строка 4.5) и работник спишут за
один месяц дважды, если ключ у них разный. Тест теперь про это и краснеет от
порчи ключа.

Проверено вырезанием, четыре выреза, все вернуты:
— убрал проверку денег → покраснели четыре теста;
— убрал отбор по причине отключения → покраснел тест про имя владельца;
— испортил ключ месяца → списание прошло дважды, тест покраснел;
— убрал пометку причины из админки → покраснел тест админки.

Живой прогон под боевой ролью crm_app_user, пара «не произошло / произошло»:
на счету 50 ₽ при плате 100 — имя осталось отключённым, деньги не тронуты;
пополнил до 550 ₽ — имя работает, списано ровно 100 ₽, оплачено до 29.08,
на счету 450 ₽. В том же прогоне имя, выключенное владельцем, при 5000 ₽ на
счету осталось выключенным. Вторая пара — на пометку клиента: без неё имя не
включается вовсе, и работник в обоих случаях молчит.

Прогон вскрыл чужую мину (В-142): у боевой роли не было права на счётчик номеров
таблицы движений рекламного кошелька — под этой ролью молча не проходило ни одно
списание. Это расхождение локального стенда с эталоном db/02_grants.sql, кода не
касается; в памятку на выкат вписана читающая проверка этого права на бою.

Прогоны: клиентские СМС 262/262 (11 пачек, все с первой попытки), приём лидов
17/17, phpstan ровно 2 чужие давние, pint чисто. Фронт не трогался.
2026-07-29 11:30:41 +03:00

217 lines
9.0 KiB
PHP

<?php
declare(strict_types=1);
use App\Models\AdWallet;
use App\Models\ClientSmsSender;
use App\Models\Tenant;
use App\Services\Advertising\AdWalletService;
use Illuminate\Foundation\Testing\DatabaseTransactions;
use Illuminate\Support\Carbon;
use Illuminate\Support\Facades\Storage;
/**
* Task 13b: SaaS-admin согласование «своего имени отправителя»
* (client_sms_senders) — approve/reject/disable + движение денег в рекламном
* кошельке клиента (AdWalletService) под ролью crm_admin_user (srv_bypass).
*
* Setup зеркалит AdminTariffTest: DatabaseTransactions + без явного логина
* (EnsureSaasAdmin fail-open в тестах), SharesAdminPdo (глобально на Feature
* через tests/Pest.php) делает pgsql_admin той же PDO, что pgsql — данные,
* засеянные default-фабрикой, видны admin-контроллеру внутри одной транзакции.
*/
uses(DatabaseTransactions::class);
/**
* Тенант + рекламный кошелёк (topup 5000) + PENDING имя (плата 2500.00).
* В реальном режиме заявка держит бронь order-time — эмулируем freeze 2500.
*
* @return array{0:Tenant,1:ClientSmsSender}
*/
function makePendingSenderWithFreeze(bool $freeze = true): array
{
$tenant = Tenant::factory()->create();
app(AdWalletService::class)->topup($tenant->id, '5000.00', null, 't');
$sender = ClientSmsSender::create([
'tenant_id' => $tenant->id,
'name' => 'mybrand.ru',
'name_type' => ClientSmsSender::TYPE_WEBSITE,
'status' => ClientSmsSender::STATUS_PENDING,
'operators' => ['mts'],
'monthly_fee_rub' => '2500.00',
'consent_at' => now(),
]);
if ($freeze) {
app(AdWalletService::class)->freeze($tenant->id, 'sms', 'sender', $sender->id, '2500.00');
}
return [$tenant, $sender];
}
test('GET /api/admin/sms/senders?status=pending возвращает заявку на рассмотрении', function () {
[$tenant, $sender] = makePendingSenderWithFreeze(false);
$r = $this->getJson('/api/admin/sms/senders?status=pending');
$r->assertStatus(200);
$senders = $r->json('senders');
expect($senders)->toHaveCount(1);
expect($senders[0]['id'])->toBe($sender->id);
expect($senders[0]['status'])->toBe(ClientSmsSender::STATUS_PENDING);
});
test('GET .../document/basis скачивает документ-основание с исходным именем', function () {
Storage::fake('local');
[$tenant, $sender] = makePendingSenderWithFreeze(false);
$path = "sms-senders/{$tenant->id}/scan.pdf";
Storage::disk('local')->put($path, '%PDF-fake-content');
$sender->update(['doc_path' => $path, 'doc_original_name' => 'ogrn.pdf']);
$r = $this->get("/api/admin/sms/senders/{$sender->id}/document/basis");
$r->assertStatus(200);
expect($r->headers->get('content-disposition'))->toContain('ogrn.pdf');
});
test('GET .../document/consent скачивает подписанное согласие с исходным именем', function () {
Storage::fake('local');
[$tenant, $sender] = makePendingSenderWithFreeze(false);
$path = "sms-senders/{$tenant->id}/soglasie.pdf";
Storage::disk('local')->put($path, '%PDF-consent');
$sender->update(['consent_doc_path' => $path, 'consent_doc_original_name' => 'soglasie.pdf']);
$r = $this->get("/api/admin/sms/senders/{$sender->id}/document/consent");
$r->assertStatus(200);
expect($r->headers->get('content-disposition'))->toContain('soglasie.pdf');
});
test('GET .../document/basis → 404, если документ не приложен', function () {
[$tenant, $sender] = makePendingSenderWithFreeze(false); // без doc_path
$this->getJson("/api/admin/sms/senders/{$sender->id}/document/basis")->assertStatus(404);
});
test('GET .../document/{kind} → 404 при неизвестном виде', function () {
[$tenant, $sender] = makePendingSenderWithFreeze(false);
$this->getJson("/api/admin/sms/senders/{$sender->id}/document/xxx")->assertStatus(404);
});
test('approve (реальный режим): списывает 2500 с баланса и снимает бронь', function () {
config(['services.sms.sandbox' => false]);
Carbon::setTestNow('2026-08-15 12:00:00');
[$tenant, $sender] = makePendingSenderWithFreeze();
// Стартовое состояние кошелька: баланс 5000, заморожено 2500.
$w0 = AdWallet::where('tenant_id', $tenant->id)->first();
expect($w0->balance_rub)->toBe('5000.00');
expect($w0->frozen_rub)->toBe('2500.00');
$r = $this->postJson("/api/admin/sms/senders/{$sender->id}/approve");
$r->assertStatus(200);
expect($r->json('status'))->toBe(ClientSmsSender::STATUS_ACTIVE);
$fresh = ClientSmsSender::find($sender->id);
expect($fresh->status)->toBe(ClientSmsSender::STATUS_ACTIVE);
expect($fresh->approved_at)->not->toBeNull();
expect($fresh->paid_until->toDateString())->toBe(Carbon::now()->addMonthNoOverflow()->toDateString());
expect($fresh->debt_since)->toBeNull();
// Списание 2500 с баланса + снятие брони 2500.
$w = AdWallet::where('tenant_id', $tenant->id)->first();
expect($w->balance_rub)->toBe('2500.00');
expect($w->frozen_rub)->toBe('0.00');
Carbon::setTestNow();
});
test('approve (sandbox): имя активируется, кошелёк не тронут', function () {
config(['services.sms.sandbox' => true]);
$tenant = Tenant::factory()->create();
app(AdWalletService::class)->topup($tenant->id, '5000.00', null, 't');
$sender = ClientSmsSender::create([
'tenant_id' => $tenant->id,
'name' => 'mybrand.ru',
'name_type' => ClientSmsSender::TYPE_WEBSITE,
'status' => ClientSmsSender::STATUS_PENDING,
'operators' => ['mts'],
'monthly_fee_rub' => '2500.00',
]);
$r = $this->postJson("/api/admin/sms/senders/{$sender->id}/approve");
$r->assertStatus(200);
expect($r->json('status'))->toBe(ClientSmsSender::STATUS_ACTIVE);
// Кошелёк не двигался: баланс 5000, заморозки нет.
$w = AdWallet::where('tenant_id', $tenant->id)->first();
expect($w->balance_rub)->toBe('5000.00');
expect($w->frozen_rub)->toBe('0.00');
});
test('reject (реальный режим): статус rejected, note сохранён, бронь снята', function () {
config(['services.sms.sandbox' => false]);
[$tenant, $sender] = makePendingSenderWithFreeze();
$r = $this->postJson("/api/admin/sms/senders/{$sender->id}/reject", ['note' => 'дубль']);
$r->assertStatus(200);
$fresh = ClientSmsSender::find($sender->id);
expect($fresh->status)->toBe(ClientSmsSender::STATUS_REJECTED);
expect($fresh->note)->toBe('дубль');
// Бронь возвращена: заморозки нет, баланс не тронут.
$w = AdWallet::where('tenant_id', $tenant->id)->first();
expect($w->balance_rub)->toBe('5000.00');
expect($w->frozen_rub)->toBe('0.00');
});
test('approve на НЕ-pending имени → 422', function () {
config(['services.sms.sandbox' => false]);
$tenant = Tenant::factory()->create();
$sender = ClientSmsSender::create([
'tenant_id' => $tenant->id,
'name' => 'active.ru',
'name_type' => ClientSmsSender::TYPE_WEBSITE,
'status' => ClientSmsSender::STATUS_ACTIVE,
'operators' => ['mts'],
'monthly_fee_rub' => '2500.00',
]);
$this->postJson("/api/admin/sms/senders/{$sender->id}/approve")
->assertStatus(422)
->assertJsonPath('message', 'Имя не в статусе на рассмотрении');
});
test('4.4 — служебное отключение помечает имя как выключённое ВЛАДЕЛЬЦЕМ, а не за долг (В-140)', function () {
config(['services.sms.sandbox' => false]);
$tenant = Tenant::factory()->create();
$sender = ClientSmsSender::create([
'tenant_id' => $tenant->id,
'name' => 'active.ru',
'name_type' => ClientSmsSender::TYPE_WEBSITE,
'status' => ClientSmsSender::STATUS_ACTIVE,
'operators' => ['mts'],
'monthly_fee_rub' => '2500.00',
'paid_until' => '2026-04-25',
'debt_since' => '2026-04-26', // долг есть — и он НЕ должен воскресить имя
]);
$this->postJson("/api/admin/sms/senders/{$sender->id}/disable")->assertStatus(200);
$fresh = ClientSmsSender::find($sender->id);
expect($fresh->status)->toBe(ClientSmsSender::STATUS_SUSPENDED)
// Без этой пометки ночной работник включил бы имя обратно за деньги клиента,
// отменив решение владельца. Имя погашено у МТС и не работает.
->and($fresh->suspended_reason)->toBe(ClientSmsSender::SUSPENDED_BY_OWNER);
});