# krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator architecture

> Architecture diagram of the GitHub repository krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator, 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/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator
- Repository: https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator

## Overview

SEQA is a full-stack Cost of Quality (CoQ) scenario calculator. A user signs in, enters Prevention, Appraisal, Internal Failure and External Failure costs, reviews the calculated summary, and can save or revisit scenario snapshots. The React app talks to Express APIs; route handlers use an atomic JSON-file database. Settings and system telemetry are additional product branches. The tree also contains an unrelated Python loan-management app, omitted as peripheral to SEQA. Some subsystem paths and capabilities are documented, but their source was not sampled.

Main entry points: [`src/App.jsx`](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/App.jsx) (App routing), [`server/server.js`](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/server.js) (API server), [`server/db/jsonDb.js`](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/db/jsonDb.js) (JSON database), [`src/context/AuthContext.jsx`](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/context/AuthContext.jsx) (Auth state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React application"]
  node_app["App routing<br/>[App.jsx]"]
  node_login["Login<br/>[Login.jsx]"]
  node_dashboard["Dashboard shell"]
  node_overview["Overview<br/>[Overview.jsx]"]
  node_calculator["CoQ calculator<br/>[CoqCalculator.jsx]"]
  node_calcpage["Calculator page<br/>[CalculatorPage.jsx]"]
  node_authstate["Auth state<br/>[AuthContext.jsx]"]
  node_coqstate["CoQ state<br/>[CoqContext.jsx]"]
  node_guard["Route guard<br/>[ProtectedRoute.jsx]"]
  node_settings["Settings page<br/>[Settings.jsx]"]
  node_authservice["Auth service<br/>[authService.js]"]
  node_coqservice["CoQ service<br/>[coqService.js]"]
  node_systemservice["System service<br/>[systemService.js]"]
  node_apiclient["API client<br/>[apiClient.js]"]
end

subgraph group_backend["Express API"]
  node_server["API server<br/>[server.js]"]
  node_authroutes["Authentication routes<br/>[authRoutes.js]"]
  node_coqroutes["CoQ and scenarios<br/>[coqRoutes.js]"]
  node_settingroutes["Settings routes<br/>[settingsRoutes.js]"]
  node_systemroutes["Telemetry routes<br/>[systemRoutes.js]"]
end

subgraph group_storage["JSON persistence"]
  node_jsondb[("JSON database<br/>[jsonDb.js]")]
  node_dbfile[("Database file<br/>[db.json]")]
end

node_user(("Quality engineer"))

node_user -->|"signs in"| node_login
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_overview
node_app -->|"routes to"| node_calcpage
node_app -->|"routes to"| node_settings
node_app -->|"protects"| node_guard
node_login -->|"uses"| node_authstate
node_guard -->|"checks"| node_authstate
node_authstate -->|"delegates to"| node_authservice
node_calcpage -->|"renders"| node_calculator
node_calculator -->|"uses"| node_coqstate
node_overview -->|"uses"| node_coqstate
node_dashboard -->|"uses"| node_authstate
node_dashboard -->|"uses"| node_coqstate
node_coqstate -->|"calls"| node_coqservice
node_settings -->|"calls"| node_systemservice
node_authservice -->|"calls"| node_apiclient
node_coqservice -->|"calls"| node_apiclient
node_systemservice -->|"calls"| node_apiclient
node_apiclient -->|"sends API requests"| node_server
node_server -->|"mounts"| node_authroutes
node_server -->|"mounts"| node_coqroutes
node_server -->|"mounts"| node_settingroutes
node_server -->|"mounts"| node_systemroutes
node_authroutes -->|"reads and writes"| node_jsondb
node_coqroutes -->|"reads and writes"| node_jsondb
node_settingroutes -->|"reads and writes"| node_jsondb
node_systemroutes -->|"reads"| node_jsondb
node_jsondb -->|"persists data"| node_dbfile

click node_app "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/App.jsx"
click node_login "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/pages/Login.jsx"
click node_dashboard "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/pages/DashboardLayout.jsx"
click node_overview "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/pages/Overview.jsx"
click node_calculator "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/components/CoqCalculator.jsx"
click node_calcpage "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/pages/CalculatorPage.jsx"
click node_authstate "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/context/AuthContext.jsx"
click node_coqstate "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/context/CoqContext.jsx"
click node_guard "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/components/ProtectedRoute.jsx"
click node_settings "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/pages/Settings.jsx"
click node_authservice "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/services/authService.js"
click node_coqservice "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/services/coqService.js"
click node_systemservice "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/services/systemService.js"
click node_apiclient "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/services/apiClient.js"
click node_server "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/server.js"
click node_authroutes "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/routes/authRoutes.js"
click node_coqroutes "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/routes/coqRoutes.js"
click node_settingroutes "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/routes/settingsRoutes.js"
click node_systemroutes "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/routes/systemRoutes.js"
click node_jsondb "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/db/jsonDb.js"
click node_dbfile "https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/data/db.json"

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_login,node_dashboard,node_overview,node_calculator,node_calcpage,node_authstate,node_coqstate,node_guard,node_settings,node_authservice,node_coqservice,node_systemservice,node_apiclient toneBlue
class node_server,node_authroutes,node_coqroutes,node_settingroutes,node_systemroutes toneAmber
class node_jsondb,node_dbfile toneMint
class node_user toneIndigo
```

## Components

### React application

- [App routing](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/App.jsx): `src/App.jsx`
- [Login](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/pages/Login.jsx): `src/pages/Login.jsx`
- [Dashboard shell](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/pages/DashboardLayout.jsx): `src/pages/DashboardLayout.jsx`
- [Overview](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/pages/Overview.jsx): `src/pages/Overview.jsx`
- [CoQ calculator](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/components/CoqCalculator.jsx): `src/components/CoqCalculator.jsx`
- [Calculator page](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/pages/CalculatorPage.jsx): `src/pages/CalculatorPage.jsx`
- [Auth state](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [CoQ state](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/context/CoqContext.jsx): `src/context/CoqContext.jsx`
- [Route guard](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/components/ProtectedRoute.jsx): `src/components/ProtectedRoute.jsx`
- [Settings page](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/pages/Settings.jsx): `src/pages/Settings.jsx`
- [Auth service](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/services/authService.js): `src/services/authService.js`
- [CoQ service](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/services/coqService.js): `src/services/coqService.js`
- [System service](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/services/systemService.js): `src/services/systemService.js`
- [API client](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/src/services/apiClient.js): `src/services/apiClient.js`

### Express API

- [API server](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/server.js): `server/server.js`
- [Authentication routes](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [CoQ and scenarios](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/routes/coqRoutes.js): `server/routes/coqRoutes.js`
- [Settings routes](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/routes/settingsRoutes.js): `server/routes/settingsRoutes.js`
- [Telemetry routes](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/routes/systemRoutes.js): `server/routes/systemRoutes.js`

### JSON persistence

- [JSON database](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/db/jsonDb.js): `server/db/jsonDb.js`
- [Database file](https://github.com/krishna-dhawangale/software-quality-economics-cost-of-quality-coq-calibrator/blob/main/server/data/db.json): `server/data/db.json`

### Other components

- **Quality engineer**

## Connections

- Quality engineer → Login: signs in (evidence: `README.md`)
- App routing → Login: routes to (evidence: `src/App.jsx`)
- App routing → Dashboard shell: routes to (evidence: `src/App.jsx`)
- App routing → Overview: routes to (evidence: `src/App.jsx`)
- App routing → Calculator page: routes to (evidence: `src/App.jsx`)
- App routing → Settings page: routes to (evidence: `src/App.jsx`)
- App routing → Route guard: protects (evidence: `src/App.jsx`)
- Login → Auth state: uses (evidence: `src/pages/Login.jsx`)
- Route guard → Auth state: checks (evidence: `src/components/ProtectedRoute.jsx`)
- Auth state → Auth service: delegates to (evidence: `src/context/AuthContext.jsx`)
- Calculator page → CoQ calculator: renders (evidence: `src/pages/CalculatorPage.jsx`)
- CoQ calculator → CoQ state: uses (evidence: `src/components/CoqCalculator.jsx`)
- Overview → CoQ state: uses (evidence: `src/pages/Overview.jsx`)
- Dashboard shell → Auth state: uses (evidence: `src/pages/DashboardLayout.jsx`)
- Dashboard shell → CoQ state: uses (evidence: `src/pages/DashboardLayout.jsx`)
- CoQ state → CoQ service: calls (evidence: `src/context/CoqContext.jsx`)
- Settings page → System service: calls (evidence: `src/pages/Settings.jsx`)
- Auth service → API client: calls (evidence: `src/services/authService.js`)
- CoQ service → API client: calls (evidence: `src/services/coqService.js`)
- System service → API client: calls (evidence: `src/services/systemService.js`)
- API client → API server: sends API requests (evidence: `README.md`)
- API server → Authentication routes: mounts (evidence: `server/server.js`)
- API server → CoQ and scenarios: mounts (evidence: `server/server.js`)
- API server → Settings routes: mounts (evidence: `server/server.js`)
- API server → Telemetry routes: mounts (evidence: `server/server.js`)
- Authentication routes → JSON database: reads and writes (evidence: `server/routes/authRoutes.js`)
- CoQ and scenarios → JSON database: reads and writes (evidence: `server/routes/coqRoutes.js`)
- Settings routes → JSON database: reads and writes (evidence: `server/routes/settingsRoutes.js`)
- Telemetry routes → JSON database: reads (evidence: `server/routes/systemRoutes.js`)
- JSON database → Database file: persists data (evidence: `README.md`)
