https://github.com/aykrimino/donation-system-java-swing
A donation management system built with Java Swing and AWT for the UI, MySQL for the database, and a well-structured architecture (Models, DAO, Services, GUI).
https://github.com/aykrimino/donation-system-java-swing
awt-graphics awt-gui intellij intellij-idea java mysql mysql-connector mysql-database mysql-workbench oop oop-principles oops-in-java swing swing-application swing-gui
Last synced: about 2 months ago
JSON representation
A donation management system built with Java Swing and AWT for the UI, MySQL for the database, and a well-structured architecture (Models, DAO, Services, GUI).
- Host: GitHub
- URL: https://github.com/aykrimino/donation-system-java-swing
- Owner: AyKrimino
- Created: 2024-11-25T16:49:48.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2024-12-19T13:59:11.000Z (6 months ago)
- Last Synced: 2025-05-01T15:22:33.294Z (about 2 months ago)
- Topics: awt-graphics, awt-gui, intellij, intellij-idea, java, mysql, mysql-connector, mysql-database, mysql-workbench, oop, oop-principles, oops-in-java, swing, swing-application, swing-gui
- Language: Java
- Homepage:
- Size: 352 KB
- Stars: 1
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Donation Management System
## Table of Contents
- [Overview](#overview)
- [Features](#features)
- [Donors](#donors)
- [Associations](#associations)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Step 1: Clone the Repository](#step-1-clone-the-repository)
- [Step 2: Set Up the Database](#step-2-set-up-the-database)
- [Step 3: Run the Application](#step-3-run-the-application)
- [Option 1: Run Directly Using IntelliJ IDEA](#option-1-run-directly-using-intellij-idea)
- [Option 2: Run from the Terminal](#option-2-run-from-the-terminal)
- [Step 4: Add the MySQL Connector to `lib/`](#step-4-add-the-mysql-connector-to-lib)
- [Usage](#usage)
- [Diagrams](#diagrams)
- [Class Diagram](#class-diagram)
- [Use Case Diagram](#use-case-diagram)
- [Screenshots](#screenshots)
- [Project Report](#project-report)
- [Contributions](#contributions)
- [License](#license)
## Overview
The Donation Management System is a Java Swing application designed to facilitate the management of donations between **donors** and **associations**. This application provides an intuitive graphical user interface for:
- **Donors** to manage their donations (create, update, delete, view).
- **Associations** to collect donations and manage their records.
## Features
### Donors
1. **Donation Management**: Donors can create, update, delete, and view their donations.
2. **Dashboard**: Donors have a dashboard listing all their donations and showing the details of collections made by associations.
### Associations
1. **Donation Collection**: Associations can view all available donations and collect them in specified quantities.
2. **Dashboard**: Associations have a dashboard that lists all the donations they have collected.
## Prerequisites
1. **Java Development Kit (JDK)** installed.
2. **MySQL Database** setup.
3. **IntelliJ IDEA** for running the project.
4. **MySQL Connector/J** jar file version `9.1.0` added to the `lib` directory.
5. **Git installed on your machine.**
## Installation
### Step 1: Clone the Repository
Ensure Git is installed on your system. If not, install it from [Git Downloads](https://git-scm.com/downloads).
Run the following command to clone the repository:
```bash
git clone https://github.com/AyKrimino/donation-system-java-swing.git
```
Navigate to the project directory:
```bash
cd donation-system-java-swing
```
### Step 2: Set Up the Database
1. Create a MySQL database named `donation_db`.
2. Run the SQL schema provided in the `resources/sql/schema.sql` file to set up the tables.
3. Update the `.env` file with your database connection details:
```
DB_URL=jdbc:mysql://localhost:3306/YOUR_DATABASE_NAME
DB_USER=YOUR_DATABASE_USERNAME
DB_PASSWORD=YOUR_DATABASE_PASSWORD
```
### Step 3: Run the Application
#### Option 1: Run Directly Using IntelliJ IDEA
1. Open the project in IntelliJ IDEA.
2. Configure the classpath to include the `mysql-connector-j-9.1.0.jar` file located in the `lib/` directory.
3. Run the `Main` class to start the application.
#### Option 2: Run from the Terminal
1. Ensure the `mysql-connector-j-9.1.0.jar` file is in the `lib/` directory.
2. Compile the application:
```bash
javac -cp ".:./lib/mysql-connector-j-9.1.0.jar" app/*.java dao/*.java gui/*.java models/*.java services/*.java utils/*.java -d bin/
```
3. Run the application:
```bash
java -cp ".:./bin:./lib/mysql-connector-j-9.1.0.jar" app.Main
```
### Step 4: Add the MySQL Connector to `lib/`
Ensure the `mysql-connector-j-9.1.0.jar` file is available in the `lib/` directory. If not, download it from [MySQL Connector/J](https://dev.mysql.com/downloads/connector/j/).
## Usage
1. **Login**: Enter your credentials to log in as a donor or association user.
2. **Dashboard Navigation**:
- Donors: Manage your donations and view collections.
- Associations: View available donations and collect them.
3. **Real-time Updates**: Changes made by donors or associations are reflected immediately in the database.
## Diagrams
### Class Diagram
### Use Case Diagram
## Screenshots
- **Welcome Page**
- **Login Page**
- **Register Donor Page**
- **Register Association Page**
- **Donations Page**
- **Available Donations Page**
- **Donor Dashboard**
- **Association Dashboard**
## Project Report
This project was created as part of our coursework at L'institut supérieur d'informatique (ISI Ariana) by myself and my partner Wajdi. You can view the full project report here: [Project Report](https://docs.google.com/document/d/1jTIKGPCk7zFJRlhYqlZAtrCGzYiZfsAS3IcBJLnfScE/edit?tab=t.0)
## Contributions
Contributions are welcome! Feel free to fork this repository and submit pull requests with improvements or fixes.
## License
This project is licensed under the [MIT License](LICENSE).