# anilkumargadi27-hub/upgrade-impact-verifier architecture

> Architecture diagram of the GitHub repository anilkumargadi27-hub/upgrade-impact-verifier, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anilkumargadi27-hub/upgrade-impact-verifier
- Repository: https://github.com/anilkumargadi27-hub/upgrade-impact-verifier

## Overview

UpgradeLens accepts a dependency-upgrade PR or manual request, then reports application API usage alongside comparable baseline and upgrade check results. The graph preserves the UI, authenticated API, background analysis stages, and reusable analysis/runner/contracts packages. Several worker and integration details are documented but not shown in source excerpts; those relationships are omitted where their callers cannot be verified.

Main entry points: [`apps/web/src/App.tsx`](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/App.tsx) (Web application), [`apps/web/src/api.ts`](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/api.ts) (API client), [`apps/worker/src/orchestrator.ts`](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/worker/src/orchestrator.ts) (Analysis orchestration), [`apps/api/src/index.ts`](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/index.ts) (REST API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web dashboard"]
  node_app["Web application<br/>[App.tsx]"]
  node_auth_ui["Auth context<br/>[AuthContext.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_analysis_form["New analysis"]
  node_progress["Progress view<br/>[ProgressPage.tsx]"]
  node_report["Report explorer<br/>[ReportPage.tsx]"]
  node_dashboard["Dashboard<br/>[DashboardPage.tsx]"]
  node_history["Analysis history<br/>[HistoryPage.tsx]"]
  node_settings["Settings<br/>[SettingsPage.tsx]"]
end

subgraph group_api["API and services"]
  node_api_server["REST API<br/>[index.ts]"]
  node_auth_routes["Authentication<br/>[authRoutes.ts]"]
  node_auth_middleware["Session authorization<br/>[authMiddleware.ts]"]
  node_analysis_routes["Analysis routes<br/>[analysisRoutes.ts]"]
  node_project_routes["Project routes<br/>[projectRoutes.ts]"]
  node_api_queue["Job queue adapter<br/>[index.ts]"]
  node_api_db[("Application database<br/>[db.js]")]
end

subgraph group_worker["Analysis worker"]
  node_worker_entry["Worker entry<br/>[index.ts]"]
  node_orchestrator["Analysis orchestration<br/>[orchestrator.ts]"]
  node_github["GitHub ingestion<br/>[github.ts]"]
  node_worker_db[("Worker database access<br/>[db.ts]")]
end

subgraph group_packages["Analysis packages"]
  node_analyzer["AST and API analysis<br/>[index.ts]"]
  node_runner["Isolated check runner<br/>[index.ts]"]
  node_contracts["Shared contracts<br/>[index.ts]"]
end

node_developer(("Developer"))

node_developer -->|"uses"| node_app
node_app -->|"provides"| node_auth_ui
node_app -->|"routes to"| node_analysis_form
node_app -->|"routes to"| node_progress
node_app -->|"routes to"| node_report
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_history
node_app -->|"routes to"| node_settings
node_auth_ui -->|"calls"| node_api_client
node_analysis_form -->|"submits requests"| node_api_client
node_progress -->|"fetches updates"| node_api_client
node_report -->|"fetches report"| node_api_client
node_dashboard -->|"fetches data"| node_api_client
node_history -->|"fetches data"| node_api_client
node_settings -->|"fetches settings"| node_api_client
node_api_client -->|"HTTP requests"| node_api_server
node_api_server -->|"registers routes"| node_auth_routes
node_api_server -->|"registers routes"| node_analysis_routes
node_api_server -->|"registers routes"| node_project_routes
node_auth_routes -->|"reads and writes"| node_api_db
node_auth_routes -->|"requires sessions"| node_auth_middleware
node_auth_middleware -->|"validates sessions"| node_api_db
node_analysis_routes -->|"reads and writes"| node_api_db
node_analysis_routes -->|"enqueues jobs"| node_api_queue
node_project_routes -->|"reads and writes"| node_api_db
node_worker_entry -->|"dispatches work"| node_orchestrator
node_orchestrator -->|"validates PR"| node_github
node_orchestrator -->|"scans and diffs"| node_analyzer
node_orchestrator -->|"runs checks"| node_runner
node_orchestrator -.->|"persists results"| node_worker_db
node_worker_entry -->|"initializes access"| node_worker_db
node_analyzer -->|"uses schemas"| node_contracts
node_runner -->|"uses schemas"| node_contracts
node_api_queue -.->|"delivers jobs"| node_worker_entry

click node_app "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/App.tsx"
click node_auth_ui "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/context/AuthContext.tsx"
click node_api_client "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/api.ts"
click node_analysis_form "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/NewAnalysisPage.tsx"
click node_progress "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/ProgressPage.tsx"
click node_report "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/ReportPage.tsx"
click node_dashboard "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/DashboardPage.tsx"
click node_history "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/HistoryPage.tsx"
click node_settings "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/SettingsPage.tsx"
click node_api_server "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/index.ts"
click node_auth_routes "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/routes/authRoutes.ts"
click node_auth_middleware "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/middleware/authMiddleware.ts"
click node_analysis_routes "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/routes/analysisRoutes.ts"
click node_project_routes "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/routes/projectRoutes.ts"
click node_api_queue "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/queue/index.ts"
click node_api_db "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/db.js"
click node_worker_entry "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/worker/src/index.ts"
click node_orchestrator "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/worker/src/orchestrator.ts"
click node_github "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/worker/src/github.ts"
click node_worker_db "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/worker/src/db.ts"
click node_analyzer "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/packages/analyzer/src/index.ts"
click node_runner "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/packages/runner/src/index.ts"
click node_contracts "https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/packages/contracts/src/index.ts"

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_auth_ui,node_api_client,node_analysis_form,node_progress,node_report,node_dashboard,node_history,node_settings toneBlue
class node_api_server,node_auth_routes,node_auth_middleware,node_analysis_routes,node_project_routes,node_api_queue,node_api_db toneAmber
class node_worker_entry,node_orchestrator,node_github,node_worker_db toneMint
class node_analyzer,node_runner,node_contracts toneRose
class node_developer toneIndigo
```

## Components

### Web dashboard

- [Web application](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/App.tsx): `apps/web/src/App.tsx`
- [Auth context](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/context/AuthContext.tsx): `apps/web/src/context/AuthContext.tsx`
- [API client](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/api.ts): `apps/web/src/api.ts`
- [New analysis](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/NewAnalysisPage.tsx): `apps/web/src/pages/NewAnalysisPage.tsx`
- [Progress view](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/ProgressPage.tsx): `apps/web/src/pages/ProgressPage.tsx`
- [Report explorer](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/ReportPage.tsx): `apps/web/src/pages/ReportPage.tsx`
- [Dashboard](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/DashboardPage.tsx): `apps/web/src/pages/DashboardPage.tsx`
- [Analysis history](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/HistoryPage.tsx): `apps/web/src/pages/HistoryPage.tsx`
- [Settings](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/web/src/pages/SettingsPage.tsx): `apps/web/src/pages/SettingsPage.tsx`

### API and services

- [REST API](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/index.ts): `apps/api/src/index.ts`
- [Authentication](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/routes/authRoutes.ts): `apps/api/src/routes/authRoutes.ts`
- [Session authorization](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/middleware/authMiddleware.ts): `apps/api/src/middleware/authMiddleware.ts`
- [Analysis routes](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/routes/analysisRoutes.ts): `apps/api/src/routes/analysisRoutes.ts`
- [Project routes](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/routes/projectRoutes.ts): `apps/api/src/routes/projectRoutes.ts`
- [Job queue adapter](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/queue/index.ts): `apps/api/src/queue/index.ts`
- [Application database](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/api/src/db.js): `apps/api/src/db.js`

### Analysis worker

- [Worker entry](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/worker/src/index.ts): `apps/worker/src/index.ts`
- [Analysis orchestration](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/worker/src/orchestrator.ts): `apps/worker/src/orchestrator.ts`
- [GitHub ingestion](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/worker/src/github.ts): `apps/worker/src/github.ts`
- [Worker database access](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/apps/worker/src/db.ts): `apps/worker/src/db.ts`

### Analysis packages

- [AST and API analysis](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/packages/analyzer/src/index.ts): `packages/analyzer/src/index.ts`
- [Isolated check runner](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/packages/runner/src/index.ts): `packages/runner/src/index.ts`
- [Shared contracts](https://github.com/anilkumargadi27-hub/upgrade-impact-verifier/blob/main/packages/contracts/src/index.ts): `packages/contracts/src/index.ts`

### Other components

- **Developer**

## Connections

- Developer → Web application: uses
- Web application → Auth context: provides (evidence: `apps/web/src/App.tsx`)
- Web application → New analysis: routes to (evidence: `apps/web/src/App.tsx`)
- Web application → Progress view: routes to (evidence: `apps/web/src/App.tsx`)
- Web application → Report explorer: routes to (evidence: `apps/web/src/App.tsx`)
- Web application → Dashboard: routes to (evidence: `apps/web/src/App.tsx`)
- Web application → Analysis history: routes to (evidence: `apps/web/src/App.tsx`)
- Web application → Settings: routes to (evidence: `apps/web/src/App.tsx`)
- Auth context → API client: calls (evidence: `apps/web/src/context/AuthContext.tsx`)
- New analysis → API client: submits requests (evidence: `apps/web/src/pages/NewAnalysisPage.tsx`)
- Progress view → API client: fetches updates (evidence: `apps/web/src/pages/ProgressPage.tsx`)
- Report explorer → API client: fetches report (evidence: `apps/web/src/pages/ReportPage.tsx`)
- Dashboard → API client: fetches data (evidence: `apps/web/src/pages/DashboardPage.tsx`)
- Analysis history → API client: fetches data (evidence: `apps/web/src/pages/HistoryPage.tsx`)
- Settings → API client: fetches settings (evidence: `apps/web/src/pages/SettingsPage.tsx`)
- API client → REST API: HTTP requests
- REST API → Authentication: registers routes (evidence: `apps/api/src/index.ts`)
- REST API → Analysis routes: registers routes (evidence: `apps/api/src/index.ts`)
- REST API → Project routes: registers routes (evidence: `apps/api/src/index.ts`)
- Authentication → Application database: reads and writes (evidence: `apps/api/src/routes/authRoutes.ts`)
- Authentication → Session authorization: requires sessions (evidence: `apps/api/src/routes/authRoutes.ts`)
- Session authorization → Application database: validates sessions (evidence: `apps/api/src/middleware/authMiddleware.ts`)
- Analysis routes → Application database: reads and writes (evidence: `apps/api/src/routes/analysisRoutes.ts`)
- Analysis routes → Job queue adapter: enqueues jobs (evidence: `apps/api/src/routes/analysisRoutes.ts`)
- Project routes → Application database: reads and writes (evidence: `apps/api/src/routes/projectRoutes.ts`)
- Worker entry → Analysis orchestration: dispatches work (evidence: `apps/worker/src/index.ts`)
- Analysis orchestration → GitHub ingestion: validates PR (evidence: `apps/worker/src/orchestrator.ts`)
- Analysis orchestration → AST and API analysis: scans and diffs (evidence: `apps/worker/src/orchestrator.ts`)
- Analysis orchestration → Isolated check runner: runs checks (evidence: `apps/worker/src/orchestrator.ts`)
- Analysis orchestration → Worker database access: persists results
- Worker entry → Worker database access: initializes access (evidence: `apps/worker/src/index.ts`)
- AST and API analysis → Shared contracts: uses schemas (evidence: `packages/analyzer/src/index.ts`)
- Isolated check runner → Shared contracts: uses schemas (evidence: `packages/runner/src/index.ts`)
- Job queue adapter → Worker entry: delivers jobs
