# hichamaf/ticketmaster-rest-api architecture

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

- Interactive diagram: https://gitdiagram.com/hichamaf/ticketmaster-rest-api
- Repository: https://github.com/hichamaf/ticketmaster-rest-api

## Overview

##### Project type and purpose
- This is a native Android mobile application (Kotlin) that interacts with the Ticketmaster Web API.
- Purpose: Search and display event, attraction, and venue data by making HTTP requests, parsing JSON responses with Gson, and rendering them in RecyclerViews across multiple Fragments.

##### File structure
- Top-level “app” module contains everything Android-related (Gradle config, Manifest, resources, source code).
- app/src/main/java/fi/centria/ticketmaster holds:
- MainActivity.kt – the host Activity
- Fragments (FirstFragment, EventFragment, MusicFragment, etc.) – each displays filtered event lists or details
- Adapters (AllEventAdapter, EventAdapter, AttractionAdapter) – bind data to RecyclerView rows
- EventDataModel.kt – Kotlin data classes matching JSON schema
- EventDetailsFragment.kt – shows detail view of a single event
- No local database or caching layer present; all data comes directly from the remote API.
- Configuration: build.gradle for dependencies (e.g., Gson), AndroidManifest.xml registers activities/fragments.

##### Extract insights from the README
- REST client calls “https://app.ticketmaster.com/discovery/v2/…” with an API key.
- JSON → Kotlin object mapping via Gson.
- UI consists of multiple list and detail screens (screenshots in the README).

##### Main components
a. Mobile App (Android APK)
- Presentation Layer: MainActivity + Navigation Host + Fragments + RecyclerViews
- Adapter Layer: Adapters format EventDataModel into view items
- Data Layer:
– Network Client (e.g., Retrofit or HttpUrlConnection with Gson)
– EventDataModel (Kotlin data classes)
b. External Service
- Ticketmaster REST API (Discovery v2)
c. (Optional) Future Extension
- Local Cache (Room or SharedPreferences)
- Authentication Manager (API key handling)

##### Relationships & interactions
- User taps UI → Fragment triggers ViewModel/Controller to make network call
- Network Client issues HTTP GET to Ticketmaster endpoint (including API key)
- Ticketmaster sends back JSON → parsed by Gson into EventDataModel
- Adapter receives model list → binds data to RecyclerView rows
- On item click → EventDetailsFragment fetches/passes selected model → displays detail screen

##### Architectural patterns & design principles
- MVVM or MVP flavor (UI layer separated from networking & data modeling)
- Single-activity with multiple fragments navigation
- Separation of concerns: Adapters handle view binding, Fragments handle presentation logic, Data Model handles schema

##### Detail without overcomplication
- Every Fragment, Adapter, and data-model relationship if clarity is needed.
- Always show how the API key is injected into the request (e.g., annotate the HTTP client block).

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Android App"
        subgraph "Presentation Layer"
            MA["MainActivity"]:::presentation
            FF["FirstFragment"]:::presentation
            SF["SecondFragment"]:::presentation
            TF["ThirdFragment"]:::presentation
            FoF["FourthFragment"]:::presentation
            EF["EventFragment"]:::presentation
            MF["MusicFragment"]:::presentation
            SpF["SportFragment"]:::presentation
            EDF["EventDetailsFragment"]:::presentation
        end

        subgraph "Adapter Layer"
            AEA["AllEventAdapter"]:::adapter
            EA["EventAdapter"]:::adapter
            AA["AttractionAdapter"]:::adapter
        end

        subgraph "Data/Network Layer"
            NC["Network Client\n(Retrofit/HttpUrlConnection, Gson)"]:::datanet
            EDM["EventDataModel\n(Kotlin data classes)"]:::datanet
        end
    end

    TM["Ticketmaster REST API"]:::external

    FF -->|"requests events"| NC
    SF -->|"requests events"| NC
    TF -->|"requests events"| NC
    FoF -->|"requests events"| NC
    EF -->|"requests events"| NC
    MF -->|"requests events"| NC
    SpF -->|"requests events"| NC
    EDF -->|"requests details"| NC

    NC -->|"HTTP GET"| TM
    TM -->|"JSON response"| NC

    NC -->|"parse JSON"| EDM
    EDM -->|"model list"| AEA
    EDM -->|"model list"| EA
    EDM -->|"model list"| AA

    AEA -->|"bind data"| FF
    EA -->|"bind data"| EF
    AA -->|"bind data"| MF

    classDef presentation fill:#D6EAF8,stroke:#2980B9,stroke-width:2px
    classDef adapter fill:#D5F5E3,stroke:#27AE60,stroke-width:2px
    classDef datanet fill:#FCF3CF,stroke:#D68910,stroke-width:2px
    classDef external fill:#D5DBDB,stroke:#7F8C8D,stroke-width:2px,stroke-dasharray: 5 5

    click MA "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/MainActivity.kt"
    click FF "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/FirstFragment.kt"
    click SF "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/SecondFragment.kt"
    click TF "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/ThirdFragment.kt"
    click FoF "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/FourthFragment.kt"
    click EF "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/EventFragment.kt"
    click MF "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/MusicFragment.kt"
    click SpF "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/SportFragment.kt"
    click EDF "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/EventDetailsFragment.kt"
    click AEA "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/AllEventAdapter.kt"
    click EA "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/EventAdapter.kt"
    click AA "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/AttractionAdapter.kt"
    click EDM "https://github.com/hichamaf/ticketmaster-rest-api/blob/master/app/src/main/java/fi/centria/ticketmaster/EventDataModel.kt"
```
