# muralidanda0/super-detect_sih_project architecture

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

- Interactive diagram: https://gitdiagram.com/muralidanda0/super-detect_sih_project
- Repository: https://github.com/muralidanda0/super-detect_sih_project

## Overview

DetectSus combines camera-side exam monitoring with a Django dashboard. The main flow is camera footage through detection and evidence capture into persistent malpractice records, followed by staff review. The README documents several detection capabilities and optional remote transfer; source excerpts confirm those mechanics in front.py, while other detector scripts were not sampled in full. Dashboard and model relationships are supported by the URL/view excerpts and source index; unsampled wiring is not inferred.

Main entry points: [`app/views.py`](https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/views.py) (Dashboard Views), [`ML/front.py`](https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/front.py) (Front Monitor), [`app/urls.py`](https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/urls.py) (Web Routes), [`app/models.py`](https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/models.py) (Hall & Teacher Records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_monitor["Camera Monitoring"]
  node_front["Front Monitor<br/>[front.py]"]
  node_unified["Unified Monitor<br/>[exam_monitor.py]"]
  node_turnmobile["Turn &amp; Phone<br/>[detect2.py]"]
  node_detector["Detection Script<br/>[detect.py]"]
  node_final["Final Detector<br/>[final.py]"]
  node_hand["Hand Raise<br/>[hand_raise.py]"]
  node_lean["Leaning Check<br/>[leaning.py]"]
  node_mobile["Phone Detection"]
  node_passing["Paper Passing<br/>[passing_paper.py]"]
  node_top["Top View Monitor<br/>[top.py]"]
end

subgraph group_web["Dashboard"]
  node_routes["Web Routes<br/>[urls.py]"]
  node_views["Dashboard Views<br/>[views.py]"]
  node_forms["User Forms<br/>[forms.py]"]
end

subgraph group_domain["Exam Records"]
  node_hall[("Hall &amp; Teacher Records<br/>[models.py]")]
  node_events[("Malpractice Records<br/>[models.py]")]
end

subgraph group_infra["Runtime Services"]
  node_db[("MySQL Database")]
end

node_camera(("Exam Camera"))
node_webuser(("Teacher / Admin"))
node_remote["Remote Server"]

node_camera -->|"captures from"| node_front
node_front -->|"writes detections"| node_db
node_front -.->|"transfers proof"| node_remote
node_webuser -->|"uses dashboard"| node_routes
node_routes -->|"routes requests"| node_views
node_views -->|"reads and updates"| node_hall
node_views -->|"lists and reviews"| node_events
node_views -->|"uses forms"| node_forms
node_events -.->|"persists records"| node_db
node_hall -.->|"persists records"| node_db

click node_front "https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/front.py"
click node_unified "https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/exam_monitor.py"
click node_turnmobile "https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/detect2.py"
click node_detector "https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/detect.py"
click node_final "https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/final.py"
click node_hand "https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/hand_raise.py"
click node_lean "https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/leaning.py"
click node_mobile "https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/mobile_detection.py"
click node_passing "https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/passing_paper.py"
click node_top "https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/top.py"
click node_routes "https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/urls.py"
click node_views "https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/views.py"
click node_forms "https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/forms.py"
click node_hall "https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/models.py"
click node_events "https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/models.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_front,node_unified,node_turnmobile,node_detector,node_final,node_hand,node_lean,node_mobile,node_passing,node_top toneBlue
class node_routes,node_views,node_forms toneAmber
class node_hall,node_events,node_remote toneMint
class node_db toneRose
class node_camera,node_webuser toneIndigo
```

## Components

### Camera Monitoring

- [Front Monitor](https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/front.py): `ML/front.py`
- [Unified Monitor](https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/exam_monitor.py): `ML/exam_monitor.py`
- [Turn & Phone](https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/detect2.py): `ML/detect2.py`
- [Detection Script](https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/detect.py): `ML/detect.py`
- [Final Detector](https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/final.py): `ML/final.py`
- [Hand Raise](https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/hand_raise.py): `ML/hand_raise.py`
- [Leaning Check](https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/leaning.py): `ML/leaning.py`
- [Phone Detection](https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/mobile_detection.py): `ML/mobile_detection.py`
- [Paper Passing](https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/passing_paper.py): `ML/passing_paper.py`
- [Top View Monitor](https://github.com/muralidanda0/super-detect_sih_project/blob/main/ML/top.py): `ML/top.py`

### Dashboard

- [Web Routes](https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/urls.py): `app/urls.py`
- [Dashboard Views](https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/views.py): `app/views.py`
- [User Forms](https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/forms.py): `app/forms.py`

### Exam Records

- [Hall & Teacher Records](https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/models.py): `app/models.py`
- [Malpractice Records](https://github.com/muralidanda0/super-detect_sih_project/blob/main/app/models.py): `app/models.py`

### Runtime Services

- **MySQL Database**

### Other components

- **Exam Camera**
- **Teacher / Admin**
- **Remote Server**

## Connections

- Exam Camera → Front Monitor: captures from (evidence: `README.md`)
- Front Monitor → MySQL Database: writes detections (evidence: `ML/front.py`)
- Front Monitor → Remote Server: transfers proof (evidence: `ML/front.py`)
- Teacher / Admin → Web Routes: uses dashboard (evidence: `README.md`)
- Web Routes → Dashboard Views: routes requests (evidence: `app/urls.py`)
- Dashboard Views → Hall & Teacher Records: reads and updates (evidence: `app/views.py`)
- Dashboard Views → Malpractice Records: lists and reviews (evidence: `app/views.py`)
- Dashboard Views → User Forms: uses forms (evidence: `app/views.py`)
- Malpractice Records → MySQL Database: persists records (evidence: `README.md`)
- Hall & Teacher Records → MySQL Database: persists records (evidence: `README.md`)
