ТЗ: Evrone Auction — онлайн-аукцион

Демонстрационная версия документа · категория «Торги» · №05

Это демонстрационное техническое задание: оно показывает структуру и глубину документа, который передаётся вместе с прототипом. Боевое ТЗ по этому солюшену готовится и заменит этот файл.

1. Суть решения

Торги в реальном времени: ставки, автобид, антиснайпинг, кабинет аукциониста.

Торги на повышение в реальном времени. Каталог лотов с фото и описанием, регистрация участников с депозитом/допуском, торговая сессия (WebSocket: ставки, автобид, антиснайпинг-автопродление), уведомления о перебитой ставке, итоги и выкуп лота, кабинет аукциониста (создание торгов, стартовые цены, шаги).

2. Технологический стек

3. Роли

• Участник торгов
• Аукционист
• Наблюдатель

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

4.1. Auction

state: enum # анонс, приём заявок, торги, завершён
starts_at: datetime
step: integer
anti_sniping_seconds: integer

4.2. Lot

auction_id: references
start_price: integer
current_price: integer
photos: has_many_attached

4.3. Bid

lot_id: references
participant_id: references
amount: integer
placed_at: datetime
auto_bid_limit: integer, nullable

5. Ключевые сценарии

1. Участник регистрируется, вносит депозит и получает допуск к торгам
2. Торговая сессия идёт в реальном времени, ставки прилетают по WebSocket
3. Ставка в последние минуты продлевает торги - антиснайпинг
4. Победитель получает счёт и выкупает лот

6. Интеграции

• WebSocket-канал торгов
• Приём депозитов
• Уведомления о перебитой ставке

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

• Серверный рендеринг, работоспособность ключевых страниц без JavaScript
• Мобильная адаптивность обязательна
• Роли и права проверяются на уровне сервера, а не интерфейса
• Логирование действий пользователей по значимым операциям
• Покрытие тестами моделей и ключевых сценариев
• Развёртывание одной командой, окружения production и staging

8. Состав MVP

Один аукцион от создания до оплаты лота.

9. Критерии приёмки

1. Все сценарии из раздела 5 проходят end-to-end на тестовом стенде
2. Роли из раздела 3 видят только то, что им положено
3. Интеграции из раздела 6 работают через слой адаптеров и переключаются конфигурацией
4. Прототип разворачивается из репозитория одной командой
5. Документация по запуску и переменным окружения лежит в README