A comprehensive hotel booking application, designed to provide users with a seamless experience in finding and booking accommodations. StayFinder allows users to search, compare, and book hotels with ease, offering real-time availability, user reviews, and secure payments.
- User registration & login
- Token-based authentication
- Role-based access control
- Search and book hotels
- Filter by price, location, amenities, and ratings
- Real-time room availability and pricing
- Secure payment gateway integration
- User reviews and ratings
- Wishlist and favorites feature
- Responsive & mobile-friendly UI
- Manage users, bookings, and settings
- View reports and analytics
- 💬 Customer Support Chat System (For queries and assistance)
- 🔎 Advanced Search & Filters (Additional sorting options)
- 🛠️ Integration with External APIs (Google Maps, Weather, etc.)
- Python 3.x
- Django 4.x or higher
- Database (PostgreSQL/MySQL/SQLite)
- Virtual environment (recommended)
-
Clone the repository:
git clone https://github.com/madhvi-n/stayfinder.git cd stayfinder -
Set up a virtual environment:
python -m venv venv source venv/bin/activate # For macOS/Linux venv\Scripts\activate # For Windows
-
Install dependencies:
pip install -r requirements.txt
-
Apply database migrations:
python manage.py migrate
-
Create a superuser (if applicable):
python manage.py createsuperuser
-
Run the development server:
python manage.py runserver
Access the application at: http://127.0.0.1:8000
The API documentation is available via Swagger:
- Swagger UI:
http://127.0.0.1:8000/api/swagger/ - Redoc:
http://127.0.0.1:8000/api/redoc/
SECRET_KEY=django-secret-key
DEBUG=True
DATABASE_NAME=db-name
DATABASE_USER=db-user
DATABASE_PASSWORD=db-password
DATABASE_HOST=db-host
DATABASE_PORT=5432