# ashokmanohar-ai/agentic-quality-engineering-platform architecture

> Architecture diagram of the GitHub repository ashokmanohar-ai/agentic-quality-engineering-platform, 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/ashokmanohar-ai/agentic-quality-engineering-platform
- Repository: https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform

## Overview

This is a human-governed agentic quality-engineering platform. Users authenticate, submit requirements, and start a persisted workflow that analyzes requirements and risk, designs and checks tests, selects regression scope, generates and validates automation, pauses for hash-bound approval, executes Playwright tests, triages failures, and produces a release recommendation. The graph follows documented stage order; sampled orchestration code confirms key calls, checkpoints, and execution behavior. Some subsystem relationships are based on README documentation or SOURCE INDEX references rather than fully sampled implementations.

Main entry points: [`app/orchestration/graph.py`](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/orchestration/graph.py) (Workflow engine), [`app/main.py`](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/main.py) (FastAPI routes), [`app/api/workflows.py`](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/api/workflows.py) (Workflow endpoints), [`app/persistence/repositories.py`](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/persistence/repositories.py) (Repositories)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and governance"]
  node_api["FastAPI routes<br/>[main.py]"]
  node_authroute["Token route<br/>[auth.py]"]
  node_auth["JWT identity<br/>[auth.py]"]
  node_permissions["Role permissions<br/>[permissions.py]"]
  node_workflowapi["Workflow endpoints<br/>[workflows.py]"]
  node_approvalapi["Approval endpoints<br/>[approvals.py]"]
  node_approval["Human approval<br/>[approval.py]"]
end

subgraph group_workflow["Quality workflow"]
  node_engine["Workflow engine<br/>[graph.py]"]
  node_state["Workflow state<br/>[state.py]"]
  node_analysis["Requirement analysis"]
  node_risk["Risk analysis<br/>[risk_analyst.py]"]
  node_testdesign["Test design"]
  node_coverage["Coverage review"]
  node_regression["Regression selection"]
  node_automation["Automation generation"]
  node_execution["Execution agent<br/>[execution_agent.py]"]
  node_triage["Failure triage<br/>[failure_triage.py]"]
  node_quality["Quality review"]
end

subgraph group_runtime["Models and integrations"]
  node_validation["Automation validation<br/>[automation_tool.py]"]
  node_playwright["Playwright runner<br/>[playwright_tool.py]"]
  node_knowledge["Knowledge retrieval"]
  node_provider["Model providers<br/>[provider.py]"]
  node_models["Domain models<br/>[domain.py]"]
  node_evaluation["Evaluation controls<br/>[deterministic.py]"]
end

subgraph group_evidence["Persistence and evidence"]
  node_container["Service container<br/>[dependencies.py]"]
  node_repositories["Repositories<br/>[repositories.py]"]
  node_database[("SQLite store<br/>[database.py]")]
  node_observability["Tracing<br/>[tracing.py]"]
end

node_user(("QE user"))

node_user -->|"uses"| node_api
node_api -->|"routes to"| node_authroute
node_authroute -->|"creates token"| node_auth
node_workflowapi -->|"authenticates"| node_auth
node_workflowapi -->|"authorizes"| node_permissions
node_api -->|"routes to"| node_workflowapi
node_api -->|"routes to"| node_approvalapi
node_workflowapi -->|"starts"| node_engine
node_approvalapi -->|"resumes"| node_engine
node_engine -->|"invokes"| node_analysis
node_engine -->|"invokes"| node_risk
node_engine -->|"invokes"| node_testdesign
node_engine -->|"invokes"| node_coverage
node_engine -->|"invokes"| node_regression
node_engine -->|"invokes"| node_automation
node_engine -->|"validates"| node_validation
node_engine -->|"waits for"| node_approval
node_engine -->|"invokes"| node_execution
node_execution -->|"runs tests"| node_playwright
node_engine -->|"invokes"| node_triage
node_engine -->|"invokes"| node_quality
node_engine -->|"updates"| node_state
node_engine -->|"checkpoints"| node_repositories
node_container -->|"constructs"| node_engine
node_container -->|"constructs"| node_repositories
node_repositories -->|"queries"| node_database
node_engine -->|"uses"| node_provider
node_engine -.->|"retrieves evidence"| node_knowledge
node_engine -.->|"evaluates"| node_evaluation
node_engine -->|"exchanges typed data"| node_models
node_api -->|"configures"| node_observability

click node_api "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/main.py"
click node_authroute "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/api/auth.py"
click node_auth "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/governance/auth.py"
click node_permissions "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/governance/permissions.py"
click node_workflowapi "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/api/workflows.py"
click node_approvalapi "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/api/approvals.py"
click node_engine "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/orchestration/graph.py"
click node_state "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/orchestration/state.py"
click node_analysis "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/requirement_analyst.py"
click node_risk "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/risk_analyst.py"
click node_testdesign "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/tree/main/app/agents"
click node_coverage "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/coverage_reviewer.py"
click node_regression "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/regression_selector.py"
click node_automation "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/automation_generator.py"
click node_validation "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/tools/automation_tool.py"
click node_approval "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/governance/approval.py"
click node_execution "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/execution_agent.py"
click node_playwright "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/tools/playwright_tool.py"
click node_triage "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/failure_triage.py"
click node_quality "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/quality_reviewer.py"
click node_knowledge "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/tree/main/app/knowledge"
click node_provider "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/llm/provider.py"
click node_models "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/models/domain.py"
click node_container "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/dependencies.py"
click node_repositories "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/persistence/repositories.py"
click node_database "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/persistence/database.py"
click node_evaluation "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/evaluation/deterministic.py"
click node_observability "https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/observability/tracing.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_api,node_authroute,node_auth,node_permissions,node_workflowapi,node_approvalapi,node_approval,node_user toneBlue
class node_engine,node_state,node_analysis,node_risk,node_testdesign,node_coverage,node_regression,node_automation,node_execution,node_triage,node_quality toneAmber
class node_validation,node_playwright,node_knowledge,node_provider,node_models,node_evaluation toneMint
class node_container,node_repositories,node_database,node_observability toneRose
```

## Components

### API and governance

- [FastAPI routes](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/main.py): `app/main.py`
- [Token route](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/api/auth.py): `app/api/auth.py`
- [JWT identity](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/governance/auth.py): `app/governance/auth.py`
- [Role permissions](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/governance/permissions.py): `app/governance/permissions.py`
- [Workflow endpoints](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/api/workflows.py): `app/api/workflows.py`
- [Approval endpoints](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/api/approvals.py): `app/api/approvals.py`
- [Human approval](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/governance/approval.py): `app/governance/approval.py`

### Quality workflow

- [Workflow engine](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/orchestration/graph.py): `app/orchestration/graph.py`
- [Workflow state](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/orchestration/state.py): `app/orchestration/state.py`
- [Requirement analysis](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/requirement_analyst.py): `app/agents/requirement_analyst.py`
- [Risk analysis](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/risk_analyst.py): `app/agents/risk_analyst.py`
- [Test design](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/tree/main/app/agents): `app/agents`
- [Coverage review](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/coverage_reviewer.py): `app/agents/coverage_reviewer.py`
- [Regression selection](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/regression_selector.py): `app/agents/regression_selector.py`
- [Automation generation](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/automation_generator.py): `app/agents/automation_generator.py`
- [Execution agent](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/execution_agent.py): `app/agents/execution_agent.py`
- [Failure triage](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/failure_triage.py): `app/agents/failure_triage.py`
- [Quality review](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/agents/quality_reviewer.py): `app/agents/quality_reviewer.py`

### Models and integrations

- [Automation validation](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/tools/automation_tool.py): `app/tools/automation_tool.py`
- [Playwright runner](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/tools/playwright_tool.py): `app/tools/playwright_tool.py`
- [Knowledge retrieval](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/tree/main/app/knowledge): `app/knowledge`
- [Model providers](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/llm/provider.py): `app/llm/provider.py`
- [Domain models](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/models/domain.py): `app/models/domain.py`
- [Evaluation controls](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/evaluation/deterministic.py): `app/evaluation/deterministic.py`

### Persistence and evidence

- [Service container](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/dependencies.py): `app/dependencies.py`
- [Repositories](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/persistence/repositories.py): `app/persistence/repositories.py`
- [SQLite store](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/persistence/database.py): `app/persistence/database.py`
- [Tracing](https://github.com/ashokmanohar-ai/agentic-quality-engineering-platform/blob/main/app/observability/tracing.py): `app/observability/tracing.py`

### Other components

- **QE user**

## Connections

- QE user → FastAPI routes: uses (evidence: `app/main.py`)
- FastAPI routes → Token route: routes to (evidence: `app/main.py`)
- Token route → JWT identity: creates token (evidence: `app/api/auth.py`)
- Workflow endpoints → JWT identity: authenticates (evidence: `app/api/workflows.py`)
- Workflow endpoints → Role permissions: authorizes (evidence: `app/api/workflows.py`)
- FastAPI routes → Workflow endpoints: routes to (evidence: `app/main.py`)
- FastAPI routes → Approval endpoints: routes to (evidence: `app/main.py`)
- Workflow endpoints → Workflow engine: starts (evidence: `app/api/workflows.py`)
- Approval endpoints → Workflow engine: resumes (evidence: `app/api/approvals.py`)
- Workflow engine → Requirement analysis: invokes (evidence: `app/orchestration/graph.py`)
- Workflow engine → Risk analysis: invokes (evidence: `app/orchestration/graph.py`)
- Workflow engine → Test design: invokes (evidence: `README.md`)
- Workflow engine → Coverage review: invokes (evidence: `app/orchestration/graph.py`)
- Workflow engine → Regression selection: invokes (evidence: `app/orchestration/graph.py`)
- Workflow engine → Automation generation: invokes (evidence: `README.md`)
- Workflow engine → Automation validation: validates (evidence: `app/orchestration/graph.py`)
- Workflow engine → Human approval: waits for (evidence: `README.md`)
- Workflow engine → Execution agent: invokes (evidence: `app/orchestration/graph.py`)
- Execution agent → Playwright runner: runs tests (evidence: `app/agents/execution_agent.py`)
- Workflow engine → Failure triage: invokes (evidence: `app/orchestration/graph.py`)
- Workflow engine → Quality review: invokes (evidence: `app/orchestration/graph.py`)
- Workflow engine → Workflow state: updates (evidence: `app/orchestration/graph.py`)
- Workflow engine → Repositories: checkpoints (evidence: `app/orchestration/graph.py`)
- Service container → Workflow engine: constructs (evidence: `app/dependencies.py`)
- Service container → Repositories: constructs (evidence: `app/dependencies.py`)
- Repositories → SQLite store: queries (evidence: `app/persistence/repositories.py`)
- Workflow engine → Model providers: uses (evidence: `app/orchestration/graph.py`)
- Workflow engine → Knowledge retrieval: retrieves evidence (evidence: `README.md`)
- Workflow engine → Evaluation controls: evaluates (evidence: `README.md`)
- Workflow engine → Domain models: exchanges typed data
- FastAPI routes → Tracing: configures (evidence: `app/main.py`)
