Files
portal/app/tests/Frontend/AppSidebarAdvertising.spec.ts
T
Дмитрий 0c9642f3d0 feat(телеграм-модуль): клиентский экран + ручной запуск в песочнице — API, telegram.ts, экран, сквозной сценарий
Сессия 3 плана docs/superpowers/plans/2026-07-27-client-telegram-ads-module.md.
Клиент сам собирает объявление + аудиторию и жмёт «Запустить»; робот кабинета МТС
(в тестах замокан) доводит до черновика. Всё в песочнице: деньги/живой запуск выключены.

- Клиентский API (Api\ClientTg\CampaignController + маршруты /api/telegram/*):
  создание (store) и запуск (launch) РАЗДЕЛЕНЫ. store создаёт ЧЕРНОВИК со сметой и
  числом кандидатов (деньги/робот не трогаются); launch draft→queued, в бою бронирует
  лимит на объявление (budget_cap_rub) и ставит RunTelegramCampaignJob. Нехватка денег
  → 409 (кампания остаётся черновиком); повторный запуск не-черновика → 422; изоляция
  тенантов (чужой show → 404). Валидация текст/ссылка/аудитория/бюджет; deals без срока → 422.
- Фронт-API telegram.ts (зеркало client-sms.ts, уже): fetch/create/get/launch, cookie-сессия.
- Экран AdvertisingTelegramView.vue (/advertising/telegram): форма (объявление, ссылка,
  3 способа аудитории, лимит), кнопка «Запустить» (create→launch), баннер песочницы,
  список кампаний с человеческим ярлыком статуса, сообщение при нехватке денег.
- Канал «Реклама Телеграм» АКТИВИРОВАН: advertisingChannels.ts route, провод в AppSidebar
  и AppMoreDrawer (route → реальный экран, остальные каналы — прежняя заглушка), маршрут
  в router. Тесты каналов обновлены (телеграм больше не заглушка).
- Ручной сквозной сценарий (песочница): создать → запустить → джоб (робот замокан, draft)
  → draft_ready + matched виден в API.

Отличие от СМС-близнеца: отдельного эндпоинта «предпросчёт до создания» нет — смету и
кандидатов клиент видит в самом черновике (создание черновик денег не тратит).

Проверки: 60/60 Pest ClientTg зелёные (+10 новых), 1512 Vitest зелёные (0 регрессий),
phpstan 0 по своему коду (level 5), pint чисто, deptrac 0 нарушений. Робот в тестах замокан
(кабинет МТС не тронут). Синтетические номера 7999… — реальных нет.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-27 17:39:43 +03:00

102 lines
5.2 KiB
TypeScript

import { describe, it, expect, beforeEach } from 'vitest';
import { mount, type VueWrapper } from '@vue/test-utils';
import { createMemoryHistory, createRouter, type Router } from 'vue-router';
import { createPinia, setActivePinia } from 'pinia';
import { createVuetify } from 'vuetify';
import AppSidebar from '../../resources/js/components/layout/AppSidebar.vue';
import { useDealsCountStore } from '../../resources/js/stores/dealsCount';
// VDialog телепортит контент в body → стаб рендерит слот инлайн, чтобы искать
// тело диалога в wrapper (тот же квирк, что в AdminSupplierProjectsView.spec).
async function setup(initialRoute = '/deals'): Promise<{ wrapper: VueWrapper; router: Router }> {
setActivePinia(createPinia());
useDealsCountStore().count = 5;
const router = createRouter({
history: createMemoryHistory(),
routes: [{ path: '/deals', component: { template: '<div />' } }],
});
await router.push(initialRoute);
await router.isReady();
const vuetify = createVuetify();
const wrapper = mount(AppSidebar, {
global: {
plugins: [router, vuetify],
stubs: {
// «Реклама Телеграм» теперь реальный RouterLink — стаб должен
// пробрасывать остальные атрибуты (data-testid и т.п.), не только class.
RouterLink: {
props: ['to'],
template: '<a v-bind="$attrs" :href="typeof to === \'string\' ? to : \'#\'"><slot /></a>',
inheritAttrs: false,
},
VDialog: { template: '<div><slot /></div>' },
},
},
});
return { wrapper, router };
}
const AD_ITEMS = [
{ testid: 'ad-nav-ai-callcenter', title: 'ИИ колцентр' },
{ testid: 'ad-nav-sms', title: 'Рассылка СМС' },
{ testid: 'ad-nav-yandex-audience', title: 'Яндекс Аудитория' },
{ testid: 'ad-nav-vk', title: 'VK Реклама' },
{ testid: 'ad-nav-telegram', title: 'Реклама Телеграм' },
];
// Каналы-заглушки: клик открывает «В разработке». «Реклама Телеграм» активирована
// (ведёт на реальный экран /advertising/telegram) — она в этот список не входит.
const STUB_ITEMS = AD_ITEMS.filter((i) => i.testid !== 'ad-nav-telegram');
describe('AppSidebar — раздел «Рекламные возможности»', () => {
beforeEach(() => localStorage.clear());
it('показывает группу «Рекламные возможности» сразу после «Работа»', async () => {
const { wrapper } = await setup();
const eyebrows = wrapper.findAll('.ld-nav-group__eyebrow').map((e) => e.text());
const workIdx = eyebrows.indexOf('Работа');
const adIdx = eyebrows.indexOf('Рекламные возможности');
expect(workIdx).toBeGreaterThanOrEqual(0);
expect(adIdx).toBe(workIdx + 1);
});
it('содержит 5 рекламных пунктов с нужными названиями', async () => {
const { wrapper } = await setup();
for (const item of AD_ITEMS) {
const el = wrapper.find(`[data-testid="${item.testid}"]`);
expect(el.exists(), `нет пункта ${item.testid}`).toBe(true);
expect(el.text()).toContain(item.title);
}
});
it('пока не кликнули — окно «В разработке» не показано', async () => {
const { wrapper } = await setup();
expect(wrapper.find('[data-testid="ad-stub-dialog"]').exists()).toBe(false);
});
it.each(STUB_ITEMS)('клик по «$title» открывает окно с текстом релиза', async ({ testid }) => {
const { wrapper } = await setup();
await wrapper.find(`[data-testid="${testid}"]`).trigger('click');
const dialog = wrapper.find('[data-testid="ad-stub-dialog"]');
expect(dialog.exists()).toBe(true);
expect(dialog.text()).toContain('В разработке');
expect(dialog.text()).toContain('01.09.2026');
});
it('«Реклама Телеграм» — активный пункт: ведёт на /advertising/telegram, не на заглушку', async () => {
const { wrapper } = await setup();
const item = wrapper.find('[data-testid="ad-nav-telegram"]');
expect(item.attributes('href') ?? item.attributes('to')).toContain('/advertising/telegram');
await item.trigger('click');
expect(wrapper.find('[data-testid="ad-stub-dialog"]').exists()).toBe(false);
});
it('кнопка «Понятно» закрывает окно', async () => {
const { wrapper } = await setup();
await wrapper.find('[data-testid="ad-nav-sms"]').trigger('click');
expect(wrapper.find('[data-testid="ad-stub-dialog"]').exists()).toBe(true);
await wrapper.find('[data-testid="ad-stub-ok"]').trigger('click');
expect(wrapper.find('[data-testid="ad-stub-dialog"]').exists()).toBe(false);
});
});