Saga MVP: Упрощенная архитектура и процессы (Integration-Only)

Версия: 1.0 MVP Дата: 2025-11-13 Архитектура: Integration-Only (НИКАКИХ WALLET ОПЕРАЦИЙ) Статус: Ready for Implementation

🎯 MVP Scope: Персональный пенсионный криптофонд

Ключевые ограничения MVP

• Один тип инвестиции: Ликвидные стейблкоины с фиксированной доходностью (10% APY)
• Email MANDATORY: Все пользователи регистрируются через email (Integration-Only)
• Минимум $500: Для инвестирования и пополнения
• Русский язык: Единственная локализация
• PWA: Адаптивный веб-сайт без нативных приложений
• Только интеграции: Crypto2B + Fordefi, никаких wallet операций

🏗️ Упрощенная архитектура MVP

graph TB
    subgraph "Пользователи"
        USER[👤 Пользователь - Google/Email вход]
        OP[👨‍💼 Оператор - Telegram + Админка]
    end

    subgraph "Saga Platform MVP"
        PWA[📱 PWA App - React/Next.js]
        ADMIN[🔧 Admin Panel - React/Next.js]
        API[🚀 Backend API - Go/Gin]
        DB[(🗄️ PostgreSQL)]
    end

    subgraph "External Services"
        SUPA[🔐 Supabase Auth - Google OAuth]
        C2B[💳 Crypto2B - Депозиты/Выводы]
        EMAIL[📧 Resend SMTP - Уведомления]
        TG[📱 Telegram Bot - Alerts операторам]
        FORD[💼 Fordefi - Manual Management]
    end

    subgraph "Blockchain"
        TRC[🌐 TRON/TRC20 - USDT (основная)]
        ETH[🌐 Ethereum - USDC (запасная)]
    end

    %% User flow
    USER --> PWA
    PWA --> API
    API --> SUPA
    API --> C2B
    API --> DB

    %% Operator flow
    OP --> ADMIN
    OP --> TG
    OP --> FORD
    ADMIN --> API

    %% External connections
    C2B --> TRC
    C2B --> ETH
    API --> EMAIL
    API --> TG

    %% Styling
    style USER fill:#e3f2fd
    style OP fill:#fff3e0
    style PWA fill:#e8f5e8
    style ADMIN fill:#fff8e1
    style API fill:#f3e5f5
    style FORD fill:#ffebee

💰 Единственный инвестиционный продукт MVP

graph LR
    subgraph "Характеристики продукта"
        LIQ[💧 Ликвидный - Вывод в любое время]
        SAFE[🛡️ Неубывающий - Капитал защищен]
        FIXED[📈 Фиксированная доходность - Предсказуемый APY]
        MIN[💵 Минимум 500 USD - Инвестиции и пополнения]
    end

    subgraph "Источник дохода"
        STAKE[🏦 Стейкинг стейблкоинов - В разных сетях]
        MANAGE[👥 Ручное управление - Через операторов]
    end

    LIQ --> STAKE
    SAFE --> STAKE
    FIXED --> MANAGE
    MIN --> MANAGE

    style LIQ fill:#e8f5e8
    style SAFE fill:#e3f2fd
    style FIXED fill:#fff3e0
    style MIN fill:#f3e5f5

🔄 Упрощенный Happy Path

sequenceDiagram
    participant U as 👤 Пользователь
    participant PWA as 📱 PWA App
    participant API as 🚀 Saga API
    participant C2B as 💳 Crypto2B
    participant TG as 📱 Telegram
    participant OP as 👨‍💼 Оператор
    participant FORD as 💼 Fordefi

    Note over U,FORD: 🎯 MVP Happy Path: 500 USD+ автоинвестирование

    U->>PWA: Вход через Google
    PWA->>API: Авторизация

    Note over PWA: Показать TRC20/USDT - с автоинвестированием

    PWA->>API: Запрос депозитного адреса
    API->>C2B: Генерация адреса TRC20
    C2B-->>API: Готовый адрес
    API-->>PWA: Адрес для 500 USD+ депозита

    U->>C2B: Перевод 1000 USD USDT
    C2B->>API: Webhook: депозит получен

    API->>API: Автосоздание инвестиции
    API->>TG: 📥 Уведомление: +1000 USD USDT
    TG-->>OP: Push уведомление

    API->>API: Запуск ежедневных начислений
    PWA->>API: Запрос портфеля
    API-->>PWA: График роста: 1000 USD → 1002 USD.74

    Note over OP,FORD: Оператор собирает средства вручную

    OP->>FORD: Ручной сбор на стейкинг
    FORD->>FORD: Размещение в DeFi протоколы

📤 Процесс вывода MVP

sequenceDiagram
    participant U as 👤 Пользователь
    participant PWA as 📱 PWA App
    participant API as 🚀 Saga API
    participant TG as 📱 Telegram
    participant OP as 👨‍💼 Оператор
    participant C2B as 💳 Crypto2B
    participant EMAIL as 📧 Email

    U->>PWA: Запрос вывода 800 USD
    PWA->>PWA: Выбор: закрыть инвестицию OR баланс

    alt Закрытие инвестиции
        PWA->>API: Частичное закрытие 80%
        API->>API: Расчет: 800 USD + проценты
    else Вывод с баланса
        PWA->>API: Проверка свободных средств
    end

    U->>PWA: Ввод адреса + сеть (TRC20)
    PWA->>API: Создание запроса вывода

    API->>TG: 📤 Уведомление: -800 USD USDC
    TG-->>OP: Запрос на обработку

    OP->>C2B: Ручная инициация вывода
    C2B->>C2B: Отправка транзакции
    C2B->>API: Webhook: вывод выполнен

    API->>EMAIL: Уведомление пользователю
    EMAIL-->>U: "Вывод 800 USD выполнен"

    Note over U,EMAIL: ⏱️ SLA: до 24-48 часов

🛠️ Operational MVP Process

stateDiagram-v2
    [*] --> DepositReceived: Депозит получен

    DepositReceived --> AutoInvest: 500 USD+ → Автоинвестирование
    DepositReceived --> Balance: <500 USD → На баланс

    AutoInvest --> TelegramNotify: Уведомление оператору
    Balance --> TelegramNotify

    TelegramNotify --> ManualCollection: Ручной сбор средств
    ManualCollection --> FordefiStaking: Размещение в Fordefi

    FordefiStaking --> DailyEarnings: Ежедневные начисления
    DailyEarnings --> PortfolioGrowth: Рост портфеля

    PortfolioGrowth --> WithdrawRequest: Запрос вывода
    WithdrawRequest --> ManualWithdraw: Ручная обработка
    ManualWithdraw --> [*]: Средства выведены

    style AutoInvest fill:#e8f5e8
    style ManualCollection fill:#fff8e1
    style DailyEarnings fill:#e3f2fd

📊 MVP Metrics Dashboard

Для операторов (админка)

📈 Общая статистика
├── 💰 Total Value Locked: $125,000
├── 👥 Активных пользователей: 47
├── 📥 Депозитов сегодня: +$12,500 (8 операций)
└── 📤 Выводов в очереди: -$3,200 (3 запроса)

⚡ Операционные метрики
├── 🕒 Среднее время обработки депозита: 1.2 часа
├── 🕒 Среднее время обработки вывода: 18 часов
├── ✅ Успешность операций: 99.8%
└── 📊 Доходность пользователей: 5.2% APY

Для пользователей (PWA)

💼 Мой портфель
├── 💵 Инвестировано: $1,000.00
├── 📈 Текущая стоимость: $1,027.40
├── 🎯 Прибыль: +$27.40 (+2.74%)
└── 📅 Дней в инвестиции: 14

🔄 История операций
├── 📥 15.10.2025: Депозит +$1,000 USDT
├── 📈 16.10-29.10: Ежедневные начисления +$27.40
└── 📊 Доходность: 5.2% APY

🚨 MVP Error Handling

graph TD
    ERROR[🚨 Ошибка в системе] --> TYPE{Тип ошибки}

    TYPE -->|Депозит| DEP_ERR[❌ Проблема депозита]
    TYPE -->|Вывод| WITH_ERR[❌ Проблема вывода]
    TYPE -->|Система| SYS_ERR[❌ Системная ошибка]

    DEP_ERR --> DEP_CHECK[🔍 Проверка блокчейна]
    DEP_CHECK -->|Найдена| DEP_CREDIT[✅ Ручное зачисление]
    DEP_CHECK -->|Не найдена| DEP_REFUND[↩️ Возврат средств]

    WITH_ERR --> WITH_MANUAL[🔧 Ручная обработка]
    WITH_MANUAL -->|Успешно| WITH_COMPLETE[✅ Завершено]
    WITH_MANUAL -->|Ошибка| WITH_CANCEL[❌ Отменено]

    SYS_ERR --> DEV_ALERT[🚨 Алерт разработчикам]
    DEV_ALERT --> HOTFIX[🔥 Hotfix deployment]

    DEP_CREDIT --> TG_NOTIFY[📱 Telegram уведомление]
    WITH_COMPLETE --> EMAIL_NOTIFY[📧 Email уведомление]

    style ERROR fill:#ffebee
    style DEP_CREDIT fill:#e8f5e8
    style WITH_COMPLETE fill:#e8f5e8

---

✅ MVP Ready for Development

Архитектура упрощена до минимальной жизнеспособной версии: - ✅ Один продукт — ликвидные стейблкоины с фиксированной доходностью - ✅ Простая интеграция — Crypto2B + ручное управление Fordefi - ✅ Минимальный UI — PWA для пользователей + админка для операторов - ✅ Базовые уведомления — Email пользователям, Telegram операторам - ✅ Четкие SLA — депозиты <2ч, выводы <48ч

Timeline: 4-6 недель до запуска MVP 🚀

---

📋 Связанная документация

• Integration-Only Architecture - основные принципы
• Crypto2B Integration ADR - техническая реализация
• Authentication Flow - email-first подход
• Deposits Flow - Crypto2B integration

Архитектурные принципы MVP: - ✅ Email MANDATORY для всех пользователей - ✅ Только внешние интеграции (Crypto2B, Fordefi) - ✅ Single strategy: 10% APY фиксированная доходность - ❌ Никаких HD Wallet, blockchain мониторинга, smart contracts для custody