Architecture Diagrams Index¶
Полный индекс всех архитектурных диаграмм проекта Saga.
System Architecture¶
System Overview¶
- Общая архитектура системы
- Взаимодействие компонентов
- Технологический стек
- Границы безопасности
Component Architecture¶
Backend Components¶
- Трёхслойная архитектура (Handlers → Services → Repositories)
- Dependency injection patterns
- Конфигурационная интеграция
- Примеры implementation
Data Flow Diagrams¶
Authentication Flow¶
- Процесс: Web3 wallet аутентификация через MetaMask
- Компоненты: Challenge-response, JWT tokens, signature verification
- Безопасность: EIP-191 standard, replay protection, session management
Deposit Flow¶
- Процесс: HD Wallet депозиты с blockchain мониторингом
- Компоненты: Address generation, transaction monitoring, balance updates
- Безопасность: Multi-confirmation, double-spending protection
Withdrawal Flow¶
- Процесс: Вывод средств с админской авторизацией
- Компоненты: Request validation, admin approval, HD wallet execution
- Безопасность: Multi-level approval, balance locking, transaction limits
Investment Flow¶
- Процесс: Создание и управление инвестициями
- Компоненты: Strategy selection, risk assessment, performance tracking
- Безопасность: Risk management, admin approval, diversification checks
🗂️ Quick Navigation¶
| Диаграмма | Описание | Ключевые компоненты |
|---|---|---|
| System Overview | Общая архитектура | Frontend, Backend, Database, Blockchain |
| Backend Components | Слои backend | Handlers, Services, Repositories |
| Auth Flow | Аутентификация | MetaMask, JWT, Signature verification |
| Deposit Flow | Депозиты | HD Wallet, Blockchain monitor, Balance service |
| Withdrawal Flow | Выводы | Admin approval, HD wallet execution |
| Investment Flow | Инвестиции | Strategy engine, Risk assessment, Performance tracking |
Architecture Insights¶
Критические пути системы:¶
- Authentication: MetaMask → Challenge → Signature → JWT
- Deposits: Blockchain → Monitor → Balance → Notification
- Withdrawals: Request → Admin → HD Wallet → Blockchain
- Investments: Strategy → Risk → Approval → Execution
Принципы архитектуры:¶
- Web3-First: Исключительно wallet-based аутентификация
- No-Mock Testing: Тестирование с реальными компонентами
- Unified Configuration: Централизованная конфигурация
- HD Wallet: Иерархическое управление адресами
- REST API: Стандартная HTTP архитектура
Безопасность:¶
- Криптографическая аутентификация
- Multi-level approval для критических операций
- ACID транзакции для финансовых операций
- Comprehensive audit trails
- Real-time monitoring и alerts
Related Documentation¶
- ADR Index - Architecture Decision Records
- System Architecture Overview - Текстовое описание архитектуры
- 🏗️ Integration-Only MVP Architecture - НОВАЯ АРХИТЕКТУРА: Полная спецификация Integration-Only подхода с диаграммами
- Testing Documentation - Подходы к тестированию
- Configuration Guide - Настройка системы
Архитектурные подходы¶
- Web3/HD Wallet (выше) - Классическая блокчейн архитектура с MetaMask
- Integration-Only MVP - Упрощенная MVP архитектура с внешними интеграциями