# kavithashanmugavel2010-jpg/school-attendance-system architecture

> Architecture diagram of the GitHub repository kavithashanmugavel2010-jpg/school-attendance-system, 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/kavithashanmugavel2010-jpg/school-attendance-system
- Repository: https://github.com/kavithashanmugavel2010-jpg/school-attendance-system

## Overview

Joseph Vidya Kshetra is a school administration system for attendance, academic records, class/student directories, homework defaulters, and reports. The main workflow is staff using the React portal to manage records; shared client state calls the Spring API, whose services handle domain operations and persistence. Authentication combines frontend session handling with a documented JWT backend and a Rust Argon2 security module. The sampled sources show key client-state, API, controller, service, and repository relationships; several screens and security configurations are represented from README claims or the source index, so their internal links are omitted where unverified.

Main entry points: [`src/store.jsx`](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/store.jsx) (Shared app state), [`src/App.jsx`](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/App.jsx) (Portal shell), [`src/services/api.js`](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/services/api.js) (API client), [`backend/src/main/java/com/jvk/school/repository`](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/tree/main/backend/src/main/java/com/jvk/school/repository) (Relational persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["School Portal"]
  node_app["Portal shell<br/>[App.jsx]"]
  node_classes_ui["Classes and students"]
  node_attendance_ui["Attendance<br/>[Attendance.jsx]"]
  node_marks_ui["Mark register<br/>[MarkRegister.jsx]"]
  node_homework_ui["Homework defaulters"]
  node_reports_ui["Reports<br/>[Reports.jsx]"]
  node_subjects_ui["Subjects<br/>[Subjects.jsx]"]
  node_marks_views["Marks views<br/>[Marks.jsx]"]
  node_login_ui["Login<br/>[Login.jsx]"]
end

subgraph group_client["Client Data Layer"]
  node_state["Shared app state<br/>[store.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_rust_client["Argon2 client"]
end

subgraph group_api["Backend API"]
  node_class_student_api["Class and student API"]
  node_attendance_api["Attendance API"]
  node_marks_api["Marks API"]
  node_subjects_api["Subjects API"]
  node_auth_api["Authentication API"]
end

subgraph group_domain["School Operations"]
  node_school_service["School operations<br/>[SchoolService.java]"]
  node_storage[("Relational persistence")]
  node_records["School records"]
end

subgraph group_security["Identity and Security"]
  node_auth_service["Login service<br/>[AuthService.java]"]
  node_user_details["User lookup"]
  node_jwt["JWT provider"]
  node_jwt_filter["JWT request filter"]
  node_rust_module["Rust Argon2 module<br/>[main.rs]"]
end

node_staff(("School staff"))
node_database[("SQL database")]

node_staff -->|"uses"| node_app
node_app -->|"routes to"| node_classes_ui
node_app -->|"routes to"| node_attendance_ui
node_app -->|"routes to"| node_marks_ui
node_app -->|"routes to"| node_homework_ui
node_app -->|"routes to"| node_reports_ui
node_app -->|"routes to"| node_subjects_ui
node_app -->|"routes to"| node_login_ui
node_classes_ui -->|"reads and updates"| node_state
node_attendance_ui -->|"uses"| node_state
node_marks_ui -->|"uses"| node_state
node_homework_ui -->|"uses"| node_state
node_reports_ui -->|"uses"| node_state
node_subjects_ui -->|"uses"| node_state
node_marks_views -.->|"uses"| node_state
node_login_ui -->|"uses"| node_state
node_state -->|"calls"| node_api_client
node_state -->|"calls"| node_rust_client
node_api_client -->|"requests"| node_class_student_api
node_api_client -->|"requests"| node_attendance_api
node_api_client -->|"requests"| node_marks_api
node_api_client -->|"requests"| node_subjects_api
node_api_client -->|"requests"| node_auth_api
node_class_student_api -->|"delegates"| node_school_service
node_attendance_api -->|"delegates"| node_school_service
node_marks_api -->|"delegates"| node_school_service
node_subjects_api -->|"delegates"| node_school_service
node_school_service -->|"reads and writes"| node_storage
node_storage -->|"persists"| node_records
node_storage -.->|"stores"| node_database
node_auth_api -.->|"delegates"| node_auth_service
node_auth_service -->|"generates token"| node_jwt
node_auth_service -.->|"authenticates via"| node_user_details
node_auth_service -->|"loads user"| node_storage
node_user_details -->|"loads user"| node_storage
node_jwt_filter -.->|"validates token"| node_jwt
node_rust_client -.->|"security integration"| node_rust_module

click node_app "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/App.jsx"
click node_classes_ui "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/ClassesAndStudents.jsx"
click node_attendance_ui "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/Attendance.jsx"
click node_marks_ui "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/MarkRegister.jsx"
click node_homework_ui "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/HomeworkDefaulters.jsx"
click node_reports_ui "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/Reports.jsx"
click node_subjects_ui "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/Subjects.jsx"
click node_marks_views "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/Marks.jsx"
click node_login_ui "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/Login.jsx"
click node_state "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/store.jsx"
click node_api_client "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/services/api.js"
click node_rust_client "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/services/rustArgon2Security.js"
click node_class_student_api "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/controller/StudentController.java"
click node_attendance_api "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/controller/AttendanceController.java"
click node_marks_api "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/controller/MarkController.java"
click node_subjects_api "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/controller/SubjectController.java"
click node_auth_api "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/controller/AuthController.java"
click node_school_service "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/service/SchoolService.java"
click node_storage "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/tree/main/backend/src/main/java/com/jvk/school/repository"
click node_records "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/tree/main/backend/src/main/java/com/jvk/school/model"
click node_auth_service "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/service/AuthService.java"
click node_user_details "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/service/CustomUserDetailsService.java"
click node_jwt "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/config/JwtTokenProvider.java"
click node_jwt_filter "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/config/JwtAuthenticationFilter.java"
click node_rust_module "https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/rust-security/src/main.rs"

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_classes_ui,node_attendance_ui,node_marks_ui,node_homework_ui,node_reports_ui,node_subjects_ui,node_marks_views,node_login_ui toneBlue
class node_state,node_api_client,node_rust_client,node_database toneAmber
class node_class_student_api,node_attendance_api,node_marks_api,node_subjects_api,node_auth_api toneMint
class node_school_service,node_storage,node_records toneRose
class node_auth_service,node_user_details,node_jwt,node_jwt_filter,node_rust_module,node_staff toneIndigo
```

## Components

### School Portal

- [Portal shell](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/App.jsx): `src/App.jsx`
- [Classes and students](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/ClassesAndStudents.jsx): `src/components/ClassesAndStudents.jsx`
- [Attendance](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/Attendance.jsx): `src/components/Attendance.jsx`
- [Mark register](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/MarkRegister.jsx): `src/components/MarkRegister.jsx`
- [Homework defaulters](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/HomeworkDefaulters.jsx): `src/components/HomeworkDefaulters.jsx`
- [Reports](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/Reports.jsx): `src/components/Reports.jsx`
- [Subjects](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/Subjects.jsx): `src/components/Subjects.jsx`
- [Marks views](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/Marks.jsx): `src/components/Marks.jsx`
- [Login](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/components/Login.jsx): `src/components/Login.jsx`

### Client Data Layer

- [Shared app state](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/store.jsx): `src/store.jsx`
- [API client](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/services/api.js): `src/services/api.js`
- [Argon2 client](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/src/services/rustArgon2Security.js): `src/services/rustArgon2Security.js`

### Backend API

- [Class and student API](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/controller/StudentController.java): `backend/src/main/java/com/jvk/school/controller/StudentController.java`
- [Attendance API](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/controller/AttendanceController.java): `backend/src/main/java/com/jvk/school/controller/AttendanceController.java`
- [Marks API](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/controller/MarkController.java): `backend/src/main/java/com/jvk/school/controller/MarkController.java`
- [Subjects API](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/controller/SubjectController.java): `backend/src/main/java/com/jvk/school/controller/SubjectController.java`
- [Authentication API](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/controller/AuthController.java): `backend/src/main/java/com/jvk/school/controller/AuthController.java`

### School Operations

- [School operations](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/service/SchoolService.java): `backend/src/main/java/com/jvk/school/service/SchoolService.java`
- [Relational persistence](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/tree/main/backend/src/main/java/com/jvk/school/repository): `backend/src/main/java/com/jvk/school/repository`
- [School records](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/tree/main/backend/src/main/java/com/jvk/school/model): `backend/src/main/java/com/jvk/school/model`

### Identity and Security

- [Login service](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/service/AuthService.java): `backend/src/main/java/com/jvk/school/service/AuthService.java`
- [User lookup](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/service/CustomUserDetailsService.java): `backend/src/main/java/com/jvk/school/service/CustomUserDetailsService.java`
- [JWT provider](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/config/JwtTokenProvider.java): `backend/src/main/java/com/jvk/school/config/JwtTokenProvider.java`
- [JWT request filter](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/backend/src/main/java/com/jvk/school/config/JwtAuthenticationFilter.java): `backend/src/main/java/com/jvk/school/config/JwtAuthenticationFilter.java`
- [Rust Argon2 module](https://github.com/kavithashanmugavel2010-jpg/school-attendance-system/blob/main/rust-security/src/main.rs): `rust-security/src/main.rs`

### Other components

- **School staff**
- **SQL database**

## Connections

- School staff → Portal shell: uses (evidence: `README.md`)
- Portal shell → Classes and students: routes to (evidence: `src/App.jsx`)
- Portal shell → Attendance: routes to (evidence: `src/App.jsx`)
- Portal shell → Mark register: routes to (evidence: `src/App.jsx`)
- Portal shell → Homework defaulters: routes to (evidence: `src/App.jsx`)
- Portal shell → Reports: routes to (evidence: `src/App.jsx`)
- Portal shell → Subjects: routes to (evidence: `src/App.jsx`)
- Portal shell → Login: routes to (evidence: `src/App.jsx`)
- Classes and students → Shared app state: reads and updates (evidence: `src/components/ClassesAndStudents.jsx`)
- Attendance → Shared app state: uses (evidence: `src/components/Attendance.jsx`)
- Mark register → Shared app state: uses (evidence: `src/components/MarkRegister.jsx`)
- Homework defaulters → Shared app state: uses (evidence: `src/components/HomeworkDefaulters.jsx`)
- Reports → Shared app state: uses (evidence: `src/components/Reports.jsx`)
- Subjects → Shared app state: uses (evidence: `src/components/Subjects.jsx`)
- Marks views → Shared app state: uses
- Login → Shared app state: uses (evidence: `src/components/Login.jsx`)
- Shared app state → API client: calls (evidence: `src/store.jsx`)
- Shared app state → Argon2 client: calls (evidence: `src/store.jsx`)
- API client → Class and student API: requests (evidence: `src/services/api.js`)
- API client → Attendance API: requests (evidence: `src/services/api.js`)
- API client → Marks API: requests (evidence: `src/services/api.js`)
- API client → Subjects API: requests (evidence: `src/services/api.js`)
- API client → Authentication API: requests (evidence: `src/services/api.js`)
- Class and student API → School operations: delegates (evidence: `backend/src/main/java/com/jvk/school/controller/StudentController.java`)
- Attendance API → School operations: delegates (evidence: `backend/src/main/java/com/jvk/school/controller/AttendanceController.java`)
- Marks API → School operations: delegates (evidence: `backend/src/main/java/com/jvk/school/controller/MarkController.java`)
- Subjects API → School operations: delegates (evidence: `backend/src/main/java/com/jvk/school/controller/SubjectController.java`)
- School operations → Relational persistence: reads and writes (evidence: `backend/src/main/java/com/jvk/school/service/SchoolService.java`)
- Relational persistence → School records: persists (evidence: `backend/src/main/java/com/jvk/school/repository/AttendanceRecordRepository.java`)
- Relational persistence → SQL database: stores
- Authentication API → Login service: delegates
- Login service → JWT provider: generates token (evidence: `backend/src/main/java/com/jvk/school/service/AuthService.java`)
- Login service → User lookup: authenticates via
- Login service → Relational persistence: loads user (evidence: `backend/src/main/java/com/jvk/school/service/AuthService.java`)
- User lookup → Relational persistence: loads user (evidence: `backend/src/main/java/com/jvk/school/service/CustomUserDetailsService.java`)
- JWT request filter → JWT provider: validates token
- Argon2 client → Rust Argon2 module: security integration
