Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/preciousakams/hotel-room

SuiteUp is a simulation of a hotel room reservation system. It enables users to make room reservations. It also allows users to see all of their reservations in a list format, delete a room only if it is empty, and all visitors can see unreserved rooms.
https://github.com/preciousakams/hotel-room

rails ruby

Last synced: 9 days ago
JSON representation

SuiteUp is a simulation of a hotel room reservation system. It enables users to make room reservations. It also allows users to see all of their reservations in a list format, delete a room only if it is empty, and all visitors can see unreserved rooms.

Awesome Lists containing this project

README

        

## SuiteUp

> SuiteUp is a simulation of a hotel room reservation system.
It enables users to make room reservations.
It also allows users to see all of their reservations in a list format, delete a room only if it is empty, and all visitors can see unreserved rooms. You can check the source code for frontend [here](https://github.com/felixodette/hotel-room-frontend).

![Screen Shot 2022-10-12 at 3 25 17 PM](https://user-images.githubusercontent.com/25887253/195348197-e5130420-081e-409f-ae56-7b48d72e00c4.png)

## Backend Schema
![hotel_schema](https://user-images.githubusercontent.com/25887253/195716717-f4418b7c-9b82-4899-909a-11223c66b065.png)

## Live Demo
- [Front End](https://hotel-room-frontend.vercel.app/)
- [Back End API](https://afternoon-fjord-27064.herokuapp.com/)

## Built With

### Backend

- [x] Programming Language: [Ruby](https://www.ruby-lang.org/en/)
- [x] Framework: [Ruby on Rails](https://rubyonrails.org/)
- [x] Linter: [Rubocop](https://rubocop.org/)
- [x] Code Editor: [VS Code](https://code.visualstudio.com/)
- [x] Database: [PostgreSQL](https://www.postgresql.org/)
- [x] Testing Framework: [RSpec](https://rspec.info/)
- [x] API Documentation: [Swagger](https://swagger.io/)

### Frontend

- [x] Programming Language: [JavaScript](https://www.javascript.com/)
- [x] Framework: [React](https://reactjs.org/)
- [x] Library: [Redux](https://redux.js.org/)
- [x] Linter: [ESLint](https://eslint.org/)
- [x] Code Editor: [VS Code](https://code.visualstudio.com/)
- [x] Testing Framework: [Jest](https://jestjs.io/)

## Getting Started

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

### Install

In the terminal, go to your file directory and run this command.

```
$ git clone https://github.com/kamzzy/Hotel-Room.git
```

### Usage

Go to the app directory
```
$ cd Hotel-Room
```

Run the server
```
$ rails server
```

You can check the linter issues and fix them
```
$ rubocop -A
```

### Setup

Install Gems
```
$ bundle install
```

Create the database
```
$ rails db:create
```

Migrate database schema
```
$ rails db:migrate
```

Seed the database
```
$ rails db:seed
```

### Run tests

To install rspec, in the terminal kindly run this command

```
$ gem install rspec
```

To run tests, please run this command
```
$ rspec ./spec/#{filename}_spec.rb
```

### API Documentation

You can find the API documentation by

```
$ rails server
```

Then go to this link: [http://localhost:3000/api-docs/index.html](http://localhost:3000/api-docs/index.html)

### Prerequisites

- [x] A web browser like [Google Chrome](https://www.google.com/chrome/).
- [x] A code editor like [Visual Studio Code](https://code.visualstudio.com/).
- [x] A terminal to run the code.
- [x] [Ruby](https://www.ruby-lang.org/en/) installed on your computer.
- [x] [Rails](https://rubyonrails.org/) installed on your computer.

You can check if Git is installed by running the following command in the terminal.
```
$ git --version
```

Likewise for Ruby installation.
```
$ ruby --version && irb
```

To install rails, in the terminal kindly run this command
```
$ gem install rails
```
## Authors

👤 **Ahmad Zamir Yousufi**

- GitHub: [@ahzamir](https://github.com/ahzamir).
- Twitter: [@YousufiZamir](https://twitter.com/YousufiZamir)
- LinkedIn: [ahzamir](https://www.linkedin.com/in/ahzamir/)

👤 **Huseyin Biyik**

- GitHub: [@huseyinbiyik](https://github.com/huseyinbiyik).
- Twitter: [@huseyin__biyik](https://twitter.com/huseyin__biyik)
- LinkedIn: [Huseyin_biyik](http://www.linkedin.com/in/tahahuseyinbiyik/)

👤 **Precious Akams**

- GitHub: [@kamzzy](https://github.com/kamzzy).
- Twitter: [@precious_akams](https://twitter.com/precious_akams)
- LinkedIn: [Onyeagoziri_Akams](https://www.linkedin.com/in/Onyeagoziri_Akams/)

👤 **Felix Odete**

- GitHub: [@felixodette](https://github.com/felixodette).
- Twitter: [@Odette3000](https://twitter.com/Odette3000)
- LinkedIn: [Felix_Odete](https://www.linkedin.com/in/Felix_Odete/)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

Feel free to check the [issues page](https://github.com/kamzzy/Hotel-Room/issues).

## Show your support

Give a ⭐️ if you like this project!

## Acknowledgments

- [Microverse](https://www.microverse.org/)
- Code Reviewers
- Coding Partners

## 📝 License

This project is [MIT](./MIT.md) licensed.

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