Travel Itinerary Management System

A full-stack application for managing travel itineraries for Thailand destinations, featuring a FastAPI backend and Next.js frontend.

Project Structure

``` travel-itinerary-system/ ├── backend/ # Python FastAPI backend ├── frontend/ # Next.js frontend └── README.md # Project documentation ```

Backend Setup

The backend is built with FastAPI, SQLAlchemy, and SQLite.

Prerequisites

• Python 3.8+
• pip

Installation

1. Navigate to the backend directory: ```bash cd backend ```

2. Create a virtual environment: ```bash python -m venv venv ```

3. Activate the virtual environment:

   • Windows: venv\Scripts\activate
   • macOS/Linux: source venv/bin/activate

4. Install dependencies: ```bash pip install fastapi uvicorn sqlalchemy pydantic ```

Running the Backend

1. Run the application using the run script: ```bash python run.py ```

This will:

• Seed the database with sample data
• Start the main API server on http://localhost:8000
• Start the recommendation server on http://localhost:8001

The API documentation will be available at http://localhost:8000/docs

Frontend Setup

The frontend is built with Next.js, React, and Tailwind CSS.

Prerequisites

• Node.js 16+
• npm or yarn

Installation

1. Navigate to the frontend directory: ```bash cd frontend ```

2. Install dependencies: ```bash npm install

   or

   yarn install ```

Running the Frontend

1. Start the development server: ```bash npm run dev

   or

   yarn dev ```

2. Open your browser and navigate to http://localhost:3000

Using the Application

1. Browse Itineraries: View all available travel itineraries on the Itineraries page
2. View Details: Click on an itinerary to see its detailed information
3. Get Recommendations: Use the Recommendations page to get itineraries based on your preferred duration
4. Create Itinerary: Create your own custom itinerary using the multi-step form

API Endpoints

• GET /api/itineraries - Get all itineraries
• GET /api/itineraries/{id} - Get a specific itinerary
• POST /api/itineraries - Create a new itinerary
• GET /api/recommendations/{nights} - Get recommended itineraries for a specific duration

Database Schema

The application uses the following database models:

• Itinerary
• Accommodation
• Transfer
• Activity

See the Schema page in the frontend for detailed information.