cleanup: trim bloated multi-line comments across the project

payment/models.py

@@ -8,12 +8,9 @@ class Order(models.Model):
     """
     STATUS_CHOICES = [('pending', 'در انتظار'), ('paid', 'پرداخت‌شده'), ('failed', 'ناموفق')]
 
-    # دو مدل پرداخت طبق درخواست سینیور: 'gateway' (زرین‌پال/زیبال و مشابه) و
-    # 'bazaar' (پرداخت درون‌برنامه‌ای اپلیکیشن بازار). این دو منطق پرداخت و
-    # صحت‌سنجی کاملاً متفاوتی دارن (webhook درگاه در برابر verify سرور-به-
-    # سرور با access_token بازار)؛ برای همین provider جداست، نه فقط یک مقدار
-    # دیگه در Transaction.gateway (که فقط برای گزارش‌گیریِ درگاه واقعی زرین‌پال/
-    # زیبال باقی می‌مونه).
+    # 'gateway' و 'bazaar' منطق و صحت‌سنجیِ کاملاً متفاوتی دارن (webhook در
+    # برابرِ verifyِ سرور-به-سرور با access_token)؛ برای همین provider جداست
+    # از Transaction.gateway (که فقط برای گزارش‌گیریِ درگاهِ واقعیه).
     PROVIDER_CHOICES = [('gateway', 'درگاه پرداخت'), ('bazaar', 'پرداخت درون‌برنامه‌ای بازار')]
 
     user_id = models.IntegerField(db_index=True)  # ارجاع سبک به accounts.User
@@ -48,18 +45,11 @@ class Transaction(models.Model):
     class Meta:
         ordering = ['created_at']
         constraints = [
-            # 🔒 یکتاییِ سراسریِ (gateway, gateway_ref_id) برای refهای
-            # غیرخالی: این قید سطح DB تضمین می‌کنه یک gateway_ref_id مشخص
-            # (مثلاً Authority زرین‌پال یا purchaseToken بازار) در کل جدول
-            # Transaction فقط می‌تونه متعلق به یک Order باشه — هم جلوی
-            # duplicate/idempotency برای همون Order رو می‌گیره (چون در کل
-            # جدول حداکثر یک ردیف با این (gateway, ref) می‌تونه وجود داشته
-            # باشه) و هم جلوی reuse/replay همون ref برای یک Order دیگه رو
-            # (نگاه کنید به apply_order_payment_result). این قید، قیدِ
-            # قدیمی‌ترِ (order, gateway_ref_id, status) رو هم در برمی‌گیره
-            # (چون سخت‌گیرانه‌تره)، برای همین دیگه لازم نیست جدا نگه داشته
-            # بشه. gateway_ref_id__gt='' یعنی رفرنس‌های خالی (که provider
-            # واقعی هنوز رفرنسی برنگردونده) مشمول این قید نمی‌شن.
+            # یکتاییِ سراسریِ (gateway, gateway_ref_id) برای refهای غیرخالی:
+            # یک ref مشخص (مثلاً Authorityِ زرین‌پال) فقط می‌تونه متعلقِ یک
+            # Order باشه — هم جلوی duplicate رو می‌گیره هم جلوی reuse/replay
+            # برای Orderِ دیگه (نگاه کنید به apply_order_payment_result).
+            # gateway_ref_id__gt='' یعنی refِ خالی مشمول نیست.
             models.UniqueConstraint(
                 fields=['gateway', 'gateway_ref_id'],
                 condition=models.Q(gateway_ref_id__gt=''),