# vgebrych/qa-automation-java architecture

> Architecture diagram of the GitHub repository vgebrych/qa-automation-java, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vgebrych/qa-automation-java
- Repository: https://github.com/vgebrych/qa-automation-java

## Overview

This is a Java QA automation project for AutomationExercise, with API automation as its documented current focus and browser-based UI automation also represented in the source tree. The API workflow builds requests through shared client infrastructure and exercises account, product, and brand capabilities; UI page objects model navigation, signup, products, cart, and contact flows. The graph emphasizes runtime page objects and API clients rather than test harnesses. Some UI capabilities are documented or indexed but unsampled, so only indexed or excerpt-supported relationships are shown.

Main entry points: [`src/main/java/pageobjects/api/client/UserApiClient.java`](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/client/UserApiClient.java) (Account API), [`src/main/java/pageobjects/ui/pom/Header.java`](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/Header.java) (Site navigation), [`src/main/java/pageobjects/api/client/ProductsApiClient.java`](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/client/ProductsApiClient.java) (Products API), [`src/main/java/pageobjects/api/client/BrandsApiClient.java`](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/client/BrandsApiClient.java) (Brands API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API automation"]
  node_userclient["Account API<br/>[UserApiClient.java]"]
  node_productclient["Products API"]
  node_brandclient["Brands API"]
  node_baseclient["HTTP client base<br/>[BaseApiClient.java]"]
end

subgraph group_models["API domain models"]
  node_userfactory["User data factory<br/>[UserFactory.java]"]
  node_userrequest["Account request<br/>[UserRequest.java]"]
  node_userresponse["Account response<br/>[User.java]"]
  node_productmodel["Product model<br/>[Product.java]"]
  node_responseproducts["Product response"]
  node_brandmodel["Brand model<br/>[Brand.java]"]
  node_responsebrands["Brand response"]
end

subgraph group_ui["Browser page objects"]
  node_home["Home page<br/>[HomePage.java]"]
  node_header["Site navigation<br/>[Header.java]"]
  node_signup["Signup login"]
  node_accountinfo["Signup details"]
  node_created["Account created"]
  node_productsui["Products browsing<br/>[ProductsPage.java]"]
  node_detail["Product details"]
  node_cart["Shopping cart<br/>[CartPage.java]"]
  node_contact["Contact us<br/>[ContactUsPage.java]"]
  node_basepage["Page base<br/>[BasePage.java]"]
  node_footer["Site footer<br/>[Footer.java]"]
end

subgraph group_shared["Shared runtime"]
  node_spec["API specifications"]
  node_config["Configuration reader<br/>[ConfigReader.java]"]
  node_actions["Element actions"]
end

node_tester(("Test initiator"))
node_service{{"AutomationExercise"}}

node_tester -.->|"runs API checks"| node_userclient
node_tester -.->|"runs API checks"| node_productclient
node_tester -.->|"runs API checks"| node_brandclient
node_userclient -->|"sends account requests"| node_service
node_productclient -.->|"sends product requests"| node_service
node_brandclient -.->|"sends brand requests"| node_service
node_userclient -->|"uses HTTP methods"| node_baseclient
node_productclient -->|"inherits requests"| node_baseclient
node_brandclient -->|"inherits requests"| node_baseclient
node_baseclient -->|"uses specifications"| node_spec
node_spec -->|"reads settings"| node_config
node_userclient -->|"serializes users"| node_userfactory
node_userfactory -->|"creates and maps"| node_userrequest
node_userclient -->|"accepts account data"| node_userrequest
node_userclient -->|"deserializes details"| node_userresponse
node_productclient -->|"returns product data"| node_responseproducts
node_responseproducts -->|"contains products"| node_productmodel
node_brandclient -->|"returns brand data"| node_responsebrands
node_responsebrands -->|"contains brands"| node_brandmodel
node_tester -.->|"drives browser flows"| node_home
node_home -->|"reads site address"| node_config
node_basepage -->|"creates navigation"| node_header
node_basepage -->|"creates footer"| node_footer
node_basepage -->|"inherits actions"| node_actions
node_header -->|"opens products"| node_productsui
node_header -->|"opens cart"| node_cart
node_header -->|"opens signup"| node_signup
node_header -->|"opens contact"| node_contact
node_signup -->|"opens details form"| node_accountinfo
node_accountinfo -->|"fills account fields"| node_userrequest
node_accountinfo -->|"submits account"| node_created
node_productsui -->|"opens product detail"| node_detail
node_productsui -->|"uses product data"| node_productmodel
node_detail -->|"uses product data"| node_productmodel
node_productsui -.->|"drives browser against"| node_service
node_home -.->|"opens website"| node_service

click node_userclient "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/client/UserApiClient.java"
click node_productclient "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/client/ProductsApiClient.java"
click node_brandclient "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/client/BrandsApiClient.java"
click node_baseclient "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/client/BaseApiClient.java"
click node_userfactory "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/account/UserFactory.java"
click node_userrequest "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/account/UserRequest.java"
click node_userresponse "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/account/User.java"
click node_productmodel "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/products/Product.java"
click node_responseproducts "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/products/ResponseProducts.java"
click node_brandmodel "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/brands/Brand.java"
click node_responsebrands "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/brands/ResponseBrands.java"
click node_spec "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/base/ApiSpecBuilder.java"
click node_config "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/utils/ConfigReader.java"
click node_home "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/HomePage.java"
click node_header "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/Header.java"
click node_signup "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/SignupLoginPage.java"
click node_accountinfo "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/SignupAccountInfoPage.java"
click node_created "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/AccountCreatedPage.java"
click node_productsui "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/ProductsPage.java"
click node_detail "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/ProductDetailPage.java"
click node_cart "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/CartPage.java"
click node_contact "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/ContactUsPage.java"
click node_basepage "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/base/BasePage.java"
click node_actions "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/utils/ElementActions.java"
click node_footer "https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/Footer.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_userclient,node_productclient,node_brandclient,node_baseclient toneBlue
class node_userfactory,node_userrequest,node_userresponse,node_productmodel,node_responseproducts,node_brandmodel,node_responsebrands toneAmber
class node_home,node_header,node_signup,node_accountinfo,node_created,node_productsui,node_detail,node_cart,node_contact,node_basepage,node_footer toneMint
class node_spec,node_config,node_actions toneRose
class node_tester,node_service toneIndigo
```

## Components

### API automation

- [Account API](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/client/UserApiClient.java): `src/main/java/pageobjects/api/client/UserApiClient.java`
- [Products API](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/client/ProductsApiClient.java): `src/main/java/pageobjects/api/client/ProductsApiClient.java`
- [Brands API](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/client/BrandsApiClient.java): `src/main/java/pageobjects/api/client/BrandsApiClient.java`
- [HTTP client base](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/client/BaseApiClient.java): `src/main/java/pageobjects/api/client/BaseApiClient.java`

### API domain models

- [User data factory](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/account/UserFactory.java): `src/main/java/pageobjects/api/account/UserFactory.java`
- [Account request](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/account/UserRequest.java): `src/main/java/pageobjects/api/account/UserRequest.java`
- [Account response](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/account/User.java): `src/main/java/pageobjects/api/account/User.java`
- [Product model](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/products/Product.java): `src/main/java/pageobjects/api/products/Product.java`
- [Product response](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/products/ResponseProducts.java): `src/main/java/pageobjects/api/products/ResponseProducts.java`
- [Brand model](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/brands/Brand.java): `src/main/java/pageobjects/api/brands/Brand.java`
- [Brand response](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/api/brands/ResponseBrands.java): `src/main/java/pageobjects/api/brands/ResponseBrands.java`

### Browser page objects

- [Home page](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/HomePage.java): `src/main/java/pageobjects/ui/pom/HomePage.java`
- [Site navigation](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/Header.java): `src/main/java/pageobjects/ui/pom/Header.java`
- [Signup login](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/SignupLoginPage.java): `src/main/java/pageobjects/ui/pom/SignupLoginPage.java`
- [Signup details](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/SignupAccountInfoPage.java): `src/main/java/pageobjects/ui/pom/SignupAccountInfoPage.java`
- [Account created](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/AccountCreatedPage.java): `src/main/java/pageobjects/ui/pom/AccountCreatedPage.java`
- [Products browsing](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/ProductsPage.java): `src/main/java/pageobjects/ui/pom/ProductsPage.java`
- [Product details](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/ProductDetailPage.java): `src/main/java/pageobjects/ui/pom/ProductDetailPage.java`
- [Shopping cart](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/CartPage.java): `src/main/java/pageobjects/ui/pom/CartPage.java`
- [Contact us](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/ContactUsPage.java): `src/main/java/pageobjects/ui/pom/ContactUsPage.java`
- [Page base](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/base/BasePage.java): `src/main/java/pageobjects/ui/pom/base/BasePage.java`
- [Site footer](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/Footer.java): `src/main/java/pageobjects/ui/pom/Footer.java`

### Shared runtime

- [API specifications](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/base/ApiSpecBuilder.java): `src/main/java/base/ApiSpecBuilder.java`
- [Configuration reader](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/utils/ConfigReader.java): `src/main/java/utils/ConfigReader.java`
- [Element actions](https://github.com/vgebrych/qa-automation-java/blob/main/src/main/java/pageobjects/ui/pom/utils/ElementActions.java): `src/main/java/pageobjects/ui/pom/utils/ElementActions.java`

### Other components

- **Test initiator**
- **AutomationExercise**

## Connections

- Test initiator → Account API: runs API checks (evidence: `README.md`)
- Test initiator → Products API: runs API checks (evidence: `README.md`)
- Test initiator → Brands API: runs API checks (evidence: `README.md`)
- Account API → AutomationExercise: sends account requests (evidence: `src/main/java/pageobjects/api/client/UserApiClient.java`)
- Products API → AutomationExercise: sends product requests
- Brands API → AutomationExercise: sends brand requests
- Account API → HTTP client base: uses HTTP methods (evidence: `src/main/java/pageobjects/api/client/UserApiClient.java`)
- Products API → HTTP client base: inherits requests (evidence: `src/main/java/pageobjects/api/client/ProductsApiClient.java`)
- Brands API → HTTP client base: inherits requests (evidence: `src/main/java/pageobjects/api/client/BrandsApiClient.java`)
- HTTP client base → API specifications: uses specifications (evidence: `src/main/java/pageobjects/api/client/BaseApiClient.java`)
- API specifications → Configuration reader: reads settings (evidence: `src/main/java/base/ApiSpecBuilder.java`)
- Account API → User data factory: serializes users (evidence: `src/main/java/pageobjects/api/client/UserApiClient.java`)
- User data factory → Account request: creates and maps (evidence: `src/main/java/pageobjects/api/account/UserFactory.java`)
- Account API → Account request: accepts account data (evidence: `src/main/java/pageobjects/api/client/UserApiClient.java`)
- Account API → Account response: deserializes details (evidence: `src/main/java/pageobjects/api/client/UserApiClient.java`)
- Products API → Product response: returns product data (evidence: `src/main/java/pageobjects/api/client/ProductsApiClient.java`)
- Product response → Product model: contains products (evidence: `src/main/java/pageobjects/api/products/ResponseProducts.java`)
- Brands API → Brand response: returns brand data (evidence: `src/main/java/pageobjects/api/client/BrandsApiClient.java`)
- Brand response → Brand model: contains brands (evidence: `src/main/java/pageobjects/api/brands/ResponseBrands.java`)
- Test initiator → Home page: drives browser flows (evidence: `README.md`)
- Home page → Configuration reader: reads site address (evidence: `src/main/java/pageobjects/ui/pom/HomePage.java`)
- Page base → Site navigation: creates navigation (evidence: `src/main/java/pageobjects/ui/pom/base/BasePage.java`)
- Page base → Site footer: creates footer (evidence: `src/main/java/pageobjects/ui/pom/base/BasePage.java`)
- Page base → Element actions: inherits actions (evidence: `src/main/java/pageobjects/ui/pom/base/BasePage.java`)
- Site navigation → Products browsing: opens products (evidence: `src/main/java/pageobjects/ui/pom/Header.java`)
- Site navigation → Shopping cart: opens cart (evidence: `src/main/java/pageobjects/ui/pom/Header.java`)
- Site navigation → Signup login: opens signup (evidence: `src/main/java/pageobjects/ui/pom/Header.java`)
- Site navigation → Contact us: opens contact (evidence: `src/main/java/pageobjects/ui/pom/Header.java`)
- Signup login → Signup details: opens details form (evidence: `src/main/java/pageobjects/ui/pom/SignupLoginPage.java`)
- Signup details → Account request: fills account fields (evidence: `src/main/java/pageobjects/ui/pom/SignupAccountInfoPage.java`)
- Signup details → Account created: submits account (evidence: `src/main/java/pageobjects/ui/pom/SignupAccountInfoPage.java`)
- Products browsing → Product details: opens product detail (evidence: `src/main/java/pageobjects/ui/pom/ProductsPage.java`)
- Products browsing → Product model: uses product data (evidence: `src/main/java/pageobjects/ui/pom/ProductsPage.java`)
- Product details → Product model: uses product data (evidence: `src/main/java/pageobjects/ui/pom/ProductDetailPage.java`)
- Products browsing → AutomationExercise: drives browser against
- Home page → AutomationExercise: opens website
