# utkarshhh0/head-hunters-sih26157 architecture

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

- Interactive diagram: https://gitdiagram.com/utkarshhh0/head-hunters-sih26157
- Repository: https://github.com/utkarshhh0/head-hunters-sih26157

## Overview

SAT-SA is a React-based supervisory analytics tool for reviewing SOC assessment submissions. Its displayed workflow covers submission, data-quality validation, normalization, and assessment; the sampled implementation uses synthetic in-memory records rather than an external ingestion service or database. The App presents findings, entity capability status, and a manual review queue, while analytics derives metrics and findings from the records. Evidence is limited to the README and sampled source excerpts, so no unsampled runtime connections are asserted.

Main entry points: [`src/App.tsx`](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx) (Assessment UI), [`src/analytics.ts`](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/analytics.ts) (Assessment analytics), [`src/data.ts`](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/data.ts) (Synthetic assessment data), [`src/main.tsx`](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/main.tsx) (React mount)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_main["React mount<br/>[main.tsx]"]
end

subgraph group_experience["Assessment experience"]
  node_app["Assessment UI<br/>[App.tsx]"]
  node_workflow["Assessment workflow<br/>[App.tsx]"]
  node_quality["Data quality review<br/>[App.tsx]"]
  node_findings_view["Findings register<br/>[App.tsx]"]
  node_entity_view["Entity assessment<br/>[App.tsx]"]
  node_review_view["Manual review queue<br/>[App.tsx]"]
end

subgraph group_analysis["Assessment analytics"]
  node_analytics["Assessment analytics<br/>[analytics.ts]"]
  node_metrics["Entity metrics<br/>[analytics.ts]"]
  node_findings["Supervisory findings<br/>[analytics.ts]"]
  node_review_queue["Review samples<br/>[analytics.ts]"]
  node_capabilities["Capability status<br/>[analytics.ts]"]
end

subgraph group_records["Assessment records"]
  node_data["Synthetic assessment data<br/>[data.ts]"]
  node_operational_records["SOC operational records<br/>[data.ts]"]
  node_assessment_records["Assessment totals<br/>[data.ts]"]
end

node_main -->|"mounts"| node_app
node_app -->|"presents"| node_workflow
node_app -->|"presents"| node_quality
node_app -->|"presents"| node_findings_view
node_app -->|"presents"| node_entity_view
node_app -->|"presents"| node_review_view
node_app -->|"uses analysis"| node_analytics
node_app -->|"reads records"| node_data
node_analytics -->|"analyzes records"| node_data
node_analytics -->|"derives"| node_metrics
node_analytics -->|"derives"| node_findings
node_analytics -->|"samples findings"| node_review_queue
node_analytics -->|"evaluates"| node_capabilities
node_data -->|"defines"| node_operational_records
node_data -->|"defines"| node_assessment_records
node_findings_view -->|"displays"| node_findings
node_entity_view -->|"displays"| node_metrics
node_entity_view -->|"displays"| node_capabilities
node_review_view -->|"displays"| node_review_queue

click node_main "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/main.tsx"
click node_app "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx"
click node_workflow "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx"
click node_quality "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx"
click node_findings_view "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx"
click node_entity_view "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx"
click node_review_view "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx"
click node_analytics "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/analytics.ts"
click node_metrics "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/analytics.ts"
click node_findings "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/analytics.ts"
click node_review_queue "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/analytics.ts"
click node_capabilities "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/analytics.ts"
click node_data "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/data.ts"
click node_operational_records "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/data.ts"
click node_assessment_records "https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/data.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_main toneBlue
class node_app,node_workflow,node_quality,node_findings_view,node_entity_view,node_review_view toneAmber
class node_analytics,node_metrics,node_findings,node_review_queue,node_capabilities toneMint
class node_data,node_operational_records,node_assessment_records toneRose
```

## Components

### Application entry

- [React mount](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/main.tsx): `src/main.tsx`

### Assessment experience

- [Assessment UI](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx): `src/App.tsx`
- [Assessment workflow](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx): `src/App.tsx`
- [Data quality review](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx): `src/App.tsx`
- [Findings register](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx): `src/App.tsx`
- [Entity assessment](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx): `src/App.tsx`
- [Manual review queue](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/App.tsx): `src/App.tsx`

### Assessment analytics

- [Assessment analytics](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/analytics.ts): `src/analytics.ts`
- [Entity metrics](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/analytics.ts): `src/analytics.ts`
- [Supervisory findings](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/analytics.ts): `src/analytics.ts`
- [Review samples](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/analytics.ts): `src/analytics.ts`
- [Capability status](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/analytics.ts): `src/analytics.ts`

### Assessment records

- [Synthetic assessment data](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/data.ts): `src/data.ts`
- [SOC operational records](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/data.ts): `src/data.ts`
- [Assessment totals](https://github.com/utkarshhh0/head-hunters-sih26157/blob/main/src/data.ts): `src/data.ts`

## Connections

- React mount → Assessment UI: mounts (evidence: `src/main.tsx`)
- Assessment UI → Assessment workflow: presents (evidence: `src/App.tsx`)
- Assessment UI → Data quality review: presents (evidence: `src/App.tsx`)
- Assessment UI → Findings register: presents (evidence: `src/App.tsx`)
- Assessment UI → Entity assessment: presents (evidence: `src/App.tsx`)
- Assessment UI → Manual review queue: presents (evidence: `src/App.tsx`)
- Assessment UI → Assessment analytics: uses analysis (evidence: `src/App.tsx`)
- Assessment UI → Synthetic assessment data: reads records (evidence: `src/App.tsx`)
- Assessment analytics → Synthetic assessment data: analyzes records (evidence: `src/analytics.ts`)
- Assessment analytics → Entity metrics: derives (evidence: `src/analytics.ts`)
- Assessment analytics → Supervisory findings: derives (evidence: `src/analytics.ts`)
- Assessment analytics → Review samples: samples findings (evidence: `src/analytics.ts`)
- Assessment analytics → Capability status: evaluates (evidence: `src/analytics.ts`)
- Synthetic assessment data → SOC operational records: defines (evidence: `src/data.ts`)
- Synthetic assessment data → Assessment totals: defines (evidence: `src/data.ts`)
- Findings register → Supervisory findings: displays (evidence: `src/App.tsx`)
- Entity assessment → Entity metrics: displays (evidence: `src/App.tsx`)
- Entity assessment → Capability status: displays (evidence: `src/App.tsx`)
- Manual review queue → Review samples: displays (evidence: `src/App.tsx`)
