# jasonlin1993/taipei_day_trip architecture

> Architecture diagram of the GitHub repository jasonlin1993/taipei_day_trip, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jasonlin1993/taipei_day_trip
- Repository: https://github.com/jasonlin1993/taipei_day_trip

## Overview

##### Main System Components

Frontend Layer:
- Static content (HTML, SCSS, JavaScript)
- Client-side features (Authentication, Booking, Payment Integration)
- Pages (Index, Attraction, Booking, Thank You)

Backend Layer:
- Flask Application Server
- RESTful API Endpoints
- JWT Authentication System
- Database Connection Pool

Database Layer:
- MySQL Database (with tables for attractions, users, bookings, orders)

External Services:
- TapPay Payment Gateway
- AWS EC2 Hosting

**[Client Layer]**
- ↕
**[Application Layer]**
- ↕
**[Data Layer]**

##### Connection and Flow Indicators

- HTTP/AJAX requests between frontend and API
- Database queries
- Authentication flows
- Payment processing flow through TapPay

##### Special Features to Highlight

- Infinite scroll mechanism
- JWT token flow
- TapPay payment integration
- Connection pooling
- Static file serving

##### Additional Elements

Infrastructure:
- AWS EC2 instance
- Ubuntu Server

Security:
- JWT token validation
- Bearer token authentication

##### Specific Implementation Details

- How the MVC pattern is implemented (Model/View/Controller separation)
- API routing system
- Static file serving through Flask
- Database connection pooling
- Payment processing flow

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        FE_Pages["Frontend Pages"]
        FE_Static["Static Assets"]
        FE_Features["Client Features"]
        
        subgraph Pages
            Index["Index Page"]:::page
            Attraction["Attraction Page"]:::page
            Booking["Booking Page"]:::page
            ThankYou["Thank You Page"]:::page
        end
        
        subgraph Static
            CSS["Styles"]:::static
            JS["JavaScript"]:::static
            Base["Base Template"]:::static
        end
        
        subgraph Features
            InfScroll["Infinite Scroll"]:::feature
            DateTime["Date/Time Handler"]:::feature
            MRTSearch["MRT Search"]:::feature
            AuthStatus["Auth Status"]:::feature
            PayInt["Payment Integration"]:::feature
        end
    end

    subgraph API_Layer
        Flask["Flask App Server"]:::server
        JWT["JWT Token Handler"]:::auth
        
        subgraph Endpoints
            AttrAPI["Attractions API"]:::api
            SingleAttrAPI["Single Attraction API"]:::api
            BookAPI["Booking API"]:::api
            OrderAPI["Order API"]:::api
            UserAPI["User Auth API"]:::api
            MRTAPI["MRT API"]:::api
        end
    end

    subgraph Business_Layer
        AttrModel["Attraction Model"]:::model
        BookModel["Booking Model"]:::model
        OrderModel["Order Model"]:::model
        UserModel["User Model"]:::model
    end

    subgraph Data_Layer
        DBPool["Database Connection Pool"]:::db
        MySQL["MySQL Database"]:::db
        Schema["Database Schema"]:::db
        InitData["Initial Data"]:::db
    end

    subgraph External
        TapPay["TapPay Gateway"]:::external
        AWS["AWS EC2"]:::external
    end

    %% Connections
    FE_Pages --> API_Layer
    FE_Static --> FE_Pages
    FE_Features --> API_Layer
    
    API_Layer --> Business_Layer
    Business_Layer --> Data_Layer
    PayInt --> TapPay
    
    %% Click Events
    click Index "https://github.com/jasonlin1993/taipei_day_trip/blob/main/templates/index.html"
    click Attraction "https://github.com/jasonlin1993/taipei_day_trip/blob/main/templates/attraction.html"
    click Booking "https://github.com/jasonlin1993/taipei_day_trip/blob/main/templates/booking.html"
    click ThankYou "https://github.com/jasonlin1993/taipei_day_trip/blob/main/templates/thankyou.html"
    click Base "https://github.com/jasonlin1993/taipei_day_trip/blob/main/templates/base.html"
    click CSS "https://github.com/jasonlin1993/taipei_day_trip/tree/main/static/styles/css"
    click JS "https://github.com/jasonlin1993/taipei_day_trip/tree/main/static/javascript"
    click AttrAPI "https://github.com/jasonlin1993/taipei_day_trip/blob/main/api/attractions_api.py"
    click SingleAttrAPI "https://github.com/jasonlin1993/taipei_day_trip/blob/main/api/attraction_id_api.py"
    click BookAPI "https://github.com/jasonlin1993/taipei_day_trip/blob/main/api/booking_api.py"
    click OrderAPI "https://github.com/jasonlin1993/taipei_day_trip/blob/main/api/order_api.py"
    click UserAPI "https://github.com/jasonlin1993/taipei_day_trip/blob/main/api/user_auth_api.py"
    click MRTAPI "https://github.com/jasonlin1993/taipei_day_trip/blob/main/api/mrt_api.py"
    click JWT "https://github.com/jasonlin1993/taipei_day_trip/blob/main/api/jwt_token.py"
    click AuthStatus "https://github.com/jasonlin1993/taipei_day_trip/blob/main/static/javascript/checkLoginStatus.js"
    click DBPool "https://github.com/jasonlin1993/taipei_day_trip/blob/main/data/database.py"
    click Schema "https://github.com/jasonlin1993/taipei_day_trip/blob/main/data/data.sql"
    click InitData "https://github.com/jasonlin1993/taipei_day_trip/blob/main/data/taipei-attractions.json"
    click AttrModel "https://github.com/jasonlin1993/taipei_day_trip/blob/main/model/attractions_model.py"
    click BookModel "https://github.com/jasonlin1993/taipei_day_trip/blob/main/model/booking_model.py"
    click OrderModel "https://github.com/jasonlin1993/taipei_day_trip/blob/main/model/order_model.py"
    click UserModel "https://github.com/jasonlin1993/taipei_day_trip/blob/main/model/user_model.py"
    click PayInt "https://github.com/jasonlin1993/taipei_day_trip/blob/main/static/javascript/tappay.js"
    click InfScroll "https://github.com/jasonlin1993/taipei_day_trip/blob/main/static/javascript/loadNextPage.js"
    click DateTime "https://github.com/jasonlin1993/taipei_day_trip/blob/main/static/javascript/dateTime.js"
    click MRTSearch "https://github.com/jasonlin1993/taipei_day_trip/blob/main/static/javascript/searchMrt.js"
    click Flask "https://github.com/jasonlin1993/taipei_day_trip/blob/main/app.py"

    %% Styles
    classDef page fill:#e1f5fe,stroke:#01579b
    classDef static fill:#e8f5e9,stroke:#2e7d32
    classDef feature fill:#fff3e0,stroke:#ef6c00
    classDef api fill:#f3e5f5,stroke:#7b1fa2
    classDef auth fill:#fff8e1,stroke:#ffa000
    classDef model fill:#fce4ec,stroke:#c2185b
    classDef db fill:#ede7f6,stroke:#4527a0
    classDef server fill:#e8eaf6,stroke:#283593
    classDef external fill:#eceff1,stroke:#455a64
```
