# deshpandechetan/internship-management-system architecture

> Architecture diagram of the GitHub repository deshpandechetan/internship-management-system, 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/deshpandechetan/internship-management-system
- Repository: https://github.com/deshpandechetan/internship-management-system

## Overview

IMS is a Django internship-management and assessment application. Users authenticate through Google or existing accounts, then enter role-specific dashboards; students submit internship records and documents, mentors verify them, and evaluators record assessment marks that feed consolidated progress and reports. Administrators and coordinators manage users and academic entities. The graph includes documented capabilities whose implementation was not sampled; those relationships are cited to the README rather than presented as inspected call paths.

Main entry points: [`apps/core/mentor_views.py`](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/mentor_views.py) (Mentor workflow), [`apps/core/urls.py`](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/urls.py) (Role dashboards), [`apps/core/student_views.py`](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/student_views.py) (Student workflow), [`apps/core/admin_views.py`](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/admin_views.py) (Admin management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_auth["Authentication<br/>[adapter.py]"]
  node_access["Role permissions<br/>[permissions.py]"]
  node_routing["Role dashboards<br/>[urls.py]"]
end

subgraph group_workflows["Internship workflows"]
  node_student["Student workflow<br/>[student_views.py]"]
  node_mentor["Mentor workflow<br/>[mentor_views.py]"]
  node_hod["Coordinator workflow<br/>[hod_views.py]"]
  node_documents["Document access<br/>[documents.py]"]
  node_forms["Workflow forms<br/>[forms.py]"]
end

subgraph group_assessment["Assessment and reporting"]
  node_evaluator["Evaluator workflow<br/>[evaluator_views.py]"]
  node_calculations["Score calculations<br/>[calculations.py]"]
  node_reports["Reports and exports"]
end

subgraph group_records["Records and operations"]
  node_profiles[("User profiles<br/>[models.py]")]
  node_admin["Admin management<br/>[admin_views.py]"]
  node_models[("IMS records<br/>[models.py]")]
  node_audit["Audit logging<br/>[audit.py]"]
  node_notifications["Notifications<br/>[notifications.py]"]
end

node_user(("IMS user"))
node_google{{"Google OAuth"}}

node_user -->|"signs in"| node_auth
node_google -->|"authenticates via"| node_auth
node_auth -->|"checks and creates"| node_profiles
node_auth -->|"redirects by role"| node_routing
node_routing -->|"routes requests"| node_admin
node_routing -->|"routes requests"| node_student
node_routing -->|"routes requests"| node_mentor
node_routing -->|"routes requests"| node_evaluator
node_routing -->|"routes requests"| node_hod
node_student -->|"validates submissions"| node_forms
node_mentor -->|"uses forms"| node_forms
node_admin -->|"uses forms"| node_forms
node_student -->|"reads and writes"| node_models
node_mentor -->|"reads and updates"| node_models
node_admin -->|"manages records"| node_models
node_evaluator -.->|"records assessments"| node_models
node_hod -.->|"manages academic data"| node_models
node_student -->|"uses document links"| node_documents
node_mentor -->|"uses document links"| node_documents
node_documents -->|"reads internship files"| node_models
node_evaluator -.->|"uses scoring"| node_calculations
node_student -->|"calculates progress"| node_calculations
node_mentor -->|"calculates progress"| node_calculations
node_reports -->|"uses score logic"| node_calculations
node_admin -->|"generates exports"| node_reports
node_admin -->|"records actions"| node_audit
node_student -->|"records actions"| node_audit
node_mentor -->|"records actions"| node_audit
node_admin -->|"sends notifications"| node_notifications
node_mentor -->|"sends notifications"| node_notifications

click node_auth "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/authentication/adapter.py"
click node_access "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/authentication/permissions.py"
click node_profiles "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/authentication/models.py"
click node_routing "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/urls.py"
click node_admin "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/admin_views.py"
click node_student "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/student_views.py"
click node_mentor "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/mentor_views.py"
click node_evaluator "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/evaluator_views.py"
click node_hod "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/hod_views.py"
click node_documents "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/documents.py"
click node_forms "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/forms.py"
click node_models "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/models.py"
click node_calculations "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/calculations.py"
click node_reports "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/report_generator.py"
click node_audit "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/audit.py"
click node_notifications "https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/notifications.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_auth,node_access,node_routing,node_user toneBlue
class node_student,node_mentor,node_hod,node_documents,node_forms toneAmber
class node_evaluator,node_calculations,node_reports toneMint
class node_profiles,node_admin,node_models,node_audit,node_notifications toneRose
class node_google toneIndigo
```

## Components

### Identity and access

- [Authentication](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/authentication/adapter.py): `apps/authentication/adapter.py`
- [Role permissions](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/authentication/permissions.py): `apps/authentication/permissions.py`
- [Role dashboards](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/urls.py): `apps/core/urls.py`

### Internship workflows

- [Student workflow](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/student_views.py): `apps/core/student_views.py`
- [Mentor workflow](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/mentor_views.py): `apps/core/mentor_views.py`
- [Coordinator workflow](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/hod_views.py): `apps/core/hod_views.py`
- [Document access](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/documents.py): `apps/core/documents.py`
- [Workflow forms](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/forms.py): `apps/core/forms.py`

### Assessment and reporting

- [Evaluator workflow](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/evaluator_views.py): `apps/core/evaluator_views.py`
- [Score calculations](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/calculations.py): `apps/core/calculations.py`
- [Reports and exports](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/report_generator.py): `apps/core/report_generator.py`

### Records and operations

- [User profiles](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/authentication/models.py): `apps/authentication/models.py`
- [Admin management](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/admin_views.py): `apps/core/admin_views.py`
- [IMS records](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/models.py): `apps/core/models.py`
- [Audit logging](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/audit.py): `apps/core/audit.py`
- [Notifications](https://github.com/deshpandechetan/internship-management-system/blob/main/apps/core/notifications.py): `apps/core/notifications.py`

### Other components

- **IMS user**
- **Google OAuth**

## Connections

- IMS user → Authentication: signs in
- Google OAuth → Authentication: authenticates via
- Authentication → User profiles: checks and creates (evidence: `apps/authentication/adapter.py`)
- Authentication → Role dashboards: redirects by role (evidence: `apps/authentication/adapter.py`)
- Role dashboards → Admin management: routes requests (evidence: `apps/core/urls.py`)
- Role dashboards → Student workflow: routes requests (evidence: `apps/core/urls.py`)
- Role dashboards → Mentor workflow: routes requests (evidence: `apps/core/urls.py`)
- Role dashboards → Evaluator workflow: routes requests (evidence: `apps/core/urls.py`)
- Role dashboards → Coordinator workflow: routes requests (evidence: `apps/core/urls.py`)
- Student workflow → Workflow forms: validates submissions (evidence: `apps/core/student_views.py`)
- Mentor workflow → Workflow forms: uses forms (evidence: `apps/core/mentor_views.py`)
- Admin management → Workflow forms: uses forms (evidence: `apps/core/admin_views.py`)
- Student workflow → IMS records: reads and writes (evidence: `apps/core/student_views.py`)
- Mentor workflow → IMS records: reads and updates (evidence: `apps/core/mentor_views.py`)
- Admin management → IMS records: manages records (evidence: `apps/core/admin_views.py`)
- Evaluator workflow → IMS records: records assessments
- Coordinator workflow → IMS records: manages academic data
- Student workflow → Document access: uses document links (evidence: `apps/core/student_views.py`)
- Mentor workflow → Document access: uses document links (evidence: `apps/core/mentor_views.py`)
- Document access → IMS records: reads internship files (evidence: `apps/core/documents.py`)
- Evaluator workflow → Score calculations: uses scoring
- Student workflow → Score calculations: calculates progress (evidence: `apps/core/student_views.py`)
- Mentor workflow → Score calculations: calculates progress (evidence: `apps/core/mentor_views.py`)
- Reports and exports → Score calculations: uses score logic (evidence: `apps/core/report_generator.py`)
- Admin management → Reports and exports: generates exports (evidence: `apps/core/admin_views.py`)
- Admin management → Audit logging: records actions (evidence: `apps/core/admin_views.py`)
- Student workflow → Audit logging: records actions (evidence: `apps/core/student_views.py`)
- Mentor workflow → Audit logging: records actions (evidence: `apps/core/mentor_views.py`)
- Admin management → Notifications: sends notifications (evidence: `apps/core/admin_views.py`)
- Mentor workflow → Notifications: sends notifications (evidence: `apps/core/mentor_views.py`)
