MathApp/payment/models.py

from django.db import models


class Order(models.Model):
    """
    تنها اپی که واقعاً پول جابه‌جا می‌کنه. عمداً از Subscription جدا شده
    چون منطق و ریسکش فرق داره (درگاه، retry، idempotency).
    """
    # «لغوشده» و «بازپرداخت‌شده» فقط از پنلِ ادمین (actionهای OrderAdmin) گذاشته می‌شوند، از ۲۰۲۶-۱۰-۰۲.
    STATUS_CHOICES = [
        ('pending', 'در انتظار'), ('paid', 'پرداخت‌شده'), ('failed', 'ناموفق'),
        ('canceled', 'لغوشده'), ('refunded', 'بازپرداخت‌شده'),
    ]

    # 'gateway' و 'bazaar' منطق و صحت‌سنجیِ کاملاً متفاوتی دارن (webhook در
    # برابرِ verifyِ سرور-به-سرور با access_token)؛ برای همین provider جداست
    # از Transaction.gateway (که فقط برای گزارش‌گیریِ درگاهِ واقعیه).
    PROVIDER_CHOICES = [('gateway', 'درگاه پرداخت'), ('bazaar', 'پرداخت درون‌برنامه‌ای بازار')]

    user_id = models.IntegerField(db_index=True)  # ارجاع سبک به accounts.User
    subscription_id = models.IntegerField(null=True, blank=True)  # ارجاع سبک به subscription.Subscription
    # پلنی که *این* سفارش برایش پرداخت می‌شود. پیش‌تر پلن فقط روی Subscription
    # بود و با شروعِ یک خریدِ دیگر عوض می‌شد: پرداختِ سفارشِ ماهانه بعد از
    # شروعِ خریدِ سالانه، اشتراکِ سالانه می‌داد (بازتولید شد، ۲۰۲۶-۰۹-۲۵).
    plan_id = models.IntegerField(null=True, blank=True)  # ارجاع سبک به subscription.Plan
    # مبلغی که باید پرداخت شود؛ کدِ تخفیف همین را کم می‌کند (discount/views.py).
    amount = models.PositiveIntegerField()
    # عکسِ لحظه‌ی خرید برای فاکتور: قیمتِ پایه پیش از تخفیف و نامِ پلن. بدونِ این،
    # فاکتورِ ماهِ پیش با عوض شدنِ قیمت یا نامِ پلن در ادمین عوض می‌شد. سفارش‌های
    # پیش از ۲۰۲۶-۱۰-۰۱ این دو را ندارند (null / خالی).
    list_price = models.PositiveIntegerField(null=True, blank=True)
    plan_title = models.CharField(max_length=50, blank=True)
    # مدتِ اشتراکی که این سفارش فروخته، در لحظه‌ی ساخت (create_order). پرداخت و بازپرداخت همین را می‌دهند و
    # پس می‌گیرند، نه مدتِ فعلیِ پلن. null یعنی سفارشِ بی‌پلن یا ساخته‌شده پیش از این ستون.
    duration_days = models.PositiveIntegerField(null=True, blank=True)
    currency = models.CharField(max_length=10, default='IRT')
    status = models.CharField(max_length=10, choices=STATUS_CHOICES, default='pending')
    provider = models.CharField(max_length=10, choices=PROVIDER_CHOICES, default='gateway')
    # فقط وقتی provider == 'bazaar' پر می‌شن: SKU محصول درون‌برنامه‌ای تعریف‌شده
    # در پنل بازار، و purchase token‌ای که کلاینت اندروید بعد از خرید از SDK
    # بازار می‌گیره و برای verify به بک‌اند می‌فرسته.
    bazaar_product_sku = models.CharField(max_length=100, blank=True)
    bazaar_purchase_token = models.CharField(max_length=300, blank=True)
    # مبلغی (ریال) که در JWTِ «تخفیف پویا» برای همین سفارش امضا شد؛ بعد از آن کدِ تخفیف روی سفارش
    # نمی‌نشیند (همان قاعده‌ی gateway_authority). null یعنی بازار قیمتِ پیشخان را گرفته/می‌گیرد.
    bazaar_price_rial = models.PositiveIntegerField(null=True, blank=True)
    # فقط اشتراکِ بازار: پایانِ دوره‌ای که همین سفارش پولش را داده، از پاسخِ بازار. تمدیدِ خودکار با
    # جلو رفتنِ این عدد در بازار دیده می‌شود (payment.services.sync_bazaar_renewals).
    bazaar_valid_until = models.DateTimeField(null=True, blank=True)
    # فقط وقتی provider == 'gateway' (زرین‌پال) پر می‌شه: Authorityِ برگشتی از
    # PaymentRequest، وقتی کاربر واقعاً لینکِ پرداخت رو باز کنه (نه موقعِ
    # ساختِ سفارش؛ نگاه کنید به PaymentRedirectView). همون چیزیه که زرین‌پال
    # موقعِ callback در query string (Authority=...) برمی‌گردونه، پس برای
    # پیداکردنِ Order از روی callback لازمه.
    gateway_authority = models.CharField(max_length=64, blank=True, db_index=True)
    idempotency_key = models.CharField(max_length=100, unique=True)
    created_at = models.DateTimeField(auto_now_add=True)

    class Meta:
        ordering = ['-created_at']

    def __str__(self):
        return f"order-{self.pk}-user{self.user_id}"


class Transaction(models.Model):
    order = models.ForeignKey(Order, on_delete=models.CASCADE, related_name='transactions')
    gateway = models.CharField(max_length=30, default='zarinpal')
    # ۳۰۰ مثلِ Order.bazaar_purchase_token: توکنِ خریدِ بازار همین‌جا می‌نشیند.
    gateway_ref_id = models.CharField(max_length=300, blank=True)
    status = models.CharField(max_length=30)
    paid_at = models.DateTimeField(null=True, blank=True)
    created_at = models.DateTimeField(auto_now_add=True)

    class Meta:
        ordering = ['created_at']
        constraints = [
            # یکتاییِ سراسریِ (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=''),
                name='uniq_transaction_gateway_ref_global',
            ),
        ]

    def __str__(self):
        return f"txn-{self.pk}-order{self.order_id}"


class BazaarCredential(models.Model):
    """
    refresh tokenِ API بازار، که با اولین «اجازه دادن» در پنل بازار ساخته
    می‌شود. در دیتابیس است نه `.env` تا گرفتنش کسی را مجبور به SSH نکند:
    بازار کاربر را با `?code=` به همان `/api/payment/bazaar/verify`
    برمی‌گرداند (Redirect URIای که در پنل ثبت شده) و ویو خودش code را عوض
    می‌کند. یک ردیف بیشتر ندارد (pk=1).

    `pending_state`/`pending_since` پنجره‌ی اتصال است: GETِ بی‌پنجره هیچ
    کاری نمی‌کند، تا کسی نتواند با codeِ حسابِ بازارِ خودش توکنِ ما را
    عوض کند. `BAZAAR_REFRESH_TOKEN` در `.env`، اگر باشد، بر این ردیف مقدم است.
    """

    refresh_token = models.TextField(blank=True)
    authorized_at = models.DateTimeField(null=True, blank=True)
    pending_state = models.CharField(max_length=64, blank=True)
    pending_since = models.DateTimeField(null=True, blank=True)

    class Meta:
        verbose_name = 'اتصال به API بازار'
        verbose_name_plural = 'اتصال به API بازار'

    def __str__(self):
        return 'متصل' if self.refresh_token else 'متصل نیست'


class PaymentEvent(models.Model):
    """
    دفترِ رویدادهای مسیرِ خرید (ساخت سفارش، رفتن به درگاه، بازگشت از درگاه، نتیجه‌ی verify،
    لغو/بازپرداخت). فقط افزودنی است و هیچ منطقی بر آن تکیه ندارد.

    چرا جدول و نه فایلِ لاگ: دیتابیس لحظه‌ای به سرورِ بکاپِ ۲۴۷ می‌رود (WAL)، پس این ردیف‌ها
    بی‌هیچ کانال و دسترسیِ تازه همان‌جا هم می‌رسند؛ فایلِ خوانا از روی همان نسخه ساخته می‌شود
    (`ops/pgbackup/export-payment-events.sh`). `StatusChangeLog` فقط تغییرِ وضعیت را نگه می‌دارد؛
    «کاربر رفت به درگاه ولی برنگشت» در آن نیست و این‌جا هست.
    در `detail` هیچ توکنِ خرید یا کلیدی نمی‌رود؛ authority فقط ۶۴ نویسه‌ی اول.
    """
    order_id = models.IntegerField(null=True, blank=True, db_index=True)  # ارجاع سبک به Order؛ بی‌سفارش هم می‌شود
    user_id = models.IntegerField(null=True, blank=True, db_index=True)
    provider = models.CharField(max_length=20, blank=True)
    event = models.CharField(max_length=40, db_index=True)
    detail = models.JSONField(default=dict, blank=True)
    created_at = models.DateTimeField(auto_now_add=True, db_index=True)

    class Meta:
        ordering = ['-created_at']

    def __str__(self):
        return f'order {self.order_id}: {self.event}'