A documentação atual corresponde à versão 1.2.0. A versão 1.1.1 permanece disponível no seletor por compatibilidade com clientes que ainda utilizam aquela linha.
Manualv1.2.0
Como usar este manual
Fonte: Manual do Usuário 1.2.0
Os nomes de menus e botões aparecem em negrito no texto. As etapas partem da barra lateral do sistema. Quando uma ação não estiver visível, confirme o perfil do usuário: algumas funções são exclusivas do Administrador e o perfil Consulta não pode alterar dados.
Símbolo
Significado
Importante
Regra que evita perda de dados ou inconsistência.
Boa prática
Recomendação operacional para reduzir risco.
Resultado esperado
Como confirmar que o procedimento funcionou.
Manualv1.2.0
Destaques da versão 1 2 0
Fonte: Manual do Usuário 1.2.0
Os procedimentos da versão 1.0.0 continuam válidos. A versão 1.2.0 acrescenta novas formas de instalar, vender, imprimir, controlar caixa, produzir e receber.
Recurso
O que o usuário pode fazer
Instalação
Escolher os modos Normal ou Portátil e aceitar os Termos de Licença e Uso.
Licença
Consultar plano, validade, limites e dispositivo em Configurações.
Compras
Visualizar, imprimir e salvar pedidos de compra em PDF.
Vendas
Usar o PDV, dividir pagamentos, calcular troco e emitir comprovantes.
Caixa
Abrir e encerrar caixa, registrar suprimentos e sangrias e gerar o fechamento diário.
Produção
Cadastrar receitas e concluir ordens com custos, perdas e lotes.
Crediário
Criar parcelas, acompanhar contas a receber e registrar recebimentos.
Transformações
Converter produtos e unidades com fator, perdas, custos e genealogia.
Atalhos
Usar F2 para a ação contextual e Esc para fechar janelas e prévias.
Manualv1.2.0
1 Primeira configuração
Fonte: Manual do Usuário 1.2.0
Abra a Cubexa pelo atalho da área de trabalho ou menu Iniciar.
Na tela Configure seu espaço, informe o nome da empresa e o nome do administrador.
O sistema gera o usuário a partir do nome do administrador informado.
Crie uma senha exclusiva com pelo menos 8 caracteres e guarde-a em local seguro.
Conclua a configuração. O sistema abrirá o catálogo para o primeiro cadastro.
Boa prática: Crie um segundo Administrador para contingência e use contas Operador no trabalho diário. Não compartilhe a conta administrativa.
Manualv1.2.0
2 Entrar, sair e navegar
Fonte: Manual do Usuário 1.2.0
Informe usuário e senha na tela de acesso e selecione Entrar.
Use o menu lateral para Dashboard, Produtos, Movimentações, Vendas, Compras, Inventário, Lotes e reposição, Relatórios e Configurações.
Use Ctrl+K para localizar telas e ações. As opções visíveis recebem atalhos Ctrl+1, Ctrl+2 e seguintes. Use Esc para fechar buscas, modais, painéis e prévias.
Use F2 para executar a ação principal da tela atual, quando seu perfil e sua licença permitirem.
Ao terminar, selecione Sair no menu lateral.
Segurança: Sempre encerre a sessão em computadores compartilhados. Fechar somente a janela pode executar backup “Ao sair”, mas não substitui o hábito de sair da conta.
Não administra empresa, usuários, backup nem estrutura do catálogo.
Consulta
Gestão, auditoria ou conferência.
Somente leitura; não registra operações.
Manualv1.2.0
4 Configurar empresa
Fonte: Manual do Usuário 1.2.0
Acesse Configurações → Empresa.
Revise nome, razão social, CPF/CNPJ, endereço, telefone e e-mail.
Opcionalmente selecione logotipo PNG, JPG ou WebP de até 5 MB.
Defina moeda, casas decimais e formato de data.
Mantenha “Permitir estoque negativo” desativado, salvo decisão formal da empresa.
Selecione Salvar e confirme a mensagem de atualização.
Manualv1.2.0
5 Categorias e produtos
Fonte: Manual do Usuário 1.2.0
5 1 Criar uma categoria
Acesse Produtos e selecione Categorias.
Selecione Nova categoria.
Informe nome, descrição e cor; escolha a categoria-pai se desejar hierarquia.
Salve e feche o gerenciador.
5 2 Cadastrar um produto
Acesse Produtos → Novo produto.
Preencha nome, descrição, categoria, unidade, preço de venda, estoque mínimo, estoque ideal e localização física.
Ative controle por lote e/ou validade somente quando o produto exigir rastreabilidade.
Adicione uma ou mais variações. Para cada uma, informe nome, SKU e código de barras quando disponíveis.
Se houver estoque inicial, informe quantidade e custo. O sistema registrará uma entrada INITIAL_STOCK, preservando o histórico.
Adicione imagem local se necessário, revise e salve.
Importante: SKU e código de barras devem ser únicos. Depois de registrar operações, não “corrija” saldo editando o cadastro: use Movimentações ou Inventário.
5 3 Localizar, editar e arquivar
Busque por nome, SKU ou código de barras.
Filtre por categoria e situação do estoque; ordene por atualização, nome, saldo ou preço.
Abra o produto ou use o ícone Editar.
Arquive produtos fora de uso; o histórico permanece preservado.
Manualv1.2.0
6 Movimentações de estoque
Fonte: Manual do Usuário 1.2.0
6 1 Registrar entrada ou saída
Acesse Movimentações → Nova movimentação.
Escolha Entrada para adicionar saldo ou Saída para retirar.
Selecione o produto/variação, informe quantidade e motivo.
Em entradas, revise o custo unitário; informe data/hora se o lançamento não for imediato.
Quando houver controle por lote, selecione o lote ou informe código, fabricação e validade.
Registre uma nota com documento, responsável ou justificativa.
Selecione Registrar entrada ou Registrar saída e confirme o novo saldo no histórico.
6 2 Estornar uma movimentação
Abra a movimentação no histórico.
Confirme produto, quantidade, lote, custo e origem.
Selecione Registrar estorno.
Confirme. O sistema cria um lançamento inverso; o original continua visível.
Importante: Movimentações não são editadas nem apagadas. Use estorno para manter rastreabilidade.
Manualv1.2.0
7 Fornecedores e compras
Fonte: Manual do Usuário 1.2.0
7 1 Cadastrar fornecedor
Acesse Compras → aba Fornecedores → Novo fornecedor.
Preencha nome/razão social, documento, contatos, endereço, prazo e observações.
Associe produtos, códigos do fornecedor, preço, prazo e quantidade mínima quando aplicável.
Salve.
7 2 Criar pedido de compra
Acesse Compras → Nova compra.
Selecione fornecedor, data, previsão e situação inicial: Rascunho ou Pedido.
Adicione itens; selecione a variação e informe quantidade, custo unitário e desconto.
Informe desconto geral, frete e observações.
Revise o total e selecione Salvar compra.
7 3 Receber compra total ou parcialmente
Abra a compra com status apto a receber.
Selecione Receber itens.
Informe a quantidade efetivamente recebida de cada item; não ultrapasse o pedido.
Para itens controlados, informe lote, fabricação e validade.
Confirme o recebimento. O estoque e o custo médio serão atualizados somente agora.
Repita em outro momento se o recebimento foi parcial.
Manualv1.2.0
8 Clientes e vendas
Fonte: Manual do Usuário 1.2.0
8 1 Cadastrar cliente
Acesse Vendas → Clientes → Novo cliente.
Informe nome e, se disponíveis, CPF/CNPJ, telefone, WhatsApp, e-mail e observações.
Mantenha Cliente ativo marcado e salve.
8 2 Criar e finalizar venda
Acesse Vendas → Nova venda.
Selecione o cliente ou mantenha Consumidor não identificado.
Informe data/hora e forma de pagamento.
Adicione produtos, quantidades, preços e descontos por item.
Informe desconto geral, acréscimo e observações.
Selecione Salvar rascunho para continuar depois, ou Finalizar venda para validar e baixar o estoque.
Confirme o status Finalizada e o total.
8 3 Cancelar venda
Abra a venda.
Selecione Cancelar venda e confirme.
Se ela já estava finalizada, confira as movimentações de estorno que devolveram o estoque.
Lotes: Em produtos rastreados, a finalização consome automaticamente os lotes pelo critério FEFO: primeiro os que vencem antes.
Manualv1.2.0
9 Inventário físico
Fonte: Manual do Usuário 1.2.0
Evite compras, vendas e movimentações durante a contagem.
Acesse Inventário → Novo inventário.
Escolha o escopo: geral, categoria ou localização. Adicione observações e inicie.
Conte cada item fisicamente e registre a quantidade. Use busca por produto, SKU ou código de barras.
Em diferença positiva de produto rastreado, informe lote e validade exigidos.
Revise progresso, pendências e divergências.
Selecione Concluir inventário. O sistema cria entradas/saídas de ajuste.
Se o saldo tiver mudado desde o início, o sistema bloqueará a conclusão; revise o movimento e reinicie a contagem.
Boa prática: Faça inventários por localização ou categoria em ciclos menores. Isso reduz o tempo de paralisação e facilita investigar divergências.
Manualv1.2.0
10 Lotes, validade e reposição
Fonte: Manual do Usuário 1.2.0
Acesse Lotes e reposição para consultar lote, fornecedor, compra, fabricação, validade, saldo e histórico.
Priorize lotes vencidos, a vencer em 7 dias e a vencer em 30 dias. Não realize venda de item vencido sem política formal e avaliação aplicável.
Use a visão de integridade para comparar saldo dos lotes com o saldo total.
Revise sugestões quando o estoque cair abaixo do mínimo; a sugestão busca completar o nível ideal.
Agrupe sugestões por fornecedor e crie uma compra em rascunho; revise preço, prazo e quantidade antes de enviar.
Consulte produtos sem giro em 30, 60, 90 ou 180 dias para reduzir capital imobilizado.
Manualv1.2.0
11 Relatórios e exportações
Fonte: Manual do Usuário 1.2.0
Acesse Relatórios e selecione o relatório desejado.
Aplique filtros de período, categoria, produto, fornecedor e usuário conforme disponíveis.
Confira indicadores e linhas na tela.
Selecione PDF para documento paginado, XLSX para análise em planilha ou CSV para integração.
Abra o arquivo exportado e confirme título, período, totais e quantidade de registros.
Boa prática: Guarde relatórios gerenciais fora da pasta de backup do banco. Relatório exportado não substitui backup, pois não contém todas as relações e o histórico necessários à restauração.
Manualv1.2.0
12 Importar produtos por planilha
Fonte: Manual do Usuário 1.2.0
Acesse Relatórios e abra a importação de produtos. A ação requer Administrador.
Selecione um arquivo XLSX ou CSV.
Mapeie cada coluna do arquivo para o campo correspondente.
Revise a prévia e corrija cabeçalhos ou valores inválidos.
Escolha criar/atualizar conforme o identificador disponível (SKU ou código de barras).
Execute a importação e leia o resumo de criados, atualizados, ignorados e erros.
Revise uma amostra no catálogo antes de importar o próximo lote.
Manualv1.2.0
13 Usuários e auditoria
Fonte: Manual do Usuário 1.2.0
13 1 Criar ou alterar usuário
Acesse Configurações → Usuários.
Selecione Novo usuário ou Editar.
Informe nome, usuário, perfil, situação e senha. Nova senha deve ter ao menos 8 caracteres.
Salve. O sistema não permite desativar a própria conta nem o último administrador ativo.
13 2 Consultar auditoria
Acesse Configurações → Auditoria.
Pesquise por ação, módulo, registro ou usuário; use os filtros disponíveis.
Compare valores anteriores e novos quando exibidos.
Registre externamente o identificador, usuário e horário ao abrir um chamado.
Manualv1.2.0
14 Backup manual
Fonte: Manual do Usuário 1.2.0
Acesse Configurações → Backups.
Revise a pasta de destino. Se necessário, selecione Escolher pasta e aponte para uma pasta dedicada.
Selecione Criar backup agora.
Aguarde a mensagem “Backup criado” e confirme no histórico o status Concluído, horário e tamanho.
Abra a pasta no Windows e verifique se existe um arquivo Cubexa-backup-...-manual.sqlite3 com tamanho maior que zero.
Manualv1.2.0
15 Configurar backup automático em drive externo
Fonte: Manual do Usuário 1.2.0
Conecte o HD externo ou pendrive e confirme no Explorador de Arquivos que ele está acessível e possui espaço livre.
Crie uma pasta exclusiva, por exemplo E:\Backups-Cubexa. Evite usar a raiz da unidade.
Na Cubexa, entre como Administrador e acesse Configurações → Backups.
Selecione Escolher pasta e indique a pasta do drive externo.
Ative a rotina e escolha Diário para operação frequente, Semanal para baixa movimentação, ou Ao sair se o drive permanece conectado no encerramento.
Defina retenção. Recomendação inicial: 14 cópias diárias ou 8 semanais, ajustando ao volume e ao espaço.
Selecione Salvar configuração.
Crie um backup manual de teste e confirme o histórico e o arquivo no drive.
Ejete o drive com segurança somente depois de o backup terminar.
Atenção: A letra da unidade pode mudar ao reconectar. Se isso ocorrer, selecione novamente a pasta. Backups automáticos falharão se o drive estiver desconectado, sem espaço ou sem permissão de gravação.
Manualv1.2.0
16 Estratégia de backup recomendada 3 2 1
Fonte: Manual do Usuário 1.2.0
Mantenha pelo menos 3 cópias dos dados: o banco ativo e duas cópias de backup.
Use 2 mídias ou locais distintos: por exemplo, drive externo e armazenamento corporativo sincronizado.
Mantenha 1 cópia fora do local físico. Se usar nuvem/Drive, sincronize a pasta de backups concluídos, nunca a pasta do banco ativo.
Não trabalhe diretamente sobre um arquivo .sqlite3 em pasta sincronizada; sincronizadores podem copiar enquanto o arquivo está em uso.
Criptografe a unidade externa quando ela sair da empresa e controle quem possui a chave.
Registre o responsável e confira o histórico ao menos semanalmente.
Manualv1.2.0
17 Restaurar um backup
Fonte: Manual do Usuário 1.2.0
Pare vendas, compras, recebimentos e movimentações. Avise todos os usuários da janela de restauração.
Confirme que o arquivo é .sqlite3, provém da Cubexa e corresponde ao ponto desejado. Preserve uma cópia dele.
Entre como Administrador e acesse Configurações → Backups.
Selecione Restaurar backup, leia o aviso e confirme Selecionar e restaurar.
Escolha o arquivo. A Cubexa valida integridade e estrutura e cria automaticamente um PRE_RESTORE do estado atual.
Aguarde a conclusão. A sessão será encerrada. Entre novamente.
Confira empresa, usuários, produtos, saldo de amostra, últimas vendas/compras e auditoria.
Se algo estiver incorreto, pare as operações e contate o suporte informando o caminho do PRE_RESTORE.
Nunca faça: Não renomeie qualquer banco para “parecer” backup, não substitua o arquivo ativo manualmente e não restaure com usuários trabalhando.
Manualv1.2.0
18 Teste periódico de restauração
Fonte: Manual do Usuário 1.2.0
Frequência recomendada: trimestral e sempre antes de atualização relevante.
Faça o teste em ambiente controlado ou computador de homologação; não use produção apenas para “ver se funciona”.
Escolha uma cópia recente e registre data, arquivo, tamanho e responsável.
Após restaurar, valide login, contagens de cadastros, saldos de amostra, movimentações e um relatório.
Registre o resultado e corrija imediatamente falhas de rotina, destino ou retenção.
Manualv1.2.0
19 Recuperar senha do administrador
Fonte: Manual do Usuário 1.2.0
Na tela de acesso, selecione a opção de recuperação de senha.
Confirme os dados solicitados da empresa.
Informe a nova senha seguindo o mínimo de 8 caracteres.
Conclua. O sistema cria um backup preventivo antes de alterar a credencial.
Entre com a nova senha. Se ocorrer bloqueio por tentativas repetidas, aguarde o período informado antes de tentar novamente.
Manualv1.2.0
20 Rotina operacional sugerida
Fonte: Manual do Usuário 1.2.0
Frequência
Verificações
Diária
Alertas do Dashboard; compras a receber; vendas pendentes; lotes vencendo; último backup concluído.
Semanal
Estoque baixo; sugestões de reposição; itens sem giro; falhas de backup; usuários ativos.
Mensal
Inventário cíclico; divergências; relatórios de margem e giro; espaço livre do computador e drive.
Trimestral
Teste de restauração; revisão de acessos; cópia externa/off-site; atualização do manual.
Manualv1.2.0
21 Solução de problemas
Fonte: Manual do Usuário 1.2.0
Situação
Ação segura
Saída bloqueada
Confira saldo e lotes. Não habilite estoque negativo apenas para contornar o erro.
Inventário não conclui
Preencha contagens pendentes; se houve movimento durante a contagem, investigue e reinicie.
Backup falhou
Reconecte a unidade, confirme pasta, espaço e permissão; execute novo backup manual.
Arquivo não restaura
Use um .sqlite3 original da Cubexa; não force a importação.
Produto duplicado na importação
Revise SKU/código de barras e mapeamento antes de repetir.
Tela sem ação de edição
Confirme se o perfil é Operador/Administrador e se a ação exige Administrador.
Saldo incorreto
Consulte movimentos, estornos e auditoria; faça ajuste documentado ou inventário.
Manualv1.2.0
22 Checklist de encerramento diário
Fonte: Manual do Usuário 1.2.0
Rascunhos importantes salvos e documentos recebidos/finalizados corretamente.
Nenhum inventário iniciado por engano ou deixado sem responsável.
Alertas críticos revisados.
Backup automático concluído ou backup manual criado.
Drive externo mantido conectado até o fim da cópia e depois ejetado com segurança, quando aplicável.
Sessão encerrada.
Manualv1.2.0
23 Instalar e atualizar a versão 1 2 0
Fonte: Manual do Usuário 1.2.0
Execute Cubexa-Setup-1.2.0.exe.
Leia as boas-vindas e os Termos de Licença e Uso. Marque o aceite para habilitar o botão Próximo.
Escolha o usuário do Windows e a pasta de instalação.
Selecione Normal para manter os dados no perfil do Windows ou Portátil para manter os dados comerciais em CubexaData junto do programa.
Conclua a instalação. Em uma atualização, abra Configurações e Sobre e confirme a versão 1.2.0.
Importante. No modo Portátil, não remova a unidade nem renomeie CubexaData com a Cubexa aberta. Use a remoção segura e mantenha uma cópia de backup separada.
Manualv1.2.0
24 Consultar e administrar a licença
Fonte: Manual do Usuário 1.2.0
Acesse Configurações e Licença.
Confira plano, estado, validade, consumo de produtos e usuários e dispositivo atual.
Para ativar uma licença paga, informe a chave fornecida e conclua a ativação com internet disponível.
Use Revalidar quando orientado pelo suporte. Uma licença local válida continua operando offline.
Use Desativar dispositivo somente quando precisar transferir a licença ou liberar a vaga. Confirme a ação.
Se a licença não permitir escrita, a Cubexa mantém consultas, relatórios, exportações e backups. Regularize a licença para voltar a registrar operações.
Manualv1.2.0
25 Gerar pedido de compra e configurar impressão
Fonte: Manual do Usuário 1.2.0
Abra Compras e selecione um pedido.
Revise fornecedor, situação, itens, recebimentos, valores e observações.
Abra a prévia do pedido A4 e use Salvar PDF ou Imprimir. Cancelar a impressão não altera a compra.
Para calibrar o dispositivo, acesse Configurações e Impressão. Escolha A4, 58 mm, 80 mm ou Personalizado, impressora, margens, escala, fonte, logo e compatibilidade de caracteres.
Faça uma impressão de teste e salve o perfil local.
Manualv1.2.0
26 Operar o PDV e emitir comprovante
Fonte: Manual do Usuário 1.2.0
Acesse Vendas e abra o PDV. Se não houver caixa aberto, siga o direcionamento para abrir uma sessão.
Busque por nome, SKU ou código de barras. Para várias unidades, use quantidade*código, como 5*7890000000000.
Revise quantidade, preço, desconto e avisos de falta de estoque.
Identifique o cliente quando necessário e selecione uma ou mais formas de pagamento.
Em dinheiro, informe o valor recebido e confira o troco.
Selecione Finalizar. O sistema revalida estoque, lotes, pagamentos e caixa na transação.
No pop-up pós-venda, imprima, salve o comprovante ou saia. Falha de impressão não desfaz a venda concluída.
Manualv1.2.0
27 Controlar caixa e fechamento diário
Fonte: Manual do Usuário 1.2.0
Acesse Vendas e Caixa e fechamento.
Abra o caixa e informe o saldo inicial. A sessão pertence ao operador neste computador.
Registre Suprimento para entrada avulsa ou Sangria para retirada de dinheiro, sempre com motivo.
Use o PDV. Vendas e cancelamentos em dinheiro atualizam o caixa na mesma transação.
No encerramento, informe a contagem física e justifique qualquer diferença.
Revise o histórico e gere o fechamento da competência. Administradores podem revisar ou reabrir com registro de auditoria.
Salve o PDF gerencial e, se configurado, acompanhe o envio por e-mail.
Manualv1.2.0
28 Configurar o envio de fechamento por e mail
Fonte: Manual do Usuário 1.2.0
Entre como Administrador e acesse Configurações e E-mail.
Informe servidor SMTP, porta, TLS, usuário, senha, remetente e destinatários.
Teste a conexão e salve. A senha fica protegida pelo armazenamento seguro do Windows.
No fechamento diário, solicite o envio. Falhas temporárias entram na fila de nova tentativa sem repetir mensagens confirmadas.
Manualv1.2.0
29 Cadastrar receita e concluir produção
Fonte: Manual do Usuário 1.2.0
Acesse Manufatura e cadastre uma receita com produto de saída, rendimento, vigência e insumos.
Crie uma ordem em Rascunho e revise a necessidade calculada.
Emita a ordem. A emissão valida os dados, mas não reserva estoque.
Na conclusão, informe produção efetiva, perdas, custos adicionais e lote do produto acabado quando exigido.
Revise a prévia e confirme. O sistema consome insumos por FEFO e calcula o custo real na mesma transação.
Consulte o histórico e a exportação JSON. Correções usam estorno integral quando permitido.
Manualv1.2.0
30 Vender e receber pelo crediário
Fonte: Manual do Usuário 1.2.0
Cadastre ou abra um cliente ativo e configure o limite quando necessário.
No PDV, identifique o cliente e informe entrada, quantidade de parcelas e primeiro vencimento.
Revise vencimentos e valores. O sistema distribui os centavos entre as primeiras parcelas.
Se o saldo ultrapassar o limite, um Administrador deve autorizar e justificar.
Finalize a venda e abra o crediário do cliente para consultar parcelas abertas, parciais, pagas, vencidas ou canceladas.
Registre o recebimento. Dinheiro exige caixa aberto; PIX e cartões não alteram o caixa físico.
Para corrigir um recebimento, estorne o lançamento integral e registre o valor correto.
Manualv1.2.0
31 Transformar produtos e unidades
Fonte: Manual do Usuário 1.2.0
Acesse Transformações e escolha um perfil ou crie uma nova versão.
Selecione variantes de origem e destino diferentes.
Informe quantidade de origem, fator, perda técnica, baixa explícita de valor e custo adicional quando houver.
Revise a quantidade líquida e o custo transferido. Custo zero exige confirmação explícita.
Confira os lotes consumidos por FEFO e a validade herdada. O sistema não estende a validade silenciosamente.
Confirme. Saldo insuficiente bloqueia a operação mesmo quando o estoque negativo estiver habilitado.
Consulte o documento, a genealogia e a exportação JSON. O estorno integral depende da ausência de operações posteriores.
Manualv1.2.0
32 Boas práticas da versão 1 2 0
Fonte: Manual do Usuário 1.2.0
Crie e teste um backup antes de atualizar. Depois, confirme a versão em Sobre e faça uma operação de amostra.
No modo Portátil, use uma unidade confiável e remoção segura. Portabilidade não substitui backup.
Abra um caixa por operador e computador. Não compartilhe sessões e justifique suprimentos, sangrias e diferenças.
Calibre os comprovantes em cada computador e mantenha um perfil A4 para contingência.
Revise receitas e perfis de transformação antes de emitir documentos. Alterações futuras criam uma nova versão sem apagar o histórico.
Concilie contas a receber e parcelas vencidas diariamente. Devoluções externas devem ocorrer no meio de pagamento original.
Nota de identidade: O nome comercial é Cubexa. O arquivo nexostock.sqlite3, a bridge window.nexostock e o App ID com.nexostock.desktop foram preservados por compatibilidade; não devem ser renomeados em manutenção corretiva sem plano de migração.
Técnicav1.2.0
Destaques da versão 1 2 0
Fonte: Documentação Técnica 1.2.0
A versão 1.2.0 mantém o catálogo, o estoque, as compras, as vendas, os inventários, os relatórios e a administração da versão 1.0.0. A atualização amplia a operação com os recursos abaixo e executa as migrações 009 a 016 após um backup verificado.
Área
Mudança incorporada
Instalação e dados
Modos Normal e Portátil, preservação de dados, bloqueio concorrente da pasta e validação da unidade.
Licenciamento
Demo, Básico e Profissional, certificados Ed25519, operação offline e modo somente leitura.
Documentos
Pedido de compra A4 com histórico, prévia, PDF e impressão; perfis A4, 58 mm, 80 mm e personalizado.
Vendas
PDV, pagamentos divididos, troco e comprovantes não fiscais com proteção contra finalização repetida.
Caixa
Caixa por operador e computador, suprimento, sangria, encerramento contado, fechamento diário, PDF e SMTP.
Novos módulos
Manufatura, crediário e transformação rastreável entre produtos e unidades.
Qualidade
Atalho F2 contextual, Esc nas janelas, correções de foco e sessão; 307 testes aprovados em 38 arquivos.
Técnicav1.2.0
Sumário executivo
Fonte: Documentação Técnica 1.2.0
A Cubexa é um sistema de controle de estoque para microempresas, distribuído como aplicativo Electron e projetado para funcionar integralmente no computador do cliente. A interface React não acessa o sistema de arquivos nem o banco diretamente. Todas as operações atravessam uma bridge tipada do preload, controladores IPC e serviços de aplicação que aplicam autorização e transações SQLite.
Catálogo com categorias, produtos, variações, SKU, código de barras, preços, níveis de estoque, imagens, lote e validade.
Movimentação central e imutável, compras e recebimentos, vendas e cancelamentos, inventários, lotes, reposição e relatórios.
Administração local com usuários e perfis, auditoria, configurações, backup/restauração e recuperação de senha.
Sem dependência de internet para a operação normal; os dados permanecem no perfil local do Windows.
Técnicav1.2.0
1 Arquitetura e tecnologias
Fonte: Documentação Técnica 1.2.0
Componente
Tecnologia / responsabilidade
Renderer
React 19 + TypeScript strict; UI, acessibilidade e estado de tela.
Desktop
Electron 37; janela, ciclo de vida, diálogos e empacotamento.
Bridge
Preload com contextIsolation e API mínima window.nexostock.
Aplicação
Serviços TypeScript; autorização, validações e limite transacional.
Persistência
SQLite via better-sqlite3; migrações versionadas.
Build
Vite 7 e Electron Builder/NSIS.
Exportação
ExcelJS para XLSX; geradores locais para PDF e CSV.
Testes
Vitest com 307 testes aprovados em 38 arquivos na liberação 1.2.0.
Fluxo lógico: Renderer → preload tipado → handlers IPC → serviços de aplicação → regras de domínio → repositórios/SQLite. Erros técnicos são convertidos em códigos estáveis e mensagens compreensíveis antes de retornar à interface.
Técnicav1.2.0
2 Estrutura do repositório
Fonte: Documentação Técnica 1.2.0
Diretório
Conteúdo
src/
Aplicação React, componentes, estilos e features.
electron/
Main, preload, IPC, contratos, serviços, banco e migrações.
tests/
Testes automatizados de catálogo, estoque, compras, vendas, inventário, relatórios, administração e erros.
docs/
Arquitetura e checklist de release.
resources/
Ícones e recursos de empacotamento.
release/
Instaladores e artefatos gerados.
Técnicav1.2.0
3 Banco de dados e integridade
Fonte: Documentação Técnica 1.2.0
Arquivo: data/nexostock.sqlite3 dentro do userData do Electron. Em instalações novas no Windows, o diretório base é %APPDATA%\Cubexa.
Ao detectar a identidade anterior, dados e imagens de %APPDATA%\NexoStock são copiados para o novo local sem apagar a origem.
PRAGMAs: foreign_keys habilitado, journal_mode WAL, synchronous NORMAL e busy_timeout de 5 segundos.
Migrações são transacionais e registradas em schema_migrations. A versão 1.2.0 inclui as migrações 001 a 016 e cria um backup verificado antes de migrar uma base existente.
Valores monetários são inteiros em centavos; quantidades são inteiros em milionésimos da unidade; datas são ISO 8601 UTC.
Movimentos lançados possuem proteção contra UPDATE e DELETE. Correções criam um movimento inverso relacionado.
Técnicav1.2.0
4 Modelo de dados essencial
Fonte: Documentação Técnica 1.2.0
Grupo
Entidades e função
Organização
companies, users, settings e audit_logs.
Catálogo
categories, products, product_variants e product_suppliers.
Estoque
stock_balances, stock_movements e lots.
Compras
suppliers, purchases e purchase_items.
Vendas
customers, sales e sale_items.
Inventário
inventories e inventory_items.
Continuidade
backup_history e schema_migrations.
Invariante crítica: A engine de movimentação é a única autoridade para alterar stock_balances e saldos de lotes. Compras alteram estoque somente no recebimento; vendas, somente na finalização; inventários, somente na conclusão.
Técnicav1.2.0
5 Regras de negócio críticas
Fonte: Documentação Técnica 1.2.0
Saídas acima do saldo são bloqueadas, exceto quando a política administrativa de estoque negativo está habilitada.
O custo médio ponderado é recalculado em entradas com custo e congelado nos itens de vendas concluídas.
Produtos rastreados por lote exigem lote nas operações aplicáveis; baixas automáticas utilizam FEFO, priorizando a menor validade.
Pedidos podem ser recebidos parcialmente, mas não acima do pedido. Documentos recebidos não são reeditados como se fossem rascunhos.
Vendas em rascunho não afetam o saldo. O cancelamento de venda concluída devolve estoque por estornos vinculados.
O inventário captura uma fotografia do saldo; sua conclusão falha se houver itens sem contagem ou se o saldo mudar durante a contagem.
Técnicav1.2.0
6 Segurança e perfis
Fonte: Documentação Técnica 1.2.0
Perfil
Capacidade principal
Administrador
Configura empresa e política de estoque; gerencia catálogo, usuários, auditoria, importação e backups; também opera os demais módulos.
Operador
Registra movimentos, compras, vendas, recebimentos e inventários; não altera configurações administrativas nem o catálogo estrutural.
Consulta
Acesso somente leitura a telas e registros; ações de escrita são ocultadas e bloqueadas no processo principal.
Senhas usam hash scrypt; comparações são resistentes a timing.
Sessão autenticada é mantida somente em memória.
Tentativas repetidas de login causam bloqueio temporário.
nodeIntegration desativado; contextIsolation e sandbox ativados.
Navegação externa é bloqueada; somente HTTPS pode ser aberto pelo sistema.
É proibido desativar o próprio usuário autenticado ou remover o último administrador ativo.
Técnicav1.2.0
7 Backup e restauração implementação
Fonte: Documentação Técnica 1.2.0
Item
Comportamento
Frequências
Diário, semanal ou ao sair; habilitação configurável.
Destino
Pasta selecionada pelo administrador; se ausente, subpasta backups do userData.
Arquivo
Cubexa-backup-<data-hora>-<tipo>.sqlite3.
Validação
Extensão .sqlite3, integrity_check e presença de companies, users e schema_migrations.
Evidência
Histórico com status, caminho, tamanho, horário e checksum SHA-256.
Retenção
1 a 100 cópias; arquivos antigos do mesmo diretório são removidos, exceto PRE_RESTORE.
Restauração
Cria PRE_RESTORE, encerra sessão, fecha banco, substitui arquivo, reabre, configura e executa migrações.
Falha
Tenta repor o PRE_RESTORE e informa seu caminho ao operador.
Limite operacional: A rotina integrada grava em um único diretório configurado. A estratégia 3-2-1 deve ser completada com uma segunda cópia automatizada ou procedimento externo, sem manipular o banco em uso.
Técnicav1.2.0
8 Instalação, build e release
Fonte: Documentação Técnica 1.2.0
Instale Windows 10/11, Node.js 22+, npm 10+ e ferramentas C++ quando o módulo nativo não tiver binário compatível.
Execute npm install. O postinstall reconstrói better-sqlite3 para a versão do Electron.
Execute npm run typecheck e npm run test.
Execute npm run build:renderer para validar a interface, ou npm run build para gerar o diretório empacotado.
Execute npm run dist:win para gerar o instalador NSIS em release/.
Distribua Cubexa-Setup-1.0.0.exe. Não distribua somente release/win-unpacked/Cubexa.exe, pois ele depende dos demais recursos do diretório.
Técnicav1.2.0
9 Operação de desenvolvimento
Fonte: Documentação Técnica 1.2.0
Comando
Uso
npm run dev
Aplicativo desktop com banco local e runtime de licença.
$env:CUBEXA_DEMO_DATA='1'; npm run dev
Dados demonstrativos, somente desenvolvimento e apenas se não houver empresa.
npm run dev:web
Prévia no navegador com snapshot em memória e sem banco.
npm run check
Typecheck seguido dos testes.
npm run dist:win
Instalador Windows NSIS.
Técnicav1.2.0
10 Testes e critérios de aceite
Fonte: Documentação Técnica 1.2.0
Executar as suites de database, errors, catalog, movements, purchasing, sales, inventory, stock-control, reporting, administration e branding.
Validar migração de uma base anterior em cópia descartável.
Testar backup manual, backup agendado e restauração com arquivo válido e inválido.
Confirmar permissões nas duas camadas: visibilidade da UI e recusa no IPC/serviço.
Realizar smoke test de criação de produto → compra/recebimento → venda → inventário → relatório.
Gerar e conferir PDF, XLSX e CSV com os mesmos filtros exibidos na tela.
Técnicav1.2.0
11 Diagnóstico e suporte
Fonte: Documentação Técnica 1.2.0
Sintoma
Verificação inicial
Aplicativo não inicia
Integridade do SQLite, permissões no userData e logs de inicialização.
Banco ocupado
Outra instância/processo, antivirus ou sincronizador operando no arquivo ativo; aguardar busy_timeout.
Saldo inesperado
Histórico de movimentos, estornos, lotes e auditoria; nunca editar o SQLite manualmente.
Backup falha
Existência/permissão da pasta, espaço livre, disponibilidade da unidade externa e histórico de backup.
Restauração recusada
Extensão, integrity_check e tabelas mínimas esperadas.
Usuário bloqueado
Aguardar bloqueio temporário ou usar recuperação local do administrador conforme procedimento autorizado.
Técnicav1.2.0
12 Manutenção e evolução
Fonte: Documentação Técnica 1.2.0
Preservar compatibilidade com nomes internos legados até existir migração formal e testada.
Toda alteração de schema deve ser uma nova migração idempotente e transacional; nunca editar uma migração já publicada.
Novos fluxos de estoque devem chamar a engine central, não atualizar saldos diretamente.
Novos canais IPC devem ser mínimos, tipados, validados e autorizados no processo principal.
Antes de atualizar um cliente, criar backup, registrar a versão e manter o instalador anterior durante a janela de validação.
Técnicav1.2.0
Apêndice A Checklist de release 1 2 0
Fonte: Documentação Técnica 1.2.0
Versão de package.json e nome do artefato conferidos.
Typecheck e testes aprovados.
Migração e primeira inicialização validadas.
Perfis e recuperação de senha testados.
Backup/restauração testados em diretório local e unidade externa.
Instalador assinado/verificado conforme processo da organização.
Manual de uso e documentação técnica entregues junto ao instalador.
Técnicav1.2.0
13 Licenciamento e capacidades comerciais
Fonte: Documentação Técnica 1.2.0
A Demo tem 90 dias. O estado local pode ser sincronizado sem ampliar o prazo por reinstalação ou conexão tardia.
Os planos Demo e Básico aplicam limites de produtos e usuários. O Profissional libera capacidades adicionais, incluindo crediário e e-mail de fechamento.
O certificado é assinado com Ed25519, vinculado ao hash do dispositivo e validado antes da persistência. A chave privada não acompanha o desktop.
Expiração, suspensão ou revogação preservam login, consultas, relatórios, exportações e backups. Os serviços de aplicação bloqueiam novas gravações.
O banco de licença fica separado do banco comercial e não é transportado por backups de estoque.
Técnicav1.2.0
14 Instalação e armazenamento
Fonte: Documentação Técnica 1.2.0
No modo Normal, os dados comerciais ficam no perfil do Windows. No modo Portátil, ficam em CubexaData junto do aplicativo.
Licença e perfis locais de dispositivo permanecem no Windows nos dois modos.
O marcador portátil, a sentinela de dados e o bloqueio de pasta impedem criação silenciosa de outra base e uso simultâneo da mesma pasta.
Antes de aplicar migrações, a API SQLite cria um snapshot que inclui transações confirmadas no WAL, executa integrity_check e grava um manifesto SHA-256.
Atualização e desinstalação preservam dados. A remoção de um dispositivo portátil durante a operação interrompe o acesso e exige reconexão antes de reabrir.
Técnicav1.2.0
15 Documentos impressão PDV e caixa
Fonte: Documentação Técnica 1.2.0
Pedidos e comprovantes usam snapshots versionados para preservar o conteúdo histórico depois de alterações cadastrais.
O PDV finaliza venda, estoque, lotes, pagamentos, caixa, comprovante e auditoria na mesma transação. request_id impede repetição da operação.
Pagamentos podem ser divididos. O troco considera o valor recebido em dinheiro e requer caixa aberto no computador do operador.
Perfis de impressão são locais ao dispositivo. PDF funciona offline e sem impressora; a impressão depende do driver e da confirmação do usuário.
O fechamento diário usa competência explícita, revisão auditada, PDF gerencial e fila SMTP com retry e proteção contra duplicação.
Técnicav1.2.0
16 Manufatura crediário e transformações
Fonte: Documentação Técnica 1.2.0
Manufatura usa receitas versionadas e ordens em Rascunho, Emitida, Concluída ou Cancelada. A conclusão consome insumos por FEFO e calcula o custo real.
Crediário exige cliente ativo, registra entrada, parcelas, vencimentos, recebimentos e estornos. Operações de escrita dependem do plano Profissional.
Transformações convertem uma variante em outra com fator, perda técnica, baixa explícita de valor e custo adicional.
Produção e transformação bloqueiam saldo insuficiente mesmo quando a política geral permite estoque negativo.
Os módulos preservam movimentos, lotes, custos e genealogia para auditoria e estorno integral.
Técnicav1.2.0
Apêndice B Validação da versão 1 2 0
Fonte: Documentação Técnica 1.2.0
TypeScript Desktop e Worker, renderer, main e preload compilados no pacote final.
307 testes aprovados em 38 arquivos.
Migração de base 1.1.1 das versões 008 a 016 validada nos modos Normal e Portátil, com dados, imagens, saldos e chaves estrangeiras preservados.
Fluxo do instalador, aceite obrigatório dos termos, reinstalação e desinstalação validados em dados isolados.
Instalador Windows x64, checksum SHA-256 e relatório de validação gerados em release.
Impressão física e variedade de hardware permanecem como itens de homologação no ambiente de destino.