# muhammad-hossam/wolfix-store-test-automation-project architecture

> Architecture diagram of the GitHub repository muhammad-hossam/wolfix-store-test-automation-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/muhammad-hossam/wolfix-store-test-automation-project
- Repository: https://github.com/muhammad-hossam/wolfix-store-test-automation-project

## Overview

This is a Java/Selenium UI and end-to-end test automation framework. Its principal workflow is to create a configured browser driver, use page objects and browser actions to exercise store journeys, validate outcomes, and capture failure evidence for TestNG/Allure reporting. The README also documents multi-browser execution, JSON data-driven tests, logging, waits, and screenshots. Source excerpts and the index support several internal dependencies; unsampled page, listener, and reporting behavior is included only where documented or indexed, so some relationships are omitted.

Main entry points: [`src/main/java/com/graduationproject/pages`](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/tree/master/src/main/java/com/graduationproject/pages) (Page objects), [`src/main/java/com/graduationproject/listeners/TestNGListeners.java`](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/listeners/TestNGListeners.java) (TestNG listeners), [`src/main/java/com/graduationproject/media/ScreenshotsManager.java`](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/media/ScreenshotsManager.java) (Screenshots), [`src/main/java/com/graduationproject/engine/report/AllureBinaryManager.java`](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/report/AllureBinaryManager.java) (Allure binary setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_execution["Test execution"]
  node_listeners["TestNG listeners"]
end

subgraph group_browser["Browser automation"]
  node_driver["Driver setup<br/>[GUIDriver.java]"]
  node_driverfactory["Browser factories"]
  node_actions["Browser actions"]
end

subgraph group_journeys["Store journeys"]
  node_pages["Page objects"]
  node_navigation["Navigation bar"]
  node_loginapi["Login API<br/>[LoginApi.java]"]
  node_api_model["API data model<br/>[POJO.java]"]
end

subgraph group_support["Automation support"]
  node_waits["Wait strategies<br/>[WaitManager.java]"]
  node_data["Data readers"]
  node_fileutils["File utilities<br/>[FileUtils.java]"]
  node_assertions["Assertions<br/>[BaseAssertion.java]"]
  node_validation["Validation API<br/>[Validation.java]"]
  node_time["Time utilities<br/>[TimeManager.java]"]
  node_os["OS utilities<br/>[OSUtils.java]"]
  node_terminal["Terminal commands<br/>[TerminalUtils.java]"]
end

subgraph group_observability["Evidence and reporting"]
  node_screenshots["Screenshots"]
  node_attachments["Allure attachments"]
  node_allure_env["Report environment"]
  node_allure_binary["Allure binary setup"]
  node_logs["Logging<br/>[LogsManager.java]"]
end

node_tester(("Test author"))
node_store["Store under test"]

node_tester -.->|"starts tests"| node_listeners
node_listeners -->|"captures failures"| node_screenshots
node_listeners -->|"adds evidence"| node_attachments
node_listeners -->|"sets environment"| node_allure_env
node_listeners -->|"uses validation"| node_validation
node_driver -->|"creates driver"| node_driverfactory
node_driver -->|"exposes actions"| node_actions
node_driver -->|"exposes checks"| node_validation
node_actions -->|"waits for elements"| node_waits
node_pages -->|"uses browser driver"| node_driver
node_pages -->|"reads properties"| node_data
node_pages -.->|"drives UI"| node_store
node_navigation -->|"references pages"| node_pages
node_pages -->|"opens checkout"| node_pages
node_loginapi -.->|"uses model"| node_api_model
node_screenshots -->|"timestamps files"| node_time
node_screenshots -->|"attaches screenshots"| node_attachments
node_screenshots -->|"logs capture status"| node_logs
node_assertions -->|"waits for checks"| node_waits
node_assertions -->|"uses element actions"| node_actions
node_validation -->|"extends assertions"| node_assertions
node_data -->|"logs reader errors"| node_logs
node_data -->|"references file utilities"| node_fileutils
node_allure_env -->|"downloads binaries"| node_allure_binary
node_allure_binary -->|"checks platform"| node_os
node_allure_binary -->|"runs commands"| node_terminal
node_allure_binary -->|"logs setup"| node_logs
node_attachments -->|"logs attachment errors"| node_logs

click node_listeners "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/listeners/TestNGListeners.java"
click node_driver "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/drivers/GUIDriver.java"
click node_driverfactory "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/tree/master/src/main/java/com/graduationproject/drivers"
click node_actions "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/tree/master/src/main/java/com/graduationproject/engine/Actions"
click node_waits "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/WaitManager.java"
click node_pages "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/tree/master/src/main/java/com/graduationproject/pages"
click node_navigation "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/pages/components/NavigationBarComponent.java"
click node_loginapi "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/apis/LoginApi.java"
click node_api_model "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/apis/POJO.java"
click node_data "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/tree/master/src/main/java/com/graduationproject/engine/dataReader"
click node_fileutils "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/FileUtils.java"
click node_assertions "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/validations/BaseAssertion.java"
click node_validation "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/validations/Validation.java"
click node_screenshots "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/media/ScreenshotsManager.java"
click node_attachments "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/report/AllureAttachmentManager.java"
click node_allure_env "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/report/AllureEnvironmentManager.java"
click node_allure_binary "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/report/AllureBinaryManager.java"
click node_logs "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/logs/LogsManager.java"
click node_time "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/TimeManager.java"
click node_os "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/OSUtils.java"
click node_terminal "https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/TerminalUtils.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_listeners toneBlue
class node_driver,node_driverfactory,node_actions toneAmber
class node_pages,node_navigation,node_loginapi,node_api_model toneMint
class node_waits,node_data,node_fileutils,node_assertions,node_validation,node_time,node_os,node_terminal toneRose
class node_screenshots,node_attachments,node_allure_env,node_allure_binary,node_logs,node_tester,node_store toneIndigo
```

## Components

### Test execution

- [TestNG listeners](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/listeners/TestNGListeners.java): `src/main/java/com/graduationproject/listeners/TestNGListeners.java`

### Browser automation

- [Driver setup](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/drivers/GUIDriver.java): `src/main/java/com/graduationproject/drivers/GUIDriver.java`
- [Browser factories](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/tree/master/src/main/java/com/graduationproject/drivers): `src/main/java/com/graduationproject/drivers`
- [Browser actions](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/tree/master/src/main/java/com/graduationproject/engine/Actions): `src/main/java/com/graduationproject/engine/Actions`

### Store journeys

- [Page objects](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/tree/master/src/main/java/com/graduationproject/pages): `src/main/java/com/graduationproject/pages`
- [Navigation bar](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/pages/components/NavigationBarComponent.java): `src/main/java/com/graduationproject/pages/components/NavigationBarComponent.java`
- [Login API](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/apis/LoginApi.java): `src/main/java/com/graduationproject/apis/LoginApi.java`
- [API data model](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/apis/POJO.java): `src/main/java/com/graduationproject/apis/POJO.java`

### Automation support

- [Wait strategies](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/WaitManager.java): `src/main/java/com/graduationproject/engine/WaitManager.java`
- [Data readers](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/tree/master/src/main/java/com/graduationproject/engine/dataReader): `src/main/java/com/graduationproject/engine/dataReader`
- [File utilities](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/FileUtils.java): `src/main/java/com/graduationproject/FileUtils.java`
- [Assertions](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/validations/BaseAssertion.java): `src/main/java/com/graduationproject/validations/BaseAssertion.java`
- [Validation API](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/validations/Validation.java): `src/main/java/com/graduationproject/validations/Validation.java`
- [Time utilities](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/TimeManager.java): `src/main/java/com/graduationproject/engine/TimeManager.java`
- [OS utilities](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/OSUtils.java): `src/main/java/com/graduationproject/engine/OSUtils.java`
- [Terminal commands](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/TerminalUtils.java): `src/main/java/com/graduationproject/engine/TerminalUtils.java`

### Evidence and reporting

- [Screenshots](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/media/ScreenshotsManager.java): `src/main/java/com/graduationproject/media/ScreenshotsManager.java`
- [Allure attachments](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/report/AllureAttachmentManager.java): `src/main/java/com/graduationproject/engine/report/AllureAttachmentManager.java`
- [Report environment](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/report/AllureEnvironmentManager.java): `src/main/java/com/graduationproject/engine/report/AllureEnvironmentManager.java`
- [Allure binary setup](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/report/AllureBinaryManager.java): `src/main/java/com/graduationproject/engine/report/AllureBinaryManager.java`
- [Logging](https://github.com/muhammad-hossam/wolfix-store-test-automation-project/blob/master/src/main/java/com/graduationproject/engine/logs/LogsManager.java): `src/main/java/com/graduationproject/engine/logs/LogsManager.java`

### Other components

- **Test author**
- **Store under test**

## Connections

- Test author → TestNG listeners: starts tests (evidence: `README.md`)
- TestNG listeners → Screenshots: captures failures (evidence: `src/main/java/com/graduationproject/listeners/TestNGListeners.java`)
- TestNG listeners → Allure attachments: adds evidence (evidence: `src/main/java/com/graduationproject/listeners/TestNGListeners.java`)
- TestNG listeners → Report environment: sets environment (evidence: `src/main/java/com/graduationproject/listeners/TestNGListeners.java`)
- TestNG listeners → Validation API: uses validation (evidence: `src/main/java/com/graduationproject/listeners/TestNGListeners.java`)
- Driver setup → Browser factories: creates driver (evidence: `src/main/java/com/graduationproject/drivers/GUIDriver.java`)
- Driver setup → Browser actions: exposes actions (evidence: `src/main/java/com/graduationproject/drivers/GUIDriver.java`)
- Driver setup → Validation API: exposes checks (evidence: `src/main/java/com/graduationproject/drivers/GUIDriver.java`)
- Browser actions → Wait strategies: waits for elements (evidence: `src/main/java/com/graduationproject/engine/Actions/ElementActions.java`)
- Page objects → Driver setup: uses browser driver (evidence: `src/main/java/com/graduationproject/pages/CartPage.java`)
- Page objects → Data readers: reads properties (evidence: `src/main/java/com/graduationproject/pages/CartPage.java`)
- Page objects → Store under test: drives UI (evidence: `README.md`)
- Navigation bar → Page objects: references pages (evidence: `src/main/java/com/graduationproject/pages/components/NavigationBarComponent.java`)
- Page objects → Page objects: opens checkout (evidence: `src/main/java/com/graduationproject/pages/CartPage.java`)
- Login API → API data model: uses model
- Screenshots → Time utilities: timestamps files (evidence: `src/main/java/com/graduationproject/media/ScreenshotsManager.java`)
- Screenshots → Allure attachments: attaches screenshots (evidence: `src/main/java/com/graduationproject/media/ScreenshotsManager.java`)
- Screenshots → Logging: logs capture status (evidence: `src/main/java/com/graduationproject/media/ScreenshotsManager.java`)
- Assertions → Wait strategies: waits for checks (evidence: `src/main/java/com/graduationproject/validations/BaseAssertion.java`)
- Assertions → Browser actions: uses element actions (evidence: `src/main/java/com/graduationproject/validations/BaseAssertion.java`)
- Validation API → Assertions: extends assertions (evidence: `src/main/java/com/graduationproject/validations/Validation.java`)
- Data readers → Logging: logs reader errors (evidence: `src/main/java/com/graduationproject/engine/dataReader/PropertyReader.java`)
- Data readers → File utilities: references file utilities (evidence: `src/main/java/com/graduationproject/engine/dataReader/PropertyReader.java`)
- Report environment → Allure binary setup: downloads binaries (evidence: `src/main/java/com/graduationproject/engine/report/AllureEnvironmentManager.java`)
- Allure binary setup → OS utilities: checks platform (evidence: `src/main/java/com/graduationproject/engine/report/AllureBinaryManager.java`)
- Allure binary setup → Terminal commands: runs commands (evidence: `src/main/java/com/graduationproject/engine/report/AllureBinaryManager.java`)
- Allure binary setup → Logging: logs setup (evidence: `src/main/java/com/graduationproject/engine/report/AllureBinaryManager.java`)
- Allure attachments → Logging: logs attachment errors (evidence: `src/main/java/com/graduationproject/engine/report/AllureAttachmentManager.java`)
