Event Management App

A Django-based event management application that allows users to create, view, and register for events.

Features

• Event Management: Create, view, and manage events
• User Registration: Users can register and unregister for events
• Event Filtering: Filter events by upcoming, past, or all events
• Search Functionality: Search events by title, description, or location
• Attendee Limits: Set maximum attendee limits for events
• Admin Panel: Full Django admin interface for managing events and registrations

Setup Instructions

Prerequisites

• Python 3.8 or higher
• pip (Python package manager)

Installation

1. Activate the virtual environment (if not already activated):

   # On Windows (PowerShell)
   .\venv\Scripts\Activate.ps1
   
   # On Windows (Command Prompt)
   venv\Scripts\activate
   
   # On macOS/Linux
   source venv/bin/activate

2. Install dependencies (if not already installed):

   pip install -r requirements.txt

3. Run migrations (if not already done):

   python manage.py migrate

4. Create a superuser (to access the admin panel):

   python manage.py createsuperuser

   Follow the prompts to create an admin user.

5. Run the development server:

   python manage.py runserver

6. Access the application:

   • Main app: http://127.0.0.1:8000/
   • Admin panel: http://127.0.0.1:8000/admin/

Project Structure

mysocialeventapp/
├── eventmanager/          # Django project settings
│   ├── settings.py        # Project configuration
│   ├── urls.py           # Main URL configuration
│   └── ...
├── events/                # Events app
│   ├── models.py         # Event and EventRegistration models
│   ├── views.py          # View functions
│   ├── urls.py           # App URL configuration
│   ├── admin.py          # Admin configuration
│   └── templates/        # HTML templates
│       └── events/
│           ├── base.html
│           ├── event_list.html
│           ├── event_detail.html
│           └── event_create.html
├── manage.py             # Django management script
├── requirements.txt      # Python dependencies
└── README.md            # This file

Models

Event

• title: Event title
• description: Event description
• location: Event location
• start_date: Event start date and time
• end_date: Event end date and time
• created_by: User who created the event
• max_attendees: Maximum number of attendees (optional)
• is_active: Whether the event is active
• created_at: Creation timestamp
• updated_at: Last update timestamp

EventRegistration

• event: Foreign key to Event
• user: Foreign key to User
• registered_at: Registration timestamp

Usage

1. View Events: Navigate to the home page to see all events
2. Filter Events: Use the filter buttons to view all, upcoming, or past events
3. Search Events: Use the search bar to find events by keywords
4. Create Event: Click "Create Event" (requires login)
5. Register for Event: Click "Register for Event" on any event detail page (requires login)
6. Admin Panel: Access the admin panel to manage events and users

Development

To make changes to the application:

1. Make your changes to models, views, or templates
2. If you changed models, create and run migrations:

   python manage.py makemigrations
   python manage.py migrate

3. Restart the development server to see changes

Technologies Used

• Django 5.2.8
• Python 3
• SQLite (default database)

License

This project is open source and available for personal and commercial use.