79 lines
4.2 KiB
Python
79 lines
4.2 KiB
Python
from django.db import models
|
|
|
|
|
|
class Conversation(models.Model):
|
|
user_id = models.IntegerField(db_index=True) # ارجاع سبک به accounts.User
|
|
lesson_id = models.IntegerField(null=True, blank=True) # ارجاع سبک به content.Lesson
|
|
chapter_id = models.IntegerField(null=True, blank=True) # شناسه‌ی فصل RAG (خارج از content/)
|
|
grade_id = models.IntegerField(null=True, blank=True) # ارجاع سبک به content.Grade
|
|
created_at = models.DateTimeField(auto_now_add=True)
|
|
|
|
def __str__(self):
|
|
return f"conv-{self.pk}-user{self.user_id}"
|
|
|
|
|
|
class Message(models.Model):
|
|
ROLE_CHOICES = [('user', 'کاربر'), ('assistant', 'دستیار')]
|
|
|
|
conversation = models.ForeignKey(Conversation, on_delete=models.CASCADE, related_name='messages')
|
|
role = models.CharField(max_length=10, choices=ROLE_CHOICES)
|
|
text = models.TextField()
|
|
question_id = models.IntegerField(null=True, blank=True) # ارجاع سبک به content.Question
|
|
created_at = models.DateTimeField(auto_now_add=True)
|
|
|
|
class Meta:
|
|
ordering = ['created_at']
|
|
|
|
def __str__(self):
|
|
return f"msg-{self.pk}-{self.role}"
|
|
|
|
|
|
class MessageFeedback(models.Model):
|
|
message = models.OneToOneField(Message, on_delete=models.CASCADE, related_name='feedback')
|
|
is_helpful = models.BooleanField()
|
|
|
|
def __str__(self):
|
|
return f"feedback-msg{self.message_id}"
|
|
|
|
|
|
class AskIdempotency(models.Model):
|
|
"""
|
|
⚛️🔒 اصلاح idempotency برای POST /api/ai/ask (همون الگویی که
|
|
UserAnswer.idempotency_key/UserLessonCompletion.idempotency_key در
|
|
content و Order.idempotency_key در payment دارن): چون نتیجه‌ی هر
|
|
«سوال» شاملِ دو ردیفِ Message (کاربر + دستیار) و مصرفِ یک اسلاتِ
|
|
کوتای روزانه‌ست (نه یک ردیفِ تکی مثلِ UserAnswer)، این رکورد پل بین
|
|
(user, Idempotency-Key) و نتیجه‌ی از قبل ساخته‌شده رو نگه می‌داره تا
|
|
رتری/دابل‌کلیکِ همون کلید، دوباره پیام یا کوتای تکراری نسازه و به‌جاش
|
|
نتیجه‌ی همون درخواستِ قبلی برگردونده بشه. UniqueConstraint سطح DB روی
|
|
(user_id, idempotency_key) هم دفاع در عمق در برابر دو submit هم‌زمانِ
|
|
دقیقاً با همون کلیده (مشابه uniq_user_answer_idempotency_key).
|
|
"""
|
|
user_id = models.IntegerField(db_index=True)
|
|
idempotency_key = models.CharField(max_length=100)
|
|
conversation = models.ForeignKey(Conversation, on_delete=models.CASCADE, related_name='+')
|
|
user_message = models.ForeignKey(Message, on_delete=models.CASCADE, related_name='+')
|
|
assistant_message = models.ForeignKey(Message, on_delete=models.CASCADE, related_name='+')
|
|
# ⚠️ اصلاح: قبلاً suggestedFollowUps هیچ‌جا ذخیره نمی‌شد و در مسیرِ
|
|
# replay (idempotent retry) دوباره با فراخوانیِ generate_tutor_answer
|
|
# بازسازی می‌شد. این فقط تا وقتی generate_tutor_answer یک stub خالی از
|
|
# اثر جانبیه بی‌ضرره؛ وقتی به یک AI provider واقعی وصل بشه، هر replay
|
|
# یک درخواستِ واقعیِ دیگه به provider می‌زنه (هزینه/تأخیرِ تکراری، و
|
|
# پیشنهادهای follow-up متفاوت در هر retry — دقیقاً برخلافِ هدفِ
|
|
# idempotency). حالا خروجیِ follow-up های همون درخواستِ اولِ موفق،
|
|
# همینجا ذخیره می‌شه تا replay بتونه بدونِ هیچ فراخوانیِ دیگری به
|
|
# generate_tutor_answer، همون مقدارِ اصلی رو برگردونه.
|
|
suggested_follow_ups = models.JSONField(default=list)
|
|
created_at = models.DateTimeField(auto_now_add=True)
|
|
|
|
class Meta:
|
|
constraints = [
|
|
models.UniqueConstraint(
|
|
fields=['user_id', 'idempotency_key'],
|
|
name='uniq_ask_idempotency_key',
|
|
),
|
|
]
|
|
|
|
def __str__(self):
|
|
return f"ask-idem-user{self.user_id}-{self.idempotency_key}"
|