🎯 Smart Event Manager

A modular, feature-rich C++ CLI application for managing events with admin authentication, smart conflict detection, undo support, and email reminders.

---

📖 Overview

Smart Event Manager is a command-line C++ application that helps you organize personal and professional events with a clean, colorized terminal interface. It uses Object-Oriented Programming, file-based persistence (CSV), and a role-based access system to provide a robust event management experience.

---

👨‍💻 Author

Pranav Chaudhari — 2nd Year, PCCOE
📧 pranavchaudhari2006@gmail.com
🔗 github.com/Pranav-chaudhari-2006

---

🛠 Tech Stack

Technology	Purpose
C++17	Core language with OOP and STL
STL — vector, stack, map, regex	Data structures and algorithms
fstream / CSV	Persistent file-based event storage
PowerShell (send_mail.ps1)	Email reminder dispatch via SMTP
ANSI Color Codes	Colorized terminal output
MinGW g++	Compiler toolchain (Windows)

---

📁 Folder Structure

ACM-TASK/
├── assets/
│   └── screenshots/          # All UI screenshots
│       ├── 01_admin_access.png
│       ├── 02_main_menu.png
│       ├── 03_add_event.png
│       └── ...
├── include/                  # Header files (.h)
│   ├── Event.h               # Event class declaration
│   ├── EventManager.h        # EventManager class declaration
│   └── Utils.h               # Utility functions & color codes
├── src/                      # Implementation files (.cpp)
│   ├── Event.cpp             # Event constructors, getters, serialization
│   ├── EventManager.cpp      # All event management logic
│   └── main.cpp              # Entry point, menu loop, role system
├── obj/                      # Compiled object files (auto-generated)
├── .clangd                   # Clangd config (fixes IDE analysis for any IDE)
├── compile_commands.json     # Universal IDE language server config
├── build.bat                 # One-click Windows build & run script
├── Makefile                  # Alternative make-based build
├── send_mail.ps1             # PowerShell email dispatch script
├── events.csv                # Auto-generated event data (runtime)
└── README.md

---

✨ Features

🔐 Role-Based Access

• Admin — Full access (add, edit, delete, send reminders, statistics, sort, undo)
• User — Read-only access (view all, view today, view by date, search)
• Admin access is protected by a passcode

📅 Event Management (Admin)

Feature	Description
Add Event	Create events with ID, name, type, date (DD-MM-YYYY), time (HH:MM), location
Edit Event	Modify any field of an existing event by ID
Delete Event	Remove an event permanently by ID
Sort Events	Sort all events chronologically by date and time
Undo Last Operation	Stack-based undo — reverses the last add/edit/delete

🔍 Viewing & Search (Admin + User)

Feature	Description
View All Events	Tabular display of all scheduled events
View Today's Events	Automatically filters events for the current date
View By Date	Filter events for any specific date
Search Events	Keyword search across event name and type (case-insensitive)

🛡 Smart Validation

• Conflict Detection — Warns if two events clash at the same date/time
• Duplicate Detection — Prevents adding events with the same ID or identical name+date+time
• Smart Slot Suggestions — Suggests free time slots when a conflict is found
• Date & Time Validation — Enforces DD-MM-YYYY and HH:MM formats via regex

📊 Statistics & Reminders

• View Statistics — Shows total events, breakdown by type, upcoming events count
• Send Reminders — Reads an attendee CSV file and sends email reminders via PowerShell SMTP

---

🚀 How to Run

Prerequisites

• Windows OS
• MinGW g++ with g++ in your PATH
• PowerShell (for email feature)

1. Clone the Repository

git clone https://github.com/Pranav-chaudhari-2006/ACM-TASK.git
cd ACM-TASK

2. Build & Run (One Command)

.\build.bat

This compiles all source files and launches the application automatically.

3. Manual Compilation

g++ -std=c++17 -Wall -Iinclude src/main.cpp src/Event.cpp src/EventManager.cpp -o SmartEventManager.exe
.\SmartEventManager.exe

4. Configure Email Reminders (Optional)

Edit send_mail.ps1 and set your Gmail credentials:

[string]$User = "your_email@gmail.com"
[string]$Pass = "your_app_password"   # Gmail App Password, not your regular password

Note: Use a Gmail App Password, not your main password.

---

🖥 Sample CLI Usage

===== Smart Event Manager =====
 Admin Menu:
  1.  Add Event
  2.  Edit Event
  3.  Delete Event
  4.  View All Events
  5.  View Today
  6.  View by Date
  7.  Search Event
  8.  Send Reminders
  9.  View Statistics
  10. Sort Events (By Date)
  11. Undo Last Operation
  12. Exit
Enter choice: _

Default Admin Passcode: 1234

---

🖼 Screenshots

Feature	Preview
🔑 Admin Access
📋 Main Menu
➕ Add Event
✏️ Edit Event
📜 View All Events
📅 View Today
🔃 Sort Events
🗑️ Delete Event
🗓️ View By Date
🔍 Search Event
📊 View Stats
↩️ Undo Operation
❌ Exit

---

📜 License

This project is licensed under the MIT License — see the LICENSE file for details.