Files
MathApp/progress/serializers.py
Zareian 37a1741e0e add gamification characters (Duolingo-style mascot catalog)
New progress.Character model: an admin-managed catalog (same pattern as
subscription.Plan) of selectable mascots, each unlocked once the user's
XP crosses unlock_xp. No separate ownership table yet — unlocking is a
pure function of UserStats.xp, kept intentionally minimal since this is
the first of an incremental rollout the senior asked for.

- GET /api/characters — catalog with per-user unlocked/selected flags
- POST /api/characters/select — picks an active character, rejecting
  ones the user hasn't unlocked yet
- UserStats.selected_character_id tracks the pick
- seed_test_data now seeds 4 sample characters (owl/fox/turtle/lion)
  for local/staging testing

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-06 13:53:17 +03:30

66 lines
2.1 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)
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()