Спецификация
Первый этап: интерфейс и mock-слой. Реальное подключение Avito API не выполняется.
Маршруты
| Маршрут | Экран | Статус |
|---|---|---|
/dashboard | Главный дашборд | работает на mock-данных |
/items | Список объявлений | работает на mock-данных |
/items/[id] | Анализ и улучшение объявления | работает на mock-данных |
/items/[id]/promotion | Продвижение объявления | mock-покупка, деньги не списываются |
/promotion | Вход в продвижение | ведёт к выбору объявления |
/reviews | Отзывы | mock-данные, отправка ответа в mock-режиме |
/reports | Отчёты | заглушка: источники данных готовы |
/settings | Настройки и аккаунты | mock-данные |
/design-system | Дизайн-система | живая витрина токенов и компонентов |
/specification | Спецификация | этот экран |
Источник каждого элемента
Каждый элемент интерфейса помечен источником| Элемент | Источник | Комментарий |
|---|---|---|
| Показы, просмотры, контакты, избранное | Данные API | Статистика профиля, группировки totals / item / day |
| Разбивка контактов: телефон, чат, оба, скидка | Данные API | Отдельные показатели, приходят вместе с контактами |
| Обе конверсии воронки | Данные API | Не считаем сами — берём значения Авито |
| Средняя цена просмотра и контакта | Данные API | Отдельные показатели статистики |
| Расходы: размещение, продвижение, комиссия, прочее, бонусы | Данные API | Приходят в копейках — нормализуются в рубли на границе провайдера |
| Баланс кошелька и история операций | Данные API | Операция содержит услугу, сумму и привязку к объявлению |
| Список объявлений, статус, цена, категория | Данные API | Лимит 25 запросов в минуту — читаем из своего хранилища |
| Активные услуги и их сроки | Данные API | Включая расписание следующих применений |
| Справочник услуг, цены со скидкой и без | Данные API | Услуги с признаком устаревания в интерфейсе не показываются |
| Прогноз прироста просмотров | Данные API | Диапазон от Авито. Платформа его не корректирует и не выдаёт за гарантию |
| Рейтинг и отзывы | Данные API | Ответ отправляется по подтверждению |
| Стоимость контакта по объявлению | Расчёт платформы | (размещение + продвижение) ÷ контакты. При нуле контактов — «— (0 контактов)» |
| Изменение к предыдущему периоду | Расчёт платформы | Сравнение с равным предыдущим интервалом |
| Главный вывод дашборда | Расчёт платформы | Доля бюджета и доля контактов у худших объявлений |
| Подсветка «требуют внимания» и флаги строк | Расчёт платформы | Пять правил: тратит без контактов, дорогой контакт (выше Q3), отклонено, срок заканчивается, конверсия ниже половины медианы |
| Диагноз воронки и общая оценка объявления | Расчёт платформы | Сравнение с медианой аккаунта, а не с отраслевой нормой |
| Черновики заголовка и описания | Расчёт платформы | Генерация ИИ. Только черновик: копирование, сохранение, переход на Авито |
| Рекомендация «подключать / не подключать услугу» | Расчёт платформы | Обоснование строится на показателях объявления и цене услуги |
| Покупка услуги продвижения | Требует подтверждения | Экран подтверждения с итоговой суммой, балансом и остатком + ключ идемпотентности |
| Массовое применение услуги | Требует подтверждения | Предпросмотр списка и итоговой суммы до запуска |
| Отправка ответа на отзыв | Требует подтверждения | Черновик ИИ отправляется только вручную |
| Управление ценой целевого действия и ставками | Расширенный доступ | Только для аккаунтов с оплатой за целевое действие — MVP 2 |
| Отчёт модерации с причинами отклонения | Расширенный доступ | Требует подключённой Автозагрузки — MVP 2 |
| Центр сообщений | Расширенный доступ | Требует платного тарифа Авито — MVP 2, в MVP 1 отсутствует |
| Создание и редактирование объявления | Недоступно | Через API невозможно. Только копирование текста и переход на Авито |
| Загрузка фотографий объявления | Недоступно | Фото передаются только внешними ссылками в фиде — MVP 2 |
| Позиция в поиске, поисковые запросы, источники переходов | Недоступно | Таких данных в API нет. В интерфейсе отсутствуют полностью |
| Список конкретных конкурентов | Недоступно | Не показываем и не обещаем |
| Пополнение кошелька Авито | Недоступно | Ведём пользователя на Авито |
Правила, которые нельзя нарушать в реализации
Никаких списаний без подтверждения. Любое действие, тратящее деньги клиента, проходит через экран подтверждения с итоговой суммой, балансом и остатком. Каждая операция получает ключ идемпотентности.
Никаких обещаний результата. Прогноз показывается только как диапазон Авито и всегда с оговоркой.
Отсутствующая метрика никогда не показывается нулём. Вместо значения выводится «Показатель недоступен на вашем тарифе Авито».
Данные всегда с отметкой актуальности. Индикатор в шапке присутствует на каждом экране с показателями.
Текст объявления не публикуется из платформы. Черновики ИИ доступны только для копирования, сохранения и перехода на Авито.