Getting Started
Project Structure
How the current dashboard and bot codebase is organized.
Dashboard (trading-dashboard/)
text
trading-dashboard/
├── app/
│ ├── (auth)/ # login, register, reset-password
│ ├── (dashboard)/ # protected dashboard pages
│ │ ├── dashboard/ # main overview
│ │ ├── bot/ # bot control, strategy mode, pair selection
│ │ ├── accounts/ # Local MT5 Login + account sync
│ │ ├── settings/ # advanced risk + Telegram settings
│ │ ├── billing/ # subscription and license key
│ │ └── download/ # Windows package download
│ ├── (docs)/ # this documentation
│ ├── (marketing)/ # landing, pricing, blog
│ └── api/ # internal dashboard API routes
├── components/
│ ├── dashboard/ # charts, tables, stat cards
│ ├── docs/ # docs layout and helpers
│ ├── layout/ # sidebar, nav, search
│ └── marketing/ # landing page components
├── lib/
│ ├── auth.ts # Better Auth config
│ ├── prisma.ts # Prisma client
│ └── subscription.ts # plan limits and plan gating
└── prisma/
└── schema.prisma # database schemaPython Bot (trading-bot/)
text
trading-bot/ ├── main.py # entry point and runtime loop ├── config/ │ └── settings.json # advanced config and defaults ├── core/ │ ├── license.py # license validation │ ├── mt5_connector.py # MT5 connect/reconnect │ └── trade_executor.py # place/manage/close orders ├── strategies/ │ ├── smc_strategy.py │ ├── trend_pullback.py │ ├── breakout_strategy.py │ └── scalping_strategy.py ├── filters/ │ ├── session_filter.py │ ├── news_filter.py │ ├── market_regime.py │ ├── market_quality.py │ └── correlation_filter.py ├── ai/ │ ├── signal_filter.py │ ├── sentiment.py │ └── volatility.py ├── risk/ │ └── risk_manager.py ├── bot_api/ │ └── main.py # local FastAPI bridge used by the dashboard ├── utils/ │ ├── local_secrets.py # local runtime secret storage for MT5 + Telegram │ ├── notifications.py # Telegram notifications │ ├── dashboard_client.py # sync between bot and dashboard services │ └── strategy_names.py # strategy aliases and normalization ├── backtest/ │ ├── backtest_engine.py │ └── optimize_strategies.py ├── supervisord.conf # keeps local bot services running └── requirements.txt
Project Root
text
/ ├── docker-compose.yml # local app stack ├── .env.example # deployment env template └── start-bot.bat # Windows: start bot API + trading bot
If you are documenting the product for end users, the pages that matter most are Setup, Bot, Accounts, Settings, Billing, and Download. The rest of the structure is mainly useful for developers and operators.