Vending Machine API

This API provides endpoints for a vending machine that is accessible to both buyers and sellers. The API includes endpoints for adding, updating, and removing products, as well as depositing coins and making purchases. Authentication and authorization are used to control access to the endpoints based on user role (buyer or seller), and caching is implemented to improve performance. The API requires authentication tokens for requests that require a specific role (buyer or seller), and uses a time-to-live (TTL) value to cache frequently-requested queries.

📗 Table of Contents

📖 About the Project
- 🛠 Built With
  - Tech Stack
  - Key Features
💻 Getting Started
📖 API Reference
- Swagger
- Postman
👥 Authors
🤝 Contributing
⭐️ Show your support
🔭 Up next
💎 Lesson Learned

Vending

🛠 Built With

Tech Stack

Server

Database

DevOps

Docs

Key Features

Uses authentication and authorization to control access based on user role.
Validates requests with Joi and supports CRUD operations for products, coins, purchases, and charges.
Allows admins to create machines at specific locations and add products.
Supports geolocation to find the nearest machine or product.
Implements caching for improved performance using Redis.

(back to top)

💻 Getting Started

To get a local copy up and running, follow these steps.

Prerequisites ❗

In order to run this project you need:

OR

Environment Variables 🔑

To run this project, you will need to add the following environment variables to your .env file

PORT : port where you application start on it

ACCESS_TOKEN_SECRET : string, access token secret (Example: JwtKey)

MONGODB_URI : string, mongo database uri ( Example: mongodb://127.0.0.1/vending).

REDIS_HOST : string, redis database host ( Example: localhost ).

REDIS_PORT : number, redis working port (Example: 6379)

SALT_WORK_FACTOR : number of rounds to create salt for hashing ( Example: 10 )

Setup ⬇️

Clone this repository to your desired folder:

cd my-folder
git clone https://github.com/ahmedeid6842/Vending.git

Install ✔️

Install this project with NPM:

npm install

Install this project with Docker-compose:

docker-compose build

Usage 🤿 🏃‍♂️

To run the project using NPM:

  npm start
  npm run dev #if your are a developer

To run the project using Docker-compose:

  docker compose up -d

After following the above steps you can now use Vending API

Import this JSON file into Postman, and you will be able to use all REST APIs.

If you don't know how to do it, watch this video.

Importing data to MongoDB

If you would like to import data to mongo collection you will

Go to you project your project folder path

cd ./your-folder

Run the following commands

mongoimport --db vending --collection users --file import/users.json
mongoimport --db vending --collection machines --file import/machines.json
mongoimport --db vending --collection products --file import/products.json