# kashifsameer277/student-management-pubsub architecture

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

- Interactive diagram: https://gitdiagram.com/kashifsameer277/student-management-pubsub
- Repository: https://github.com/kashifsameer277/student-management-pubsub

## Overview

This is a school-management web application: users navigate a dashboard and feature pages to manage students, attendance, teachers, and courses, then review attendance reports and institute settings. The frontend separates page components from event-driven stores and services; student records additionally use an HTTP API and backend. Attendance is persisted in browser local storage. The README is only the Vite template, so product capabilities are inferred from the source index and excerpts; backend implementation details beyond its entry file were not sampled.

Main entry points: [`src/App.jsx`](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/App.jsx) (Route application), [`src/pubsub/EventBus.js`](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/pubsub/EventBus.js) (Event bus), [`src/components/dashboard/Dashboard.jsx`](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/dashboard/Dashboard.jsx) (Dashboard), [`src/store/AttendanceStore.js`](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/store/AttendanceStore.js) (Attendance store)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Application UI"]
  node_app["Route application<br/>[App.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
end

subgraph group_domain["Management Features"]
  node_students["Student management<br/>[StudentList.jsx]"]
  node_student_details["Student details<br/>[StudentDetails.jsx]"]
  node_attendance["Attendance management<br/>[AttendancePage.jsx]"]
  node_reports["Attendance reports<br/>[ReportsPage.jsx]"]
  node_teachers["Teacher management<br/>[TeacherList.jsx]"]
  node_courses["Course management<br/>[CourseList.jsx]"]
  node_settings["Institute settings<br/>[SettingsPage.jsx]"]
end

subgraph group_state["State And Events"]
  node_student_service["Student service<br/>[StudentService.js]"]
  node_attendance_service["Attendance service"]
  node_teacher_service["Teacher service<br/>[TeacherService.js]"]
  node_course_service["Course service<br/>[CourseService.js]"]
  node_student_store["Student store<br/>[StudentStore.js]"]
  node_attendance_store["Attendance store<br/>[AttendanceStore.js]"]
  node_teacher_store["Teacher store<br/>[TeacherStore.js]"]
  node_course_store["Course store<br/>[CourseStore.js]"]
  node_activity_store["Activity store<br/>[ActivityStore.js]"]
  node_event_bus["Event bus<br/>[EventBus.js]"]
  node_event_names["Event names<br/>[events.js]"]
end

subgraph group_backend["Student Backend"]
  node_student_api["Student HTTP API<br/>[studentApi.js]"]
  node_backend_server["Backend server<br/>[server.js]"]
end

node_user(("Institute user"))
node_local_storage[("Browser local storage")]

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_students
node_app -->|"routes to"| node_student_details
node_app -->|"routes to"| node_attendance
node_app -->|"routes to"| node_teachers
node_app -->|"routes to"| node_courses
node_app -->|"routes to"| node_reports
node_app -->|"routes to"| node_settings
node_students -->|"calls"| node_student_service
node_student_details -->|"calls"| node_student_api
node_student_service -->|"calls"| node_student_api
node_student_api -->|"HTTP requests"| node_backend_server
node_students -->|"reads"| node_student_store
node_attendance -->|"reads"| node_student_store
node_attendance -->|"calls"| node_attendance_service
node_attendance -->|"reads"| node_attendance_store
node_reports -->|"reads"| node_student_store
node_reports -->|"reads"| node_attendance_store
node_dashboard -->|"reads"| node_student_store
node_dashboard -->|"reads"| node_teacher_store
node_dashboard -->|"reads"| node_course_store
node_dashboard -->|"reads"| node_attendance_store
node_teachers -->|"calls"| node_teacher_service
node_courses -->|"calls"| node_course_service
node_student_service -->|"publishes"| node_event_bus
node_teacher_service -->|"publishes"| node_event_bus
node_course_service -->|"publishes"| node_event_bus
node_attendance_service -->|"publishes"| node_event_bus
node_student_store -->|"subscribes"| node_event_bus
node_attendance_store -->|"subscribes"| node_event_bus
node_teacher_store -->|"subscribes"| node_event_bus
node_course_store -->|"subscribes"| node_event_bus
node_activity_store -->|"subscribes"| node_event_bus
node_event_bus -->|"uses names"| node_event_names
node_attendance_store -->|"reads and writes"| node_local_storage

click node_app "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/App.jsx"
click node_dashboard "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/dashboard/Dashboard.jsx"
click node_students "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/students/StudentList.jsx"
click node_student_details "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/students/StudentDetails.jsx"
click node_attendance "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/attendance/AttendancePage.jsx"
click node_reports "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/Reports/ReportsPage.jsx"
click node_teachers "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/teachers/TeacherList.jsx"
click node_courses "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/courses/CourseList.jsx"
click node_settings "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/settings/SettingsPage.jsx"
click node_student_service "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/services/StudentService.js"
click node_attendance_service "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/services/AttendanceService.js"
click node_teacher_service "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/services/TeacherService.js"
click node_course_service "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/services/CourseService.js"
click node_student_store "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/store/StudentStore.js"
click node_attendance_store "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/store/AttendanceStore.js"
click node_teacher_store "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/store/TeacherStore.js"
click node_course_store "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/store/CourseStore.js"
click node_activity_store "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/store/ActivityStore.js"
click node_event_bus "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/pubsub/EventBus.js"
click node_event_names "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/pubsub/events.js"
click node_student_api "https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/api/studentApi.js"
click node_backend_server "https://github.com/kashifsameer277/student-management-pubsub/blob/main/backend/server.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_dashboard,node_user toneBlue
class node_students,node_student_details,node_attendance,node_reports,node_teachers,node_courses,node_settings,node_local_storage toneAmber
class node_student_service,node_attendance_service,node_teacher_service,node_course_service,node_student_store,node_attendance_store,node_teacher_store,node_course_store,node_activity_store,node_event_bus,node_event_names toneMint
class node_student_api,node_backend_server toneRose
```

## Components

### Application UI

- [Route application](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/App.jsx): `src/App.jsx`
- [Dashboard](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/dashboard/Dashboard.jsx): `src/components/dashboard/Dashboard.jsx`

### Management Features

- [Student management](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/students/StudentList.jsx): `src/components/students/StudentList.jsx`
- [Student details](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/students/StudentDetails.jsx): `src/components/students/StudentDetails.jsx`
- [Attendance management](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/attendance/AttendancePage.jsx): `src/attendance/AttendancePage.jsx`
- [Attendance reports](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/Reports/ReportsPage.jsx): `src/components/Reports/ReportsPage.jsx`
- [Teacher management](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/teachers/TeacherList.jsx): `src/components/teachers/TeacherList.jsx`
- [Course management](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/courses/CourseList.jsx): `src/components/courses/CourseList.jsx`
- [Institute settings](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/components/settings/SettingsPage.jsx): `src/components/settings/SettingsPage.jsx`

### State And Events

- [Student service](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/services/StudentService.js): `src/services/StudentService.js`
- [Attendance service](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/services/AttendanceService.js): `src/services/AttendanceService.js`
- [Teacher service](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/services/TeacherService.js): `src/services/TeacherService.js`
- [Course service](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/services/CourseService.js): `src/services/CourseService.js`
- [Student store](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/store/StudentStore.js): `src/store/StudentStore.js`
- [Attendance store](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/store/AttendanceStore.js): `src/store/AttendanceStore.js`
- [Teacher store](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/store/TeacherStore.js): `src/store/TeacherStore.js`
- [Course store](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/store/CourseStore.js): `src/store/CourseStore.js`
- [Activity store](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/store/ActivityStore.js): `src/store/ActivityStore.js`
- [Event bus](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/pubsub/EventBus.js): `src/pubsub/EventBus.js`
- [Event names](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/pubsub/events.js): `src/pubsub/events.js`

### Student Backend

- [Student HTTP API](https://github.com/kashifsameer277/student-management-pubsub/blob/main/src/api/studentApi.js): `src/api/studentApi.js`
- [Backend server](https://github.com/kashifsameer277/student-management-pubsub/blob/main/backend/server.js): `backend/server.js`

### Other components

- **Institute user**
- **Browser local storage**

## Connections

- Institute user → Route application: opens (evidence: `src/App.jsx`)
- Route application → Dashboard: routes to (evidence: `src/App.jsx`)
- Route application → Student management: routes to (evidence: `src/App.jsx`)
- Route application → Student details: routes to (evidence: `src/App.jsx`)
- Route application → Attendance management: routes to (evidence: `src/App.jsx`)
- Route application → Teacher management: routes to (evidence: `src/App.jsx`)
- Route application → Course management: routes to (evidence: `src/App.jsx`)
- Route application → Attendance reports: routes to (evidence: `src/App.jsx`)
- Route application → Institute settings: routes to (evidence: `src/App.jsx`)
- Student management → Student service: calls (evidence: `src/components/students/StudentList.jsx`)
- Student details → Student HTTP API: calls (evidence: `src/components/students/StudentDetails.jsx`)
- Student service → Student HTTP API: calls (evidence: `src/services/StudentService.js`)
- Student HTTP API → Backend server: HTTP requests (evidence: `src/api/studentApi.js`)
- Student management → Student store: reads (evidence: `src/components/students/StudentList.jsx`)
- Attendance management → Student store: reads (evidence: `src/attendance/AttendancePage.jsx`)
- Attendance management → Attendance service: calls (evidence: `src/attendance/AttendancePage.jsx`)
- Attendance management → Attendance store: reads (evidence: `src/attendance/AttendancePage.jsx`)
- Attendance reports → Student store: reads (evidence: `src/components/Reports/ReportsPage.jsx`)
- Attendance reports → Attendance store: reads (evidence: `src/components/Reports/ReportsPage.jsx`)
- Dashboard → Student store: reads (evidence: `src/components/dashboard/Dashboard.jsx`)
- Dashboard → Teacher store: reads (evidence: `src/components/dashboard/Dashboard.jsx`)
- Dashboard → Course store: reads (evidence: `src/components/dashboard/Dashboard.jsx`)
- Dashboard → Attendance store: reads (evidence: `src/components/dashboard/Dashboard.jsx`)
- Teacher management → Teacher service: calls (evidence: `src/components/teachers/TeacherList.jsx`)
- Course management → Course service: calls (evidence: `src/components/courses/CourseList.jsx`)
- Student service → Event bus: publishes (evidence: `src/services/StudentService.js`)
- Teacher service → Event bus: publishes (evidence: `src/services/TeacherService.js`)
- Course service → Event bus: publishes (evidence: `src/services/CourseService.js`)
- Attendance service → Event bus: publishes (evidence: `src/services/AttendanceService.js`)
- Student store → Event bus: subscribes (evidence: `src/store/StudentStore.js`)
- Attendance store → Event bus: subscribes (evidence: `src/store/AttendanceStore.js`)
- Teacher store → Event bus: subscribes (evidence: `src/store/TeacherStore.js`)
- Course store → Event bus: subscribes (evidence: `src/store/CourseStore.js`)
- Activity store → Event bus: subscribes (evidence: `src/store/ActivityStore.js`)
- Event bus → Event names: uses names (evidence: `src/pubsub/events.js`)
- Attendance store → Browser local storage: reads and writes (evidence: `src/store/AttendanceStore.js`)
