magma-stocks

You are a senior software architect and technical writer. I am building a full-stack web application for a university project. The frontend must use **Next.js**, and the backend must use a **Python framework (FastAPI preferred)**. Your task is to generate **complete technical documentation and system design** for this project. Project name: **StockVision – Advanced Stock Market Analytics Platform** Project description: This is a dynamic stock market analytics platform where users can explore real-world stock market data, track portfolios, create watchlists, and access advanced analytics features. The application will integrate with external stock market APIs to fetch real-time and historical market data. The platform will also include **premium features that users can purchase through a checkout system**, which satisfies the requirement of having a checkout/payment feature. Tech stack requirements: Frontend: * Next.js (App Router) * React * TypeScript * Tailwind CSS * Shadcn UI * TanStack Query * Chart.js or TradingView charts Backend: * Python FastAPI * PostgreSQL database * SQLAlchemy ORM * JWT authentication * Redis caching (optional) External APIs: * Alpha Vantage or Finnhub stock market API Payment: * Stripe or Razorpay The system must include the following core features: Authentication * User signup * User login * JWT-based authentication * Password hashing Stock Listing * List popular or trending stocks * Search stocks by symbol or company name * Display stock price, change %, and basic information Stock Detail Page * Detailed stock information * Historical price charts * Technical indicators * Company details * Market news (optional) Watchlist * Users can save stocks to a watchlist * Add/remove stocks Portfolio Tracker * Users can simulate investments * Track profit/loss * View portfolio value Premium Features * Advanced indicators * Unlimited watchlists * Export stock data * Advanced analytics Pricing and Checkout * Pricing page showing free vs premium plans * Checkout page * Payment integration with Stripe or Razorpay * Subscription management Required Pages: * Home * Login * Signup * Stocks listing page * Stock detail page * Watchlist * Portfolio * Pricing * Checkout * User dashboard/profile Please generate the following documentation: 1. High-level system architecture 2. Complete project folder structure (frontend + backend) 3. Database schema and ER diagram 4. API design with endpoints 5. Authentication flow 6. Data flow between frontend, backend, and stock APIs 7. UI page structure 8. Component architecture for Next.js 9. Backend service architecture 10. Deployment architecture 11. Optional scalability improvements The documentation should be structured professionally as if it were a real production project.