The Imaginary School System is a web application designed to manage student attendance efficiently. It features secure JWT authentication for user login and logout functionality. Upon login, users are directed to a dashboard where they can track and record student attendance for classes. Role-based access control ensures appropriate permissions for teachers, administrators, and staff. The system provides reporting capabilities to analyze attendance trends and support decision-making for student success.
- Java
- Spring Boot
- React
- Spring Security
- Spring Data JPA
- JWT (JSON Web Tokens)
- Java 17 or higher installed on your machine
- Maven installed on your machine
Clone this repository to your local machine:
git clone https://github.com/dilen1999/Imaginary-School-System
Navigate to the Project Directory
cd server
Set Up the Project
Open the project in your preferred IDE (e.g., IntelliJ IDEA, Eclipse).
Maven will automatically download the required dependencies.
Configuration
By default, the application uses in-memory storage for users. Ensure the application.properties file contains the following configurations:
# Disable data source auto-configuration if no database is needed
spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration
# JWT Configuration
app.jwt.secret=your_jwt_secret_key
app.jwt.expiration=3600
# Server Configuration
server.port=8080
# Logging Configuration
logging.level.org.springframework=DEBUG
logging.level.root=DEBUG
Running the Application
You can run the application using the Maven command:
mvn spring-boot:run
##Accessing the Endpoints
Once the application is running, you can access the endpoints using a REST client like Postman or any HTTP client library.
API Endpoints
Login: POST /api/auth/login
Request Body:
{
"username": "admin",
"password": "password"
}
Response
{
"jwt": "your_jwt_token"
}
##Testing Credentials
Use the following credentials to test the login endpoint:
Username: admin
Password: password
### Frontend (React)
#### Prerequisites
- Node.js installed
2. Navigate to the client directory:
3. Install dependencie using : npm i
4. Start the development server: npm start
The React frontend should now be running on `http://localhost:3000`.
## Screenshots
