Guia completo do fluxo de trabalho — versão longa em GUIA.md no repositório.
O fluxo, do começo ao fim
📦 Estoque→📥 Nova Oferta→💾 Orçamento→💰 Venda
1
Cadastre suas repetidas em 📦 Estoque
Clique numa figurinha = +1. Shift+clique ou toque longo = −1.
O filtro aceita país, sigla, "craque" ou número (1, 13).
Pegou a figurinha na mão e ainda não cadastrou? Dá pra selecioná-la nas telas de oferta mesmo assim
(fica vermelha com borda verde) e cadastrar na hora da venda.
2
Cole a lista do cliente em 📥 Nova Oferta
Aceita inline (POR10, POR-14) e agrupado (BIH 🇧🇦: 5, 13).
O app cruza com o estoque e já marca o que você tem. O que faltou vira 🔎 Procuradas
no nome desse cliente. Ajuste a seleção e gere a lista pronta pro WhatsApp.
3
Salve como 💾 Orçamento
Guarda a oferta pra fechar depois. No modo com reserva (veja abaixo), salvar um orçamento
reserva aquelas figurinhas — elas somem do "disponível" da vitrine e das próximas ofertas.
Dá pra reabrir e adicionar figurinha nova achada depois.
4
Feche em 💰 Confirmar Venda
Baixa o estoque, congela o preço do momento e pergunta forma/status de pagamento.
↩️ Cancelar Venda devolve tudo ao estoque e recria o orçamento.
🔑 Modo de trabalho — a parte que mais confunde
🔒
Com reserva (padrão)
Orçamento salvo segura as figurinhas por até 48 h. Serve pra não vender a mesma
figurinha pra duas pessoas. Na prática, você TEM que separar fisicamente: ao salvar o orçamento, tire as figurinhas da
caixa e ponha num saquinho com o nome do cliente. Quando ele pagar → Confirmar Venda. Se ele sumir →
devolva o saquinho pra caixa e apague o orçamento (ou espere expirar em 48 h).
A vitrine e a Nova Oferta mostram o estoque menos o que está reservado — por isso podem
mostrar menos do que tem na caixa. Isso é o esperado se você separou de verdade.
🔓
Sem reserva
Orçamento vira só um rascunho / registro. A vitrine, a Nova Oferta e a Escolha Livre mostram
o estoque físico inteiro, sempre. Não separa nada; quem chega primeiro leva e, se dois pedirem
a mesma, você resolve na conversa. Zero chance de "desincronização" entre caixa e app.
⚙️
Onde troca / o aviso ao cliente⚙️ Configurações → Loja → Modo de trabalho. Ali também tem "Aviso de reserva (horas)":
o texto que aparece pro cliente na vitrine ("reservadas por até 24 h"). É de propósito
menor que as 48 h reais — assusta menos e faz ele decidir logo; se atrasar, só tem
surpresa boa (ainda está lá).
Telas de apoio
✏️
Escolha Livre
Monta oferta clicando direto nas figurinhas, sem colar lista — bom pra montar pacote na hora.
🔎
Procuradas
Radar de quem quer o quê, alimentado por cada lista processada em Nova Oferta. Gera a lista
"PROCURO" pronta pros grupos de troca.
✅
Consegui pra Você
Cruza o radar de Procuradas com o que entrou no estoque — mostra "conseguiu a figurinha que
o fulano queria" e monta o orçamento com 1 toque.
❌
Não Tenho
Todas as figurinhas do álbum que faltam no seu estoque — pra saber o que caçar.
🔄
Trocas Manuais
Cola a lista de repetidas (e, se tiver, de faltantes) de um amigo e calcula o que dá pra pegar e
o que dá pra oferecer.
🛍️ Vitrine pública
🛍️
Link que o cliente monta o pedido sozinho⚙️ Configurações → Vitrine pública. Precisa estar logado na nuvem. Publica só preço e
tem/não tem (nunca quantidade, vendas ou clientes). O cliente escolhe, o pedido chega pronto
no seu WhatsApp e você cola em 📥 Nova Oferta pra processar. Atualiza sozinha a cada mudança
de estoque enquanto você estiver logado.
☁️ Nuvem & 📷 Scanner
☁️
Sincronizar celular e PC⚙️ Configurações → "Sincronizar entre celular e PC" (ou o chip Nuvem no rodapé do menu).
Login por e-mail/senha. Sem login, os dados ficam só neste navegador/aparelho.
📷
Scanner
Aponte pro verso da figurinha, onde está o código. Detecta a "pílula" com sigla+número
sozinho; na dúvida mostra as 3 opções mais prováveis. Precisa de internet (OCR vem de CDN).
Regras do álbum
✨
Brilhantes
A nº 01 de cada seleção + todas as 🏆 FWC (00–19).
⭐
Craques
O cabeçalho de cada seleção mostra quem é o craque. A Panini não divulga a numeração oficial,
então não marcamos por número. Edite ACES_BY_TEAM em js/data.js.
📐
Numeração
980 cromos = 48 seleções × 20 (nº 01–20) + 20 especiais FWC (nº 00–19).
Não existe bloco "HIST".
💡 Atalhos: ? ajuda · M menu · Esc fecha ·
Interruptor "Conferir estoque" liga/desliga a validação e nunca apaga o que você marcou.
📦 Meu Estoque
🔓 Modo sem conferência ativo — as ofertas não estão validando o estoque.
Cadastre as figurinhas repetidas que você tem para vender
—
Clique = +1 • Shift + clique / toque longo = −1
O selo vermelho indica quantas pessoas procuram aquela figurinha
Não tenho Tenho Qtd. Procurada ✨ brilhante
📥 Nova Oferta
🔓 Modo sem conferência — nada vem pré-marcado: escolha o que oferecer.
Cole a lista recebida — aceita formato inline e agrupado
—
Selecionada (tenho) Selecionada s/ estoque Não tenho (clicável) Desmarcada
Clique para marcar/desmarcar — as sem estoque também podem ser selecionadas.
✏️ Escolha Livre
🔓 Modo sem conferência — avisos de saldo desativados.
Monte a oferta clicando direto nas figurinhas, sem precisar de lista
—
Selecionada (tenho) Selecionada s/ estoque Sem estoque (clicável)
🔄 Trocas Manuais
Cole as listas do seu amigo pra ver o que dá pra trocar
✅ Você pode pegar dele
O que ele tem sobrando que está na sua lista de faltantes
—
🎁 Você pode oferecer pra ele
O que você tem sobrando que está na lista de faltantes dele
—
🔎 Procuradas
O que te pediram e você não tem — use para trocar e aumentar o estoque
—
Cada lista processada em Nova Oferta alimenta este radar automaticamente.
Clique em +1 quando conseguir a figurinha: ela vai para o estoque e sai desta lista.
📇 Pedidos registrados
Histórico por pessoa — exclua os que já resolveu
🎁 Consegui pra Você
Clientes que registraram procura e você já tem parte do que eles queriam
—
A lista sai do que foi processado em Nova Oferta. Cada item some sozinho
quando você já não tem, ou depois que vira orçamento pro cliente.
—
Clique pra tirar da oferta o que você não quer mandar agora.
💾 Orçamentos Salvos
🔓 Modo sem conferência — avisos de saldo desativados.
Ofertas montadas aguardando confirmação do cliente
—
💵 Tabela de Preços
Define quanto vale cada figurinha — usado nos orçamentos e nas vendas
—
Valores padrão
Aplicados a toda figurinha que não tiver preço especial
Preços especiais
Exceções que sobrescrevem o valor padrão da categoria
Simulação do álbum completo
Quanto valem os 980 cromos com a tabela atual
💰 Histórico de Vendas
Vendas confirmadas com baixa no estoque
—
↩️ Cancelar Venda devolve as figurinhas ao estoque e recria o orçamento • 🗑️ Excluir apaga só o registro
—
Registro fechado — as figurinhas abaixo já saíram do estoque e não podem ser alteradas aqui.
📊 Relatórios
Faturamento, recebido e ticket médio por período
—
Faturamento por cliente
Do maior pro menor, no período selecionado
📷 Scanner de Códigos
Aponte para o verso da figurinha — o código é detectado sozinho
encaixe o código aqui
Toque em Iniciar e aponte para o código
✍️ Entrada manual
Código ilegível? Digite: BRA 5 · fwc00 · arg17
Pronto.
❌ Não Tenho
Figurinhas do álbum que ainda não estão no seu estoque
—
⚙️ Configurações
Tudo da sua loja num lugar só
É pra cá que chega o pedido montado na vitrine.
Texto que o cliente vê na vitrine. O prazo real é 48 h — avisar um número
menor faz ele decidir logo. Só vale no modo com reserva.
Tema do aplicativo
Na grade de figurinhas
👤 Nomes dos jogadores
💰 Preços nas figurinhas
Conferir estoque
Backup local do arquivo de dados — o mesmo do menu lateral.
Abrir outra tela
🧪 Testes Unitários
Valida as funcionalidades — seus dados reais não são alterados