An open API service indexing awesome lists of open source software.

https://github.com/shiinaneet/violationwebreactapp


https://github.com/shiinaneet/violationwebreactapp

Last synced: 3 months ago
JSON representation

Awesome Lists containing this project

README

        

# Student Violation Management with Email Integration

**Student Violation List** is a web application designed to manage student violations effectively. It allows users to create, edit, and delete violations, as well as visualize the data through charts that display monthly and overall student violations. The application is built using React with Vite and Material UI.

Website: [Student-Violations-Website](https://react.shiinaneet.site/)

## Features

- **CRUD Operations**: Create, read, update, and delete student violations.
- **Violation Management**: Easily manage and categorize student violations.
- **Data Visualization**: View charts for monthly and overall student violations.
- **Responsive Design**: Optimized for both desktop and mobile devices.

## Tech Stack

- **Frontend**: React (Vite)
- **UI Framework**: Material UI
- **Charts**: Material UI X
- **Deployment**: (Nginx - Ubuntu)

## Prerequisites

To run this project locally, you need to have the following installed:

- [Node.js](https://nodejs.org/en/)
- [npm](https://www.npmjs.com/)

## Installation

Follow these steps to set up the project locally:

1. **Clone the repository**:
```bash
git clone https://github.com/shiinaneet/ViolationWebReactApp.git
cd ViolationWebReactApp
```

2. **Install dependencies**:
```bash
npm install
```

3. **Run the application**:
```bash
npm run dev
```

4. **Open your browser**:
Visit `http://localhost:3000` (or the port specified in the console) to view the application.

## Screenshots

This is outdated. You can request them in Issues.

1. **Student with Violation List**
![Student with Violation List](https://github.com/user-attachments/assets/39acb72e-8403-42c0-995a-bcd072fa47d3)
![Edit student Violation](https://github.com/user-attachments/assets/9ddb6852-a53c-4839-ad62-a95696e9036d)
![Student Full information](https://github.com/user-attachments/assets/08c4654e-bb3f-464c-89ec-ce923832af91)
![Student Send Email](https://github.com/user-attachments/assets/919355d2-e65e-40af-b5e9-0f40982859ea)

2. **Violation List**
![Violation List](https://github.com/user-attachments/assets/63d9ced8-9b86-42f4-906a-19d4f556d5a4)

3. **Violation Chart**
![Chart](https://github.com/user-attachments/assets/b85a80b1-906c-429c-bc24-1f97fd0d7b7b)

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Contact

For any inquiries, please contact:
- **Name**: Gene Paolo Dayandayan
- **Email**: [email protected]
- **GitHub**: [github.com/ShiinaNeet](https://github.com/ShiinaNeet)