Add complete WealthMind full-stack investment platform (Groww clone)

[Copilot]

Overview

This PR implements a comprehensive full-stack investment platform called WealthMind, which replicates the core features of the Groww investment app. The application is built with the MERN stack (MongoDB, Express.js, React, Node.js) and includes authentication, portfolio management, stock trading, and personalized recommendations.

Features Implemented

🔐 Authentication & User Management

• User registration and login with JWT authentication
• Secure password hashing using bcrypt
• Protected API routes with middleware
• User preference management (risk level, investment goals, investment horizon)

📊 Portfolio Management

• Real-time portfolio tracking with profit/loss calculations
• Holdings breakdown with performance metrics
• Sector and risk allocation visualization using Recharts
• Automatic portfolio updates on trade execution

💹 Stock Market

• Browse 50 diverse stocks across 11 sectors (IT, Banking, FMCG, Pharma, Automobile, etc.)
• Advanced search and filtering by sector, risk level, and market cap
• Detailed stock information pages with key metrics (P/E ratio, volatility, dividend yield)
• Real-time price and change percentage display

💰 Trading System

• Buy and sell stock functionality with validation
• Order execution and confirmation
• Transaction history tracking
• Quantity and availability checks

🎯 Smart Recommendation Engine

• Rule-based algorithm considering user preferences
• Personalized stock recommendations based on:
  • Risk tolerance (Low/Medium/High)
  • Investment goals (Income/Growth/Balanced)
  • Investment horizon (Short/Medium/Long)
• Returns 5-8 tailored stock suggestions

📈 Analytics & Visualization

• Interactive portfolio pie charts (sector allocation)
• Performance tracking with P&L percentages
• Top gainers and losers
• Responsive charts using Recharts library

Technical Implementation

Backend Architecture

WealthMind/backend/
├── server.js              # Express app entry point
├── models/                # Mongoose schemas (User, Stock, Portfolio, Order)
├── controllers/           # Business logic (6 controllers)
├── routes/                # API endpoints (14 endpoints total)
├── middleware/            # JWT authentication
├── seedData.js           # Database seeder
└── mockStocks.json       # 50 stock seed data

API Endpoints:

• POST /api/auth/register - User registration
• POST /api/auth/login - User authentication
• GET /api/market - Get all stocks with filters
• GET /api/market/:symbol - Get specific stock
• GET /api/portfolio - Get user portfolio (protected)
• POST /api/orders/buy - Buy stock (protected)
• POST /api/orders/sell - Sell stock (protected)
• GET /api/recommendations/:userId - Get personalized recommendations (protected)

Frontend Architecture

WealthMind/frontend/src/
├── App.jsx               # Main app with routing
├── components/           # Navbar component
├── pages/                # 7 pages (Login, Register, Dashboard, Market, StockDetail, Portfolio, Profile)
├── context/              # AuthContext for state management
└── utils/                # API client and helper functions

Key Technologies:

• React 18 with Hooks
• Vite for fast builds
• Tailwind CSS for styling
• React Router v6 for navigation
• Axios for HTTP requests
• Recharts for data visualization

Database Design

• Users - Authentication and preferences
• Stocks - 50 diverse stocks with market data
• Portfolios - User holdings and calculations
• Orders - Transaction history

Indexes on: email, symbol, userId, sector, riskLevel

Docker Deployment

• Multi-container setup with Docker Compose
• Services: MongoDB, Backend (Node.js), Frontend (React)
• Persistent MongoDB volume
• Network isolation with bridge network

Testing & Verification

Backend API ✅

• Health check endpoint working
• User registration and login tested
• Stock endpoints returning 50 stocks correctly
• Portfolio operations functioning
• Trade execution (buy/sell) validated
• JWT authentication protecting routes

Frontend ✅

• Build successful (608 KB bundle, 176 KB gzipped)
• All 7 pages rendering correctly
• Navigation and routing working
• Forms with validation functional
• Charts rendering properly
• Responsive design verified

Database ✅

• MongoDB running on port 27017
• Seed data loaded successfully (50 stocks + 3 demo users)
• Indexes created for optimization
• Relationships between collections working

Documentation

Comprehensive documentation provided:

• README.md (540 lines) - Features, setup, and API documentation
• QUICKSTART.md (315 lines) - Quick start guide and troubleshooting
• ARCHITECTURE.md (436 lines) - System architecture and design patterns
• TESTING.md (469 lines) - Testing guide and verification steps
• PROJECT_SUMMARY.md (470 lines) - Complete project overview

Quick Start

cd WealthMind
docker compose up --build
docker exec -it wealthmind-backend npm run seed

# Access the application
# Frontend: http://localhost:3000
# Backend: http://localhost:5000
# MongoDB: mongodb://localhost:27017

# Demo credentials
# Email: john@example.com
# Password: password123

Project Statistics

• Total Files: 58 files
• Code Lines: 6,711 lines
• API Endpoints: 14 (3 public, 11 protected)
• React Pages: 7 pages
• Mock Stocks: 50 across 11 sectors
• Demo Users: 3 with different risk profiles

Security Features

• Password hashing with bcrypt (salt rounds)
• JWT token-based authentication
• Protected routes with middleware
• Input validation using express-validator
• CORS configuration
• Environment variable management

Future Enhancements

Potential additions for Phase 2:

• Real-time stock price updates (WebSocket)
• SIP (Systematic Investment Plan)
• Price alerts and notifications
• Watchlist functionality
• Advanced charting (candlestick, indicators)
• News feed integration
• Admin dashboard
• Two-factor authentication

Notes

• All stock data is fictional and for demonstration purposes only
• This is an educational project showcasing MERN stack development
• Not intended for actual investment decisions
• Demo credentials provided for easy testing

---

Ready for review and demonstration! 🚀

Original prompt

Generate a full-stack Groww clone named WealthMind using React, Node.js, Express, and MongoDB.
Include authentication, portfolio management, stock market page, buy/sell functionality, and a personalized recommendation system based on user goals and risk levels.
Use Tailwind CSS for styling, React Router for navigation, JWT for auth, and Docker Compose for deployment.
Create modular, well-commented code with clear folder structure and example seed data for 50 stocks.
Provide sample APIs, frontend components, and documentation inside the repo." roject Name: WealthGrow – Groww App Duplicate (Major Project)
Goal: Build a full-stack web app that replicates key features of the Groww investment platform.
The system will allow users to sign up, invest in mock stocks/funds, view portfolios, get recommendations, and track investment performance in real-time.

🏗️ Core Requirements
1️⃣ Architecture

Full-stack MERN application (MongoDB + Express.js + React + Node.js)

Use Docker Compose for backend, frontend, and database setup.

Maintain clear folder structure:

/backend
├── server.js
├── routes/
├── models/
├── controllers/
├── config/
/frontend
├── src/
├── components/
├── pages/
├── context/
/database
├── seed/
├── mockStocks.json
docker-compose.yml
README.md

2️⃣ Backend (Node.js + Express)

Create a RESTful backend with:

✅ Authentication

Register/Login using JWT and bcrypt.

/auth/register and /auth/login routes.

✅ User Profile

Store user risk level, goals, and investment horizon.

/user/preferences (GET/POST).

✅ Market Data

/market to list mock stocks from a JSON file or database.

Include symbol, company name, price, change %, volatility, and risk tag.

✅ Portfolio

/portfolio to show user holdings, total invested, and current value.

/orders/buy and /orders/sell to simulate trades.

✅ Stock Recommendation System

/recommendations/:userId route that returns 5 stocks matching user preferences.

Rule-based or cosine similarity logic (Python optional).

✅ SIPs & Alerts (Optional)

Allow simulated monthly SIPs and price-based notifications.

Include Sequelize or Mongoose models:

User, UserPreferences, Stock, Order, Portfolio

3️⃣ Frontend (React + Tailwind CSS)

Develop a responsive single-page app with pages:

/login – Authentication form

/register – Sign-up form

/dashboard – Portfolio summary + “Recommended for You”

/market – Stock list with search + filters

/stock/:symbol – Stock detail page (price, volatility, buy/sell button)

/profile – Set risk level, goal, and investment horizon

Use:

React Router for navigation

Axios for API calls

Context API or Redux for global state (auth + portfolio)

Recharts for visualizing portfolio allocation and P&L

Tailwind CSS for a clean, Groww-like interface

4️⃣ Recommendation Engine (Smart Suggestion System)

Simple logic:

Fetch user risk and goal → match stocks from stocks table.

Example rules:

Low risk → Large cap / FMCG / Banking

High risk → Small cap / Tech / Pharma

Goal: Income → Dividend yield > 2%

Goal: Growth → Return > 12%

Advanced (optional):

Add recommendation.py using scikit-learn:

Compute cosine similarity between user profile and stock features.

Return top 5 similar items via an API call.

5️⃣ Database (MongoDB or PostgreSQL)

Tables/Collections:

users
user_preferences
stocks
orders
portfolio

Include a seeder file to populate 50+ mock stocks:

{
"symbol": "TCS",
"name": "Tata Consultancy Services",
"sector": "IT",
"price": 3870.50,
"volatility": 12.5,
"avg_return": 11.8,
"risk_level": "Medium"
}

6️⃣ DevOps & Testing

Dockerfile + docker-compose.yml (services: backend, frontend, db)

GitHub Actions for test + build pipeline.

Jest / Supertest for backend unit tests.

ESLint + Prettier for clean code style.

7️⃣ Deliverables

✅ Fully functional Groww-like web app

✅ Auth, Portfolio, Market, and Recommendation features

✅ Responsive frontend with Tailwind

✅ REST APIs documented in README

✅ Docker deployment working locally

✅ Short demo video (optional)

✅ Final project report (architecture, DB schema, flow diagrams)

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.