Project URL: https://github.com/SamBen-Ghars/Academic-Project-Dsk-App

# 🎯 Academic Project - JavaFX Desktop Application

## 🌟 Project Overview This is a **modern and interactive desktop application** developed in **JavaFX**, following the **Model-View-Controller (MVC)** architecture. The project showcases a structured approach to software development using **native Java** and **Maven**.

## 🚀 Features ✅ **Recipe Management** – Browse and manage Tunisian cooking recipes with step-by-step instructions. ✅ **Good Deals Section** – Discover and manage exclusive offers and promotions. ✅ **User Reviews & Ratings** – Share feedback and rate recipes and deals. ✅ **Community Forum** – Engage in discussions and share experiences. ✅ **Quizzes & Challenges** – Test your knowledge with interactive quizzes.

## 🛠️ Technologies Used - ⚡ **Java (Native)** – Core backend logic. - 🎨 **JavaFX** – Rich UI development. - 📦 **Maven** – Dependency management and build automation. - 🏗️ **FXML** – UI structuring. - 🗄️ **MySQL** – Robust database management.

## 📥 Installation & Setup ### Prerequisites Ensure you have the following installed: ✔️ **Java Development Kit (JDK 17 or later)** ✔️ **Maven** ✔️ **MySQL Database**

### Steps to Run the Project 1️⃣ **Clone the repository:** ```sh git clone https://github.com/SamBen-Ghars/Academic-Project-Dsk-App.git ``` 2️⃣ **Navigate to the project folder:** ```sh cd Academic-Project-Dsk-App ``` 3️⃣ **Open the project in your favorite Java IDE** (e.g., IntelliJ IDEA, Eclipse, or NetBeans). 4️⃣ **Ensure JavaFX is properly configured** in your IDE settings. 5️⃣ **Build and launch the application using Maven:** ```sh mvn clean install mvn javafx:run ```

## 🗃️ Database Setup 1️⃣ Import the provided MySQL database dump into your MySQL instance. 2️⃣ Update the database connection settings in the application properties file.

## 👥 Contributing Contributions are welcome! If you'd like to enhance this project, please fork the repository, create a new branch, and submit a pull request.

## ✨ Author 👤 **Samah Ben Ghars**

## 📜 License This project is licensed under the **MIT License**. Feel free to use and modify it as needed.

## 📬 Contact For any inquiries or feedback, reach out via **GitHub Issues** or **Email**.

--- 🚀 *Happy Coding!* 🎉