Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/usmansbk/rooms-backend

Room booking app
https://github.com/usmansbk/rooms-backend

postgresql rails rest-api

Last synced: about 1 month ago
JSON representation

Room booking app

Awesome Lists containing this project

README

        

# Final group capstone - Room reservation Backend

![Microverse](https://img.shields.io/badge/Microverse-blueviolet)

> Room reservation app

![screenshot](./erd.png)

This project is based on an app to book an appointment to try a motorcycle. It has been customized to allow you to book a room or try hosting people with yours.

## Project

- [Kanban board](https://github.com/usmansbk/rooms-backend/projects/1)

- [GitHub](https://github.com/usmansbk/rooms-backend/tree/main)

- Final number of team members: 4

![Screenshot 2021-11-29 at 17-38-52 Final Capstone Project ยท usmansbk rooms-backend](https://user-images.githubusercontent.com/10219539/143907673-0d2f2af8-08e0-4952-8c50-72d43f99639f.png)

## Frontend

[GitHub Repo](https://github.com/usmansbk/rooms-frontend)

[Live Link](https://microverse-rooms.netlify.app/)

## API

[Heroku](https://polar-island-18380.herokuapp.com)

## Built With

- Ruby on Rails
- PostgreSQL

## Getting Started

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

### Prerequisites

- [Ruby v3.0.2](https://www.ruby-lang.org/en/)
- [Rails v6.1.4](https://gorails.com/)
- [RSwag](https://github.com/rswag/rswag)

## Setup

```sh
git clone https://github.com/usmansbk/rooms-backend.git

cd ./rooms-backend
```

### Install

```sh
bundle install
```

### Database

```sh
# Create user
sudo -u postgres createuser rooms_backend -s

# Create the database
rails db:create

## Apply migration
rails db:migrate
```

### Run

```sh
rails s
```

### Test

```sh
rspec
```

### Generate documentation

```sh
rails rswag
```

### API Documentation

[Swagger](http://localhost:3000)

### Troubleshoot

```sh
### Undo migrations
rake db:migrate VERSION=0
```

## Authors

๐Ÿ‘ค **Usman**

- GitHub: [@usmansbk](https://github.com/usmansbk)
- LinkedIn: [Usman Suleiman Babakolo](https://linkedin.com/in/usmansbk)

๐Ÿ‘ค **Simon**

- GitHub: [@SimonGrchevski](https://github.com/SimonGrchevski)
- LinkedIn: [Simon Grchevski](https://www.linkedin.com/in/simon-grchevski-682935209/)

๐Ÿ‘ค **Olawale**

- GitHub: [@olawale-o](https://github.com/olawale-o)
- LinkedIn: [Omoogun Olawale](https://linkedin.com/in/olawaleomoogun)

๐Ÿ‘ค **Denis**

- GitHub: [@denisdiaconu](https://github.com/denisdiaconu)
- LinkedIn: [Denis Andrei Diaconu](https://www.linkedin.com/in/denis-diaconu-1394091b7/)

## ๐Ÿค Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](../../issues/).

## Show your support

Give a โญ๏ธ if you like this project!

## Acknowledgments

- Microverse
- Original design by [Murat Korkmaz](https://www.behance.net/muratk) on Behance

## License

[MIT](./LICENSE)