📈 Quantify

🚧 Status: Active Development

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 high-performance backend system design, secure transaction handling, and seamless data interaction.

---

🚀 Features

🔐 Authentication & Security

• JWT (JOSE): Secure user authentication and session management.
• Middleware Protection: Custom authentication middleware to guard private routes.
• HTTP Security: Integrated Helmet.js for setting secure headers.
• Rate Limiting: (In Progress) Redis-backed rate limiting to prevent API abuse.

📊 Market Data & Watchlists

• Dynamic Watchlists: User-specific stock tracking with real-time price data simulation.
• Stock Analytics: Interactive charts for detailed price analysis and trend monitoring.

💼 Portfolio Management

• Live Tracking: Dynamic portfolio valuation based on current market prices.
• Holdings Management: Automated calculation of Profit/Loss (P&L) and total asset value.

🧾 Trade Execution Engine

• Simulated Orders: Seamless Buy/Sell execution logic.
• Atomic Updates: Ensures database consistency across portfolio and transaction logs.
• Validation: Server-side checks for sufficient balance and stock quantity.

---

🛠️ Tech Stack

• Frontend: React.js, React-Bootstrap, Axios, React Router
• Backend: Node.js, Express.js
• Database: MongoDB (Mongoose)
• Caching/Security: Redis (In Progress), JWT, Helmet.js, CORS
• Package Manager: pnpm

---

🏗️ System Architecture

graph TD
    subgraph Client_Side [Frontend - React.js]
        A[User Interface] --> B[State Management]
        B --> C[Axios / API Calls]
    end

    subgraph Security_Layer [Middleware]
        C --> D{JWT Authenticator}
    end

    subgraph Server_Side [Backend - Node.js/Express]
        D -- Authorized --> E[Controllers]
        E --> F[User Controller]
        E --> G[Portfolio Controller]
        E --> H[Watchlist Controller]
        E --> I[Transaction Controller]
    end

    subgraph Database_Layer [Data - MongoDB]
        F <--> J[(Users Collection)]
        G <--> K[(Portfolios Collection)]
        H <--> L[(WatchLists Collection)]
        I <--> M[(Transactions Collection)]
    end

    %% Styling
    style Client_Side fill:#e1f5fe,stroke:#01579b
    style Server_Side fill:#fff3e0,stroke:#e65100
    style Database_Layer fill:#e8f5e9,stroke:#1b5e20
    style Security_Layer fill:#fce4ec,stroke:#880e4f

Loading

🔄 Request Flow

sequenceDiagram
    participant User as User (React)
    participant API as API Gateway (Express)
    participant Auth as JWT Middleware
    participant DB as MongoDB

    User->>API: GET /watchlist
    API->>Auth: Verify Token
    Auth-->>API: Token Valid
    API->>DB: WatchList.find()
    DB-->>API: Data
    API-->>User: JSON Response
    

Loading

📁 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
---

my technical journey here: https://lnkd.in/gjUfJqSD

⚙️ Installation & Setup

Prerequisites

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

Install PNPM (if not installed)

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