# disomimba/seleniumframeworktestcaseautomation architecture

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

- Interactive diagram: https://gitdiagram.com/disomimba/seleniumframeworktestcaseautomation
- Repository: https://github.com/disomimba/seleniumframeworktestcaseautomation

## Overview

This repository is a Selenium/TestNG end-to-end test framework for Automation Exercise. Its workflow runs regression cases against a browser, uses page-event classes to perform and verify user actions through page-object locators, and produces HTML reports with screenshots. The README documents registration, login, cart and checkout, and contact-form coverage; sampled source also shows product search, categories, brands, reviews, and subscriptions. Edges are limited to relationships visible in the README or source index/excerpts; the test-case implementation was not sampled.

Main entry points: [`TestCaseAutomation/src/main/java/base/BaseTest.java`](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/base/BaseTest.java) (Browser and test base), [`TestCaseAutomation/src/main/java/pageEvents/productsEventPage.java`](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/productsEventPage.java) (Product workflows), [`TestCaseAutomation/src/main/java/pageEvents/mainPageEvents.java`](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/mainPageEvents.java) (Home navigation), [`TestCaseAutomation/src/main/java/pageEvents/registerPageEvents.java`](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/registerPageEvents.java) (Registration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Test execution"]
  node_cases["Regression cases<br/>[TestCases.java]"]
end

subgraph group_flows["User workflows"]
  node_mainflow["Home navigation"]
  node_products["Product workflows"]
  node_registration["Registration"]
  node_login["Login"]
  node_cart["Cart operations"]
  node_contact["Contact form"]
end

subgraph group_locators["Page locators"]
  node_home_locators["Home locators"]
  node_product_locators["Product locators"]
  node_cart_locators["Cart locators"]
  node_register_locators["Registration locators"]
  node_login_locators["Login locators"]
  node_contact_locators["Contact locators"]
end

subgraph group_support["Browser and reporting"]
  node_base["Browser and test base<br/>[BaseTest.java]"]
  node_fetch["Element fetch<br/>[ElementFetch.java]"]
  node_constants["Test constants<br/>[Constants.java]"]
  node_retry["Retry analyzer<br/>[RetryAnalyzer.java]"]
  node_listener["Suite listener<br/>[SuiteListener.java]"]
  node_reports["HTML reports"]
end

node_runner(("Test runner"))
node_browser(("Web browser"))

node_runner -->|"runs"| node_cases
node_base -->|"drives"| node_browser
node_base -->|"uses"| node_fetch
node_base -->|"reads URL"| node_constants
node_base -->|"writes reports"| node_reports
node_listener -->|"registers"| node_retry
node_mainflow -->|"extends"| node_base
node_mainflow -->|"uses"| node_home_locators
node_products -->|"extends"| node_base
node_products -->|"calls"| node_mainflow
node_products -->|"uses"| node_product_locators
node_products -->|"uses"| node_cart_locators
node_registration -->|"extends"| node_base
node_registration -->|"calls"| node_mainflow
node_registration -->|"uses"| node_register_locators
node_login -->|"extends"| node_base
node_login -->|"uses"| node_login_locators
node_cart -->|"extends"| node_base
node_cart -->|"uses"| node_cart_locators
node_contact -->|"extends"| node_base
node_contact -->|"uses"| node_contact_locators

click node_cases "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/test/java/regression/TestCases.java"
click node_base "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/base/BaseTest.java"
click node_fetch "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/utils/ElementFetch.java"
click node_constants "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/utils/Constants.java"
click node_retry "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/utils/RetryAnalyzer.java"
click node_listener "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/utils/SuiteListener.java"
click node_reports "https://github.com/disomimba/seleniumframeworktestcaseautomation/tree/main/TestCaseAutomation/Reports"
click node_mainflow "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/mainPageEvents.java"
click node_products "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/productsEventPage.java"
click node_registration "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/registerPageEvents.java"
click node_login "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/loginPageEvents.java"
click node_cart "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/cartPageEvents.java"
click node_contact "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/contactPageEvents.java"
click node_home_locators "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/mainPageElements.java"
click node_product_locators "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/productsPageElements.java"
click node_cart_locators "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/cartPageElements.java"
click node_register_locators "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/registerPageElements.java"
click node_login_locators "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/loginPageElements.java"
click node_contact_locators "https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/contactPageElements.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_cases,node_browser toneBlue
class node_mainflow,node_products,node_registration,node_login,node_cart,node_contact toneAmber
class node_home_locators,node_product_locators,node_cart_locators,node_register_locators,node_login_locators,node_contact_locators toneMint
class node_base,node_fetch,node_constants,node_retry,node_listener,node_reports toneRose
class node_runner toneIndigo
```

## Components

### Test execution

- [Regression cases](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/test/java/regression/TestCases.java): `TestCaseAutomation/src/test/java/regression/TestCases.java`

### User workflows

- [Home navigation](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/mainPageEvents.java): `TestCaseAutomation/src/main/java/pageEvents/mainPageEvents.java`
- [Product workflows](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/productsEventPage.java): `TestCaseAutomation/src/main/java/pageEvents/productsEventPage.java`
- [Registration](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/registerPageEvents.java): `TestCaseAutomation/src/main/java/pageEvents/registerPageEvents.java`
- [Login](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/loginPageEvents.java): `TestCaseAutomation/src/main/java/pageEvents/loginPageEvents.java`
- [Cart operations](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/cartPageEvents.java): `TestCaseAutomation/src/main/java/pageEvents/cartPageEvents.java`
- [Contact form](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageEvents/contactPageEvents.java): `TestCaseAutomation/src/main/java/pageEvents/contactPageEvents.java`

### Page locators

- [Home locators](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/mainPageElements.java): `TestCaseAutomation/src/main/java/pageObjects/mainPageElements.java`
- [Product locators](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/productsPageElements.java): `TestCaseAutomation/src/main/java/pageObjects/productsPageElements.java`
- [Cart locators](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/cartPageElements.java): `TestCaseAutomation/src/main/java/pageObjects/cartPageElements.java`
- [Registration locators](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/registerPageElements.java): `TestCaseAutomation/src/main/java/pageObjects/registerPageElements.java`
- [Login locators](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/loginPageElements.java): `TestCaseAutomation/src/main/java/pageObjects/loginPageElements.java`
- [Contact locators](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/pageObjects/contactPageElements.java): `TestCaseAutomation/src/main/java/pageObjects/contactPageElements.java`

### Browser and reporting

- [Browser and test base](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/base/BaseTest.java): `TestCaseAutomation/src/main/java/base/BaseTest.java`
- [Element fetch](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/utils/ElementFetch.java): `TestCaseAutomation/src/main/java/utils/ElementFetch.java`
- [Test constants](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/utils/Constants.java): `TestCaseAutomation/src/main/java/utils/Constants.java`
- [Retry analyzer](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/utils/RetryAnalyzer.java): `TestCaseAutomation/src/main/java/utils/RetryAnalyzer.java`
- [Suite listener](https://github.com/disomimba/seleniumframeworktestcaseautomation/blob/main/TestCaseAutomation/src/main/java/utils/SuiteListener.java): `TestCaseAutomation/src/main/java/utils/SuiteListener.java`
- [HTML reports](https://github.com/disomimba/seleniumframeworktestcaseautomation/tree/main/TestCaseAutomation/Reports): `TestCaseAutomation/Reports`

### Other components

- **Test runner**
- **Web browser**

## Connections

- Test runner → Regression cases: runs (evidence: `README.md`)
- Browser and test base → Web browser: drives (evidence: `TestCaseAutomation/src/main/java/base/BaseTest.java`)
- Browser and test base → Element fetch: uses (evidence: `TestCaseAutomation/src/main/java/base/BaseTest.java`)
- Browser and test base → Test constants: reads URL (evidence: `TestCaseAutomation/src/main/java/base/BaseTest.java`)
- Browser and test base → HTML reports: writes reports (evidence: `TestCaseAutomation/src/main/java/base/BaseTest.java`)
- Suite listener → Retry analyzer: registers (evidence: `TestCaseAutomation/src/main/java/utils/SuiteListener.java`)
- Home navigation → Browser and test base: extends (evidence: `TestCaseAutomation/src/main/java/pageEvents/mainPageEvents.java`)
- Home navigation → Home locators: uses (evidence: `TestCaseAutomation/src/main/java/pageEvents/mainPageEvents.java`)
- Product workflows → Browser and test base: extends (evidence: `TestCaseAutomation/src/main/java/pageEvents/productsEventPage.java`)
- Product workflows → Home navigation: calls (evidence: `TestCaseAutomation/src/main/java/pageEvents/productsEventPage.java`)
- Product workflows → Product locators: uses (evidence: `TestCaseAutomation/src/main/java/pageEvents/productsEventPage.java`)
- Product workflows → Cart locators: uses (evidence: `TestCaseAutomation/src/main/java/pageEvents/productsEventPage.java`)
- Registration → Browser and test base: extends (evidence: `TestCaseAutomation/src/main/java/pageEvents/registerPageEvents.java`)
- Registration → Home navigation: calls (evidence: `TestCaseAutomation/src/main/java/pageEvents/registerPageEvents.java`)
- Registration → Registration locators: uses (evidence: `TestCaseAutomation/src/main/java/pageEvents/registerPageEvents.java`)
- Login → Browser and test base: extends (evidence: `TestCaseAutomation/src/main/java/pageEvents/loginPageEvents.java`)
- Login → Login locators: uses (evidence: `TestCaseAutomation/src/main/java/pageEvents/loginPageEvents.java`)
- Cart operations → Browser and test base: extends (evidence: `TestCaseAutomation/src/main/java/pageEvents/cartPageEvents.java`)
- Cart operations → Cart locators: uses (evidence: `TestCaseAutomation/src/main/java/pageEvents/cartPageEvents.java`)
- Contact form → Browser and test base: extends (evidence: `TestCaseAutomation/src/main/java/pageEvents/contactPageEvents.java`)
- Contact form → Contact locators: uses (evidence: `TestCaseAutomation/src/main/java/pageEvents/contactPageEvents.java`)
