# b-bhavani27/examnest- architecture

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

- Interactive diagram: https://gitdiagram.com/b-bhavani27/examnest-
- Repository: https://github.com/b-bhavani27/examnest-

## Overview

ExamNest is a Django exam platform for student account onboarding, proctored exam attempts, results, and administrator reporting. Student registration, activation and password recovery lead to a dashboard; an exam attempt proceeds through instructions and permissions, face verification, answering and submission, then results. Proctoring records warnings, violations and camera-based detections. Admins review student and exam performance and export reports. The sampled views and models show these relationships; some capabilities are represented by their enclosing source directory because their implementation was not excerpted.

Main entry points: [`admin_panel/views.py`](https://github.com/b-bhavani27/examnest-/blob/main/admin_panel/views.py) (Admin views), [`exams/views.py`](https://github.com/b-bhavani27/examnest-/blob/main/exams/views.py) (Exam workflow), [`accounts/views.py`](https://github.com/b-bhavani27/examnest-/blob/main/accounts/views.py) (Account workflows), [`accounts/models.py`](https://github.com/b-bhavani27/examnest-/blob/main/accounts/models.py) (Student)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Student accounts"]
  node_student[("Student<br/>[models.py]")]
  node_account_flow["Account workflows<br/>[views.py]"]
end

subgraph group_exam["Exam lifecycle"]
  node_exam_flow["Exam workflow<br/>[views.py]"]
  node_exam_data[("Exam records<br/>[models.py]")]
end

subgraph group_proctoring["Proctoring"]
  node_ai_check["Camera analysis<br/>[views.py]"]
end

subgraph group_administration["Administration"]
  node_admin_flow["Admin views<br/>[views.py]"]
  node_admin_data[("Admin accounts<br/>[models.py]")]
  node_report_export["Report exports<br/>[utils.py]"]
end

node_student_actor(("Student"))
node_admin_actor(("Administrator"))

node_student_actor -->|"uses accounts"| node_account_flow
node_account_flow -->|"creates and reads"| node_student
node_account_flow -->|"reads attempts"| node_exam_data
node_student_actor -->|"takes exam"| node_exam_flow
node_exam_flow -->|"loads student"| node_student
node_exam_flow -->|"records attempt"| node_exam_data
node_exam_flow -->|"analyzes camera"| node_ai_check
node_admin_actor -->|"manages exams"| node_admin_flow
node_admin_flow -->|"authenticates admin"| node_admin_data
node_admin_flow -->|"reads students"| node_student
node_admin_flow -->|"reads results"| node_exam_data
node_admin_flow -->|"builds exports"| node_report_export

click node_student "https://github.com/b-bhavani27/examnest-/blob/main/accounts/models.py"
click node_account_flow "https://github.com/b-bhavani27/examnest-/blob/main/accounts/views.py"
click node_exam_flow "https://github.com/b-bhavani27/examnest-/blob/main/exams/views.py"
click node_exam_data "https://github.com/b-bhavani27/examnest-/blob/main/exams/models.py"
click node_ai_check "https://github.com/b-bhavani27/examnest-/blob/main/exams/views.py"
click node_admin_flow "https://github.com/b-bhavani27/examnest-/blob/main/admin_panel/views.py"
click node_admin_data "https://github.com/b-bhavani27/examnest-/blob/main/admin_panel/models.py"
click node_report_export "https://github.com/b-bhavani27/examnest-/blob/main/admin_panel/utils.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_student,node_account_flow toneBlue
class node_exam_flow,node_exam_data toneAmber
class node_ai_check toneMint
class node_admin_flow,node_admin_data,node_report_export toneRose
class node_student_actor,node_admin_actor toneIndigo
```

## Components

### Student accounts

- [Student](https://github.com/b-bhavani27/examnest-/blob/main/accounts/models.py): `accounts/models.py`
- [Account workflows](https://github.com/b-bhavani27/examnest-/blob/main/accounts/views.py): `accounts/views.py`

### Exam lifecycle

- [Exam workflow](https://github.com/b-bhavani27/examnest-/blob/main/exams/views.py): `exams/views.py`
- [Exam records](https://github.com/b-bhavani27/examnest-/blob/main/exams/models.py): `exams/models.py`

### Proctoring

- [Camera analysis](https://github.com/b-bhavani27/examnest-/blob/main/exams/views.py): `exams/views.py`

### Administration

- [Admin views](https://github.com/b-bhavani27/examnest-/blob/main/admin_panel/views.py): `admin_panel/views.py`
- [Admin accounts](https://github.com/b-bhavani27/examnest-/blob/main/admin_panel/models.py): `admin_panel/models.py`
- [Report exports](https://github.com/b-bhavani27/examnest-/blob/main/admin_panel/utils.py): `admin_panel/utils.py`

### Other components

- **Student**
- **Administrator**

## Connections

- Student → Account workflows: uses accounts
- Account workflows → Student: creates and reads (evidence: `accounts/views.py`)
- Account workflows → Exam records: reads attempts (evidence: `accounts/views.py`)
- Student → Exam workflow: takes exam
- Exam workflow → Student: loads student (evidence: `exams/views.py`)
- Exam workflow → Exam records: records attempt (evidence: `exams/views.py`)
- Exam workflow → Camera analysis: analyzes camera (evidence: `exams/views.py`)
- Administrator → Admin views: manages exams
- Admin views → Admin accounts: authenticates admin (evidence: `admin_panel/views.py`)
- Admin views → Student: reads students (evidence: `admin_panel/views.py`)
- Admin views → Exam records: reads results (evidence: `admin_panel/views.py`)
- Admin views → Report exports: builds exports (evidence: `admin_panel/views.py`)
