5b04d751c0
Сессия 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>
124 lines
5.0 KiB
PHP
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();
|
|
});
|