ТЗ: WebP → JPG Batch Converter

Тип проекта: Веб-приложение (Next.js, обработка изображений в браузере)

Обзор

Веб-приложение для пакетной конвертации WebP-изображений в JPG с настройкой степени сжатия и формата вывода. Продукт закрывает поисковую задачу «конвертация webp в jpg» (1909/мес) и соседние запросы о переводе WebP в JPG для публикации на сайте. Основное отличие от универсальных suite (Format Factory, Movavi): загрузка пачки файлов, выбор качества и скачивание результата на одном экране, без регистрации, с локальной обработкой в браузере. Выигрывает за счёт скорости (десятки секунд на пачку вместо ручной обработки по файлу) и приватности (файлы не уходят на сервер).

Проверка ниши

Оценка ниши: 5.9/10 (traffic 85 · competition 40 · trend 50 · niche 40). Ниша пройдена, раундов research: 2. Спрос: 3393 запросов/мес по 8 запросам.

Запрос	Объём/мес	Конкуренция	CPC
конвертация webp в jpg	1909	Ads n/a	n/a
конвертация веб в jpg	419	Ads n/a	n/a
перевод из веб в jpg	258	Ads n/a	n/a
конвертор web d jpg	229	Ads n/a	n/a
перевод из веб в джипег	213	Ads n/a	n/a
конвертировать вебр в jpg онлайн бесплатно	187	Ads n/a	n/a
конвертация web в jpg	102	Ads n/a	n/a
конверт веб в джипег	76	Ads n/a	n/a

SERP, CPC и Ads competition_index не предоставлены. Google Trends interest отсутствует — тренд оценён нейтрально, не как растущий.

Целевая аудитория и сценарий

Владельцы сайтов, контент-менеджеры, авторы и дизайнеры, которые получили WebP-файлы, а публиковать или передавать нужно JPG. Основной путь (3 шага):

1. Запрос в поиске («конвертация webp в jpg») → посадочная страница с инструментом на первом экране.
2. Drag&drop пачки WebP-файлов, ползунок качества, выбор формата вывода.
3. Скачивание отдельного файла или всего пакета ZIP-архивом.

Конкуренты и позиционирование

Конкуренты из данных (wikipedia, suite):

• Format Factory — универсальный конвертер, поддерживает JPG и WebP.
• Movavi Видео Конвертер — универсальный конвертер, поддерживает WebP и JPEG/JPG.

Берём за основу: саму функцию конвертации WebP → JPG с настройкой качества.

Делаем проще/быстрее: один экран вместо многошагового мастера suite; пакетная обработка; локальная обработка в браузере без установки и без загрузки на сервер; без регистрации; ZIP-экспорт с сохранением имён.

Сознательно не делаем: не строим универсальный оптимизатор ИИ-изображений, не поддерживаем видео/аудио, не делаем десктопное приложение.

Функционал первой версии

Обязательно

• Пакетная конвертация WebP в JPG — ядро продукта. Загрузка пачки WebP-файлов и конвертация их в JPG одним действием. Закрывает главный запрос «конвертация webp в jpg» (1909/мес) и соседние. Граничные случаи: битый WebP — файл помечается ошибкой, остальные обрабатываются; пустой пакет — кнопка конвертации неактивна.
• Загрузка пачки файлов — drag&drop или выбор нескольких файлов сразу. Список с именами, размерами и миниатюрами. Граничные случаи: превышение лимита 25 МБ на файл / 200 МБ на пакет — файл не добавляется с понятным сообщением; дубликаты по имени — предупреждение.
• Степень сжатия и формат — ползунок качества/сжатия (0–100, дефолт 85) и выбор формата вывода (JPG или PNG). Показ итогового размера файла до скачивания. Граничные случаи: качество 0 — предупреждение о потере качества; пересчёт размера — debounce.
• Скачивание результата — скачивание отдельного файла или всего пакета ZIP-архивом с сохранением исходных имён. Граничные случаи: имя с недопустимыми символами — санитизация; конвертация в процессе — кнопка заблокирована.

Желательно

• Обработка в браузере без регистрации — конвертация локально в браузере, файлы не уходят на сервер, аккаунт не нужен. Отличие от Format Factory и онлайн-конвертеров с загрузкой.
• Посадочная под запросы конвертации — страница с заголовком и текстом под целевые запросы, чтобы поисковый трафик сразу попадал в инструмент.
• Ссылка на результат — кнопка «поделиться» со ссылкой на обработанный пакет или превью. Файл загружается на сервер только при нажатии «Поделиться», хранится временно до 24 ч.
• Платный тариф для больших пакетов — бесплатно до 10 файлов / 25 МБ на пакет; платно — большие пакеты, ZIP-экспорт и сохранённые пресеты качества.

Можно позже

• Изменение размера для сайта — менять ширину/высоту при конвертации (соседняя ниша «изменять размер изображения», 1774/мес).
• Сжатие до целевого веса — режим «уложить файл в N КБ» с автоподбором качества.

Не входит в объём первой версии

• Изменение размера изображений (ширина/высота) — отложено в «Можно позже».
• Сжатие до целевого веса (N КБ) — отложено в «Можно позже».
• Универсальный оптимизатор ИИ-изображений.
• Конвертация видео/аудио.
• Десктопное приложение и браузерное расширение.
• Пакетная конвертация WebP → PNG как отдельный продукт (поддерживается как формат вывода, но не позиционируется).

SEO и посадочные страницы

Главная посадочная — под запрос с наибольшим объёмом «конвертация webp в jpg» (1909/мес).

Запрос	Страница/раздел	title / H1
конвертация webp в jpg	/ (главная)	title: «Конвертация WebP в JPG онлайн — пакетно, бесплатно» / H1: «Конвертация WebP в JPG»
конвертация веб в jpg	/ (главная, блок)	H2: «Конвертация веб в JPG»
перевод из веб в jpg	/ (главная, блок)	H2: «Перевод из веб в JPG»
конвертор web d jpg	/ (главная, блок)	H2: «Конвертор Web в JPG»
перевод из веб в джипег	/ (главная, блок)	H2: «Перевод из веб в джипег»
конвертировать вебр в jpg онлайн бесплатно	/ (главная, блок)	H2: «Конвертировать вебр в JPG онлайн бесплатно»
конвертация web в jpg	/ (главная, блок)	H2: «Конвертация Web в JPG»
конверт веб в джипег	/ (главная, блок)	H2: «Конверт веб в джипег»

Все целевые запросы ведут на одну главную посадочную с инструментом на первом экране; запросы-синонимы раскрываются блоками H2 на той же странице. Отдельные страницы под синонимы не создаём (дублирование).

Пользователи и доступ

• Анонимный пользователь — полный доступ к конвертации без регистрации, лимит: до 10 файлов, до 25 МБ на пакет.
• Платный пользователь — авторизация по Email + magic link. Доступ к большим пакетам, ZIP-экспорту и сохранённым пресетам качества.
• Проверка прав — в сервисном слое на каждом действии, не только в UI.

Модель данных

Сущности (Supabase Postgres):

• users — id (uuid, pk), email (text, unique), created_at (timestamptz).
• sessions — id (uuid, pk), user_id (uuid, fk users), token_hash (text), expires_at (timestamptz), created_at.
• magic_links — id (uuid, pk), email (text), token_hash (text), expires_at (timestamptz), used_at (timestamptz, nullable).
• subscriptions — id (uuid, pk), user_id (uuid, fk users), stripe_customer_id (text), stripe_subscription_id (text), plan (enum: monthly|yearly), status (enum: active|past_due|canceled), current_period_end (timestamptz), created_at.
• shared_batches — id (uuid, pk), user_id (uuid, fk users, nullable), storage_path (text), file_count (int), expires_at (timestamptz), created_at.
• usage — id (uuid, pk), user_id (uuid, fk users, nullable), anonymous_id (text, nullable), files_count (int), bytes_total (bigint), created_at.
• app_settings — key (text, pk), value (jsonb); ключ billing хранит квоты тарифов.

Локальные файлы (в браузере) в БД не хранятся. На сервере — только временные файлы для шаринга (shared_batches, TTL 24 ч).

Стек и архитектура

• Фронтенд/бэкенд: Next.js (App Router), серверные компоненты и Server Actions по умолчанию; use client — только на интерактивных листьях.
• Язык: TypeScript strict, без any.
• Обработка изображений: в браузере через Canvas API / createImageBitmap + OffscreenCanvas; для WebP-декодирования — нативный браузерный декодер. ZIP — fflate (клиентский, стриминговый).
• Валидация: Zod на границе (Server Actions, API).
• БД/хранилище: Supabase (Postgres + Storage).
• Хостинг: Vercel.
• Платежи: Stripe (Checkout + Customer Portal для подписок), события подписки через вебхуки, статус храним у себя.
• Email: Resend + React Email (magic link, транзакционные письма), SPF/DKIM/DMARC.
• Аналитика: PostHog.
• Тесты: Vitest (юнит на бизнес-логику), Playwright (e2e на путь конвертации).
• Линтер/форматтер: ESLint + Prettier.

Контракт API — источник истины: сначала Zod-схема, затем реализация. Единый формат ошибок { error: { code, message, details } }.

Структура проекта

webp-to-jpg/
├─ app/
│  ├─ layout.tsx
│  ├─ page.tsx                     # главная посадочная + инструмент
│  ├─ share/[id]/page.tsx          # превью/скачивание расшаренного пакета
│  ├─ account/page.tsx             # подписка, пресеты
│  └─ api/
│     ├─ auth/magic-link/route.ts
│     ├─ auth/callback/route.ts
│     ├─ share/route.ts
│     └─ stripe/webhook/route.ts
├─ components/
│  ├─ converter/
│  │  ├─ Dropzone.tsx
│  │  ├─ FileList.tsx
│  │  ├─ QualitySlider.tsx
│  │  ├─ FormatSelect.tsx
│  │  └─ DownloadBar.tsx
│  └─ ui/
├─ lib/
│  ├─ convert/                     # ядро: конвертация, сжатие, ZIP
│  │  ├─ convertImage.ts
│  │  ├─ estimateSize.ts
│  │  └─ zip.ts
│  ├─ validation/                  # Zod-схемы
│  ├─ auth/
│  ├─ billing/
│  ├─ errors.ts                    # классы/коды ошибок
│  └─ supabase/
├─ tests/
│  ├─ unit/
│  └─ e2e/
├─ .cursor/rules/*.mdc
├─ CLAUDE.md
├─ AGENTS.md
├─ .env.example
├─ BACKLOG.md
└─ README.md

UI/UX

• Первый экран сразу решает задачу главного запроса: заголовок «Конвертация WebP в JPG», dropzone, ползунок качества, выбор формата, кнопка конвертации — без скролла и без регистрации.
• Результат ядра без лишних шагов: загрузил → настроил → скачал.
• Список файлов: имя, исходный размер, миниатюра, статус (ожидает / конвертируется / готово / ошибка).
• Показ итогового размера до скачивания, обновление с debounce.
• Прогресс пакетной обработки; ошибки по конкретным файлам не блокируют остальные.
• Кнопка «Поделиться» — только после конвертации; явное предупреждение, что файл будет загружен на сервер и удалён через 24 ч.
• Адаптив под мобильные; быстрая загрузка (< 1 с).
• Пустое состояние с примером и подсказкой форматов.

Интеграции

• Supabase — Postgres, Storage (временные файлы для шаринга), Auth-таблицы.
• Stripe — Checkout, Customer Portal, вебхуки подписки.
• Resend — magic link и транзакционные письма.
• PostHog — продуктовая аналитика.
• Telegram Bot API — алерты команде (опционально).

Монетизация

Модель из ответов: подписка (месяц/год) с лимитами.

• Free — до 10 файлов, до 25 МБ на пакет, без ZIP-экспорта и пресетов.
• Monthly / Yearly — большие пакеты, ZIP-экспорт, сохранённые пресеты качества.

CPC по целевым запросам не предоставлен (Ads n/a) — как ориентир ценности трафика использовать нельзя. Ориентир ценности — объём спроса ниши (3393/мес) и доля конверсии в платный тариф (гипотеза). Цифры выручки не закладываем.

Нефункциональные требования

• TypeScript strict, без `