# naman123-code/sdet-automation-framework architecture

> Architecture diagram of the GitHub repository naman123-code/sdet-automation-framework, 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/naman123-code/sdet-automation-framework
- Repository: https://github.com/naman123-code/sdet-automation-framework

## Overview

This repository combines browser-based UI automation, REST API validation, and an AI test-case generator. The primary user workflow is to provide a natural-language requirement to the generator, which uses Gemini to produce structured test scenarios. Separately, the UI and API suites exercise browser flows and HTTP responses. The README documents these capabilities and links; source excerpts are limited, so implementation-level relationships are not inferred beyond that evidence.

Main entry points: [`generators/test_case_generator.py`](https://github.com/naman123-code/sdet-automation-framework/blob/main/generators/test_case_generator.py) (Test-case generator), [`tests/ui/test_browser.py`](https://github.com/naman123-code/sdet-automation-framework/blob/main/tests/ui/test_browser.py) (Browser test flows), [`tests/api/test_api.py`](https://github.com/naman123-code/sdet-automation-framework/blob/main/tests/api/test_api.py) (REST test cases)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_generation["AI Generation"]
  node_generator["Test-case generator"]
  node_scenarios["Structured scenarios"]
end

subgraph group_ui["UI Automation"]
  node_ui_tests["Browser test flows<br/>[test_browser.py]"]
  node_playwright["Playwright browser"]
end

subgraph group_api["API Validation"]
  node_api_tests["REST test cases<br/>[test_api.py]"]
end

node_user(("Requirement author"))
node_gemini["Gemini service"]
node_browser["Chromium browser"]
node_http_service["HTTP API"]

node_user -->|"provides requirement"| node_generator
node_generator -->|"requests scenarios"| node_gemini
node_generator -->|"produces JSON"| node_scenarios
node_ui_tests -->|"automates browser"| node_playwright
node_playwright -->|"drives Chromium"| node_browser
node_api_tests -->|"validates responses"| node_http_service

click node_generator "https://github.com/naman123-code/sdet-automation-framework/blob/main/generators/test_case_generator.py"
click node_scenarios "https://github.com/naman123-code/sdet-automation-framework/blob/main/generators/test_case_generator.py"
click node_ui_tests "https://github.com/naman123-code/sdet-automation-framework/blob/main/tests/ui/test_browser.py"
click node_api_tests "https://github.com/naman123-code/sdet-automation-framework/blob/main/tests/api/test_api.py"

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_generator,node_scenarios,node_browser toneBlue
class node_ui_tests,node_playwright toneAmber
class node_api_tests,node_http_service toneMint
class node_user,node_gemini toneIndigo
```

## Components

### AI Generation

- [Test-case generator](https://github.com/naman123-code/sdet-automation-framework/blob/main/generators/test_case_generator.py): `generators/test_case_generator.py`
- [Structured scenarios](https://github.com/naman123-code/sdet-automation-framework/blob/main/generators/test_case_generator.py): `generators/test_case_generator.py`

### UI Automation

- [Browser test flows](https://github.com/naman123-code/sdet-automation-framework/blob/main/tests/ui/test_browser.py): `tests/ui/test_browser.py`
- **Playwright browser**

### API Validation

- [REST test cases](https://github.com/naman123-code/sdet-automation-framework/blob/main/tests/api/test_api.py): `tests/api/test_api.py`

### Other components

- **Requirement author**
- **Gemini service**
- **Chromium browser**
- **HTTP API**

## Connections

- Requirement author → Test-case generator: provides requirement (evidence: `README.md`)
- Test-case generator → Gemini service: requests scenarios (evidence: `README.md`)
- Test-case generator → Structured scenarios: produces JSON (evidence: `README.md`)
- Browser test flows → Playwright browser: automates browser (evidence: `README.md`)
- Playwright browser → Chromium browser: drives Chromium (evidence: `README.md`)
- REST test cases → HTTP API: validates responses (evidence: `README.md`)
