https://github.com/codetoby/vs-game-js
A virtual stock trading application that simulates stock market investments. The project includes a frontend for portfolio visualization, a backend for business logic, and a Discord bot for easy interaction. Users can view their portfolios, buy and sell stocks, and track portfolio performance over time. Authentication is handled via Discord OAuth2.
https://github.com/codetoby/vs-game-js
express-js reactjs stock-market
Last synced: 11 months ago
JSON representation
A virtual stock trading application that simulates stock market investments. The project includes a frontend for portfolio visualization, a backend for business logic, and a Discord bot for easy interaction. Users can view their portfolios, buy and sell stocks, and track portfolio performance over time. Authentication is handled via Discord OAuth2.
- Host: GitHub
- URL: https://github.com/codetoby/vs-game-js
- Owner: codetoby
- Created: 2024-07-16T20:42:53.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2024-07-22T16:55:43.000Z (over 1 year ago)
- Last Synced: 2025-02-17T14:45:15.324Z (about 1 year ago)
- Topics: express-js, reactjs, stock-market
- Language: JavaScript
- Homepage:
- Size: 530 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Virtual Stock Game
## Overview
The Virtual Stock Game is an application that allows users to simulate stock trading within a controlled environment. The project comprises three main components: the Frontend, Backend, and a Discord Bot. The frontend displays the user's portfolio, including a table of each stock they own and a graph showing the portfolio's development. The Discord Bot provides commands for users to interact with their portfolios. The backend handles all the business logic, including transactions and portfolio management, and uses Discord OAuth2 for authentication.
## Components
### 1. Frontend
The frontend component is responsible for displaying the user's portfolio. It includes:
- **Portfolio Table**: A table listing each stock the user owns, including details such as the ticker, current price, number of shares, and more.
- **Portfolio Graph**: A graph showing the historical performance and development of the user's portfolio over time.
### 2. Discord Bot
The Discord Bot allows users to manage their portfolios directly from Discord. It includes the following commands:
- **buy**: Allows the user to purchase shares of a stock.
- **Usage**: `$buy [ticker] [number of shares]`
- **Example**: `$buy AAPL 10` will buy 10 shares of Apple Inc.
- **sell**: Allows the user to sell shares of a stock they own.
- **Usage**: `$sell [ticker] [number of shares]`
- **Example**: `$sell AAPL 5` will sell 5 shares of Apple Inc.
- **createPortfolio**: Initializes a new portfolio for the user.
- **Usage**: `$createPortfolio`
- **Example**: `$createPortfolio` will create a new portfolio for the user.
- **portfolio**: Displays the current state of the user's portfolio.
- **Usage**: `$portfolio`
- **Example**: `$portfolio` will show the user their current portfolio, including all owned stocks and their values.
### 3. Backend
The backend component is the core of the application, handling all the business logic, such as:
- Managing user accounts and authentication via Discord OAuth2.
- Handling transactions (buying and selling of stocks).
- Managing portfolio data and calculations.
- Interfacing with external stock market APIs to fetch real-time stock data.
## Authentication
The application uses Discord OAuth2 for user authentication. This ensures that users can securely log in using their Discord accounts and interact with their portfolios either through the frontend or the Discord bot.
## Setup and Installation
### Prerequisites
- Docker: Ensure you have Docker installed on your machine. You can download Docker from [here](https://www.docker.com/get-started).
- Docker Compose: Docker Compose is a tool for defining and running multi-container Docker applications. You can install it following the instructions [here](https://docs.docker.com/compose/install/).
- Discord account and a registered Discord bot: You need a Discord account and a registered bot to interact with the Discord API. You can register a bot on the [Discord Developer Portal](https://discord.com/developers/applications).
### Clone the Repository
```bash
git clone https://github.com/codetoby/VS-Game-Js
cd vs-game-js
```
### Set Up Environment Variables
#### Backend
Create a `.env` file in the `server` directory and copy the contents of the `.env.example` file.
#### Frontend
Modify the config.json file in the `client/src` directory to the backend URL.
#### Discord Bot
Create a `.env` file in the `discordbot` directory and copy the contents of the `.env.example` file.
### Build and Run the Application
```bash
docker-compose up
```
This command will build and run the frontend, backend, and Discord bot components of the application. You can access the frontend at `http://localhost:3000`.