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>
152 lines
6.8 KiB
TypeScript
152 lines
6.8 KiB
TypeScript
import { apiClient, ensureCsrfCookie } from './client';
|
|
|
|
/**
|
|
* API-модуль клиентской Telegram-рекламы «по своей базе» (план §Сессия 3, задача 3.2).
|
|
*
|
|
* Эндпоинты под [auth:sanctum, tenant], префикс /api/telegram. GET'ы не требуют
|
|
* CSRF-cookie, мутации (POST) — требуют.
|
|
*
|
|
* 🔴 Отличие от СМС-близнеца: создание (create) и запуск (launch) РАЗДЕЛЕНЫ.
|
|
* create возвращает ЧЕРНОВИК со сметой и числом кандидатов; launch переводит его
|
|
* в очередь и запускает робота кабинета МТС (в песочнице — только черновик).
|
|
*/
|
|
|
|
/** Способ выбора аудитории: свежие сделки за период / своя база / свой список. */
|
|
export type TelegramAudienceKind = 'deals' | 'base' | 'list';
|
|
|
|
/** Кампания клиентской Telegram-рекламы (строка списка, POST-ответ и часть GET .../{id}). */
|
|
export interface TelegramCampaign {
|
|
id: number;
|
|
status: string;
|
|
status_reason?: string | null;
|
|
ad_text: string;
|
|
ad_link: string;
|
|
media_path: string | null;
|
|
/** Документ модератору, приложённый при пересдаче отклонённой кампании (задача 3.6). */
|
|
moderator_file_path?: string | null;
|
|
ord_category: string;
|
|
budget_cap_rub: string;
|
|
audience_kind: TelegramAudienceKind;
|
|
audience_params: Record<string, unknown> | null;
|
|
planned_count: number;
|
|
matched_count: number | null;
|
|
estimated_cost_rub: string;
|
|
actual_cost_rub: string | null;
|
|
/** null = авто-кампания (накопитель), иначе id создавшего менеджера. */
|
|
created_by?: number | null;
|
|
created_at?: string;
|
|
}
|
|
|
|
/** Ответ GET /api/telegram/campaigns — список кампаний тенанта + режим + баланс. */
|
|
export interface TelegramIndex {
|
|
campaigns: TelegramCampaign[];
|
|
sandbox: boolean;
|
|
balance_rub: string;
|
|
frozen_rub: string;
|
|
}
|
|
|
|
/** Тело POST /api/telegram/campaigns — создание черновика кампании. */
|
|
export interface TelegramCreatePayload {
|
|
ad_text: string;
|
|
ad_link: string;
|
|
audience_kind: TelegramAudienceKind;
|
|
budget_cap_rub: string;
|
|
audience_days?: number;
|
|
ord_category?: string;
|
|
phones?: string[];
|
|
}
|
|
|
|
/** GET /api/telegram/campaigns — список кампаний тенанта + режим + баланс. */
|
|
export async function fetchTelegram(): Promise<TelegramIndex> {
|
|
const { data } = await apiClient.get<TelegramIndex>('/api/telegram/campaigns');
|
|
return data;
|
|
}
|
|
|
|
/** POST /api/telegram/campaigns — создать ЧЕРНОВИК кампании (деньги/робот не трогаются). */
|
|
export async function createTelegram(payload: TelegramCreatePayload): Promise<TelegramCampaign> {
|
|
await ensureCsrfCookie();
|
|
const { data } = await apiClient.post<TelegramCampaign>('/api/telegram/campaigns', payload);
|
|
return data;
|
|
}
|
|
|
|
/** GET /api/telegram/campaigns/{id} — детали кампании. */
|
|
export async function fetchTelegramCampaign(id: number): Promise<{ campaign: TelegramCampaign }> {
|
|
const { data } = await apiClient.get<{ campaign: TelegramCampaign }>(`/api/telegram/campaigns/${id}`);
|
|
return data;
|
|
}
|
|
|
|
/** POST /api/telegram/campaigns/{id}/launch — запустить черновик (draft → queued + робот). */
|
|
export async function launchTelegram(id: number): Promise<TelegramCampaign> {
|
|
await ensureCsrfCookie();
|
|
const { data } = await apiClient.post<TelegramCampaign>(`/api/telegram/campaigns/${id}/launch`);
|
|
return data;
|
|
}
|
|
|
|
/** Тело POST /api/telegram/campaigns/{id}/resubmit — правки + опц. документ модератору. */
|
|
export interface TelegramResubmitPayload {
|
|
ad_text: string;
|
|
ad_link: string;
|
|
ord_category?: string;
|
|
/** Лицензия/договор для модератора МТС (png/jpg/pdf ≤10 МБ). */
|
|
moderator_file?: File | null;
|
|
}
|
|
|
|
/**
|
|
* POST /api/telegram/campaigns/{id}/resubmit — пересдать ОТКЛОНЁННУЮ кампанию
|
|
* (rejected → queued). Отправляем multipart, т.к. можно приложить документ модератору.
|
|
*/
|
|
export async function resubmitTelegram(id: number, payload: TelegramResubmitPayload): Promise<TelegramCampaign> {
|
|
await ensureCsrfCookie();
|
|
const form = new FormData();
|
|
form.append('ad_text', payload.ad_text);
|
|
form.append('ad_link', payload.ad_link);
|
|
if (payload.ord_category) {
|
|
form.append('ord_category', payload.ord_category);
|
|
}
|
|
if (payload.moderator_file) {
|
|
form.append('moderator_file', payload.moderator_file);
|
|
}
|
|
const { data } = await apiClient.post<TelegramCampaign>(`/api/telegram/campaigns/${id}/resubmit`, form);
|
|
return data;
|
|
}
|
|
|
|
/**
|
|
* POST /api/telegram/campaigns/{id}/media — приложить картинку/видео к ЧЕРНОВИКУ
|
|
* объявления (png/jpg/gif или mp4, ≤50 МБ). Робот отдаёт файл кабинету МТС при запуске.
|
|
*/
|
|
export async function uploadTelegramMedia(id: number, file: File): Promise<TelegramCampaign> {
|
|
await ensureCsrfCookie();
|
|
const form = new FormData();
|
|
form.append('media', file);
|
|
const { data } = await apiClient.post<TelegramCampaign>(`/api/telegram/campaigns/${id}/media`, form);
|
|
return data;
|
|
}
|
|
|
|
/**
|
|
* Правило авто-рекламы Telegram (план §Этап 5, задача 5.4). Одно на тенанта: клиент
|
|
* из кабинета включает авто, задаёт объявление, порог пачки, бюджет и дневной лимит.
|
|
*/
|
|
export interface TelegramAutoRule {
|
|
enabled: boolean;
|
|
ad_text: string;
|
|
ad_link: string;
|
|
ord_category: string;
|
|
budget_cap_rub: string;
|
|
daily_limit_rub: string;
|
|
/** Сколько кандидатов накопить перед отправкой пачки; null → порог по умолчанию (367). */
|
|
batch_threshold: number | null;
|
|
}
|
|
|
|
/** GET /api/telegram/auto-rule — правило авто-рекламы тенанта (или дефолты). */
|
|
export async function fetchAutoRule(): Promise<TelegramAutoRule> {
|
|
const { data } = await apiClient.get<TelegramAutoRule>('/api/telegram/auto-rule');
|
|
return data;
|
|
}
|
|
|
|
/** PUT /api/telegram/auto-rule — сохранить правило авто-рекламы. */
|
|
export async function saveAutoRule(payload: TelegramAutoRule): Promise<TelegramAutoRule> {
|
|
await ensureCsrfCookie();
|
|
const { data } = await apiClient.put<TelegramAutoRule>('/api/telegram/auto-rule', payload);
|
|
return data;
|
|
}
|