# rammeshgar/pc-test-automation architecture

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

- Interactive diagram: https://gitdiagram.com/rammeshgar/pc-test-automation
- Repository: https://github.com/rammeshgar/pc-test-automation

## Overview

This repository is an automated QA and monitoring suite for the Peoples Clinic platform. Its main user-to-result path is scheduled test execution, clinical or FNX workflow validation, and publication of run status and failure evidence to a monitoring dashboard; failures can also trigger email alerts. The README documents the suite behavior and connections, but the test and dashboard source was not sampled, so implementation-level calls are not asserted.

Main entry points: [`smoke_test.py`](https://github.com/rammeshgar/pc-test-automation/blob/main/smoke_test.py) (Smoke checks), [`test_regression.py`](https://github.com/rammeshgar/pc-test-automation/blob/main/test_regression.py) (Clinical regression), [`test_fnx_ai.py`](https://github.com/rammeshgar/pc-test-automation/blob/main/test_fnx_ai.py) (FNX and AI checks), [`dashboard/index.html`](https://github.com/rammeshgar/pc-test-automation/blob/main/dashboard/index.html) (Live status dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Test orchestration"]
  node_smoke_workflow["Smoke schedule<br/>[smoke_test.yml]"]
  node_regression_workflow["Regression schedule"]
  node_fnx_workflow["FNX schedule<br/>[fnx_test.yml]"]
end

subgraph group_validation["Workflow validation"]
  node_smoke_test["Smoke checks<br/>[smoke_test.py]"]
  node_regression_test["Clinical regression<br/>[test_regression.py]"]
  node_fnx_test["FNX and AI checks<br/>[test_fnx_ai.py]"]
end

subgraph group_monitoring["Monitoring dashboard"]
  node_dashboard["Live status dashboard<br/>[index.html]"]
end

subgraph group_alerts["Failure alerting"]
  node_failure_capture["Failure screenshots<br/>[smoke_test.py]"]
end

node_github["GitHub Actions"]
node_clinic["Peoples Clinic"]
node_monitor_viewer(("QA dashboard viewer"))
node_run_history[("Workflow run history")]
node_artifacts[("GitHub artifacts")]
node_smtp["SMTP email"]

node_github -->|"runs every 10 minutes"| node_smoke_workflow
node_github -->|"runs hourly"| node_regression_workflow
node_github -->|"runs every two hours"| node_fnx_workflow
node_smoke_workflow -->|"runs checks"| node_smoke_test
node_regression_workflow -->|"runs checks"| node_regression_test
node_fnx_workflow -->|"runs checks"| node_fnx_test
node_smoke_test -->|"checks login and routing"| node_clinic
node_regression_test -->|"validates consultation"| node_clinic
node_fnx_test -->|"tests FNX and AI"| node_clinic
node_github -->|"records executions"| node_run_history
node_dashboard -->|"fetches every five minutes"| node_run_history
node_monitor_viewer -->|"views status"| node_dashboard
node_smoke_test -->|"captures on failure"| node_failure_capture
node_failure_capture -->|"uploads screenshots"| node_artifacts
node_artifacts -->|"renders screenshots"| node_dashboard
node_smoke_test -->|"sends cooldown alerts"| node_smtp
node_regression_test -->|"sends working-hours alerts"| node_smtp
node_fnx_test -->|"sends working-hours alerts"| node_smtp

click node_smoke_workflow "https://github.com/rammeshgar/pc-test-automation/blob/main/.github/workflows/smoke_test.yml"
click node_regression_workflow "https://github.com/rammeshgar/pc-test-automation/blob/main/.github/workflows/regression_test.yml"
click node_fnx_workflow "https://github.com/rammeshgar/pc-test-automation/blob/main/.github/workflows/fnx_test.yml"
click node_smoke_test "https://github.com/rammeshgar/pc-test-automation/blob/main/smoke_test.py"
click node_regression_test "https://github.com/rammeshgar/pc-test-automation/blob/main/test_regression.py"
click node_fnx_test "https://github.com/rammeshgar/pc-test-automation/blob/main/test_fnx_ai.py"
click node_dashboard "https://github.com/rammeshgar/pc-test-automation/blob/main/dashboard/index.html"
click node_failure_capture "https://github.com/rammeshgar/pc-test-automation/blob/main/smoke_test.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_smoke_workflow,node_regression_workflow,node_fnx_workflow,node_monitor_viewer toneBlue
class node_smoke_test,node_regression_test,node_fnx_test,node_run_history,node_artifacts toneAmber
class node_dashboard toneMint
class node_failure_capture toneRose
class node_github,node_clinic,node_smtp toneIndigo
```

## Components

### Test orchestration

- [Smoke schedule](https://github.com/rammeshgar/pc-test-automation/blob/main/.github/workflows/smoke_test.yml): `.github/workflows/smoke_test.yml`
- [Regression schedule](https://github.com/rammeshgar/pc-test-automation/blob/main/.github/workflows/regression_test.yml): `.github/workflows/regression_test.yml`
- [FNX schedule](https://github.com/rammeshgar/pc-test-automation/blob/main/.github/workflows/fnx_test.yml): `.github/workflows/fnx_test.yml`

### Workflow validation

- [Smoke checks](https://github.com/rammeshgar/pc-test-automation/blob/main/smoke_test.py): `smoke_test.py`
- [Clinical regression](https://github.com/rammeshgar/pc-test-automation/blob/main/test_regression.py): `test_regression.py`
- [FNX and AI checks](https://github.com/rammeshgar/pc-test-automation/blob/main/test_fnx_ai.py): `test_fnx_ai.py`

### Monitoring dashboard

- [Live status dashboard](https://github.com/rammeshgar/pc-test-automation/blob/main/dashboard/index.html): `dashboard/index.html`

### Failure alerting

- [Failure screenshots](https://github.com/rammeshgar/pc-test-automation/blob/main/smoke_test.py): `smoke_test.py`

### Other components

- **GitHub Actions**
- **Peoples Clinic**
- **QA dashboard viewer**
- **Workflow run history**
- **GitHub artifacts**
- **SMTP email**

## Connections

- GitHub Actions → Smoke schedule: runs every 10 minutes (evidence: `README.md`)
- GitHub Actions → Regression schedule: runs hourly (evidence: `README.md`)
- GitHub Actions → FNX schedule: runs every two hours (evidence: `README.md`)
- Smoke schedule → Smoke checks: runs checks (evidence: `README.md`)
- Regression schedule → Clinical regression: runs checks (evidence: `README.md`)
- FNX schedule → FNX and AI checks: runs checks (evidence: `README.md`)
- Smoke checks → Peoples Clinic: checks login and routing (evidence: `README.md`)
- Clinical regression → Peoples Clinic: validates consultation (evidence: `README.md`)
- FNX and AI checks → Peoples Clinic: tests FNX and AI (evidence: `README.md`)
- GitHub Actions → Workflow run history: records executions (evidence: `README.md`)
- Live status dashboard → Workflow run history: fetches every five minutes (evidence: `README.md`)
- QA dashboard viewer → Live status dashboard: views status (evidence: `README.md`)
- Smoke checks → Failure screenshots: captures on failure (evidence: `README.md`)
- Failure screenshots → GitHub artifacts: uploads screenshots (evidence: `README.md`)
- GitHub artifacts → Live status dashboard: renders screenshots (evidence: `README.md`)
- Smoke checks → SMTP email: sends cooldown alerts (evidence: `README.md`)
- Clinical regression → SMTP email: sends working-hours alerts (evidence: `README.md`)
- FNX and AI checks → SMTP email: sends working-hours alerts (evidence: `README.md`)
