6f469fb13d
Денежная модель (куски 1-2): реклама в Телеграме (МТС Маркетолог, робот-в-браузере)
оплачивается с ОБЩЕГО баланса тенанта (как СМС), наценка 40%. Списание при запуске,
возврат при отказе модерации/сбое/отмене (сальдо-идемпотентность tg_ad_charge/tg_ad_refund).
Старый рекламный кошелёк-заморозка убран из потока кампаний (таблицы ad_wallets НЕ удалены).
Новый TelegramCampaignChargeService (зеркало SmsChargeService); F5 money-safety сохранён
(сбой с mts_campaign_id → needs_review без возврата). Уборщик добивает зависшие queued с возвратом.
Чистка СМС-наследия (аудит модуля построчно 5 проверяющими): модуль ресейлит ПОКАЗЫ рекламы,
а не рассылку сообщений — вырезаны выдуманные сущности, механически скопированные из СМС:
- «имя/бренд отправителя» + помесячная абонплата (в телеге МТС имени отправителя нет):
ChargeTgNameFeeJob, TelegramSenderService, SenderController, модели Sender/Setting,
фронт-панель TelegramSenderPanel, админ-карточка, updateTgSettings, тип tg_name_fee.
Таблицы client_tg_senders/_settings дропнуты.
- мёртвые таблицы client_tg_messages (доставка по номеру) и client_tg_templates (шаблоны
сообщений) — без модели/использования, дропнуты (миграция 000017, create-миграции удалены).
- client_tg_optouts переосмыслен как ручной список «не показывать этим номерам» (не «отписки»).
- лексика рассылки → рекламы: «Авторассылка»→«Авто-реклама», «кошелёк/заморожено»→«общий баланс».
Медиа объявления (реальный пробел показов): новый POST /api/telegram/campaigns/{id}/media
(картинка/видео к черновику, png/jpg/gif/mp4 ≤50 МБ, замена удаляет старый файл) + поле
загрузки в форме кабинета. Робот уже принимал media_path (RunTelegramCampaignJob → mediaFile
→ cabinet.js fillAdMedia) — не хватало только приёма файла от клиента.
Схема: db/CHANGELOG_schema.md v8.94 (CHECK += tg_ad_charge/tg_ad_refund) + v8.95 (дроп
СМС-таблиц, tg_name_fee убран). Тесты зелёные поштучно (квирк партиций — гонять по одному):
Schema/Models/AdminTg/CampaignCharge/CampaignApi/Audience/Media; фронт advertising-telegram-view
19 + admin-tg/auto-rule 24. pint/deptrac(0) чисто; larastan исключён (Pest-$this шум). Робот
bots/mts-telegram-ads НЕ трогали.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
129 lines
6.0 KiB
PHP
129 lines
6.0 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
use App\Jobs\ClientTg\RunTelegramCampaignJob;
|
|
use App\Models\BalanceTransaction;
|
|
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 или пусто —
|
|
* робот всё равно упал бы, но деньги уже были бы списаны. В песочнице гейта
|
|
* нет (денег нет вообще).
|
|
*
|
|
* Деньги теперь идут с ОБЩЕГО баланса тенанта (tenants.balance_rub) — списание
|
|
* пишет проводку BalanceTransaction TYPE_TG_AD_CHARGE (отдельного рекламного
|
|
* кошелька с заморозкой больше нет). «Гейт отсёк деньги не тронуты» = 0 проводок
|
|
* списания; «гейт пройден списали» = 1 проводка + баланс уменьшился.
|
|
*
|
|
* 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 () {
|
|
$this->tenant->update(['balance_rub' => '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(BalanceTransaction::where('type', BalanceTransaction::TYPE_TG_AD_CHARGE)->count())->toBe(0);
|
|
expect((string) Tenant::find($this->tenant->id)->balance_rub)->toBe('5000.00');
|
|
|
|
Queue::assertNothingPushed();
|
|
});
|
|
|
|
it('0 кандидатов в бою → launch 422, статус остаётся draft', function () {
|
|
$this->tenant->update(['balance_rub' => '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(BalanceTransaction::where('type', BalanceTransaction::TYPE_TG_AD_CHARGE)->count())->toBe(0);
|
|
|
|
Queue::assertNothingPushed();
|
|
});
|
|
|
|
it('≥367 кандидатов + денег хватает в бою → launch OK, draft→queued, джоб поставлен, списание произошло', function () {
|
|
$this->tenant->update(['balance_rub' => '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), достаточно факта списания.
|
|
DB::statement('SET LOCAL app.current_tenant_id = '.$this->tenant->id);
|
|
expect(BalanceTransaction::where('type', BalanceTransaction::TYPE_TG_AD_CHARGE)->count())->toBe(1);
|
|
expect(bccomp((string) Tenant::find($this->tenant->id)->balance_rub, '5000.00', 2))->toBeLessThan(0);
|
|
});
|