# gururohith2017-boop/ai-multi-agent-test-automation architecture

> Architecture diagram of the GitHub repository gururohith2017-boop/ai-multi-agent-test-automation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gururohith2017-boop/ai-multi-agent-test-automation
- Repository: https://github.com/gururohith2017-boop/ai-multi-agent-test-automation

## Overview

This repository is a Streamlit dashboard for running an AI-assisted, deterministic Playwright test suite against a live customer-support application. The workflow loads Excel requirements, plans execution, runs mapped browser tests, summarizes outcomes, and produces an Excel report with screenshots and failure details. The dashboard also previews requirements and presents execution results and the report. The README documents the main stages; the workflow implementation and several supporting modules were not excerpted, so their internal call relationships are not asserted beyond documented links.

Main entry points: [`agents/test_automation_workflow.py`](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/test_automation_workflow.py) (Automation Workflow), [`agents/playwright_agent.py`](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/playwright_agent.py) (Playwright Agent), [`app.py`](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/app.py) (Streamlit Dashboard), [`agents/requirement_reader.py`](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/requirement_reader.py) (Requirement Reader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Requirements"]
  node_requirements["Excel Requirements"]
  node_reader["Requirement Reader"]
end

subgraph group_planning["Test Planning"]
  node_manager["Test Manager"]
  node_repository["Test Case Repository"]
  node_workflow["Automation Workflow"]
end

subgraph group_execution["Browser Execution"]
  node_executor["Playwright Agent"]
  node_browser_tests["Mapped Browser Tests"]
end

subgraph group_results["Analysis and Reporting"]
  node_result_agent["Result Agent<br/>[result_agent.py]"]
  node_report_agent["Report Agent<br/>[report_agent.py]"]
  node_report_file["Excel Execution Report"]
end

subgraph group_interface["Dashboard"]
  node_dashboard["Streamlit Dashboard<br/>[app.py]"]
end

node_user(("Operator"))
node_support_app{{"Customer Support App"}}

node_user -->|"starts run"| node_dashboard
node_dashboard -->|"loads requirements"| node_reader
node_reader -->|"reads rows"| node_requirements
node_dashboard -->|"runs workflow"| node_workflow
node_reader -.->|"supplies requirements"| node_manager
node_manager -.->|"plans cases"| node_repository
node_repository -->|"provides cases"| node_executor
node_workflow -.->|"runs tests"| node_executor
node_executor -->|"dispatches tests"| node_browser_tests
node_browser_tests -.->|"tests routing"| node_support_app
node_executor -.->|"returns results"| node_result_agent
node_result_agent -.->|"provides summary"| node_report_agent
node_report_agent -->|"writes report"| node_report_file
node_workflow -.->|"generates report"| node_report_agent
node_workflow -.->|"returns results"| node_dashboard

click node_requirements "https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/user_stories/customer_support_user_stories.xlsx"
click node_reader "https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/requirement_reader.py"
click node_manager "https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/requirement_manager.py"
click node_repository "https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/test_case_repository.py"
click node_workflow "https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/test_automation_workflow.py"
click node_executor "https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/playwright_agent.py"
click node_browser_tests "https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/tree/main/playwright_tests"
click node_result_agent "https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/result_agent.py"
click node_report_agent "https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/report_agent.py"
click node_dashboard "https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/app.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_requirements,node_reader toneBlue
class node_manager,node_repository,node_workflow toneAmber
class node_executor,node_browser_tests toneMint
class node_result_agent,node_report_agent,node_report_file toneRose
class node_dashboard,node_user,node_support_app toneIndigo
```

## Components

### Requirements

- [Excel Requirements](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/user_stories/customer_support_user_stories.xlsx): `user_stories/customer_support_user_stories.xlsx`
- [Requirement Reader](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/requirement_reader.py): `agents/requirement_reader.py`

### Test Planning

- [Test Manager](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/requirement_manager.py): `agents/requirement_manager.py`
- [Test Case Repository](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/test_case_repository.py): `agents/test_case_repository.py`
- [Automation Workflow](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/test_automation_workflow.py): `agents/test_automation_workflow.py`

### Browser Execution

- [Playwright Agent](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/playwright_agent.py): `agents/playwright_agent.py`
- [Mapped Browser Tests](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/tree/main/playwright_tests): `playwright_tests`

### Analysis and Reporting

- [Result Agent](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/result_agent.py): `agents/result_agent.py`
- [Report Agent](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/agents/report_agent.py): `agents/report_agent.py`
- **Excel Execution Report**

### Dashboard

- [Streamlit Dashboard](https://github.com/gururohith2017-boop/ai-multi-agent-test-automation/blob/main/app.py): `app.py`

### Other components

- **Operator**
- **Customer Support App**

## Connections

- Operator → Streamlit Dashboard: starts run (evidence: `app.py`)
- Streamlit Dashboard → Requirement Reader: loads requirements (evidence: `app.py`)
- Requirement Reader → Excel Requirements: reads rows (evidence: `agents/requirement_reader.py`)
- Streamlit Dashboard → Automation Workflow: runs workflow (evidence: `app.py`)
- Requirement Reader → Test Manager: supplies requirements (evidence: `agents/requirement_manager.py`)
- Test Manager → Test Case Repository: plans cases (evidence: `README.md`)
- Test Case Repository → Playwright Agent: provides cases (evidence: `agents/playwright_agent.py`)
- Automation Workflow → Playwright Agent: runs tests (evidence: `README.md`)
- Playwright Agent → Mapped Browser Tests: dispatches tests (evidence: `agents/playwright_agent.py`)
- Mapped Browser Tests → Customer Support App: tests routing (evidence: `README.md`)
- Playwright Agent → Result Agent: returns results (evidence: `agents/result_agent.py`)
- Result Agent → Report Agent: provides summary (evidence: `README.md`)
- Report Agent → Excel Execution Report: writes report (evidence: `agents/report_agent.py`)
- Automation Workflow → Report Agent: generates report (evidence: `README.md`)
- Automation Workflow → Streamlit Dashboard: returns results (evidence: `README.md`)
