Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mariarodr1136/microinvestmentplatform
Micro-Investment Education Platform is an innovative educational web application developed using React, Node.js with Express, and MongoDB, designed to introduce beginners to investing through simulated micro-investments. This platform provides a risk-free environment where users can practice investment strategies with virtual money. 💰
https://github.com/mariarodr1136/microinvestmentplatform
express finance-management investments micro-investing mongodb nodejs react stock-market virtual-currency virtual-trading
Last synced: 15 days ago
JSON representation
Micro-Investment Education Platform is an innovative educational web application developed using React, Node.js with Express, and MongoDB, designed to introduce beginners to investing through simulated micro-investments. This platform provides a risk-free environment where users can practice investment strategies with virtual money. 💰
- Host: GitHub
- URL: https://github.com/mariarodr1136/microinvestmentplatform
- Owner: mariarodr1136
- Created: 2024-10-27T21:00:24.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-10-28T01:02:10.000Z (2 months ago)
- Last Synced: 2024-10-28T04:12:48.753Z (2 months ago)
- Topics: express, finance-management, investments, micro-investing, mongodb, nodejs, react, stock-market, virtual-currency, virtual-trading
- Language: JavaScript
- Homepage:
- Size: 36.1 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Micro-Investment Education Platform
The Micro-Investment Education Platform is an innovative educational app crafted to empower beginners in the world of investing. By simulating micro-investments within a risk-free environment using virtual money, this platform allows users to explore various investment strategies and gain insights into market dynamics without the fear of losing real funds. The goal is to instill the knowledge and confidence necessary for users to navigate the complexities of investing, enabling them to understand market trends, evaluate risks, and appreciate the potential rewards of their investment decisions safely and engagingly. 📈
     
### Table of Contents
- [Features](#features)
- [Code Structure](#code-structure)
- [Installation](#installation)
- [Demo Recording](#demo-recording)
- [Requirements](#requirements)
- [API Interaction with Postman](#api-interaction-with-postman)
- [Contributing](#contributing)
- [Contact](#contact-)
---
### Features
- **Virtual Money Management**: Each user receives a set amount of virtual currency to simulate real-world investing.
- **Real-Time Market Data**: Users can access up-to-date stock prices and market conditions through integrated stock market APIs.
- **Latest Stock News**: The platform provides the latest stock news through a news API, keeping users informed about market trends and events.
- **Transaction History**: Users can view their transaction histories for buying and selling in a detailed table format, including price per share, date, and time.
- **Popular Stocks Section**: A dedicated section displays current popular stocks with clickable links to view their live prices.
- **Leaderboard & Gamification**: Track portfolio performance and foster healthy competition through a leaderboard showcasing top-performing users.
- **User-Friendly Interface**: A responsive and interactive UI built with React, providing a seamless user experience.
---
### Code Structure
The platform is built using the following technologies:
- **Frontend**: Developed with React for an engaging user interface.
- **Backend**: Node.js with Express for handling user authentication, data processing, and API integrations.
- **Database**: MongoDB stores user profiles, transaction history, and leaderboard data.
- **API**: Integrated with Alpha Vantage for real-time stock market data and a NEWS API for the latest news.
---
### Installation
1. **Clone the repository**:
```bash
gh repo clone mariarodr1136/MicroInvestmentPlatform
- Alternatively, if you prefer to use HTTPS:
```bash
https://github.com/mariarodr1136/MicroInvestmentPlatform.git
2. **Navigate to the backend directory**:
```bash
cd MicroInvestmentPlatform/backend
3. **Install backend dependencies**:
```bash
npm install
4. **Set up the database and configure environment variables**
5. **Start the backend server**:
```bash
node index.js
6. **In a new terminal, navigate to the frontend directory**:
```bash
cd MicroInvestmentPlatform/client
7. **Install frontend dependencies**:
```bash
npm install
8. **Start the frontend server**:
```bash
npm start
---
### Demo Recording
https://github.com/user-attachments/assets/47d8ec34-643b-4425-ae3c-0ce502bc33f8
---
### Requirements
- Node.js (v14 or later)
- MongoDB
- React (v17 or later)
- Stock market and NEWS API access key (e.g., Alpha Vantage)
---
### Fixing the URL in Your Frontend
Once you have a user ID, update your App.js to view data in frontend:
- const userId = '60d21b4667d0d8992e610c85'
---
## API Interaction with Postman
You can use Postman to interact with the API and perform various actions. Below are some common operations:
1. **Register a User**
- **Endpoint**: `/api/user/register`
- **HTTP Method**: `POST`
- **Description**: Adds a new `User` with username, email, and password.
- **Request Body**:
```json
{
"username": "string",
"email": "string",
"password": "string",
}
```
- **Response**: The created `User` object with balance, portfolio, and ID.
2. **Retrieve All Users**
- **Endpoint**: `api/user`
- **HTTP Method**: `GET`
- **Description**: Retrieves all registered `User` objects
- **Response**: All `User` objects with `id, username, balance`, and `stock portfolio`.
3. **Retrieve a User Portfolio by ID**
- **Endpoint**: `/api/user/{id}/portfolio`
- **HTTP Method**: `GET`
- **Description**: Fetches `User` portfolio by their ID.
- **Response**:
```json
{
"symbol": "stock string",
"shares": "integer",
"avgPrice": "integer",
"id": "integer"
}
```
4. **Create a Transaction**
- **Endpoint**: `/api/transactions/buy`
- **HTTP Method**: `POST`
- **Description**: Purchase Stock Option
- **Request Body**:
```json
{
"userId": "integer",
"symbol": "string - Stock symbol",
"shares": "integer - Number of shares to buy",
}
```
- **Response**: "Stock purchased successfully"
- **Endpoint**: `/api/transactions/sell`
- **HTTP Method**: `POST`
- **Description**: Sell Stock Option
- **Request Body**:
```json
{
"userId": "integer",
"symbol": "string - Stock symbol",
"shares": "integer - Number of shares to sell",
}
```
- **Response**:
```json
{
"message": "Stock sold successfully",
"balance": "integer",
"soldShares": "integer",
"revenue": "integer"
}
```
5. **Retrieve User Current Balance**
- **Endpoint**: `/api/user/{id}/balance`
- **HTTP Method**: `GET`
- **Description**: Retrieves `User` current balance
- **Response**:
```json
{
"balance": "integer"
}
```
---
### Contributing
Feel free to submit issues or pull requests for improvements or bug fixes. You can also open issues to discuss potential changes or enhancements. All contributions are welcome to enhance the app’s features or functionality!
To contribute, please follow these steps:
1. Fork the repository.
2. Create a new branch for your feature or bug fix:
```bash
git checkout -b feat/your-feature-name
- Alternatively, for bug fixes:
```bash
git checkout -b fix/your-bug-fix-name
3. Make your changes and run all tests before committing the changes and make sure all tests are passed.
4. After all tests are passed, commit your changes with descriptive messages:
```bash
git commit -m 'add your commit message'
5. Push your changes to your forked repository:
```bash
git push origin feat/your-feature-name.
6. Submit a pull request to the main repository, explaining your changes and providing any necessary details.
---
### Contact 🌐
If you have any questions or feedback, feel free to reach out at [[email protected]](mailto:[email protected]).