Primeiros Passos com Levy Swap
Esta e a lista pratica para colocar o Levy Swap em funcionamento em uma frota ja existente no Levy Fleets. O fluxo todo leva cerca de uma hora para 50 a 200 veiculos; a maior parte e esperar a impressao dos QRs.
Passo 1: Confirmar Elegibilidade da Frota
Cada veiculo com um dos tipos IoT suportados recebe automaticamente um SoH depois da configuracao. Tipos IoT suportados:
- OKAI - melhor telemetria de tensao/temperatura
- Segway - cobertura completa
- Omni 4G - Levy Max e familia A3A4
- Queclink (ZK600 / ZK105L)
- Acton / Feishen / Physhen
- Zimo - campos limitados (MQTT); SoH funciona com confianca menor
Veiculos axa ou manual mostram n/a em SoH (sem telemetria ao vivo).
Passo 2: Abrir o Swap Hub
Navegue ate Dashboard -> Swap. Voce vera quatro azulejos:
| Azulejo | O Que Tem |
|---|---|
| Saude da Bateria | Ranking SoH por pacote, previsoes EoL, flags de rotacao |
| Estacoes | Catalogo de estacoes e inventario ao vivo |
| Pacotes | Catalogo, ferramenta de mint de QR, gerador de etiquetas |
| Juicers | Roster e onboarding (desativado por padrao) |
Se nao ve o link Swap, peca ao seu contato Operator Success - e uma flag por subconta.
Passo 3: Backfill de Pacotes na Frota Existente
Quando o Levy Swap e habilitado pela primeira vez, a migracao escreve uma linha de pacote placeholder por veiculo. Esses placeholders ficam em deployed mas sem QR impresso e sem numero de serie real.
Duas formas de torna-los reais:
- Lote (recomendado acima de ~30 veiculos)
- Dashboard -> Swap -> Pacotes -> Mint
- Quantidade, fabricante, modelo, quimica (LFP / NMC), capacidade (Wh), tensao
- O sistema cria N pacotes em
orderede retorna PDF com etiquetas QR impermeaveis - Cole etiqueta no pacote quando receber, escaneie uma vez via Receber, e o pacote vai para
received
- Por veiculo na proxima troca (pequenas frotas)
- Na primeira troca, escaneie o QR colado - o sistema substitui o placeholder em um passo
QR Codes Nao Sao IDs do Banco
Cada QR codifica um ID aleatorio de 256 bits, nao o UUID. Etiquetas danificadas podem ser substituidas sem mudar o registro. Mantenha uma folha extra de QRs no estoque.
Passo 4: Esperar o Primeiro Job Noturno
O motor SoH roda diariamente as 03:00 UTC. Apos a primeira execucao, cada pacote com ao menos 24h de telemetria recebe SoH. Pacotes mais novos mostram "aquecendo" por uma ou duas noites.
Verifique o cron acessando Saude da Bateria na manha seguinte - o ranking deve estar preenchido.
Passo 5: Configurar a Primeira Estacao
Se voce tem um deposito, garagem ou closet de carga:
- Dashboard -> Swap -> Estacoes -> Adicionar Estacao
- Nome ("Garagem Principal", "HQ Centro", etc.)
- Pin no mapa
- Capacidade (slots) e numero de carregadores
- Salvar - slots auto-criados em
empty
Ao carregar pacotes, escaneie o QR em um slot pela pagina da estacao. O slot passa por empty -> charging -> charged, e a pagina de estacoes mostra contagens ao vivo.
Veja Inventario de Estacao.
Passo 6: Lancar o Fluxo de Troca no Operator App
Seus tecnicos precisam atualizar o operator-app para a versao com o tab Swap Queue. Atualizacao apenas JavaScript - sem rebuild nativo, sem atraso da App Store. Chega em minutos com Wi-Fi.
Aponte-os para Fluxo Interno de Troca.
Passo 7 (opcional): Decidir sobre Juicers
O marketplace e opt-in deliberado. Nao habilite sem ler Visao Geral do Marketplace - ha pre-requisitos de estados permitidos, KYC e seguro.
Perguntas Comuns no Primeiro Dia
- Todos meus pacotes mostram SoH 100 - e real? Pacotes novos comecam perto de 100. Espere uma semana.
- Alguns veiculos mostram "n/a". Tipo IoT nao suportado (
axa/manual) ou sem tensao nas ultimas 24h. - Um QR nao escaneia. Lente limpa e boa iluminacao; se fisicamente danificado, mint um novo pacote e troque a etiqueta.