# bharatyadav05/project-smart_test_system architecture

> Architecture diagram of the GitHub repository bharatyadav05/project-smart_test_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/bharatyadav05/project-smart_test_system
- Repository: https://github.com/bharatyadav05/project-smart_test_system

## Overview

This is a browser-based assessment platform for students and staff. Students find a test, validate its access code, identify themselves, complete MCQ and coding sections, and submit work. Staff authenticate to create classes and assessments, monitor live sessions, manage rosters, and review submissions. The React app routes these workflows; page components use a shared Supabase client for backend operations. The README is empty, so capability coverage is based on the supplied source index and excerpts; some page-to-backend behavior is supported only by import references.

Main entry points: [`src/App.jsx`](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/App.jsx) (Route application), [`src/lib/supabase.js`](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/lib/supabase.js) (Supabase client), [`src/context/AuthContext.jsx`](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/context/AuthContext.jsx) (Admin authentication), [`src/components/CreateClassModal.jsx`](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/components/CreateClassModal.jsx) (Create class)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_routing["App and access"]
  node_app["Route application<br/>[App.jsx]"]
  node_auth["Admin authentication<br/>[AuthContext.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
end

subgraph group_student["Student assessment"]
  node_student_entry["Find test<br/>[StudentEntry.jsx]"]
  node_student_identity["Join and identify"]
  node_test_runner["Take assessment<br/>[TestRunner.jsx]"]
  node_confirmation["Submission confirmation"]
  node_image_upload["Evidence upload<br/>[ImageUpload.jsx]"]
end

subgraph group_admin["Staff operations"]
  node_admin_login["Staff login<br/>[AdminLogin.jsx]"]
  node_dashboard["Assessment dashboard<br/>[AdminDashboard.jsx]"]
  node_create_test["Create assessment"]
  node_create_class["Create class"]
  node_live_room["Live monitoring<br/>[LiveTestRoom.jsx]"]
  node_submissions["Submission management"]
  node_review["Review and grade"]
  node_roster["Class roster"]
  node_settings["Admin settings"]
end

subgraph group_services["Backend and shared UI"]
  node_supabase_client["Supabase client<br/>[supabase.js]"]
  node_supabase[("Supabase backend")]
end

node_student_actor(("Student"))
node_staff_actor(("Staff"))

node_student_actor -->|"opens app"| node_app
node_staff_actor -->|"opens app"| node_app
node_app -->|"provides auth"| node_auth
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_student_entry
node_app -->|"routes to"| node_student_identity
node_app -->|"routes to"| node_test_runner
node_app -->|"routes to"| node_confirmation
node_app -->|"routes to"| node_admin_login
node_app -->|"protects route"| node_dashboard
node_app -->|"protects route"| node_live_room
node_app -->|"protects route"| node_submissions
node_app -->|"protects route"| node_roster
node_app -->|"protects route"| node_settings
node_admin_login -->|"authenticates via"| node_auth
node_auth -->|"reads auth session"| node_supabase_client
node_navbar -->|"uses auth state"| node_auth
node_student_entry -->|"queries backend"| node_supabase_client
node_student_identity -->|"validates code"| node_supabase_client
node_test_runner -->|"loads and submits"| node_supabase_client
node_test_runner -->|"renders"| node_image_upload
node_image_upload -->|"uploads evidence"| node_supabase_client
node_dashboard -->|"queries backend"| node_supabase_client
node_dashboard -->|"opens"| node_create_test
node_create_test -->|"creates assessment"| node_supabase_client
node_create_test -->|"opens"| node_create_class
node_create_class -->|"creates class"| node_supabase_client
node_live_room -->|"loads session data"| node_supabase_client
node_submissions -->|"loads submissions"| node_supabase_client
node_submissions -->|"opens review"| node_review
node_review -->|"saves evaluation"| node_supabase_client
node_roster -->|"manages roster"| node_supabase_client
node_roster -->|"opens"| node_create_class
node_settings -->|"reads settings data"| node_supabase_client
node_settings -->|"opens"| node_create_class
node_supabase_client -->|"connects to"| node_supabase

click node_app "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/App.jsx"
click node_auth "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/context/AuthContext.jsx"
click node_navbar "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/components/Navbar.jsx"
click node_student_entry "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/student/StudentEntry.jsx"
click node_student_identity "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/student/StudentIdentity.jsx"
click node_test_runner "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/student/TestRunner.jsx"
click node_confirmation "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/student/SubmissionConfirmation.jsx"
click node_image_upload "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/components/ImageUpload.jsx"
click node_admin_login "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/AdminLogin.jsx"
click node_dashboard "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/AdminDashboard.jsx"
click node_create_test "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/CreateTestModal.jsx"
click node_create_class "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/components/CreateClassModal.jsx"
click node_live_room "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/LiveTestRoom.jsx"
click node_submissions "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/SubmissionsPage.jsx"
click node_review "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/SubmissionReviewModal.jsx"
click node_roster "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/ClassRosterPage.jsx"
click node_settings "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/AdminSettingsPage.jsx"
click node_supabase_client "https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/lib/supabase.js"

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_auth,node_navbar toneBlue
class node_student_entry,node_student_identity,node_test_runner,node_confirmation,node_image_upload toneAmber
class node_admin_login,node_dashboard,node_create_test,node_create_class,node_live_room,node_submissions,node_review,node_roster,node_settings toneMint
class node_supabase_client,node_supabase toneRose
class node_student_actor,node_staff_actor toneIndigo
```

## Components

### App and access

- [Route application](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/App.jsx): `src/App.jsx`
- [Admin authentication](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Navigation](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/components/Navbar.jsx): `src/components/Navbar.jsx`

### Student assessment

- [Find test](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/student/StudentEntry.jsx): `src/pages/student/StudentEntry.jsx`
- [Join and identify](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/student/StudentIdentity.jsx): `src/pages/student/StudentIdentity.jsx`
- [Take assessment](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/student/TestRunner.jsx): `src/pages/student/TestRunner.jsx`
- [Submission confirmation](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/student/SubmissionConfirmation.jsx): `src/pages/student/SubmissionConfirmation.jsx`
- [Evidence upload](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/components/ImageUpload.jsx): `src/components/ImageUpload.jsx`

### Staff operations

- [Staff login](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/AdminLogin.jsx): `src/pages/admin/AdminLogin.jsx`
- [Assessment dashboard](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/AdminDashboard.jsx): `src/pages/admin/AdminDashboard.jsx`
- [Create assessment](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/CreateTestModal.jsx): `src/pages/admin/CreateTestModal.jsx`
- [Create class](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/components/CreateClassModal.jsx): `src/components/CreateClassModal.jsx`
- [Live monitoring](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/LiveTestRoom.jsx): `src/pages/admin/LiveTestRoom.jsx`
- [Submission management](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/SubmissionsPage.jsx): `src/pages/admin/SubmissionsPage.jsx`
- [Review and grade](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/SubmissionReviewModal.jsx): `src/pages/admin/SubmissionReviewModal.jsx`
- [Class roster](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/ClassRosterPage.jsx): `src/pages/admin/ClassRosterPage.jsx`
- [Admin settings](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/pages/admin/AdminSettingsPage.jsx): `src/pages/admin/AdminSettingsPage.jsx`

### Backend and shared UI

- [Supabase client](https://github.com/bharatyadav05/project-smart_test_system/blob/main/src/lib/supabase.js): `src/lib/supabase.js`
- **Supabase backend**

### Other components

- **Student**
- **Staff**

## Connections

- Student → Route application: opens app (evidence: `src/App.jsx`)
- Staff → Route application: opens app (evidence: `src/App.jsx`)
- Route application → Admin authentication: provides auth (evidence: `src/App.jsx`)
- Route application → Navigation: renders (evidence: `src/App.jsx`)
- Route application → Find test: routes to (evidence: `src/App.jsx`)
- Route application → Join and identify: routes to (evidence: `src/App.jsx`)
- Route application → Take assessment: routes to (evidence: `src/App.jsx`)
- Route application → Submission confirmation: routes to (evidence: `src/App.jsx`)
- Route application → Staff login: routes to (evidence: `src/App.jsx`)
- Route application → Assessment dashboard: protects route (evidence: `src/App.jsx`)
- Route application → Live monitoring: protects route (evidence: `src/App.jsx`)
- Route application → Submission management: protects route (evidence: `src/App.jsx`)
- Route application → Class roster: protects route (evidence: `src/App.jsx`)
- Route application → Admin settings: protects route (evidence: `src/App.jsx`)
- Staff login → Admin authentication: authenticates via (evidence: `src/pages/admin/AdminLogin.jsx`)
- Admin authentication → Supabase client: reads auth session (evidence: `src/context/AuthContext.jsx`)
- Navigation → Admin authentication: uses auth state (evidence: `src/components/Navbar.jsx`)
- Find test → Supabase client: queries backend (evidence: `src/pages/student/StudentEntry.jsx`)
- Join and identify → Supabase client: validates code (evidence: `src/pages/student/StudentIdentity.jsx`)
- Take assessment → Supabase client: loads and submits (evidence: `src/pages/student/TestRunner.jsx`)
- Take assessment → Evidence upload: renders (evidence: `src/pages/student/TestRunner.jsx`)
- Evidence upload → Supabase client: uploads evidence (evidence: `src/components/ImageUpload.jsx`)
- Assessment dashboard → Supabase client: queries backend (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Assessment dashboard → Create assessment: opens (evidence: `src/pages/admin/AdminDashboard.jsx`)
- Create assessment → Supabase client: creates assessment (evidence: `src/pages/admin/CreateTestModal.jsx`)
- Create assessment → Create class: opens (evidence: `src/pages/admin/CreateTestModal.jsx`)
- Create class → Supabase client: creates class (evidence: `src/components/CreateClassModal.jsx`)
- Live monitoring → Supabase client: loads session data (evidence: `src/pages/admin/LiveTestRoom.jsx`)
- Submission management → Supabase client: loads submissions (evidence: `src/pages/admin/SubmissionsPage.jsx`)
- Submission management → Review and grade: opens review (evidence: `src/pages/admin/SubmissionsPage.jsx`)
- Review and grade → Supabase client: saves evaluation (evidence: `src/pages/admin/SubmissionReviewModal.jsx`)
- Class roster → Supabase client: manages roster (evidence: `src/pages/admin/ClassRosterPage.jsx`)
- Class roster → Create class: opens (evidence: `src/pages/admin/ClassRosterPage.jsx`)
- Admin settings → Supabase client: reads settings data (evidence: `src/pages/admin/AdminSettingsPage.jsx`)
- Admin settings → Create class: opens (evidence: `src/pages/admin/AdminSettingsPage.jsx`)
- Supabase client → Supabase backend: connects to (evidence: `src/lib/supabase.js`)
