# ogasimli/udacity-moviebox architecture

> Architecture diagram of the GitHub repository ogasimli/udacity-moviebox, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ogasimli/udacity-moviebox
- Repository: https://github.com/ogasimli/udacity-moviebox

## Overview

Movie Box is an Android movie-discovery app: users choose a movie sort, browse results or favorites, open a movie, and view its details, trailers, and reviews. Network discovery and detail requests use TMDB; favorites and cached detail data are stored locally for offline use. The graph includes the principal UI, request, model, and persistence layers. Some loader and store implementations were not excerpted, so their internal call relationships are shown only where the index or README supports them.

Main entry points: [`app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java`](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java) (Movie detail view), [`app/src/main/java/org/ogasimli/MovieBox/fragments/MovieFragment.java`](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/fragments/MovieFragment.java) (Movie browser), [`app/src/main/java/org/ogasimli/MovieBox/retrofit/TmdbService.java`](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/retrofit/TmdbService.java) (TMDB API service), [`app/src/main/java/org/ogasimli/MovieBox/provigen/MovieContentProvider.java`](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/provigen/MovieContentProvider.java) (SQLite content provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browse["Movie browsing"]
  node_main["Main activity<br/>[MainActivity.java]"]
  node_movie_ui["Movie browser<br/>[MovieFragment.java]"]
  node_adapter["Movie grid adapter<br/>[MovieAdapter.java]"]
end

subgraph group_details["Movie details"]
  node_detail_activity["Detail activity"]
  node_detail_ui["Movie detail view"]
  node_trailer_dialog["Trailer chooser"]
end

subgraph group_data["Requests and models"]
  node_movie_model["Movie data model<br/>[MovieList.java]"]
  node_review_model["Review data model<br/>[ReviewList.java]"]
  node_trailer_model["Trailer data model<br/>[TrailerList.java]"]
  node_retrofit["Retrofit configuration"]
  node_tmdb_service["TMDB API service<br/>[TmdbService.java]"]
end

subgraph group_local["Local persistence"]
  node_movie_loader["Favorite movie loader<br/>[MovieLoader.java]"]
  node_movie_store["Favorite movie store<br/>[MovieStore.java]"]
  node_review_loader["Review loader<br/>[ReviewLoader.java]"]
  node_trailer_loader["Trailer loader<br/>[TrailerLoader.java]"]
  node_detail_store["Trailer and review store"]
  node_provider[("SQLite content provider")]
  node_movie_contract["Movie table contract<br/>[MovieContract.java]"]
  node_review_contract["Review table contract"]
  node_trailer_contract["Trailer table contract"]
end

node_user(("Movie viewer"))
node_tmdb{{"TMDB service"}}
node_youtube{{"YouTube"}}

node_user -->|"opens app"| node_main
node_main -->|"instantiates"| node_movie_ui
node_user -->|"chooses sort"| node_movie_ui
node_movie_ui -->|"creates grid"| node_adapter
node_movie_ui -->|"requests movies"| node_tmdb_service
node_movie_ui -->|"gets adapter"| node_retrofit
node_retrofit -.->|"configures client"| node_tmdb_service
node_tmdb_service -->|"fetches listings"| node_tmdb
node_tmdb -->|"returns movies"| node_movie_model
node_movie_ui -->|"renders results"| node_movie_model
node_adapter -->|"displays movies"| node_movie_model
node_adapter -->|"selects movie"| node_main
node_main -->|"opens detail"| node_detail_activity
node_main -->|"shows pane"| node_detail_ui
node_detail_activity -->|"hosts fragment"| node_detail_ui
node_detail_ui -->|"gets adapter"| node_retrofit
node_detail_ui -->|"requests details"| node_tmdb_service
node_tmdb_service -->|"fetches reviews"| node_tmdb
node_tmdb_service -->|"fetches trailers"| node_tmdb
node_tmdb -->|"returns reviews"| node_review_model
node_tmdb -->|"returns trailers"| node_trailer_model
node_detail_ui -->|"shows chooser"| node_trailer_dialog
node_trailer_dialog -->|"receives trailer list"| node_trailer_model
node_detail_ui -->|"renders reviews"| node_review_model
node_detail_ui -->|"saves favorite"| node_movie_store
node_detail_ui -->|"caches details"| node_detail_store
node_detail_ui -->|"loads offline reviews"| node_review_loader
node_detail_ui -->|"loads offline trailers"| node_trailer_loader
node_movie_ui -->|"loads favorites"| node_movie_loader
node_movie_loader -->|"queries movies"| node_movie_contract
node_review_loader -->|"queries reviews"| node_provider
node_review_loader -->|"uses review table"| node_review_contract
node_trailer_loader -->|"loads trailers"| node_provider
node_trailer_loader -->|"uses trailer table"| node_trailer_contract
node_movie_store -->|"writes favorites"| node_movie_contract
node_detail_store -->|"writes cached data"| node_provider
node_provider -->|"registers table"| node_movie_contract
node_provider -->|"registers table"| node_review_contract
node_provider -->|"registers table"| node_trailer_contract
node_detail_ui -.->|"shares trailer link"| node_youtube

click node_main "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/MainActivity.java"
click node_movie_ui "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/fragments/MovieFragment.java"
click node_adapter "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/objects/MovieAdapter.java"
click node_detail_activity "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/DetailActivity.java"
click node_detail_ui "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java"
click node_trailer_dialog "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/fragments/TrailerDialogFragment.java"
click node_movie_loader "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/asynctasks/MovieLoader.java"
click node_movie_store "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/asynctasks/MovieStore.java"
click node_review_loader "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/asynctasks/ReviewLoader.java"
click node_trailer_loader "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/asynctasks/TrailerLoader.java"
click node_detail_store "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/asynctasks/TrailerAndReviewStore.java"
click node_provider "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/provigen/MovieContentProvider.java"
click node_movie_contract "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/provigen/MovieContract.java"
click node_review_contract "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/provigen/ReviewContract.java"
click node_trailer_contract "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/provigen/TrailerContract.java"
click node_movie_model "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/objects/MovieList.java"
click node_review_model "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/objects/ReviewList.java"
click node_trailer_model "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/objects/TrailerList.java"
click node_retrofit "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/retrofit/RetrofitAdapter.java"
click node_tmdb_service "https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/retrofit/TmdbService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_movie_ui,node_adapter,node_user toneBlue
class node_detail_activity,node_detail_ui,node_trailer_dialog toneAmber
class node_movie_model,node_review_model,node_trailer_model,node_retrofit,node_tmdb_service toneMint
class node_movie_loader,node_movie_store,node_review_loader,node_trailer_loader,node_detail_store,node_provider,node_movie_contract,node_review_contract,node_trailer_contract toneRose
class node_tmdb,node_youtube toneIndigo
```

## Components

### Movie browsing

- [Main activity](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/MainActivity.java): `app/src/main/java/org/ogasimli/MovieBox/MainActivity.java`
- [Movie browser](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/fragments/MovieFragment.java): `app/src/main/java/org/ogasimli/MovieBox/fragments/MovieFragment.java`
- [Movie grid adapter](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/objects/MovieAdapter.java): `app/src/main/java/org/ogasimli/MovieBox/objects/MovieAdapter.java`

### Movie details

- [Detail activity](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/DetailActivity.java): `app/src/main/java/org/ogasimli/MovieBox/DetailActivity.java`
- [Movie detail view](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java): `app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java`
- [Trailer chooser](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/fragments/TrailerDialogFragment.java): `app/src/main/java/org/ogasimli/MovieBox/fragments/TrailerDialogFragment.java`

### Requests and models

- [Movie data model](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/objects/MovieList.java): `app/src/main/java/org/ogasimli/MovieBox/objects/MovieList.java`
- [Review data model](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/objects/ReviewList.java): `app/src/main/java/org/ogasimli/MovieBox/objects/ReviewList.java`
- [Trailer data model](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/objects/TrailerList.java): `app/src/main/java/org/ogasimli/MovieBox/objects/TrailerList.java`
- [Retrofit configuration](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/retrofit/RetrofitAdapter.java): `app/src/main/java/org/ogasimli/MovieBox/retrofit/RetrofitAdapter.java`
- [TMDB API service](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/retrofit/TmdbService.java): `app/src/main/java/org/ogasimli/MovieBox/retrofit/TmdbService.java`

### Local persistence

- [Favorite movie loader](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/asynctasks/MovieLoader.java): `app/src/main/java/org/ogasimli/MovieBox/asynctasks/MovieLoader.java`
- [Favorite movie store](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/asynctasks/MovieStore.java): `app/src/main/java/org/ogasimli/MovieBox/asynctasks/MovieStore.java`
- [Review loader](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/asynctasks/ReviewLoader.java): `app/src/main/java/org/ogasimli/MovieBox/asynctasks/ReviewLoader.java`
- [Trailer loader](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/asynctasks/TrailerLoader.java): `app/src/main/java/org/ogasimli/MovieBox/asynctasks/TrailerLoader.java`
- [Trailer and review store](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/asynctasks/TrailerAndReviewStore.java): `app/src/main/java/org/ogasimli/MovieBox/asynctasks/TrailerAndReviewStore.java`
- [SQLite content provider](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/provigen/MovieContentProvider.java): `app/src/main/java/org/ogasimli/MovieBox/provigen/MovieContentProvider.java`
- [Movie table contract](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/provigen/MovieContract.java): `app/src/main/java/org/ogasimli/MovieBox/provigen/MovieContract.java`
- [Review table contract](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/provigen/ReviewContract.java): `app/src/main/java/org/ogasimli/MovieBox/provigen/ReviewContract.java`
- [Trailer table contract](https://github.com/ogasimli/udacity-moviebox/blob/master/app/src/main/java/org/ogasimli/MovieBox/provigen/TrailerContract.java): `app/src/main/java/org/ogasimli/MovieBox/provigen/TrailerContract.java`

### Other components

- **Movie viewer**
- **TMDB service**
- **YouTube**

## Connections

- Movie viewer → Main activity: opens app (evidence: `app/src/main/java/org/ogasimli/MovieBox/MainActivity.java`)
- Main activity → Movie browser: instantiates (evidence: `app/src/main/java/org/ogasimli/MovieBox/MainActivity.java`)
- Movie viewer → Movie browser: chooses sort
- Movie browser → Movie grid adapter: creates grid (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/MovieFragment.java`)
- Movie browser → TMDB API service: requests movies (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/MovieFragment.java`)
- Movie browser → Retrofit configuration: gets adapter (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/MovieFragment.java`)
- Retrofit configuration → TMDB API service: configures client
- TMDB API service → TMDB service: fetches listings (evidence: `app/src/main/java/org/ogasimli/MovieBox/retrofit/TmdbService.java`)
- TMDB service → Movie data model: returns movies
- Movie browser → Movie data model: renders results (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/MovieFragment.java`)
- Movie grid adapter → Movie data model: displays movies (evidence: `app/src/main/java/org/ogasimli/MovieBox/objects/MovieAdapter.java`)
- Movie grid adapter → Main activity: selects movie (evidence: `app/src/main/java/org/ogasimli/MovieBox/MainActivity.java`)
- Main activity → Detail activity: opens detail (evidence: `app/src/main/java/org/ogasimli/MovieBox/MainActivity.java`)
- Main activity → Movie detail view: shows pane (evidence: `app/src/main/java/org/ogasimli/MovieBox/MainActivity.java`)
- Detail activity → Movie detail view: hosts fragment (evidence: `app/src/main/java/org/ogasimli/MovieBox/DetailActivity.java`)
- Movie detail view → Retrofit configuration: gets adapter (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java`)
- Movie detail view → TMDB API service: requests details (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java`)
- TMDB API service → TMDB service: fetches reviews (evidence: `app/src/main/java/org/ogasimli/MovieBox/retrofit/TmdbService.java`)
- TMDB API service → TMDB service: fetches trailers (evidence: `app/src/main/java/org/ogasimli/MovieBox/retrofit/TmdbService.java`)
- TMDB service → Review data model: returns reviews
- TMDB service → Trailer data model: returns trailers
- Movie detail view → Trailer chooser: shows chooser (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java`)
- Trailer chooser → Trailer data model: receives trailer list (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/TrailerDialogFragment.java`)
- Movie detail view → Review data model: renders reviews (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java`)
- Movie detail view → Favorite movie store: saves favorite (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java`)
- Movie detail view → Trailer and review store: caches details (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java`)
- Movie detail view → Review loader: loads offline reviews (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java`)
- Movie detail view → Trailer loader: loads offline trailers (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/DetailFragment.java`)
- Movie browser → Favorite movie loader: loads favorites (evidence: `app/src/main/java/org/ogasimli/MovieBox/fragments/MovieFragment.java`)
- Favorite movie loader → Movie table contract: queries movies (evidence: `app/src/main/java/org/ogasimli/MovieBox/asynctasks/MovieLoader.java`)
- Review loader → SQLite content provider: queries reviews (evidence: `app/src/main/java/org/ogasimli/MovieBox/asynctasks/ReviewLoader.java`)
- Review loader → Review table contract: uses review table (evidence: `app/src/main/java/org/ogasimli/MovieBox/asynctasks/ReviewLoader.java`)
- Trailer loader → SQLite content provider: loads trailers (evidence: `app/src/main/java/org/ogasimli/MovieBox/asynctasks/TrailerLoader.java`)
- Trailer loader → Trailer table contract: uses trailer table (evidence: `app/src/main/java/org/ogasimli/MovieBox/asynctasks/TrailerLoader.java`)
- Favorite movie store → Movie table contract: writes favorites (evidence: `app/src/main/java/org/ogasimli/MovieBox/asynctasks/MovieStore.java`)
- Trailer and review store → SQLite content provider: writes cached data (evidence: `app/src/main/java/org/ogasimli/MovieBox/asynctasks/TrailerAndReviewStore.java`)
- SQLite content provider → Movie table contract: registers table (evidence: `app/src/main/java/org/ogasimli/MovieBox/provigen/MovieContentProvider.java`)
- SQLite content provider → Review table contract: registers table (evidence: `app/src/main/java/org/ogasimli/MovieBox/provigen/MovieContentProvider.java`)
- SQLite content provider → Trailer table contract: registers table (evidence: `app/src/main/java/org/ogasimli/MovieBox/provigen/MovieContentProvider.java`)
- Movie detail view → YouTube: shares trailer link
