How juma1-hub/supa_ai works
Supa AI combines a trading dashboard and strategy-builder prototype with a backend that exposes authenticated account, market-analysis, and Demo-workflow APIs. The user-facing flow spans preview or Deriv sign-in, workspace navigation, strategy drafting/review, and market monitoring; the README cautions that frontend drafts are local and its digit panel may be illustrative. Sampled backend code confirms that analysis is read-only and Demo purchase is disabled. Some backend wiring is supported by the SOURCE INDEX; unsampled UI-to-backend connections are omitted.
Main entry points: main.py FastAPI endpoints · WorkspaceClient.tsx Workspace UI · page.tsx Account selection · deriv_market_data.py Public market collector
Components 25
Dashboard and workspace
- Dashboard
frontend/app/page.tsx - Preview workspace
frontend/app/preview/page.tsx - Workspace UI
frontend/app/workspace/WorkspaceClient.tsx - Strategy workspace
frontend/app/workspace/SupaAutoTrader.tsx
Identity and accounts
- OAuth callback
frontend/app/auth/deriv/callback/page.tsx - Account selection
frontend/app/account/page.tsx - Account API routes
frontend/app/api/account/links/route.ts - Deriv auth routes
frontend/app/api/auth/deriv/accounts/route.ts - Deriv account checks
backend/app/deriv_account.py
Strategy and market analysis
- Browser strategy engine
frontend/app/workspace/strategy-engine.ts - Strategy rule validation
backend/app/strategy_rules.py - Strategy analysis API
backend/app/strategy_engine_api.py - Strategy state engine
backend/supa_ai_engine/engine.py - Public market collector
backend/app/deriv_market_data.py
API and runtime
- FastAPI endpoints
backend/app/main.py - User runtime
backend/app/user_runtime.py - Purchase reconciliation
backend/app/purchase_reconciliation.py - Execution guard
backend/app/execution_guard.py - Demo proposals and status
backend/app/deriv_demo_trading.py
Persistence and integrations
- Supabase auth verifier
backend/app/supa_auth.py - Supabase persistence adapter
backend/app/supa_store.py
Other components
- Visitor / user
- Deriv services
- Supabase services
- Browser local storage
Connections 31
- Visitor / user → Dashboard: opens
README.md - Visitor / user → Preview workspace: previews
README.md - Visitor / user → OAuth callback: signs in
README.md - Dashboard → Workspace UI: opens workspace
README.md - Preview workspace → Workspace UI: renders
frontend/app/preview/page.tsx - Workspace UI → Strategy workspace: renders
frontend/app/workspace/WorkspaceClient.tsx - Strategy workspace → Browser strategy engine: uses
frontend/app/workspace/SupaAutoTrader.tsx - Browser strategy engine → Browser local storage: persists drafts
README.md - OAuth callback → Deriv services: exchanges code
README.md - Visitor / user → Account selection: selects account
README.md - Account selection → Deriv auth routes: requests account choices
- Account selection → Account API routes: loads linked accounts
- FastAPI endpoints → Supabase auth verifier: verifies identity
backend/app/main.py - Supabase auth verifier → Supabase services: verifies token
backend/app/supa_auth.py - FastAPI endpoints → Strategy rule validation: validates rules
backend/app/main.py - FastAPI endpoints → Strategy analysis API: handles analysis
backend/app/main.py - Strategy analysis API → Strategy state engine: updates analysis
backend/app/strategy_engine_api.py - FastAPI endpoints → Public market collector: controls collection
backend/app/main.py - Public market collector → Deriv services: subscribes to ticks
backend/app/deriv_market_data.py - Public market collector → Strategy state engine: feeds statistics
backend/app/deriv_market_data.py - FastAPI endpoints → User runtime: serves user state
backend/app/main.py - User runtime → Strategy state engine: uses analysis state
backend/app/user_runtime.py - FastAPI endpoints → Purchase reconciliation: handles reconciliation
backend/app/main.py - FastAPI endpoints → Execution guard: guards execution
- FastAPI endpoints → Deriv account checks: checks accounts
backend/app/main.py - Deriv account checks → Deriv services: checks balance
backend/app/deriv_account.py - FastAPI endpoints → Demo proposals and status: prepares Demo proposals
backend/app/main.py - Demo proposals and status → Deriv services: requests proposals
backend/app/deriv_demo_trading.py - FastAPI endpoints → Supabase persistence adapter: persists state
backend/app/main.py - Supabase persistence adapter → Supabase services: reads and writes
backend/app/supa_store.py - Workspace UI → Deriv services: monitors public ticks
frontend/app/workspace/WorkspaceClient.tsx