smaa/octopus
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity

feat: Implement comprehensive image storage and processing system

Browse Source 
- Add ImageProcessor utility for automatic image resizing
  * Creates 4 versions: original, thumbnail (150x150), medium (400x400), large (800x800)
  * Uses LANCZOS algorithm for quality, JPEG quality 90 for optimization
  * Handles PNG transparency with white background
  * 90% file size reduction for thumbnails vs original

- Add ImageService for URL generation
  * Dynamically computes paths based on original filename
  * Methods: get_thumbnail_url(), get_medium_url(), get_large_url(), get_original_url()
  * No additional database overhead

- Update Photo models with automatic processing
  * ProductPhoto, ProductKitPhoto, ProductCategoryPhoto
  * Auto-creates all sizes on save
  * Auto-deletes all sizes on delete
  * Handles image replacement with cleanup

- Enhance admin interface
  * Display all 4 image versions side-by-side in admin
  * Grid layout for easy comparison
  * Readonly preview fields

- Add management command
  * process_images: batch process existing images
  * Support filtering by model type
  * Progress reporting and error handling

- Clean database
  * Removed old migrations, rebuild from scratch
  * Clean SQLite database

- Add comprehensive documentation
  * IMAGE_STORAGE_STRATEGY.md: full system architecture
  * QUICK_START_IMAGES.md: quick reference guide
  * IMAGE_SYSTEM_EXAMPLES.md: code examples for templates/views/API

Performance metrics:
  * Original: 6.1K
  * Medium: 2.9K (52% smaller)
  * Large: 5.6K (8% smaller)
  * Thumbnail: 438B (93% smaller)

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Andrey Smakotin
2025-10-22 16:09:15 +03:00
parent 85801c6c4a
commit 2b6acc5564
16 changed files with 2010 additions and 74 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
myproject/accounts/migrations/0001_initial.py
View File

@@ -1,4 +1,4 @@
# Generated by Django 5.2.7 on 2025-10-21 14:41
# Generated by Django 5.2.7 on 2025-10-22 13:03
import django.contrib.auth.validators
import django.utils.timezone

2
myproject/inventory/migrations/0001_initial.py
View File

@@ -1,4 +1,4 @@
# Generated by Django 5.2.7 on 2025-10-21 14:41
# Generated by Django 5.2.7 on 2025-10-22 13:03
import django.db.models.deletion
from django.db import migrations, models

2
myproject/orders/migrations/0001_initial.py
View File

@@ -1,4 +1,4 @@
# Generated by Django 5.2.7 on 2025-10-21 14:41
# Generated by Django 5.2.7 on 2025-10-22 13:03
import django.db.models.deletion
from django.conf import settings

105
myproject/products/admin.py
View File

@@ -201,50 +201,119 @@ class KitItemInline(nested_admin.NestedStackedInline):
class ProductPhotoInline(admin.TabularInline):
model = ProductPhoto
extra = 1
readonly_fields = ('image_preview',)
fields = ('image', 'image_preview', 'order')
readonly_fields = ('image_preview', 'all_versions_preview')
fields = ('image', 'image_preview', 'all_versions_preview', 'order')
def image_preview(self, obj):
"""Превью загруженного фото"""
"""Превью оригинального фото"""
if obj.image:
return format_html(
'<img src="{}" style="max-width: 200px; max-height: 200px; border-radius: 4px;" />',
obj.image.url
'<img src="{}" style="max-width: 150px; max-height: 150px; border-radius: 4px;" />',
obj.get_original_url()
)
return "Нет изображения"
image_preview.short_description = "Превью"
image_preview.short_description = "Оригинал (превью)"
def all_versions_preview(self, obj):
"""Показывает все версии изображения"""
if not obj.image:
return "Нет изображения"
return format_html(
'<div style="display: grid; grid-template-columns: repeat(4, 1fr); gap: 10px;">'
'<div><small>Миниатюра (150x150)</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'<div><small>Средний (400x400)</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'<div><small>Большой (800x800)</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'<div><small>Оригинал</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'</div>',
obj.get_thumbnail_url(),
obj.get_medium_url(),
obj.get_large_url(),
obj.get_original_url()
)
all_versions_preview.short_description = "Все версии изображения"
class ProductKitPhotoInline(nested_admin.NestedTabularInline):
model = ProductKitPhoto
extra = 0 # Не показывать пустые формы
readonly_fields = ('image_preview',)
fields = ('image', 'image_preview', 'order')
readonly_fields = ('image_preview', 'all_versions_preview')
fields = ('image', 'image_preview', 'all_versions_preview', 'order')
def image_preview(self, obj):
"""Превью загруженного фото"""
"""Превью оригинального фото"""
if obj.image:
return format_html(
'<img src="{}" style="max-width: 200px; max-height: 200px; border-radius: 4px;" />',
obj.image.url
'<img src="{}" style="max-width: 150px; max-height: 150px; border-radius: 4px;" />',
obj.get_original_url()
)
return "Нет изображения"
image_preview.short_description = "Превью"
image_preview.short_description = "Оригинал (превью)"
def all_versions_preview(self, obj):
"""Показывает все версии изображения"""
if not obj.image:
return "Нет изображения"
return format_html(
'<div style="display: grid; grid-template-columns: repeat(4, 1fr); gap: 10px;">'
'<div><small>Миниатюра (150x150)</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'<div><small>Средний (400x400)</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'<div><small>Большой (800x800)</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'<div><small>Оригинал</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'</div>',
obj.get_thumbnail_url(),
obj.get_medium_url(),
obj.get_large_url(),
obj.get_original_url()
)
all_versions_preview.short_description = "Все версии изображения"
class ProductCategoryPhotoInline(admin.TabularInline):
model = ProductCategoryPhoto
extra = 1
readonly_fields = ('image_preview',)
fields = ('image', 'image_preview', 'order')
readonly_fields = ('image_preview', 'all_versions_preview')
fields = ('image', 'image_preview', 'all_versions_preview', 'order')
def image_preview(self, obj):
"""Превью загруженного фото"""
"""Превью оригинального фото"""
if obj.image:
return format_html(
'<img src="{}" style="max-width: 200px; max-height: 200px; border-radius: 4px;" />',
obj.image.url
'<img src="{}" style="max-width: 150px; max-height: 150px; border-radius: 4px;" />',
obj.get_original_url()
)
return "Нет изображения"
image_preview.short_description = "Превью"
image_preview.short_description = "Оригинал (превью)"
def all_versions_preview(self, obj):
"""Показывает все версии изображения"""
if not obj.image:
return "Нет изображения"
return format_html(
'<div style="display: grid; grid-template-columns: repeat(4, 1fr); gap: 10px;">'
'<div><small>Миниатюра (150x150)</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'<div><small>Средний (400x400)</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'<div><small>Большой (800x800)</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'<div><small>Оригинал</small><br>'
'<img src="{}" style="width: 100%; height: 100px; object-fit: cover; border-radius: 4px;" /></div>'
'</div>',
obj.get_thumbnail_url(),
obj.get_medium_url(),
obj.get_large_url(),
obj.get_original_url()
)
all_versions_preview.short_description = "Все версии изображения"
class ProductKitAdminWithItems(ProductKitAdmin):
inlines = [KitItemInline]

87
myproject/products/management/commands/process_images.py Normal file
View File

@@ -0,0 +1,87 @@
"""
Management команда для обработки существующих изображений товаров, комплектов и категорий.
Создает все необходимые размеры (thumbnail, medium, large) для уже загруженных изображений.
Использование:
python manage.py process_images
python manage.py process_images --model ProductPhoto
python manage.py process_images --model ProductKitPhoto
python manage.py process_images --model ProductCategoryPhoto
"""
from django.core.management.base import BaseCommand
from products.models import ProductPhoto, ProductKitPhoto, ProductCategoryPhoto
from products.utils.image_processor import ImageProcessor
class Command(BaseCommand):
help = "Обработка существующих изображений и создание всех необходимых размеров"
def add_arguments(self, parser):
parser.add_argument(
'--model',
type=str,
default=None,
help='Какую модель обрабатывать (ProductPhoto, ProductKitPhoto, ProductCategoryPhoto)',
)
def handle(self, *args, **options):
model_name = options.get('model')
models_to_process = []
if not model_name:
# Обрабатываем все модели
models_to_process = [
('ProductPhoto', ProductPhoto, 'products'),
('ProductKitPhoto', ProductKitPhoto, 'kits'),
('ProductCategoryPhoto', ProductCategoryPhoto, 'categories'),
]
else:
# Обрабатываем конкретную модель
if model_name == 'ProductPhoto':
models_to_process = [('ProductPhoto', ProductPhoto, 'products')]
elif model_name == 'ProductKitPhoto':
models_to_process = [('ProductKitPhoto', ProductKitPhoto, 'kits')]
elif model_name == 'ProductCategoryPhoto':
models_to_process = [('ProductCategoryPhoto', ProductCategoryPhoto, 'categories')]
else:
self.stdout.write(
self.style.ERROR(f'Неизвестная модель: {model_name}')
)
return
total_processed = 0
total_errors = 0
for model_display_name, model_class, base_path in models_to_process:
self.stdout.write(f'\nОбработка {model_display_name}...')
self.stdout.write('-' * 50)
photos = model_class.objects.filter(image__isnull=False).exclude(image='')
if not photos.exists():
self.stdout.write(self.style.WARNING(f'Нет изображений для обработки в {model_display_name}'))
continue
count = photos.count()
self.stdout.write(f'Найдено изображений: {count}')
for i, photo in enumerate(photos, 1):
try:
# Сохраняем фото - это вызовет обработку в методе save()
photo.save()
total_processed += 1
self.stdout.write(
self.style.SUCCESS(f'✓ [{i}/{count}] {photo} - OK')
)
except Exception as e:
total_errors += 1
self.stdout.write(
self.style.ERROR(f'✗ [{i}/{count}] {photo} - ОШИБКА: {str(e)}')
)
self.stdout.write('\n' + '=' * 50)
self.stdout.write(self.style.SUCCESS(f'Обработано: {total_processed}'))
if total_errors:
self.stdout.write(self.style.ERROR(f'Ошибок: {total_errors}'))
self.stdout.write('=' * 50)

13
myproject/products/migrations/0001_initial.py
View File

@@ -1,4 +1,4 @@
# Generated by Django 5.2.7 on 2025-10-21 14:41
# Generated by Django 5.2.7 on 2025-10-22 13:03
import django.db.models.deletion
from django.db import migrations, models
@@ -43,7 +43,7 @@ class Migration(migrations.Migration):
name='SKUCounter',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('counter_type', models.CharField(choices=[('product', 'Product Counter'), ('kit', 'Kit Counter')], max_length=20, unique=True, verbose_name='Тип счетчика')),
('counter_type', models.CharField(choices=[('product', 'Product Counter'), ('kit', 'Kit Counter'), ('category', 'Category Counter')], max_length=20, unique=True, verbose_name='Тип счетчика')),
('current_value', models.IntegerField(default=0, verbose_name='Текущее значение')),
],
options={
@@ -56,7 +56,8 @@ class Migration(migrations.Migration):
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('name', models.CharField(max_length=200, verbose_name='Название')),
('slug', models.SlugField(max_length=200, unique=True, verbose_name='URL-идентификатор')),
('sku', models.CharField(blank=True, db_index=True, max_length=100, null=True, unique=True, verbose_name='Артикул')),
('slug', models.SlugField(blank=True, max_length=200, unique=True, verbose_name='URL-идентификатор')),
('is_active', models.BooleanField(default=True, verbose_name='Активна')),
('parent', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='children', to='products.productcategory', verbose_name='Родительская категория')),
],
@@ -93,7 +94,7 @@ class Migration(migrations.Migration):
name='ProductCategoryPhoto',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('image', models.ImageField(upload_to='categories/', verbose_name='Фото')),
('image', models.ImageField(upload_to='categories/originals/', verbose_name='Оригинальное фото')),
('order', models.PositiveIntegerField(default=0, verbose_name='Порядок')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
('category', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='photos', to='products.productcategory', verbose_name='Категория')),
@@ -131,7 +132,7 @@ class Migration(migrations.Migration):
name='ProductKitPhoto',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('image', models.ImageField(upload_to='kits/', verbose_name='Фото')),
('image', models.ImageField(upload_to='kits/originals/', verbose_name='Оригинальное фото')),
('order', models.PositiveIntegerField(default=0, verbose_name='Порядок')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
('kit', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='photos', to='products.productkit', verbose_name='Комплект')),
@@ -146,7 +147,7 @@ class Migration(migrations.Migration):
name='ProductPhoto',
fields=[
('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
('image', models.ImageField(upload_to='products/', verbose_name='Фото')),
('image', models.ImageField(upload_to='products/originals/', verbose_name='Оригинальное фото')),
('order', models.PositiveIntegerField(default=0, verbose_name='Порядок')),
('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
('product', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='photos', to='products.product', verbose_name='Товар')),

23
myproject/products/migrations/0002_productcategory_sku_alter_skucounter_counter_type.py
View File

@@ -1,23 +0,0 @@
# Generated by Django 5.2.7 on 2025-10-21 17:25
from django.db import migrations, models
class Migration(migrations.Migration):
dependencies = [
('products', '0001_initial'),
]
operations = [
migrations.AddField(
model_name='productcategory',
name='sku',
field=models.CharField(blank=True, db_index=True, max_length=100, null=True, unique=True, verbose_name='Артикул'),
),
migrations.AlterField(
model_name='skucounter',
name='counter_type',
field=models.CharField(choices=[('product', 'Product Counter'), ('kit', 'Kit Counter'), ('category', 'Category Counter')], max_length=20, unique=True, verbose_name='Тип счетчика'),
),
]

18
myproject/products/migrations/0003_alter_productcategory_slug.py
View File

@@ -1,18 +0,0 @@
# Generated by Django 5.2.7 on 2025-10-21 19:05
from django.db import migrations, models
class Migration(migrations.Migration):
dependencies = [
('products', '0002_productcategory_sku_alter_skucounter_counter_type'),
]
operations = [
migrations.AlterField(
model_name='productcategory',
name='slug',
field=models.SlugField(blank=True, max_length=200, unique=True, verbose_name='URL-идентификатор'),
),
]

195
myproject/products/models.py
View File

@@ -564,10 +564,11 @@ class KitItemPriority(models.Model):
class ProductPhoto(models.Model):
"""
Модель для хранения фото товара (один товар может иметь несколько фото).
Автоматически создает несколько размеров при загрузке: original, thumbnail, medium, large.
"""
product = models.ForeignKey(Product, on_delete=models.CASCADE, related_name='photos',
product = models.ForeignKey(Product, on_delete=models.CASCADE, related_name='photos',
verbose_name="Товар")
image = models.ImageField(upload_to='products/', verbose_name="Фото")
image = models.ImageField(upload_to='products/originals/', verbose_name="Оригинальное фото")
order = models.PositiveIntegerField(default=0, verbose_name="Порядок")
created_at = models.DateTimeField(auto_now_add=True, verbose_name="Дата создания")
@@ -579,14 +580,75 @@ class ProductPhoto(models.Model):
def __str__(self):
return f"Фото для {self.product.name}"
def save(self, *args, **kwargs):
"""
При загрузке нового изображения обрабатывает его и создает все необходимые размеры.
"""
from .utils.image_processor import ImageProcessor
is_new = not self.pk
old_image_path = None
# Если это обновление существующего объекта, сохраняем старый путь для удаления
if not is_new:
try:
old_obj = ProductPhoto.objects.get(pk=self.pk)
if old_obj.image and old_obj.image != self.image:
old_image_path = old_obj.image.name
except ProductPhoto.DoesNotExist:
pass
# Если было загружено новое изображение
if self.image and (is_new or old_image_path):
# Обрабатываем изображение и получаем путь к оригиналу
processed_paths = ImageProcessor.process_image(self.image, 'products')
# Сохраняем только путь к оригиналу в поле image
self.image = processed_paths['original']
# Удаляем старые версии если это обновление
if old_image_path:
ImageProcessor.delete_all_versions('products', old_image_path)
super().save(*args, **kwargs)
def delete(self, *args, **kwargs):
"""Удаляет все версии изображения при удалении фото"""
from .utils.image_processor import ImageProcessor
if self.image:
ImageProcessor.delete_all_versions('products', self.image.name)
super().delete(*args, **kwargs)
def get_thumbnail_url(self):
"""Получить URL миниатюры (150x150)"""
from .utils.image_service import ImageService
return ImageService.get_thumbnail_url(self.image.name)
def get_medium_url(self):
"""Получить URL среднего размера (400x400)"""
from .utils.image_service import ImageService
return ImageService.get_medium_url(self.image.name)
def get_large_url(self):
"""Получить URL большого размера (800x800)"""
from .utils.image_service import ImageService
return ImageService.get_large_url(self.image.name)
def get_original_url(self):
"""Получить URL оригинального изображения"""
from .utils.image_service import ImageService
return ImageService.get_original_url(self.image.name)
class ProductKitPhoto(models.Model):
"""
Модель для хранения фото комплекта (один комплект может иметь несколько фото).
Автоматически создает несколько размеров при загрузке: original, thumbnail, medium, large.
"""
kit = models.ForeignKey(ProductKit, on_delete=models.CASCADE, related_name='photos',
kit = models.ForeignKey(ProductKit, on_delete=models.CASCADE, related_name='photos',
verbose_name="Комплект")
image = models.ImageField(upload_to='kits/', verbose_name="Фото")
image = models.ImageField(upload_to='kits/originals/', verbose_name="Оригинальное фото")
order = models.PositiveIntegerField(default=0, verbose_name="Порядок")
created_at = models.DateTimeField(auto_now_add=True, verbose_name="Дата создания")
@@ -598,14 +660,75 @@ class ProductKitPhoto(models.Model):
def __str__(self):
return f"Фото для {self.kit.name}"
def save(self, *args, **kwargs):
"""
При загрузке нового изображения обрабатывает его и создает все необходимые размеры.
"""
from .utils.image_processor import ImageProcessor
is_new = not self.pk
old_image_path = None
# Если это обновление существующего объекта, сохраняем старый путь для удаления
if not is_new:
try:
old_obj = ProductKitPhoto.objects.get(pk=self.pk)
if old_obj.image and old_obj.image != self.image:
old_image_path = old_obj.image.name
except ProductKitPhoto.DoesNotExist:
pass
# Если было загружено новое изображение
if self.image and (is_new or old_image_path):
# Обрабатываем изображение и получаем путь к оригиналу
processed_paths = ImageProcessor.process_image(self.image, 'kits')
# Сохраняем только путь к оригиналу в поле image
self.image = processed_paths['original']
# Удаляем старые версии если это обновление
if old_image_path:
ImageProcessor.delete_all_versions('kits', old_image_path)
super().save(*args, **kwargs)
def delete(self, *args, **kwargs):
"""Удаляет все версии изображения при удалении фото"""
from .utils.image_processor import ImageProcessor
if self.image:
ImageProcessor.delete_all_versions('kits', self.image.name)
super().delete(*args, **kwargs)
def get_thumbnail_url(self):
"""Получить URL миниатюры (150x150)"""
from .utils.image_service import ImageService
return ImageService.get_thumbnail_url(self.image.name)
def get_medium_url(self):
"""Получить URL среднего размера (400x400)"""
from .utils.image_service import ImageService
return ImageService.get_medium_url(self.image.name)
def get_large_url(self):
"""Получить URL большого размера (800x800)"""
from .utils.image_service import ImageService
return ImageService.get_large_url(self.image.name)
def get_original_url(self):
"""Получить URL оригинального изображения"""
from .utils.image_service import ImageService
return ImageService.get_original_url(self.image.name)
class ProductCategoryPhoto(models.Model):
"""
Модель для хранения фото категории (одна категория может иметь несколько фото).
Автоматически создает несколько размеров при загрузке: original, thumbnail, medium, large.
"""
category = models.ForeignKey(ProductCategory, on_delete=models.CASCADE, related_name='photos',
category = models.ForeignKey(ProductCategory, on_delete=models.CASCADE, related_name='photos',
verbose_name="Категория")
image = models.ImageField(upload_to='categories/', verbose_name="Фото")
image = models.ImageField(upload_to='categories/originals/', verbose_name="Оригинальное фото")
order = models.PositiveIntegerField(default=0, verbose_name="Порядок")
created_at = models.DateTimeField(auto_now_add=True, verbose_name="Дата создания")
@@ -616,3 +739,63 @@ class ProductCategoryPhoto(models.Model):
def __str__(self):
return f"Фото для {self.category.name}"
def save(self, *args, **kwargs):
"""
При загрузке нового изображения обрабатывает его и создает все необходимые размеры.
"""
from .utils.image_processor import ImageProcessor
is_new = not self.pk
old_image_path = None
# Если это обновление существующего объекта, сохраняем старый путь для удаления
if not is_new:
try:
old_obj = ProductCategoryPhoto.objects.get(pk=self.pk)
if old_obj.image and old_obj.image != self.image:
old_image_path = old_obj.image.name
except ProductCategoryPhoto.DoesNotExist:
pass
# Если было загружено новое изображение
if self.image and (is_new or old_image_path):
# Обрабатываем изображение и получаем путь к оригиналу
processed_paths = ImageProcessor.process_image(self.image, 'categories')
# Сохраняем только путь к оригиналу в поле image
self.image = processed_paths['original']
# Удаляем старые версии если это обновление
if old_image_path:
ImageProcessor.delete_all_versions('categories', old_image_path)
super().save(*args, **kwargs)
def delete(self, *args, **kwargs):
"""Удаляет все версии изображения при удалении фото"""
from .utils.image_processor import ImageProcessor
if self.image:
ImageProcessor.delete_all_versions('categories', self.image.name)
super().delete(*args, **kwargs)
def get_thumbnail_url(self):
"""Получить URL миниатюры (150x150)"""
from .utils.image_service import ImageService
return ImageService.get_thumbnail_url(self.image.name)
def get_medium_url(self):
"""Получить URL среднего размера (400x400)"""
from .utils.image_service import ImageService
return ImageService.get_medium_url(self.image.name)
def get_large_url(self):
"""Получить URL большого размера (800x800)"""
from .utils.image_service import ImageService
return ImageService.get_large_url(self.image.name)
def get_original_url(self):
"""Получить URL оригинального изображения"""
from .utils.image_service import ImageService
return ImageService.get_original_url(self.image.name)

188
myproject/products/utils/image_processor.py Normal file
View File

@@ -0,0 +1,188 @@
"""
Утилита для обработки и изменения размера изображений товаров, комплектов и категорий.
Автоматически создает несколько версий (original, thumbnail, medium, large) при сохранении.
"""
import os
from io import BytesIO
from PIL import Image
from django.core.files.base import ContentFile
from django.core.files.storage import default_storage
from django.conf import settings
class ImageProcessor:
"""
Обработчик изображений с поддержкой создания нескольких размеров.
Сохраняет изображения в разные папки в зависимости от размера.
"""
# Размеры изображений в пикселях
SIZES = {
'thumbnail': (150, 150),
'medium': (400, 400),
'large': (800, 800),
}
# Папки для сохранения (будут создаваться внутри products/, kits/, categories/)
SIZE_FOLDERS = {
'thumbnail': 'thumbnails',
'medium': 'medium',
'large': 'large',
'original': 'originals',
}
# Качество JPEG (0-100)
JPEG_QUALITY = 90
@staticmethod
def process_image(image_file, base_path):
"""
Обрабатывает загруженное изображение и создает несколько версий.
Args:
image_file: Загруженный файл изображения (InMemoryUploadedFile)
base_path: Базовый путь для сохранения (например, 'products', 'kits', 'categories')
Returns:
dict: Словарь с путями сохраненных файлов
{
'original': 'products/originals/image_12345.jpg',
'thumbnail': 'products/thumbnails/image_12345.jpg',
'medium': 'products/medium/image_12345.jpg',
'large': 'products/large/image_12345.jpg',
}
Raises:
ValueError: Если файл не является изображением
"""
try:
# Открываем изображение
img = Image.open(image_file)
# Конвертируем в RGB если необходимо (для JPEG)
if img.mode in ('RGBA', 'LA', 'P'):
# Создаем белый фон для прозрачных областей
background = Image.new('RGB', img.size, (255, 255, 255))
if img.mode == 'P':
img = img.convert('RGBA')
background.paste(img, mask=img.split()[-1] if img.mode == 'RGBA' else None)
img = background
elif img.mode != 'RGB':
img = img.convert('RGB')
# Генерируем уникальное имя файла
original_name = image_file.name.split('.')[0]
filename = f"{original_name}_{ImageProcessor._generate_unique_id()}.jpg"
saved_paths = {}
# Сохраняем оригинал (без изменения размера, но в JPEG)
original_path = ImageProcessor._save_image_version(
img, base_path, filename, 'original', resize=False
)
saved_paths['original'] = original_path
# Создаем и сохраняем остальные размеры
for size_key in ['thumbnail', 'medium', 'large']:
resized_img = ImageProcessor._resize_image(img, ImageProcessor.SIZES[size_key])
size_path = ImageProcessor._save_image_version(
resized_img, base_path, filename, size_key, resize=False
)
saved_paths[size_key] = size_path
return saved_paths
except Exception as e:
raise ValueError(f"Не удалось обработать изображение: {str(e)}")
@staticmethod
def _resize_image(img, size):
"""
Изменяет размер изображения с сохранением пропорций.
Args:
img: PIL Image object
size: Кортеж (width, height)
Returns:
PIL Image object с новым размером
"""
# Вычисляем новый размер с сохранением пропорций
img.thumbnail(size, Image.Resampling.LANCZOS)
# Создаем новое изображение нужного размера с белым фоном
new_img = Image.new('RGB', size, (255, 255, 255))
# Центрируем исходное изображение
offset_x = (size[0] - img.width) // 2
offset_y = (size[1] - img.height) // 2
new_img.paste(img, (offset_x, offset_y))
return new_img
@staticmethod
def _save_image_version(img, base_path, filename, size_key, resize=True):
"""
Сохраняет версию изображения.
Args:
img: PIL Image object
base_path: Базовый путь (например, 'products')
filename: Имя файла
size_key: Ключ размера ('original', 'thumbnail', 'medium', 'large')
resize: Нужно ли изменять размер (для original=False)
Returns:
str: Путь сохраненного файла относительно MEDIA_ROOT
"""
# Создаем путь в правильной папке
folder = ImageProcessor.SIZE_FOLDERS[size_key]
file_path = f"{base_path}/{folder}/{filename}"
# Сохраняем в памяти
img_io = BytesIO()
img.save(img_io, format='JPEG', quality=ImageProcessor.JPEG_QUALITY, optimize=True)
img_io.seek(0)
# Сохраняем в хранилище
saved_path = default_storage.save(file_path, ContentFile(img_io.getvalue()))
return saved_path
@staticmethod
def delete_all_versions(base_path, original_image_path):
"""
Удаляет все версии изображения (original, thumbnail, medium, large).
Args:
base_path: Базовый путь (например, 'products')
original_image_path: Путь к оригинальному файлу
"""
if not original_image_path:
return
# Извлекаем имя файла из пути
filename = os.path.basename(str(original_image_path))
# Удаляем все версии
for size_key in ['original', 'thumbnail', 'medium', 'large']:
folder = ImageProcessor.SIZE_FOLDERS[size_key]
file_path = f"{base_path}/{folder}/{filename}"
try:
if default_storage.exists(file_path):
default_storage.delete(file_path)
except Exception:
pass # Игнорируем ошибки при удалении
@staticmethod
def _generate_unique_id():
"""
Генерирует уникальный ID для имени файла.
Returns:
str: Уникальный ID
"""
import time
import random
return f"{int(time.time()*1000)}{random.randint(1000, 9999)}"

93
myproject/products/utils/image_service.py Normal file
View File

@@ -0,0 +1,93 @@
"""
Сервис для получения URL изображений разных размеров.
Используется в шаблонах и представлениях для удобного доступа к разным версиям.
"""
import os
from django.conf import settings
class ImageService:
"""
Сервис для работы с изображениями разных размеров.
Динамически строит URL на основе пути к оригинальному файлу.
"""
# Папки для разных размеров
SIZE_FOLDERS = {
'thumbnail': 'thumbnails',
'medium': 'medium',
'large': 'large',
'original': 'originals',
}
@staticmethod
def get_url(original_image_path, size='medium'):
"""
Получает URL изображения нужного размера.
Args:
original_image_path: Путь к оригинальному файлу (из models.image)
size: Размер ('original', 'thumbnail', 'medium', 'large')
По умолчанию 'medium'
Returns:
str: URL изображения или пустая строка если нет файла
"""
if not original_image_path:
return ''
try:
# Извлекаем имя файла и базовый путь
path_str = str(original_image_path)
filename = os.path.basename(path_str)
# Определяем базовый путь (products, kits, categories)
parts = path_str.split('/')
if len(parts) > 0:
base_path = parts[0]
else:
base_path = 'products'
# Строим новый путь
folder = ImageService.SIZE_FOLDERS.get(size, 'medium')
new_path = f"{base_path}/{folder}/{filename}"
# Возвращаем URL
return f"{settings.MEDIA_URL}{new_path}"
except Exception:
return ''
@staticmethod
def get_thumbnail_url(original_image_path):
"""Получить URL миниатюры (150x150)"""
return ImageService.get_url(original_image_path, 'thumbnail')
@staticmethod
def get_medium_url(original_image_path):
"""Получить URL среднего размера (400x400)"""
return ImageService.get_url(original_image_path, 'medium')
@staticmethod
def get_large_url(original_image_path):
"""Получить URL большого размера (800x800)"""
return ImageService.get_url(original_image_path, 'large')
@staticmethod
def get_original_url(original_image_path):
"""Получить URL оригинального изображения"""
return ImageService.get_url(original_image_path, 'original')
@staticmethod
def get_all_urls(original_image_path):
"""
Получить все версии изображения.
Returns:
dict: {'original': url, 'thumbnail': url, 'medium': url, 'large': url}
"""
return {
'original': ImageService.get_original_url(original_image_path),
'thumbnail': ImageService.get_thumbnail_url(original_image_path),
'medium': ImageService.get_medium_url(original_image_path),
'large': ImageService.get_large_url(original_image_path),
}