ТЗ: Evrone Crypto Checkout — приём криптоплатежей

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

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

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

API и виджет оплаты, инвойсы с QR, вебхуки, автоконвертация в стейблкоин.

Продукт для мерчантов: API и виджет оплаты, инвойс со ссылкой/QR, отслеживание транзакции в сети, вебхуки о статусе, автоконвертация в стейблкоин/фиат по курсу на момент оплаты, кабинет мерчанта (платежи, вывод, отчёты), плагины для популярных платформ.

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

3. Роли

• Мерчант
• Плательщик
• Администратор платформы

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

4.1. Invoice

merchant_id: references
amount: integer
currency: string
address: string
state: enum # ожидает, оплачен, просрочен
expires_at: datetime

4.2. Webhook

merchant_id: references
url: string
secret: string
deliveries: has_many

4.3. Settlement

merchant_id: references
amount: integer
converted_to: string
rate: decimal

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

1. Мерчант создаёт инвойс через API и получает ссылку или QR
2. Плательщик отправляет средства, платформа отслеживает транзакцию в сети
3. Статус уходит мерчанту вебхуком с подписью и повторными попытками
4. Полученное автоматически конвертируется в стейблкоин или фиат

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

• Блокчейн-ноды и эксплореры
• Провайдер конвертации
• Плагины для CMS

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

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

8. Состав MVP

Инвойс + виджет + вебхук + кабинет мерчанта.

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

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