# raptatinha/tau-advanced-playwright architecture

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

- Interactive diagram: https://gitdiagram.com/raptatinha/tau-advanced-playwright
- Repository: https://github.com/raptatinha/tau-advanced-playwright

## Overview

This repository is an Advanced Playwright course project: its product is a set of browser and API automation examples for DemoQA, rather than a standalone application. The main workflow configures a target environment, performs UI or API-based authentication, then exercises pages and APIs with reusable page objects, fixtures, and test data. Separate examples cover visual regression and multi-role stored authentication. The README documents these capabilities; source excerpts are limited to Playwright configs, so links to unsampled test implementations are documented rather than source-verified.

Main entry points: [`tests/ui/specs`](https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/ui/specs) (UI scenarios), [`tests/api`](https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/api) (API scenarios), [`playwright.config.ts`](https://github.com/raptatinha/tau-advanced-playwright/blob/main/playwright.config.ts) (Playwright configs), [`tests/setup/auth-setup.ts`](https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/setup/auth-setup.ts) (Auth setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Test Configuration"]
  node_config["Playwright configs"]
end

subgraph group_authentication["Authentication"]
  node_authsetup["Auth setup<br/>[auth-setup.ts]"]
  node_globalsetup["Global setup<br/>[global-setup.ts]"]
  node_login["Login page<br/>[login-page.ts]"]
  node_storedauth["Stored auth tests"]
end

subgraph group_ui["UI Testing"]
  node_ui_tests["UI scenarios"]
  node_pages["Page objects"]
  node_fixtures["Book fixtures<br/>[books-fixture.ts]"]
  node_hooks["Page hooks<br/>[hooks.ts]"]
  node_visual["Visual regression"]
end

subgraph group_api["API Testing"]
  node_api_tests["API scenarios"]
  node_api_methods["API methods<br/>[apiMethods.ts]"]
  node_api_requests["Collection requests"]
end

subgraph group_support["Test Support"]
  node_envurl["Environment URLs"]
  node_uiurl["UI URL builder<br/>[uiUrlBuilder.ts]"]
  node_api_url["API URL utilities<br/>[apiUrlBuilder.ts]"]
  node_data["Test data"]
end

node_engineer(("Test author"))
node_playwright["Playwright runner"]
node_demoqa["DemoQA"]
node_eyes["Applitools Eyes"]

node_engineer -.->|"chooses configuration"| node_config
node_config -.->|"configures runner"| node_playwright
node_config -->|"imports URLs"| node_envurl
node_playwright -.->|"runs setup"| node_globalsetup
node_globalsetup -.->|"authenticates via UI"| node_login
node_authsetup -.->|"uses page objects"| node_login
node_storedauth -.->|"uses stored auth"| node_authsetup
node_playwright -.->|"runs scenarios"| node_ui_tests
node_ui_tests -.->|"uses page objects"| node_pages
node_ui_tests -.->|"reuses flows"| node_fixtures
node_ui_tests -.->|"creates page objects"| node_hooks
node_ui_tests -.->|"builds URLs"| node_uiurl
node_ui_tests -.->|"exercises application"| node_demoqa
node_playwright -.->|"runs scenarios"| node_api_tests
node_api_tests -.->|"uses HTTP methods"| node_api_methods
node_api_tests -.->|"sends collection requests"| node_api_requests
node_api_tests -.->|"builds request URLs"| node_api_url
node_api_tests -.->|"uses test data"| node_data
node_api_tests -.->|"calls application API"| node_demoqa
node_playwright -.->|"runs regression"| node_visual
node_visual -.->|"checks visual output"| node_eyes

click node_config "https://github.com/raptatinha/tau-advanced-playwright/blob/main/playwright.config.ts"
click node_envurl "https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/utils/environmentBaseUrl.ts"
click node_authsetup "https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/setup/auth-setup.ts"
click node_globalsetup "https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/setup/global-setup.ts"
click node_login "https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/ui/pages/login-page.ts"
click node_storedauth "https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/ui/specs-auth"
click node_ui_tests "https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/ui/specs"
click node_pages "https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/ui/pages"
click node_fixtures "https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/ui/fixtures/books-fixture.ts"
click node_hooks "https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/utils/hooks.ts"
click node_uiurl "https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/utils/uiUrlBuilder.ts"
click node_api_tests "https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/api"
click node_api_methods "https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/utils/apiMethods.ts"
click node_api_requests "https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/api/requests"
click node_api_url "https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/utils/apiUrlBuilder.ts"
click node_data "https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/data"
click node_visual "https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/ui/specs/visual-regression.spec.ts"

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_config toneBlue
class node_authsetup,node_globalsetup,node_login,node_storedauth toneAmber
class node_ui_tests,node_pages,node_fixtures,node_hooks,node_visual toneMint
class node_api_tests,node_api_methods,node_api_requests toneRose
class node_envurl,node_uiurl,node_api_url,node_data,node_engineer,node_playwright,node_demoqa,node_eyes toneIndigo
```

## Components

### Test Configuration

- [Playwright configs](https://github.com/raptatinha/tau-advanced-playwright/blob/main/playwright.config.ts): `playwright.config.ts`

### Authentication

- [Auth setup](https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/setup/auth-setup.ts): `tests/setup/auth-setup.ts`
- [Global setup](https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/setup/global-setup.ts): `tests/setup/global-setup.ts`
- [Login page](https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/ui/pages/login-page.ts): `tests/ui/pages/login-page.ts`
- [Stored auth tests](https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/ui/specs-auth): `tests/ui/specs-auth`

### UI Testing

- [UI scenarios](https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/ui/specs): `tests/ui/specs`
- [Page objects](https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/ui/pages): `tests/ui/pages`
- [Book fixtures](https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/ui/fixtures/books-fixture.ts): `tests/ui/fixtures/books-fixture.ts`
- [Page hooks](https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/utils/hooks.ts): `tests/utils/hooks.ts`
- [Visual regression](https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/ui/specs/visual-regression.spec.ts): `tests/ui/specs/visual-regression.spec.ts`

### API Testing

- [API scenarios](https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/api): `tests/api`
- [API methods](https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/utils/apiMethods.ts): `tests/utils/apiMethods.ts`
- [Collection requests](https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/api/requests): `tests/api/requests`

### Test Support

- [Environment URLs](https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/utils/environmentBaseUrl.ts): `tests/utils/environmentBaseUrl.ts`
- [UI URL builder](https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/utils/uiUrlBuilder.ts): `tests/utils/uiUrlBuilder.ts`
- [API URL utilities](https://github.com/raptatinha/tau-advanced-playwright/blob/main/tests/utils/apiUrlBuilder.ts): `tests/utils/apiUrlBuilder.ts`
- [Test data](https://github.com/raptatinha/tau-advanced-playwright/tree/main/tests/data): `tests/data`

### Other components

- **Test author**
- **Playwright runner**
- **DemoQA**
- **Applitools Eyes**

## Connections

- Test author → Playwright configs: chooses configuration
- Playwright configs → Playwright runner: configures runner
- Playwright configs → Environment URLs: imports URLs (evidence: `playwright.config.ts`)
- Playwright runner → Global setup: runs setup
- Global setup → Login page: authenticates via UI (evidence: `README.md`)
- Auth setup → Login page: uses page objects (evidence: `README.md`)
- Stored auth tests → Auth setup: uses stored auth (evidence: `README.md`)
- Playwright runner → UI scenarios: runs scenarios
- UI scenarios → Page objects: uses page objects (evidence: `README.md`)
- UI scenarios → Book fixtures: reuses flows (evidence: `README.md`)
- UI scenarios → Page hooks: creates page objects (evidence: `README.md`)
- UI scenarios → UI URL builder: builds URLs (evidence: `README.md`)
- UI scenarios → DemoQA: exercises application (evidence: `README.md`)
- Playwright runner → API scenarios: runs scenarios
- API scenarios → API methods: uses HTTP methods (evidence: `README.md`)
- API scenarios → Collection requests: sends collection requests
- API scenarios → API URL utilities: builds request URLs (evidence: `README.md`)
- API scenarios → Test data: uses test data (evidence: `README.md`)
- API scenarios → DemoQA: calls application API (evidence: `README.md`)
- Playwright runner → Visual regression: runs regression
- Visual regression → Applitools Eyes: checks visual output (evidence: `README.md`)
