Gestão de Sessões de Carregamento
O módulo de Sessões (Charging Sessions) espelha o estado em tempo real dos carregamentos e mantém o registo histórico (System of Record).
Utilizamos Firestore acoplado a um barramento BullMQ para garantir tolerância a falhas.
Ciclo de Vida da Sessão
- CREATED: Registo inicial criado.
- AUTHORIZED: Pagamento validado (RemoteStart despachado).
- CHARGING: Hardware confirmou o início.
- STOPPING: RemoteStop despachado.
- COMPLETED: Transação concluída com captura financeira.
- ERROR: Falha no hardware ou banco. Estornos automáticos acionados.
Consultar Sessões
Retorna uma lista paginada com o histórico de sessões da empresa autenticada.
GET /charging-session
Tratamento Automático de Falhas (Autocura)
- Auto-Stop por Limite de Saldo: Se o custo dinâmico ultrapassar o pré-autorizado, a transação encerra automaticamente.
- Estorno por Falha de Hardware: Se o carregador reportar anomalia (CHARGER_FAULT), a API consolida o consumo e estorna o remanescente.