Implement flexible order status management system

Features: - Created OrderStatus model for managing statuses per tenant - Added system-level statuses: draft, new, confirmed, in_assembly, in_delivery, completed, return, cancelled - Implemented CRUD views for managing order statuses - Created OrderStatusService with status transitions and business logic hooks - Updated Order model to use ForeignKey to OrderStatus - Added is_returned flag for tracking returned orders - Updated filters to work with new OrderStatus model - Created management command for status initialization - Added HTML templates for status list, form, and confirmation - Fixed views.py to use OrderStatus instead of removed STATUS_CHOICES 🤖 Generated with Claude Code Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-13 16:29:50 +03:00
parent 0d5f0d2015
commit c7875f147c
28 changed files with 1337 additions and 390 deletions
--- a/myproject/orders/migrations/0001_initial.py
+++ b/myproject/orders/migrations/0001_initial.py
@@ -1,4 +1,4 @@
-# Generated by Django 5.0.10 on 2025-11-09 22:18
+# Generated by Django 5.0.10 on 2025-11-13 13:12

 import django.db.models.deletion
 import simple_history.models
@@ -17,6 +17,28 @@ class Migration(migrations.Migration):
    ]

    operations = [
+        migrations.CreateModel(
+            name='OrderStatus',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=100, verbose_name='Название статуса')),
+                ('code', models.SlugField(help_text="Уникальный идентификатор (например: 'completed', 'cancelled')", unique=True, verbose_name='Код статуса')),
+                ('label', models.CharField(blank=True, max_length=100, verbose_name='Метка для отображения')),
+                ('is_system', models.BooleanField(default=False, help_text='True для встроенных статусов (draft, completed, cancelled)', verbose_name='Системный статус')),
+                ('is_positive_end', models.BooleanField(default=False, help_text='True если это финальный успешный статус (Выполнен)', verbose_name='Положительный конец')),
+                ('is_negative_end', models.BooleanField(default=False, help_text='True если это финальный отрицательный статус (Отменен)', verbose_name='Отрицательный конец')),
+                ('order', models.PositiveIntegerField(default=0, verbose_name='Порядок отображения')),
+                ('color', models.CharField(blank=True, default='#808080', help_text='Например: #FF5733', max_length=7, verbose_name='Цвет (hex)')),
+                ('description', models.TextField(blank=True, verbose_name='Описание')),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+            ],
+            options={
+                'verbose_name': 'Статус заказа',
+                'verbose_name_plural': 'Статусы заказов',
+                'ordering': ['order', 'name'],
+            },
+        ),
        migrations.CreateModel(
            name='Payment',
            fields=[
@@ -32,6 +54,30 @@ class Migration(migrations.Migration):
                'ordering': ['-payment_date'],
            },
        ),
+        migrations.CreateModel(
+            name='Address',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('recipient_name', models.CharField(blank=True, help_text='Имя человека, которому будет доставлен заказ', max_length=200, null=True, verbose_name='Имя получателя')),
+                ('recipient_phone', models.CharField(blank=True, help_text='Контактный телефон получателя для уточнения адреса', max_length=20, null=True, verbose_name='Телефон получателя')),
+                ('street', models.CharField(blank=True, max_length=255, null=True, verbose_name='Улица')),
+                ('building_number', models.CharField(blank=True, max_length=20, null=True, verbose_name='Номер здания')),
+                ('apartment_number', models.CharField(blank=True, max_length=20, null=True, verbose_name='Номер квартиры/офиса')),
+                ('entrance', models.CharField(blank=True, help_text='Номер подъезда/входа', max_length=20, null=True, verbose_name='Подъезд')),
+                ('floor', models.CharField(blank=True, max_length=20, null=True, verbose_name='Этаж')),
+                ('intercom_code', models.CharField(blank=True, help_text='Код домофона для входа в здание', max_length=100, null=True, verbose_name='Код домофона')),
+                ('delivery_instructions', models.TextField(blank=True, help_text='Дополнительные инструкции для курьера', null=True, verbose_name='Инструкции для доставки')),
+                ('confirm_address_with_recipient', models.BooleanField(default=False, help_text='Курьер должен уточнить адрес у получателя перед доставкой', verbose_name='Уточнить адрес у получателя')),
+                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
+                ('updated_at', models.DateTimeField(auto_now=True, verbose_name='Дата обновления')),
+            ],
+            options={
+                'verbose_name': 'Адрес доставки',
+                'verbose_name_plural': 'Адреса доставки',
+                'ordering': ['-created_at'],
+                'indexes': [models.Index(fields=['created_at'], name='orders_addr_created_98ad97_idx')],
+            },
+        ),
        migrations.CreateModel(
            name='HistoricalOrder',
            fields=[
@@ -42,7 +88,8 @@ class Migration(migrations.Migration):
                ('delivery_time_start', models.TimeField(blank=True, help_text='Начало временного интервала', null=True, verbose_name='Время от')),
                ('delivery_time_end', models.TimeField(blank=True, help_text='Конец временного интервала', null=True, verbose_name='Время до')),
                ('delivery_cost', models.DecimalField(decimal_places=2, default=0, help_text='0 для самовывоза', max_digits=10, verbose_name='Стоимость доставки')),
-                ('status', models.CharField(choices=[('draft', 'Черновик'), ('new', 'Новый'), ('confirmed', 'Подтвержден'), ('in_assembly', 'В сборке'), ('in_delivery', 'В доставке'), ('delivered', 'Доставлен'), ('cancelled', 'Отменен')], default='new', max_length=20, verbose_name='Статус заказа')),
+                ('is_custom_delivery_cost', models.BooleanField(default=False, help_text='True если стоимость доставки была изменена вручную', verbose_name='Стоимость доставки установлена вручную')),
+                ('is_returned', models.BooleanField(default=False, help_text='True если заказ был выполнен, но потом отменен или возвращен клиентом', verbose_name='Возвращен')),
                ('last_autosave_at', models.DateTimeField(blank=True, help_text='Время последнего автоматического сохранения черновика', null=True, verbose_name='Последнее автосохранение')),
                ('payment_method', models.CharField(choices=[('cash_to_courier', 'Наличные курьеру'), ('card_to_courier', 'Карта курьеру'), ('online', 'Онлайн оплата'), ('bank_transfer', 'Банковский перевод')], default='cash_to_courier', max_length=20, verbose_name='Способ оплаты')),
                ('is_paid', models.BooleanField(default=False, verbose_name='Оплачен')),
@@ -62,7 +109,7 @@ class Migration(migrations.Migration):
                ('history_change_reason', models.CharField(max_length=100, null=True)),
                ('history_type', models.CharField(choices=[('+', 'Created'), ('~', 'Changed'), ('-', 'Deleted')], max_length=1)),
                ('customer', models.ForeignKey(blank=True, db_constraint=False, null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to='customers.customer', verbose_name='Клиент')),
-                ('delivery_address', models.ForeignKey(blank=True, db_constraint=False, help_text='Обязательно для курьерской доставки', null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to='customers.address', verbose_name='Адрес доставки')),
+                ('delivery_address', models.ForeignKey(blank=True, db_constraint=False, help_text='Обязательно для курьерской доставки', null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to='orders.address', verbose_name='Адрес доставки')),
                ('history_user', models.ForeignKey(null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='+', to=settings.AUTH_USER_MODEL)),
                ('modified_by', models.ForeignKey(blank=True, db_constraint=False, help_text='Последний пользователь, изменивший заказ', null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to=settings.AUTH_USER_MODEL, verbose_name='Изменен пользователем')),
                ('pickup_shop', models.ForeignKey(blank=True, db_constraint=False, help_text='Обязательно для самовывоза', null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to='shops.shop', verbose_name='Точка самовывоза')),
@@ -85,7 +132,8 @@ class Migration(migrations.Migration):
                ('delivery_time_start', models.TimeField(blank=True, help_text='Начало временного интервала', null=True, verbose_name='Время от')),
                ('delivery_time_end', models.TimeField(blank=True, help_text='Конец временного интервала', null=True, verbose_name='Время до')),
                ('delivery_cost', models.DecimalField(decimal_places=2, default=0, help_text='0 для самовывоза', max_digits=10, verbose_name='Стоимость доставки')),
-                ('status', models.CharField(choices=[('draft', 'Черновик'), ('new', 'Новый'), ('confirmed', 'Подтвержден'), ('in_assembly', 'В сборке'), ('in_delivery', 'В доставке'), ('delivered', 'Доставлен'), ('cancelled', 'Отменен')], default='new', max_length=20, verbose_name='Статус заказа')),
+                ('is_custom_delivery_cost', models.BooleanField(default=False, help_text='True если стоимость доставки была изменена вручную', verbose_name='Стоимость доставки установлена вручную')),
+                ('is_returned', models.BooleanField(default=False, help_text='True если заказ был выполнен, но потом отменен или возвращен клиентом', verbose_name='Возвращен')),
                ('last_autosave_at', models.DateTimeField(blank=True, help_text='Время последнего автоматического сохранения черновика', null=True, verbose_name='Последнее автосохранение')),
                ('payment_method', models.CharField(choices=[('cash_to_courier', 'Наличные курьеру'), ('card_to_courier', 'Карта курьеру'), ('online', 'Онлайн оплата'), ('bank_transfer', 'Банковский перевод')], default='cash_to_courier', max_length=20, verbose_name='Способ оплаты')),
                ('is_paid', models.BooleanField(default=False, verbose_name='Оплачен')),
@@ -101,7 +149,7 @@ class Migration(migrations.Migration):
                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
                ('updated_at', models.DateTimeField(auto_now=True, verbose_name='Дата обновления')),
                ('customer', models.ForeignKey(on_delete=django.db.models.deletion.PROTECT, related_name='orders', to='customers.customer', verbose_name='Клиент')),
-                ('delivery_address', models.ForeignKey(blank=True, help_text='Обязательно для курьерской доставки', null=True, on_delete=django.db.models.deletion.PROTECT, related_name='orders', to='customers.address', verbose_name='Адрес доставки')),
+                ('delivery_address', models.OneToOneField(blank=True, help_text='Обязательно для курьерской доставки', null=True, on_delete=django.db.models.deletion.CASCADE, related_name='order', to='orders.address', verbose_name='Адрес доставки')),
                ('modified_by', models.ForeignKey(blank=True, help_text='Последний пользователь, изменивший заказ', null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='modified_orders', to=settings.AUTH_USER_MODEL, verbose_name='Изменен пользователем')),
                ('pickup_shop', models.ForeignKey(blank=True, help_text='Обязательно для самовывоза', null=True, on_delete=django.db.models.deletion.PROTECT, related_name='pickup_orders', to='shops.shop', verbose_name='Точка самовывоза')),
            ],
--- a/myproject/orders/migrations/0002_initial.py
+++ b/myproject/orders/migrations/0002_initial.py
@@ -1,4 +1,4 @@
-# Generated by Django 5.0.10 on 2025-11-09 22:18
+# Generated by Django 5.0.10 on 2025-11-13 13:12

 import django.db.models.deletion
 from django.conf import settings
@@ -26,6 +26,26 @@ class Migration(migrations.Migration):
            name='product_kit',
            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='order_items', to='products.productkit', verbose_name='Комплект товаров'),
        ),
+        migrations.AddField(
+            model_name='orderstatus',
+            name='created_by',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='created_order_statuses', to=settings.AUTH_USER_MODEL, verbose_name='Создано'),
+        ),
+        migrations.AddField(
+            model_name='orderstatus',
+            name='updated_by',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='updated_order_statuses', to=settings.AUTH_USER_MODEL, verbose_name='Последнее изменение'),
+        ),
+        migrations.AddField(
+            model_name='order',
+            name='status',
+            field=models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.PROTECT, related_name='orders', to='orders.orderstatus', verbose_name='Статус заказа'),
+        ),
+        migrations.AddField(
+            model_name='historicalorder',
+            name='status',
+            field=models.ForeignKey(blank=True, db_constraint=False, null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to='orders.orderstatus', verbose_name='Статус заказа'),
+        ),
        migrations.AddField(
            model_name='payment',
            name='created_by',
@@ -36,13 +56,37 @@ class Migration(migrations.Migration):
            name='order',
            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='payments', to='orders.order', verbose_name='Заказ'),
        ),
+        migrations.AddIndex(
+            model_name='orderitem',
+            index=models.Index(fields=['order'], name='orders_orde_order_i_5d347b_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='orderitem',
+            index=models.Index(fields=['product'], name='orders_orde_product_32ff41_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='orderitem',
+            index=models.Index(fields=['product_kit'], name='orders_orde_product_925b51_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='orderstatus',
+            index=models.Index(fields=['code'], name='orders_orde_code_5e1ef7_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='orderstatus',
+            index=models.Index(fields=['is_system'], name='orders_orde_is_syst_2f5b85_idx'),
+        ),
+        migrations.AddIndex(
+            model_name='orderstatus',
+            index=models.Index(fields=['order'], name='orders_orde_order_2e2930_idx'),
+        ),
        migrations.AddIndex(
            model_name='order',
            index=models.Index(fields=['customer'], name='orders_orde_custome_59b6fb_idx'),
        ),
        migrations.AddIndex(
            model_name='order',
-            index=models.Index(fields=['status'], name='orders_orde_status_c6dd84_idx'),
+            index=models.Index(fields=['status'], name='orders_orde_status__eb4f00_idx'),
        ),
        migrations.AddIndex(
            model_name='order',
@@ -65,16 +109,8 @@ class Migration(migrations.Migration):
            index=models.Index(fields=['order_number'], name='orders_orde_order_n_f3ada5_idx'),
        ),
        migrations.AddIndex(
-            model_name='orderitem',
-            index=models.Index(fields=['order'], name='orders_orde_order_i_5d347b_idx'),
-        ),
-        migrations.AddIndex(
-            model_name='orderitem',
-            index=models.Index(fields=['product'], name='orders_orde_product_32ff41_idx'),
-        ),
-        migrations.AddIndex(
-            model_name='orderitem',
-            index=models.Index(fields=['product_kit'], name='orders_orde_product_925b51_idx'),
+            model_name='order',
+            index=models.Index(fields=['is_custom_delivery_cost'], name='orders_orde_is_cust_108e98_idx'),
        ),
        migrations.AddIndex(
            model_name='payment',
--- a/myproject/orders/migrations/0003_remove_address_model.py
+++ b/myproject/orders/migrations/0003_remove_address_model.py
@@ -1,46 +0,0 @@
-# Generated by Django 5.0.10 on 2025-11-10 23:09
-
-import django.db.models.deletion
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
-    dependencies = [
-        ('orders', '0002_initial'),
-    ]
-
-    operations = [
-        migrations.CreateModel(
-            name='Address',
-            fields=[
-                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
-                ('recipient_name', models.CharField(help_text='Имя человека, которому будет доставлен заказ', max_length=200, verbose_name='Имя получателя')),
-                ('recipient_phone', models.CharField(blank=True, help_text='Контактный телефон получателя для уточнения адреса', max_length=20, null=True, verbose_name='Телефон получателя')),
-                ('street', models.CharField(max_length=255, verbose_name='Улица')),
-                ('building_number', models.CharField(max_length=20, verbose_name='Номер здания')),
-                ('apartment_number', models.CharField(blank=True, max_length=20, null=True, verbose_name='Номер квартиры/офиса')),
-                ('district', models.CharField(blank=True, help_text='Район в Минске для удобства доставки', max_length=100, null=True, verbose_name='Район')),
-                ('delivery_instructions', models.TextField(blank=True, help_text='Дополнительные инструкции для курьера (домофон, подъезд и т.д.)', null=True, verbose_name='Инструкции для доставки')),
-                ('confirm_address_with_recipient', models.BooleanField(default=False, help_text='Курьер должен уточнить адрес у получателя перед доставкой', verbose_name='Уточнить адрес у получателя')),
-                ('created_at', models.DateTimeField(auto_now_add=True, verbose_name='Дата создания')),
-                ('updated_at', models.DateTimeField(auto_now=True, verbose_name='Дата обновления')),
-            ],
-            options={
-                'verbose_name': 'Адрес доставки',
-                'verbose_name_plural': 'Адреса доставки',
-                'ordering': ['-created_at'],
-                'indexes': [models.Index(fields=['district'], name='orders_addr_distric_fd94e9_idx')],
-            },
-        ),
-        migrations.AlterField(
-            model_name='historicalorder',
-            name='delivery_address',
-            field=models.ForeignKey(blank=True, db_constraint=False, help_text='Обязательно для курьерской доставки', null=True, on_delete=django.db.models.deletion.DO_NOTHING, related_name='+', to='orders.address', verbose_name='Адрес доставки'),
-        ),
-        migrations.AlterField(
-            model_name='order',
-            name='delivery_address',
-            field=models.OneToOneField(blank=True, help_text='Обязательно для курьерской доставки', null=True, on_delete=django.db.models.deletion.CASCADE, related_name='order', to='orders.address', verbose_name='Адрес доставки'),
-        ),
-    ]
--- a/myproject/orders/migrations/0004_remove_address_orders_addr_distric_fd94e9_idx_and_more.py
+++ b/myproject/orders/migrations/0004_remove_address_orders_addr_distric_fd94e9_idx_and_more.py
@@ -1,45 +0,0 @@
-# Generated by Django 5.0.10 on 2025-11-10 23:35
-
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
-    dependencies = [
-        ('orders', '0003_remove_address_model'),
-    ]
-
-    operations = [
-        migrations.RemoveIndex(
-            model_name='address',
-            name='orders_addr_distric_fd94e9_idx',
-        ),
-        migrations.RemoveField(
-            model_name='address',
-            name='district',
-        ),
-        migrations.AddField(
-            model_name='address',
-            name='entrance',
-            field=models.CharField(blank=True, help_text='Номер подъезда/входа', max_length=20, null=True, verbose_name='Подъезд'),
-        ),
-        migrations.AddField(
-            model_name='address',
-            name='floor',
-            field=models.CharField(blank=True, max_length=20, null=True, verbose_name='Этаж'),
-        ),
-        migrations.AddField(
-            model_name='address',
-            name='intercom_code',
-            field=models.CharField(blank=True, help_text='Код домофона для входа в здание', max_length=100, null=True, verbose_name='Код домофона'),
-        ),
-        migrations.AlterField(
-            model_name='address',
-            name='delivery_instructions',
-            field=models.TextField(blank=True, help_text='Дополнительные инструкции для курьера', null=True, verbose_name='Инструкции для доставки'),
-        ),
-        migrations.AddIndex(
-            model_name='address',
-            index=models.Index(fields=['created_at'], name='orders_addr_created_98ad97_idx'),
-        ),
-    ]
--- a/myproject/orders/migrations/0005_add_custom_delivery_cost_flag.py
+++ b/myproject/orders/migrations/0005_add_custom_delivery_cost_flag.py
@@ -1,46 +0,0 @@
-# Generated by Django 5.0.10 on 2025-11-11 09:52
-
-from django.conf import settings
-from django.db import migrations, models
-
-
-class Migration(migrations.Migration):
-
-    dependencies = [
-        ('customers', '0002_remove_address_model'),
-        ('orders', '0004_remove_address_orders_addr_distric_fd94e9_idx_and_more'),
-        ('shops', '0001_initial'),
-        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
-    ]
-
-    operations = [
-        migrations.AddField(
-            model_name='historicalorder',
-            name='is_custom_delivery_cost',
-            field=models.BooleanField(default=False, help_text='True если стоимость доставки была изменена вручную', verbose_name='Стоимость доставки установлена вручную'),
-        ),
-        migrations.AddField(
-            model_name='order',
-            name='is_custom_delivery_cost',
-            field=models.BooleanField(default=False, help_text='True если стоимость доставки была изменена вручную', verbose_name='Стоимость доставки установлена вручную'),
-        ),
-        migrations.AlterField(
-            model_name='address',
-            name='building_number',
-            field=models.CharField(blank=True, max_length=20, null=True, verbose_name='Номер здания'),
-        ),
-        migrations.AlterField(
-            model_name='address',
-            name='recipient_name',
-            field=models.CharField(blank=True, help_text='Имя человека, которому будет доставлен заказ', max_length=200, null=True, verbose_name='Имя получателя'),
-        ),
-        migrations.AlterField(
-            model_name='address',
-            name='street',
-            field=models.CharField(blank=True, max_length=255, null=True, verbose_name='Улица'),
-        ),
-        migrations.AddIndex(
-            model_name='order',
-            index=models.Index(fields=['is_custom_delivery_cost'], name='orders_orde_is_cust_108e98_idx'),
-        ),
-    ]