# devaivaraja36-spec/isms architecture

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

- Interactive diagram: https://gitdiagram.com/devaivaraja36-spec/isms
- Repository: https://github.com/devaivaraja36-spec/isms

## Overview

This is an internship monitoring system with a React role-based interface and a Django backend. Students manage tasks and activities; mentors review work and track students; administrators oversee people, projects, progress, memos, and notifications. The frontend routes users to role-specific pages, while the backend models internship records and includes scheduled deadline notifications. The excerpts show routing, authentication, and notification-task internals, but not most page-to-API or backend URL wiring, so those relationships are omitted or marked unverified.

Main entry points: [`src/App.tsx`](https://github.com/devaivaraja36-spec/isms/blob/main/src/App.tsx) (Role-based routes), [`backend/students/models.py`](https://github.com/devaivaraja36-spec/isms/blob/main/backend/students/models.py) (Student profiles), [`backend/tasks/models.py`](https://github.com/devaivaraja36-spec/isms/blob/main/backend/tasks/models.py) (Tasks), [`backend/mentors/models.py`](https://github.com/devaivaraja36-spec/isms/blob/main/backend/mentors/models.py) (Mentor profiles)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["User interface"]
  node_app["Role-based routes<br/>[App.tsx]"]
  node_student_ui["Student workspace"]
  node_mentor_ui["Mentor workspace"]
  node_admin_ui["Admin console"]
  node_shared_ui["Shared pages"]
  node_sidebars["Role navigation"]
end

subgraph group_identity["Identity and access"]
  node_auth_provider["Auth state<br/>[AuthContext.tsx]"]
  node_auth_api["Auth API<br/>[auth.js]"]
  node_api_client["API client<br/>[client.js]"]
  node_theme["Theme preferences<br/>[ThemeContext.tsx]"]
  node_websocket["Realtime context"]
end

subgraph group_internship["Internship operations"]
  node_students[("Student profiles<br/>[models.py]")]
  node_mentors[("Mentor profiles<br/>[models.py]")]
  node_internships[("Internship records")]
  node_activities[("Daily activities")]
  node_projects[("Projects<br/>[models.py]")]
  node_tasks[("Tasks<br/>[models.py]")]
  node_files["File uploads"]
  node_reports["Progress reports"]
end

subgraph group_platform["Backend services"]
  node_accounts["Accounts"]
  node_notifications[("Notifications<br/>[models.py]")]
  node_notification_service["Notification dispatch<br/>[services.py]"]
  node_deadline_task["Deadline checker<br/>[tasks.py]"]
end

node_user(("User"))
node_api_service["Remote API"]

node_user -->|"opens routes"| node_app
node_app -->|"routes to"| node_student_ui
node_app -->|"routes to"| node_mentor_ui
node_app -->|"routes to"| node_admin_ui
node_app -->|"routes to"| node_shared_ui
node_student_ui -->|"renders"| node_sidebars
node_mentor_ui -->|"renders"| node_sidebars
node_admin_ui -->|"renders"| node_sidebars
node_app -->|"uses provider"| node_auth_provider
node_app -->|"uses provider"| node_theme
node_app -->|"uses provider"| node_websocket
node_auth_provider -->|"calls"| node_auth_api
node_auth_api -->|"uses client"| node_api_client
node_api_client -->|"sends requests"| node_api_service
node_websocket -->|"reads auth state"| node_auth_provider
node_students -->|"references mentor"| node_mentors
node_students -->|"references internship"| node_internships
node_projects -->|"references student"| node_students
node_projects -->|"references mentor"| node_mentors
node_tasks -->|"references student"| node_students
node_tasks -->|"references mentor"| node_mentors
node_tasks -->|"references project"| node_projects
node_activities -->|"references student"| node_students
node_activities -->|"references mentor"| node_mentors
node_deadline_task -->|"queries and updates"| node_tasks
node_deadline_task -->|"dispatches alerts"| node_notification_service
node_notification_service -->|"creates records"| node_notifications
node_notifications -.->|"pushes realtime events"| node_websocket

click node_app "https://github.com/devaivaraja36-spec/isms/blob/main/src/App.tsx"
click node_student_ui "https://github.com/devaivaraja36-spec/isms/tree/main/src/pages/student"
click node_mentor_ui "https://github.com/devaivaraja36-spec/isms/tree/main/src/pages/mentor"
click node_admin_ui "https://github.com/devaivaraja36-spec/isms/tree/main/src/pages/admin"
click node_shared_ui "https://github.com/devaivaraja36-spec/isms/tree/main/src/pages/common"
click node_sidebars "https://github.com/devaivaraja36-spec/isms/tree/main/src/components/layout"
click node_auth_provider "https://github.com/devaivaraja36-spec/isms/blob/main/src/context/AuthContext.tsx"
click node_auth_api "https://github.com/devaivaraja36-spec/isms/blob/main/src/api/auth.js"
click node_api_client "https://github.com/devaivaraja36-spec/isms/blob/main/src/api/client.js"
click node_theme "https://github.com/devaivaraja36-spec/isms/blob/main/src/context/ThemeContext.tsx"
click node_websocket "https://github.com/devaivaraja36-spec/isms/blob/main/src/context/WebSocketContext.tsx"
click node_accounts "https://github.com/devaivaraja36-spec/isms/tree/main/backend/accounts"
click node_students "https://github.com/devaivaraja36-spec/isms/blob/main/backend/students/models.py"
click node_mentors "https://github.com/devaivaraja36-spec/isms/blob/main/backend/mentors/models.py"
click node_internships "https://github.com/devaivaraja36-spec/isms/tree/main/backend/internships"
click node_activities "https://github.com/devaivaraja36-spec/isms/tree/main/backend/activities"
click node_projects "https://github.com/devaivaraja36-spec/isms/blob/main/backend/projects/models.py"
click node_tasks "https://github.com/devaivaraja36-spec/isms/blob/main/backend/tasks/models.py"
click node_files "https://github.com/devaivaraja36-spec/isms/tree/main/backend/files"
click node_reports "https://github.com/devaivaraja36-spec/isms/tree/main/backend/reports"
click node_notifications "https://github.com/devaivaraja36-spec/isms/blob/main/backend/notifications/models.py"
click node_notification_service "https://github.com/devaivaraja36-spec/isms/blob/main/backend/notifications/services.py"
click node_deadline_task "https://github.com/devaivaraja36-spec/isms/blob/main/backend/tasks/tasks.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_app,node_student_ui,node_mentor_ui,node_admin_ui,node_shared_ui,node_sidebars,node_user toneBlue
class node_auth_provider,node_auth_api,node_api_client,node_theme,node_websocket toneAmber
class node_students,node_mentors,node_internships,node_activities,node_projects,node_tasks,node_files,node_reports,node_api_service toneMint
class node_accounts,node_notifications,node_notification_service,node_deadline_task toneRose
```

## Components

### User interface

- [Role-based routes](https://github.com/devaivaraja36-spec/isms/blob/main/src/App.tsx): `src/App.tsx`
- [Student workspace](https://github.com/devaivaraja36-spec/isms/tree/main/src/pages/student): `src/pages/student`
- [Mentor workspace](https://github.com/devaivaraja36-spec/isms/tree/main/src/pages/mentor): `src/pages/mentor`
- [Admin console](https://github.com/devaivaraja36-spec/isms/tree/main/src/pages/admin): `src/pages/admin`
- [Shared pages](https://github.com/devaivaraja36-spec/isms/tree/main/src/pages/common): `src/pages/common`
- [Role navigation](https://github.com/devaivaraja36-spec/isms/tree/main/src/components/layout): `src/components/layout`

### Identity and access

- [Auth state](https://github.com/devaivaraja36-spec/isms/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Auth API](https://github.com/devaivaraja36-spec/isms/blob/main/src/api/auth.js): `src/api/auth.js`
- [API client](https://github.com/devaivaraja36-spec/isms/blob/main/src/api/client.js): `src/api/client.js`
- [Theme preferences](https://github.com/devaivaraja36-spec/isms/blob/main/src/context/ThemeContext.tsx): `src/context/ThemeContext.tsx`
- [Realtime context](https://github.com/devaivaraja36-spec/isms/blob/main/src/context/WebSocketContext.tsx): `src/context/WebSocketContext.tsx`

### Internship operations

- [Student profiles](https://github.com/devaivaraja36-spec/isms/blob/main/backend/students/models.py): `backend/students/models.py`
- [Mentor profiles](https://github.com/devaivaraja36-spec/isms/blob/main/backend/mentors/models.py): `backend/mentors/models.py`
- [Internship records](https://github.com/devaivaraja36-spec/isms/tree/main/backend/internships): `backend/internships`
- [Daily activities](https://github.com/devaivaraja36-spec/isms/tree/main/backend/activities): `backend/activities`
- [Projects](https://github.com/devaivaraja36-spec/isms/blob/main/backend/projects/models.py): `backend/projects/models.py`
- [Tasks](https://github.com/devaivaraja36-spec/isms/blob/main/backend/tasks/models.py): `backend/tasks/models.py`
- [File uploads](https://github.com/devaivaraja36-spec/isms/tree/main/backend/files): `backend/files`
- [Progress reports](https://github.com/devaivaraja36-spec/isms/tree/main/backend/reports): `backend/reports`

### Backend services

- [Accounts](https://github.com/devaivaraja36-spec/isms/tree/main/backend/accounts): `backend/accounts`
- [Notifications](https://github.com/devaivaraja36-spec/isms/blob/main/backend/notifications/models.py): `backend/notifications/models.py`
- [Notification dispatch](https://github.com/devaivaraja36-spec/isms/blob/main/backend/notifications/services.py): `backend/notifications/services.py`
- [Deadline checker](https://github.com/devaivaraja36-spec/isms/blob/main/backend/tasks/tasks.py): `backend/tasks/tasks.py`

### Other components

- **User**
- **Remote API**

## Connections

- User → Role-based routes: opens routes (evidence: `src/App.tsx`)
- Role-based routes → Student workspace: routes to (evidence: `src/App.tsx`)
- Role-based routes → Mentor workspace: routes to (evidence: `src/App.tsx`)
- Role-based routes → Admin console: routes to (evidence: `src/App.tsx`)
- Role-based routes → Shared pages: routes to (evidence: `src/App.tsx`)
- Student workspace → Role navigation: renders (evidence: `src/pages/student/MyTasks.tsx`)
- Mentor workspace → Role navigation: renders (evidence: `src/pages/mentor/ActivityReviews.tsx`)
- Admin console → Role navigation: renders (evidence: `src/pages/admin/WorkMemos.tsx`)
- Role-based routes → Auth state: uses provider (evidence: `src/main.tsx`)
- Role-based routes → Theme preferences: uses provider (evidence: `src/main.tsx`)
- Role-based routes → Realtime context: uses provider (evidence: `src/main.tsx`)
- Auth state → Auth API: calls (evidence: `src/context/AuthContext.tsx`)
- Auth API → API client: uses client (evidence: `src/api/auth.js`)
- API client → Remote API: sends requests (evidence: `src/api/client.js`)
- Realtime context → Auth state: reads auth state (evidence: `src/context/WebSocketContext.tsx`)
- Student profiles → Mentor profiles: references mentor (evidence: `backend/students/models.py`)
- Student profiles → Internship records: references internship (evidence: `backend/students/models.py`)
- Projects → Student profiles: references student (evidence: `backend/projects/models.py`)
- Projects → Mentor profiles: references mentor (evidence: `backend/projects/models.py`)
- Tasks → Student profiles: references student (evidence: `backend/tasks/models.py`)
- Tasks → Mentor profiles: references mentor (evidence: `backend/tasks/models.py`)
- Tasks → Projects: references project (evidence: `backend/tasks/models.py`)
- Daily activities → Student profiles: references student (evidence: `backend/activities/models.py`)
- Daily activities → Mentor profiles: references mentor (evidence: `backend/activities/models.py`)
- Deadline checker → Tasks: queries and updates (evidence: `backend/tasks/tasks.py`)
- Deadline checker → Notification dispatch: dispatches alerts (evidence: `backend/tasks/tasks.py`)
- Notification dispatch → Notifications: creates records (evidence: `backend/notifications/services.py`)
- Notifications → Realtime context: pushes realtime events
