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 یعنی سفارشِ بی‌پلن یا ساخته‌شده پیش از این ستون. question_credits = models.PositiveIntegerField(null=True, blank=True) hearts_days = models.PositiveIntegerField(null=True, blank=True) 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) # فقط وقتی 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 'متصل نیست'