# pp492312/watchlistapplication architecture

> Architecture diagram of the GitHub repository pp492312/watchlistapplication, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pp492312/watchlistapplication
- Repository: https://github.com/pp492312/watchlistapplication

## Overview

##### Project type and purpose
- This is a monolithic, full-stack Java web application built with Spring Boot.
- Purpose: allow users to manage a personal movie watchlist (CRUD operations) and fetch live ratings from the OMDB API.

##### File structure
- Top-level: Maven project (pom.xml, mvnw)
- src/main/java/com/example/pramod/watchlist
- WatchlistApplication.java (Spring Boot entry point)
- controller/MovieController.java (web layer)
- service/{DatabaseService.java, RatingService.java} (business logic)
- repository/MovieRepo.java (data‐access layer via Spring Data JPA)
- entity/Movie.java + custom validation annotations (domain model)
- src/main/resources/templates: Thymeleaf HTML views (index, watchlist, form)
- src/main/resources/application.properties: configuration (DB, OMDB API key, etc.)

##### Key insights from README
- Core features: add/delete/update movies in watchlist
- External integration: rating updates via OMDB API
- MVC pattern implied by controllers, services, repos and templates

a. Main components
- Browser (User Interface)
- Spring Boot Web Server
- Presentation Layer: Thymeleaf templates + MovieController
- Business Layer: DatabaseService, RatingService
- Data Layer: MovieRepo, Entity Manager
- Database (e.g., H2 / PostgreSQL)
- External Service: OMDB API
b. Relationships & interactions
1. User → Browser UI → sends HTTP requests
2. MovieController handles requests, invokes services
3. DatabaseService interacts with MovieRepo → reads/writes DB
4. RatingService calls OMDB API via REST, processes response
5. Controller composes model and returns Thymeleaf view
c. Architectural patterns & design principles
- MVC (Model-View-Controller)
- Layered architecture (presentation, service, repository)
- Dependency injection via Spring
- Repository abstraction (Spring Data JPA)
d. Key technologies & frameworks
- Spring Boot, Spring MVC, Spring Data JPA
- Thymeleaf (server-side templating)
- Maven build system
- External REST service (OMDB API)
- Hibernate/JPA for ORM

##### Detail
- Maven build artifact (jar) or Spring Boot embedded server if desired

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client
    Browser["Browser (User UI)"]:::external

    %% Server Side
    subgraph "Server"
        subgraph "Presentation Layer"
            WatchlistApplication["WatchlistApplication"]:::presentation
            MovieController["MovieController"]:::presentation
            Templates["Thymeleaf Templates"]:::presentation
            Config["application.properties"]:::presentation
        end

        subgraph "Business Layer"
            DatabaseService["DatabaseService"]:::business
            RatingService["RatingService"]:::business
        end

        subgraph "Domain Layer"
            MovieEntity["Movie Entity (Movie.java)"]:::data
            PriorityAnnotation["Priority Annotation"]:::data
            PriorityLogic["PriorityAnnotationLogic"]:::data
            RatingAnnotation["Rating Annotation"]:::data
            RatingLogic["RatingAnnotationLogic"]:::data
        end

        subgraph "Data Access Layer"
            MovieRepo["MovieRepo"]:::data
            Database[(Database)]:::data
        end

        subgraph "Testing"
            Tests["Application Tests"]:::external
        end
    end

    %% External Services
    OMDB["OMDB API"]:::external

    %% Relationships
    Browser -->|"HTTP GET/POST"| MovieController
    WatchlistApplication -->|bootstrap| MovieController
    MovieController -->|"invoke"| DatabaseService
    MovieController -->|"invoke"| RatingService
    MovieController -->|"return view"| Templates
    DatabaseService -->|"save(), findAll()"| MovieRepo
    RatingService -->|"HTTP GET to OMDB"| OMDB
    MovieRepo -->|"SQL operations"| Database

    %% Click Events
    click WatchlistApplication "https://github.com/pp492312/watchlistapplication/blob/master/src/main/java/com/example/pramod/watchlist/WatchlistApplication.java"
    click MovieController "https://github.com/pp492312/watchlistapplication/blob/master/src/main/java/com/example/pramod/watchlist/controller/MovieController.java"
    click Templates "https://github.com/pp492312/watchlistapplication/tree/master/src/main/resources/templates/"
    click DatabaseService "https://github.com/pp492312/watchlistapplication/blob/master/src/main/java/com/example/pramod/watchlist/service/DatabaseService.java"
    click RatingService "https://github.com/pp492312/watchlistapplication/blob/master/src/main/java/com/example/pramod/watchlist/service/RatingService.java"
    click MovieRepo "https://github.com/pp492312/watchlistapplication/blob/master/src/main/java/com/example/pramod/watchlist/repository/MovieRepo.java"
    click MovieEntity "https://github.com/pp492312/watchlistapplication/blob/master/src/main/java/com/example/pramod/watchlist/entity/Movie.java"
    click PriorityAnnotation "https://github.com/pp492312/watchlistapplication/blob/master/src/main/java/com/example/pramod/watchlist/entity/validation/Priority/Priority.java"
    click PriorityLogic "https://github.com/pp492312/watchlistapplication/blob/master/src/main/java/com/example/pramod/watchlist/entity/validation/Priority/PriorityAnnotationLogic.java"
    click RatingAnnotation "https://github.com/pp492312/watchlistapplication/blob/master/src/main/java/com/example/pramod/watchlist/entity/validation/Priority/Rating.java"
    click RatingLogic "https://github.com/pp492312/watchlistapplication/blob/master/src/main/java/com/example/pramod/watchlist/entity/validation/Priority/RatingAnnotationLogic.java"
    click Config "https://github.com/pp492312/watchlistapplication/blob/master/src/main/resources/application.properties"
    click Tests "https://github.com/pp492312/watchlistapplication/blob/master/src/test/java/com/example/pramod/watchlist/WatchlistApplicationTests.java"

    %% Styles
    classDef presentation fill:#AED6F1,stroke:#1B4F72,color:#1B2631
    classDef business fill:#ABEBC6,stroke:#196F3D,color:#145A32
    classDef data fill:#F9E79F,stroke:#B9770E,color:#7E5109
    classDef external fill:#D5D8DC,stroke:#626567,color:#1B2631
```
