🚀 Project Title & Tagline

College Fest Management System 🎉 A comprehensive platform for managing college festivals, including event registration, participant management, and admin dashboard

📖 Description

The College Fest Management System is a web-based application designed to simplify the process of managing college festivals. The system allows students to register for events, view event schedules, and access event details. It also provides an admin dashboard for managing events, viewing participant lists, and monitoring registration status. The system is built using Python, Flask, and MySQL, ensuring a robust and scalable architecture.

The system consists of several modules, including event management, registration management, and participant management. The event management module allows admins to create, edit, and delete events, while the registration management module handles student registrations for events. The participant management module provides a list of participants for each event, enabling admins to track registration status and event attendance.

The College Fest Management System is designed to be user-friendly, with an intuitive interface that makes it easy for students and admins to navigate and use the system. The system also includes features such as email notifications, event reminders, and registration deadlines, ensuring that students and admins stay informed and up-to-date with festival activities.

✨ Features

The following are some of the key features of the College Fest Management System:

1. Event Management: Create, edit, and delete events, including event schedules, descriptions, and registration deadlines.
2. Registration Management: Handle student registrations for events, including registration status, participant lists, and event attendance tracking.
3. Participant Management: View participant lists for each event, including student details and registration status.
4. Admin Dashboard: Monitor festival activities, including event schedules, registration status, and participant lists.
5. Student Profile Management: Students can view their registration history, event schedules, and participant lists.
6. Email Notifications: Send email notifications to students and admins regarding event registrations, reminders, and deadlines.
7. Event Reminders: Send reminders to students and admins regarding upcoming events and registration deadlines.
8. Registration Deadlines: Set registration deadlines for events, ensuring that students register on time.

🧰 Tech Stack Table

Category	Technology
Frontend	HTML, CSS, JavaScript
Backend	Python, Flask
Database	MySQL
Tools	MySQL Connector, Flask-SQLAlchemy

📁 Project Structure

The project is organized into the following folders:

• app: Contains the Flask application code, including routes, templates, and static files.
• database: Contains the database connection code, including the MySQL connector and database schema.
• controllers: Contains the controller code, including admin and student controllers.
• models: Contains the model code, including event, student, and registration models.
• templates: Contains the HTML templates for the application, including event, registration, and participant templates.
• static: Contains the static files for the application, including CSS, JavaScript, and image files.

⚙️ How to Run

To run the application, follow these steps:

1. Install the required dependencies, including Python, Flask, and MySQL.
2. Create a MySQL database and update the database connection settings in the config.py file.
3. Run the application using python app.py.
4. Access the application in your web browser at http://localhost:5000.

🧪 Testing Instructions

To test the application, follow these steps:

1. Run the application using python app.py.
2. Access the application in your web browser at http://localhost:5000.
3. Test the event management features, including creating, editing, and deleting events.
4. Test the registration management features, including registering for events and viewing participant lists.
5. Test the participant management features, including viewing participant lists and tracking event attendance.

📸 Screenshots

Event Management

Registration Management

Participant Management

📦 API Reference

The application provides the following API endpoints:

• GET /events: Returns a list of all events.
• GET /events/<id>: Returns the details of a single event.
• POST /events: Creates a new event.
• PUT /events/<id>: Updates an existing event.
• DELETE /events/<id>: Deletes an event.

👤 Author

The College Fest Management System was developed by Your Name.

📝 License

The College Fest Management System is licensed under the MIT License.