🌟 Evently: The Future of Event Planning 🚀

Connect • Plan • Celebrate
A Full-Stack Event Management System powered by Artificial Intelligence

---

📖 Table of Contents

• ✨ About the Project
• 🔥 Key Features
• ⚙️ System Architecture
• 🛠️ Tech Stack
• 🚀 Getting Started
• 📸 Screenshots
• 🤝 Contributing
• 📬 Contact

---

✨ About the Project

Evently is not just another booking app. It is a smart ecosystem that bridges the gap between Users, Vendors, and Admins.

Solved the chaos of manual planning by integrating:

• 🤖 AI Chatbot: Uses RAG (Retrieval-Augmented Generation) to answer questions based on real-time database availability.
• 💸 Secure Payments: Fully functional PayPal Sandbox integration for safe transactions.
• 🛡️ Vendor Verification: Admin-controlled approval system to ensure trust.

---

🔥 Key Features

👤 User Module

• Smart Search: Filter events by category, date, and price.
• AI Assistant: Ask "What is the price of the Tech Summit?" and get an instant answer.
• Booking History: Track all tickets and download invoices.

🏢 Vendor Module

• Event Creation: Easy-to-use dashboard to publish events.
• Analytics: Track ticket sales and revenue in real-time.
• Profile Management: Showcase portfolio images to attract customers.

👮 Admin Module

• Verification System: Approve or Reject new vendors.
• Platform Stats: View total users, bookings, and revenue.

---

⚙️ System Architecture

The app follows a robust Monolithic 3-Tier Architecture:

1. Frontend: React.js (Vite) communicates via REST APIs (Axios).
2. Backend: Java Spring Boot secures endpoints with JWT and manages logic.
3. Database: MySQL stores relational data (Users, Events, Bookings).
4. External Services: OpenRouter (AI) and PayPal (Payments).

---

🛠️ Tech Stack

Layer	Technology
Frontend	React.js, Vite, Tailwind CSS, Framer Motion, Axios
Backend	Java 17, Spring Boot 3.x, Spring Security (JWT), Hibernate
Database	MySQL 8.0
AI Integration	OpenRouter API (Grok / Gemini), RAG Implementation
Payments	PayPal Sandbox API
Tools	VS Code, Git, Maven, Postman

---

🚀 Getting Started

Follow these steps to set up the project locally.

1️⃣ Prerequisites

• Java JDK 17+
• Node.js 18+
• MySQL Server

2️⃣ Database Setup

1. Open MySQL Workbench.
2. Create a database named event_management_db.

   CREATE DATABASE event_management_db;

3. (Optional) The app uses update mode, so tables will be auto-generated.

3️⃣ Backend Setup (Spring Boot)

1. Navigate to the backend folder:

   cd backend

2. Configure src/main/resources/application.properties:

   spring.datasource.username=root
   spring.datasource.password=YOUR_MYSQL_PASSWORD
   app.paypal.clientId=YOUR_PAYPAL_CLIENT_ID
   app.paypal.clientSecret=YOUR_PAYPAL_SECRET
   app.openrouter.apiKey=YOUR_AI_API_KEY

3. Run the application:

   mvn spring-boot:run

4️⃣ Frontend Setup (React)

1. Navigate to the frontend folder:

   cd frontend

2. Install dependencies:

   npm install

3. Start the development server:

   npm run dev

---

🤝 Contributing

Contributions are what make the open-source community such an amazing place to learn!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📬 Contact

Durvesh Manohar Patil

• GitHub: Durvesh-code
• Email: patil.durvesh8668@gmail.com

_{Built with ❤️ by Durvesh}