72 lines
4.4 KiB
Python
72 lines
4.4 KiB
Python
from django.db import models
|
||
|
||
|
||
class Order(models.Model):
|
||
"""
|
||
تنها اپی که واقعاً پول جابه‌جا می‌کنه. عمداً از Subscription جدا شده
|
||
چون منطق و ریسکش فرق داره (درگاه، retry، idempotency).
|
||
"""
|
||
STATUS_CHOICES = [('pending', 'در انتظار'), ('paid', 'پرداخت‌شده'), ('failed', 'ناموفق')]
|
||
|
||
# دو مدل پرداخت طبق درخواست سینیور: '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
|
||
amount = models.PositiveIntegerField()
|
||
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)
|
||
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')
|
||
gateway_ref_id = models.CharField(max_length=100, 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های
|
||
# غیرخالی: این قید سطح 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
|
||
# واقعی هنوز رفرنسی برنگردونده) مشمول این قید نمی‌شن.
|
||
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}"
|