User Manager

This repository contains a simple demo API built with NodeJS using a Docker-compose setup. The API is used to manage users in a MongoDB database.

Development

This application was developed using ExpressJS. MongoDB was used for persisting data with Mongoose as ORM. Docker virtualization was used for easy deployment.

Installation

• Start up your terminal (or Command Prompt on Windows OS).
• Ensure that you've docker and docker-compose installed on your PC.https://www.google.com.ng/url?sa=t&rct=j&q=&esrc=s&source=web&cd=2&cad=rja&uact=8&ved=0ahUKEwiwpeftx6fYAhUDDsAKHZ7IBrQQFggpMAE&url=https%3A%2F%2Fdocs.docker.com%2Fcompose%2Finstall%2F&usg=AOvVaw1RNbJ6RAepxXdkmEJpMqVX
• Clone the repository by entering the command git clone https://github.com/akinduko/UserManager in the terminal.
• Navigate to the project folder using cd UserManager on your terminal (or command prompt)
• After cloning, run docker-compose up -d, as root or as a privileged user.

Testing

To ensure that your installation is successful you'll need to run tests. The command: npm test makes this possible. It isn't functional right now, but once it's done you'll be notified via the README.

API Documentation

The API only has one endpoint which is the /users endpoint for saving users to the database. The endpoint works with the HTTP verbs: POST, GET, PUT, DELETE.

POST HTTP Request

• POST /users
• INPUT:

name: John Doe
email: john.doe@gmail.com
password: johndoe

HTTP Response

• HTTP Status: 201: created
• JSON data

{
  "_id": "59071791b0lkscm2325794",
  "name": "John Doe",
  "email": "john.doe@gmail.com",
  "password": "johndoe",
  "__v": 0
}

GET HTTP Response

• GET /users

[
    {
        "_id": "59071791b0lkscm2325794",
        "name": "John Doe",
        "email": "john.doe@gmail.com",
        "password": "johndoe",
        "__v": 0
    }
]

GET HTTP Response

• GET /users/:id

{
    "_id": "59071791b0lkscm2325794",
    "name": "John Doe",
    "email": "john.doe@gmail.com",
    "password": "johndoe",
    "__v": 0
}

DELETE HTTP Response

• DELETE /users/:id

User John Doe was deleted

POST HTTP Request

• PUT /users/:id
• INPUT:

name: Jane Doe
email: jane.doe@gmail.com
password: janedoe

HTTP Response

• HTTP Status: 200: OK
• JSON data

{
  "_id": "59071791b0lkscm2325794",
  "name": "Jane Doe",
  "email": "jane.doe@gmail.com",
  "password": "janedoe",
  "__v": 0
}

Author

Olajide Bolaji 'Nuel - Software Developer at Andela

Updated by:

*** Akinduko Olugbenga Akinwumi. Devop Engineer at Qrios Networks