# oktaliem/pengujianmembandingkangambar architecture

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

## Overview

##### Project type and purpose
- This is an automated testing framework that combines functional (Selenium/Appium) and visual regression testing using Cucumber (BDD), Maven, AShot, Visual Regression Tracker, Micoo, and Allure reporting.
- Its goal is to let QA engineers run end-to-end functional tests and at the same time run visual comparisons of the UI across multiple sites (Blibli, Bukalapak, Yahoo Finance, a demo Selenium site).

##### File structure
- Top-level:
- pom.xml (Maven build & dependency management)
- micoo (Micoo library integration)
- README.md, LICENSE, .gitignore
- src/test/java/com/oktaliem:
- features/… .feature files (Cucumber Gherkin scenarios)
- stepdefs/… Step definition classes mapping Gherkin steps to code
- page/… Page Object Model classes for each target site
- page/webactions/… low-level action and assertion wrappers (JS executor, waits, mouse/keyboard, general actions)
- utils/… constants and path utilities
- src/test/resources:
- baseimages (reference screenshots for visual tests)
- log4j.properties (logging configuration)

##### Key insights from README
- Integration with three visual-testing libraries: AShot (+Allure), Visual Regression Tracker, Micoo
- Maven commands to drive tests, support for Selenium Grid via system properties
- Feature files are grouped by library/approach:
- AShot + Allure: SeleniumWebsiteVisualTest.feature
- VRT: BlibliVisualTest.feature, BukalapakVisualTest.feature
- Micoo: YahooFinanceVisualTest.feature

##### Main components
a. Test Runner Layer
- Maven Surefire/Failsafe plugins
- Cucumber JUnit runner
- Command-line entry points (mvn clean test with flags)
b. BDD Layer
- Feature files (.feature)
- Step Definitions (com.oktaliem.stepdefs)
c. Test Logic Layer
- Page Objects (com.oktaliem.page)
- Webactions (com.oktaliem.page.webactions)
d. Libraries & Tools
- Selenium/WebDriver (local or Grid)
- Appium (if mobile)
- AShot (screenshot capture)
- Visual Regression Tracker (server API)
- Micoo
- Allure Cucumber JVM plugin (report generation)
e. External Services
- Selenium Grid Hub (optional, via –Dbrowser=grid –Dgrid_url)
- VRT server URL
f. Resources & Artifacts
- baseimages (baseline screenshots)
- allure-results (test report files)
- logs (log4j output)

##### Relationships and data flow
1. Maven invokes the Cucumber runner
2. The runner parses feature files → invokes matching step definition methods
3. Step definitions call into Page Objects and Webactions
4. Page Objects wrap WebDriver/Appium calls to open browsers and navigate to target URLs
5. Webactions perform clicks, keys, waits, JS, assertions
6. When a visual assertion is needed:
a. AShot or Micoo captures screenshots
b. Visual Regression Tracker client posts images to the VRT server
c. Comparison against baseline images (src/test/resources/baseimages)
d. Result (pass/fail) returned to test code
7. Allure plugin collects test results, screenshots, logs, and assembles the final report

##### Architectural patterns/design principles
- Layered architecture:
- Entry → BDD layer → Test logic → Infrastructure (WebDriver) → External services
- Page Object Model for UI abstraction
- Separation of concerns: feature files vs. step definitions vs. page & action code
- Modular integration of multiple visual-testing approaches
- Configurable via Maven properties and log4j

##### Final advice
- How the framework plugs in different visual-testing libraries side-by-side.
- Configuration inputs (Maven flags, log4j) and where they influence runtime.
- This will give stakeholders a clear, accurate view of how tests flow through BDD scenarios into real browser executions, into visual comparisons, and into reporting.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Test Runner & BDD Layer
    subgraph "Test Runner & BDD" 
        direction TB
        Pom["pom.xml"]:::code
        Runner["Cucumber JUnit Runner"]:::code
        subgraph "Feature Files"
            direction TB
            FF1["BlibliVisualTest.feature"]:::code
            FF2["BukalapakVisualTest.feature"]:::code
            FF3["SeleniumWebsiteVisualTest.feature"]:::code
            FF4["YahooFinanceVisualTest.feature"]:::code
        end
        subgraph "Step Definitions"
            direction TB
            SD1["AbstractStepDef.java"]:::code
            SD2["BlibliStepDef.java"]:::code
            SD3["BukalapakStepDef.java"]:::code
            SD4["LoginStepDef.java"]:::code
            SD5["SeleniumStepDef.java"]:::code
            SD6["YahooStepDef.java"]:::code
        end
    end

    %% Test Logic Layer
    subgraph "Test Logic" 
        direction TB
        subgraph "Page Objects"
            direction TB
            PO1["BasePage.java"]:::code
            PO2["BlibliPage.java"]:::code
            PO3["BukalapakPage.java"]:::code
            PO4["LoginPage.java"]:::code
            PO5["SeleniumPage.java"]:::code
            PO6["YahooPage.java"]:::code
        end
        subgraph "Webactions"
            direction TB
            WA1["BaseActions.java"]:::code
            WA2["BaseAssertionAction.java"]:::code
            WA3["BaseGeneralAction.java"]:::code
            WA4["BaseJSExecutorAction.java"]:::code
            WA5["BaseMouseKeyboardAction.java"]:::code
            WA6["BaseWaitsAction.java"]:::code
            WA7["Log.java"]:::code
        end
    end

    %% Libraries & Tools Integration
    subgraph "Libraries & Tools" 
        direction TB
        Micoo["Micoo"]:::lib
        AShot["AShot"]:::lib
        VRTClient["Visual Regression Tracker Client"]:::lib
        AllurePlugin["Allure Cucumber JVM Plugin"]:::lib
    end

    %% Utilities & Configuration
    subgraph "Utilities & Config" 
        direction TB
        Utils1["constants.java"]:::config
        Utils2["path.java"]:::config
        LogConfig["log4j.properties"]:::config
    end

    %% External Services
    subgraph "External Services" 
        direction TB
        WebDriver["WebDriver/Browser"]:::external
        Grid["Selenium Grid Hub"]:::external
        VRTServer["VRT Server"]:::external
    end

    %% Artifacts & Reports
    subgraph "Artifacts & Reports" 
        direction TB
        BaseImages["baseimages"]:::artifacts
        Screenshots["screenshots"]:::artifacts
        AllureResults["allure-results"]:::artifacts
    end

    %% Connections
    Pom -->|invokes| Runner
    Runner -->|parses| FF1
    Runner -->|parses| FF2
    Runner -->|parses| FF3
    Runner -->|parses| FF4
    Runner -->|invokes| SD1
    Runner -->|invokes| SD2
    Runner -->|invokes| SD3
    Runner -->|invokes| SD4
    Runner -->|invokes| SD5
    Runner -->|invokes| SD6

    SD1 -->|calls| PO1
    SD2 -->|calls| PO2
    SD3 -->|calls| PO3
    SD4 -->|calls| PO4
    SD5 -->|calls| PO5
    SD6 -->|calls| PO6

    PO1 -->|uses| WA1
    PO1 -->|uses| WA2
    PO1 -->|uses| WA3
    PO1 -->|uses| WA4
    PO1 -->|uses| WA5
    PO1 -->|uses| WA6
    PO2 -->|uses| WA1
    PO3 -->|uses| WA1
    PO4 -->|uses| WA1
    PO5 -->|uses| WA1
    PO6 -->|uses| WA1

    WA1 -->|executes| WebDriver
    WA2 -->|executes| WebDriver
    WA3 -->|executes| WebDriver
    WA4 -->|executes| WebDriver
    WA5 -->|executes| WebDriver
    WA6 -->|executes| WebDriver

    SD2 -->|visual compare| AShot
    SD2 -->|visual compare| VRTClient
    SD2 -->|visual compare| Micoo
    SD3 -->|visual compare| AShot
    SD3 -->|visual compare| VRTClient
    SD3 -->|visual compare| Micoo
    SD4 -->|visual compare| AShot
    SD4 -->|visual compare| VRTClient
    SD4 -->|visual compare| Micoo
    SD5 -->|visual compare| AShot
    SD5 -->|visual compare| VRTClient
    SD5 -->|visual compare| Micoo
    SD6 -->|visual compare| AShot
    SD6 -->|visual compare| VRTClient
    SD6 -->|visual compare| Micoo

    VRTClient -->|posts images| VRTServer
    VRTServer -->|returns result| VRTClient

    Runner -->|generates| AllurePlugin
    AShot -->|captures| Screenshots
    AllurePlugin -->|assembles| AllureResults
    LogConfig -->|configures| WA7

    Utils1 -->|provides| SD1
    Utils2 -->|provides| SD1
    BaseImages -->|baseline for| VRTClient

    Grid -->|used by| WebDriver

    %% Click Events
    click Pom "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/pom.xml"
    click Runner "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/CucumberJvmTest.java"
    click FF1 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/features/BlibliVisualTest.feature"
    click FF2 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/features/BukalapakVisualTest.feature"
    click FF3 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/features/SeleniumWebsiteVisualTest.feature"
    click FF4 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/features/YahooFinanceVisualTest.feature"
    click SD1 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/stepdefs/AbstractStepDef.java"
    click SD2 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/stepdefs/BlibliStepDef.java"
    click SD3 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/stepdefs/BukalapakStepDef.java"
    click SD4 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/stepdefs/LoginStepDef.java"
    click SD5 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/stepdefs/SeleniumSteDef.java"
    click SD6 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/stepdefs/YahooPage.java"
    click PO1 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/BasePage.java"
    click PO2 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/BlibliPage.java"
    click PO3 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/BukalapakPage.java"
    click PO4 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/LoginPage.java"
    click PO5 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/SeleniumPage.java"
    click PO6 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/YahooPage.java"
    click WA1 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/webactions/BaseActions.java"
    click WA2 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/webactions/BaseAssertionAction.java"
    click WA3 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/webactions/BaseGeneralAction.java"
    click WA4 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/webactions/BaseJSExecutorAction.java"
    click WA5 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/webactions/BaseMouseKeyboardAction.java"
    click WA6 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/webactions/BaseWaitsAction.java"
    click WA7 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/page/webactions/Log.java"
    click Micoo "https://github.com/oktaliem/pengujianmembandingkangambar/tree/main//micoo"
    click Utils1 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/utils/constants.java"
    click Utils2 "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/java/com/oktaliem/utils/path.java"
    click LogConfig "https://github.com/oktaliem/pengujianmembandingkangambar/blob/main/src/test/resources/log4j.properties"
    click BaseImages "https://github.com/oktaliem/pengujianmembandingkangambar/tree/main/src/test/resources/baseimages"

    %% Styles
    classDef code fill:#D0E3FF,stroke:#0366d6,color:#000
    classDef lib fill:#F0D0FF,stroke:#9b59b6,color:#000
    classDef config fill:#FFE0E0,stroke:#e67e22,color:#000
    classDef external fill:#CFFFD0,stroke:#27ae60,color:#000
    classDef artifacts fill:#FFD8A8,stroke:#d35400,color:#000
```
