feat(promotions): add models, managers, admin and migrations

Author: tyronejosee

apps/promotions/admin.py

@@ -1 +1,17 @@
 """Admin for Promotions App."""
+
+from django.contrib import admin
+
+from .models import Promotion
+
+
+@admin.register(Promotion)
+class PromotionAdmin(admin.ModelAdmin):
+    """Admin config for Order model."""
+    search_fields = ["name", "user"]
+    list_display = ["name", "created_at", "available"]
+    list_filter = ["available",]
+    list_editable = ["available",]
+    list_per_page = 25
+    readonly_fields = ["pk", "created_at", "updated_at",]
+    ordering = ["created_at",]

apps/promotions/managers.py

@@ -0,0 +1,19 @@
+"""Managers for Promotions App."""
+
+from django.db.models import Manager
+
+
+class PromotionManager(Manager):
+    """Manager for Promotion model."""
+
+    def get_queryset(self):
+        # Default queryset
+        return super().get_queryset()
+
+    def get_available(self):
+        """Return a queryset of available drivers."""
+        return self.get_queryset().filter(available=True)
+
+    def get_unavailable(self):
+        """Return a queryset of unavailable drivers."""
+        return self.get_queryset().filter(available=False)

apps/promotions/migrations/0001_initial.py

@@ -0,0 +1,41 @@
+# Generated by Django 5.0.4 on 2024-04-29 18:52
+
+import apps.utilities.paths
+import django.core.validators
+import django.db.models.deletion
+import uuid
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='Promotion',
+            fields=[
+                ('id', models.UUIDField(default=uuid.uuid4, editable=False, primary_key=True, serialize=False)),
+                ('available', models.BooleanField(db_index=True, default=True)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('name', models.CharField(max_length=255)),
+                ('conditions', models.TextField()),
+                ('start_date', models.DateField()),
+                ('end_date', models.DateField()),
+                ('is_active', models.BooleanField(default=True)),
+                ('image', models.ImageField(upload_to=apps.utilities.paths.image_path, validators=[django.core.validators.FileExtensionValidator(allowed_extensions=['webp'])])),
+                ('creator', models.ForeignKey(null=True, on_delete=django.db.models.deletion.SET_NULL, to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'verbose_name': 'promotion',
+                'verbose_name_plural': 'promotions',
+                'ordering': ['pk'],
+            },
+        ),
+    ]

apps/promotions/migrations/__init__.py

@@ -1,56 +1,37 @@
 """Models for Promotions App."""
 
-# from django.db import models
-
-# class Promotion(models.Model):
-#     name = models.CharField(max_length=255)
-#     description = models.TextField()
-#     start_date = models.DateField()
-#     end_date = models.DateField()
-#     is_active = models.BooleanField(default=True)
-
-#     def __str__(self):
-#         return self.name
-
-
-# class PromotionCode(models.Model):
-#     promotion = models.ForeignKey(
-#         Promotion, on_delete=models.CASCADE, related_name='codes')
-#     code = models.CharField(max_length=50, unique=True)
-#     is_used = models.BooleanField(default=False)
-
-#     def __str__(self):
-#         return self.code
-
-
-# def create_promotion(name, description, start_date, end_date):
-#     promotion = Promotion.objects.create(
-#         name=name,
-#         description=description,
-#         start_date=start_date,
-#         end_date=end_date
-#     )
-#     return promotion
-
-
-# def create_promotion_code(promotion):
-#     code = generate_unique_code()
-#     # Implementa lógica para generar un código único
-#     promotion_code = PromotionCode.objects.create(
-#         promotion=promotion,
-#         code=code
-#     )
-#     return promotion_code
-
-
-# def validate_promotion_code(code):
-#     try:
-#         promotion_code = PromotionCode.objects.get(code=code)
-#         if promotion_code.is_used:
-#             return False, "El código ya fue utilizado"
-#         else:
-#             promotion_code.is_used = True
-#             promotion_code.save()
-#             return True, "Código válido"
-#     except PromotionCode.DoesNotExist:
-#         return False, "Código inválido"
+from django.conf import settings
+from django.db import models
+from django.core.validators import FileExtensionValidator
+
+from apps.utilities.models import BaseModel
+from apps.utilities.paths import image_path
+
+User = settings.AUTH_USER_MODEL
+
+
+class Promotion(BaseModel):
+    """Model definition for Promotion (Entity)."""
+    creator = models.ForeignKey(User, on_delete=models.SET_NULL, null=True)
+    name = models.CharField(max_length=255)
+    conditions = models.TextField()
+    start_date = models.DateField()
+    end_date = models.DateField()
+    is_active = models.BooleanField(default=True)
+    image = models.ImageField(
+        upload_to=image_path,
+        validators=[
+            FileExtensionValidator(allowed_extensions=["webp"]),
+        ]
+    )
+
+    # TODO: Add max file size, min and max dimensions validators
+
+    class Meta:
+        """Meta definition for FixedCoupon."""
+        ordering = ["pk"]
+        verbose_name = "promotion"
+        verbose_name_plural = "promotions"
+
+    def __str__(self):
+        return str(self.name)