# ragavryan365/student-tracker-frontend architecture

> Architecture diagram of the GitHub repository ragavryan365/student-tracker-frontend, 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/ragavryan365/student-tracker-frontend
- Repository: https://github.com/ragavryan365/student-tracker-frontend

## Overview

Student-Tracker-Frontend is a Next.js attendance-marking interface. An instructor selects a department, section, and year; the page fetches that class’s students, lets the instructor set each student’s status, and submits attendance. After attendance is marked, the page displays read-only student cards. The sampled page also checks whether attendance was already recorded. The backend is external; its implementation and any broader product capabilities are not present in this repository. Relationships shown are limited to the sampled page and component code.

Main entry points: [`app/page.tsx`](https://github.com/ragavryan365/student-tracker-frontend/blob/main/app/page.tsx) (Attendance page), [`components/topMenu.tsx`](https://github.com/ragavryan365/student-tracker-frontend/blob/main/components/topMenu.tsx) (Class selectors), [`components/studentCardEdit.tsx`](https://github.com/ragavryan365/student-tracker-frontend/blob/main/components/studentCardEdit.tsx) (Editable student card), [`app/layout.tsx`](https://github.com/ragavryan365/student-tracker-frontend/blob/main/app/layout.tsx) (Root layout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_attendance["Attendance workflow"]
  node_home["Attendance page<br/>[page.tsx]"]
  node_backend["Backend API"]
end

subgraph group_ui["Student interface"]
  node_class_menu["Class selectors<br/>[topMenu.tsx]"]
  node_editable_card["Editable student card"]
  node_student_card["Read-only student card<br/>[studentCard.tsx]"]
end

subgraph group_shell["App shell"]
  node_layout["Root layout<br/>[layout.tsx]"]
end

node_instructor(("Instructor"))

node_instructor -->|"uses"| node_home
node_home -->|"fetches students"| node_backend
node_home -->|"checks attendance"| node_backend
node_home -->|"submits attendance"| node_backend
node_home -->|"renders"| node_class_menu
node_class_menu -->|"invokes selection callbacks"| node_home
node_home -->|"renders"| node_editable_card
node_editable_card -->|"reports status changes"| node_home
node_home -->|"renders"| node_student_card
node_layout -.->|"wraps page"| node_home

click node_home "https://github.com/ragavryan365/student-tracker-frontend/blob/main/app/page.tsx"
click node_class_menu "https://github.com/ragavryan365/student-tracker-frontend/blob/main/components/topMenu.tsx"
click node_editable_card "https://github.com/ragavryan365/student-tracker-frontend/blob/main/components/studentCardEdit.tsx"
click node_student_card "https://github.com/ragavryan365/student-tracker-frontend/blob/main/components/studentCard.tsx"
click node_layout "https://github.com/ragavryan365/student-tracker-frontend/blob/main/app/layout.tsx"

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_home,node_backend toneBlue
class node_class_menu,node_editable_card,node_student_card toneAmber
class node_layout toneMint
class node_instructor toneIndigo
```

## Components

### Attendance workflow

- [Attendance page](https://github.com/ragavryan365/student-tracker-frontend/blob/main/app/page.tsx): `app/page.tsx`
- **Backend API**

### Student interface

- [Class selectors](https://github.com/ragavryan365/student-tracker-frontend/blob/main/components/topMenu.tsx): `components/topMenu.tsx`
- [Editable student card](https://github.com/ragavryan365/student-tracker-frontend/blob/main/components/studentCardEdit.tsx): `components/studentCardEdit.tsx`
- [Read-only student card](https://github.com/ragavryan365/student-tracker-frontend/blob/main/components/studentCard.tsx): `components/studentCard.tsx`

### App shell

- [Root layout](https://github.com/ragavryan365/student-tracker-frontend/blob/main/app/layout.tsx): `app/layout.tsx`

### Other components

- **Instructor**

## Connections

- Instructor → Attendance page: uses (evidence: `app/page.tsx`)
- Attendance page → Backend API: fetches students (evidence: `app/page.tsx`)
- Attendance page → Backend API: checks attendance (evidence: `app/page.tsx`)
- Attendance page → Backend API: submits attendance (evidence: `app/page.tsx`)
- Attendance page → Class selectors: renders (evidence: `app/page.tsx`)
- Class selectors → Attendance page: invokes selection callbacks (evidence: `components/topMenu.tsx`)
- Attendance page → Editable student card: renders (evidence: `app/page.tsx`)
- Editable student card → Attendance page: reports status changes (evidence: `components/studentCardEdit.tsx`)
- Attendance page → Read-only student card: renders (evidence: `app/page.tsx`)
- Root layout → Attendance page: wraps page
