# rajatt95/masterseleniumframework architecture

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

- Interactive diagram: https://gitdiagram.com/rajatt95/masterseleniumframework
- Repository: https://github.com/rajatt95/masterseleniumframework

## Overview

##### Project type and purpose
- This is a Java-based automated testing framework (“MasterSeleniumFramework”) that unifies UI tests (via Selenium WebDriver) and API tests (via RestAssured) into atomic test cases.
- It provides cross-browser support, data-driven testing, custom annotations, configurable reports (ExtentReports v5 & Allure), retry logic, email notifications, and CI/CD integration (Jenkins).

##### File structure
- Top-level:
- pom.xml – Maven build/dep management
- src/main/java/org/selenium – framework code
- src/test/java/org/selenium – test classes & base test
- src/test/resources – configs, JSON test data, TestNG XML runners
- Key packages under src/main/java/org/selenium:
- annotations – custom TestNG/JUnit annotations
- api & api/actions – RestAssured client and API action classes
- driver & factories – DriverManagerFactory and browser‐specific DriverManagers
- pages & components – Page Object Model classes for UI elements
- dataproviders – JSONDataProvider for data-driven tests
- listeners – TestNG listeners, retry/failure interceptors
- reports – ExtentReports manager/logger classes
- java_Mail_API – email sender & config classes
- utils – utilities (config loader, JSON/Jackson utils, screenshot, zip, date, verification)
- Test sources:
- BaseTest – setup/teardown logic
- Tests (AddToCartTest, LoginTest, etc.)
- TestNG runner XMLs for local/Jenkins cross-browser

##### README for additional insights
- Emphasis on atomic tests combining UI & API
- Allure reports support
- Email notifications with zipped reports via JavaMail
- Parallel execution, cross-browser, retry mechanisms
- Custom enums, exceptions, annotations, data-driven via JSON

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Test Runner Layer
    subgraph "Test Runner (TestNG)"
        TR["TestNG Runner\n(XMLs)"]:::config
    end

    %% Configuration Layer
    subgraph "Configuration Loader"
        CL["ConfigLoader"]:::config
        INTP["int_config.properties"]:::config
        STGP["stg_config.properties"]:::config
        ALLP["allure.properties"]:::config
    end

    %% Test Scripts Layer
    subgraph "Test Scripts"
        BT["BaseTest"]:::test
        LT["LoginTest"]:::test
        ST["SearchTest"]:::test
        AT["AddToCartTest"]:::test
        NT["NavigationTest"]:::test
    end

    %% Core Framework Layer
    subgraph "Driver Factory Layer"
        DF["DriverManagerFactory"]:::core
        DCH["DriverManagerChrome"]:::core
        DFF["DriverManagerFirefox"]:::core
        DED["DriverManagerEdge"]:::core
        DOP["DriverManagerOpera"]:::core
        DSA["DriverManagerSafari"]:::core
        DOC["DriverManager_OC"]:::core
        EWF["ExplicitWaitFactory"]:::core
    end

    subgraph "Web UI Layer"
        BP["BasePage"]:::core
        HP["HomePage"]:::core
        SP["StorePage"]:::core
        CP["CartPage"]:::core
        CKP["CheckoutPage"]:::core
        MC["MyHeader"]:::core
        PT["ProductThumbnail"]:::core
    end

    subgraph "API Layer"
        SB["SpecBuilder"]:::core
        AR["ApiRequest"]:::core
        CA["CartApi"]:::core
        SA["SignUpApi"]:::core
    end

    subgraph "Data Layer"
        JDP["JSONDataProvider"]:::core
        PJSON["products.json"]:::core
        BJSON["myBillingAddress.json"]:::core
    end

    subgraph "Listeners & Annotations"
        LC["ListenerClass"]:::core
        RT["RetryFailedTests"]:::core
        MI["MethodInterceptor"]:::core
        ATN["AnnotationTransformer"]:::core
    end

    %% Reporting & Notification
    subgraph "Reporting Engine"
        EM["ExtentManager"]:::report
        EL["ExtentLogger"]:::report
        ER["ExtentReport"]:::report
        AP["Allure Properties"]:::report
    end

    subgraph "Email Service"
        EC["EmailConfig"]:::core
        EAS["EmailAttachmentsSender"]:::core
    end

    %% CI/CD & External Services
    subgraph "CI/CD & External"
        JEN["Jenkins"]:::external
        SMTP["SMTP Server"]:::external
        BROWSERS["Browsers\n(Chrome, Firefox,\nEdge, Safari, Opera)"]:::external
    end

    %% Flow Connections
    JEN -->|"triggers"| TR
    TR -->|"loads config"| CL
    CL -->|"reads"| INTP
    CL -->|"reads"| STGP
    CL -->|"reads"| ALLP

    TR -->|"invokes before()"| BT
    CL -->|"provides config"| BT

    BT -->|"sets up"| DF
    DF -->|"creates"| DCH
    DF -->|"creates"| DFF
    DF -->|"creates"| DED
    DF -->|"creates"| DOP
    DF -->|"creates"| DSA
    DF -->|"creates"| DOC
    DF -->|"uses"| EWF
    DF -->|"controls"| BROWSERS

    BT -->|"interacts with"| BP
    BP --> HP
    BP --> SP
    BP --> CP
    BP --> CKP
    BP --> MC
    BP --> PT

    BT -->|"calls API"| CA
    BT -->|"calls API"| SA
    CA --> SB
    CA --> AR
    SA --> SB
    SA --> AR

    BT -->|"data-driven"| JDP
    JDP --> PJSON
    JDP --> BJSON

    BT -->|"registers"| LC
    BT -->|"registers"| RT
    BT -->|"registers"| MI
    BT -->|"registers"| ATN

    LC -->|"logs to"| EM
    LC -->|"logs to"| EL
    EM --> ER
    AP --> ER

    ER -->|"zip & email"| EAS
    EAS --> EC
    EC --> SMTP
    JEN -->|"collects reports"| EAS

    %% Click Events
    click TR "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/resources/runners/testng_Local.xml"
    click TR "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/resources/runners/testng_Jenkins_CrossBrowser.xml"
    click TR "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/resources/runners/testng_Jenkins_CrossBrowser_Safari.xml"
    click TR "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/resources/runners/testng_Jenkins_OneBrowser.xml"

    click CL "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/utils/ConfigLoader.java"
    click INTP "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/resources/int_config.properties"
    click STGP "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/resources/stg_config.properties"
    click ALLP "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/resources/allure.properties"

    click DF "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/driver/DriverManagerFactory.java"
    click DCH "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/driver/DriverManagerChrome.java"
    click DFF "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/driver/DriverManagerFirefox.java"
    click DED "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/driver/DriverManagerEdge.java"
    click DOP "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/driver/DriverManagerOpera.java"
    click DSA "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/driver/DriverManagerSafari.java"
    click DOC "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/driver/DriverManager_OC.java"
    click EWF "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/factories/ExplicitWaitFactory.java"

    click BP "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/pages/BasePage.java"
    click HP "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/pages/HomePage.java"
    click SP "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/pages/StorePage.java"
    click CP "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/pages/CartPage.java"
    click CKP "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/pages/CheckoutPage.java"
    click MC "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/components/MyHeader.java"
    click PT "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/components/ProductThumbnail.java"

    click SB "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/api/SpecBuilder.java"
    click AR "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/api/ApiRequest.java"
    click CA "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/api/actions/CartApi.java"
    click SA "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/api/actions/SignUpApi.java"

    click BT "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/java/org/selenium/base/BaseTest.java"
    click LT "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/java/org/selenium/tests/LoginTest.java"
    click ST "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/java/org/selenium/tests/SearchTest.java"
    click AT "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/java/org/selenium/tests/AddToCartTest.java"
    click NT "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/java/org/selenium/tests/NavigationTest.java"

    click JDP "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/dataproviders/JSONDataProvider.java"
    click PJSON "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/resources/products.json"
    click BJSON "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/resources/myBillingAddress.json"

    click EM "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/reports/ExtentManager.java"
    click EL "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/reports/ExtentLogger.java"
    click ER "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/reports/ExtentReport.java"
    click AP "https://github.com/rajatt95/masterseleniumframework/blob/master/src/test/resources/allure.properties"

    click LC "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/listeners/ListenerClass.java"
    click RT "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/listeners/RetryFailedTests.java"
    click MI "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/listeners/MethodInterceptor.java"
    click ATN "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/listeners/AnnotationTransformer.java"

    click EC "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/java_Mail_API/EmailConfig.java"
    click EAS "https://github.com/rajatt95/masterseleniumframework/blob/master/src/main/java/org/selenium/java_Mail_API/EmailAttachmentsSender.java"

    %% Styles
    classDef config fill:#cccccc,stroke:#333;
    classDef core fill:#add8e6,stroke:#333;
    classDef test fill:#98fb98,stroke:#333;
    classDef report fill:#ffa500,stroke:#333;
    classDef external fill:#dda0dd,stroke:#333;
```
