How kavithashanmugavel2010-jpg/school-attendance-system works
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: store.jsx Shared app state · App.jsx Portal shell · api.js API client · repository Relational persistence
Components 27
School Portal
- Portal shell
src/App.jsx - Classes and students
src/components/ClassesAndStudents.jsx - Attendance
src/components/Attendance.jsx - Mark register
src/components/MarkRegister.jsx - Homework defaulters
src/components/HomeworkDefaulters.jsx - Reports
src/components/Reports.jsx - Subjects
src/components/Subjects.jsx - Marks views
src/components/Marks.jsx - Login
src/components/Login.jsx
Client Data Layer
- Shared app state
src/store.jsx - API client
src/services/api.js - Argon2 client
src/services/rustArgon2Security.js
Backend API
- Class and student API
backend/src/main/java/com/jvk/school/controller/StudentController.java - Attendance API
backend/src/main/java/com/jvk/school/controller/AttendanceController.java - Marks API
backend/src/main/java/com/jvk/school/controller/MarkController.java - Subjects API
backend/src/main/java/com/jvk/school/controller/SubjectController.java - Authentication API
backend/src/main/java/com/jvk/school/controller/AuthController.java
School Operations
- School operations
backend/src/main/java/com/jvk/school/service/SchoolService.java - Relational persistence
backend/src/main/java/com/jvk/school/repository - School records
backend/src/main/java/com/jvk/school/model
Identity and Security
- Login service
backend/src/main/java/com/jvk/school/service/AuthService.java - User lookup
backend/src/main/java/com/jvk/school/service/CustomUserDetailsService.java - JWT provider
backend/src/main/java/com/jvk/school/config/JwtTokenProvider.java - JWT request filter
backend/src/main/java/com/jvk/school/config/JwtAuthenticationFilter.java - Rust Argon2 module
rust-security/src/main.rs
Other components
- School staff
- SQL database
Connections 37
- School staff → Portal shell: uses
README.md - Portal shell → Classes and students: routes to
src/App.jsx - Portal shell → Attendance: routes to
src/App.jsx - Portal shell → Mark register: routes to
src/App.jsx - Portal shell → Homework defaulters: routes to
src/App.jsx - Portal shell → Reports: routes to
src/App.jsx - Portal shell → Subjects: routes to
src/App.jsx - Portal shell → Login: routes to
src/App.jsx - Classes and students → Shared app state: reads and updates
src/components/ClassesAndStudents.jsx - Attendance → Shared app state: uses
src/components/Attendance.jsx - Mark register → Shared app state: uses
src/components/MarkRegister.jsx - Homework defaulters → Shared app state: uses
src/components/HomeworkDefaulters.jsx - Reports → Shared app state: uses
src/components/Reports.jsx - Subjects → Shared app state: uses
src/components/Subjects.jsx - Marks views → Shared app state: uses
- Login → Shared app state: uses
src/components/Login.jsx - Shared app state → API client: calls
src/store.jsx - Shared app state → Argon2 client: calls
src/store.jsx - API client → Class and student API: requests
src/services/api.js - API client → Attendance API: requests
src/services/api.js - API client → Marks API: requests
src/services/api.js - API client → Subjects API: requests
src/services/api.js - API client → Authentication API: requests
src/services/api.js - Class and student API → School operations: delegates
backend/src/main/java/com/jvk/school/controller/StudentController.java - Attendance API → School operations: delegates
backend/src/main/java/com/jvk/school/controller/AttendanceController.java - Marks API → School operations: delegates
backend/src/main/java/com/jvk/school/controller/MarkController.java - Subjects API → School operations: delegates
backend/src/main/java/com/jvk/school/controller/SubjectController.java - School operations → Relational persistence: reads and writes
backend/src/main/java/com/jvk/school/service/SchoolService.java - Relational persistence → School records: persists
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
backend/src/main/java/com/jvk/school/service/AuthService.java - Login service → User lookup: authenticates via
- Login service → Relational persistence: loads user
backend/src/main/java/com/jvk/school/service/AuthService.java - User lookup → Relational persistence: loads user
backend/src/main/java/com/jvk/school/service/CustomUserDetailsService.java - JWT request filter → JWT provider: validates token
- Argon2 client → Rust Argon2 module: security integration