# tahanima/playwright-java-test-automation-architecture architecture

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

- Interactive diagram: https://gitdiagram.com/tahanima/playwright-java-test-automation-architecture
- Repository: https://github.com/tahanima/playwright-java-test-automation-architecture

## Overview

##### Main Components

a) Core Test Framework Layer:
- Test Execution Engine (JUnit 5)
- Configuration Management
- Browser Management
- Test Data Management
- Reporting System (Allure)

b) Page Object Layer:
- Page Objects
- Component Objects
- Page Factory

c) Test Implementation Layer:
- E2E Tests
- Test Utilities
- Data Transfer Objects (DTOs)

- ┌─────────────────────────────────────────┐
- Test Implementation          │
- (E2E Tests, Annotations, Test Utils)   │
- ┤
- Page Object Architecture        │
- (Page Objects, Components, Factory)   │
- ┤
- Core Framework                │
- (Browser, Config, Data Management)      │
- ┘

##### Component Relationships

a) Data Flow:
- Test Data (CSV) → DTOs → Test Classes
- Configuration → Browser Factory → Page Objects
- Test Execution → Allure Reporting

b) Dependencies:
- Page Objects → Component Objects
- Tests → Page Objects
- Browser Factory → Playwright

##### Detailed Component Breakdown

Specific components from the project:

**Core Framework:**
- Configuration (Configuration.java, ConfigurationManager.java)
- Browser Management (BrowserManager.java, BrowserFactory.java)
- Data Management (CsvToDtoMapper.java, DataArgumentsProvider.java)

**Page Objects:**
- Base Classes (BasePage.java, BaseComponent.java)
- Page Implementations (LoginPage.java, ProductsPage.java)
- Components (Header.java, SideNavMenu.java)

**Test Implementation:**
- Base Test (BaseTest.java)
- Test Classes (LoginTest.java, ProductsTest.java)
- DTOs (LoginDto.java, ProductsDto.java)
- Annotations (@DataSource, @Regression, @Smoke, @Validation)

##### External Dependencies

Integration points with:
- Playwright
- JUnit 5
- Allure Reporting
- Univocity Parsers
- Lombok

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef core fill:#FFA07A,stroke:#333,stroke-width:2px
    classDef page fill:#90EE90,stroke:#333,stroke-width:2px
    classDef test fill:#87CEEB,stroke:#333,stroke-width:2px
    classDef external fill:#DDA0DD,stroke:#333,stroke-width:2px
    
    %% External Dependencies
    subgraph External["External Dependencies"]
        Playwright["Playwright"]:::external
        JUnit["JUnit 5"]:::external
        Allure["Allure Reporting"]:::external
        Univocity["Univocity Parsers"]:::external
        Lombok["Lombok"]:::external
    end

    %% Core Framework Layer
    subgraph CoreFramework["Core Framework Layer"]
        Config["Configuration Management"]:::core
        BrowserMgmt["Browser Management"]:::core
        DataMgmt["Test Data Management"]:::core
        Report["Reporting System"]:::core
        
        BrowserFactory["Browser Factory"]:::core
        ConfigManager["Configuration Manager"]:::core
        DataMapper["CSV to DTO Mapper"]:::core
        DataProvider["Data Arguments Provider"]:::core
    end

    %% Page Object Layer
    subgraph PageLayer["Page Object Layer"]
        BasePageObj["Base Page"]:::page
        BaseCmpObj["Base Component"]:::page
        PageFactory["Page Factory"]:::page
        
        Pages["Page Objects"]:::page
        Components["Component Objects"]:::page
    end

    %% Test Implementation Layer
    subgraph TestLayer["Test Implementation Layer"]
        BaseTest["Base Test"]:::test
        E2ETests["E2E Tests"]:::test
        TestUtils["Test Utilities"]:::test
        DTOs["Data Transfer Objects"]:::test
        TestAnnotations["Test Annotations"]:::test
    end

    %% Relationships
    Playwright --> BrowserFactory
    BrowserFactory --> BrowserMgmt
    BrowserMgmt --> BasePageObj
    
    Config --> ConfigManager
    ConfigManager --> BaseTest
    
    DataMgmt --> DataMapper
    DataMapper --> DTOs
    DataProvider --> E2ETests
    
    BasePageObj --> Pages
    BaseCmpObj --> Components
    PageFactory --> Pages
    
    Pages --> E2ETests
    Components --> Pages
    
    E2ETests --> Report
    Report --> Allure
    
    JUnit --> E2ETests
    Univocity --> DataMapper
    Lombok --> DTOs

    %% Click Events
    click Config "https://github.com/Tahanima/playwright-java-test-automation-architecture/tree/main/src/main/java/io/github/tahanima/config/"
    click BrowserMgmt "https://github.com/Tahanima/playwright-java-test-automation-architecture/blob/main/src/main/java/io/github/tahanima/util/BrowserManager.java"
    click BrowserFactory "https://github.com/Tahanima/playwright-java-test-automation-architecture/blob/main/src/main/java/io/github/tahanima/factory/BrowserFactory.java"
    click DataMgmt "https://github.com/Tahanima/playwright-java-test-automation-architecture/blob/main/src/test/java/io/github/tahanima/util/CsvToDtoMapper.java"
    click DataMapper "https://github.com/Tahanima/playwright-java-test-automation-architecture/blob/main/src/test/java/io/github/tahanima/util/CsvToDtoMapper.java"
    click DataProvider "https://github.com/Tahanima/playwright-java-test-automation-architecture/blob/main/src/test/java/io/github/tahanima/util/DataArgumentsProvider.java"
    click Report "https://github.com/Tahanima/playwright-java-test-automation-architecture/blob/main/src/test/resources/allure.properties"
    click BasePageObj "https://github.com/Tahanima/playwright-java-test-automation-architecture/blob/main/src/main/java/io/github/tahanima/ui/page/BasePage.java"
    click BaseCmpObj "https://github.com/Tahanima/playwright-java-test-automation-architecture/blob/main/src/main/java/io/github/tahanima/ui/component/BaseComponent.java"
    click Pages "https://github.com/Tahanima/playwright-java-test-automation-architecture/tree/main/src/main/java/io/github/tahanima/ui/page/"
    click Components "https://github.com/Tahanima/playwright-java-test-automation-architecture/tree/main/src/main/java/io/github/tahanima/ui/component/"
    click PageFactory "https://github.com/Tahanima/playwright-java-test-automation-architecture/blob/main/src/main/java/io/github/tahanima/factory/BasePageFactory.java"
    click BaseTest "https://github.com/Tahanima/playwright-java-test-automation-architecture/blob/main/src/test/java/io/github/tahanima/e2e/BaseTest.java"
    click E2ETests "https://github.com/Tahanima/playwright-java-test-automation-architecture/tree/main/src/test/java/io/github/tahanima/e2e/"
    click DTOs "https://github.com/Tahanima/playwright-java-test-automation-architecture/tree/main/src/main/java/io/github/tahanima/dto/"
    click TestAnnotations "https://github.com/Tahanima/playwright-java-test-automation-architecture/tree/main/src/test/java/io/github/tahanima/annotation/"

    %% Legend
    subgraph Legend
        L1["Core Framework"]:::core
        L2["Page Objects"]:::page
        L3["Test Implementation"]:::test
        L4["External Dependencies"]:::external
    end
```
