# igauravbhatt/selenium-testng-framework architecture

> Architecture diagram of the GitHub repository igauravbhatt/selenium-testng-framework, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/igauravbhatt/selenium-testng-framework
- Repository: https://github.com/igauravbhatt/selenium-testng-framework

## Overview

##### Project type and purpose
- This is a Java-based Selenium TestNG automation framework, organized using the Page Object Model (POM).
- It is designed to automate end-to-end UI tests against a web application, grouping tests into suites (smoke, regression) via TestNG XML files.

##### File structure
- Top-level files:
- pom.xml — Maven build and dependency management
- smoke.xml, Regression.xml — TestNG suite definitions
- src/main/java/com/selenium_testng:
- base/ — core framework classes:
– base.java: initializes WebDriver, loads properties, sets up TestNG before/after methods
– PageObjectManager.java: lazy-loads and provides page object instances
- pages/ — one class per web page (Login, Dashboard, PIM, Leave, etc.) implementing element locators and actions
- utils/ — support utilities:
– PropertyReader.java: reads objectRepo.properties and config files
– commonMethods.java: reusable UI interaction helpers
– ReportListener.java, screenshotListener.java: event handlers for logging and capturing screenshots
– objectRepo.properties: element locators and test data mappings
- src/test/java/com/selenium_testng:
- Listeners.java — registers TestNG listeners for reporting and screenshots
- Practice_Testcases/ — exploratory or sample tests
- TestCases/ — structured test classes (TC01_login, TC02_Dashboard, …) extending baseTest.java

##### README
- README is minimal; rely on the code organization and naming conventions to infer the architecture.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Top-level Build
    pom[pom.xml]:::framework
    click pom "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/pom.xml"

    %% Test Runner Layer
    subgraph "Test Runner Layer"
        style TestRunner stroke:#333,stroke-width:1
        smoke[smoke.xml]:::test
        click smoke "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/smoke.xml"
        regression[Regression.xml]:::test
        click regression "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/Regression.xml"
        engine["TestNG Engine"]:::framework
    end

    pom -->|"build & dependency management"| engine
    smoke -->|"triggers"| engine
    regression -->|"triggers"| engine

    %% Listeners Registration
    listenersReg["Listeners.java"]:::framework
    click listenersReg "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/src/test/java/com/selenium_testng/Listeners.java"
    engine -->|"registers listeners"| listenersReg

    %% Custom Listeners
    subgraph "Custom Reporting & Screenshots"
        reportL["ReportListener.java"]:::util
        click reportL "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/src/main/java/com/selenium_testng/utils/ReportListener.java"
        screenshotL["screenshotListener.java"]:::util
        click screenshotL "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/src/main/java/com/selenium_testng/utils/screenshotListener.java"
        objRepo["objectRepo.properties"]:::util
        click objRepo "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/src/main/java/com/selenium_testng/utils/objectRepo.properties"
    end

    listenersReg -->|"uses"| reportL
    listenersReg -->|"uses"| screenshotL

    %% Test Scripts Layer
    subgraph "Test Scripts Layer"
        style TestScripts stroke:#333,stroke-width:1
        practice["Practice_Testcases/"]:::test
        click practice "https://github.com/igauravbhatt/selenium-testng-framework/tree/master/src/test/java/com/selenium_testng/Practice_Testcases/"
        structured["TestCases/"]:::test
        click structured "https://github.com/igauravbhatt/selenium-testng-framework/tree/master/src/test/java/com/selenium_testng/TestCases/"
        baseTest["baseTest.java"]:::framework
        click baseTest "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/src/test/java/com/selenium_testng/TestCases/baseTest.java"
    end

    engine -->|"invokes"| practice
    engine -->|"invokes"| structured
    practice -->|"extends"| baseTest
    structured -->|"extends"| baseTest

    %% Framework Core Layer
    subgraph "Framework Core Layer"
        style Core stroke:#333,stroke-width:1
        baseCore["base.java"]:::framework
        click baseCore "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/src/main/java/com/selenium_testng/base/base.java"
        pomObjMgr["PageObjectManager.java"]:::framework
        click pomObjMgr "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/src/main/java/com/selenium_testng/base/PageObjectManager.java"
    end

    baseTest -->|"calls setup/teardown"| baseCore
    baseCore -->|"initializes"| pomObjMgr

    %% Utilities Layer
    subgraph "Utilities Layer"
        style Utils stroke:#333,stroke-width:1
        propReader["PropertyReader.java"]:::util
        click propReader "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/src/main/java/com/selenium_testng/utils/PropertyReader.java"
        commonM["commonMethods.java"]:::util
        click commonM "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/src/main/java/com/selenium_testng/utils/commonMethods.java"
    end

    baseCore -->|"reads configs"| propReader
    propReader --> objRepo
    commonM -->|"helper methods"| baseCore

    %% Page Objects Layer
    subgraph "Page Objects Layer"
        style Pages stroke:#333,stroke-width:1
        pages["pages/"]:::framework
        click pages "https://github.com/igauravbhatt/selenium-testng-framework/tree/master/src/main/java/com/selenium_testng/pages/"
    end

    pomObjMgr -->|"provides"| pages
    pages -->|"uses locators & actions"| commonM

    %% Browser & SUT
    browser["Browser (Chrome/Firefox)"]:::external
    sut["System Under Test (Web App)"]:::external

    pages -->|"WebDriver API calls"| browser
    browser -->|"requests"| sut

    %% Reporting Output
    reportOut["TestNG Reports & Screenshots"]:::external
    reportL -->|"generates"| reportOut
    screenshotL -->|"captures"| reportOut

    %% README Documentation
    readme["README.md"]:::external
    click readme "https://github.com/igauravbhatt/selenium-testng-framework/blob/master/README.md"
    pom -->|"documentation"| readme

    classDef framework fill:#D6EAF8,stroke:#1B4F72;
    classDef test fill:#D5F5E3,stroke:#145A32;
    classDef util fill:#FCF3CF,stroke:#7D6608;
    classDef external fill:#E5E7E9,stroke:#6E2C00;
```
