«Оптима» — единое окно для селлеров Wildberries
«Оптима» — веб-сервис, который собирает в одном интерфейсе данные и инструменты продавца Wildberries: продажи и прибыль, цены и скидки, рекламу, отзывы, поставки, товарный учёт, бухгалтерию и ИИ-инструменты. Сервис работает через официальный API Wildberries от имени подключённого кабинета продавца.
Для кого: селлеры Wildberries и их команды — владелец бизнеса, менеджеры маркетплейсов, сотрудники, отвечающие за рекламу, цены и работу с отзывами.
Где что находится
| Что | Адрес |
|---|---|
| Веб-приложение | app.optimawb.ru |
| Сайт сервиса | optimawb.ru |
| Эта документация | docs.optimawb.ru |
| API (Swagger UI) | api.optimawb.ru/api/docs — открыт без логина и пароля |
| Документация кода (Compodoc) | Код (Compodoc) |
Как начать
- Зарегистрируйтесь в приложении и войдите — Регистрация и вход.
- Получите API-ключ в личном кабинете продавца Wildberries и подключите кабинет — Кабинеты Wildberries.
- Загрузите данные и откройте обзор кабинета — пошагово в разделе Быстрый старт.
Модули сервиса
Модули соответствуют разделам 5.1–5.15 технического задания. В приложении каждый модуль — пункт бокового меню внутри выбранного кабинета Wildberries.
| № | Модуль | Пункт меню | Документация |
|---|---|---|---|
| 5.1 | Оцифровка продаж и финансовый учёт | Продажи → Оцифровка | Оцифровка продаж |
| 5.2 | Управление ценами и скидками | Цены → Цены | Цены и скидки |
| 5.3 | Репрайсер | Цены → Репрайсер | Репрайсер |
| 5.4 | Автобиддер | Реклама → Автобиддер | Автобиддер |
| 5.5 | Автоответы на отзывы и вопросы, жалобы | Коммуникации → Автоответы | Автоответы |
| 5.6 | РНП — единая аналитика по товару | Продажи → РНП | РНП |
| 5.7 | Бухгалтерия | Прочее → Бухгалтерия | Бухгалтерия |
| 5.8 | Бронировщик поставок | Операции → Бронировщик | Бронировщик поставок |
| 5.9 | ИИ-помощник | ИИ → ИИ-помощник | ИИ-помощник |
| 5.10 | ИИ-агент (маркетолог) | Реклама → ИИ-агент | ИИ-агент |
| 5.11 | Товарный учёт | Операции → Товарный учёт | Товарный учёт |
| 5.12 | Юридический блок (досудебные претензии) | Прочее → Юр. блок | Досудебные претензии |
| 5.13 | Генерация контента | ИИ → Генерация контента | Генерация контента |
| 5.14 | A/B-тестирование | Прочее → A/B тесты | A/B-тестирование |
| 5.15 | База знаний | Прочее → База знаний | База знаний |
Что именно умеет каждый модуль и в каком он состоянии — в обзоре возможностей. Ход работ по задачам — на странице Статус поставки.
Разделы документации
- Начало работы — регистрация, подключение кабинета, роли, уведомления, ответы на частые вопросы и словарь терминов.
- Возможности по модулям — инструкции для селлера по каждому модулю.
- Статус поставки — готовность модулей, формируется из Jira.
- Архитектура — как устроены бэкенд, фронтенд, фоновые задачи, интеграция с Wildberries, ИИ-слой, безопасность и развёртывание.
- Техническая справка — API, переменные окружения, интеграция с WB API, локальная разработка, CI/CD.
- Решения (ADR) — реестр архитектурных решений с обоснованиями.
Как поддерживается документация
- Пользовательские страницы обновляются вместе с поставкой функциональности (по задачам Jira,
проект
OP). - Документация кода (Compodoc) собирается из TSDoc-комментариев бэкенда при каждой сборке портала.
- Контракт API (Swagger) генерируется самим бэкендом из декораторов NestJS.
- Архитектурные решения ведутся в
backend/docs/adr/и публикуются здесь командойnpm run sync:adr.