feat(achievement): 添加用户侧成就 API
新增 achievements 列表、summary、pending 三个用户侧端点,隐藏未解锁成就 在序列化层打码(name/description/icon 替换为占位符,不下发 progress)。
This commit is contained in:
80
achievement/serializers.py
Normal file
80
achievement/serializers.py
Normal file
@@ -0,0 +1,80 @@
|
||||
from django.core.cache import cache
|
||||
from rest_framework import serializers
|
||||
|
||||
from account.models import User
|
||||
from achievement.models import Achievement, UserAchievement
|
||||
|
||||
|
||||
def get_active_user_count():
|
||||
"""获得率的分母:未禁用用户总数,缓存 1 小时。
|
||||
|
||||
不用"有过提交的用户数"这类动态口径:分母波动会让同一个成就的获得率
|
||||
忽高忽低,学生会当成 bug。
|
||||
"""
|
||||
count = cache.get("achievement_active_user_count")
|
||||
if count is None:
|
||||
count = User.objects.filter(is_disabled=False).count()
|
||||
cache.set("achievement_active_user_count", count, 3600)
|
||||
return count
|
||||
|
||||
|
||||
class AchievementSerializer(serializers.ModelSerializer):
|
||||
unlocked = serializers.BooleanField(read_only=True)
|
||||
unlock_time = serializers.DateTimeField(read_only=True, allow_null=True)
|
||||
backfilled = serializers.BooleanField(read_only=True)
|
||||
progress = serializers.IntegerField(read_only=True, allow_null=True)
|
||||
unlock_rate = serializers.SerializerMethodField()
|
||||
name = serializers.SerializerMethodField()
|
||||
description = serializers.SerializerMethodField()
|
||||
icon = serializers.SerializerMethodField()
|
||||
|
||||
class Meta:
|
||||
model = Achievement
|
||||
fields = (
|
||||
"id",
|
||||
"name",
|
||||
"description",
|
||||
"icon",
|
||||
"rarity",
|
||||
"hidden",
|
||||
"metric",
|
||||
"operator",
|
||||
"threshold",
|
||||
"unlocked",
|
||||
"unlock_time",
|
||||
"backfilled",
|
||||
"progress",
|
||||
"unlock_rate",
|
||||
)
|
||||
|
||||
def _masked(self, obj):
|
||||
return obj.hidden and not getattr(obj, "unlocked", False)
|
||||
|
||||
def get_name(self, obj):
|
||||
return "???" if self._masked(obj) else obj.name
|
||||
|
||||
def get_description(self, obj):
|
||||
return "达成条件保密" if self._masked(obj) else obj.description
|
||||
|
||||
def get_icon(self, obj):
|
||||
return "❓" if self._masked(obj) else obj.icon
|
||||
|
||||
def get_unlock_rate(self, obj):
|
||||
total = get_active_user_count()
|
||||
if not total:
|
||||
return 0.0
|
||||
return round(obj.unlock_count / total * 100, 1)
|
||||
|
||||
|
||||
class PendingAchievementSerializer(serializers.ModelSerializer):
|
||||
"""待弹窗的解锁记录,无需打码(已解锁)。"""
|
||||
|
||||
id = serializers.IntegerField(source="achievement_id", read_only=True)
|
||||
name = serializers.CharField(source="achievement.name", read_only=True)
|
||||
description = serializers.CharField(source="achievement.description", read_only=True)
|
||||
icon = serializers.CharField(source="achievement.icon", read_only=True)
|
||||
rarity = serializers.CharField(source="achievement.rarity", read_only=True)
|
||||
|
||||
class Meta:
|
||||
model = UserAchievement
|
||||
fields = ("id", "name", "description", "icon", "rarity")
|
||||
Reference in New Issue
Block a user