Уточняющие вопросы по ТЗ продавца (Wavy)

На главную

Критически важные вопросы (блокируют разработку)

1. Передача API-ключа аутентификации

В заголовке Authorization: Bearer {API_KEY}
В заголовке X-API-Key: {API_KEY}
В query параметре: ?api_key={API_KEY}
В теле запроса для POST методов

2. Обработка удаления несуществующего товара

Возвращать 404 Not Found если товар не существует
Возвращать 200 OK (идемпотентная операция)
Возвращать 400 Bad Request с сообщением об ошибке

3. Структура идентификаторов в отзывах

id в FeedbackDTO - это ID отзыва (исправить описание)
id в FeedbackDTO - это ID товара (дублирование, убрать)
Добавить отдельное поле productId для связи с товаром

4. Пагинация для списков товаров и отзывов

Без пагинации - возвращать все данные сразу
Пагинация по страницам: page/size параметры
Пагинация по курсору: limit/offset параметры
Фиксированный лимит на страницу (например, 20 элементов)

Важные функциональные вопросы

5. Перечень допустимых категорий товаров

Электроника, Одежда, Косметика, Продукты, Книги
Список из 10-15 основных категорий Wildberries
Динамический список - можно добавлять новые категории
Фиксированный enum как в спецификации OpenAPI

6. Формат поля period в графике продаж

"Январь 2025", "Февраль 2025" (полное название)
"2025-01", "2025-02" (стандартный формат для сортировки)
"Jan", "Feb" (короткое название)
"01.2025", "02.2025" (числовой формат)

7. Ограничения для генерируемых товаров

Цена: 100-10 000 рублей
Наличие: 0-1000 штук на складе
Рейтинг: 1.0-5.0 звезд
Описание: 50-500 символов
Без ограничений - полностью случайные значения

8. Поддержка нескольких фото в отзывах

Только одно фото (photoUrl как строка)
Несколько фото (photoUrls как массив строк)
Без фото - только текстовые отзывы
Опционально одно или несколько фото

9. Привязка товаров к продавцу

Все товары общие для всех продавцов
Товары привязаны к API-ключу (только свои товары)
Смешанный режим: общий каталог + личные товары
Возможность просматривать чужие товары, но редактировать только свои

Вопросы по бизнес-логике

10. Валидация операций с товарами

Проверять права на удаление только своих товаров
Любой продавец может удалить любой товар
Удаление только товаров с isRemovable=true
Дополнительные бизнес-правила для удаления

11. Расчет процента возвратов (refundsPercent)

refundsCount / totalSalesCount * 100
refundsAmount / totalSalesAmount * 100
Сложный алгоритм с учетом времени и суммы
Фиксированное значение для демо-версии

12. Обновление статистики в реальном времени

Статистика обновляется в реальном времени
Кэширование данных на 5-15 минут
Ежедневное обновление в фоне
Статические данные для демо-версии

13. Время жизни сгенерированных товаров

Товары сохраняются постоянно
Автоматическое удаление через 24 часа
Ограничение на количество товаров у одного продавца
Ротация товаров по времени или количеству

Технические вопросы реализации

14. Формат ошибок при нестандартных сценариях

Всегда 200 OK с полем error в теле
Стандартные HTTP коды (400, 404, 500)
Гибридный подход: 200 для бизнес-ошибок, 5xx для технических
Детализированные ошибки с кодами и сообщениями

15. Поддержка опциональных полей в API

Все необязательные поля могут отсутствовать или быть null
Необязательные поля всегда присутствуют, но могут быть null
Разные стратегии для разных полей
Строгая валидация - все поля обязательны

16. Валидация входных данных

Проверка типов данных и форматов
Проверка бизнес-логики (ценность > 0 и т.д.)
Базовая валидация только на уровне типов
Подробные сообщения об ошибках валидации

Дополнительные вопросы

17. Сортировка товаров в списках

По дате добавления (новые сначала)
По цене (возрастание/убывание)
По популярности (количество заказов)
По рейтингу (высокий сначала)
Фиксированная сортировка как в базе

18. Поддержка поиска и фильтрации

Поиск по названию товара
Фильтрация по категории
Фильтрация по диапазону цен
Поиск по артикулу
Без поиска и фильтрации в MVP

19. Формат изображений товаров

Полные URL (https://example.com/image.jpg)
Относительные пути (images/product1.jpg)
ID изображений для загрузки через отдельный эндпоинт
Base64 кодированные изображения в JSON

20. Локализация и мультиязычность

Только русский язык
Поддержка русского и английского
Определение языка через заголовок Accept-Language
Язык фиксирован для всего API