adding

2026-08-24 15:54:08 +03:30
commit 236002a87c
133 changed files with 5946 additions and 0 deletions
@@ -0,0 +1,52 @@
+from rest_framework import serializers
+
+from apps.orders.models import Order, OrderStage, OrderStageLog
+
+
+class OrderStageSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = OrderStage
+        fields = [
+            "id",
+            "label",
+            "template",
+            "sort_order",
+            "requires_extra_input",
+            "extra_input_label",
+            "updated_at",
+        ]
+        read_only_fields = ["updated_at"]
+
+    def validate_template(self, template):
+        if template is None:
+            return template
+        request = self.context["request"]
+        if template.user_id != request.user.id:
+            raise serializers.ValidationError("این قالب متعلق به شما نیست.")
+        return template
+
+
+class OrderStageLogSerializer(serializers.ModelSerializer):
+    class Meta:
+        model = OrderStageLog
+        fields = ["id", "stage", "stage_label", "message_body", "extra_input_value", "created_at"]
+        read_only_fields = fields
+
+
+class OrderSerializer(serializers.ModelSerializer):
+    current_stage_label = serializers.CharField(source="current_stage.label", read_only=True, default="")
+
+    class Meta:
+        model = Order
+        fields = [
+            "id",
+            "customer_name",
+            "customer_phone",
+            "tracking_code",
+            "current_stage",
+            "current_stage_label",
+            "is_completed",
+            "created_at",
+            "updated_at",
+        ]
+        read_only_fields = ["current_stage", "is_completed", "created_at", "updated_at"]
@@ -0,0 +1,83 @@
+import re
+import uuid
+
+from django.db import transaction
+
+from apps.account.models import User
+from apps.banker.models import Contact
+from apps.messaging.api.services import BulkMessageService
+from apps.messaging.models import Channel
+from apps.orders.models import Order, OrderStage, OrderStageLog
+
+_FIELD_PATTERN = re.compile(r"\{(.*?)\}")
+
+
+class OrderStageService:
+    @staticmethod
+    def _render(order: Order, stage: OrderStage, extra_input_value: str = "") -> str:
+        body = stage.template.body if stage.template else ""
+        values = {
+            "نام": order.customer_name,
+            "شماره": order.customer_phone,
+            "کد پیگیری": order.tracking_code,
+            "مرحله": stage.label,
+            "ورودی": extra_input_value,
+        }
+        return _FIELD_PATTERN.sub(lambda m: values.get(m.group(1), m.group(0)), body)
+
+    @staticmethod
+    def _upsert_contact(user: User, order: Order) -> Contact:
+        contact = Contact.objects.filter(user=user, phone=order.customer_phone).first()
+        if contact:
+            return contact
+        return Contact.objects.create(
+            id=str(uuid.uuid4()), user=user, name=order.customer_name, phone=order.customer_phone
+        )
+
+    @staticmethod
+    @transaction.atomic
+    def advance(user: User, order_id: str, extra_input_value: str = "") -> Order:
+        order = Order.objects.select_for_update().get(pk=order_id, user=user)
+        if order.is_completed:
+            raise ValueError("این سفارش قبلا به آخرین مرحله رسیده است.")
+
+        stages = list(OrderStage.objects.filter(user=user).order_by("sort_order"))
+        if not stages:
+            raise ValueError("اول باید حداقل یک مرحله برای پیگیری سفارش تعریف کنی.")
+
+        if order.current_stage_id is None:
+            next_stage = stages[0]
+        else:
+            current_index = next((i for i, s in enumerate(stages) if s.id == order.current_stage_id), None)
+            if current_index is None or current_index + 1 >= len(stages):
+                raise ValueError("این سفارش قبلا به آخرین مرحله رسیده است.")
+            next_stage = stages[current_index + 1]
+
+        extra_input_value = (extra_input_value or "").strip()
+        if next_stage.requires_extra_input and not extra_input_value:
+            label = next_stage.extra_input_label or "ورودی این مرحله"
+            raise ValueError(f"برای این مرحله باید «{label}» را وارد کنی.")
+
+        contact = OrderStageService._upsert_contact(user, order)
+        rendered = OrderStageService._render(order, next_stage, extra_input_value)
+        if rendered:
+            BulkMessageService.create_and_dispatch(
+                user=user,
+                channels=[Channel.SMS],
+                contact_ids=[contact.id],
+                body_override=rendered,
+            )
+
+        order.current_stage = next_stage
+        order.is_completed = next_stage.id == stages[-1].id
+        order.save(update_fields=["current_stage", "is_completed", "updated_at"])
+
+        OrderStageLog.objects.create(
+            id=str(uuid.uuid4()),
+            order=order,
+            stage=next_stage,
+            stage_label=next_stage.label,
+            message_body=rendered,
+            extra_input_value=extra_input_value,
+        )
+        return order
@@ -0,0 +1,79 @@
+from rest_framework import generics, status
+from rest_framework.exceptions import NotFound, ValidationError
+from rest_framework.permissions import IsAuthenticated
+from rest_framework.response import Response
+from rest_framework.views import APIView
+
+from apps.billing.permissions import HasActiveFeature
+from apps.orders.api.services import OrderStageService
+from apps.orders.models import Order, OrderStage, OrderStageLog
+
+from .serializers import OrderSerializer, OrderStageLogSerializer, OrderStageSerializer
+
+
+class _UserScopedListCreateView(generics.ListCreateAPIView):
+    permission_classes = [IsAuthenticated, HasActiveFeature]
+    feature_key = "orders"
+
+    def get_queryset(self):
+        return self.model.objects.filter(user=self.request.user)
+
+    def perform_create(self, serializer):
+        serializer.save(user=self.request.user)
+
+
+class _UserScopedDetailView(generics.RetrieveUpdateDestroyAPIView):
+    permission_classes = [IsAuthenticated, HasActiveFeature]
+    feature_key = "orders"
+
+    def get_queryset(self):
+        return self.model.objects.filter(user=self.request.user)
+
+
+class OrderStageListCreateView(_UserScopedListCreateView):
+    model = OrderStage
+    serializer_class = OrderStageSerializer
+
+
+class OrderStageDetailView(_UserScopedDetailView):
+    model = OrderStage
+    serializer_class = OrderStageSerializer
+
+
+class OrderListCreateView(_UserScopedListCreateView):
+    model = Order
+    serializer_class = OrderSerializer
+
+
+class OrderDetailView(_UserScopedDetailView):
+    model = Order
+    serializer_class = OrderSerializer
+
+
+class AdvanceOrderStageView(APIView):
+    """با هر بار زدن «مرحله‌ی بعد»، سفارش را به مرحله‌ی بعدیِ تعریف‌شده
+    می‌برد و طبق قالبِ همان مرحله برای مشتریِ همین سفارش پیامک می‌فرستد."""
+
+    permission_classes = [IsAuthenticated, HasActiveFeature]
+    feature_key = "orders"
+
+    def post(self, request, pk):
+        if not Order.objects.filter(pk=pk, user=request.user).exists():
+            raise NotFound("سفارش یافت نشد.")
+        extra_input_value = request.data.get("extra_input_value", "")
+        try:
+            order = OrderStageService.advance(request.user, pk, extra_input_value)
+        except Order.DoesNotExist:
+            raise NotFound("سفارش یافت نشد.")
+        except ValueError as exc:
+            raise ValidationError(str(exc))
+        return Response(OrderSerializer(order).data, status=status.HTTP_200_OK)
+
+
+class OrderStageLogListView(generics.ListAPIView):
+    serializer_class = OrderStageLogSerializer
+    permission_classes = [IsAuthenticated, HasActiveFeature]
+    feature_key = "orders"
+
+    def get_queryset(self):
+        return OrderStageLog.objects.filter(order_id=self.kwargs["pk"], order__user=self.request.user)