# himanshux19/perfanalyzer architecture

> Architecture diagram of the GitHub repository himanshux19/perfanalyzer, 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/himanshux19/perfanalyzer
- Repository: https://github.com/himanshux19/perfanalyzer

## Overview

PerfAnalyzer is a web platform for authoring and running load tests, organizing workspaces and results, and viewing telemetry, with account administration and subscription billing. The primary flow is user configuration through the Angular client, backend discovery and JMX/YAML generation, then queued local or Jenkins execution and result monitoring. README documents additional APM, workspace, billing, and administration capabilities; unsampled implementation details are represented only at supported directory level. Edges follow explicit README architecture or shown imports/calls; unshown subsystem links are omitted.

Main entry points: [`perfAnalyzer-backend/main.py`](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/main.py) (REST and WebSocket API), [`perfAnalyzer-frontend/src/app/api.service.ts`](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/api.service.ts) (API client), [`perfAnalyzer-frontend/src/app/components/projects/projects.ts`](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/projects/projects.ts) (Workspace interface), [`perfAnalyzer-frontend/src/app/app.routes.ts`](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/app.routes.ts) (Page routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Angular application<br/>[app.ts]"]
  node_routes["Page routing<br/>[app.routes.ts]"]
  node_projects["Workspace interface<br/>[projects.ts]"]
  node_auth["User sign-in<br/>[auth.ts]"]
  node_admin["Admin portal<br/>[admin-dashboard.ts]"]
  node_test_config["Test configuration<br/>[test-config.ts]"]
  node_queue_ui["Run queue<br/>[test-queue.ts]"]
  node_reports["Reports and history<br/>[reports.ts]"]
  node_monitor_ui["Monitoring viewer<br/>[monitoring.ts]"]
  node_billing_ui["Subscription interface<br/>[subscribe.ts]"]
  node_api_client["API client<br/>[api.service.ts]"]
end

subgraph group_authoring["Test authoring"]
  node_discovery["Endpoint discovery"]
  node_jmx["JMeter generator<br/>[jmx_builder.py]"]
  node_yaml["Taurus config generator<br/>[yaml_builder.py]"]
end

subgraph group_execution["Run and analyze"]
  node_queue["Execution orchestration<br/>[main.py]"]
  node_artifacts[("Test artifacts and results<br/>[main.py]")]
end

subgraph group_platform["Platform services"]
  node_api["REST and WebSocket API<br/>[main.py]"]
  node_models["Request models<br/>[models.py]"]
  node_database[("PostgreSQL data")]
  node_crypto["Credential encryption"]
end

subgraph group_integrations["External systems"]
  node_crawler["Target application"]
  node_taurus["Taurus and JMeter"]
  node_jenkins["Jenkins agents"]
  node_uptrace["Uptrace APM"]
  node_razorpay["Razorpay"]
  node_otel["OpenTelemetry<br/>[tracing.py]"]
end

node_user(("User or admin"))

node_user -->|"uses"| node_app
node_app -->|"routes through"| node_routes
node_routes -->|"routes login"| node_auth
node_routes -->|"routes admin"| node_admin
node_routes -->|"routes workspace"| node_projects
node_projects -->|"hosts"| node_test_config
node_projects -->|"hosts"| node_queue_ui
node_projects -->|"hosts"| node_reports
node_projects -->|"hosts"| node_monitor_ui
node_projects -->|"hosts"| node_billing_ui
node_auth -->|"calls"| node_api_client
node_admin -->|"calls"| node_api_client
node_projects -->|"calls"| node_api_client
node_test_config -->|"calls"| node_api_client
node_queue_ui -->|"calls"| node_api_client
node_reports -->|"calls"| node_api_client
node_monitor_ui -->|"calls"| node_api_client
node_billing_ui -->|"calls"| node_api_client
node_api_client -->|"HTTP and WebSocket"| node_api
node_api -->|"validates requests"| node_models
node_api -->|"discovers endpoints"| node_discovery
node_api -->|"generates JMX"| node_jmx
node_api -->|"generates YAML"| node_yaml
node_api -->|"dispatches runs"| node_queue
node_api -->|"reads and writes"| node_database
node_api -->|"stores outputs"| node_artifacts
node_discovery -->|"crawls target"| node_crawler
node_queue -->|"local execution"| node_taurus
node_queue -->|"remote execution"| node_jenkins
node_taurus -->|"writes reports"| node_artifacts
node_api -->|"emits telemetry"| node_otel
node_otel -->|"exports traces"| node_uptrace
node_monitor_ui -->|"views proxied APM"| node_uptrace
node_api -->|"handles payments"| node_razorpay
node_api -->|"encrypts credentials"| node_crypto

click node_app "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/app.ts"
click node_routes "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/app.routes.ts"
click node_projects "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/projects/projects.ts"
click node_auth "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/auth/auth.ts"
click node_admin "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/admin-dashboard/admin-dashboard.ts"
click node_test_config "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/test-config/test-config.ts"
click node_queue_ui "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/test-queue/test-queue.ts"
click node_reports "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/reports/reports.ts"
click node_monitor_ui "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/monitoring/monitoring.ts"
click node_billing_ui "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/subscribe/subscribe.ts"
click node_api_client "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/api.service.ts"
click node_api "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/main.py"
click node_models "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/models.py"
click node_discovery "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/services/endpoint_discovery.py"
click node_jmx "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/jmx_builder.py"
click node_yaml "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/yaml_builder.py"
click node_queue "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/main.py"
click node_artifacts "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/main.py"
click node_otel "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/tracing.py"
click node_crypto "https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/monitoring_crypto.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_app,node_routes,node_projects,node_auth,node_admin,node_test_config,node_queue_ui,node_reports,node_monitor_ui,node_billing_ui,node_api_client,node_user toneBlue
class node_discovery,node_jmx,node_yaml toneAmber
class node_queue,node_artifacts toneMint
class node_api,node_models,node_database,node_crypto toneRose
class node_crawler,node_taurus,node_jenkins,node_uptrace,node_razorpay,node_otel toneIndigo
```

## Components

### Web client

- [Angular application](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/app.ts): `perfAnalyzer-frontend/src/app/app.ts`
- [Page routing](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/app.routes.ts): `perfAnalyzer-frontend/src/app/app.routes.ts`
- [Workspace interface](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/projects/projects.ts): `perfAnalyzer-frontend/src/app/components/projects/projects.ts`
- [User sign-in](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/auth/auth.ts): `perfAnalyzer-frontend/src/app/components/auth/auth.ts`
- [Admin portal](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/admin-dashboard/admin-dashboard.ts): `perfAnalyzer-frontend/src/app/components/admin-dashboard/admin-dashboard.ts`
- [Test configuration](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/test-config/test-config.ts): `perfAnalyzer-frontend/src/app/components/test-config/test-config.ts`
- [Run queue](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/test-queue/test-queue.ts): `perfAnalyzer-frontend/src/app/components/test-queue/test-queue.ts`
- [Reports and history](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/reports/reports.ts): `perfAnalyzer-frontend/src/app/components/reports/reports.ts`
- [Monitoring viewer](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/monitoring/monitoring.ts): `perfAnalyzer-frontend/src/app/components/monitoring/monitoring.ts`
- [Subscription interface](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/components/subscribe/subscribe.ts): `perfAnalyzer-frontend/src/app/components/subscribe/subscribe.ts`
- [API client](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-frontend/src/app/api.service.ts): `perfAnalyzer-frontend/src/app/api.service.ts`

### Test authoring

- [Endpoint discovery](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/services/endpoint_discovery.py): `perfAnalyzer-backend/services/endpoint_discovery.py`
- [JMeter generator](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/jmx_builder.py): `perfAnalyzer-backend/jmx_builder.py`
- [Taurus config generator](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/yaml_builder.py): `perfAnalyzer-backend/yaml_builder.py`

### Run and analyze

- [Execution orchestration](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/main.py): `perfAnalyzer-backend/main.py`
- [Test artifacts and results](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/main.py): `perfAnalyzer-backend/main.py`

### Platform services

- [REST and WebSocket API](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/main.py): `perfAnalyzer-backend/main.py`
- [Request models](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/models.py): `perfAnalyzer-backend/models.py`
- **PostgreSQL data**
- [Credential encryption](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/monitoring_crypto.py): `perfAnalyzer-backend/monitoring_crypto.py`

### External systems

- **Target application**
- **Taurus and JMeter**
- **Jenkins agents**
- **Uptrace APM**
- **Razorpay**
- [OpenTelemetry](https://github.com/himanshux19/perfanalyzer/blob/main/perfAnalyzer-backend/tracing.py): `perfAnalyzer-backend/tracing.py`

### Other components

- **User or admin**

## Connections

- User or admin → Angular application: uses (evidence: `README.md`)
- Angular application → Page routing: routes through
- Page routing → User sign-in: routes login (evidence: `perfAnalyzer-frontend/src/app/app.routes.ts`)
- Page routing → Admin portal: routes admin (evidence: `perfAnalyzer-frontend/src/app/app.routes.ts`)
- Page routing → Workspace interface: routes workspace (evidence: `perfAnalyzer-frontend/src/app/app.routes.ts`)
- Workspace interface → Test configuration: hosts (evidence: `perfAnalyzer-frontend/src/app/components/projects/projects.ts`)
- Workspace interface → Run queue: hosts (evidence: `perfAnalyzer-frontend/src/app/components/projects/projects.ts`)
- Workspace interface → Reports and history: hosts (evidence: `perfAnalyzer-frontend/src/app/components/projects/projects.ts`)
- Workspace interface → Monitoring viewer: hosts (evidence: `perfAnalyzer-frontend/src/app/components/projects/projects.ts`)
- Workspace interface → Subscription interface: hosts (evidence: `perfAnalyzer-frontend/src/app/components/projects/projects.ts`)
- User sign-in → API client: calls (evidence: `perfAnalyzer-frontend/src/app/components/auth/auth.ts`)
- Admin portal → API client: calls (evidence: `perfAnalyzer-frontend/src/app/components/admin-dashboard/admin-dashboard.ts`)
- Workspace interface → API client: calls (evidence: `perfAnalyzer-frontend/src/app/components/projects/projects.ts`)
- Test configuration → API client: calls (evidence: `perfAnalyzer-frontend/src/app/components/test-config/test-config.ts`)
- Run queue → API client: calls (evidence: `perfAnalyzer-frontend/src/app/components/test-queue/test-queue.ts`)
- Reports and history → API client: calls (evidence: `perfAnalyzer-frontend/src/app/components/reports/reports.ts`)
- Monitoring viewer → API client: calls (evidence: `perfAnalyzer-frontend/src/app/components/monitoring/monitoring.ts`)
- Subscription interface → API client: calls (evidence: `perfAnalyzer-frontend/src/app/components/subscribe/subscribe.ts`)
- API client → REST and WebSocket API: HTTP and WebSocket (evidence: `README.md`)
- REST and WebSocket API → Request models: validates requests (evidence: `perfAnalyzer-backend/main.py`)
- REST and WebSocket API → Endpoint discovery: discovers endpoints (evidence: `perfAnalyzer-backend/main.py`)
- REST and WebSocket API → JMeter generator: generates JMX (evidence: `perfAnalyzer-backend/main.py`)
- REST and WebSocket API → Taurus config generator: generates YAML (evidence: `perfAnalyzer-backend/main.py`)
- REST and WebSocket API → Execution orchestration: dispatches runs (evidence: `README.md`)
- REST and WebSocket API → PostgreSQL data: reads and writes (evidence: `README.md`)
- REST and WebSocket API → Test artifacts and results: stores outputs (evidence: `README.md`)
- Endpoint discovery → Target application: crawls target (evidence: `README.md`)
- Execution orchestration → Taurus and JMeter: local execution (evidence: `README.md`)
- Execution orchestration → Jenkins agents: remote execution (evidence: `README.md`)
- Taurus and JMeter → Test artifacts and results: writes reports (evidence: `README.md`)
- REST and WebSocket API → OpenTelemetry: emits telemetry (evidence: `README.md`)
- OpenTelemetry → Uptrace APM: exports traces (evidence: `README.md`)
- Monitoring viewer → Uptrace APM: views proxied APM (evidence: `README.md`)
- REST and WebSocket API → Razorpay: handles payments (evidence: `README.md`)
- REST and WebSocket API → Credential encryption: encrypts credentials (evidence: `README.md`)
