How swamini-jadhav/finiq works
Project type and purpose
• FinIQ is a full-stack MERN application augmented by a separate Flask-based ML microservice.
• Purpose: provide authenticated users with stock price forecasts (LSTM), news sentiment analysis, AI chatbot insights, and an interactive dashboard.
File structure
• Top-level folders:
• backend/ – Node.js + Express REST API, MongoDB models, Passport JWT auth, business logic & routing
• frontend/ – React single-page app, TailwindCSS, React Router, Chart.js, Axios calls to backend
• ml-service/ – Flask microservice exposing LSTM prediction, sentiment analysis & chatbot endpoints
• Key patterns:
• MVC-style in backend (models/, routes/, middleware/)
• “context” pattern in React for auth state
• Microservice architecture: ML algorithms isolated in Flask container
• Config & deployment files: package.json in each service, requirements.txt for ml-service, .gitignore
README for additional insights
• Auth: signup/signin with JWT issued by backend
• ML Service:
• LSTM network (PyTorch) for 60-day lookback price forecasting
• TextBlob + NewsAPI for sentiment scoring
• Chatbot logic in chatbot.py
• Dashboard: real-time Chart.js visualizations
• External dependencies: MongoDB Atlas (or self-hosted), NewsAPI
a. Main components
• Web Client (React SPA)
• API Server (Node.js/Express)
• ML Microservice (Flask)
• Database (MongoDB)
• External Services (NewsAPI, optional yfinance endpoint)
• End user/browser
b. Relationships & data flows
1. Browser ↔️ React app (user actions, routing)
2. React → Express API (Axios calls to /auth, /chatbot, /ml)
3. Express API ↔️ MongoDB (Mongoose CRUD for users & historical data)
4. Express API → Flask ML Service endpoints (HTTP REST: /predict, /sentiment, /chat)
5. Flask ML Service ↔️ External APIs (NewsAPI, yfinance)
6. Flask returns ML results → Express → React
c. Architectural patterns
• Microservices: decoupled ML logic in its own container
• MVC in backend: Models, Routes (Controllers), Middleware
• JWT-based stateless auth
• Context API in React for global state (AuthContext)
d. Key technologies
• Frontend: React.js, TailwindCSS, Chart.js, Axios, React Router
• Backend: Node.js, Express, Mongoose, Passport.js, JWT
• ML Service: Flask, PyTorch, TextBlob, yfinance, NewsAPI