ТЗ: Evrone Marketplace — двусторонняя торговая площадка

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

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

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

Деньги идут через платформу: онбординг мерчантов, сплит-платежи, выплаты.

Ключевое отличие от магазина и классифайда: деньги проходят через платформу. Онбординг и KYC продавцов, кабинет мерчанта (товары, остатки, статистика продаж), общий каталог, корзина с товарами разных продавцов, сплит-платежи (комиссия площадки + выплата мерчанту), взаиморасчёты и отчёты для продавцов, рейтинги, модерация.

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

3. Роли

• Покупатель
• Мерчант
• Модератор
• Финансовый контролёр

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

4.1. Merchant

legal_name: string
inn: string
kyc_state: enum # черновик, на проверке, подтверждён
commission_rate: decimal
payout_details: jsonb

4.2. Order

buyer_id: references
sub_orders: has_many # по одному на мерчанта
payment_state: enum
split_amounts: jsonb

4.3. Payout

merchant_id: references
period: daterange
amount: integer
state: enum # запланирована, отправлена, подтверждена

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

1. Мерчант проходит онбординг с KYC и получает кабинет с товарами и остатками
2. Покупатель собирает корзину из товаров разных мерчантов и оплачивает одним платежом
3. Платёж делится на комиссию площадки и выплату мерчанту
4. Финансовый контролёр закрывает период и подтверждает выплаты

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

• Платёжный провайдер со сплит-платежами
• Проверка контрагентов
• Электронный документооборот

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

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

8. Состав MVP

Одна вертикаль, ~10 продавцов, полный цикл сделки от заказа до выплаты мерчанту.

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

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