Skip to content

Advanced-computer-lab-2024/Explora

BranchesTags

Repository files navigation

Explora

Explora is a travel booking site which allows the user to find and book hotel, transportation and activities and buy products.

Motivation

Our motivation was to create an all in one website for all the user's needs, starting from booking the hotels and transportation all the way to buying products, we also wanted to make it as easy as it can be and to give the user the opportunity to give feedback on every experience they had starting from the activities to the products.

Build Status

The build is stable besides the following points :

  • The payment is accepted when you book with stripe as soon as you get redirected to the page before you add any payment details.
  • The change password using otp method doesn't work as expected.
  • The admin/seller fails to filter sails report.

Code Style

Key Style Rules:

  • Indentation: Use 4 spaces for indentation.
  • Semicolons: Always include semicolons at the end of statements.

Quotes:

  • Use double quotes (") for imports.
  • Use single quotes (') for other strings.

Naming Conventions:

  • Use camelCase for variables and functions (e.g., deleteAdminAccount).
  • Use PascalCase for classes (e.g., User, Admin).

Spacing:

  • Include spaces around operators and after keywords (e.g., if, try, catch).
  • Separate functions with a blank line for clarity.

Error Handling:

  • Wrap all asynchronous code in try...catch blocks to manage errors effectively.

Screenshots

PHOTO-2024-12-09-07-09-32 4 PHOTO-2024-12-09-07-09-33 2 PHOTO-2024-12-09-07-09-34 2 PHOTO-2024-12-09-07-09-29 PHOTO-2024-12-09-07-09-36 3 PHOTO-2024-12-09-07-09-34 3 PHOTO-2024-12-09-07-09-30 4 PHOTO-2024-12-09-07-09-36 2 PHOTO-2024-12-09-07-09-36 PHOTO-2024-12-09-07-09-31 2 PHOTO-2024-12-09-07-09-31 PHOTO-2024-12-09-07-09-35 4 PHOTO-2024-12-09-07-09-35 PHOTO-2024-12-09-07-09-35 2 PHOTO-2024-12-09-07-09-32 3 PHOTO-2024-12-09-07-09-33 3 PHOTO-2024-12-09-07-09-35 5 PHOTO-2024-12-09-07-09-31 3 PHOTO-2024-12-09-07-09-34 4 PHOTO-2024-12-09-07-09-33 PHOTO-2024-12-09-07-09-32 PHOTO-2024-12-09-07-09-35 3 PHOTO-2024-12-09-07-09-34 PHOTO-2024-12-09-07-09-32 2 PHOTO-2024-12-09-07-09-30 3 PHOTO-2024-12-09-07-09-30 2 PHOTO-2024-12-09-07-09-30

Tech/Framework used

This project is built using modern JavaScript technologies and frameworks to ensure scalability, maintainability, and performance. Below is an overview of the key technologies and frameworks used:

Backend:

  • Node.js: A JavaScript runtime environment for server-side development.
  • Express.js: A lightweight framework for building RESTful APIs and handling HTTP requests and responses. Database:
  • MongoDB: A NoSQL database used to store user and administrative data.
  • Mongoose: An Object Data Modeling (ODM) library for MongoDB, providing schema-based data modeling and query-building functionality. Authentication & Security:
  • bcrypt: For hashing and verifying user passwords securely.
  • jsonwebtoken: For generating and validating JSON Web Tokens (JWT) for authentication. Other Dependencies:
  • dotenv: For managing environment variables securely (if used).
  • ESLint: For maintaining consistent code style (optional, recommended).

To understand this project, familiarity with the following concepts/technologies is recommended:

JavaScript (ES6+ syntax) RESTful API design MongoDB database structure Node.js modules and package management (npm) Authentication techniques (e.g., JWT, password hashing)

Features

Authentication and Account Management

  1. Login:
    • All users can log in using a username and password.
    • Password recovery using OTP sent via email.

Notifications

  1. System Notifications:
    • Receive notifications for flagged events or itineraries (on system and via email).
    • Notify users of upcoming bookings and events.
    • Notify users when a product is out of stock (Admins/Sellers).
    • Tourists receive birthday promo codes.
  2. Reminder Notifications:
    • Reminders for upcoming events booked (on system and via email).
    • Notifications for interest in events when booking starts.

Reports and Insights

  1. Sales Reports:
    • Admin can view reports for revenue from events, itineraries, and gift shop sales.
    • Sellers can view revenue reports.
    • Tour Guides and Advertisers can view revenue reports.
    • Filters available for activity, itinerary, product, date, or month.
  2. User Reports:
    • Admin can view the total number of users and new users per month.
    • Tour Guides and Advertisers can view reports on the number of tourists using their itineraries or attending their activities.
    • Filter user reports by month.

Payment and Wallet

  1. Payment Options:
    • Pay for events or itineraries online via Stripe (credit/debit card) or wallet.
    • Cash-on-delivery option for product purchases.
  2. Refunds and Wallet Updates:
    • Refunds for canceled events or orders are reflected in the user’s wallet.
    • View updated wallet balances after payment or refunds.
  3. Receipts and Transactions:
    • Email receipts sent for all payments.
    • View order and payment history.

Event and Activity Management

  1. Event Interaction:
    • Bookmark events for later.
    • View saved events.
    • Request notifications for event bookings.
  2. Activity Guides:
    • View a step-by-step guide for starting a vacation.
    • Demo features to help users navigate the system.

Product Management

  1. Wishlist and Cart:
    • Save products to a wishlist.
    • View and manage wishlist items (add to cart, remove).
    • Add, remove, or modify items in the cart.
  2. Order Management:
    • Checkout with payment options.
    • Add and manage delivery addresses.
    • Cancel orders and view refunded amounts in the wallet.
    • View order details, status, and history.

Promotions and Discounts

  1. Promo Codes:
    • Admins can create promo codes.
    • Tourists receive birthday promo codes usable across the site.
    • Apply promo codes during checkout.

Administrative Features

  1. Admin Notifications:
    • Receive alerts for flagged content.
    • Notify sellers and users of flagged content.
  2. Revenue Management:
    • Admin revenue includes a 10% application rate on online bookings.
  3. Content Management:
    • Admin can monitor flagged events, itineraries, and products.

Additional Features

  1. System Demo:
    • Demo guides to help new users understand the system features.

Code Examples

Example 1

router.post('/bookWallet', async (req, res) => {
  const { touristId, searchId, flightId, promoCode } = req.body;

  try {
    // Find the tourist user
    const tourist = await User.findById(touristId);
    if (!tourist || tourist.role !== 'Tourist') {
      return res.status(400).json({ message: 'Invalid tourist user' });
    }

    const touristEmail = tourist.email; // Get the tourist's email dynamically

    // Check if the flight is in the cache using the searchId and flightId
    const cachedFlights = flightCache[searchId];  // Get flights based on searchId

    if (!cachedFlights) {
      return res.status(404).json({ message: 'No flights found for this searchId' });
    }

    const selectedFlight = cachedFlights.find(flight => flight.id === flightId);

    if (!selectedFlight) {
      return res.status(404).json({ message: 'Flight not found in this search results' });
    }

    // Check if the user has already booked the selected flight
    const existingBooking = await FlightTicket.findOne({
      tourist: touristId,
      flightNumber: ${selectedFlight.itineraries[0].segments[0].departure.iataCode}${selectedFlight.itineraries[0].segments[0].arrival.iataCode}${flightId}
    });

    if (existingBooking) {
      return res.status(400).json({ message: 'You have already booked this flight' });
    }

    // Check if the user has enough wallet balance
    if (!tourist.wallet || tourist.wallet < selectedFlight.price.total) {
      return res.status(400).json({ message: 'You do not have enough credits in your wallet to book this flight' });
    }

    // Initialize price to full price
    let discountedPrice = selectedFlight.price.total;

    // Check if promo code exists and is valid
    if (promoCode) {
      const promoCodeRecord = await TouristPromoCode.findOne({ tourist: touristId, code: promoCode });

      if (!promoCodeRecord) {
        return res.status(400).json({ message: 'Invalid or expired promo code' });
      }

      // Apply the promo code discount
      const discountAmount = promoCodeRecord.discount * discountedPrice;
      discountedPrice = selectedFlight.price.total - discountAmount;

      // Ensure discounted price is valid
      if (discountedPrice < 0) {
        return res.status(400).json({ message: 'Discounted price is invalid' });
      }

      // Deduct the discounted price from the tourist's wallet
      tourist.wallet -= discountedPrice;
      await tourist.save(); // Save the updated tourist

      // Delete the promo code since it's used
      await TouristPromoCode.deleteOne({ tourist: touristId, code: promoCode });
    } else {
      // If no promo code, deduct full price
      tourist.wallet -= selectedFlight.price.total;
      await tourist.save(); // Save the updated tourist
    }

    // Extract flight details
    const flightSegment = selectedFlight.itineraries[0].segments[0];
    const origin = flightSegment.departure.iataCode;
    const destination = flightSegment.arrival.iataCode;
    const date = flightSegment.departure.at;
    const flightNumber = ${origin}${destination}${flightId};  // Generate flight number from origin, destination, and flightId
    const time = flightSegment.departure.at;  // Assuming this is the departure time
    const duration = selectedFlight.itineraries[0].duration;  // Duration from itineraries
    const arrivalTime = flightSegment.arrival.at;  // Arrival time

    // Create a new flight booking using the discounted price
    const flightTicket = new FlightTicket({
      tourist: touristId,
      origin,
      destination,
      date,
      flightNumber,
      time,
      duration,
      arrivalTime,
      price: discountedPrice  // Use discounted price here
    });

    // Save the booking
    const savedFlightTicket = await flightTicket.save();

    // Send a payment receipt email to the tourist's email
    const mailOptions = {
      from: '[email protected]', // Sender address
      to: touristEmail,            // Dynamic email based on the tourist's record
      subject: 'Flight Booking Receipt',
      text: Dear ${tourist.username},\n\nYour flight has been successfully booked!\n\nDetails:\n- Flight Number: ${flightNumber}\n- Origin: ${origin}\n- Destination: ${destination}\n- Date: ${date}\n- Time: ${time}\n- Duration: ${duration}\n- Price: ${discountedPrice} USD\n\nThank you for booking with us!\n\nBest regards,\nExplora
    };
    transporter.sendMail(mailOptions, (error, info) => {
      if (error) {
        console.error('Error sending email:', error);
      } else {
        console.log('Email sent:', info.response);
      }
    });

    // Respond with the booking confirmation, including discounted price
    res.status(201).json({
      message: 'Flight booked successfully',
      bookingDetails: savedFlightTicket,
      discountedPrice: discountedPrice
    });

  } catch (err) {
    console.error(err);
    res.status(500).json({ message: 'Error booking flight', error: err.message });
  }
});

This code snippet is part of a flight booking system, where a tourist user can book a flight from available search results using a wallet balance and potentially apply a promo code for a discount. Here’s a breakdown of the main functionality:

  • Input Validation: It starts by validating the input, checking if the tourist exists and has the right role (Tourist). It checks if the flightId exists in the cached flight results (based on searchId).
  • Booking Logic: If the selected flight is not already booked by the tourist, it proceeds. Then, it checks if the tourist has enough credits in their wallet to pay for the flight. If a promo code is provided, it validates the promo code, applies the discount, and ensures that the discounted price is valid. If no promo code is applied, the tourist is charged the full price.
  • Booking Creation: A new FlightTicket document is created with flight details and the final price (discounted or full price). The tourist’s wallet is updated, deducting the flight cost.
  • Email Notification: A booking receipt is sent to the tourist’s email with flight details and payment confirmation.
  • Error Handling: The code includes error handling for invalid users, flights, or promo codes and catches any errors during the process to return a proper message. Simplified Explanation: This API route allows a tourist to book a flight by:

Verifying if they exist and can afford the flight. Checking for a valid promo code to apply a discount. Confirming that the flight isn’t already booked. Deducting the final cost from the tourist’s wallet and saving the booking. Sending a booking confirmation email. What to highlight in the "Code Snippets" section: Tourist validation: Ensuring the user is a tourist and exists in the database. Promo code application: Handling discount logic if a valid promo code is used. Booking creation: Creating a booking entry and updating the tourist's wallet. Email notification: Sending a confirmation email after successful booking. This snippet illustrates how to process a flight booking, validate user inputs, apply discounts, and ensure the tourist has enough funds before confirming the booking.

Example 2

//http://localhost:4000/api/tour_guide_itinerary/upcoming
router.get('/upcoming', async (req, res) => {
  try {
    // Get today's date and remove the time component for accurate comparisons
    const today = new Date();
    today.setHours(0, 0, 0, 0);

    // Query the database for itineraries with availableDates equal to or later than today
    const upcomingItineraries = await Itinerary.find({
      availableDates: { $gte: today }
    });

    // If no itineraries are found
    if (upcomingItineraries.length === 0) {
      return res.status(404).json({ message: 'No upcoming itineraries found.' });
    }

    // Return the list of upcoming itineraries
    res.status(200).json(upcomingItineraries);
  } catch (error) {
    console.error(error);
    res.status(500).json({ message: 'Server error', error: error.message });
  }
});

Here’s how you can write a Code Snippet for this route that retrieves upcoming itineraries:

Code Snippet: Get Upcoming Itineraries
javascript
Copy code
// Route to get all upcoming itineraries that are available to be booked
router.get('/upcoming', async (req, res) => {
  try {
    // Get today's date and set the time to midnight for comparison
    const today = new Date();
    today.setHours(0, 0, 0, 0);  // Remove time part for accurate date comparison

    // Query the database for itineraries with availableDates greater than or equal to today
    const upcomingItineraries = await Itinerary.find({
      availableDates: { $gte: today }  // Only itineraries with future available dates
    });

    // If no itineraries are found, return a 404 error
    if (upcomingItineraries.length === 0) {
      return res.status(404).json({ message: 'No upcoming itineraries found.' });
    }

    // Return the list of upcoming itineraries
    res.status(200).json(upcomingItineraries);
  } catch (error) {
    console.error(error);
    res.status(500).json({ message: 'Server error', error: error.message });
  }
});

What This Code Does:

  • Sets the current date: It ensures the comparison is done without the time part (just the date).

  • Fetches itineraries: Queries the database for itineraries where availableDates are greater than or equal to today.

  • Handles no results: Returns a 404 error if no itineraries are found for booking.

  • Sends the results: If itineraries are found, it sends them back in the response.

  • Brief Explanation: This API endpoint is used to fetch all itineraries that are available to be booked starting from today. It does so by comparing the availableDates of each itinerary with the current date. If no itineraries are found, it returns a 404 response; otherwise, it returns the list of available itineraries.

  • Usage: This code can be used in the part of your application where users can see upcoming tours or trips available for booking, making sure only future itineraries are listed.

Installation

  • VS Code - Download the version for your OS
  • Node - Download the version for your OS
  • Nodemon - Search for the package
  • Express - Search for the package
  • Mongoose - Search for the package
  • React - Search for the package
  • Git - Search for the package
  • Axios - Search for the package

After installing, run the following terminal command:

npm install
cd backend
node Server.js
cd reactjs-creatingbuttons
npm run dev

Click the link that pops up after you run those two, it should look something like this: http://localhost:5173/ rns the sum.

API reference

Click the above link to see all our API references.

Tests

This project includes various tests to ensure functionality, reliability, and security. Below is an overview of the tests you can perform, along with code examples:

Types of Tests

  • Unit Tests: Verify individual functions and components (e.g., password hashing, user creation).

  • Integration Tests: Test interactions between different modules (e.g., API endpoints and database).

  • End-to-End (E2E) Tests: Simulate real-world user interactions with the API.

Testing Frameworks

  • Postman: A JavaScript testing framework used for unit and integration tests.
  • React: For testing HTTP endpoints.

Here are a few tests:

{
  "username": "sis",       
  "email": "[email protected]",          
  "password": "sis",       
  "name": "sasa",           
  "mobile": "010052525",         
  "yearsOfExperience": 5, 
  "previousWork": "non",   
  "termsAccepted": "true", 
  "image": "file"             
}
  • Expected Response:
{
    "username": "sis",
    "password": "$2b$10$yJ.ODT7r3PwDPvtqXX/O8OCDOvX1Zo.Wb7CDzxdV8ognlQlOugKRu",
    "loyaltyPoints": 0,
    "loyaltyLevel": 0,
    "role": "TourGuide",
    "_id": "6754b5cf0ee2b9fdc6014dd6",
    "email": "[email protected]",
    "tourists": [],
    "name": "sasa",
    "mobile": "010052525",
    "yearsOfExperience": 5,
    "previousWork": "non",
    "isAccepted": true,
    "termsAccepted": true,
    "rating": 0,
    "status": "Pending",
    "createdAt": "2024-12-07T20:53:35.862Z",
    "updatedAt": "2024-12-07T20:53:35.862Z",
    "__v": 0
}
  "id": "string"

Body Parameters: None Expected Response:

{
  "loyaltyPoints": 0,
  "loyaltyLevel": 0,
  "_id": "6748fae835a3fa0479d4a088",
  "username": "mimi",
  "password": "$2b$10$/.0EcrIBO9ZF4IPDQaSF7eFoEeF2sL7IQcMFtSdjRa/Mhi2H07HYy",
  "role": "TourGuide",
  "email": "[email protected]",
  "tourists": [],
  "previousWork": "",
  "isAccepted": true,
  "termsAccepted": false,
  "rating": 0,
  "idFile": "uploads\\1732836072168.png",
  "certificatesFile": "uploads\\1732836072181.png",
  "imageFile": "uploads\\1732836072188.png",
  "status": "Accepted",
  "createdAt": "2024-11-28T23:21:12.555Z",
  "updatedAt": "2024-12-01T23:52:05.955Z",
  "__v": 0
}
{
  "email": "[email protected]",
  "newPassword": "new_password",
  "name": "New Name",
  "mobile": "0123456789",
  "yearsOfExperience": 5,
  "previousWork": "New Work Details",
  "isAccepted": true
}
  • Expected Response:
{
  "_id": "6748fae835a3fa0479d4a088",
  "username": "mimi",
  "email": "[email protected]",
  "password": "$2b$10$hashed_password_string",
  "name": "New Name",
  "mobile": "0123456789",
  "yearsOfExperience": 5,
  "previousWork": "New Work Details",
  "isAccepted": true,
  "profilePicture": "uploads/path_to_new_picture.png",
  "loyaltyPoints": 0,
  "loyaltyLevel": 0,
  "role": "TourGuide",
  "tourists": [],
  "rating": 0,
  "status": "Accepted",
  "createdAt": "2024-11-28T23:21:12.555Z",
  "updatedAt": "2024-12-01T23:52:05.955Z",
  "__v": 0
}
{
  "tourGuideName": "John Doe",
  "tourGuideId": "6748fae835a3fa0479d4a088",
  "activities": [
    {
      "duration": 120,
      "date": "2024-07-01",
      "time": "10:00"
    },
    {
      "duration": 90,
      "date": "2024-07-02",
      "time": "14:00"
    }
  ],
  "locations": "Cairo, Giza Pyramids, Egyptian Museum",
  "timeline": "2-day cultural tour covering major attractions",
  "duration": 2,
  "language": "English",
  "price": 150,
  "availableDates": ["2024-07-01", "2024-07-02"],
  "availableTimes": ["10:00", "14:00"],
  "accessibility": true,
  "pickupLocation": "Cairo Airport",
  "dropoffLocation": "Giza Pyramids",
  "hasBookings": false,
  "tags": ["cultural", "history", "adventure"]
}

Expected Response:

{
    "tourGuideName": "John Doe",
    "tourGuideId": "6748fae835a3fa0479d4a088",
    "activities": [
        {
            "duration": 120,
            "date": "2024-07-01T00:00:00.000Z",
            "time": "10:00",
            "_id": "6754b7c1420909de67705296"
        },
        {
            "duration": 90,
            "date": "2024-07-02T00:00:00.000Z",
            "time": "14:00",
            "_id": "6754b7c1420909de67705297"
        }
    ],
    "locations": "Cairo, Giza Pyramids, Egyptian Museum",
    "timeline": "2-day cultural tour covering major attractions",
    "duration": 2,
    "language": "English",
    "price": 150,
    "availableDates": [
        "2024-07-01T00:00:00.000Z",
        "2024-07-02T00:00:00.000Z"
    ],
    "availableTimes": [
        "10:00",
        "14:00"
    ],
    "accessibility": true,
    "pickupLocation": "Cairo Airport",
    "dropoffLocation": "Giza Pyramids",
    "hasBookings": false,
    "isActive": true,
    "tags": [
        "cultural",
        "history",
        "adventure"
    ],
    "rating": 0,
    "isDeleted": false,
    "flagged": false,
    "_id": "6754b7c1420909de67705295",
    "__v": 0
}
    "tourGuideId": "6748fae835a3fa0479d4a088"

Expected Response:

[ 
    {
        "_id": "6749a7a40d9e637f9c7cc0b8",
        "tourGuideName": "Mimi",
        "tourGuideId": "6748fae835a3fa0479d4a088",
        "activities": [
            {
                "duration": 10,
                "date": "2024-11-30T00:00:00.000Z",
                "time": "13:40",
                "_id": "6749a7a40d9e637f9c7cc0b9"
            }
        ],
        "locations": "Germany",
        "timeline": "Morning ",
        "duration": 5,
        "language": "English",
        "price": 500,
        "availableDates": [
            "2024-12-05T00:00:00.000Z"
        ],
        "availableTimes": [
            "13:35"
        ],
        "accessibility": false,
        "pickupLocation": "Cairo",
        "dropoffLocation": "Berlin",
        "hasBookings": true,
        "isActive": true,
        "tags": [],
        "rating": 0,
        "isDeleted": false,
        "flagged": false,
        "__v": 0
    }
]
    "_id": "6754bb26420909de67705299"
  • Request Body:
{
  "tourGuideName": "John Doe",
  "activities": [
    {
      "duration": 180,
      "date": "2024-08-01T00:00:00.000Z",
      "time": "11:00"
    }
  ],
  "locations": "Luxor, Karnak Temple",
  "timeline": "3-day ancient sites tour",
  "duration": 3,
  "language": "French",
  "price": 300,
  "availableDates": ["2024-08-01T00:00:00.000Z"],
  "availableTimes": ["11:00"],
  "accessibility": true,
  "pickupLocation": "Luxor Airport",
  "dropoffLocation": "Karnak Temple",
  "hasBookings": false,
  "tags": ["ancient", "cultural"]
}
  • Expected Response:
{
    "_id": "6754bb26420909de67705299",
    "tourGuideName": "John Doe",
    "tourGuideId": "6748fae835a3fa0479d4a088",
    "activities": [
        {
            "duration": 180,
            "date": "2024-08-01T00:00:00.000Z",
            "time": "11:00",
            "_id": "6754c2c100cbdf40181f909b"
        }
    ],
    "locations": "Luxor, Karnak Temple",
    "timeline": "3-day ancient sites tour",
    "duration": 3,
    "language": "French",
    "price": 300,
    "availableDates": [
        "2024-08-01T00:00:00.000Z"
    ],
    "availableTimes": [
        "11:00"
    ],
    "accessibility": true,
    "pickupLocation": "Luxor Airport",
    "dropoffLocation": "Karnak Temple",
    "hasBookings": false,
    "isActive": true,
    "tags": [
        "ancient",
        "cultural"
    ],
    "rating": 0,
    "isDeleted": false,
    "flagged": false,
    "__v": 1
}
    id : "6754bb26420909de67705299"

Expected Response:

{
  "msg": "Itinerary removed successfully"
}
    id: "6754bb26420909de67705299"

Expected Response:

{
    "_id": "6754bb26420909de67705299",
    "tourGuideName": "John Doe",
    "tourGuideId": "6748fae835a3fa0479d4a088",
    "activities": [
        {
            "duration": 180,
            "date": "2024-08-01T00:00:00.000Z",
            "time": "11:00",
            "_id": "6754c2c100cbdf40181f909b"
        }
    ],
    "locations": "Luxor, Karnak Temple",
    "timeline": "3-day ancient sites tour",
    "duration": 3,
    "language": "French",
    "price": 300,
    "availableDates": [
        "2024-08-01T00:00:00.000Z"
    ],
    "availableTimes": [
        "11:00"
    ],
    "accessibility": true,
    "pickupLocation": "Luxor Airport",
    "dropoffLocation": "Karnak Temple",
    "hasBookings": false,
    "isActive": true,
    "tags": [
        "ancient",
        "cultural"
    ],
    "rating": 0,
    "isDeleted": false,
    "flagged": false,
    "__v": 1
}
{
  "username": "john_doe",
  "email": "[email protected]",
  "reason": "No longer needed"
}

Expected Response:

{
  "message": "Deletion request submitted"
}
id: "6749a7a40d9e637f9c7cc0b8"

Expected Response:

{
  "message": "Itinerary deactivated successfully."
}
    id: "6748fae835a3fa0479d4a088"

Expected Response:

{
  "msg": "Terms accepted successfully"
}
{
    "touristId": "674d0772a54a6ecc374e2f35",
    "tourGuideId": "674cfa7ea54a6ecc374e2ea9",
    "rating": 5,
    "comment": "very good" 
}

Expected Response:

{
    "msg": "Review added successfully",
    "review": {
        "tourGuide": "674cfa7ea54a6ecc374e2ea9",
        "tourist": "674d0772a54a6ecc374e2f35",
        "rating": 5,
        "comment": "very good",
        "_id": "6754e71ff92fc61705823126",
        "date": "2024-12-08T00:23:59.226Z"
    }
}
{
"touristId": "674d0772a54a6ecc374e2f35",
"itineraryId": "6754bb26420909de67705299",
"rating": 5,
"comment": "very good" 
}

Expected Response:

{
    "msg": "Rating and comment added successfully",
    "itinerary": {
        "_id": "6754bb26420909de67705299",
        "tourGuideName": "John Doe",
        "tourGuideId": "6748fae835a3fa0479d4a088",
        "activities": [
            {
                "duration": 180,
                "date": "2024-08-01T00:00:00.000Z",
                "time": "11:00",
                "_id": "6754c2c100cbdf40181f909b"
            }
        ],
        "locations": "Luxor, Karnak Temple",
        "timeline": "3-day ancient sites tour",
        "duration": 3,
        "language": "French",
        "price": 300,
        "availableDates": [
            "2024-08-01T00:00:00.000Z"
        ],
        "availableTimes": [
            "11:00"
        ],
        "accessibility": true,
        "pickupLocation": "Luxor Airport",
        "dropoffLocation": "Karnak Temple",
        "hasBookings": false,
        "isActive": true,
        "tags": [
            "ancient",
            "cultural"
        ],
        "rating": 5,
        "isDeleted": false,
        "flagged": false,
        "__v": 1,
        "comment": "very good"
    }
}
{
        "_id": "67324673bd5e0b9fdcdba05c",
        "tourGuideName": "John Doe",
        "activities": [
            {
                "duration": 120,
                "date": "2024-11-15T10:00:00.000Z",
                "time": "10:00 AM",
                "_id": "67324673bd5e0b9fdcdba05d"
            }
        ],
        "locations": "Paris, France",
        "timeline": "Full Day Tour",
        "duration": 1,
        "language": "English",
        "price": 150,
        "availableDates": [
            "2024-11-15T00:00:00.000Z",
            "2024-11-16T00:00:00.000Z"
        ],
        "availableTimes": [
            "10:00 AM",
            "2:00 PM"
        ],
        "accessibility": true,
        "pickupLocation": "Paris Hotel",
        "dropoffLocation": "Eiffel Tower",
        "hasBookings": false,
        "isActive": true,
        "tags": [
            "tour",
            "adventure",
            "paris"
        ],
        "rating": 0,
        "isDeleted": false,
        "flagged": true,
        "__v": 0
    }
{
        "_id": "6754bb26420909de67705299",
        "tourGuideName": "John Doe",
        "tourGuideId": "6748fae835a3fa0479d4a088",
        "activities": [
            {
                "duration": 180,
                "date": "2024-08-01T00:00:00.000Z",
                "time": "11:00",
                "_id": "6754c2c100cbdf40181f909b"
            }
        ],
        "locations": "Luxor, Karnak Temple",
        "timeline": "3-day ancient sites tour",
        "duration": 3,
        "language": "French",
        "price": 300,
        "availableDates": [
            "2024-08-01T00:00:00.000Z"
        ],
        "availableTimes": [
            "11:00"
        ],
        "accessibility": true,
        "pickupLocation": "Luxor Airport",
        "dropoffLocation": "Karnak Temple",
        "hasBookings": false,
        "isActive": true,
        "tags": [
            "ancient",
            "cultural"
        ],
        "rating": 5,
        "isDeleted": false,
        "flagged": false,
        "__v": 1,
        "comment": "very good"
    }
{
        "_id": "6752f084f3d7174904885e23",
        "tourGuideName": "EZZ",
        "tourGuideId": "6751e64314a67da81e2b08e9",
        "activities": [],
        "locations": "Egypt",
        "timeline": "December",
        "duration": 2,
        "language": "Egypt",
        "price": 499,
        "availableDates": [
            "2024-12-31T00:00:00.000Z"
        ],
        "availableTimes": [
            "14:22"
        ],
        "accessibility": false,
        "pickupLocation": "Airport",
        "dropoffLocation": "Egypt",
        "hasBookings": true,
        "isActive": true,
        "tags": [],
        "rating": 0,
        "isDeleted": false,
        "flagged": true,
        "__v": 0
    }
userId: "674d0772a54a6ecc374e2f35"

Expected Response:

{
    "loyaltyPoints": 250019312.5
}
{
  "username": "user_username",
  "password": "user_password"
}

Expected Response:

{
  "token": "jwt_token_here",
  "role": "user_role",
  "userId": "user_id"
}
    tourGuideId: 674cfa7ea54a6ecc374e2ea9
  • Expected Response:
{
    "message": "Sales records retrieved successfully",
    "sales": [
        {
            "_id": "674dc4eb4526b9cae9d05cb8",
            "tourGuideId": "674cfa7ea54a6ecc374e2ea9",
            "itineraryId": {
                "_id": "674cfaefa54a6ecc374e2eb4",
                "locations": "India",
                "price": 150,
                "availableDates": [
                    "2025-03-01T00:00:00.000Z"
                ]
            },
            "touristId": {
                "_id": "674d0772a54a6ecc374e2f35",
                "username": "didi",
                "email": "didi@gmail"
            },
            "amount": 150,
            "date": "2024-12-02T14:32:11.458Z",
            "__v": 0
        },
    ]
}
tourGuideId: 674cfa7ea54a6ecc374e2ea9
  • Expected Response:
{
    "message": "Tourists who booked the itinerary",
    "touristDetails": [
        {
            "touristName": "didi",
            "itineraryLocations": "India",
            "itineraryDate": [
                "2025-03-01T00:00:00.000Z"
            ]
        },
    ] 
}
id: 67324673bd5e0b9fdcdba05c
  • Expected Response:
{
  "message": "Itinerary flagged successfully"
}

Notification:

{
  "userId": "tourGuideId",
  "message": "Your itinerary 'Itinerary Title' has been flagged.",
  "itineraryId": "itineraryId"
}

Email:

Subject: Itinerary has been Flagged

Dear Tour Guide Name,

Your itinerary titled "Itinerary Title" has been flagged.
Please review it.

Sincerely,
Explora Team }

  "userId": "string"
  • Expected Response:
[
  {
    "_id": "notification_id",
    "userId": "user_id",
    "message": "Notification message",
    "createdAt": "2024-06-08T12:00:00Z"
  }
]
  "id": "string" // Notification ID
  • Expected Response:
{
  "message": "Notification marked as read.",
  "notification": {
    "_id": "664ff3b4cde92f0012a7ab3c",
    "userId": "664a6b21cde92f0012a7a001",
    "message": "Your itinerary has been flagged.",
    "read": true,
    "createdAt": "2024-06-01T08:00:00.000Z",
    "updatedAt": "2024-06-01T09:00:00.000Z"
  }
}

How to Use

A Guide for Tourists, Tour Guides, Advertisers, Sellers, Tourism Governors, and Admins
Welcome to Explora! Follow these simple steps to make the most out of your travel experience:

For Tourists

  1. Sign Up
  • Create a new account as a tourist to access personalized features.
  1. Profile Management
  • Update and View Profile: Easily edit and view your profile information.
  • Change Password: Securely update your account password whenever needed.
  • Account Deletion: Request account deletion if you no longer wish to use our services.
  1. Bookings
  • Book Tickets: Effortlessly book flights, transportation, hotels, itineraries, and activities.
  • View My Bookings: o Access details of your upcoming and previous bookings for itineraries, activities, flights, transportation, and hotels.
  1. Complaints Management
  • Issue Complaints: Submit any concerns or issues you face.
  • Track Complaints: View and manage all previously issued complaints.
  1. Bookmarks and Wishlist’s
  • Bookmark Itineraries and Activities: Save itineraries and activities that interest you for easy access.
  • Wishlist Products: Add products to your Wishlist and view your Wishlist items.
  • View Purchased Products: Keep track of all products you have purchased.
  1. Notifications
  • Stay updated with real-time notifications about itineraries or activities you are interested in, including reminders for upcoming releases.
  1. Explore and Discover
  • Discover exciting destinations, activities, and itineraries tailored to your preferences.
  • Browse Products: Explore our wide range of travel products and offerings to suit your travel needs.
  1. Cart and Checkout
  • Add to Cart: Select and add products to your cart for purchase.
  • Checkout: Proceed to checkout to complete your purchases.
  • Payment Options: Choose your preferred payment method — via wallet or VISA.
  1. Notifications and Updates
  • Receive timely updates about new products, bookings, and special offers.

For Tour Guides

  1. Sign Up
  • Create a new account as a tour guide to offer itineraries and services.
  1. Profile Management
  • Update and View Profile: Easily edit and view your profile information.
  • Change Password: Securely update your account password whenever needed.
  • Account Deletion: Request account deletion if you no longer wish to use our services.
  1. Itinerary Management
  • Create Itinerary: Create new itineraries for tourists to book.
  • Manage Itineraries: Edit, update, delete and manage your itineraries and bookings.
  1. View Statistics
  • Access statistics on tourist ratings, preferences, and feedback regarding your itineraries.
  1. Notifications
  • Receive real-time notifications when: o One of your itineraries gets flagged for review.

For Advertisers

  1. Sign Up
  • Create a new account as an advertiser.
  1. Profile Management
  • Update and View Profile: Easily edit and view your profile information.
  • Change Password: Securely update your account password whenever needed.
  • Account Deletion: Request account deletion if you no longer wish to use our services.
  1. Activity Management
  • Create Activity: Create new activities for tourists to book.
  • Manage Activities: Edit, update, delete and manage your activities and bookings.
  1. View Statistics
  • Access statistics on tourist ratings, preferences, and feedback regarding your activities.
  1. Notifications
  • Receive real-time notifications when: o One of your activities gets flagged for review.

For Sellers

  1. Sign Up
  • Create a new account as a seller.
  1. Profile Management
  • Update and View Profile: Easily edit and view your profile information.
  • Change Password: Securely update your account password whenever needed.
  • Account Deletion: Request account deletion if you no longer wish to use our services.
  1. Product Management
  • Add Products: Add new products for tourists to purchase.
  • Manage Products: Edit, update, delete and manage your products and orders.
  • View Revenue: View revenue generated from your products.
  1. Notifications
  • Receive real-time notifications when: o One of your products is out of stock.

For Admins

  1. User Management
  • Manage Users: Oversee users, roles, and permissions.
  1. Dashboard and Analytics
  • View Dashboard: Access detailed analytics and statistics on platform usage.
  1. Content Management
  • Manage Content: Oversee and manage products, activities, and itineraries.
  • Resolve Complaints: Handle and resolve user complaints and issues.
  • Create Promos: Generate promotional codes for users.
  1. View Revenue
  • Access insights on revenue generated across the platform.
  1. Add Tourism Governors
  • Add and manage tourism governors within the system.

For Tourism Governors

  1. Add Places
  • Add new tourist attractions and historical locations.
  1. Manage Places
  • Edit, update, and manage tourist attractions and historical sites.

Start Exploring with Explora Embark on your next adventure with Explora – whether you're a tourist, tour guide, advertiser, seller, admin, or tourism governor, we make travel planning seamless and enjoyable!

Contribute

Want to contribute? Great!

Send us a email at [email protected]

Credits

License

License

License

License

License

License

License

License

License License: MIT

About

No description, website, or topics provided.

Resources

Readme
Activity
Custom properties

Stars

0 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 11

Languages