35 lines
1018 B
Python
35 lines
1018 B
Python
"""资金账户相关 DTO。
|
||
|
||
金额统一序列化为两位小数字符串（如 "48000.00"），避免 JSON number 的浮点精度隐患。
|
||
"""
|
||
from datetime import datetime
|
||
from decimal import Decimal
|
||
from typing import Literal
|
||
|
||
from pydantic import BaseModel, Field, field_serializer
|
||
|
||
|
||
class BalanceResp(BaseModel):
|
||
"""用户余额响应体。available_balance = balance - frozen_amount，由 service 派生。"""
|
||
|
||
customer_id: int
|
||
balance: Decimal
|
||
available_balance: Decimal
|
||
frozen_amount: Decimal
|
||
currency: str
|
||
status: str
|
||
update_time: datetime | None = None
|
||
|
||
@field_serializer("balance", "available_balance", "frozen_amount")
|
||
def _fmt_money(self, value: Decimal) -> str:
|
||
return f"{value:.2f}"
|
||
|
||
|
||
class AdjustReq(BaseModel):
|
||
"""加减余额入参。amount 为正数（元），direction 决定加/减。"""
|
||
|
||
direction: Literal["add", "sub"] = Field(
|
||
..., description="add=入账(充值)，sub=出账(提现)"
|
||
)
|
||
amount: Decimal = Field(gt=0)
|