🎯 Smart Event System

Smart Event System is a Django-based event management platform enhanced with AI-powered insights to help organizers manage events efficiently, monitor risks, and make informed decisions using real-time analytics.

---

🚀 Key Features

👨‍💼 Organizer (Admin Dashboard)

• Create, update, and delete events
• Professional dashboard with:
  • Total Events
  • Low Risk Events
  • High Risk Events
• Interactive charts:
  • Registrations vs Capacity (Bar Chart)
  • Risk Distribution (Donut Chart)
• AI-generated event insights
• Deep AI Analysis page
• Clean, modern, responsive UI

🎓 Student Module

• View available events
• See remaining capacity
• Register for events
• Simple and user-friendly interface

🤖 AI Intelligence

• Integrated with Groq API (LLaMA 3)
• Automatically analyzes:
  • Event risk levels
  • Capacity utilization
  • Registration patterns
• AI insights displayed directly on the dashboard

---

🛠 Tech Stack

• Backend: Django (Python)
• Frontend: HTML, CSS, JavaScript
• Charts: Chart.js
• Database: SQLite
• AI Engine: Groq API (LLaMA 3)
• Styling: Custom professional CSS
• Environment: Virtualenv

---

📁 Project Structure

smart_event_system/
│
├── config/
│   ├── __init__.py
│   ├── asgi.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
│
├── events/
│   ├── __init__.py
│   ├── admin.py
│   ├── ai_agent.py
│   ├── apps.py
│   ├── forms.py
│   ├── models.py
│   ├── tests.py
│   ├── urls.py
│   └── views.py
│
├── templates/
│   ├── base.html
│   ├── base_auth.html
│   ├── registration/
│   │   └── login.html
│   └── events/
│       ├── admin_dashboard.html
│       ├── admin_analysis.html
│       ├── create_event.html
│       ├── update_event.html
│       ├── delete_event.html
│       └── student_event_list.html
│
├── static/
│   ├── css/
│   │   ├── app.css
│   │   └── admin_dashboard.css
│   └── js/
│       ├── app.js
│       └── admin_dashboard.js
│
├── .env
├── .gitignore
├── db.sqlite3
├── manage.py
├── requirements.txt
├── run_app.ps1
└── README.md

---

🔐 Environment Variables

Create a .env file in the root directory:

GROQ_API_KEY=your_groq_api_key_here

⚠️ Important

• Never commit .env to GitHub
• API keys are loaded using python-dotenv

---

▶️ How to Run the Project

1️⃣ Clone the Repository

git clone https://github.com/your-username/your-repo-name.git
cd smart_event_system

2️⃣ Create Virtual Environment

python -m venv venv

3️⃣ Activate Virtual Environment

Windows

venv\Scripts\activate

Linux / macOS

source venv/bin/activate

4️⃣ Install Dependencies

pip install -r requirements.txt

5️⃣ Apply Migrations

python manage.py migrate

6️⃣ Create Superuser

python manage.py createsuperuser

7️⃣ Run the Server

python manage.py runserver

OR (Windows shortcut):

.\run_app.ps1

---

🌐 Application URLs

• Organizer Dashboard
  http://127.0.0.1:8000/organizer/dashboard/

• Student Events Page
  http://127.0.0.1:8000/events/

• Django Admin Panel
  http://127.0.0.1:8000/admin/

---

📊 Dashboard Highlights

• Card-based statistics layout
• Side-by-side responsive charts
• Smooth hover animations
• AI insights section
• Professional admin UI

---

🔒 Security

• .env excluded via .gitignore
• CSRF protection enabled
• API keys securely handled
• Role-based access (Organizer / Student)

---

📌 Future Enhancements

• Email notifications
• Role-based permissions
• Deployment (AWS / Render)
• Export reports (PDF / CSV)
• Real-time analytics

---

👨‍💻 Developed By

Smart Event System
Built with ❤️ using Django, AI, and modern UI practices.