"""billing 域对外响应模型（FR-BILL-03 任务奖励）.

``apps/api/schemas.py`` 是全局共享契约文件，本轮并行开发禁改；billing 新增
接口的响应模型放本包，由路由层装配进 ``ok(...)`` 信封。字段口径与
NFR-MAINT-01「契约先行」一致：客户端类型从 OpenAPI 生成。
"""

from __future__ import annotations

from pydantic import BaseModel, Field


class TaskBonusClaimResponse(BaseModel):
    """``POST /quota/tasks/{task_key}/claim`` 的 data 载荷（FR-BILL-03）."""

    task_key: str = Field(max_length=64, description="任务标识，如 sign_in")
    quota_key: str = Field(max_length=64, description="奖励落入的额度种类")
    amount: int = Field(description="本次发放数额（当前为占位值，正式数值由产品定稿后改配置）")
    bonus_granted: int = Field(description="本周期累计已获得的任务奖励")
    remaining: int = Field(description="发放后该额度的剩余次数")