Дмитрий
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>
63 lines
3.7 KiB
PHP
63 lines
3.7 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
return [
|
|
/*
|
|
|--------------------------------------------------------------------------
|
|
| Песочница Telegram-рекламы
|
|
|--------------------------------------------------------------------------
|
|
| По умолчанию ВКЛ (true) — робот доводит кампанию только до черновика
|
|
| (mode:'draft'), деньги не списываются, «запустить/оплатить» не жмётся.
|
|
| Живой режим (mode:'live' + списание) открывается ОСОЗНАННО (Сессия 6)
|
|
| выставлением TG_SANDBOX=false после проверки в песочнице.
|
|
*/
|
|
'sandbox' => filter_var(env('TG_SANDBOX', true), FILTER_VALIDATE_BOOL),
|
|
|
|
/*
|
|
|--------------------------------------------------------------------------
|
|
| Наценка на клиентскую цену Telegram-рекламы
|
|
|--------------------------------------------------------------------------
|
|
| Клиент платит цену С наценкой: клиентская смета = базовая смета тарифа
|
|
| (себестоимость-оценка) × markup. 1.40 = +40%. Строка для bcmath (scale 2).
|
|
| Меняется без правки кода через env TG_MARKUP.
|
|
*/
|
|
'markup' => (string) env('TG_MARKUP', '1.40'),
|
|
|
|
/*
|
|
|--------------------------------------------------------------------------
|
|
| Порог авто-пачки
|
|
|--------------------------------------------------------------------------
|
|
| Авто-режим копит новых лидов и запускает кампанию, когда наберётся столько
|
|
| кандидатов (МТС показывает рекламу базе, а не по одному номеру). Минимальная
|
|
| осмысленная пачка у МТС Маркетолог — 367 (спека §5).
|
|
*/
|
|
'auto_batch_threshold' => (int) env('TG_AUTO_BATCH', 367),
|
|
|
|
/*
|
|
|--------------------------------------------------------------------------
|
|
| Окно «зависшей модерации»
|
|
|--------------------------------------------------------------------------
|
|
| Кампания в статусе `moderating` дольше стольких ЧАСОВ считается зависшей
|
|
| (робот не смог прочитать вердикт: сломались селекторы кабинета / id протух).
|
|
| Уборщик уводит её в `needs_review` для ручного разбора, БЕЗ возврата брони
|
|
| (могла реально показываться). МТС проверяет ~4ч; окно с большим запасом.
|
|
*/
|
|
'moderation_stuck_hours' => (int) env('TG_MODERATION_STUCK_HOURS', 48),
|
|
|
|
/*
|
|
|--------------------------------------------------------------------------
|
|
| Node-робот кабинета МТС (bots/mts-telegram-ads)
|
|
|--------------------------------------------------------------------------
|
|
| У МТС нет API — кампанию доводит браузер-робот. TelegramRobotRunner
|
|
| запускает `node <script> --task <file>` в каталоге <cwd>. Воркер этой
|
|
| очереди живёт на Windows-машине с живой сессией МТС (профиль браузера).
|
|
*/
|
|
'robot' => [
|
|
'node' => env('TG_ROBOT_NODE', 'node'),
|
|
'script' => env('TG_ROBOT_SCRIPT', base_path('bots/mts-telegram-ads/bin/run.js')),
|
|
'cwd' => env('TG_ROBOT_CWD', base_path('bots/mts-telegram-ads')),
|
|
'timeout' => (int) env('TG_ROBOT_TIMEOUT', 300),
|
|
],
|
|
];
|