# rahichy3002/test_site architecture

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

- Interactive diagram: https://gitdiagram.com/rahichy3002/test_site
- Repository: https://github.com/rahichy3002/test_site

## Overview

Progsity is a browser-based programming exam simulator with a local judge. The main workflow is: a candidate selects a problem, edits a solution, runs it against sample or custom input, and submits it for sample-plus-hidden-test grading. A separate sandbox scans and executes untrusted code; the client also offers proctoring monitors, watermark simulation, and an audit log. The problem builder is included as a distinct authoring capability. Relationships are limited to calls and data access shown in the excerpts; the README is empty and some source is unsampled.

Main entry points: [`server.py`](https://github.com/rahichy3002/test_site/blob/main/server.py) (HTTP API Handler), [`static/app.js`](https://github.com/rahichy3002/test_site/blob/main/static/app.js) (Exam Interface), [`sandbox_guard.py`](https://github.com/rahichy3002/test_site/blob/main/sandbox_guard.py) (Sandbox Engine), [`problems`](https://github.com/rahichy3002/test_site/tree/main/problems) (Problem Catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_exam["Exam Client"]
  node_exam_ui["Exam Interface<br/>[app.js]"]
  node_problem_navigation["Problem Navigation<br/>[app.js]"]
  node_code_editor["Code Editor<br/>[app.js]"]
  node_sample_run_ui["Sample Run UI<br/>[app.js]"]
  node_submission_ui["Submission UI<br/>[app.js]"]
  node_proctoring["Proctoring Monitors<br/>[app.js]"]
  node_watermark_audit["Watermark And Audit<br/>[app.js]"]
end

subgraph group_judge["Judge Server"]
  node_http_api["HTTP API Handler<br/>[server.py]"]
  node_problem_catalog[("Problem Catalog")]
  node_sample_grading["Sample Evaluation<br/>[server.py]"]
  node_hidden_grading["Hidden-Test Grading<br/>[server.py]"]
end

subgraph group_sandbox["Sandbox Execution"]
  node_sandbox_engine["Sandbox Engine<br/>[sandbox_guard.py]"]
  node_security_scanner["Code Security Scanner<br/>[sandbox_guard.py]"]
  node_process_isolation["Process Isolation<br/>[sandbox_guard.py]"]
  node_language_runners["Language Runners<br/>[sandbox_guard.py]"]
end

subgraph group_authoring["Problem Authoring"]
  node_problem_builder["Problem Builder"]
end

node_candidate(("Candidate"))

node_candidate -->|"uses"| node_exam_ui
node_exam_ui -->|"navigates"| node_problem_navigation
node_exam_ui -->|"edits solutions"| node_code_editor
node_exam_ui -->|"configures"| node_proctoring
node_exam_ui -->|"configures"| node_watermark_audit
node_problem_navigation -->|"fetches problems"| node_http_api
node_http_api -->|"reads"| node_problem_catalog
node_sample_run_ui -->|"posts run"| node_http_api
node_submission_ui -->|"posts submission"| node_http_api
node_http_api -->|"dispatches run"| node_sample_grading
node_http_api -->|"dispatches submission"| node_hidden_grading
node_sample_grading -->|"reads tests"| node_problem_catalog
node_hidden_grading -->|"reads tests"| node_problem_catalog
node_sample_grading -->|"executes code"| node_sandbox_engine
node_hidden_grading -->|"executes code"| node_sandbox_engine
node_sandbox_engine -.->|"checks code"| node_security_scanner
node_sandbox_engine -.->|"isolates process"| node_process_isolation
node_sandbox_engine -.->|"runs language"| node_language_runners

click node_exam_ui "https://github.com/rahichy3002/test_site/blob/main/static/app.js"
click node_problem_navigation "https://github.com/rahichy3002/test_site/blob/main/static/app.js"
click node_code_editor "https://github.com/rahichy3002/test_site/blob/main/static/app.js"
click node_sample_run_ui "https://github.com/rahichy3002/test_site/blob/main/static/app.js"
click node_submission_ui "https://github.com/rahichy3002/test_site/blob/main/static/app.js"
click node_proctoring "https://github.com/rahichy3002/test_site/blob/main/static/app.js"
click node_watermark_audit "https://github.com/rahichy3002/test_site/blob/main/static/app.js"
click node_http_api "https://github.com/rahichy3002/test_site/blob/main/server.py"
click node_problem_catalog "https://github.com/rahichy3002/test_site/tree/main/problems"
click node_sample_grading "https://github.com/rahichy3002/test_site/blob/main/server.py"
click node_hidden_grading "https://github.com/rahichy3002/test_site/blob/main/server.py"
click node_sandbox_engine "https://github.com/rahichy3002/test_site/blob/main/sandbox_guard.py"
click node_security_scanner "https://github.com/rahichy3002/test_site/blob/main/sandbox_guard.py"
click node_process_isolation "https://github.com/rahichy3002/test_site/blob/main/sandbox_guard.py"
click node_language_runners "https://github.com/rahichy3002/test_site/blob/main/sandbox_guard.py"
click node_problem_builder "https://github.com/rahichy3002/test_site/blob/main/build_20_problems.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_exam_ui,node_problem_navigation,node_code_editor,node_sample_run_ui,node_submission_ui,node_proctoring,node_watermark_audit toneBlue
class node_http_api,node_problem_catalog,node_sample_grading,node_hidden_grading toneAmber
class node_sandbox_engine,node_security_scanner,node_process_isolation,node_language_runners toneMint
class node_problem_builder toneRose
class node_candidate toneIndigo
```

## Components

### Exam Client

- [Exam Interface](https://github.com/rahichy3002/test_site/blob/main/static/app.js): `static/app.js`
- [Problem Navigation](https://github.com/rahichy3002/test_site/blob/main/static/app.js): `static/app.js`
- [Code Editor](https://github.com/rahichy3002/test_site/blob/main/static/app.js): `static/app.js`
- [Sample Run UI](https://github.com/rahichy3002/test_site/blob/main/static/app.js): `static/app.js`
- [Submission UI](https://github.com/rahichy3002/test_site/blob/main/static/app.js): `static/app.js`
- [Proctoring Monitors](https://github.com/rahichy3002/test_site/blob/main/static/app.js): `static/app.js`
- [Watermark And Audit](https://github.com/rahichy3002/test_site/blob/main/static/app.js): `static/app.js`

### Judge Server

- [HTTP API Handler](https://github.com/rahichy3002/test_site/blob/main/server.py): `server.py`
- [Problem Catalog](https://github.com/rahichy3002/test_site/tree/main/problems): `problems`
- [Sample Evaluation](https://github.com/rahichy3002/test_site/blob/main/server.py): `server.py`
- [Hidden-Test Grading](https://github.com/rahichy3002/test_site/blob/main/server.py): `server.py`

### Sandbox Execution

- [Sandbox Engine](https://github.com/rahichy3002/test_site/blob/main/sandbox_guard.py): `sandbox_guard.py`
- [Code Security Scanner](https://github.com/rahichy3002/test_site/blob/main/sandbox_guard.py): `sandbox_guard.py`
- [Process Isolation](https://github.com/rahichy3002/test_site/blob/main/sandbox_guard.py): `sandbox_guard.py`
- [Language Runners](https://github.com/rahichy3002/test_site/blob/main/sandbox_guard.py): `sandbox_guard.py`

### Problem Authoring

- [Problem Builder](https://github.com/rahichy3002/test_site/blob/main/build_20_problems.py): `build_20_problems.py`

### Other components

- **Candidate**

## Connections

- Candidate → Exam Interface: uses (evidence: `static/app.js`)
- Exam Interface → Problem Navigation: navigates (evidence: `static/app.js`)
- Exam Interface → Code Editor: edits solutions (evidence: `static/app.js`)
- Exam Interface → Proctoring Monitors: configures (evidence: `static/app.js`)
- Exam Interface → Watermark And Audit: configures (evidence: `static/app.js`)
- Problem Navigation → HTTP API Handler: fetches problems (evidence: `static/app.js`)
- HTTP API Handler → Problem Catalog: reads (evidence: `server.py`)
- Sample Run UI → HTTP API Handler: posts run (evidence: `static/app.js`)
- Submission UI → HTTP API Handler: posts submission (evidence: `static/app.js`)
- HTTP API Handler → Sample Evaluation: dispatches run (evidence: `server.py`)
- HTTP API Handler → Hidden-Test Grading: dispatches submission (evidence: `server.py`)
- Sample Evaluation → Problem Catalog: reads tests (evidence: `server.py`)
- Hidden-Test Grading → Problem Catalog: reads tests (evidence: `server.py`)
- Sample Evaluation → Sandbox Engine: executes code (evidence: `server.py`)
- Hidden-Test Grading → Sandbox Engine: executes code (evidence: `server.py`)
- Sandbox Engine → Code Security Scanner: checks code (evidence: `sandbox_guard.py`)
- Sandbox Engine → Process Isolation: isolates process (evidence: `sandbox_guard.py`)
- Sandbox Engine → Language Runners: runs language (evidence: `sandbox_guard.py`)
