# manimozhiyan1990/playwright-tdd-framework architecture

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

- Interactive diagram: https://gitdiagram.com/manimozhiyan1990/playwright-tdd-framework
- Repository: https://github.com/manimozhiyan1990/playwright-tdd-framework

## Overview

This repository is a Playwright-based test-automation framework, with page-step classes for login, home, and cookie interactions and a shared browser helper. Its wider tree includes AI, API, data-provider, JMeter, database, spreadsheet, and PDF-related areas, though several are empty or unsampled. The excerpts establish page-step-to-helper and helper-to-config links; the test spec and most data/integration wiring were not shown, so those relationships are left out.

Main entry points: [`commons/ui/web-commons.ts`](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/commons/ui/web-commons.ts) (Web commons), [`page-object/page-steps/login-page-steps.ts`](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-steps/login-page-steps.ts) (Login steps), [`page-object/page-steps/home-page-step.ts`](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-steps/home-page-step.ts) (Home steps), [`page-object/page-steps/cookies-page-steps.ts`](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-steps/cookies-page-steps.ts) (Cookie steps)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Browser automation"]
  node_ui_tests["UI test spec<br/>[ui-test.spec.ts]"]
  node_login["Login steps"]
  node_home["Home steps<br/>[home-page-step.ts]"]
  node_cookies["Cookie steps"]
  node_login_locators["Login locators"]
  node_home_locators["Home locators"]
  node_cookie_locators["Cookie locators"]
end

subgraph group_commons["Shared capabilities"]
  node_web["Web commons<br/>[web-commons.ts]"]
  node_config["Runtime config<br/>[config.json]"]
  node_ai["AI commons<br/>[ai-commons.ts]"]
  node_api["API commons<br/>[api-commons.ts]"]
  node_dp["Data provider<br/>[dp-commons.ts]"]
  node_jmeter["JMeter commons<br/>[jmeter-commons.ts]"]
end

subgraph group_data["Data utilities"]
  node_db["Database utilities<br/>[db-utils.ts]"]
  node_db_query["Database query helper<br/>[pdf-util.ts]"]
  node_excel["Spreadsheet reader<br/>[excel-util.ts]"]
  node_testdata["Test data"]
end

node_runner(("Test runner"))

node_login -->|"uses"| node_web
node_home -->|"uses"| node_web
node_cookies -->|"uses"| node_web
node_login -->|"reads locators"| node_login_locators
node_home -->|"reads locators"| node_home_locators
node_cookies -->|"reads locators"| node_cookie_locators
node_web -->|"reads settings"| node_config

click node_ui_tests "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/tests/ui/ui-test.spec.ts"
click node_login "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-steps/login-page-steps.ts"
click node_home "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-steps/home-page-step.ts"
click node_cookies "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-steps/cookies-page-steps.ts"
click node_login_locators "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-elements/login-page-elements.json"
click node_home_locators "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-elements/home-page-elements.json"
click node_cookie_locators "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-elements/cookies-page-elements.json"
click node_web "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/commons/ui/web-commons.ts"
click node_config "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/config/config.json"
click node_ai "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/commons/ai/ai-commons.ts"
click node_api "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/commons/api/api-commons.ts"
click node_dp "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/commons/dp/dp-commons.ts"
click node_jmeter "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/commons/jmeter/jmeter-commons.ts"
click node_db "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/utilities/db-utils.ts"
click node_db_query "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/utilities/pdf-util.ts"
click node_excel "https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/utilities/excel-util.ts"
click node_testdata "https://github.com/manimozhiyan1990/playwright-tdd-framework/tree/main/testdata"

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_ui_tests,node_login,node_home,node_cookies,node_login_locators,node_home_locators,node_cookie_locators toneBlue
class node_web,node_config,node_ai,node_api,node_dp,node_jmeter toneAmber
class node_db,node_db_query,node_excel,node_testdata toneMint
class node_runner toneIndigo
```

## Components

### Browser automation

- [UI test spec](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/tests/ui/ui-test.spec.ts): `tests/ui/ui-test.spec.ts`
- [Login steps](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-steps/login-page-steps.ts): `page-object/page-steps/login-page-steps.ts`
- [Home steps](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-steps/home-page-step.ts): `page-object/page-steps/home-page-step.ts`
- [Cookie steps](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-steps/cookies-page-steps.ts): `page-object/page-steps/cookies-page-steps.ts`
- [Login locators](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-elements/login-page-elements.json): `page-object/page-elements/login-page-elements.json`
- [Home locators](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-elements/home-page-elements.json): `page-object/page-elements/home-page-elements.json`
- [Cookie locators](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/page-object/page-elements/cookies-page-elements.json): `page-object/page-elements/cookies-page-elements.json`

### Shared capabilities

- [Web commons](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/commons/ui/web-commons.ts): `commons/ui/web-commons.ts`
- [Runtime config](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/config/config.json): `config/config.json`
- [AI commons](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/commons/ai/ai-commons.ts): `commons/ai/ai-commons.ts`
- [API commons](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/commons/api/api-commons.ts): `commons/api/api-commons.ts`
- [Data provider](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/commons/dp/dp-commons.ts): `commons/dp/dp-commons.ts`
- [JMeter commons](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/commons/jmeter/jmeter-commons.ts): `commons/jmeter/jmeter-commons.ts`

### Data utilities

- [Database utilities](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/utilities/db-utils.ts): `utilities/db-utils.ts`
- [Database query helper](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/utilities/pdf-util.ts): `utilities/pdf-util.ts`
- [Spreadsheet reader](https://github.com/manimozhiyan1990/playwright-tdd-framework/blob/main/utilities/excel-util.ts): `utilities/excel-util.ts`
- [Test data](https://github.com/manimozhiyan1990/playwright-tdd-framework/tree/main/testdata): `testdata`

### Other components

- **Test runner**

## Connections

- Login steps → Web commons: uses (evidence: `page-object/page-steps/login-page-steps.ts`)
- Home steps → Web commons: uses (evidence: `page-object/page-steps/home-page-step.ts`)
- Cookie steps → Web commons: uses (evidence: `page-object/page-steps/cookies-page-steps.ts`)
- Login steps → Login locators: reads locators (evidence: `page-object/page-steps/login-page-steps.ts`)
- Home steps → Home locators: reads locators (evidence: `page-object/page-steps/home-page-step.ts`)
- Cookie steps → Cookie locators: reads locators (evidence: `page-object/page-steps/cookies-page-steps.ts`)
- Web commons → Runtime config: reads settings (evidence: `commons/ui/web-commons.ts`)
