# muhammad-hossam/automationexerciseproject architecture

> Architecture diagram of the GitHub repository muhammad-hossam/automationexerciseproject, 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/automationexerciseproject
- Repository: https://github.com/muhammad-hossam/automationexerciseproject

## Overview

This repository is a Java/Selenium practice test-automation framework for exercising Automation Exercise website workflows, including registration, login, product browsing and checkout. Its runtime path is a test initiator using the GUI driver and page objects to interact with the site, with validations and TestNG listeners supporting execution and reporting. The graph includes the documented browser-factory and API capabilities; several relationships are based on the SOURCE INDEX rather than inspected implementation, so uncertain wiring is omitted.

Main entry points: [`src/main/java/com/automationexercices/drivers/GUIDriver.java`](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/drivers/GUIDriver.java) (GUI driver), [`src/main/java/com/automationexercices/pages/components/NavigationBarComponent.java`](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/components/NavigationBarComponent.java) (Navigation bar), [`src/main/java/com/automationexercices/listeners/TestNGListeners.java`](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/listeners/TestNGListeners.java) (TestNG listeners), [`src/main/java/com/automationexercices/validations/BaseAssertion.java`](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/validations/BaseAssertion.java) (Assertion base)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browser["Browser control"]
  node_gui["GUI driver<br/>[GUIDriver.java]"]
  node_browserfactory["Browser factories"]
  node_elementactions["Element actions"]
  node_waits["Wait manager<br/>[WaitManager.java]"]
end

subgraph group_flows["Website workflows"]
  node_navigation["Navigation bar"]
  node_account["Account pages<br/>[RegisterPage.java]"]
  node_products["Product browsing<br/>[ProductsPage.java]"]
  node_cart["Cart<br/>[CartPage.java]"]
  node_checkout["Checkout<br/>[CheckoutPage.java]"]
  node_payment["Payment<br/>[PaymentPage.java]"]
  node_otherpages["Other site pages"]
  node_api["User management API"]
  node_apibuilder["API builder<br/>[Builder.java]"]
end

subgraph group_support["Execution support"]
  node_validation["Validations<br/>[Validation.java]"]
  node_assertions["Assertion base<br/>[BaseAssertion.java]"]
  node_properties["Property reader"]
  node_files["File utilities<br/>[FileUtils.java]"]
end

subgraph group_reports["Reporting"]
  node_listeners["TestNG listeners"]
  node_screenshots["Screenshots"]
  node_attachments["Allure attachments"]
  node_environment["Allure environment"]
  node_binary["Allure binaries"]
  node_logs["Logging<br/>[LogsManager.java]"]
end

node_initiator(("Test initiator"))
node_site(("Automation Exercise"))

node_initiator -.->|"uses"| node_gui
node_gui -->|"creates driver"| node_browserfactory
node_gui -->|"provides actions"| node_elementactions
node_gui -->|"provides checks"| node_validation
node_elementactions -->|"uses waits"| node_waits
node_navigation -->|"uses driver"| node_gui
node_navigation -->|"opens"| node_products
node_navigation -->|"opens"| node_cart
node_navigation -->|"opens"| node_account
node_navigation -->|"opens"| node_otherpages
node_account -->|"uses driver"| node_gui
node_checkout -->|"uses driver"| node_gui
node_checkout -->|"uses payment"| node_payment
node_gui -.->|"drives browser"| node_site
node_api -->|"uses builder"| node_apibuilder
node_validation -->|"extends"| node_assertions
node_assertions -->|"uses waits"| node_waits
node_assertions -->|"checks files"| node_files
node_listeners -->|"captures"| node_screenshots
node_listeners -->|"attaches"| node_attachments
node_listeners -->|"sets environment"| node_environment
node_screenshots -->|"attaches image"| node_attachments
node_environment -->|"downloads"| node_binary
node_properties -->|"logs errors"| node_logs
node_listeners -->|"uses utilities"| node_files
node_listeners -->|"logs events"| node_logs
node_attachments -->|"logs errors"| node_logs
node_browserfactory -->|"reads settings"| node_properties

click node_gui "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/drivers/GUIDriver.java"
click node_browserfactory "https://github.com/muhammad-hossam/automationexerciseproject/tree/master/src/main/java/com/automationexercices/drivers"
click node_elementactions "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/Actions/ElementActions.java"
click node_waits "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/WaitManager.java"
click node_navigation "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/components/NavigationBarComponent.java"
click node_account "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/RegisterPage.java"
click node_products "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/ProductsPage.java"
click node_cart "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/CartPage.java"
click node_checkout "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/CheckoutPage.java"
click node_payment "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/PaymentPage.java"
click node_otherpages "https://github.com/muhammad-hossam/automationexerciseproject/tree/master/src/main/java/com/automationexercices/pages"
click node_api "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/apis/UserManagementAPI.java"
click node_apibuilder "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/apis/Builder.java"
click node_validation "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/validations/Validation.java"
click node_assertions "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/validations/BaseAssertion.java"
click node_properties "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/dataReader/PropertyReader.java"
click node_files "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/FileUtils.java"
click node_listeners "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/listeners/TestNGListeners.java"
click node_screenshots "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/media/ScreenshotsManager.java"
click node_attachments "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/report/AllureAttachmentManager.java"
click node_environment "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/report/AllureEnvironmentManager.java"
click node_binary "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/report/AllureBinaryManager.java"
click node_logs "https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/logs/LogsManager.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_gui,node_browserfactory,node_elementactions,node_waits toneBlue
class node_navigation,node_account,node_products,node_cart,node_checkout,node_payment,node_otherpages,node_api,node_apibuilder toneAmber
class node_validation,node_assertions,node_properties,node_files toneMint
class node_listeners,node_screenshots,node_attachments,node_environment,node_binary,node_logs toneRose
class node_initiator,node_site toneIndigo
```

## Components

### Browser control

- [GUI driver](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/drivers/GUIDriver.java): `src/main/java/com/automationexercices/drivers/GUIDriver.java`
- [Browser factories](https://github.com/muhammad-hossam/automationexerciseproject/tree/master/src/main/java/com/automationexercices/drivers): `src/main/java/com/automationexercices/drivers`
- [Element actions](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/Actions/ElementActions.java): `src/main/java/com/automationexercices/utils/Actions/ElementActions.java`
- [Wait manager](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/WaitManager.java): `src/main/java/com/automationexercices/utils/WaitManager.java`

### Website workflows

- [Navigation bar](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/components/NavigationBarComponent.java): `src/main/java/com/automationexercices/pages/components/NavigationBarComponent.java`
- [Account pages](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/RegisterPage.java): `src/main/java/com/automationexercices/pages/RegisterPage.java`
- [Product browsing](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/ProductsPage.java): `src/main/java/com/automationexercices/pages/ProductsPage.java`
- [Cart](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/CartPage.java): `src/main/java/com/automationexercices/pages/CartPage.java`
- [Checkout](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/CheckoutPage.java): `src/main/java/com/automationexercices/pages/CheckoutPage.java`
- [Payment](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/pages/PaymentPage.java): `src/main/java/com/automationexercices/pages/PaymentPage.java`
- [Other site pages](https://github.com/muhammad-hossam/automationexerciseproject/tree/master/src/main/java/com/automationexercices/pages): `src/main/java/com/automationexercices/pages`
- [User management API](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/apis/UserManagementAPI.java): `src/main/java/com/automationexercices/apis/UserManagementAPI.java`
- [API builder](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/apis/Builder.java): `src/main/java/com/automationexercices/apis/Builder.java`

### Execution support

- [Validations](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/validations/Validation.java): `src/main/java/com/automationexercices/validations/Validation.java`
- [Assertion base](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/validations/BaseAssertion.java): `src/main/java/com/automationexercices/validations/BaseAssertion.java`
- [Property reader](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/dataReader/PropertyReader.java): `src/main/java/com/automationexercices/utils/dataReader/PropertyReader.java`
- [File utilities](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/FileUtils.java): `src/main/java/com/automationexercices/FileUtils.java`

### Reporting

- [TestNG listeners](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/listeners/TestNGListeners.java): `src/main/java/com/automationexercices/listeners/TestNGListeners.java`
- [Screenshots](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/media/ScreenshotsManager.java): `src/main/java/com/automationexercices/media/ScreenshotsManager.java`
- [Allure attachments](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/report/AllureAttachmentManager.java): `src/main/java/com/automationexercices/utils/report/AllureAttachmentManager.java`
- [Allure environment](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/report/AllureEnvironmentManager.java): `src/main/java/com/automationexercices/utils/report/AllureEnvironmentManager.java`
- [Allure binaries](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/report/AllureBinaryManager.java): `src/main/java/com/automationexercices/utils/report/AllureBinaryManager.java`
- [Logging](https://github.com/muhammad-hossam/automationexerciseproject/blob/master/src/main/java/com/automationexercices/utils/logs/LogsManager.java): `src/main/java/com/automationexercices/utils/logs/LogsManager.java`

### Other components

- **Test initiator**
- **Automation Exercise**

## Connections

- Test initiator → GUI driver: uses
- GUI driver → Browser factories: creates driver (evidence: `src/main/java/com/automationexercices/drivers/GUIDriver.java`)
- GUI driver → Element actions: provides actions (evidence: `src/main/java/com/automationexercices/drivers/GUIDriver.java`)
- GUI driver → Validations: provides checks (evidence: `src/main/java/com/automationexercices/drivers/GUIDriver.java`)
- Element actions → Wait manager: uses waits (evidence: `src/main/java/com/automationexercices/utils/Actions/ElementActions.java`)
- Navigation bar → GUI driver: uses driver (evidence: `src/main/java/com/automationexercices/pages/components/NavigationBarComponent.java`)
- Navigation bar → Product browsing: opens (evidence: `src/main/java/com/automationexercices/pages/components/NavigationBarComponent.java`)
- Navigation bar → Cart: opens (evidence: `src/main/java/com/automationexercices/pages/components/NavigationBarComponent.java`)
- Navigation bar → Account pages: opens (evidence: `src/main/java/com/automationexercices/pages/components/NavigationBarComponent.java`)
- Navigation bar → Other site pages: opens (evidence: `src/main/java/com/automationexercices/pages/components/NavigationBarComponent.java`)
- Account pages → GUI driver: uses driver (evidence: `src/main/java/com/automationexercices/pages/RegisterPage.java`)
- Checkout → GUI driver: uses driver (evidence: `src/main/java/com/automationexercices/pages/CheckoutPage.java`)
- Checkout → Payment: uses payment (evidence: `src/main/java/com/automationexercices/pages/CheckoutPage.java`)
- GUI driver → Automation Exercise: drives browser
- User management API → API builder: uses builder (evidence: `src/main/java/com/automationexercices/apis/UserManagementAPI.java`)
- Validations → Assertion base: extends (evidence: `src/main/java/com/automationexercices/validations/Validation.java`)
- Assertion base → Wait manager: uses waits (evidence: `src/main/java/com/automationexercices/validations/BaseAssertion.java`)
- Assertion base → File utilities: checks files (evidence: `src/main/java/com/automationexercices/validations/BaseAssertion.java`)
- TestNG listeners → Screenshots: captures (evidence: `src/main/java/com/automationexercices/listeners/TestNGListeners.java`)
- TestNG listeners → Allure attachments: attaches (evidence: `src/main/java/com/automationexercices/listeners/TestNGListeners.java`)
- TestNG listeners → Allure environment: sets environment (evidence: `src/main/java/com/automationexercices/listeners/TestNGListeners.java`)
- Screenshots → Allure attachments: attaches image (evidence: `src/main/java/com/automationexercices/media/ScreenshotsManager.java`)
- Allure environment → Allure binaries: downloads (evidence: `src/main/java/com/automationexercices/utils/report/AllureEnvironmentManager.java`)
- Property reader → Logging: logs errors (evidence: `src/main/java/com/automationexercices/utils/dataReader/PropertyReader.java`)
- TestNG listeners → File utilities: uses utilities (evidence: `src/main/java/com/automationexercices/listeners/TestNGListeners.java`)
- TestNG listeners → Logging: logs events (evidence: `src/main/java/com/automationexercices/listeners/TestNGListeners.java`)
- Allure attachments → Logging: logs errors (evidence: `src/main/java/com/automationexercices/utils/report/AllureAttachmentManager.java`)
- Browser factories → Property reader: reads settings (evidence: `src/main/java/com/automationexercices/drivers/ChromeFactory.java`)
