# tanjim079/result-management-system architecture

> Architecture diagram of the GitHub repository tanjim079/result-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tanjim079/result-management-system
- Repository: https://github.com/tanjim079/result-management-system

## Overview

This React portal supports student, teacher, and administrator workflows over Supabase. Students register for courses, submit complaints, and view calculated results; teachers enter marks and review semester results; administrators manage academic records and complaints. The sampled code shows route dispatch, course registration writes, shared data loading, mark entry, and result calculations. Other page-level capabilities come from the README and route declarations; their internal calls are not inferred where source was not sampled.

Main entry points: [`src/App.jsx`](https://github.com/tanjim079/result-management-system/blob/main/src/App.jsx) (Route dispatcher), [`src/pages/student/ViewResult.jsx`](https://github.com/tanjim079/result-management-system/blob/main/src/pages/student/ViewResult.jsx) (Student results), [`src/pages/teacher/TheoryMarks.jsx`](https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/TheoryMarks.jsx) (Theory marks), [`src/utils/helpers.js`](https://github.com/tanjim079/result-management-system/blob/main/src/utils/helpers.js) (Grades and exports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Portal and access"]
  node_app["Route dispatcher<br/>[App.jsx]"]
  node_login["Role sign-in"]
  node_navbar["Role navigation<br/>[TopNavbar.jsx]"]
end

subgraph group_student["Student services"]
  node_studentdash["Student dashboard"]
  node_registration["Course registration"]
  node_complaints["Student complaints<br/>[Complaint.jsx]"]
  node_studentresults["Student results<br/>[ViewResult.jsx]"]
  node_calculations["Grades and exports<br/>[helpers.js]"]
end

subgraph group_teacher["Teacher operations"]
  node_teacherdash["Teacher dashboard"]
  node_markroutes["Mark entry routing<br/>[InputMarks.jsx]"]
  node_theory["Theory marks<br/>[TheoryMarks.jsx]"]
  node_lab["Lab marks<br/>[LabMarks.jsx]"]
  node_viva["Board viva<br/>[BoardViva.jsx]"]
  node_teacherresults["Semester results<br/>[SemesterResult.jsx]"]
end

subgraph group_admin["Administration and data"]
  node_admindash["Admin dashboard<br/>[AdminDashboard.jsx]"]
  node_entityadmin["Academic records"]
  node_complaintadmin["Complaint review"]
  node_context["Shared data loading<br/>[DataContext.jsx]"]
  node_database[("Supabase database")]
end

node_students(("Students"))
node_teachers(("Teachers"))
node_administrators(("Administrators"))

node_students -->|"use portal"| node_app
node_teachers -->|"use portal"| node_app
node_administrators -->|"use portal"| node_app
node_app -->|"routes to"| node_login
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_studentdash
node_app -->|"routes to"| node_registration
node_app -->|"routes to"| node_complaints
node_app -->|"routes to"| node_studentresults
node_app -->|"routes to"| node_teacherdash
node_app -->|"routes to"| node_markroutes
node_app -->|"routes to"| node_theory
node_app -->|"routes to"| node_lab
node_app -->|"routes to"| node_viva
node_app -->|"routes to"| node_teacherresults
node_app -->|"routes to"| node_admindash
node_app -->|"routes to"| node_entityadmin
node_app -->|"routes to"| node_complaintadmin
node_registration -->|"writes registration"| node_database
node_studentresults -->|"calculates grades"| node_calculations
node_theory -->|"calculates grades"| node_calculations
node_theory -->|"reads and saves marks"| node_database
node_studentresults -.->|"reads academic data"| node_database
node_complaints -.->|"submits complaints"| node_database
node_lab -.->|"stores marks"| node_database
node_viva -.->|"stores marks"| node_database
node_teacherresults -.->|"calculates results"| node_calculations
node_entityadmin -.->|"manages records"| node_database
node_complaintadmin -.->|"reviews complaints"| node_database
node_context -->|"loads shared data"| node_database

click node_app "https://github.com/tanjim079/result-management-system/blob/main/src/App.jsx"
click node_login "https://github.com/tanjim079/result-management-system/tree/main/src/pages/auth"
click node_navbar "https://github.com/tanjim079/result-management-system/blob/main/src/components/TopNavbar.jsx"
click node_studentdash "https://github.com/tanjim079/result-management-system/blob/main/src/pages/student/StudentDashboard.jsx"
click node_registration "https://github.com/tanjim079/result-management-system/blob/main/src/pages/student/CourseRegistration.jsx"
click node_complaints "https://github.com/tanjim079/result-management-system/blob/main/src/pages/student/Complaint.jsx"
click node_studentresults "https://github.com/tanjim079/result-management-system/blob/main/src/pages/student/ViewResult.jsx"
click node_calculations "https://github.com/tanjim079/result-management-system/blob/main/src/utils/helpers.js"
click node_teacherdash "https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/TeacherDashboard.jsx"
click node_markroutes "https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/InputMarks.jsx"
click node_theory "https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/TheoryMarks.jsx"
click node_lab "https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/LabMarks.jsx"
click node_viva "https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/BoardViva.jsx"
click node_teacherresults "https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/SemesterResult.jsx"
click node_admindash "https://github.com/tanjim079/result-management-system/blob/main/src/pages/admin/AdminDashboard.jsx"
click node_entityadmin "https://github.com/tanjim079/result-management-system/tree/main/src/pages/admin"
click node_complaintadmin "https://github.com/tanjim079/result-management-system/blob/main/src/pages/admin/ManageComplaints.jsx"
click node_context "https://github.com/tanjim079/result-management-system/blob/main/src/context/DataContext.jsx"

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_login,node_navbar toneBlue
class node_studentdash,node_registration,node_complaints,node_studentresults,node_calculations toneAmber
class node_teacherdash,node_markroutes,node_theory,node_lab,node_viva,node_teacherresults toneMint
class node_admindash,node_entityadmin,node_complaintadmin,node_context,node_database toneRose
class node_students,node_teachers,node_administrators toneIndigo
```

## Components

### Portal and access

- [Route dispatcher](https://github.com/tanjim079/result-management-system/blob/main/src/App.jsx): `src/App.jsx`
- [Role sign-in](https://github.com/tanjim079/result-management-system/tree/main/src/pages/auth): `src/pages/auth`
- [Role navigation](https://github.com/tanjim079/result-management-system/blob/main/src/components/TopNavbar.jsx): `src/components/TopNavbar.jsx`

### Student services

- [Student dashboard](https://github.com/tanjim079/result-management-system/blob/main/src/pages/student/StudentDashboard.jsx): `src/pages/student/StudentDashboard.jsx`
- [Course registration](https://github.com/tanjim079/result-management-system/blob/main/src/pages/student/CourseRegistration.jsx): `src/pages/student/CourseRegistration.jsx`
- [Student complaints](https://github.com/tanjim079/result-management-system/blob/main/src/pages/student/Complaint.jsx): `src/pages/student/Complaint.jsx`
- [Student results](https://github.com/tanjim079/result-management-system/blob/main/src/pages/student/ViewResult.jsx): `src/pages/student/ViewResult.jsx`
- [Grades and exports](https://github.com/tanjim079/result-management-system/blob/main/src/utils/helpers.js): `src/utils/helpers.js`

### Teacher operations

- [Teacher dashboard](https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/TeacherDashboard.jsx): `src/pages/teacher/TeacherDashboard.jsx`
- [Mark entry routing](https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/InputMarks.jsx): `src/pages/teacher/InputMarks.jsx`
- [Theory marks](https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/TheoryMarks.jsx): `src/pages/teacher/TheoryMarks.jsx`
- [Lab marks](https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/LabMarks.jsx): `src/pages/teacher/LabMarks.jsx`
- [Board viva](https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/BoardViva.jsx): `src/pages/teacher/BoardViva.jsx`
- [Semester results](https://github.com/tanjim079/result-management-system/blob/main/src/pages/teacher/SemesterResult.jsx): `src/pages/teacher/SemesterResult.jsx`

### Administration and data

- [Admin dashboard](https://github.com/tanjim079/result-management-system/blob/main/src/pages/admin/AdminDashboard.jsx): `src/pages/admin/AdminDashboard.jsx`
- [Academic records](https://github.com/tanjim079/result-management-system/tree/main/src/pages/admin): `src/pages/admin`
- [Complaint review](https://github.com/tanjim079/result-management-system/blob/main/src/pages/admin/ManageComplaints.jsx): `src/pages/admin/ManageComplaints.jsx`
- [Shared data loading](https://github.com/tanjim079/result-management-system/blob/main/src/context/DataContext.jsx): `src/context/DataContext.jsx`
- **Supabase database**

### Other components

- **Students**
- **Teachers**
- **Administrators**

## Connections

- Students → Route dispatcher: use portal (evidence: `README.md`)
- Teachers → Route dispatcher: use portal (evidence: `README.md`)
- Administrators → Route dispatcher: use portal (evidence: `README.md`)
- Route dispatcher → Role sign-in: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Role navigation: renders (evidence: `src/App.jsx`)
- Route dispatcher → Student dashboard: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Course registration: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Student complaints: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Student results: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Teacher dashboard: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Mark entry routing: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Theory marks: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Lab marks: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Board viva: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Semester results: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Admin dashboard: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Academic records: routes to (evidence: `src/App.jsx`)
- Route dispatcher → Complaint review: routes to (evidence: `src/App.jsx`)
- Course registration → Supabase database: writes registration (evidence: `src/pages/student/CourseRegistration.jsx`)
- Student results → Grades and exports: calculates grades (evidence: `src/pages/student/ViewResult.jsx`)
- Theory marks → Grades and exports: calculates grades (evidence: `src/pages/teacher/TheoryMarks.jsx`)
- Theory marks → Supabase database: reads and saves marks (evidence: `src/pages/teacher/TheoryMarks.jsx`)
- Student results → Supabase database: reads academic data
- Student complaints → Supabase database: submits complaints
- Lab marks → Supabase database: stores marks
- Board viva → Supabase database: stores marks
- Semester results → Grades and exports: calculates results (evidence: `src/pages/teacher/SemesterResult.jsx`)
- Academic records → Supabase database: manages records
- Complaint review → Supabase database: reviews complaints
- Shared data loading → Supabase database: loads shared data (evidence: `src/context/DataContext.jsx`)
