# kainos-academy-2026-eayl/team-b-for-brilliant-test-harness architecture

> Architecture diagram of the GitHub repository kainos-academy-2026-eayl/team-b-for-brilliant-test-harness, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness
- Repository: https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness

## Overview

This repository is a Playwright test harness, not the website under test. Its workflow is to run browser-based UI checks against a configured frontend and API checks against a separately started backend; discount tests cover creation and expiry-based activation. Reusable page objects, API fixtures, and test data support those checks. The test source files were not sampled, so links from suites to helpers are omitted where the README does not establish them.

Main entry points: [`tests/UI_Tests`](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/tree/main/tests/UI_Tests) (UI test suites), [`tests/API_Tests`](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/tree/main/tests/API_Tests) (API login and registration), [`tests/add-discount.spec.ts`](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/tests/add-discount.spec.ts) (Add discount tests), [`tests/discount-activation.spec.ts`](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/tests/discount-activation.spec.ts) (Discount activation tests)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["UI checks"]
  node_ui_tests["UI test suites"]
  node_login_page["Login page object<br/>[LoginPage.ts]"]
  node_register_page["Register page object<br/>[RegisterPage.ts]"]
end

subgraph group_api["API checks"]
  node_api_tests["API login and registration"]
end

subgraph group_discounts["Discount checks"]
  node_discount_add["Add discount tests"]
  node_discount_activation["Discount activation tests"]
  node_discount_helpers["Discount helpers<br/>[discounts.ts]"]
end

subgraph group_harness["Shared harness"]
  node_api_fixture["API fixtures<br/>[fixture.ts]"]
  node_variables["Test variables<br/>[Variables.ts]"]
end

node_runner(("Test runner"))
node_frontend["Website under test"]
node_backend["Backend under test"]

node_runner -->|"runs"| node_ui_tests
node_runner -->|"runs"| node_api_tests
node_runner -->|"runs"| node_discount_add
node_runner -->|"runs"| node_discount_activation
node_ui_tests -->|"tests against"| node_frontend
node_api_tests -->|"tests against"| node_backend
node_discount_add -->|"creates discounts through"| node_backend
node_discount_activation -->|"tests expiry via"| node_backend
node_api_fixture -->|"reads defaults from"| node_variables

click node_ui_tests "https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/tree/main/tests/UI_Tests"
click node_login_page "https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/pages/LoginPage.ts"
click node_register_page "https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/pages/RegisterPage.ts"
click node_api_tests "https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/tree/main/tests/API_Tests"
click node_api_fixture "https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/fixture.ts"
click node_variables "https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/Variables.ts"
click node_discount_add "https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/tests/add-discount.spec.ts"
click node_discount_activation "https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/tests/discount-activation.spec.ts"
click node_discount_helpers "https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/tests/helpers/discounts.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_ui_tests,node_login_page,node_register_page toneBlue
class node_api_tests toneAmber
class node_discount_add,node_discount_activation,node_discount_helpers toneMint
class node_api_fixture,node_variables toneRose
class node_runner,node_frontend,node_backend toneIndigo
```

## Components

### UI checks

- [UI test suites](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/tree/main/tests/UI_Tests): `tests/UI_Tests`
- [Login page object](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/pages/LoginPage.ts): `pages/LoginPage.ts`
- [Register page object](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/pages/RegisterPage.ts): `pages/RegisterPage.ts`

### API checks

- [API login and registration](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/tree/main/tests/API_Tests): `tests/API_Tests`

### Discount checks

- [Add discount tests](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/tests/add-discount.spec.ts): `tests/add-discount.spec.ts`
- [Discount activation tests](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/tests/discount-activation.spec.ts): `tests/discount-activation.spec.ts`
- [Discount helpers](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/tests/helpers/discounts.ts): `tests/helpers/discounts.ts`

### Shared harness

- [API fixtures](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/fixture.ts): `fixture.ts`
- [Test variables](https://github.com/kainos-academy-2026-eayl/team-b-for-brilliant-test-harness/blob/main/Variables.ts): `Variables.ts`

### Other components

- **Test runner**
- **Website under test**
- **Backend under test**

## Connections

- Test runner → UI test suites: runs (evidence: `README.md`)
- Test runner → API login and registration: runs (evidence: `README.md`)
- Test runner → Add discount tests: runs (evidence: `README.md`)
- Test runner → Discount activation tests: runs (evidence: `README.md`)
- UI test suites → Website under test: tests against (evidence: `README.md`)
- API login and registration → Backend under test: tests against (evidence: `README.md`)
- Add discount tests → Backend under test: creates discounts through (evidence: `README.md`)
- Discount activation tests → Backend under test: tests expiry via (evidence: `README.md`)
- API fixtures → Test variables: reads defaults from (evidence: `fixture.ts`)
