Quantify

Quantify is a full-stack simulated trading platform built using the MERN stack, designed to replicate core functionalities of real-world trading systems. It focuses on backend system design, secure transaction handling, and real-time data interaction.

🚀 Features

🔐 Authentication & Security

• Secure user authentication using JWT (JOSE)
• Helmet.js for HTTP security headers
• Rate limiting with Redis (in progress) to prevent API abuse

📊 Market Data & Visualization

• Real-time market data streaming for stocks and indices
• Interactive charts for price analysis and trends

💼 Portfolio Management

• Dynamic portfolio tracking with real-time valuation
• Aggregation of holdings and profit/loss calculations

🧾 Trade Execution Engine

• Simulated buy/sell order placement
• Validation logic to ensure sufficient balance before execution
• Atomic updates to portfolio and transaction history

🕒 Transaction History

• Persistent logging of all trades
• Efficient querying for user-specific trade history

🧑‍💻 Backend Architecture

• RESTful API design using Express.js
• Modular structure with routes, middleware, and controllers
• MongoDB for flexible data modeling
• Redis integration for caching and rate limiting

📱 Frontend

• React.js with responsive Bootstrap UI
• Axios for API communication
• React Router for navigation

🛠️ Tech Stack

Frontend:

• React.js, React-Bootstrap, Axios, React Router

Backend:

• Node.js, Express.js, MongoDB (Mongoose)
• JWT (JOSE), Redis, Helmet.js, Morgan, CORS

Package Manager:

• pnpm

Notes

Initial frontend boilerplate was generated using AI tools (Google Antigravity) (SignUp,login and Services Pages Only) and then customized and extended manually.

🔄 Request Flow

1. Client sends request (e.g., buy/sell order)
2. Request passes through authentication & validation middleware
3. Controller processes trade logic
4. Database is updated (portfolio + transactions)
5. Response is returned to client

---

📁 Project Structure

Quantify/
│
├── backend/
│   ├── models/
│   ├── routes/
│   ├── controllers/
│   ├── middleware/
│   ├── config/
│   └── server.js
│
├── frontend/
│   ├── src/
│   │   ├── components/
│   │   ├── pages/
│   │   ├── services/
│   │   ├── App.jsx
│   │   └── main.jsx
│   └── index.html
│
├── .env
├── pnpm-workspace.yaml
├── package.json
└── README.md
Backend-Folder Structure
backend/
│
├── src/
│   ├── config/
│   │   └── db.js            # MongoDB connection
│   │
│   ├── models/
│   │   └── User.model.js
│   │
│   ├── controllers/
│   │   └── auth.controller.js
│   │
│   ├── routes/
│   │   └── auth.routes.js
│   │
│   ├── middlewares/
│   │   └── auth.middleware.js
│   │
│   ├── app.js
│   └── server.js
│
├── .env
├── package.json
└── README.md
---

## ⚙️ Installation & Setup

### Prerequisites

* Node.js (v18+ recommended)
* PNPM
* MongoDB (local or Atlas)

### Install PNPM (if not installed)

```bash
npm install -g pnpm

Clone the Repository

git clone https://github.com/jayalloyd/quantify.git
cd Quantify

Install Dependencies

pnpm install

---

▶️ Running the Project

Start Backend

cd backend
pnpm run dev

Start Frontend

cd frontend
pnpm run dev

Frontend will run on:

http://localhost:5173

Backend will run on:

http://localhost:5000

---

🔐 Environment Variables

Create a .env file inside backend/:

PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_secret_key

---

🧪 Future Enhancements

• WebSocket-based live price updates
• Payment gateway integration
• Role-based admin dashboard
• Advanced charting (TradingView)
• Watchlists & alerts

---

📜 License

This project is for educational purposes only and is a demo project and is not affiliated with any trading platform.

---

👨‍💻 Author

Quantify

Jaya Rani.Y.S

Linkedin:jayarani y s Github: jayalloyd