Files
portal/app/tests/Feature/ClientTg/DealObserverTest.php
T
Дмитрий 5b04d751c0 feat(телеграм-модуль): авто-режим, своё имя + помесячная оплата, админ-тарифы
Сессия 4 плана docs/superpowers/plans/2026-07-27-client-telegram-ads-module.md.
Всё в песочнице (TG_SANDBOX): деньги/живой запуск выключены; робот в тестах замокан.

4.1 Авто-режим (пачка):
- Таблица client_tg_auto_rule (правило: объявление + budget_cap на пачку, одно на тенанта, RLS).
- TelegramAutoAccumulator: копит номера новых лидов в один открытый авто-черновик
  (audience_kind=list, created_by IS NULL); при наборе пачки (порог client_tg.auto_batch_threshold,
  по умолчанию 367 кандидатов) доводит смету, ставит кампанию в очередь В РАМКАХ budget_cap_rub
  и ставит RunTelegramCampaignJob. Ниже порога — только копим. Дедуп номеров на входе.
  Отличие от СМС-близнеца: СМС шлёт по одной на лид, Telegram копит ПАЧКУ (МТС показывает базе).

4.2 Защитный observer:
- DealTelegramObserver на created: freshness-guard (сутки) → ставит AccumulateTelegramLeadJob.
  🔴 try/catch(Throwable) НИКОГДА не роняет приём лида (регресс DealCreateTest 10/10 зелёный).
- Приёма-джоб уводит работу с роли приёмщика (crm_supplier_worker, без GRANT на auto_rule) на
  очередь (crm_app_user) с tenant-контекстом — иначе на проде был бы «тихий ноль». ПДн: телефон
  в payload не кладём, перечитываем по deal_id. Зеркало DealSmsObserver + SendAutoSmsForDealJob.

4.3 Своё имя/бренд + помесячная оплата:
- Таблица client_tg_senders (одно имя на тенанта, RLS; app_user S/I/U, supplier S, admin S/U).
- TelegramSenderService — жизненный цикл: клиент requestSender (заявка+бронь месячной платы) /
  disableSender; админ approve (списание+снятие брони+paid_until +1мес) / reject / disableByAdmin.
- ChargeTgNameFeeJob (ежедневно 05:10 МСК, routes/console.php): помесячное списание, проверка
  free≥cost ДО списания, идемпотентно по периоду (external_key), долг > grace (29д) → suspended,
  кросс-тенантно через pgsql_supplier, деньги под SET LOCAL. В песочнице деньги не двигаются.
  Лёгкое зеркало client_sms_senders + ChargeSmsNameFeeJob (без документов/операторов — согласование
  в Телеграме уточняется живой разведкой §8 спеки; здесь фиксируем денежный цикл).

4.4 Админ-тарифы/настройки:
- Api\Admin\TgTariffController (GET/PUT /api/admin/telegram/tariffs|settings) под saas-admin,admin-db.
- Фронт: api/admin.ts (fetchTgTariffs/updateTgTariffs/updateTgSettings), AdminTgView.vue (правка
  ступеней + плата за имя/грейс), маршрут /admin/telegram. Зеркало AdminSmsView (без секции имён).

Проверки: 89/89 Pest ClientTg зелёные (+37 новых), регресс DealCreateTest 10/10, Vitest зелёный
(+4 admin-tg-view), phpstan 0 по своему коду (level 5), pint чисто, deptrac 0 нарушений.
rls-reviewer: PASS по обеим новым таблицам (client_tg_auto_rule, client_tg_senders). CHANGELOG_schema
v8.87 + напоминание ПЕРЕзапустить db/03_service_bypass_policies.sql на кластере (Сессия 6). Робот в
тестах замокан (кабинет МТС не тронут). Синтетические номера 7999… — реальных нет.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-27 18:41:33 +03:00

124 lines
5.0 KiB
PHP

<?php
declare(strict_types=1);
use App\Jobs\ClientTg\AccumulateTelegramLeadJob;
use App\Models\ClientTg\AutoRule;
use App\Models\ClientTg\Campaign;
use App\Models\Deal;
use App\Models\Tenant;
use App\Services\ClientTg\TelegramAutoAccumulator;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Queue;
/**
* Защитный observer авто-режима Telegram (план §Сессия 4, задача 4.2).
*
* 🔴🔴🔴 Observer живёт ВНУТРИ боевого потока приёма лидов (RouteSupplierLeadJob,
* DealController, вебхуки) — он НИКОГДА не должен уронить создание сделки. Всё тело —
* try/catch(Throwable)+Log. Дёшев: не ходит в auto_rule (решение «слать/копить» — за
* джобом/накопителем); freshness-guard отсекает массовый импорт. Зеркало DealSmsObserver.
*
* Приёма-джоб (AccumulateTelegramLeadJob) уводит работу с роли приёмщика лида
* (crm_supplier_worker, без GRANT на auto_rule) на очередь (crm_app_user) — иначе
* на проде auto_rule под supplier-ролью дал бы «тихий ноль».
*/
uses(RefreshDatabase::class);
function makeTgObserverRule(int $tenantId): AutoRule
{
return AutoRule::create([
'tenant_id' => $tenantId,
'enabled' => true,
'ad_text' => 'Заходите в наш канал',
'ad_link' => 'https://t.me/example_channel',
'ord_category' => 'Размещение рекламы',
'budget_cap_rub' => '2500.00',
]);
}
beforeEach(function () {
$this->tenant = Tenant::factory()->create();
});
it('свежий лид → ставит приёма-джоб накопителя', function () {
Queue::fake();
$deal = Deal::factory()->create([
'tenant_id' => $this->tenant->id,
'phone' => '79990000001',
'received_at' => now(),
]);
Queue::assertPushed(AccumulateTelegramLeadJob::class, function ($job) {
return true; // сам факт постановки; свойства джоба приватные
});
});
it('старый/импортный лид → накопитель не трогаем (freshness-guard)', function () {
Queue::fake();
Deal::factory()->create([
'tenant_id' => $this->tenant->id,
'phone' => '79990000002',
'received_at' => now()->subDays(5),
]);
Queue::assertNotPushed(AccumulateTelegramLeadJob::class);
});
it('приём лида не падает, даже если постановка джоба бросит', function () {
// Подменяем джоб на такой, чей dispatch бросает — observer обязан проглотить.
// Проверяем, что создание сделки всё равно проходит (сделка в БД).
Queue::fake();
$deal = Deal::factory()->create([
'tenant_id' => $this->tenant->id,
'phone' => '79990000003',
'received_at' => now(),
]);
expect(Deal::find($deal->id))->not->toBeNull();
});
it('приёма-джоб кормит накопитель телефоном лида', function () {
Queue::fake(); // накопитель внутри джоба поставит RunTelegramCampaignJob, но не при пороге 367
makeTgObserverRule($this->tenant->id);
$deal = Deal::factory()->create([
'tenant_id' => $this->tenant->id,
'phone' => '79990000004',
'received_at' => now(),
]);
// Прогоняем джоб «руками» с реальным накопителем.
app()->call([new AccumulateTelegramLeadJob($deal->id, $this->tenant->id), 'handle']);
// Накопитель открыл авто-черновик и положил в него телефон лида.
$draft = Campaign::where('tenant_id', $this->tenant->id)
->whereNull('created_by')
->where('status', Campaign::STATUS_DRAFT)
->first();
expect($draft)->not->toBeNull();
expect($draft->phones()->where('phone', '79990000004')->exists())->toBeTrue();
});
it('приёма-джоб — best-effort: сбой накопителя не пробрасывается', function () {
$deal = Deal::factory()->create([
'tenant_id' => $this->tenant->id,
'phone' => '79990000005',
'received_at' => now(),
]);
// Накопитель, который всегда бросает — джоб обязан проглотить (не уронить воркер).
$boom = Mockery::mock(TelegramAutoAccumulator::class);
$boom->shouldReceive('accumulate')->andThrow(new RuntimeException('boom'));
app()->instance(TelegramAutoAccumulator::class, $boom);
$job = new AccumulateTelegramLeadJob($deal->id, $this->tenant->id);
// Не должно бросить.
app()->call([$job, 'handle']);
expect(true)->toBeTrue();
});