# oktaliem/pageobjectpagefactoryactions architecture

> Architecture diagram of the GitHub repository oktaliem/pageobjectpagefactoryactions, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/oktaliem/pageobjectpagefactoryactions
- Repository: https://github.com/oktaliem/pageobjectpagefactoryactions

## Overview

##### Project type and purpose
- This is a Maven-based Java test automation framework.
- It implements a keyword-driven approach around Selenium WebDriver, using both Page Object and Page Factory patterns.
- Purpose: wrap WebDriver calls into reusable “keywords” (clickOn, sendKeys, waitFor, etc.), organize UI locators and actions in page classes, and execute tests via TestNG.

a. Test Runner Layer
- Maven + Surefire plugin
- TestNG (TestNG.xml)
b. Test Suite Layer
- com.oktaliem.testsuite.* classes (UnitTest, AngularTest, ReactTest, etc.)
- BaseTest class (initializes WebDriver, sets up test context)
c. Keyword Library & Page Layer
- Page Objects (src/test/java/com/oktaliem/pages/*)
- Page Factory classes (annotated @FindBy)
- Interfaces for actions (IElementActions, IWaitActions, etc.)
- Concrete base-action implementations (BaseElementAct, BaseWaitAct, BaseJSExecutorAct, etc.)
d. WebDriver Manager & Driver Binaries
- WebDriverManager integration (downloads drivers automatically)
- Manual binaries under /drivers (chromedriver-*) as fallback
e. Web Browser & SUT (System Under Test)
- ChromeDriver → Chrome browser (or other browser)
- Web application under test (e.g., Bitnami Odoo container)
f. Logging & Configuration
- log4j.properties (src/test/resources)
- actualhtmltext artifacts (for text-based verification)

##### Relationships and data flow
- The Maven/TestNG runner loads TestNG.xml → invokes Test Suite classes.
- Each Test Suite class extends BaseTest → requests a WebDriver instance (via WebDriverManager or binary).
- WebDriver instance is passed into Page Factory / Page Object constructors.
- Test methods call “keyword” methods (clickOn, typeOn, waitUntil, etc.) on page objects; these methods delegate to base-action classes.
- Base-action classes invoke the WebDriver API (findElement, executeScript, takeScreenshot, etc.).
- WebDriver controls the browser → interacts with the SUT → returns control/data to test code.
- All keyword calls emit log entries via log4j.

##### Architectural patterns & design principles
- Layered design:
Test Runner → Test Suites → Page Objects/Factory → Base Actions → WebDriver → Browser/SUT
- Page Object Model + Page Factory for locator encapsulation and code re-use.
- Keyword-driven: exposes high-level actions rather than raw WebDriver calls.
- Dependency injection via BaseTest: supplies WebDriver to pages.
- Configuration via Maven profiles, system properties, and log4j.

- Use clear, consistent labels for classes or packages (e.g., com.oktaliem.pages, com.oktaliem.pages.baseactions).
- Related classes (pages, actions, tests) inside containers to reduce clutter.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Runner Layer
    subgraph "Test Runner Layer"
        RUNNER_MAVEN["Maven (pom.xml)"]:::runner
        RUNNER_TESTNG["TestNG (TestNG.xml)"]:::runner
    end

    %% Test Suite Layer
    subgraph "Test Suite Layer"
        BASETEST["BaseTest"]:::tests
        UNITTEST["UnitTest"]:::tests
        ANGULARTEST["AngularTest"]:::tests
        REACTTEST["ReactTest"]:::tests
        RALLYTEST["RallyTest"]:::tests
        HOMEPAGETEST["HomePageTest"]:::tests
        WEBFORMTEST["WebFormTest"]:::tests
        VUETEST["VueTest"]:::tests
        WAIARIATEST["WaiariaTest"]:::tests
    end

    %% Page & Keyword Layer
    subgraph "Keyword Library & Page Layer"
        BASEPAGE["BasePage"]:::pages
        LOGINPAGE["LoginPage"]:::pages
        WEBPAGE["WebPage"]:::pages
        REACTDASH["ReactDashboardPage"]:::pages
        VUEDASH["VueDashboardPage"]:::pages
        W3CPAGE["W3CPage"]:::pages
        RALLYLOGIN["RallyLoginPage"]:::pages
        PATH["Path.java"]:::pages
        IELEMENT["IElementActions"]:::pages
    end

    %% Base Actions Layer
    subgraph "Base Actions Layer"
        BASEEL["BaseElementAct"]:::pages
        BASEWAIT["BaseWaitAct"]:::pages
        BASEJS["BaseJSExecutorAct"]:::pages
        BASEMK["BaseMouseKeyboardAct"]:::pages
        BASERB["BaseRobotAct"]:::pages
        BASEAS["BaseAssertionAct"]:::pages
        BASEGN["BaseGeneralAct"]:::pages
        BASESS["BaseScreenshot"]:::pages
    end

    %% WebDriver Manager & Drivers
    subgraph "WebDriver Manager & Binaries"
        WDM["WebDriverManager"]:::drivers
        LOCALBIN["Local Driver Binaries"]:::drivers
    end

    %% Browser & SUT
    subgraph "Browser & SUT"
        BROWSER["ChromeDriver/Browser"]:::browser
        SUT["System Under Test"]:::sut
    end

    %% Logging & Config
    subgraph "Logging & Configuration"
        LOG4J["log4j.properties"]:::logging
        HTMLART["actualhtmltext/loginPage.txt"]:::logging
    end

    %% Connections
    RUNNER_MAVEN -->|runs| RUNNER_TESTNG
    RUNNER_TESTNG -->|invokes| BASETEST
    BASETEST -->|extends| UNITTEST
    BASETEST -->|extends| ANGULARTEST
    BASETEST -->|extends| REACTTEST
    BASETEST -->|extends| RALLYTEST
    BASETEST -->|extends| HOMEPAGETEST
    BASETEST -->|extends| WEBFORMTEST
    BASETEST -->|extends| VUETEST
    BASETEST -->|extends| WAIARIATEST

    UNITTEST -->|uses| BASEPAGE
    ANGULARTEST -->|uses| BASEPAGE
    REACTTEST -->|uses| BASEPAGE
    RALLYTEST -->|uses| BASEPAGE
    HOMEPAGETEST -->|uses| BASEPAGE
    WEBFORMTEST -->|uses| BASEPAGE
    VUETEST -->|uses| BASEPAGE
    WAIARIATEST -->|uses| BASEPAGE

    BASEPAGE -->|provides elements to| LOGINPAGE
    BASEPAGE -->|provides elements to| WEBPAGE
    BASEPAGE -->|provides elements to| REACTDASH
    BASEPAGE -->|provides elements to| VUEDASH
    BASEPAGE -->|provides elements to| W3CPAGE
    BASEPAGE -->|provides elements to| RALLYLOGIN
    BASEPAGE -->|uses locators from| PATH
    LOGINPAGE -->|implements| IELEMENT

    LOGINPAGE -->|calls| BASEEL
    WEBPAGE -->|calls| BASEEL
    REACTDASH -->|calls| BASEEL
    VUEDASH -->|calls| BASEEL
    W3CPAGE -->|calls| BASEEL
    RALLYLOGIN -->|calls| BASEEL

    BASEEL -->|delegates to| BASEWAIT
    BASEWAIT -->|delegates to| BASEJS
    BASEJS -->|delegates to| BASEMK
    BASEMK -->|delegates to| BASERB
    BASERB -->|delegates to| BASEAS
    BASEAS -->|delegates to| BASEGN
    BASEGN -->|uses| BASESS
    BASESS -->|captures screenshot| LOCALBIN

    BASETEST -->|initializes driver via| WDM
    BASETEST -->|fallback to| LOCALBIN
    WDM -->|controls| BROWSER
    LOCALBIN -->|controls| BROWSER
    BROWSER -->|interacts with| SUT
    SUT -->|returns data to| BROWSER

    BASEPAGE -->|logs actions to| LOG4J
    IELEMENT -->|logs actions to| LOG4J
    BASEEL -->|logs actions to| LOG4J

    %% Click Events
    click RUNNER_MAVEN "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/pom.xml"
    click RUNNER_TESTNG "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/TestNG.xml"
    click BASETEST "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/testsuite/BaseTest.java"
    click UNITTEST "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/testsuite/UnitTest.java"
    click ANGULARTEST "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/testsuite/angularweb/AngularTest.java"
    click REACTTEST "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/testsuite/reactweb/ReactTest.java"
    click RALLYTEST "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/testsuite/flutterweb/RallyTest.java"
    click HOMEPAGETEST "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/testsuite/seleniumwebpractice/HomePageTest.java"
    click WEBFORMTEST "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/testsuite/seleniumwebpractice/WebFormTest.java"
    click VUETEST "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/testsuite/vueweb/VueTest.java"
    click WAIARIATEST "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/testsuite/w3cweb/WaiariaTest.java"
    click BASEPAGE "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/BasePage.java"
    click LOGINPAGE "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/LoginPage.java"
    click WEBPAGE "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/WebPage.java"
    click REACTDASH "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/reactpage/ReactDashboardPage.java"
    click VUEDASH "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/vuepage/VueDashboardPage.java"
    click W3CPAGE "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/w3c/W3CPage.java"
    click RALLYLOGIN "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/flutterPage/RallyLoginPage.java"
    click PATH "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/Path.java"
    click IELEMENT "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/webactions/IElementActions.java"
    click BASEEL "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/baseactions/BaseElementAct.java"
    click BASEWAIT "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/baseactions/BaseWaitAct.java"
    click BASEJS "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/baseactions/BaseJSExecutorAct.java"
    click BASEMK "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/baseactions/BaseMouseKeyboardAct.java"
    click BASERB "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/baseactions/BaseRobotAct.java"
    click BASEAS "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/baseactions/BaseAssertionAct.java"
    click BASEGN "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/baseactions/BaseGeneralAct.java"
    click BASESS "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/java/com/oktaliem/pages/baseactions/BaseScreenshot.java"
    click LOG4J "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/test/resources/log4j.properties"
    click HTMLART "https://github.com/oktaliem/pageobjectpagefactoryactions/blob/master/src/main/resources/actualhtmltext/loginPage.txt"

    %% Styles
    classDef runner fill:#cccccc,stroke:#333,stroke-width:1px
    classDef tests fill:#bbddff,stroke:#333,stroke-width:1px
    classDef pages fill:#bbeebb,stroke:#333,stroke-width:1px
    classDef drivers fill:#ffcc99,stroke:#333,stroke-width:1px
    classDef browser fill:#ffaa00,stroke:#333,stroke-width:1px
    classDef sut fill:#ff4444,stroke:#333,stroke-width:1px
    classDef logging fill:#ffff99,stroke:#333,stroke-width:1px
```
