# jahnavi-deshkar/study_pod architecture

> Architecture diagram of the GitHub repository jahnavi-deshkar/study_pod, 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/jahnavi-deshkar/study_pod
- Repository: https://github.com/jahnavi-deshkar/study_pod

## Overview

Study_Pod is a Django portal for teachers, students, and parents. Users sign in and reach role-specific dashboards, then use academic services such as attendance, discussions, leave, timetables, and analytics, or manage and take assessments. The README documents these major capabilities and the role/class scoping; sampled views show leave submission, attendance marking, discussion access, and assessment restrictions. The graph keeps the exam engine distinct from general academics and shows the shared SQLite-backed domain models. Some README-listed features have no sampled implementation excerpts, so their internal links are omitted.

Main entry points: [`academics/models.py`](https://github.com/jahnavi-deshkar/study_pod/blob/main/academics/models.py) (Classes and records), [`accounts/views.py`](https://github.com/jahnavi-deshkar/study_pod/blob/main/accounts/views.py) (Sign-in and dashboards), [`academics/views.py`](https://github.com/jahnavi-deshkar/study_pod/blob/main/academics/views.py) (Academic workflows), [`exam_engine/views.py`](https://github.com/jahnavi-deshkar/study_pod/blob/main/exam_engine/views.py) (Assessment sessions and grading)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and portal"]
  node_account_views["Sign-in and dashboards<br/>[views.py]"]
  node_account_forms["Profile and notice forms<br/>[forms.py]"]
  node_account_models[("Users and profiles<br/>[models.py]")]
  node_assessment_setup["Assessment setup<br/>[views.py]"]
end

subgraph group_academics["Academic services"]
  node_academic_views["Academic workflows<br/>[views.py]"]
  node_academic_forms["Academic forms<br/>[forms.py]"]
  node_academic_models[("Classes and records<br/>[models.py]")]
  node_doubt_storage["Private doubt storage<br/>[storage.py]"]
end

subgraph group_exams["Assessment engine"]
  node_exam_views["Assessment sessions and grading<br/>[views.py]"]
  node_exam_forms["Question forms<br/>[forms.py]"]
  node_exam_models[("Questions and attempts<br/>[models.py]")]
end

subgraph group_data["Persistence and files"]
  node_sqlite[("SQLite database<br/>[db.sqlite3]")]
  node_uploads["Uploaded media"]
  node_private_uploads["Private doubt uploads"]
end

node_users(("Teachers, students, parents"))

node_users -->|"sign in"| node_account_views
node_users -->|"use academic services"| node_academic_views
node_users -->|"take assessments"| node_exam_views
node_account_views -->|"uses forms"| node_account_forms
node_account_views -->|"reads academic data"| node_academic_models
node_account_views -->|"authenticates users"| node_account_models
node_academic_views -->|"uses forms"| node_academic_forms
node_academic_views -->|"reads and writes"| node_academic_models
node_academic_views -->|"checks profiles"| node_account_models
node_academic_views -->|"reads assessment data"| node_exam_models
node_academic_models -->|"configures uploads"| node_doubt_storage
node_account_views -->|"creates assessments"| node_academic_models
node_exam_views -->|"uses forms"| node_exam_forms
node_exam_views -->|"manages attempts"| node_exam_models
node_exam_forms -->|"uses assessment models"| node_academic_models
node_account_models -.->|"persists profiles"| node_sqlite
node_academic_models -.->|"persists academic records"| node_sqlite
node_exam_models -.->|"persists attempts"| node_sqlite
node_academic_models -.->|"stores resources"| node_uploads
node_doubt_storage -->|"stores attachments"| node_private_uploads

click node_account_views "https://github.com/jahnavi-deshkar/study_pod/blob/main/accounts/views.py"
click node_account_forms "https://github.com/jahnavi-deshkar/study_pod/blob/main/accounts/forms.py"
click node_account_models "https://github.com/jahnavi-deshkar/study_pod/blob/main/accounts/models.py"
click node_academic_views "https://github.com/jahnavi-deshkar/study_pod/blob/main/academics/views.py"
click node_academic_forms "https://github.com/jahnavi-deshkar/study_pod/blob/main/academics/forms.py"
click node_academic_models "https://github.com/jahnavi-deshkar/study_pod/blob/main/academics/models.py"
click node_doubt_storage "https://github.com/jahnavi-deshkar/study_pod/blob/main/academics/storage.py"
click node_assessment_setup "https://github.com/jahnavi-deshkar/study_pod/blob/main/accounts/views.py"
click node_exam_views "https://github.com/jahnavi-deshkar/study_pod/blob/main/exam_engine/views.py"
click node_exam_forms "https://github.com/jahnavi-deshkar/study_pod/blob/main/exam_engine/forms.py"
click node_exam_models "https://github.com/jahnavi-deshkar/study_pod/blob/main/exam_engine/models.py"
click node_sqlite "https://github.com/jahnavi-deshkar/study_pod/blob/main/db.sqlite3"
click node_uploads "https://github.com/jahnavi-deshkar/study_pod/tree/main/media"
click node_private_uploads "https://github.com/jahnavi-deshkar/study_pod/tree/main/private_doubt_uploads"

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_account_views,node_account_forms,node_account_models,node_assessment_setup toneBlue
class node_academic_views,node_academic_forms,node_academic_models,node_doubt_storage toneAmber
class node_exam_views,node_exam_forms,node_exam_models toneMint
class node_sqlite,node_uploads,node_private_uploads toneRose
class node_users toneIndigo
```

## Components

### Identity and portal

- [Sign-in and dashboards](https://github.com/jahnavi-deshkar/study_pod/blob/main/accounts/views.py): `accounts/views.py`
- [Profile and notice forms](https://github.com/jahnavi-deshkar/study_pod/blob/main/accounts/forms.py): `accounts/forms.py`
- [Users and profiles](https://github.com/jahnavi-deshkar/study_pod/blob/main/accounts/models.py): `accounts/models.py`
- [Assessment setup](https://github.com/jahnavi-deshkar/study_pod/blob/main/accounts/views.py): `accounts/views.py`

### Academic services

- [Academic workflows](https://github.com/jahnavi-deshkar/study_pod/blob/main/academics/views.py): `academics/views.py`
- [Academic forms](https://github.com/jahnavi-deshkar/study_pod/blob/main/academics/forms.py): `academics/forms.py`
- [Classes and records](https://github.com/jahnavi-deshkar/study_pod/blob/main/academics/models.py): `academics/models.py`
- [Private doubt storage](https://github.com/jahnavi-deshkar/study_pod/blob/main/academics/storage.py): `academics/storage.py`

### Assessment engine

- [Assessment sessions and grading](https://github.com/jahnavi-deshkar/study_pod/blob/main/exam_engine/views.py): `exam_engine/views.py`
- [Question forms](https://github.com/jahnavi-deshkar/study_pod/blob/main/exam_engine/forms.py): `exam_engine/forms.py`
- [Questions and attempts](https://github.com/jahnavi-deshkar/study_pod/blob/main/exam_engine/models.py): `exam_engine/models.py`

### Persistence and files

- [SQLite database](https://github.com/jahnavi-deshkar/study_pod/blob/main/db.sqlite3): `db.sqlite3`
- [Uploaded media](https://github.com/jahnavi-deshkar/study_pod/tree/main/media): `media`
- [Private doubt uploads](https://github.com/jahnavi-deshkar/study_pod/tree/main/private_doubt_uploads): `private_doubt_uploads`

### Other components

- **Teachers, students, parents**

## Connections

- Teachers, students, parents → Sign-in and dashboards: sign in (evidence: `README.md`)
- Teachers, students, parents → Academic workflows: use academic services (evidence: `README.md`)
- Teachers, students, parents → Assessment sessions and grading: take assessments (evidence: `README.md`)
- Sign-in and dashboards → Profile and notice forms: uses forms (evidence: `accounts/views.py`)
- Sign-in and dashboards → Classes and records: reads academic data (evidence: `accounts/views.py`)
- Sign-in and dashboards → Users and profiles: authenticates users (evidence: `accounts/views.py`)
- Academic workflows → Academic forms: uses forms (evidence: `academics/views.py`)
- Academic workflows → Classes and records: reads and writes (evidence: `academics/views.py`)
- Academic workflows → Users and profiles: checks profiles (evidence: `academics/views.py`)
- Academic workflows → Questions and attempts: reads assessment data (evidence: `academics/views.py`)
- Classes and records → Private doubt storage: configures uploads (evidence: `academics/models.py`)
- Sign-in and dashboards → Classes and records: creates assessments (evidence: `accounts/views.py`)
- Assessment sessions and grading → Question forms: uses forms (evidence: `exam_engine/views.py`)
- Assessment sessions and grading → Questions and attempts: manages attempts (evidence: `exam_engine/views.py`)
- Question forms → Classes and records: uses assessment models (evidence: `exam_engine/forms.py`)
- Users and profiles → SQLite database: persists profiles (evidence: `README.md`)
- Classes and records → SQLite database: persists academic records (evidence: `README.md`)
- Questions and attempts → SQLite database: persists attempts (evidence: `README.md`)
- Classes and records → Uploaded media: stores resources (evidence: `README.md`)
- Private doubt storage → Private doubt uploads: stores attachments (evidence: `academics/storage.py`)
