# dpaktester/mi_bdd_flipkart_ex architecture

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

- Interactive diagram: https://gitdiagram.com/dpaktester/mi_bdd_flipkart_ex
- Repository: https://github.com/dpaktester/mi_bdd_flipkart_ex

## Overview

##### Project Type & Purpose
- This is a **Selenium-based UI automation framework** built in Java using Maven, Cucumber, TestNG and Extent Reports.
- Purpose: provide reusable helper methods (ElementUtil), implement the Page-Object Model, execute feature-based tests (Gherkin) and generate HTML/PDF test reports.

##### File Structure Analysis
- **Top-level files**
- pom.xml (Maven configuration)
- testng.xml (TestNG suite)
- README.md
- lib/*.jar (external utility JARs)
- **src/main/java**
- factory/DriverFactory.java – initializes WebDriver instances
- pages/*.java – Page Object classes (LoginPage etc.)
- utilities/*.java – ConfigReader, Constants, PasswordEncryption, **ElementUtil**
- **src/test/java**
- applicationhooks/AppHooks.java – lifecycle hooks (before/after scenarios)
- stepdefinitions/SmokeTestSteps.java – Cucumber step mappings
- testrunners/TestRunner.java – Cucumber + TestNG runner
- **src/test/resources**
- features/*.feature – Gherkin feature files
- config/config.properties – environment settings
- cucumber.properties, logback.xml, extent-config.xml, pdf-config.yaml
- **Output folders**
- CucumberExtent-Reports & test-output-thread – Spark & PDF/HTML reports
- test-output-thread/* – TestNG default HTML report

##### README Insights
- **ElementUtil**: Core reusable Selenium methods (click, waits, file upload/download, dropdowns, JS executor, window/frame handling, advanced interactions, etc.)
- Emphasis on **simplifying web automation** and providing a comprehensive toolkit for tests.

##### Diagramming the Architecture
a. **Main Components**
- Test Runner (TestNG + Cucumber)
- Gherkin Feature Files
- Step Definitions
- Application Hooks (before/after)
- Page Objects
- ElementUtil & Utility Classes
- DriverFactory (WebDriver manager)
- Browser Driver (ChromeDriver/GeckoDriver)
- External Config & Resource Files
- Report Generators (Spark, PDF, TestNG)
b. **Relationships & Data Flow**
1. TestRunner picks up *.feature files.
2. Cucumber engine parses scenarios and invokes StepDefinitions.
3. StepDefinitions call PageObjects + ElementUtil methods.
4. DriverFactory supplies WebDriver → communicates with Browser (Chrome/Firefox).
5. Utilities (ConfigReader, Constants) supply test data & timeouts.
6. Application Hooks manage setup/teardown (driver init, report start/end).
7. Reports are collected & written via Extent/Spark/PDF modules.
c. **Architectural Patterns**
- **Page Object Model**: separates page structure & actions into classes.
- **Factory Pattern**: DriverFactory abstracts browser initialization.
- **Layered Design**:
1. **Presentation** (Gherkin features)
2. **Glue** (StepDefinitions)
3. **Domain** (PageObjects & ElementUtil)
4. **Infrastructure** (DriverFactory, ConfigReader)
5. **Reporting** (Extent, PDF)
d. **Key Technologies**
- Java, Maven, TestNG, Cucumber
- Selenium WebDriver
- ExtentReports & Spark
- Logback, PDF generation (YAML config)
- ConfigReader (properties file)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer"
        Features["Gherkin Feature Files"]:::external
    end

    %% Glue Layer
    subgraph "Glue Layer"
        Runner["Test Runner\n(TestNG + Cucumber)"]:::testExec
        TestNGConf["TestNG Suite\n(testng.xml)"]:::testExec
        Hooks["Application Hooks"]:::testExec
        Steps["Step Definitions"]:::testExec
    end

    %% Domain Layer
    subgraph "Domain Layer"
        PageObj["Page Objects\n(LoginPage)"]:::logic
        ElementUtil["ElementUtil Library"]:::logic
    end

    %% Infrastructure Layer
    subgraph "Infrastructure Layer"
        DriverFactory["WebDriver Factory"]:::infra
        ConfigReader["ConfigReader"]:::infra
        Constants["Constants"]:::infra
        PasswordEnc["PasswordEncryption"]:::infra
        ConfigFiles["External Config & Resource Files"]:::external
    end

    %% Reporting Layer
    subgraph "Reporting Layer"
        Reports["Report Generators\n(HTML/PDF/Spark)"]:::external
    end

    %% External Systems
    subgraph "External Systems"
        Browser["Browser Driver\n(ChromeDriver/GeckoDriver)"]:::external
        Maven["Maven Project\n(pom.xml)"]:::external
        LibJars["External JAR Dependencies\n(lib/*.jar)"]:::external
    end

    %% Connections
    Features -->|parsed by| Runner
    Runner -->|uses| TestNGConf
    Runner -->|triggers| Hooks
    Runner -->|invokes| Steps
    Hooks -->|initializes| DriverFactory
    Hooks -->|finalizes setup/teardown| Reports
    DriverFactory -->|provides WebDriver| Browser
    DriverFactory -->|reads| ConfigReader
    Hooks -->|sets WebDriver in| PageObj
    Steps -->|calls| PageObj
    Steps -->|uses| ElementUtil
    PageObj -->|utilizes| ElementUtil
    ElementUtil -->|reads config| ConfigReader
    ConfigReader -->|loads| ConfigFiles
    Runner -->|generates results| Reports
    Maven -->|manages| LibJars
    Maven -->|build & triggers| Runner

    %% Click Events
    click Runner "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/src/test/java/testrunners/TestRunner.java"
    click TestNGConf "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/testng.xml"
    click Features "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/src/test/resources/features/SmokeTest.feature"
    click Steps "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/src/test/java/stepdefinitions/SmokeTestSteps.java"
    click Hooks "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/src/test/java/applicationhooks/AppHooks.java"
    click PageObj "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/src/main/java/pages/LoginPage.java"
    click DriverFactory "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/src/main/java/factory/DriverFactory.java"
    click ElementUtil "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/lib/ElementUtil.jar"
    click ConfigReader "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/src/main/java/utilities/ConfigReader.java"
    click Constants "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/src/main/java/utilities/Constants.java"
    click PasswordEnc "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/src/main/java/utilities/PasswordEncryption.java"
    click ConfigFiles "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/src/test/resources/config/config.properties"
    click Maven "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/pom.xml"
    click LibJars "https://github.com/dpaktester/mi_bdd_flipkart_ex/blob/master/lib/*.jar"

    %% Styles
    classDef testExec fill:#e0f7fa,stroke:#000,stroke-width:1px
    classDef logic fill:#e8f5e9,stroke:#000,stroke-width:1px
    classDef infra fill:#fff3e0,stroke:#000,stroke-width:1px
    classDef external fill:#f3e5f5,stroke:#000,stroke-width:1px
```
