ТЗ: Evrone Wallet — криптокошелёк

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

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

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

Мультивалютные балансы, ввод-вывод, обмен, KYC, ledger с двойной записью.

Кастодиальный мультивалютный кошелёк: балансы, ввод/вывод с очередью подтверждений, обмен внутри кошелька с котировками и спредом, история операций, KYC-онбординг, ledger с двойной бухгалтерской записью под капотом.

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

3. Роли

• Владелец кошелька
• Комплаенс-офицер
• Оператор поддержки

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

4.1. Account

user_id: references
currency: string
balance: integer # минимальные единицы
kyc_level: integer

4.2. LedgerEntry

account_id: references
debit: integer
credit: integer
operation_id: references # двойная запись

4.3. Operation

kind: enum # ввод, вывод, обмен
state: enum # создана, в очереди, подтверждена, отклонена
quote: jsonb

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

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

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

• Провайдер котировок
• Блокчейн-ноды
• KYC-провайдер
• Мониторинг транзакций

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

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

8. Состав MVP

Две валюты — ввод, вывод, обмен.

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

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