Django/rank/reward_models.py

"""排行榜奖励 — 按俱乐部分奖，与集团展示榜分离。"""
from django.db import models
from gvsdsdk.model_base import QModel


class RankRewardScheme(QModel):
    """俱乐部 + 身份 + 周期 奖励方案"""

    PERIOD_DAY = 'day'
    PERIOD_WEEK = 'week'
    PERIOD_MONTH = 'month'
    PERIOD_CHOICES = [
        (PERIOD_DAY, '日榜(昨日)'),
        (PERIOD_WEEK, '周榜(上周)'),
        (PERIOD_MONTH, '月榜(上月)'),
    ]

    club_id = models.CharField(max_length=16, db_index=True, verbose_name='俱乐部ID')
    shenfen = models.CharField(max_length=16, db_index=True, verbose_name='身份')
    period_type = models.CharField(max_length=16, choices=PERIOD_CHOICES, verbose_name='周期类型')
    sort_field = models.CharField(max_length=32, verbose_name='排序指标键')
    title = models.CharField(max_length=128, blank=True, default='', verbose_name='展示标题')
    description = models.TextField(blank=True, default='', verbose_name='规则说明')
    enabled = models.BooleanField(default=False, verbose_name='启用')
    claim_days = models.PositiveSmallIntegerField(default=30, verbose_name='领取有效天数')
    min_metric = models.DecimalField(
        max_digits=12, decimal_places=2, default=0, verbose_name='最低指标门槛',
    )
    CreateTime = models.DateTimeField(auto_now_add=True, verbose_name='创建时间')
    UpdateTime = models.DateTimeField(auto_now=True, verbose_name='更新时间')

    class Meta:
        db_table = 'rank_reward_scheme'
        verbose_name = '排行榜奖励方案'
        verbose_name_plural = verbose_name
        unique_together = [['club_id', 'shenfen', 'period_type']]

    def __str__(self):
        return f'{self.club_id}:{self.shenfen}:{self.period_type}'


class RankRewardTier(QModel):
    scheme = models.ForeignKey(
        RankRewardScheme, on_delete=models.CASCADE, related_name='tiers', verbose_name='方案',
    )
    rank_from = models.PositiveSmallIntegerField(verbose_name='名次起')
    rank_to = models.PositiveSmallIntegerField(verbose_name='名次止')
    reward_amount = models.DecimalField(max_digits=10, decimal_places=2, verbose_name='奖金(元)')
    label = models.CharField(max_length=32, blank=True, default='', verbose_name='档位标签')

    class Meta:
        db_table = 'rank_reward_tier'
        verbose_name = '排行榜奖励档位'
        verbose_name_plural = verbose_name
        ordering = ['rank_from']

    def __str__(self):
        return f'{self.rank_from}-{self.rank_to} ¥{self.reward_amount}'


class RankRewardSettlement(QModel):
    """结算批次 — 同一 club+方案+period_key 仅一条"""

    scheme = models.ForeignKey(RankRewardScheme, on_delete=models.CASCADE, verbose_name='方案')
    club_id = models.CharField(max_length=16, db_index=True, verbose_name='俱乐部ID')
    period_key = models.CharField(max_length=32, db_index=True, verbose_name='周期键')
    period_start = models.DateField(verbose_name='统计起始')
    period_end = models.DateField(verbose_name='统计截止')
    riqi_label = models.CharField(max_length=16, verbose_name='前端周期文案')
    sort_field = models.CharField(max_length=32, verbose_name='结算时排序字段快照')
    settled_at = models.DateTimeField(auto_now_add=True, verbose_name='结算时间')
    claim_count = models.PositiveIntegerField(default=0, verbose_name='生成待领取数')

    class Meta:
        db_table = 'rank_reward_settlement'
        verbose_name = '排行榜奖励结算'
        verbose_name_plural = verbose_name
        unique_together = [['club_id', 'scheme', 'period_key']]


class RankRewardClaim(QModel):
    STATUS_PENDING = 0
    STATUS_CLAIMED = 1
    STATUS_EXPIRED = 2
    STATUS_CANCELLED = 3
    STATUS_CHOICES = [
        (STATUS_PENDING, '待领取'),
        (STATUS_CLAIMED, '已领取'),
        (STATUS_EXPIRED, '已过期'),
        (STATUS_CANCELLED, '已取消'),
    ]

    settlement = models.ForeignKey(
        RankRewardSettlement, on_delete=models.CASCADE, related_name='claims', verbose_name='结算批次',
    )
    club_id = models.CharField(max_length=16, db_index=True, verbose_name='俱乐部ID')
    yonghuid = models.CharField(max_length=7, db_index=True, verbose_name='用户ID')
    shenfen = models.CharField(max_length=16, verbose_name='身份')
    mingci = models.PositiveSmallIntegerField(verbose_name='名次')
    metric_value = models.DecimalField(max_digits=12, decimal_places=2, default=0, verbose_name='指标快照')
    reward_amount = models.DecimalField(max_digits=10, decimal_places=2, verbose_name='奖金')
    status = models.PositiveSmallIntegerField(default=STATUS_PENDING, choices=STATUS_CHOICES, db_index=True)
    expire_at = models.DateTimeField(verbose_name='领取截止')
    claimed_at = models.DateTimeField(null=True, blank=True, verbose_name='领取时间')
    balance_field = models.CharField(max_length=32, verbose_name='入账字段')
    idempotent_key = models.CharField(max_length=96, unique=True, verbose_name='幂等键')
    CreateTime = models.DateTimeField(auto_now_add=True, verbose_name='创建时间')
    UpdateTime = models.DateTimeField(auto_now=True, verbose_name='更新时间')

    class Meta:
        db_table = 'rank_reward_claim'
        verbose_name = '排行榜奖励领取'
        verbose_name_plural = verbose_name
        indexes = [
            models.Index(fields=['yonghuid', 'status']),
            models.Index(fields=['club_id', 'status']),
        ]