Skip to content

tafesoftware/finalyear-project-2025

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Ethiopia Tourism Website

A dynamic tourism website for Ethiopia connecting travelers, hotels, tour guides, and restaurants.

🌍 Project Overview

This platform serves as a comprehensive tourism hub for Ethiopia, providing:

  • Travelers: Destination information, booking services, and travel guides
  • Hotels: Property listings, booking management, and guest services
  • Tour Guides: Profile management, tour packages, and client connections
  • Restaurants: Menu listings, reservations, and culinary experiences

🚀 Features

For Travelers

  • Browse destinations and attractions
  • Book hotels and tours
  • Find local restaurants
  • Read travel guides and reviews
  • Interactive maps and itineraries

For Hotels

  • Property management dashboard
  • Room availability and booking system
  • Guest communication tools
  • Analytics and reporting

For Tour Guides

  • Profile and service management
  • Tour package creation
  • Client booking system
  • Calendar and scheduling tools

For Restaurants

  • Menu management
  • Reservation system
  • Customer reviews and ratings
  • Special offers and promotions

🛠️ Tech Stack

Frontend

  • HTML5, CSS3, JavaScript (ES6+)
  • Responsive design with mobile-first approach
  • Interactive maps and galleries
  • Form validation and user experience optimization

Backend

  • Node.js with Express.js
  • RESTful API architecture
  • JWT authentication
  • File upload and image processing
  • Email notifications

Database

  • MongoDB for flexible data storage
  • Mongoose ODM for data modeling

📁 Project Structure

ethiopia-tourism-website/
├── client/                 # Frontend application
│   ├── assets/
│   │   ├── css/
│   │   ├── js/
│   │   ├── images/
│   │   └── fonts/
│   ├── pages/
│   ├── components/
│   └── index.html
├── server/                 # Backend application
│   ├── config/
│   ├── controllers/
│   ├── middleware/
│   ├── models/
│   ├── routes/
│   ├── uploads/
│   └── server.js
├── docs/                   # Documentation
└── README.md

🚀 Getting Started

Prerequisites

  • Node.js (v14 or higher)
  • MongoDB
  • Git

Installation

  1. Clone the repository
git clone <repository-url>
cd ethiopia-tourism-website
  1. Install server dependencies
cd server
npm install
  1. Install client dependencies (if using build tools)
cd ../client
npm install
  1. Set up environment variables
# In server directory, create .env file
cp .env.example .env
# Edit .env with your configuration
  1. Start the development servers
# Start backend server
cd server
npm run dev

# Start frontend (in new terminal)
cd client
npm start

🌟 Key Destinations Featured

  • Addis Ababa: Capital city with rich history
  • Lalibela: Rock-hewn churches
  • Gondar: Royal castles and palaces
  • Axum: Ancient obelisks and ruins
  • Simien Mountains: Trekking and wildlife
  • Danakil Depression: Unique landscapes
  • Lake Tana: Monasteries and boat tours
  • Harar: Walled city and hyena feeding

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

📄 License

This project is licensed under the MIT License.

📞 Contact

For support or inquiries, please contact the development team.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published