Manual do Foto Bling

Capítulo 1Como funciona

São duas ações por produto: bipar o código de barras e tirar a foto. Sem menus nem confirmações.

O celular guarda o catálogo de produtos do Bling. Por isso o nome do produto aparece na hora do bipe, mesmo sem internet.
A foto fica guardada no celular e sobe sozinha para o servidor do Foto Bling assim que houver internet.
O servidor coloca a foto no cadastro do produto no Bling, no ritmo que o Bling permite, e tenta de novo sozinho se der falha.

Quem usa o quê

Quem	Onde	O que faz
Revenda	`foto.focosaas.com.br/painel`	Cadastra os clientes, configura o aplicativo do Bling e as atualizações do sistema.
Administrador do cliente	`foto.focosaas.com.br/painel`	Conecta o Bling da empresa, ativa os celulares, acompanha o progresso e os erros.
Operador	App no celular (ícone Foto Bling)	Bipa e fotografa. Não precisa de login: o celular é ativado por um link.

Capítulo 2Revenda: configuração

Revenda

Aplicativo do Bling (uma vez só)

No Bling: Central de Extensões → Área do Integrador → Criar aplicativo.
Link de redirecionamento: https://foto.focosaas.com.br/auth/callback. Escopo: Produtos.
No painel: Configurações → Aplicativo do Bling. Cole o Client ID e o Client Secret e salve. O Secret fica cifrado.

Atualizações do sistema

No GitHub, crie um token fine-grained só para o repositório app-foto, com Contents: Read-only e validade longa (1 ano).
Em Configurações → Atualizações do sistema, cole o token, marque Atualizar automaticamente, escolha o horário (padrão 03:00) e salve.
Atualizar agora instala na hora. Antes de trocar, o sistema roda os testes da versão nova; se algum falhar, nada muda. Voltar versão anterior desfaz a última atualização.

Limpeza das fotos do servidor

Em Configurações → Limpeza das fotos do servidor você vê o espaço usado e controla quando as fotos saem do servidor.

Limpeza automática: todo dia às 4h, apaga as fotos que chegaram ao Bling há mais do prazo escolhido (padrão 30 dias; opções de 7 a 90 dias, ou desligada).
Limpar agora: faz a limpeza na hora, sem esperar o prazo.
Fotos com erro ou ainda na fila nunca são apagadas: ficam guardadas até serem reenviadas, não importa quantos dias passem.
Antes de apagar, o sistema confere no Bling se o produto ainda depende do link da foto. Se depender, ela fica e aparece como "Em uso pelo Bling", para a foto não sumir do produto.

Dá para voltar atrás?Enquanto a foto estiver no servidor (dentro do prazo), o cliente pode reenviá-la ao Bling (menu Fotos → Reenviar), por exemplo se alguém apagou a foto do produto por engano. Depois que a limpeza apaga, só tirando outra foto.

Novo cliente

Clientes → Novo cliente: nome, CNPJ, e-mail e senha do administrador e o máximo de aparelhos do plano.
Passe ao cliente o endereço foto.focosaas.com.br/painel, o e-mail e a senha.
Para ajudar o cliente: clique em Abrir ao lado do nome. Você entra no painel dele.
Suspender bloqueia na hora o login e os celulares do cliente (ex.: inadimplência). Reativar libera de novo.

Minha conta

Clique no seu nome, no topo do painel, para trocar o e-mail de acesso e a senha.

Capítulo 3Cliente: primeiros passos

Administrador do cliente

Entre em foto.focosaas.com.br/painel com o e-mail e a senha recebidos.
Bling → Conectar ao Bling: entre com o usuário Bling da empresa e autorize. Você volta sozinho para o painel.
O catálogo começa a carregar sozinho. Acompanhe em Visão geral. A lista de produtos é rápida; os códigos de barras (GTIN) chegam aos poucos, cerca de 1 produto por segundo.
Bling → Quando o produto já tem foto: escolha Substituir (padrão) ou Adicionar.
Aparelhos → Adicionar: dê um nome (ex.: "Celular estoque 1") e toque em Enviar por WhatsApp. O link vale para um celular.

DicaO catálogo do celular se atualiza sozinho. No painel, Atualizar do Bling busca na hora os produtos novos ou alterados.

Capítulo 4Instalar no celular

Operador

Android

Abra o link de ativação (o do WhatsApp) no Chrome.
Permita o uso da câmera.
Menu ⋮ → Instalar app (ou "Adicionar à tela inicial"). Depois, abra sempre pelo ícone Foto Bling.

iPhone

Abra o link de ativação no Safari.
Toque nos contadores, na parte de baixo da tela, e depois em Copiar chave.
Toque em Compartilhar (□↑) → Adicionar à Tela de Início.
Abra pelo ícone novo, toque em Colar e em Ativar. Permita a câmera.

Por que copiar a chave no iPhone?O iPhone separa o app da Tela de Início do Safari: a ativação feita no Safari não passa para o ícone. Por isso a chave é copiada e colada uma vez.

Computador

Abra o link no Chrome ou Edge. Funciona com a webcam ou com um leitor de código USB/Bluetooth. Com o leitor, Espaço ou Enter tira a foto.

Capítulo 5Bipar e fotografar

Operador

O app abre com a câmera ligada. Aponte para o código de barras dentro do retângulo.
Ouviu o bipe? O nome do produto aparece grande no topo. Confira se é o produto certo.
Enquadre o produto e toque no botão amarelo. Você ouve o "clic-clac" da câmera e a tela pisca branco.
Pronto. A tela já está esperando o próximo bipe.

Cor da faixa do topo

Cor	Significa	O que fazer
Verde	Produto encontrado e ainda sem foto.	Fotografe.
Amarela	O produto já tem foto no Bling, ou já foi fotografado neste celular.	Se fotografar, a nova substitui a anterior (ou é adicionada, conforme a configuração da empresa).
Vermelha	Código não está no catálogo do celular.	Pode fotografar mesmo assim: o servidor procura no Bling. Se não existir lá, aparece como erro.

Sons

Bipe agudo	Código lido e produto encontrado.
Dois bipes graves	Código lido, mas fora do catálogo.
"Clic-clac"	Foto tirada e guardada.
Alerta (dois tons descendo) + vibração longa	Apareceu um problema no envio (veja o capítulo 8).

Sem som?O celular só libera o som depois do primeiro toque na tela. Confira também se o volume de mídia está alto e se o modo silencioso está desligado.

Outras funções

Lanterna (🔦, no canto direito): aparece nos celulares Android que permitem. O iPhone não deixa o navegador controlar a lanterna.
Digitar código: toque nos contadores → Digitar código. Use para etiqueta rasgada ou ilegível.
Sem internet? Pode continuar bipando e fotografando. Tudo fica guardado e sobe quando a internet voltar.

Capítulo 6Lista do celular

Operador

Toque nos contadores na parte de baixo da tela (na fila · no Bling · erros). Aparece:

Resumo do dia: ex. "Hoje: 52 bipados · 47 fotos · 45 no Bling · 5 sem foto".
Cada produto bipado, do mais recente para o mais antigo, com miniatura da foto, nome, código, horário e situação.

Situação	Significa
Na fila	A foto ainda está no celular, esperando internet.
A caminho do Bling	A foto já está no servidor, que está colocando no Bling.
No Bling	Pronto: a foto está no cadastro do produto.
Erro	O Bling recusou. O motivo aparece embaixo do nome.
Bipado, sem foto	O produto foi bipado, mas ninguém tirou a foto. Volte nele.

Reenviar (aparece ao lado da foto com erro): manda aquela foto de novo.
Enviar agora: força o envio do que está na fila (também tenta de novo as fotos recusadas pelo celular).
Limpar as já enviadas: tira da lista as fotos que já estão no Bling. Não apaga nada do Bling.

Muitas fotos por dia

Depois que a foto sobe, o celular guarda só uma miniatura. As fotos que já estão no Bling saem da lista sozinhas depois de ontem; as com erro ou na fila nunca saem sozinhas.
Em Aparelho aparece o espaço usado pelo app e o disponível. Fica em vermelho quando sobra pouco.
Se o celular ficar sem espaço, aparece a faixa vermelha com som: "a foto NÃO foi guardada". Libere espaço (ou conecte à internet para as fotos subirem) e fotografe de novo.
Quando a internet volta, o app envia tudo na hora.

Capítulo 7Painel do cliente

Administrador do cliente

Menu	Para que serve
Visão geral	Progresso da migração (quantos produtos já têm foto), fila, enviadas e erros, e a situação do catálogo.
Bling	Conectar ou desconectar o Bling; escolher se a foto nova substitui ou é adicionada.
Aparelhos	Ativar celulares (link por WhatsApp), ver fotos de hoje e o total de cada celular, gerar novo link, desativar celular perdido.
Fotos	Lista de problemas com o motivo, o link ver foto e o botão Reenviar em cada uma; Tentar de novo reenvia todas. Nas últimas enviadas, Reenviar manda a foto de novo ao Bling (enquanto ela estiver guardada no servidor).
Usuários	Outras pessoas da empresa com acesso ao painel (login por e-mail).

Capítulo 8Problemas e soluções

Faixa vermelha: "foto não subiu para o servidor"

O celular está sem internet ou o servidor não respondeu. As fotos estão guardadas no celular e o app tenta de novo sozinho. Confira o Wi-Fi. Para forçar, toque nos contadores → Enviar agora.

"Erro" na lista ou em Fotos → Problemas

O Bling recusou a foto. Leia o motivo. Depois de resolver, toque em Reenviar ao lado da foto (no celular ou no painel, menu Fotos), ou em Tentar de novo para reenviar todas.

"Código não encontrado no Bling": o código bipado não existe em nenhum produto. Confira o cadastro (campo Código ou GTIN/EAN).
"Bling desconectado": o administrador precisa entrar em Bling → Conectar de novo. As fotos esperam na fila.
"Um erro interno aconteceu…": normalmente o Bling não conseguiu baixar a foto do nosso servidor. Abra ver foto: ela precisa abrir sem aviso de segurança. Se não abrir, chame o suporte (capítulo 9).

A foto sumiu do produto no Bling

No painel, menu Fotos → Últimas enviadas, toque em Reenviar na foto do produto. Funciona enquanto a foto estiver guardada no servidor (prazo da limpeza, padrão 30 dias). Depois disso, é só bipar e fotografar de novo.

Ficou sem internet

Continue bipando e fotografando: as fotos ficam guardadas no próprio app (não vão para a galeria) e sobem sozinhas quando a internet voltar. O envio acontece com o app aberto: antes de encerrar o dia, confira que nada ficou em "Na fila". Não remova o app nem apague os dados do navegador com fotos na fila: elas se perderiam.

Câmera não abre

Permita a câmera nas configurações do navegador (Android: cadeado ao lado do endereço → Permissões; iPhone: Ajustes → Safari → Câmera). Feche e abra o app.

Não lê o código de barras

Aproxime ou afaste o celular até focar, use a lanterna em lugar escuro e deixe o código inteiro dentro do retângulo. Se não der, digite o código (contadores → Digitar código).

Nome errado ou "produto não encontrado" num produto que existe

O catálogo do celular pode estar desatualizado. Contadores → Catálogo → Baixar de novo. Se o produto foi criado agora, o administrador pode clicar em Atualizar do Bling (Visão geral).

"Este aparelho foi desativado"

O administrador gerou um link novo ou desativou o celular. Peça um novo link (Aparelhos → Novo link). As fotos que estavam no celular continuam guardadas e sobem depois da reativação.

Capítulo 9Suporte técnico

Revenda / técnico

Servidor: serviço foto-bling (Node), em /home/focosaas/domains/foto.focosaas.com.br/app, porta interna 3200, atrás do Apache.
Ver o que está acontecendo: journalctl -u foto-bling -n 50 --no-pager
Reiniciar só o app: systemctl restart foto-bling
Backup: a pasta data/ (banco + fotos). O Bling pode depender dos links das fotos: não apague fotos à mão; use a limpeza do painel, que confere no Bling antes de apagar.
Atualizar pelo terminal (alternativa ao painel): cd /root/app-foto && git pull && bash deploy/instalar.sh

Certificado SSL (importante)O Bling só baixa as fotos se o certificado do foto.focosaas.com.br estiver completo (com a cadeia). No Apache, use o ssl.combined, não o ssl.cert. Teste:

curl -s -o /dev/null -w "%{http_code}\n" https://foto.focosaas.com.br/saude

Tem que dar 200. Depois de renovar o certificado no Virtualmin, confira de novo.

Antes de mexer no ApacheRode apachectl configtest e, depois, systemctl is-active apache2. Os outros sites da VPS usam o mesmo Apache.

Capítulo 10Novidades por versão

10/10/2026

Preparado para alto volume (1.000+ produtos por dia por celular): lista do celular se limpa sozinha, histórico de bipes maior, espaço do app à mostra.
Alerta quando a foto não pode ser guardada por falta de espaço.
Quando a internet volta, envia tudo na hora.

09/10/2026 (noite)

Limpeza das fotos do servidor: automática (padrão 30 dias depois de chegar ao Bling) e botão Limpar agora, com conferência no Bling antes de apagar. Fotos com erro nunca são apagadas.
Botão Reenviar em cada foto com erro (celular e painel) e nas fotos já enviadas, enquanto estiverem no servidor.
Manual do app (este) e documentação técnica.

09/10/2026

Lista no celular: produtos bipados (com e sem foto), situação de cada foto e resumo do dia.
Sons: bipe de leitor, aviso de código fora do catálogo e "clic-clac" de câmera.
Alerta de erro de envio: faixa vermelha e som quando a foto não sobe ou o Bling recusa.
Painel: fotos por aparelho (hoje, total e no Bling).
iPhone: leitura do código pela câmera e instalação na Tela de Início.
Envio ao Bling mais robusto (plano B automático) e erros detalhados com link "ver foto".
Login do painel por e-mail; página Minha conta.
Atualização do sistema pelo painel e automática.
Aplicativo do Bling cadastrado pelo painel (Configurações).
Primeira versão multiempresa, para revenda.