# mohitkumar6122/online-examination-system architecture

> Architecture diagram of the GitHub repository mohitkumar6122/online-examination-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mohitkumar6122/online-examination-system
- Repository: https://github.com/mohitkumar6122/online-examination-system

## Overview

##### Project type and purpose
- This is a full-stack, monolithic web application built on the Django framework.
- Its purpose is to deliver an Online Examination System, with distinct interfaces and workflows for Students, Professors, and Administrators.

##### File structure
- Top-level “Exam” directory is the Django project root. Under it:
- examProject/ – project settings, URL router, WSGI/ASGI entrypoints, global static files
- Multiple Django apps by domain: admission, course, faculty, questions, resultprocessing, student, studentPreferences, tuition
- templates/ – shared and per-app HTML templates
- media/ – user-uploaded content (profile pictures)
- db.sqlite3 – default database
- manage.py, Pipfile, requirements.txt – build, environment, dependencies
- Each app follows standard Django MVC: models.py, views.py, urls.py, admin.py, migrations/, templates (in some), tests.py.
- Static assets (CSS, JS, images) live under examProject/static and templates/static.

##### README for additional insights
- Stack: Python, Django, HTML/CSS/JavaScript, SQLite (or configurable RDBMS), Pipenv, Argon2 password hashing.
- Features: auto-submit, focus monitoring with email alert (external SMTP), automatic scoring.
- Actors: Students, Professors, Admins (superuser + Django Groups).

##### Detail without over-fragmentation
- Domain app as a separate element within the server layer.
- Shared components (template engine, static files).
- User-group logic (Students vs Professors) gating access to specific apps or views.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Client Layer
    subgraph "Client Browsers"
        style Client fill:#cce5ff,stroke:#333,stroke-width:1px
        StudentBrowser["Student Browser"]:::client
        ProfessorBrowser["Professor Browser"]:::client
        AdminBrowser["Admin Browser"]:::client
    end

    %% Server Layer
    subgraph "Django Web Server"
        style Server fill:#d4edda,stroke:#333,stroke-width:1px
        Settings["Project Settings & Entrypoints"]:::server
        URLRouter["URL Router"]:::server

        subgraph "App Modules"
            style Apps fill:#d4edda,stroke:#333,stroke-width:1px
            AdmissionApp["admission app"]:::server
            CourseApp["course app"]:::server
            FacultyApp["faculty app"]:::server
            QuestionsApp["questions app"]:::server
            ResultApp["resultprocessing app"]:::server
            StudentApp["student app"]:::server
            PrefApp["studentPreferences app"]:::server
            TuitionApp["tuition app"]:::server
            DjangoAdmin["Django Admin Interface"]:::server
        end

        Templates["Templates"]:::server
        StaticProj["Static Assets (Project)"]:::server
        StaticTmpl["Static Assets (Templates)"]:::server
    end

    %% Database & Storage & External
    Database["Database"]:::db
    MediaStorage["Media Storage"]:::storage
    EmailService["External Email Service (SMTP)"]:::external

    %% Connections
    StudentBrowser -->|+HTTP GET/POST| URLRouter
    ProfessorBrowser -->|+HTTP GET/POST| URLRouter
    AdminBrowser -->|+HTTP GET/POST| URLRouter
    StudentBrowser -->|+Focus Event| URLRouter

    URLRouter -->|"routes"| AdmissionApp
    URLRouter -->|"routes"| CourseApp
    URLRouter -->|"routes"| FacultyApp
    URLRouter -->|"routes"| QuestionsApp
    URLRouter -->|"routes"| ResultApp
    URLRouter -->|"routes"| StudentApp
    URLRouter -->|"routes"| PrefApp
    URLRouter -->|"routes"| TuitionApp
    URLRouter -->|"routes"| DjangoAdmin

    AdmissionApp -->|+ORM queries| Database
    CourseApp -->|+ORM queries| Database
    FacultyApp -->|+ORM queries| Database
    QuestionsApp -->|+ORM queries| Database
    ResultApp -->|+ORM queries| Database
    StudentApp -->|+ORM queries| Database
    PrefApp -->|+ORM queries| Database
    TuitionApp -->|+ORM queries| Database
    DjangoAdmin -->|+ORM queries| Database

    AdmissionApp -->|uploads/downloads| MediaStorage
    CourseApp -->|uploads/downloads| MediaStorage
    FacultyApp -->|uploads/downloads| MediaStorage
    StudentApp -->|uploads/downloads| MediaStorage
    TuitionApp -->|uploads/downloads| MediaStorage

    URLRouter -->|renders| Templates
    URLRouter -->|serves| StaticProj
    URLRouter -->|serves| StaticTmpl

    URLRouter -->|sends alerts/resets| EmailService
    QuestionsApp -->|sends alerts| EmailService
    StudentApp -->|sends alerts| EmailService

    %% Click Events
    click Settings "https://github.com/mohitkumar6122/online-examination-system/blob/master/Exam/examProject/settings.py"
    click URLRouter "https://github.com/mohitkumar6122/online-examination-system/blob/master/Exam/examProject/urls.py"
    click AdmissionApp "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/admission/"
    click CourseApp "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/course/"
    click FacultyApp "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/faculty/"
    click QuestionsApp "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/questions/"
    click ResultApp "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/resultprocessing/"
    click StudentApp "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/student/"
    click PrefApp "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/studentPreferences/"
    click TuitionApp "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/tuition/"
    click DjangoAdmin "https://github.com/mohitkumar6122/online-examination-system/blob/master/Exam/admission/admin.py"
    click Templates "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/templates/"
    click StaticProj "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/examProject/static/"
    click StaticTmpl "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/templates/static/"
    click MediaStorage "https://github.com/mohitkumar6122/online-examination-system/tree/master/Exam/media/"
    click Database "https://github.com/mohitkumar6122/online-examination-system/blob/master/Exam/db.sqlite3"
    click Settings "https://github.com/mohitkumar6122/online-examination-system/blob/master/Exam/examProject/settings.py"
    click Settings_WSGI "https://github.com/mohitkumar6122/online-examination-system/blob/master/Exam/examProject/wsgi.py"
    click Settings_ASGI "https://github.com/mohitkumar6122/online-examination-system/blob/master/Exam/examProject/asgi.py"

    %% Styles
    classDef client fill:#cce5ff,stroke:#333,stroke-width:1px
    classDef server fill:#d4edda,stroke:#333,stroke-width:1px
    classDef db fill:#ffe5b4,stroke:#333,stroke-width:1px
    classDef external fill:#fff3cd,stroke:#333,stroke-width:1px
    classDef storage fill:#e2e3e5,stroke:#333,stroke-width:1px
```
