# sagarkalyankar/tour-and-travel-packages architecture

> Architecture diagram of the GitHub repository sagarkalyankar/tour-and-travel-packages, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-07-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sagarkalyankar/tour-and-travel-packages
- Repository: https://github.com/sagarkalyankar/tour-and-travel-packages

## Overview

##### Project Type and Purpose
- This is a full-stack “Tour and Travel Packages” application.
- Backend: Django project (`Tour_Agency1/Tour_Agency` + `Yatraapp` app) exposing REST endpoints, server-side templates, ORM models, admin interfaces, and static assets.
- Frontend: Angular single-page application under `tour_agency/`, consuming the backend’s APIs and serving client-side views for users and admins.
- Purpose: Allow end users to browse, book, and pay for tour packages; provide an admin dashboard to manage packages, bookings, and messages.

##### Main Components
a. Client Tier
- Angular SPA (`tour_agency/src/app/*` components & services)
- Browser running HTML/CSS/TS served from a web server or CDN (`index.html`, `styles.css`)
b. API Tier
- Django REST framework serializers and viewsets in `Yatraapp/serializers.py` & `views.py`
- URL routing via `Tour_Agency/urls.py`
- Authentication (login, register) and permission checks in `Yatraapp/forms.py` & DRF auth
c. Business Logic Tier
- Django ORM models (`Yatraapp/models.py`) for TourPackage, Booking, PaymentStatus, UserProfile, ContactMessage, etc.
- Services and forms for validations and workflows (`forms.py`)
d. Data Tier
- Relational database (PostgreSQL/MySQL/SQLite) storing migrations defined in `migrations/`
e. Admin Interfaces
- Django Admin (`Yatraapp/admin.py`) for admin-side CRUD
- Angular Admin components (`src/app/admin/*`) for a richer admin UI
f. Static & Media
- CSS, images under `Yatraapp/static/` and Angular’s `public/` folder
g. External Integrations
- Payment gateway (e.g., Stripe/PayPal) called from Angular or via Django views
- Email/SMS service for booking confirmations
h. Deployment & Infra
- Gunicorn/Uvicorn (WSGI/ASGI: `wsgi.py`, `asgi.py`) behind Nginx or Apache
- CI/CD pipelines (if applicable), containerization (Docker), hosting (AWS/GCP/Azure)

##### Relationships and Data Flow
- User’s browser → (HTTP/HTTPS) → Angular SPA
- Angular services (`auth.service.ts`, `admin.service.ts`) → (REST API calls) → Django endpoints
- Django endpoints → ORM → Database → ORM → Django → JSON → Angular
- Booking flow: Angular “BookPackageComponent” → POST `/api/bookings/` → Django view → create Booking & Payment record → return status → Angular “PaymentComponent”
- Admin flow: Angular “AdminDashboardComponent” → GET `/api/packages/` & `/api/bookings/` → Django Admin APIs
- Static assets served by web server; media files (user uploads) possibly via S3 or local storage

##### Architectural Patterns & Principles
- Client-Server separation (SPA + REST)
- MVC on backend (Django’s Models, Views, Templates)
- Component-based UI on frontend (Angular modules & services)
- Layered architecture: Presentation (Angular, Django templates), Business logic (Django views/forms), Data access (Django ORM)
- DRY and Single Responsibility for each Angular component and Django app

## Diagram (Mermaid)

```mermaid
graph TB
    %% Presentation Layer
    subgraph "Presentation Layer"
        Browser["Browser (User/ Admin)"]:::frontend
        IndexHTML["index.html"]:::frontend
        StylesCSS["styles.css"]:::frontend

        Browser -->|loads| IndexHTML
        Browser -->|loads| StylesCSS
        IndexHTML -->|bootstraps| AngularSPA
    end

    subgraph "Angular SPA" 
        style AngularSPA fill:#E8F6FF,stroke:#036,stroke-width:1px
        AngularSPA["Angular SPA"]:::frontend
        Home["HomeComponent"]:::frontend
        Packages["PackagesComponent"]:::frontend
        ViewPackage["ViewPackageComponent"]:::frontend
        BookingHistory["BookingHistoryComponent"]:::frontend
        UserProfile["UserProfileComponent"]:::frontend
        FAQ["FAQComponent"]:::frontend
        ContactUs["ContactUsComponent"]:::frontend

        Login["LoginComponent"]:::frontend
        Register["RegisterComponent"]:::frontend
        AuthService["AuthService"]:::frontend

        BookPackage["BookPackageComponent"]:::frontend
        Payment["PaymentComponent"]:::frontend

        AdminLogin["AdminLoginComponent"]:::admin
        AdminDashboard["AdminDashboardComponent"]:::admin
        Messages["MessagesComponent"]:::admin
        AdminService["AdminService"]:::admin

        AngularSPA --> Home
        AngularSPA --> Packages
        AngularSPA --> ViewPackage
        AngularSPA --> BookingHistory
        AngularSPA --> UserProfile
        AngularSPA --> FAQ
        AngularSPA --> ContactUs

        AngularSPA --> Login
        AngularSPA --> Register
        AngularSPA --> AuthService

        AngularSPA --> BookPackage
        AngularSPA --> Payment

        AngularSPA --> AdminLogin
        AngularSPA --> AdminDashboard
        AngularSPA --> Messages
        AngularSPA --> AdminService

        Home -->|uses| AuthService
        Packages -->|fetch| AuthService
        BookingHistory -->|fetch| AuthService
        BookPackage -->|POST /api/bookings| AuthService
        Payment -->|handles payment| AuthService
        AdminDashboard -->|GET /api/packages| AdminService
        Messages -->|GET /api/messages| AdminService
    end

    %% API Tier and Business Logic Layer
    subgraph "Django Backend" 
        style DjangoBackend fill:#FFE8E8,stroke:#630,stroke-width:1px
        Settings["settings.py"]:::backend
        URLs["urls.py"]:::backend
        ASGI["asgi.py"]:::backend
        WSGI["wsgi.py"]:::backend
        Manage["manage.py"]:::backend

        Models["models.py"]:::backend
        Serializers["serializers.py"]:::backend
        Views["views.py"]:::backend
        Forms["forms.py"]:::backend
        DjangoAdmin["admin.py"]:::backend
        Templates["templates/*.html"]:::backend
        StaticCSS["static/css/style.css"]:::backend
        StaticImages["static/images/"]:::backend
        Tests["tests.py"]:::backend

        AngularSPA -->|REST API calls| URLs
        URLs --> Views
        Views --> Serializers
        Views --> Forms
        Views --> Models
        Serializers --> Models
        Forms --> Models
        Models --> Migrations
        DjangoAdmin --> Models
        Views --> Templates
        Settings --> URLs
        ASGI --> Settings
        WSGI --> Settings
        Manage --> Settings

    end

    %% Data Layer
    subgraph "Data Layer"
        DB["Relational Database"]:::database
        Migrations["migrations/"]:::database
        Tests --> Migrations
        Models --> DB
        Migrations --> DB
    end

    %% External Services
    PaymentService["Payment Gateway"]:::external
    EmailService["Email/SMS Service"]:::external

    Payment -->|process payment| PaymentService
    Views -->|send confirmation| EmailService

    %% Click Events
    click AngularSPA "https://github.com/sagarkalyankar/tour-and-travel-packages/tree/main/tour_agency/src/app"
    click IndexHTML "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/index.html"
    click StylesCSS "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/styles.css"
    click Routes "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/app.routes.ts"
    click Config "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/app.config.ts"

    click Home "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/home/home.component.ts"
    click Packages "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/packages/packages.component.ts"
    click ViewPackage "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/view-package/view-package.component.ts"
    click BookingHistory "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/booking-history/booking-history.component.ts"
    click UserProfile "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/user-profile/user-profile.component.ts"
    click FAQ "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/faq/faq.component.ts"
    click ContactUs "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/contact-us/contact-us.component.ts"

    click Login "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/login/login.component.ts"
    click Register "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/register/register.component.ts"
    click AuthService "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/auth.service.ts"

    click BookPackage "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/book-package/book-package.component.ts"
    click Payment "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/payment/payment.component.ts"

    click AdminLogin "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/admin/admin-login/admin-login.component.ts"
    click AdminDashboard "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/admin/admindashboard/admindashboard.component.ts"
    click Messages "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/admin/messages/messages.component.ts"
    click AdminService "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/tour_agency/src/app/admin.service.ts"

    click Settings "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/Tour_Agency/settings.py"
    click URLs "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/Tour_Agency/urls.py"
    click ASGI "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/Tour_Agency/asgi.py"
    click WSGI "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/Tour_Agency/wsgi.py"
    click Manage "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/manage.py"

    click Models "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/Yatraapp/models.py"
    click Serializers "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/Yatraapp/serializers.py"
    click Views "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/Yatraapp/views.py"
    click Forms "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/Yatraapp/forms.py"
    click DjangoAdmin "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/Yatraapp/admin.py"
    click Templates "https://github.com/sagarkalyankar/tour-and-travel-packages/tree/main/Tour_Agency1/Yatraapp/templates/"
    click StaticCSS "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/Yatraapp/static/css/style.css"
    click StaticImages "https://github.com/sagarkalyankar/tour-and-travel-packages/tree/main/Tour_Agency1/Yatraapp/static/images/"
    click Migrations "https://github.com/sagarkalyankar/tour-and-travel-packages/tree/main/Tour_Agency1/Yatraapp/migrations/"
    click Tests "https://github.com/sagarkalyankar/tour-and-travel-packages/blob/main/Tour_Agency1/Yatraapp/tests.py"

    %% Styles
    classDef frontend fill:#E8F6FF,stroke:#036,stroke-width:1px
    classDef backend fill:#FFE8E8,stroke:#630,stroke-width:1px
    classDef database fill:#E8FFE8,stroke:#063,stroke-width:1px
    classDef external fill:#FFF3E0,stroke:#975,stroke-width:1px
    classDef admin fill:#F3E5F5,stroke:#620,stroke-width:1px
```
