app.YQPoint_utils module

app.YQPoint_utils.add_signin_point(user: User)

用户获得今日签到的积分，并返回用户提示信息

参数:

user (User) -- 签到的用户

返回:

本次签到获得的积分，以及应看到的提示（若为空则显示默认提示）

返回类型:

tuple[int, str]

app.YQPoint_utils.buy_exchange_item(user: User, poolitem_id: str, attributes: dict[str, str] = {}) → dict

购买兑换奖池的某个奖品

参数:

• user (User) -- 当前用户

• poolitem_id (str) -- 待购买的奖池奖品id，因为是前端传过来的所以是str

返回:

表明购买结果的warn_code和warn_message

返回类型:

MESSAGECONTEXT

app.YQPoint_utils.buy_lottery_pool(user: User, pool_id: str) → dict

购买抽奖奖池

参数:

• user (User) -- 当前用户

• pool_id (str) -- 待购买的奖池id，因为是前端传过来的所以是str

返回:

表明购买结果的warn_code和warn_message

返回类型:

MESSAGECONTEXT

app.YQPoint_utils.buy_random_pool(user: User, pool_id: str) → Tuple[dict, int, int]

购买盲盒

参数:

• user (User) -- 当前用户

• pool_id (str) -- 待购买的奖池id，因为是前端传过来的所以是str

返回:

表明购买结果的warn_code和warn_message；买到的prize的id（如果购买失败就是-1）； 表明盲盒结果的一个int：2表示无反应、1表示开出空盒、0表示开出奖品

返回类型:

Tuple[MESSAGECONTEXT, int, int]

app.YQPoint_utils.get_income_expenditure(user: User, start_time: datetime, end_time: datetime) → tuple[int, int]

获取用户一段时间内收支情况

参数:

• user (Usesr) -- 要查询的用户

• start_time (datetime) -- 开始时间

• end_time (datetime) -- 结束时间

返回:

收入, 支出

返回类型:

tuple[int, int]

app.YQPoint_utils.get_pools_and_items(pool_type: Type, user: User, frontend_dict: Dict[str, any])

获取某一种类的所有当前开放的pool的前端所需信息。如果用户未参加奖池关联的活动，这个奖池的信息不会被返回。

参数:

• pool_type (Pool.Type) -- pool种类

• user (User) -- 当前用户

• frontend_dict (Dict[str, any]) -- 前端字典

app.YQPoint_utils.run_lottery(pool_id: int)

抽奖；更新PoolRecord表和PoolItem表；给所有参与者发送通知

参数:

pool_id (int) -- 待抽取的抽奖奖池id