Архитектура backend¶
Backend Saga написан на Go и обслуживает API, статические frontend-сборки и фоновые задачи.
Основные слои¶
- Handler: HTTP endpoints, валидация запроса, auth middleware.
- Service: бизнес-логика, расчёты, интеграции, проверки статусов.
- Repository: доступ к PostgreSQL и транзакционным данным.
Ключевые модули¶
- Auth: Supabase login, backend JWT, роли пользователя и администратора.
- Storage: PostgreSQL, миграции, append-only transactions.
- Интеграции: Crypto2B, Fordefi, DeBank, Pendle, DefiLlama, Zerion.
- Notifications: email, алерты, support bot.
Правила¶
- Балансы и доходность рассчитываются через canonical backend services.
- Денежные значения в API используют SafeDecimal.
- Ошибки логируются и возвращаются явно.
- Изменения схемы БД идут только через миграции.