📈 Trading Application

Modern Full-Stack Stock Trading & Portfolio Management Platform

---

📋 Table of Contents

• Overview
• Project Status
• Features
• Security
• Tech Stack
• Architecture
• Getting Started
• Project Structure
• API Reference
• Contributing
• Disclaimer
• License

---

📌 Overview

Trading Application is a full-stack stock trading platform developed using Go (Golang), Vue.js, Vuetify, and PostgreSQL.

The application enables users to securely register, manage their profile, maintain wallets, place buy and sell orders, track portfolios, and manage investments through a modular and scalable architecture.

This project is being developed as a production-oriented learning and portfolio application following enterprise software engineering practices.

---

🚧 Project Status

This project is currently under active development.

Core Modules Completed

• User Authentication & IPV KYC Flow
• Wallet Management
• Stock Trading
• Profile Management
• Admin Dashboard
• Live Stock Market API Integration
• Watchlist

In Progress

• Portfolio Analytics

Planned

• Notifications
• Real-Time Updates
• Mobile Optimization

---

✨ Features

🔐 Authentication & Security

• Secure user registration and login
• In-Person Verification (IPV) & comprehensive KYC flow
• JWT-based authentication
• Password reset and forgot password flow
• Comprehensive profile management (Occupation, Address, Bank details)

💰 Wallet & Orders

• Wallet Management — Maintain balances and transaction history
• Order Placement — Execute secure buy and sell orders
• Real-Time Tracking — Monitor stock prices and portfolio performance

📊 Portfolio Management

• Dashboard — Live overview of holdings and total balance
• Investment Management — Track and manage long-term investments

🚀 Enterprise Architecture

• Modular & Scalable — Designed following enterprise software engineering practices
• High-Performance Backend — Optimized concurrent processing with Go

---

🔒 Security

• JWT Authentication
• Password Hashing (bcrypt)
• Protected Routes
• Role-Based Authorization
• Session Management
• Backend Input Validation
• Frontend Input Validation
• Environment-Based Configuration

---

🛠️ Tech Stack

Frontend

Technology	Purpose
Vue 3	Progressive JavaScript framework for building user interfaces
Vuetify	Material Design component framework for Vue
Node.js	Runtime environment for development

Backend

Technology	Purpose
Go	Core language for backend services
Go Modules	Dependency management
RESTful API	Communication between client and server

Infrastructure & Databases

Technology	Purpose
PostgreSQL	Primary robust relational database for users, wallets, and trades

---

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│                        CLIENT (Browser)                     │
│  ┌────────────┐  ┌──────────────┐  ┌─────────────────────┐  │
│  │   Vue 3    │  │   Vuetify    │  │    Trading UI       │  │
│  │ Components │  │   Styling    │  │     & Wallets       │  │
│  └─────┬──────┘  └──────────────┘  └──────────┬──────────┘  │
│        │                                       │            │
│        │  REST API                             │ HTTP       │
└────────┼───────────────────────────────────────┼────────────┘
         │                                       │
         ▼                                       ▼
┌─────────────────────┐              ┌────────────────────────┐
│    Go Backend       │              │      External APIs     │
│  ┌───────────────┐  │              │    (Market Data)       │
│  │  Controllers  │  │              └────────────────────────┘
│  ├───────────────┤  │
│  │  Services     │  │
│  ├───────────────┤  │
│  │  Repositories │  │
│  ├───────────────┤  │
│  │  Auth / JWT   │  │
│  └───────┬───────┘  │
│          │          │
└──────────┼──────────┘
           │
           ▼
┌───────────────────────────┐
│       Databases           │
│  ┌─────────────────────┐  │
│  │     PostgreSQL      │  │
│  │ (Profiles & Trades) │  │
│  └─────────────────────┘  │
└───────────────────────────┘

---

🚀 Getting Started

Prerequisites

Requirement	Version
Node.js	≥ 18.x
Go	≥ 1.20
PostgreSQL	Latest

1. Clone the Repository

git clone https://github.com/Bharani6/Trading_Application.git
cd Trading_Application

2. Backend Setup

Navigate to the backend directory, install dependencies, and start the Go server:

cd backend
go mod tidy
go run cmd/server/main.go

3. Frontend Setup

In a new terminal window, navigate to the frontend directory, install dependencies, and start the development server:

cd frontend
npm install
npm run dev

---

📁 Project Structure

Trading_Application/
├── backend/                          # Go Backend (Modular Architecture)
│   ├── cmd/server/                   # Application entry point (main.go)
│   ├── internal/                     # Core Business Logic & Modules
│   │   ├── admin/                    # Admin panel controllers & services
│   │   ├── auth/                     # Authentication & JWT logic
│   │   ├── config/                   # Environment & app configurations
│   │   ├── database/                 # DB connection & ORM setup
│   │   ├── logger/                   # Custom logging utilities
│   │   ├── market/                   # External market data integration
│   │   ├── middleware/               # HTTP middlewares (auth, logging)
│   │   ├── profile/                  # User profile & KYC management
│   │   ├── response/                 # Standardized API responses
│   │   ├── routes/                   # API route definitions
│   │   ├── trade/                    # Trading execution logic
│   │   ├── user/                     # User management & models
│   │   ├── utils/                    # Shared backend utilities
│   │   ├── wallet/                   # Fund management & ledgers
│   │   └── watchlist/                # User stock watchlists
│   ├── go.mod                        # Go dependencies
│   └── go.sum
│
├── frontend/                         # Vue 3 Frontend (Component-Based)
│   ├── public/                       # Static assets
│   ├── src/                          # Vue source code
│   │   ├── api/                      # Axios clients & API wrappers
│   │   ├── assets/                   # Images, CSS, and styling
│   │   ├── components/               # Reusable Vue/Vuetify components
│   │   ├── constants/                # Global frontend constants
│   │   ├── layouts/                  # Page layouts (Navbar, Footer, Sidebar)
│   │   ├── router/                   # Vue Router definitions
│   │   ├── services/                 # Business logic & external calls
│   │   ├── store/                    # State management (Vuex/Pinia)
│   │   ├── utils/                    # Shared frontend utilities
│   │   ├── views/                    # Main page components
│   │   └── App.vue                   # Root component
│   ├── package.json                  # NPM dependencies
│   └── vite.config.js                # Build configuration
│
├── LICENSE                           # MIT License
└── README.md

---

📡 API Reference

Authentication

Method	Endpoint	Description
POST	/api/v1/auth/register	Register a new user
POST	/api/v1/auth/login	Authenticate & get JWT token
POST	/api/v1/auth/forgot-password	Generate password reset token
POST	/api/v1/auth/verify-reset-token	Verify password reset token
POST	/api/v1/auth/reset-password	Set new user password

User & Profile

Method	Endpoint	Description
GET	/api/v1/users/me	Get current user's profile
POST	/api/v1/users/kyc	Submit KYC details

Trading & Wallets

Method	Endpoint	Description
GET	/api/v1/wallet/balance	Get current user's wallet balance
POST	/api/v1/wallet/add-fund	Add funds to wallet
POST	/api/v1/wallet/withdraw	Withdraw funds from wallet
GET	/api/v1/wallet/transactions	Get wallet transaction history
GET	/api/v1/shares	Get available shares to trade
POST	/api/v1/trades/buy	Execute a buy order
POST	/api/v1/trades/sell	Execute a sell order
GET	/api/v1/trades/history	Get user's trade history
POST	/api/v1/trades/:id/cancel	Cancel an open trade

Watchlist

Method	Endpoint	Description
GET	/api/v1/watchlist	Get user's watchlist
POST	/api/v1/watchlist	Add a stock to watchlist
DELETE	/api/v1/watchlist/:id	Remove a stock from watchlist
PUT	/api/v1/watchlist/:id/favorite	Toggle favorite status

---

🤝 Contributing

Contributions are welcome! Here's how to get started:

1. Fork the repository
2. Create a feature branch: git checkout -b feature/amazing-feature
3. Commit your changes: git commit -m 'Add amazing feature'
4. Push to the branch: git push origin feature/amazing-feature
5. Open a Pull Request

---

⚠️ Disclaimer

This application is developed for educational and portfolio purposes only.

It does not provide real financial advice or execute real stock market transactions.

---

📄 License

This project is licensed under the MIT License — see the LICENSE file for details.

---

👨💻 Author

Bharanidharan R — @Bharani6

---

_{Built with ❤️ for modern trading.}