# sujanvbharadwaj/proctoring architecture

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

- Interactive diagram: https://gitdiagram.com/sujanvbharadwaj/proctoring
- Repository: https://github.com/sujanvbharadwaj/proctoring

## Overview

This browser-based proctoring app requests camera and microphone access, monitors a running test for presence, noise, mouse behavior, and browser events, then records violations with screenshots and displays a results log. The runtime is concentrated in one JavaScript file. The sampled excerpts show the main calls and state flow; unsampled HTML and model assets are not treated as evidence of additional runtime connections.

Main entry points: [`Procotoring/script.js`](https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js) (Test controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_monitoring["Test monitoring"]
  node_media["Media access<br/>[script.js]"]
  node_pose["Pose detection<br/>[script.js]"]
  node_mic["Noise monitoring<br/>[script.js]"]
  node_mouse["Mouse monitoring<br/>[script.js]"]
  node_browser["Browser events<br/>[script.js]"]
end

subgraph group_response["Violation response"]
  node_violations["Violation logging<br/>[script.js]"]
  node_screenshots["Screenshot capture<br/>[script.js]"]
  node_results["Test results<br/>[script.js]"]
end

subgraph group_runtime["Browser runtime"]
  node_proctor["Test controller<br/>[script.js]"]
  node_browserapis["Browser APIs"]
  node_mediapipe["MediaPipe Pose"]
end

node_candidate(("Candidate"))

node_candidate -->|"starts or ends"| node_proctor
node_proctor -->|"requests access"| node_media
node_media -->|"opens media stream"| node_browserapis
node_media -->|"starts monitoring"| node_mic
node_media -->|"initializes pose"| node_mediapipe
node_proctor -->|"starts checks"| node_pose
node_pose -->|"sends webcam image"| node_mediapipe
node_pose -->|"records absence"| node_violations
node_proctor -->|"starts tracking"| node_mouse
node_mouse -->|"records activity"| node_violations
node_proctor -->|"registers checks"| node_browser
node_browser -->|"records events"| node_violations
node_mic -->|"records loud noise"| node_violations
node_violations -->|"captures image"| node_screenshots
node_proctor -->|"resets and ends"| node_violations
node_proctor -->|"renders log"| node_results
node_screenshots -->|"draws webcam frame"| node_browserapis

click node_proctor "https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js"
click node_media "https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js"
click node_pose "https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js"
click node_mic "https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js"
click node_mouse "https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js"
click node_browser "https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js"
click node_violations "https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js"
click node_screenshots "https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js"
click node_results "https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js"

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_media,node_pose,node_mic,node_mouse,node_browser toneBlue
class node_violations,node_screenshots,node_results toneAmber
class node_proctor,node_browserapis,node_mediapipe toneMint
class node_candidate toneIndigo
```

## Components

### Test monitoring

- [Media access](https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js): `Procotoring/script.js`
- [Pose detection](https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js): `Procotoring/script.js`
- [Noise monitoring](https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js): `Procotoring/script.js`
- [Mouse monitoring](https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js): `Procotoring/script.js`
- [Browser events](https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js): `Procotoring/script.js`

### Violation response

- [Violation logging](https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js): `Procotoring/script.js`
- [Screenshot capture](https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js): `Procotoring/script.js`
- [Test results](https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js): `Procotoring/script.js`

### Browser runtime

- [Test controller](https://github.com/sujanvbharadwaj/proctoring/blob/master/Procotoring/script.js): `Procotoring/script.js`
- **Browser APIs**
- **MediaPipe Pose**

### Other components

- **Candidate**

## Connections

- Candidate → Test controller: starts or ends (evidence: `Procotoring/script.js`)
- Test controller → Media access: requests access (evidence: `Procotoring/script.js`)
- Media access → Browser APIs: opens media stream (evidence: `Procotoring/script.js`)
- Media access → Noise monitoring: starts monitoring (evidence: `Procotoring/script.js`)
- Media access → MediaPipe Pose: initializes pose (evidence: `Procotoring/script.js`)
- Test controller → Pose detection: starts checks (evidence: `Procotoring/script.js`)
- Pose detection → MediaPipe Pose: sends webcam image (evidence: `Procotoring/script.js`)
- Pose detection → Violation logging: records absence (evidence: `Procotoring/script.js`)
- Test controller → Mouse monitoring: starts tracking (evidence: `Procotoring/script.js`)
- Mouse monitoring → Violation logging: records activity (evidence: `Procotoring/script.js`)
- Test controller → Browser events: registers checks (evidence: `Procotoring/script.js`)
- Browser events → Violation logging: records events (evidence: `Procotoring/script.js`)
- Noise monitoring → Violation logging: records loud noise (evidence: `Procotoring/script.js`)
- Violation logging → Screenshot capture: captures image (evidence: `Procotoring/script.js`)
- Test controller → Violation logging: resets and ends (evidence: `Procotoring/script.js`)
- Test controller → Test results: renders log (evidence: `Procotoring/script.js`)
- Screenshot capture → Browser APIs: draws webcam frame (evidence: `Procotoring/script.js`)
