feat: add catalogue image management (#1)

- Add CatalogueImage model with FK to Product
- Add image resize service (strict/non-strict modes with configurable dimensions)
- Add CRUD API endpoints with admin-only write permissions
- Add catalogue_images field to product listing/detail endpoints
- Serve media files in development via static()
- 28 TDD tests covering model, API, permissions, resize, and product listing

tienda_ilusion/don_confiao/serializers/__init__.py

@@ -1,3 +1,4 @@
+from .catalogue_images import CatalogueImageSerializer
 from .products import ProductSerializer, ListProductSerializer
 from .customers import CustomerSerializer, ListCustomerSerializer
 from .sales import (
@@ -17,6 +18,8 @@ from .payments import (
 )
 
 __all__ = [
+    # Catalogue Images
+    "CatalogueImageSerializer",
     # Products
     "ProductSerializer",
     "ListProductSerializer",

tienda_ilusion/don_confiao/serializers/catalogue_images.py

@@ -0,0 +1,20 @@
+from django.conf import settings
+from rest_framework import serializers
+
+from ..models.catalogue_images import CatalogueImage
+
+
+class CatalogueImageSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = CatalogueImage
+        fields = ["id", "product", "image", "uploaded_at"]
+        read_only_fields = ["uploaded_at"]
+
+    def validate_image(self, value):
+        max_size = settings.CATALOGUE_MAX_UPLOAD_SIZE
+        if value.size > max_size:
+            raise serializers.ValidationError(
+                f"Image size exceeds the maximum allowed size of "
+                f"{max_size // (1024 * 1024)}MB."
+            )
+        return value

tienda_ilusion/don_confiao/serializers/products.py

@@ -4,6 +4,8 @@ from ..models.products import Product, ProductCategory
 
 
 class ProductSerializer(serializers.ModelSerializer):
+    catalogue_images = serializers.SerializerMethodField()
+
     class Meta:
         model = Product
         fields = [
@@ -14,10 +16,31 @@ class ProductSerializer(serializers.ModelSerializer):
             "measuring_unit",
             "categories",
             "external_id",
+            "catalogue_images",
+        ]
+
+    def get_catalogue_images(self, obj):
+        request = self.context.get("request")
+        if not request:
+            return [img.image.url for img in obj.catalogue_images.all()]
+        return [
+            request.build_absolute_uri(img.image.url)
+            for img in obj.catalogue_images.all()
         ]
 
 
 class ListProductSerializer(serializers.ModelSerializer):
+    catalogue_images = serializers.SerializerMethodField()
+
     class Meta:
         model = Product
-        fields = ["id", "name"]
+        fields = ["id", "name", "catalogue_images"]
+
+    def get_catalogue_images(self, obj):
+        request = self.context.get("request")
+        if not request:
+            return [img.image.url for img in obj.catalogue_images.all()]
+        return [
+            request.build_absolute_uri(img.image.url)
+            for img in obj.catalogue_images.all()
+        ]