https://github.com/derek486/django-events-management

A web-based event management system built with Django
https://github.com/derek486/django-events-management

django pillow sqlite

Last synced: about 1 month ago
JSON representation

A web-based event management system built with Django

Host: GitHub
URL: https://github.com/derek486/django-events-management
Owner: Derek486
License: mit
Created: 2023-10-16T01:04:43.000Z (over 2 years ago)
Default Branch: main
Last Pushed: 2025-03-25T19:53:53.000Z (about 1 year ago)
Last Synced: 2025-07-15T03:41:32.205Z (11 months ago)
Topics: django, pillow, sqlite
Language: Python
Homepage:
Size: 1.73 MB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# 📅 Event Management System

![Django](https://img.shields.io/badge/Django-green?style=for-the-badge&logo=django) ![SQLite](https://img.shields.io/badge/SQLite-blue?style=for-the-badge&logo=sqlite)

A web-based event management system built with Django, allowing users to create, manage, and participate in events.

---

## 🌟 Features

✅ **User Authentication** – Register and log in securely.
✅ **Event Creation** – Users can create and manage events.
✅ **Event Registration** – Users can sign up for events.
✅ **Sorting & Filtering** – Events can be organized by date, name, or organizer.
✅ **Image Upload** – Events can have cover images stored in the `media/` directory.

---

## 🏗️ Installation

### 1️⃣ Clone the Repository
```bash
$ git clone https://github.com/Derek486/django-events-management.git
$ cd django-events-management
```

### 2️⃣ Create a Virtual Environment & Install Dependencies
```bash
$ python -m venv venv
$ source venv/bin/activate # On Windows use `venv\Scripts\activate`
$ pip install -r requirements.txt
```

### 3️⃣ Apply Migrations & Run the Server
```bash
$ python manage.py migrate
$ python manage.py runserver
```

### 4️⃣ Access the Application
Go to [http://127.0.0.1:8000/](http://127.0.0.1:8000/) in your browser.

---

## 🏛️ Project Structure
```
.
├── eventos
│ ├── models.py # Database models
│ ├── views.py # Views for handling requests
│ ├── urls.py # URL routing
│ ├── templates/ # HTML templates
│ └── static/ # CSS, JS, and images
├── events_management_app
│ ├── settings.py # Django settings
│ ├── urls.py # Root URL configuration
│ └── wsgi.py # WSGI entry point
├── media
│ ├── portadas_eventos/ # Event cover images
├── db.sqlite3 # SQLite database
└── manage.py # Django command-line utility
```

---

## 📜 Database Models

### 👤 User (`Usuario`)
```python
class Usuario(AbstractUser):
email = models.EmailField(unique=True)
```

### 🎟️ Event (`Evento`)
```python
class Evento(models.Model):
autor = models.ForeignKey(Usuario, on_delete=models.CASCADE)
nombre = models.CharField(max_length=100)
descripcion = models.TextField()
fecha = models.DateField()
portada = models.ImageField(upload_to='portadas_eventos/', null=True, blank=True)
```

### 📝 Registration (`RegistroEvento`)
```python
class RegistroEvento(models.Model):
usuario = models.ForeignKey(Usuario, on_delete=models.CASCADE)
evento = models.ForeignKey(Evento, on_delete=models.CASCADE)
fecha_registro = models.DateTimeField(auto_now_add=True)
```

---

## 🖼️ Preview

### 📌 Event Listings & Details

Event List
Event Details