Files
MathApp/progress/serializers.py
Zareian 96f0204fcf refill hearts like Duolingo: one every 5 hours, all of them after 24
Each heart used to take 24 hours, so a student who lost all five waited up to
five days. Now one heart returns every 5 hours, and 24 hours after the first
heart was lost they all come back at once (the owner's call). /api/user/hearts
reports both times (nextRefillAt, fullRefillAt); an existing timer longer than
5 hours is shortened the first time it is read.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-24 06:58:39 +03:30

68 lines
2.3 KiB
Python

from rest_framework import serializers
class StreakSummarySerializer(serializers.Serializer):
current = serializers.IntegerField()
longest = serializers.IntegerField()
class UserSummaryResponseSerializer(serializers.Serializer):
userId = serializers.CharField()
name = serializers.CharField()
avatar = serializers.CharField()
gradeId = serializers.IntegerField(allow_null=True)
xp = serializers.IntegerField()
coins = serializers.IntegerField()
streak = StreakSummarySerializer()
subscription = serializers.CharField(allow_null=True)
class StreakCalendarResponseSerializer(serializers.Serializer):
currentStreak = serializers.IntegerField()
longestStreak = serializers.IntegerField()
activeDays = serializers.ListField(child=serializers.DateField())
class LeaderboardEntrySerializer(serializers.Serializer):
rank = serializers.IntegerField()
userId = serializers.CharField()
name = serializers.CharField()
xpInPeriod = serializers.IntegerField()
class LeaderboardResponseSerializer(serializers.Serializer):
period = serializers.ChoiceField(choices=['weekly', 'all_time'])
entries = LeaderboardEntrySerializer(many=True)
class UserHeartsResponseSerializer(serializers.Serializer):
currentHearts = serializers.IntegerField()
maxHearts = serializers.IntegerField()
nextRefillAt = serializers.DateTimeField(allow_null=True)
# همه‌ی قلب‌ها کی یک‌جا پر می‌شوند (۲۴ ساعت بعد از اولین قلبِ ازدست‌رفته).
fullRefillAt = serializers.DateTimeField(allow_null=True)
isUnlimited = serializers.BooleanField()
class CharacterSerializer(serializers.Serializer):
characterId = serializers.CharField()
slug = serializers.CharField()
name = serializers.CharField()
icon = serializers.CharField()
unlockXp = serializers.IntegerField()
unlocked = serializers.BooleanField()
selected = serializers.BooleanField()
class CharacterListResponseSerializer(serializers.Serializer):
characters = CharacterSerializer(many=True)
class SelectCharacterRequestSerializer(serializers.Serializer):
characterId = serializers.CharField()
class SelectCharacterResponseSerializer(serializers.Serializer):
characterId = serializers.CharField()
selected = serializers.BooleanField()