Уточняющие вопросы по ТЗ бэкенда доставки

На главную

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

1. Механизм аутентификации и управления сессиями

Статические JWT токены без серверного logout
JWT с blacklist токенов для инвалидации на сервере
Сессионная аутентификация с хранением сессий в БД
Refresh tokens для автоматического обновления access токенов

2. Подтверждение контактных данных пользователя

Email требует подтверждения через ссылку
Телефон требует подтверждения через SMS-код
Подтверждение не требуется для email
Подтверждение не требуется для телефона

3. Парольная политика при регистрации

Минимальная длина 6 символов
Минимальная длина 8 символов + буквы и цифры
Сложный пароль: 8+ символов, буквы в разных регистрах, цифры, спецсимволы
Без специальных требований к сложности

4. Процесс оплаты и интеграция с платежными системами

Единый запрос: создание заказа + немедленная оплата
Двухэтапный процесс: создание заказа → отдельный запрос на оплату
Поддержка только внешних платежных систем (Stripe/YooMoney)
Поддержка внутреннего кошелька как основного метода оплаты
Гибридный подход: кошелек + внешние платежные системы

5. Обработка конкурентных запросов при изменении наличия товаров

Пессимистичная блокировка: резервирование товаров при добавлении в корзину
Оптимистичная блокировка: проверка наличия только при оформлении заказа
Версионность товаров: каждый заказ фиксирует версию данных товара
Очередь запросов на оформление заказов

6. Определение координат для адресов доставки

Клиент самостоятельно определяет и передает координаты (lat, lon)
Бэкенд преобразует текстовый адрес в координаты через API карт
Смешанный подход: приоритет координатам от клиента, fallback к геокодированию
Обязательная валидация адреса через сервис карт

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

7. Архитектура хранения данных корзины

Временное хранение в Redis (высокая производительность, очистка после заказа)
Постоянное хранение в PostgreSQL (сохранение между сессиями)
Гибридный подход: Redis для активной корзины + синхронизация в PostgreSQL

8. Параметры пагинации для списков

Классическая пагинация: limit/offset
Современная пагинация: page/size с указанием общего количества
Курсорная пагинация для больших наборов данных

9. Параметры сортировки товаров в каталоге

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

10. Поддерживаемые фильтры для каталога товаров

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

11. Стратегия хранения файлов изображений товаров

Локальное файловое хранилище на сервере
Облачное объектное хранилище (Amazon S3, Yandex Object Storage)
Гибридное решение: оригиналы в облаке + кэш на сервере
CDN для раздачи статических файлов

12. События для отправки push-уведомлений

Изменение статуса заказа
Поступление новых товаров в категориях интереса
Специальные предложения и акции
Напоминания о брошенной корзине
Информация о доставке (курьер выехал)

13. Механизм определения языка интерфейса

Заголовок Accept-Language HTTP запроса
Явный параметр в URL (?lang=ru)
Настройка в профиле пользователя
Определение по локали устройства (из app метаданных)

Вопросы по интеграции кошелька

14. Архитектурный подход к реализации кошелька

Монолитная архитектура: общая БД с основным сервисом
Микросервисная архитектура: отдельный сервис кошелька с API
Module-first подход: изолированные модули в рамках одного приложения

15. Методы двухфакторной аутентификации для финансовых операций

SMS-коды подтверждения
Push-уведомления с действиями
Email-коды подтверждения
TOTP (Time-based One-Time Password) через приложение
Комбинация методов на выбор пользователя

16. Уровень сложности NLP обработки команд в чате

Простой pattern-matching по ключевым словам
Библиотека prose для базового анализа английского текста
Специализированная библиотека для русского языка
Кастомная ML модель для распознавания намерений
Интеграция с внешним NLP-сервисом (Dialogflow, etc.)

17. Политика лимитов для финансовых операций

Фиксированные лимиты на одну операцию
Суточные/месячные лимиты на общую сумму операций
Настраиваемые пользователем лимиты
Адаптивные лимиты на основе истории и верификации
Без лимитов для верифицированных пользователей

Дополнительные/технические вопросы

18. Уровень детализации логирования

Только ошибки и критические события
Полные логи HTTP запросов и ответов
Structured logging в JSON формате для анализа
Логи бизнес-событий (заказы, платежи, etc.)

19. Мониторинг здоровья системы и метрики

Базовый эндпоинт /health для проверки БД
Расширенный /health с проверкой всех зависимостей
Метрики Prometheus для мониторинга производительности
Кастомные бизнес-метрики (количество заказов, etc.)

20. Формат документации API

Swagger/OpenAPI 3.0 с полной спецификацией
Swagger/OpenAPI 2.0 для совместимости
Альтернативные форматы: API Blueprint, RAML
Интерактивная документация с примерами запросов

21. Детализация ошибок валидации

Единый формат для всех ошибок { "error": "message" }
Детальные ошибки с указанием проблемных полей и правил
Многоуровневая система ошибок с кодами и категориями
Локализованные сообщения об ошибках

22. Политика ограничения запросов (Rate Limiting)

Без ограничений на этапе MVP
Фиксированные квоты на API-ключ/пользователя
Адаптивные лимиты на основе нагрузки и поведения
Разные лимиты для разных эндпоинтов (строже для платежей)

23. Обработка устаревших цен товаров в корзине

Цены фиксируются только при оформлении заказа
Предупреждение пользователя об изменении цен при оформлении
Автоматическое обновление цен в корзине при изменении
Резервирование цены на ограниченное время

24. Механизм расчета стоимости доставки

Фиксированная стоимость для всех заказов
Зависимость от суммы заказа (бесплатно от N руб.)
Расчет на основе расстояния и веса заказа
Интеграция с API служб доставки для расчета