Credit Grant Expiration Sweep - Documentação DEVMOB

Credit Grant Expiration Sweep é a rotina periódica que expira créditos concedidos quando expiresAt é alcançado.

Objetivo

A rotina mantém CreditGrant e CreditLedgerEntry alinhados com a validade do crédito.

Ao rodar, a rotina:

Busca créditos com status = ACTIVE e expiresAt vencido.
Calcula o saldo disponível remanescente.
Cria uma entrada CreditLedgerEntry do tipo EXPIRE quando houver valor disponível a baixar.
Atualiza o CreditGrant para status = EXPIRED.

Regra	Comportamento
Validade	`expiresAt` define o fim de validade do crédito.
Ledger	Expiração que altera saldo deve gerar movimento `EXPIRE`.
Reservas	Reservas pendentes precisam ser tratadas antes de baixar o saldo disponível.
Estados terminais	Créditos `EXPIRED`, `CONSUMED` ou `CANCELED` não são processados.
Idempotência	A chave de idempotência evita duplicar movimento de expiração.