venus-trading

As a guest or logged-in user I want to browse live asset prices on the Markets page so that I can identify trading opportunities across stocks, crypto, and forex. Implement a filterable/searchable asset list with columns: asset name, price (INR), 24h change %, chart sparkline, and a 'Trade' CTA linking to /Trade. Tabs for Stocks, Crypto, Forex, Commodities. Guest users see demo data; authenticated users see live data. Flows from /Landing and /Dashboard.

As a user or guest I want to access educational resources on the Learn page so that I can improve my trading knowledge. Implement a content hub with course cards (title, difficulty badge, duration, progress bar for logged-in users), category filters (Basics, Crypto, Forex, Technical Analysis, Tax & Compliance), featured article banner, and video lesson previews. Guest users see intro content only. Links from /Landing and /Dashboard.

As a user I want to sign in securely via the Login page so that I can access my dashboard and trading tools. Implement the Login page with email/password fields, 'Forgot Password' link, social login options, error handling, and a link to /Signup. On success, redirect Admin users to /Admin Dashboard and regular users to /Dashboard. Apply Venus-Trading theme tokens.

As a guest user I want to browse the Venus-Trading platform landing page so that I can explore features, view live market teasers, and navigate to Signup or Login. Implement the Landing page based on the existing JSX design (v2) which includes: NavBar (sticky, galaxy-aware), Hero (animated galaxy particle canvas, 'Trade the Universe' headline, dual CTAs), GalaxyExplorer (interactive star-map), TrustBadges (marquee), AssetClasses (4-col card grid), PlatformFeatures (alternating showcase), LiveMarketTicker (#0077B6 bg), HowItWorks (4-step flow), UserPersonas (3-col cards), Testimonials, CallToAction (dark gradient), and Footer. Links flow to: /Markets, /Learn, /Signup, /Login.

As an individual investor I want to register on the Signup page so that I can create a Venus-Trading account and start investing. Implement the Signup page with fields for name, email, phone, password, and account type selection (Individual Investor, Professional Trader, Institutional Client). Include terms acceptance, KYC intro messaging, and a link to /Login. On success, redirect to /Dashboard.

As an admin I want to view platform-wide activity on the Admin Dashboard so that I can monitor users, transactions, and compliance in real time. Implement KPI cards (active users, daily volume, pending withdrawals, flagged accounts), activity feed, quick-links to /Users, /Withdrawals, /Reports, /Compliance, and a platform health status widget. Accessible only to Admin role after login.

As a user I want to use backend APIs for registration, login, JWT token management, and role-based access control so that my account is secure and properly permissioned. Implement FastAPI endpoints: POST /auth/register, POST /auth/login, POST /auth/refresh, POST /auth/logout, GET /users/me, PATCH /users/me. Include email verification flow, password hashing (bcrypt), and JWT with role claims (user/admin). Store in MySQL.

As a user I want to view my portfolio overview and key stats on the Dashboard page so that I can monitor my investments at a glance. Implement the Dashboard page with: portfolio summary cards (total value, P&L, day change), recent trades table, quick-access tiles to /Markets, /Trade, /Wallet, /Learn, /Portfolio, and /Charts. Support both Individual Investor (simplified view) and Professional Trader (analytics-heavy view) layouts. Apply Venus-Trading surface cards and accent tokens.

As a professional trader I want to analyze market data on the Charts page so that I can make informed trading decisions using advanced charting tools. Implement full-screen candlestick/OHLC charts with TradingView-style toolbar, timeframe selector (1m, 5m, 1h, 1D, 1W), technical indicators panel (RSI, MACD, Bollinger Bands), drawing tools, and asset search. Links from /Dashboard; 'Trade' button routes to /Trade with pre-selected asset.

As an admin I want to review and action withdrawal requests on the Withdrawals page so that I can approve or reject user fund requests in compliance with platform policies. Implement a queue table (user, amount, bank details, requested date, status), approve/reject buttons with reason modal, bulk action support, and status filter tabs (Pending, Approved, Rejected). Links from /Admin Dashboard.

As an admin or institutional client I want to generate and view reports on the Reports page so that I can analyze platform usage, financial transactions, and compliance metrics. Implement report type selector (User Activity, Transaction Volume, P&L Summary, Compliance Audit), date range picker, export to CSV/PDF, and an embedded data table with charts. Links from /Admin Dashboard and /Portfolio.

As a professional trader or institutional client I want to manage API keys on the API Settings page so that I can integrate Venus-Trading with external tools and algorithms. Implement API key generation, key list with name/created date/permissions/last-used, revoke button, IP whitelist input, usage stats chart, and documentation link. Links from /Dashboard.

As a user I want to place buy/sell orders on the Trade page so that I can execute trades across stocks, crypto, and forex. Implement order form (market/limit/stop-loss), asset selector, quantity/price inputs, order preview, and confirmation modal. Show current asset price, balance available, and estimated fee. Support bulk order entry for Institutional Clients. Links from /Markets and /Dashboard; on success routes to /Portfolio.

As a user I want to manage and track my holdings on the Portfolio page so that I can monitor positions, P&L, and asset allocation. Implement holdings table (asset, qty, avg cost, current price, P&L %), allocation pie chart, historical value line chart, and filter by asset class. For Institutional Clients show aggregate holdings across sub-accounts. Links from /Trade and /Dashboard.

As an admin I want to manage user accounts on the Users page so that I can view, edit, suspend, or delete user accounts and adjust permissions. Implement a searchable/filterable user table (name, email, account type, KYC status, balance, joined date), user detail drawer/modal with edit form, role assignment dropdown, and account suspend/activate toggle. Links from /Admin Dashboard.

As a user I want to deposit and withdraw funds via the Wallet page so that I can manage my trading capital in INR and other currencies. Implement balance summary, deposit flow (UPI/NEFT/bank transfer), withdrawal request form, transaction history table, and pending status tracker. Admin approval flow for withdrawals. Links from /Dashboard; withdrawal requests appear in /Withdrawals for admins.

As an admin I want to monitor regulatory compliance on the Compliance page so that I can ensure the platform adheres to SEBI and RBI regulations. Implement a compliance dashboard with flagged transaction alerts, KYC verification queue (approve/reject with document preview), AML risk score display, regulatory checklist status, and audit log viewer. Links from /Admin Dashboard.

As a user I want to use backend APIs for wallet management, deposits, and withdrawal requests so that I can safely move funds in and out of my account. Implement FastAPI endpoints: GET /wallet/balance, POST /wallet/deposit, POST /wallet/withdraw, GET /wallet/transactions. Include INR payment gateway stub (UPI/NEFT), withdrawal request queuing for admin approval, and transaction ledger in MySQL.

As a user I want to use backend APIs for real-time and historical market data so that the Markets, Charts, and Dashboard pages display accurate prices. Implement FastAPI endpoints: GET /markets/assets, GET /markets/price/{symbol}, GET /markets/history/{symbol}, GET /markets/ticker (WebSocket). Integrate with an external data provider (e.g., Alpha Vantage or NSE API), cache in Redis, and serve via WebSocket for live updates.

As an admin I want to use backend APIs for user management, withdrawal approval, reports, and compliance so that I can operate the platform effectively. Implement FastAPI endpoints: GET /admin/users, PATCH /admin/users/{id}, DELETE /admin/users/{id}, GET /admin/withdrawals, PATCH /admin/withdrawals/{id}/approve, PATCH /admin/withdrawals/{id}/reject, GET /admin/reports, GET /admin/compliance/flags. Protect all routes with admin-role JWT guard.

As a professional trader or institutional client I want to use backend APIs to generate and manage API keys so that I can programmatically access Venus-Trading data and execute trades. Implement FastAPI endpoints: POST /api-keys, GET /api-keys, DELETE /api-keys/{id}, with scopes (read/trade), IP whitelist validation, usage logging in MongoDB, and rate limiting per key.

As a user I want to use backend APIs to place and manage orders so that my trades are executed accurately and recorded. Implement FastAPI endpoints: POST /trade/order, GET /trade/orders, DELETE /trade/order/{id}, GET /trade/order/{id}/status. Support market, limit, and stop-loss order types. Validate balance before execution, deduct/credit accordingly, and emit order status via WebSocket. Store trades in MySQL.

As a user I want to use backend APIs for portfolio data so that the Portfolio page shows accurate holdings, allocation, and P&L. Implement FastAPI endpoints: GET /portfolio/holdings, GET /portfolio/summary, GET /portfolio/history. Compute P&L using average cost basis, current market price from market data service, and aggregate by asset class. Support institutional sub-account rollups.