# vandervv/seleniumprojectlive architecture

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

- Interactive diagram: https://gitdiagram.com/vandervv/seleniumprojectlive
- Repository: https://github.com/vandervv/seleniumprojectlive

## Overview

This repository is a Java Selenium/TestNG browser-automation framework. Its principal workflow is test setup creating a browser, tests using shared element actions to exercise a site, and teardown closing the browser; listeners and logging produce execution reports and screenshots. Configuration, locator parsing, retry handling, and reporting are supporting layers. The excerpts establish the framework’s internal calls, but the README is empty and test classes were not sampled, so test-to-framework invocation is not shown.

Main entry points: [`src/main/java/framework/actions/ElementActions.java`](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/actions/ElementActions.java) (Element actions), [`src/main/java/framework/reporting/StepLogger.java`](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/reporting/StepLogger.java) (Step logger), [`src/main/java/framework/listeners/TestListener.java`](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/listeners/TestListener.java) (Test listener), [`src/main/java/framework/config/Config.java`](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/config/Config.java) (Runtime config)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lifecycle["Test lifecycle"]
  node_testng(("TestNG tests"))
  node_base["Base test hooks<br/>[BaseTest.java]"]
  node_listener["Test listener<br/>[TestListener.java]"]
  node_transformer["Retry transformer"]
  node_retry["Retry analyzer<br/>[RetryAnalyzer.java]"]
end

subgraph group_browser["Browser automation"]
  node_actions["Element actions"]
  node_locators["Locator parser<br/>[Locators.java]"]
  node_driver["WebDriver factory<br/>[DriverFactory.java]"]
end

subgraph group_settings["Configuration"]
  node_config["Runtime config<br/>[Config.java]"]
  node_secrets["Secret handling<br/>[Secrets.java]"]
  node_properties["Config properties<br/>[config.properties]"]
end

subgraph group_reporting["Reporting"]
  node_extent["Extent manager<br/>[ExtentManager.java]"]
  node_step["Step logger<br/>[StepLogger.java]"]
  node_screenshot["Screenshot utility"]
  node_allure["Allure reporting"]
end

node_base -->|"starts and quits"| node_driver
node_base -->|"provides actions"| node_actions
node_transformer -->|"sets retry handler"| node_retry
node_retry -->|"reads retry count"| node_config
node_actions -->|"gets browser"| node_driver
node_actions -->|"reads settings"| node_config
node_actions -->|"parses locator strings"| node_locators
node_actions -->|"logs actions"| node_step
node_actions -->|"uses screenshots"| node_screenshot
node_config -->|"loads properties"| node_properties
node_listener -->|"reads settings"| node_config
node_listener -->|"checks browser"| node_driver
node_listener -->|"manages report lifecycle"| node_extent
node_listener -->|"captures test state"| node_screenshot
node_listener -->|"logs test data"| node_step
node_extent -->|"reads report settings"| node_config
node_screenshot -->|"captures browser"| node_driver
node_screenshot -->|"attaches image"| node_step
node_step -->|"writes report logs"| node_extent
node_step -->|"records steps and attachments"| node_allure
node_step -->|"masks sensitive text"| node_secrets
node_testng -.->|"extends hooks"| node_base

click node_testng "https://github.com/vandervv/seleniumprojectlive/tree/main/src/test/java/tests"
click node_base "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/base/BaseTest.java"
click node_listener "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/listeners/TestListener.java"
click node_transformer "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/listeners/RetryTransformer.java"
click node_retry "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/listeners/RetryAnalyzer.java"
click node_actions "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/actions/ElementActions.java"
click node_locators "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/actions/Locators.java"
click node_driver "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/driver/DriverFactory.java"
click node_config "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/config/Config.java"
click node_secrets "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/config/Secrets.java"
click node_properties "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/resources/config.properties"
click node_extent "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/reporting/ExtentManager.java"
click node_step "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/reporting/StepLogger.java"
click node_screenshot "https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/reporting/ScreenshotUtil.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_testng,node_base,node_listener,node_transformer,node_retry toneBlue
class node_actions,node_locators,node_driver toneAmber
class node_config,node_secrets,node_properties toneMint
class node_extent,node_step,node_screenshot,node_allure toneRose
```

## Components

### Test lifecycle

- [TestNG tests](https://github.com/vandervv/seleniumprojectlive/tree/main/src/test/java/tests): `src/test/java/tests`
- [Base test hooks](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/base/BaseTest.java): `src/main/java/framework/base/BaseTest.java`
- [Test listener](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/listeners/TestListener.java): `src/main/java/framework/listeners/TestListener.java`
- [Retry transformer](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/listeners/RetryTransformer.java): `src/main/java/framework/listeners/RetryTransformer.java`
- [Retry analyzer](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/listeners/RetryAnalyzer.java): `src/main/java/framework/listeners/RetryAnalyzer.java`

### Browser automation

- [Element actions](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/actions/ElementActions.java): `src/main/java/framework/actions/ElementActions.java`
- [Locator parser](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/actions/Locators.java): `src/main/java/framework/actions/Locators.java`
- [WebDriver factory](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/driver/DriverFactory.java): `src/main/java/framework/driver/DriverFactory.java`

### Configuration

- [Runtime config](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/config/Config.java): `src/main/java/framework/config/Config.java`
- [Secret handling](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/config/Secrets.java): `src/main/java/framework/config/Secrets.java`
- [Config properties](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/resources/config.properties): `src/main/resources/config.properties`

### Reporting

- [Extent manager](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/reporting/ExtentManager.java): `src/main/java/framework/reporting/ExtentManager.java`
- [Step logger](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/reporting/StepLogger.java): `src/main/java/framework/reporting/StepLogger.java`
- [Screenshot utility](https://github.com/vandervv/seleniumprojectlive/blob/main/src/main/java/framework/reporting/ScreenshotUtil.java): `src/main/java/framework/reporting/ScreenshotUtil.java`
- **Allure reporting**

## Connections

- Base test hooks → WebDriver factory: starts and quits (evidence: `src/main/java/framework/base/BaseTest.java`)
- Base test hooks → Element actions: provides actions (evidence: `src/main/java/framework/base/BaseTest.java`)
- Retry transformer → Retry analyzer: sets retry handler (evidence: `src/main/java/framework/listeners/RetryTransformer.java`)
- Retry analyzer → Runtime config: reads retry count (evidence: `src/main/java/framework/listeners/RetryAnalyzer.java`)
- Element actions → WebDriver factory: gets browser (evidence: `src/main/java/framework/actions/ElementActions.java`)
- Element actions → Runtime config: reads settings (evidence: `src/main/java/framework/actions/ElementActions.java`)
- Element actions → Locator parser: parses locator strings (evidence: `src/main/java/framework/actions/ElementActions.java`)
- Element actions → Step logger: logs actions (evidence: `src/main/java/framework/actions/ElementActions.java`)
- Element actions → Screenshot utility: uses screenshots (evidence: `src/main/java/framework/actions/ElementActions.java`)
- Runtime config → Config properties: loads properties (evidence: `src/main/java/framework/config/Config.java`)
- Test listener → Runtime config: reads settings (evidence: `src/main/java/framework/listeners/TestListener.java`)
- Test listener → WebDriver factory: checks browser (evidence: `src/main/java/framework/listeners/TestListener.java`)
- Test listener → Extent manager: manages report lifecycle (evidence: `src/main/java/framework/listeners/TestListener.java`)
- Test listener → Screenshot utility: captures test state (evidence: `src/main/java/framework/listeners/TestListener.java`)
- Test listener → Step logger: logs test data (evidence: `src/main/java/framework/listeners/TestListener.java`)
- Extent manager → Runtime config: reads report settings (evidence: `src/main/java/framework/reporting/ExtentManager.java`)
- Screenshot utility → WebDriver factory: captures browser (evidence: `src/main/java/framework/reporting/ScreenshotUtil.java`)
- Screenshot utility → Step logger: attaches image (evidence: `src/main/java/framework/reporting/ScreenshotUtil.java`)
- Step logger → Extent manager: writes report logs (evidence: `src/main/java/framework/reporting/StepLogger.java`)
- Step logger → Allure reporting: records steps and attachments (evidence: `src/main/java/framework/reporting/StepLogger.java`)
- Step logger → Secret handling: masks sensitive text (evidence: `src/main/java/framework/reporting/StepLogger.java`)
- TestNG tests → Base test hooks: extends hooks
