The Wild Oasis

Abstract

1. Introduction

The Wild Oasis is an internal hotel management system built with nextjs13, prisma, MongoDB, typescript, tailwind CSS, and many other technologies. It allows employees to manage everything about hotel bookings, cabins, and guests.

2. Objective

An internal hotel management system allows employees to manage everything about hotel bookings, cabins, and guests.

This project demonstrates how TypeScript, MongoDB, React can be applied to a real-world Full Stack Web Development problem.

3. Key Features / Modules

• User Authentication and Signup:
• Hotel employees can log in to the application to perform tasks.
• New users can only be signed up within the application to ensure that only actual hotel employees can create accounts.
• User Profile Management:
• Users can upload an avatar to personalize their profile.
• Users can change their name and password.
• Cabin Management:
• The app provides a table view with all cabins.
• The table view displays cabin information, including cabin photo, name, capacity, price, and current discount.
• Users can update or delete existing cabins.

4. Technology Stack

5. System Requirements

General requirements for this technology stack — check the README for exact versions.

• Node.js (LTS) and npm / yarn / pnpm
• VS Code or any code editor
• Git (to clone the repository)

6. Installation & Setup

git clone https://github.com/sudeepmahato16/the-wild-oasis.git
cd the-wild-oasis

1. Clone the repository:
2. Navigate to the project directory:
3. Install the dependencies:
4. Set up the environment variables:
5. Create a .env file in the root directory.
6. Add the following variables to the .env file, replacing the placeholder values with your own:
7. Seed the database
8. Start the development server:

git clone https://github.com/sudeepmahato16/the-wild-oasis.git

cd the-wild-oasis

npm install

DATABASE_URL=<your-mongodb-uri>
  NEXTAUTH_SECRET=<your-nextauth-secret>
  NEXT_PUBLIC_CLOUDINARY_KEY=<your-cloudinary-cloud-name>

Full setup instructions are in the project README.

7. Future Enhancements

Suggested extensions you can add to make this your own project.

• Add role-based access control
• Deploy on a VPS or cPanel hosting with a custom domain
• Add automated tests and a CI pipeline

8. Viva / Review Questions

Common questions examiners ask for projects in this domain.

1. Explain the frontend, backend and database layers of this application.
2. How is user authentication and authorisation implemented?
3. Describe the main database tables / collections and their relationships.
4. Which REST APIs or routes are exposed and what do they return?
5. How would you deploy this application to production?

9. Source Code & License

This project is developed by sudeepmahato16 and published on GitHub under the MIT License. Please follow the license terms and credit the original author when you use or modify this code.