Documentação

Assistente de Inicialização

O Assistente de Inicialização é executado na primeira vez que você abre o aplicativo. Ele orienta você na escolha de um modo de uso, na ativação de recursos de IA, na configuração de criptografia e sincronização, e na revisão dos próximos passos — para que o aplicativo esteja ajustado à forma como você realmente planeja usá-lo.

Escolha Seu Modo

Etapas de Configuração

1. Escolha seu idioma e o modo que melhor corresponde à forma como você usará o aplicativo — Personal Keeper, Inventory Pro ou The Full Bleep.
2. Na tela AI Superpowers, decida se deseja ativar o Reconhecimento de Imagem (tire uma foto e a IA preenche os detalhes do item) e as Descrições de Vendas (a IA escreve anúncios atraentes para o marketplace).
3. Ajuste a aparência em Make It Yours, opte pela criptografia de ponta a ponta em Lock It Down? e ative a sincronização entre dispositivos em Your Data Lives Here.
4. Revise o resumo You're all set! — links rápidos para adicionar sua chave de API de IA, configurar o Square e ativar a sincronização — depois toque em Let's Go para chegar ao painel inicial.

Nota: Se você optar pela criptografia, o assistente executa um breve fluxo complementar para criar uma senha de criptografia e salvar uma frase de recuperação — guarde a frase de recuperação em um local seguro, pois é a única maneira de recuperar seus dados se você esquecer a senha. Todas as opções do assistente podem ser alteradas depois em Configurações.

Painel Inicial

A tela Início é seu hub central. Ela mostra todos os seus itens, o status de check-in/check-out e oferece acesso rápido a todos os recursos principais pela navegação de abas na parte inferior.

Navegação por Abas Inferiores

O aplicativo usa uma barra de abas na parte inferior para navegar entre as seções principais:

Gerenciamento de Itens

Os itens são o núcleo do Where The Bleep. Cada item pode ter fotos, descrições, categorias, metadados (números de série, preço de compra, valor estimado, referências de seguro) e uma localização atribuída.

Criando um Item

1. Toque no botão + no ecrã inicial
2. Adicione um título e uma descrição — ou toque no botão de câmara com IA para tirar uma foto e deixar a IA gerá-los
3. Escolha uma categoria no seletor
4. Atribua uma localização navegando pela sua árvore de localizações
5. Opcionalmente adicione fotos, número de série, preço de compra, valor estimado e informações de seguro
6. Ative Tem Inventário se quiser rastrear quantidades
7. Toque em Salvar

Status dos Itens

Ações do Item

Localizações

As localizações são organizadas em hierarquia. Localizações contêiner (cômodos, edifícios, armários) podem conter outros contêineres ou destinos. Localizações de destino são onde os itens são armazenados — uma prateleira, gaveta ou caixa específica.

Recursos de Localização

• Caminhos de navegação — ex.: "Casa > Escritório > Mesa"
• Gráfico sunburst — visualização interativa de toda a sua árvore de localizações
• Etiquetas QR — gere etiquetas de código QR personalizáveis para qualquer local de destino em dois formatos de modelo Avery
• Contagem de itens — veja quantos itens estão armazenados em cada localização
• Imprimir em PDF — exporte folhas de etiquetas de código QR como PDF para imprimir em papel de etiqueta padrão
• Reimpressão seletiva — imprima apenas etiquetas não impressas, reimprima uma única etiqueta ou imprima todas de uma vez
• Busca — pesquisa por texto completo e por voz para acessar qualquer local pelo nome ou pelo que está armazenado dentro

Gerenciamento de Localizações

Códigos QR e Etiquetas

Cada localização de destino pode ter um código QR. Escanear uma etiqueta QR abre instantaneamente a localização para que você possa dar entrada nos itens. As etiquetas utilizam o esquema de URI belongings://loc/{uuid}.

Fluxo de Etiquetas QR

1. Navegue até uma localização de destino
2. Toque no ícone de código QR para gerar uma etiqueta
3. Imprima etiquetas individuais ou use a Exportação em PDF em Massa para imprimir várias de uma vez
4. Cole a etiqueta na localização física (prateleira, caixa, gaveta)
5. Para registrar a entrada de um item, escaneie o código QR com a câmera do aplicativo

Rastreamento de Status do QR

Opções de Impressão

• Formato da etiqueta — escolha Avery 5160 (1 × 2-5/8") ou o modelo maior de 2 × 4", em layout vertical ou horizontal
• Personalizar a etiqueta — controles deslizantes de tamanho independentes para o nome da localização e o código de ID, além de uma opção para mostrar ou ocultar o caminho de navegação
• Margem superior — ajuste onde a impressão começa para que folhas de etiquetas parcialmente usadas se alinhem corretamente
• Incluir número do código de barras — imprima o ID bruto sob cada QR para entrada manual quando o escaneamento não for uma opção
• Apenas reimpressões pendentes — pule etiquetas já impressas em uma execução em massa para não desperdiçar folhas
• Salvar como PDF — visualize a folha completa na tela antes de enviá-la para uma impressora

Use o botão "Foi Impresso" para reimprimir etiquetas individuais sem reimprimir todas em massa novamente.

Pesquisa e Voz

A pesquisa é alimentada pelo SQLite FTS5 para busca de texto completo ultrarrápida em nomes de itens, descrições e tags. A pesquisa por voz usa reconhecimento de fala no dispositivo.

Recursos de Pesquisa

• Busca de texto completo — encontra correspondências em nomes, descrições e tags
• Correspondência por prefixo — comece a digitar e os resultados aparecem instantaneamente
• Pesquisa por voz — toque no ícone do microfone e diga sua consulta
• Filtrar por localização — refine os resultados para um cômodo ou área específica
• Filtrar por categoria — exiba apenas itens de uma categoria específica
• Filtrar por status — em armazenamento, emprestado, listado para venda, etc.
• Voz em todos os campos — o microfone funciona em Nome e Descrição do item, notas de listagem, preço pedido, nomes de Check-in / Check-out e qualquer outra entrada de texto no aplicativo
• Pesquisar dentro de Localizações — pesquisa por voz ou texto acima da árvore de localizações para ir até uma sala, gaveta ou contêiner pelo nome

Pessoas e Empréstimos

Gerencie uma lista de pessoas que podem pegar seus itens emprestados. O app oferece duas ações separadas: <strong>Retirar</strong> remove um item do seu local, enquanto <strong>Emprestar</strong> atribui o item a uma pessoa específica. O app lista itens retirados e emprestados separadamente para que você sempre saiba onde tudo está.

Fluxo de Retirada e Empréstimo

1. Na tela de detalhes de um item, toque em Retirar para remover o item do seu local, ou toque em Emprestar para atribuí-lo a uma pessoa
2. Para Emprestar, selecione uma pessoa dos seus contatos ou crie uma nova
3. O status do item muda para Retirado ou Emprestado com o nome da pessoa exibido
4. Para devolver, toque em Devolver — o item regressa a Em Armazém

Gerenciando Pessoas

Histórico de Eventos

Cada entrada, retirada e empréstimo é registrado com data e hora. Visualize o histórico na tela de detalhes do item.

Rastreamento de Inventário

Opcionalmente ative contagens de inventário em qualquer item — independente do check-in/check-out. Rastreie quantidades de consumíveis, suprimentos ou qualquer coisa que você tenha em múltiplas unidades.

Como Funciona

1. Ao criar ou editar um item, ative Tem Inventário
2. Defina a quantidade inicial
3. Na tela de detalhes do item, use os botões + e - para ajustar a contagem
4. Toque no número para definir manualmente uma quantidade específica
5. Todas as alterações são registradas com data e hora no histórico de inventário

Relatórios de Inventário

Toque no ícone de relatório ao lado do botão de inventário para gerar um relatório PDF de inventário. O relatório inclui a miniatura do item, quantidade atual e uma tabela completa do histórico de alterações. Salve ou compartilhe o PDF pela tela de compartilhamento do sistema.

Escanear Código de Barras

Toque no ícone QR verde na aba Inventário para abrir Escanear Inventário — um scanner de câmera ao vivo com duas abas para ajustar o estoque: Recebimento para itens que chegam e Manual para definir uma quantidade exata. O estoque que sai é gerenciado pelo escaneamento de Vendas no PDV, abordado na seção Square POS.

Estoque Baixo e Sem Estoque

Defina um Ponto de reabastecimento em qualquer item rastreado. A aba Inventário mostra um selo laranja de Estoque baixo quando a quantidade em estoque está igual ou abaixo desse ponto, e um selo vermelho de Sem estoque quando a contagem chega a zero. O bloco de resumo do painel e um cartão de alerta na tela inicial mostram a contagem para que você identifique faltas sem precisar procurá-las, e os chips de filtro Estoque baixo e Sem estoque restringem a lista apenas aos itens afetados.

Inventário Físico

Abra Inventário físico no menu ⋮, escolha uma localização de destino e percorra cada item rastreado naquela localização inserindo a contagem real que você vê na prateleira. A tela mostra a quantidade esperada ao lado da sua entrada com uma seta verde ou vermelha indicando a discrepância. Salve e o aplicativo registra apenas os itens que mudaram, com um motivo e nota opcionais anexados a cada ajuste.

Importação de CSV

No menu ⋮ selecione Importar de CSV e escolha um arquivo com duas colunas — barcode_or_name e quantity. Valores numéricos com 8 a 14 dígitos são tratados como códigos de barras; tudo o mais é correspondido por similaridade aos nomes dos itens. A primeira linha é detectada automaticamente como cabeçalho. A importação é registrada como um ajuste de importação CSV para que você possa rastrear qualquer alteração até o arquivo.

Rastreamento de Danos e Perdas

Quando uma contagem de inventário fica abaixo do esperado, marque a discrepância com um motivo — Danificado, Erro de contagem, Obsoleto, Deterioração, Roubo ou Outro. Os motivos alimentam dois relatórios no menu ⋮: Discrepâncias (lista bruta de cada ajuste) e Relatório de quebras (totais agrupados por motivo e período), ambos exportáveis como PDF para seguro ou revisão de fim de período.

Painel de Inventário

A aba Inventário é a base central para tudo relacionado ao estoque: cartões de resumo para Itens rastreados, Unidades totais e Estoque baixo; chips de filtro para Todos, Estoque baixo e Sem estoque; pesquisa de texto completo e por voz; um botão flutuante de escaneamento QR; um atalho para impressora; e o menu ⋮ que abre Inventário físico, transferências, importação CSV e os quatro relatórios integrados — Nível de estoque, Movimentação, Valoração e Quebras.

PDV Square

O Where The Bleep inclui um Ponto de Venda integrado na aba Vender — um carrinho operado por leitor de código de barras que se conecta ao Square para pagamentos com cartão. Você também pode receber em dinheiro com cálculo de troco integrado, ou registrar uma venda paga por outro canal. Cada sessão de caixa abre com o Resumo de Hoje (Vendas, Devoluções, Líquido) e uma lista de Transações Recentes que você pode reimprimir ou reembolsar.

Métodos de Pagamento

Fluxo de Checkout

1. Na aba Vender, toque no botão verde do leitor de QR para abrir o scanner do PDV
2. Escaneie um código de barras (ou escolha na lista de busca) para adicionar um item ao carrinho — a quantidade padrão é 1 e pode ser editada no modal Adicionar ao Carrinho
3. Toque em Pagar na folha do carrinho para abrir o Checkout, onde você escolhe um método de pagamento e confirma o total
4. Para Leitor de Cartão e Cartão Manual o app passa a transação para o Square; para Dinheiro, informe o valor recebido e o app calcula o troco
5. Após a conclusão da venda, a tela do recibo voltada ao cliente aparece — o cliente pode opcionalmente informar um e-mail para receber o recibo em seu idioma preferido

PDV Offline

Quando o app perde conexão com a internet, o PDV continua funcionando para pagamentos não-Square e enfileira qualquer item que precise comunicar com o servidor.

• Vendas em Dinheiro e Externas funcionam totalmente offline — sem necessidade de rede
• Ajustes de estoque a partir de vendas no PDV são registrados localmente e sincronizam com outros dispositivos no momento em que você se reconecta
• Recibos por e-mail são enfileirados localmente e enviados automaticamente quando a rede voltar; a tela de agradecimento ao cliente ainda é exibida imediatamente

Observação: Pagamentos por Leitor de Cartão e Cartão Manual exigem conexão ativa com a internet no momento da cobrança — o Square precisa autorizar o cartão. Se a rede cair durante o checkout, mude para Dinheiro ou Externo, receba o pagamento de outra forma e registre a venda para que seu estoque e relatórios permaneçam precisos.

Vendedores e Operadores

Adicione vendedores (operadores) para que o PDV possa ser atendido por mais de uma pessoa e cada transação seja atribuída a quem a registrou. Os operadores entram com seu nome e um PIN opcional, recebem apenas as permissões que você concede e você pode voltar para Administrador a qualquer momento usando sua senha de criptografia.

Adicionando um Vendedor

1. Abra Configurações > Vendas > Vendedores e toque em Adicionar Vendedor (ou no botão + na lista de Vendedores)
2. Informe um nome e um PIN de 6 dígitos opcional — sem um PIN o perfil fica aberto e qualquer um pode usá-lo, o que é aceitável para um único local de confiança, mas não ideal para um ambiente movimentado
3. Ative as permissões que deseja conceder — Acesso ao Estoque, Acesso a Relatórios e uma Definir Expiração opcional para acesso por tempo limitado
4. Opcionalmente, escolha um local padrão de venda para que as vendas no PDV do operador deduzam o estoque do local correto automaticamente

Níveis de Permissão

Acesso por Tempo Limitado

Ative Definir Expiração ao adicionar ou editar um vendedor e escolha uma data. Após essa data, suas permissões são revogadas automaticamente e a tela de login do operador exibe uma mensagem clara de expirado — útil para funcionários sazonais, prestadores de serviço ou qualquer pessoa a quem você queira conceder apenas acesso temporário.

Marcação de Eventos e Trilha de Auditoria

Cada venda, devolução, ajuste de estoque e inventário é marcado com o operador que o realizou, incluindo transações registradas enquanto conectado como Administrador. As marcações aparecem nas listas de transações, no histórico de eventos do estoque e nos relatórios exportados — para que você sempre saiba quem fez o quê e quando.

Observação: Voltar de uma sessão de operador para Administrador requer a senha de criptografia (ou o desbloqueio do dispositivo se a criptografia não estiver ativa). Isso impede que um operador conectado altere configurações, exclua outros operadores ou veja relatórios de caixa que não deveria ver.

Venda e Anúncios em Marketplaces

Liste itens para venda em 7 marketplaces compatíveis. A IA gera os detalhes do anúncio a partir dos dados do seu item, e o app produz fichas de venda em PDF que você pode consultar ao publicar.

Marketplaces Compatíveis

Fluxo de Anúncio

1. Vá até a aba Vender e toque em Novo Anúncio
2. Escolha um item no seletor de itens com busca
3. Selecione um marketplace
4. A IA preenche automaticamente os campos do anúncio: título, preço, categoria, condição e descrição
5. Cada marketplace possui seus próprios campos extras (ex.: eBay: marca, UPC, frete; Poshmark: departamento, tamanho)
6. Revise e edite tudo na tela de revisão
7. Gere uma ficha de venda em PDF — inclui foto do item, todos os detalhes do anúncio e um código QR com link para a página de criação de anúncio do marketplace
8. Salvar em Downloads ou Compartilhar via AirDrop, e-mail ou mensagens

Rastreamento de Vendas

Os itens passam pelos status de listagem: Listado para Venda → Vendido – Não Entregue → Entregue. O painel de vendas mostra listagens ativas (incluindo itens vendidos mas não entregues), histórico completo de vendas e estatísticas resumidas com detalhes do comprador, preços, taxas e receita líquida. Gere relatórios de vendas em PDF ou CSV para qualquer período.

Integração Square para Vendas

Além de aceitar pagamentos com cartão presenciais no PDV, a integração com o Square também viabiliza o envio de Recibos por E-mail — quando uma assinatura ativa de recibos por e-mail do Square está conectada, os recibos voltados ao cliente podem ser enviados no idioma preferido do comprador diretamente da tela de agradecimento do PDV. Autorize o Square uma vez em Configurações > Vendas > Pagamentos Square e tanto os pagamentos com cartão quanto os recibos por e-mail compartilham a mesma conexão.

Recibos

Toda venda no PDV termina em uma tela de recibo de Agradecimento voltada ao cliente, com os itens, total, forma de pagamento e (para dinheiro) o troco devido. O cliente pode opcionalmente inserir seu e-mail para receber o recibo no idioma de sua preferência, e você pode reimprimir ou reembolsar qualquer venda passada na lista Transações Recentes.

Recursos de Recibos

• Multilíngue — os recibos são traduzidos automaticamente para o idioma escolhido pelo cliente no momento da venda (18 idiomas suportados)
• Dois canais de entrega — uma tela voltada ao cliente que o comprador lê no seu dispositivo e um recibo opcional por e-mail enviado para o endereço dele
• Reimpressão sob demanda — cada transação em Transações Recentes abre uma página completa de detalhes do recibo que você pode reenviar, salvar em PDF ou reembolsar
• Controle de troco em dinheiro — para vendas em dinheiro, o recibo registra o valor recebido e o troco entregue para que a trilha de auditoria seja inequívoca

Fluxo de Recibos

1. Conclua uma venda no PDV — a tela do recibo voltada ao cliente aparece automaticamente com os totais e um seletor de idioma
2. Entregue o dispositivo ao cliente; a tela usa texto maior e um seletor de idioma para que ele possa ler com conforto e alternar idiomas instantaneamente
3. Se o cliente quiser uma cópia por e-mail, ele insere seu endereço e toca em Enviar Recibo — o e-mail é enfileirado no idioma selecionado
4. Toque em Concluído para voltar ao scanner do PDV pronto para a próxima venda

Personalizando Recibos

A personalização do recibo é obtida em Configurações > Vendas > Informações do Negócio — o nome da sua empresa, endereço, telefone, e-mail, CNPJ e CEP aparecem no topo. Configure o remetente do e-mail em Configurações > Vendas > Opções de E-mail: escolha o serviço de e-mail integrado Where The Bleep (assinatura necessária) ou seu próprio servidor SMTP Personalizado para que os recibos sejam enviados do seu próprio domínio.

Observação: Os recibos por e-mail exigem conexão com a internet no momento do envio, mas são enfileirados localmente se você estiver offline e enviados assim que a rede voltar. A tela de agradecimento voltada ao cliente sempre é exibida imediatamente, online ou offline.

Criptografia e Segurança

O Where The Bleep usa criptografia de ponta a ponta com conhecimento zero. Seus dados são criptografados no dispositivo antes de chegarem à nuvem. Nós não podemos ler seus dados — somente você pode.

Detalhes da Criptografia

Hierarquia de Chaves

Sua senha deriva uma Chave Mestra (256 bits) via PBKDF2-HMAC-SHA256 (600 mil iterações). A partir da chave mestra, três subchaves são derivadas:

• DEK (Chave de Criptografia de Dados) — criptografa campos de itens, nomes, descrições
• FEK (Chave de Criptografia de Arquivos) — criptografa imagens e documentos em blocos de 64 KB
• SIK (Chave de Índice de Busca) — gera índices cegos para consultas no servidor

Opções de Desbloqueio

Proteção contra Força Bruta

Tentativas falhadas de palavra-passe ativam bloqueios com recuo exponencial: 30 segundos → 5 minutos → 15 minutos → 1 hora.

Autenticação de Dois Fatores

Vincule um aplicativo autenticador à sua conta para uma camada extra além da sua senha. Configure em Configurações > Segurança > Autenticação de Dois Fatores — qualquer aplicativo compatível com TOTP funciona (Google Authenticator, Authy, 1Password, Microsoft Authenticator). Uma vez vinculado, o login em um novo dispositivo exige tanto sua senha quanto um novo código de 6 dígitos do aplicativo.

Segurança de Rede

• Monitoramento de Transparência de Certificados — rastreamento de certificados TLS TOFU para cada endpoint de API
• Detecção de alteração de certificado — alertas quando a impressão digital de um certificado muda inesperadamente
• Tráfego não criptografado bloqueado no Android — nenhuma conexão HTTP sem criptografia
• Tela de Monitoramento de Certificados — visualize o emissor do certificado, validade, impressão digital e histórico de alterações por endpoint (Configurações > Segurança > Monitoramento de Certificados)

Sincronização na Nuvem

O Where The Bleep funciona offline primeiro — funciona totalmente sem internet. A sincronização na nuvem é opcional e está disponível para subscritores Pro.

Como a Sincronização Funciona

• Todos os dados são armazenados localmente em SQLite — o app nunca exige internet
• webDocsSyncFeature2
• Os dados são criptografados antes de sair do seu dispositivo — o servidor só vê colunas criptografadas
• Detecção de conflitos — último a escrever prevalece em nível de registro, com conflitos registrados na trilha de auditoria de Eventos
• Propagação de exclusão — excluir no Dispositivo A remove o item no Dispositivo B
• Isolamento por usuário — a Segurança em Nível de Linha garante que você veja apenas seus próprios dados
• Listagens e vendas em marketplaces são incluídas na sincronização com informações pessoais do comprador criptografadas

Cópia de Segurança e Restauro

Exporte todo o seu banco de dados e imagens como um arquivo de backup criptografado. Defina uma senha de backup no momento da exportação e use-a para restaurar em qualquer dispositivo.

Conteúdo da Cópia de Segurança

• Base de dados SQLite completa
• Todas as imagens dos itens
• Criptografia AES-256-GCM com senha de backup definida pelo usuário (chave derivada por PBKDF2)
• Manifesto JSON para verificação da integridade do arquivo

Fluxo de Restauração

1. Acesse Configurações > Backup e Restauração
2. Toque em Importar Backup
3. Selecione o arquivo de backup usando o seletor de arquivos
4. Digite a senha de backup que você definiu quando criou o backup
5. Seus dados e imagens são restaurados

Exportação de Dados e Relatórios

Exporte os dados do seu inventário em múltiplos formatos para sinistros de seguro, registros pessoais ou portabilidade de dados.

Formatos de Exportação

Descrições com IA

Tire uma foto e deixe a IA gerar o título, a descrição e as etiquetas do seu item. A mesma capacidade de IA alimenta a geração de anúncios no marketplace. Utiliza a sua própria chave de API de qualquer um dos 8 fornecedores suportados.

Provedores de IA Compatíveis

Configuração

1. Acesse Configurações > Provedor de IA
2. Selecione o seu fornecedor preferido
3. Introduza a sua chave de API
4. Opcionalmente, altere o modelo predefinido
5. Ao adicionar ou editar itens, toque no botão de câmara com IA para utilizá-lo

Nota: A sua chave de API é armazenada apenas no dispositivo e nunca é enviada para os nossos servidores. Os pedidos de IA vão diretamente do seu dispositivo para o fornecedor.

Configurações

A tela de Configurações é seu centro de controle para criptografia, sincronização, configuração de IA, exportação de dados e gerenciamento de conta.

Seções de Configurações

Assinaturas

O Where The Bleep oferece um plano gratuito generoso com todos os recursos principais. O Pro desbloqueia sincronização na nuvem, backups automáticos e suporte prioritário.

Planos

As assinaturas são gerenciadas pela App Store (iOS) ou Google Play (Android). Você pode cancelar a qualquer momento nas configurações de assinatura do seu dispositivo.

What's Included with Pro

• Gira um negócio a sério — Square POS com pagamentos por leitor de cartões e cartão manual, Vendedores com PINs e permissões por operador, Recibos por Email em 18 idiomas, listagem no eBay e os quatro relatórios de inventário integrados (Nível de Stock, Movimento, Avaliação, Quebras)
• Traz a tua equipa — escolhe um nível de 5, 10 ou 20 dispositivos para que os teus vendedores, equipa de cozinha ou cossócios possam trabalhar cada um a partir do seu próprio dispositivo com o seu próprio login
• Funciona sem Wi-Fi — todos os ecrãs permanecem utilizáveis quando a rede falha, incluindo vendas a dinheiro, ajustes de inventário e contagens de stock; tudo é colocado em fila e sincronizado assim que voltares a ligar
• Sincronização na nuvem encriptada e backup automático — os teus dados são encriptados de ponta a ponta no dispositivo, replicados em todos os dispositivos emparelhados em segundos e continuamente guardados na nuvem para que possas restaurar mesmo que todos os dispositivos desapareçam