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

https://github.com/billymohajeri/final-group-capstone-backend

Cottage Booking is an app that helps users find cottages and reserve them. The app allows users to add new cottages, remove cottages, make reservations. Built with Ruby on Rails, React, Redux, and PostgreSQL.
https://github.com/billymohajeri/final-group-capstone-backend

postgresql ruby-on-rails

Last synced: 4 months ago
JSON representation

Cottage Booking is an app that helps users find cottages and reserve them. The app allows users to add new cottages, remove cottages, make reservations. Built with Ruby on Rails, React, Redux, and PostgreSQL.

Awesome Lists containing this project

README

          

# 📗 Table of Contents

- [📖 About the Project](#about-project)
- [🛠 Built With](#built-with)
- [Tech Stack](#tech-stack)
- [Key Features](#key-features)
- [🚀 Live Demo](#live-demo)
- [💻 Getting Started](#getting-started)
- [Setup](#setup)
- [Prerequisites](#prerequisites)
- [Create database](#create-database)
- [👥 Authors](#authors)
- [📊 Kanban Board ](#kanban)
- [🔭 Future Features](#future-features)
- [🤝 Contributing](#contributing)
- [⭐️ Show your support](#support)
- [🙏 Acknowledgements](#acknowledgements)
- [📝 License](#license)

# 📖 Cottage booking app

**Cottage booking app** is a booking app that allows users to search a list of available cottages and make reservations. This is the backend repository.

Frontend repo is [here](https://github.com/billymohajeri/Final-Group-Capstone-Frontend)

After launching a local server, this link provides access to API documentation: http://localhost:3000/api-docs/index.html

## 🛠 Built With

### Tech Stack

Client

Bundle

Server

Database

### Key Features

- **Create new user**
- **Create new cottage**
- **Delete cottage**
- **Add reservation**
- **Display my reservations list**

(back to top)

## 🚀 Live Demo

[Live Demo](https://final-group-capstone-frontend-git-deploy-billymohajeri.vercel.app/)

(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:

- [Ruby on Rails](https://rubyonrails.org/) installed and running. To get more information, read the [installation guide](https://guides.rubyonrails.org/).

- [PostgreSQL](https://www.postgresql.org/) installed and running.

### Setup

Clone this repository to your desired folder:

Clone the back-end repo
```
git clone git@github.com:billymohajeri/Final-Group-Capstone-Backend.git
```

Clone the front-end repo
```
git clone git@github.com:billymohajeri/Final-Group-Capstone-Frontend.git
```

### Install

Install the backend project with:

```cd Final-Group-Capstone-Backend```

```bundle install``` to install all gems used.

```rails db:create``` to create the database.

```rails db:migrate``` to run the database migrations you created.

```rails db:seed``` to add a new uer to the database.

`rails s` to run the dev server.

Go to http://localhost:3000/api-docs/index.html to see API documentation.

Install the frontend project with:

```cd Final-Group-Capstone-Backend```

```npm install``` to install the app.

```npm start``` ro run the app.

(back to top)

## 👥 Authors

👤 **Billy Mohajeri**

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

👤 **Gaurav Gangwar**

- GitHub: [@gauravgangwarweb](https://github.com/gauravgangwarweb)
- Twitter: [@gauravgangwar501](https://twitter.com/gauravgangwar501)
- LinkedIn: [Gaurav Gangwar](https://www.linkedin.com/in/gauravgangwarweb/)

👤 **Botlhale Setou**
- GitHub: [@Botlhale-Setou](https://github.com/Botlhale-Setou)
- Twitter: [@Botlhale_Setou](https://twitter.com/BotlhaleSetou)
- LinkedIn: [@botlhalesetou](https://www.linkedin.com/in/botlhalesetou/)

(back to top)

## 📊 Kanban Board

- Link to Kanban Board: [Kanban](https://github.com/users/billymohajeri/projects/6/views/1)
- Initial state of Kanban board: [Kanban Image](https://user-images.githubusercontent.com/58295348/237707763-a4569c96-d090-4692-92d4-93f411c10427.png)
- We are a group of 3 persons.

(back to top)

## 🔭 Future Features

- [ ] **Improve the application UI**
- [ ] **Add comment button**
- [ ] **Improve authentication system**
- [ ] **Authorization**

(back to top)

## 🤝 Contributing

Contributions, issues, and feature requests are welcome!

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

(back to top)

## ⭐️ Show your support

If you like this project, please consider giving it a star.

(back to top)

## 🙏 Acknowledgments

- I would like to thank all code reviewers for making this project better.

- Original design idea by [Murat Korkmaz on Behance](https://www.behance.net/gallery/26425031/Vespa-Responsive-Redesign).

📸 Photos:
- [Houses Cottages](https://stocksnap.io/photo/houses-cottages-7KUECPAQ80) at Free Stock Image by 👤 Arno Smit
- [Wishbone Cottage, Malvern Hills](https://www.countryliving.com/uk/travel-ideas/staycation-uk/g25857853/cottages-rent-uk/?slide=9) at Unique Home Stays by 👤 Mark Watts

(back to top)

## 📝 License

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

(back to top)