📗 Table of Contents

• 📖 About the Project

  • Built With
    • Tech Stack
    • Key Features
    • Website Mockup 📱 💻 🖥️
    • 🖺 Entity Relationship Diagram
  • Kanban Board
  • React Frontend
  • API Documentation
  • 🚀 Live Demo

• 💻 Getting Started

  • Setup
  • Prerequisites
  • Install
  • Usage
  • Run tests
  • Deployment

• 👥 Authors

• 🔭 Future Features

• 🤝 Contributing

• ⭐️ Show your support

• 🙏 Acknowledgements

• ❓ FAQ

• 📝 License

📖 EL Dorado Backend

El Dorado Backend is a luxary car rental application where the user can register new accounts, login and reserve a set of different cars. It is built and connected by using two different repos, including Back-end(Rails) and Front-end(React/Redux).

🛠 Built With

Tech Stack

Client

• React.js

Server

• Rails

Database

• PostgreSQL

Key Features

• [Luxary Cars List endpoint]
• [Devise authentication to access Reservations]
• [JWT Authorization upon login and register]
• [Authenticated Users can add/mark as removed a Car]
• [Authenticated Users can reserve/remove a Car]

(back to top)

Website Mockup 📱 💻 🖥️

(back to top)

Kanban Board

• We are a group of 4 people, so we used 2 Kanban Board to divide the work and keep track of the progress.

Frontend Kanban Board

• Frontend Kanban Board p-1
• Frontend Kanban Board p-2

Backend Kanban Board

• Backend Kanban Board p-1
• Backend Kanban Board p-2

(back to top)

API Documentation

• Here is the API documentation of the project El Dorado API-Docs

(back to top)

📇 Entity Relationship Diagram

React Frontend

• Here is the Frontend part of the project El Dorado Frontend

🚀 Live Demo

• Live Demo 🚀 😃

(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: Git and Ruby

 gem install rails

Install

Install this project with:

  bundle install

• Generate a secret key using rails secret
• Create a .env file with the following content:

POSTGRES_USER=postgres
# If you declared a password when creating the database:
POSTGRES_PASSWORD=YourPassword
POSTGRES_HOST=localhost
POSTGRES_DB=Hello_Rails_Backend_development
POSTGRES_TEST_DB=Hello_Rails_Backend_test
# Devise secret key
DEVISE_JWT_SECRET_KEY=Secret Key you generated

Create Database (Mandatory)

rails db:create

If you have made a migration then run this command

rails db:migrate

rails db:seed

Usage

To run the project, execute the following command:

   rails s -p 3001 # # for serving the API on localhost:3001

Run tests

bundle exec rspec

(back to top)

👥 Authors (4 Micronauts)

👤 Aamir Khan

• GitHub: @aamirkhan2478
• Twitter: @SmartKhan2478
• LinkedIn: Aamir Khan

👤 Abel Gebeyehu

• GitHub: @AbelG101
• LinkedIn: Abel Gebeyehu

👤 Michael Mesfin

• GitHub: @michael-duke
• Twitter: @MikeDuke21
• LinkedIn: MICHAEL MESFIN

👤 Milen Alebel

• GitHub: @milen-ale
• Twitter: @milenalebel2
• LinkedIn: Milen Alebel

(back to top)

🔭 Future Features

• [Admin Roles and access to add New lux Cars]
• [Keep count of cars using addtional attribute]

(back to top)

🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the issues page.

(back to top)

⭐️ Show your support

Give a ⭐️ if you like this project!

(back to top)

🙏 Acknowledgments

I would like to thank:

• Microverse
• Code Reviewers

(back to top)

❓ FAQ

• How I can install rails?

  • You can follow the official guide to install rails. If you have gem installed, you can run gem install rails to install rails.

• How I can run this project?

  • After cloning repository, run bundle and then run rails s with option argument -p 3001. This will run the server on localhost:3001. You can change the port number if you want. Then you can use any API client to test the endpoints. For example, you can use Postman or Insomnia. You can also use the API Documentation to test the endpoints.

• How I can run tests?

  • After cloning repository, run bundle and then run rspec to run the tests.

(back to top)

📝 License

This project is MIT licensed.

(back to top)