https://github.com/lakshay1341/campusadmin
CampusAdmin is a Spring web application designed to manage student information efficiently. The application allows users to add, update, find, and delete student records through a user-friendly interface. The backend is built using Spring Boot, providing a robust and scalable solution for handling API requests.
https://github.com/lakshay1341/campusadmin
javascript lombok maven pagination restfull-api spring-boot spring-data-jpa spring-mvc swagger-ui
Last synced: 16 days ago
JSON representation
CampusAdmin is a Spring web application designed to manage student information efficiently. The application allows users to add, update, find, and delete student records through a user-friendly interface. The backend is built using Spring Boot, providing a robust and scalable solution for handling API requests.
- Host: GitHub
- URL: https://github.com/lakshay1341/campusadmin
- Owner: lakshay1341
- Created: 2025-01-09T12:58:23.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-13T16:42:00.000Z (about 1 year ago)
- Last Synced: 2025-03-06T20:17:03.591Z (about 1 year ago)
- Topics: javascript, lombok, maven, pagination, restfull-api, spring-boot, spring-data-jpa, spring-mvc, swagger-ui
- Language: Java
- Homepage:
- Size: 1.16 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Project Documentation for CampusAdmin
## Project Overview
**Project Name**: CampusAdmin
**Backend Framework**: Spring Boot
CampusAdmin is a web application designed to manage student information efficiently. The application allows users to add, update, find, and delete student records through a user-friendly interface. The backend is built using Spring Boot, providing a robust and scalable solution for handling API requests.
## Features
- **Add Student**: Users can add new student records with relevant details.
- **Update Student**: Existing student records can be updated with new information.
- **Find Student**: Users can search for a student by their ID to view details.
- **Delete Student**: Users can remove a student record from the system.
- **View All Students**: A table displaying all students with pagination support for better performance and usability.
## Technical Stack
- **Frontend**: HTML, CSS (Bootstrap)
- **Backend**: Spring Boot
- **Database**: MySQL
- **API Communication**: RESTful APIs
- **API Documentation**: Swagger UI
## Installation Instructions
1. **Clone the Repository**
```bash
git clone https://github.com/lakshay1341/CampusAdmin.git
cd CampusAdmin
```
2. **Set Up the Database**
- Create a database in your preferred database management system.
- Update the `application.properties` file in the `src/main/resources` directory with your database connection details.
3. **Run the Application**
- Navigate to the project directory and run:
```bash
./mvnw spring-boot:run
```
- The application will start on `http://localhost:8080`.
4. **Access the Swagger UI**
- Open your web browser and go to:
```
http://localhost:8080/swagger-ui.html
```
- Use this interface to explore and test the APIs.
## API Documentation (via Swagger UI)
The API documentation for CampusAdmin is auto-generated and accessible through Swagger UI. It provides an interactive interface to test and understand all available endpoints.
### How to Use Swagger UI
1. Navigate to `http://localhost:8080/swagger-ui.html`.
2. Expand each API endpoint group to view detailed documentation.
3. Use the "Try it out" button to test API endpoints directly from the browser.
4. Review responses for each endpoint, including HTTP status codes and data structures.
### Example Endpoints (Available in Swagger UI)
- **POST /api/student/create**: Add a new student.
- **PUT /api/student/modify**: Update student details.
- **GET /api/student/find/{id}**: Find a student by ID.
- **DELETE /api/student/remove/{id}**: Delete a student by ID.
- **GET /api/student/all**: View all students with pagination.
## Conclusion
The CampusAdmin project provides a comprehensive solution for managing student records efficiently using modern web technologies. With the integration of Swagger UI, API testing and documentation have become seamless, enhancing the overall development and user experience.