EventEase - College Event Management System
EventEase is a full-stack web application for managing college events. The backend provides a RESTful API built with Flask, and the frontend is a dynamic single-page application. This platform simplifies the process of organizing and participating in campus activities for students, clubs, and administrators.
Features
- User Management: Secure signup, login, and role-based access control (Student, Club Admin, Admin).
- Event Management: Create, view, update, and delete events.
- Event Registration: Students can easily register for upcoming events.
- Feedback System: Allows users to provide feedback and ratings for events they have attended.
- Admin Dashboard: A control panel for Admins to manage users and approve or reject event submissions.
Project Workflow
The system is designed to serve different roles within a college environment:
- Admin: Has full control over the system. They can manage user accounts (verifying club admins, etc.) and have the final say on approving or rejecting any event created on the platform.
- Club Admin: Represents a college club or organization. They can create new events, and manage the events submitted by their club.
- Student: Can browse all approved events, register for events they are interested in, and provide valuable feedback and ratings after attending an event.
Tech Stack & Tools
Backend
- Framework: Flask
- Database: MySQL
- ORM: SQLAlchemy with Flask-SQLAlchemy
- Database Migrations: Flask-Migrate (using Alembic)
- Authentication: JWT (JSON Web Tokens) with Flask-JWT-Extended
Frontend
- Framework: React (or Vue/Angular)
- Package Manager: npm (or Yarn)
- Styling: CSS / SASS (or a framework like Material-UI/Tailwind CSS)
- API Communication: Axios
Development
- API Testing: Bruno / Postman
Setup and Installation
Follow these steps to get the full-stack application running on your local machine.
Prerequisites
- Node.js and npm
- Python 3.8+
- MySQL Server
- A virtual environment tool like
venv
1. Clone the Repository
git clone https://github.com/your-username/Event-Management-System.git
cd Event-Management-System
2. Backend Setup
Navigate to the Backend Directory
cd backendCreate and Activate Virtual Environment
# On Windows python -m venv venv venv\\Scripts\\activate # On macOS/Linux python3 -m venv venv source venv/bin/activateInstall Dependencies
pip install -r requirements.txtConfigure Environment Variables Create a
.envfile in thebackenddirectory. Use the template below, replacing the placeholder values with your database credentials.DATABASE_URL=mysql+pymysql://<your_mysql_user>:<your_mysql_password>@localhost/eventease JWT_SECRET_KEY=a_very_secret_jwt_key SECRET_KEY=a_super_secret_flask_keySet Up the Database Ensure your MySQL server is running and create a new database named
eventease. Then, apply the database migrations.flask db upgradeRun the Backend Server
flask runThe API server will start and be available at
http://127.0.0.1:5000.
3. Frontend Setup
Navigate to the Frontend Directory Open a new terminal and navigate to the
frontenddirectory from the project root.cd ../frontendInstall Dependencies
npm installConfigure Environment Variables Create a
.envfile in thefrontenddirectory to specify the backend API URL.REACT_APP_API_URL=http://127.0.0.1:5000Run the Frontend Application
npm startThe application will open in your browser, usually at
http://localhost:3000.
You should now have the EventEase application running locally with the frontend communicating with the backend. Feel free to explore the features, register as a new user, create events, and see the system in action.
For any issues or contributions, please open an issue or submit a pull request.
Built With
- css
- dockerfile
- html
- javascript
- mako
- python
