Struct TokenService 

pub struct TokenService;

Implementations

impl TokenService

pub async fn recharge( pool: &Pool<Postgres>, params: TokenRechargeInsertParams, ) -> Result<RechargeResult, Error>

充值：在同一事务中插入充值记录并更新账户余额。 若账户不存在则自动创建。

pub async fn consume( pool: &Pool<Postgres>, params: TokenUsageInsertParams, ) -> Result<ConsumeResult, Error>

消费：在同一事务中扣减余额并写入消费记录。 余额不足时返回 Error::InsufficientBalance，不写消费记录，事务回滚。

pub async fn adjust( pool: &Pool<Postgres>, user_id: i64, amount: i64, admin_user_id: i64, remark: Option<String>, ) -> Result<AdjustResult, Error>

管理员调整某用户的 token 余额（保留审计流水，禁止绕过流水直接 UPDATE）：

• amount > 0 → 调用 Self::recharge，source=RECHARGE_SOURCE_ADMIN，created_by=admin_user_id
• amount < 0 → 调用 Self::consume，service=SERVICE_ADMIN_ADJUST，biz_id=admin:<id> 保留操作者
• amount == 0 → 返回 Error::InvalidAmount

remark 为空或空白会被替换为 “admin adjust”。