Como o sistema funciona
O Contagem Cíclica não trabalha como um inventário com início e fim. Ele mantém uma base permanente de materiais e localizações, calcula quando cada item deve voltar a ser contado, gera tarefas para os dias programados e registra cada contagem como um evento rastreável. Quando uma posição confere, o material avança para a próxima data conforme sua frequência; quando diverge, o caso fica aberto para tratamento.
Este documento descreve somente os recursos já implementados até a V0.5. A primeira divergência já é registrada automaticamente, porém a tela de recontagem e tratamento da Controladoria será ativada na V0.6. Histórico analítico e relatórios avançados entram nas versões seguintes.
O caminho completo, em seis fases
Base
Preparar depósitos, localizações, materiais e vínculos físicos.
Regras
Definir frequência por ABC, criticidade e prioridade.
Plano
Definir unidade, escopo, período, dias e limite diário.
Programar
Gerar tarefas vencidas e distribuir entre conferentes.
Contar
Confirmar localização, material e informar a quantidade física.
Acompanhar
Monitorar execução, divergências e a próxima contagem.
O ciclo em uma frase
Manter a base atualizada → aplicar as regras → gerar a agenda → distribuir as tarefas → contar às cegas → avançar a próxima data e repetir continuamente.
Como acessar
O sistema abre dentro do painel administrativo do WordPress, mas em tela cheia, sem o menu padrão do WordPress. Cada pessoa entra com seu próprio login e senha. O perfil do usuário define as permissões de execução, programação, gestão e consulta.
A segurança está no servidor
A interface esconde os botões que o perfil não pode usar, mas a proteção principal está na API. Uma chamada sem a capability necessária é recusada pelo servidor. A quantidade sistêmica de referência também não é enviada para a tela de contagem.
Os cinco perfis
A V0.5 trabalha com quatro perfis próprios do Contagem Cíclica e o Administrador padrão do WordPress.
Conferente
Executa as tarefas de campo atribuídas ao seu usuário.
- Minha Contagem, QR Code e Entrada Manual
- Registra a primeira contagem cega
- Não altera base nem programação
Supervisor
Planeja a operação e pode também executar contagens.
- Cria planos, regras e programações
- Distribui tarefas aos conferentes
- Acompanha Dashboard e filas
Controladoria
Acompanha, programa e terá a governança das divergências.
- Tudo da operação e programação
- Capability de divergências já reservada
- Tratamento operacional entra na V0.6
Dashboard
Perfil de consulta, sem capacidade de gravar a operação.
- Acesso de leitura e indicadores
- Sem execução de contagem
- Sem programação ou alteração da base
Administrador
Configura a base, mantém cadastros e possui acesso total.
- Materiais, depósitos e localizações
- Importação e vínculos Material × Localização
- Todas as permissões do sistema
Quem pode fazer o quê
| Módulo / ação | Conferente | Supervisor | Controladoria | Dashboard | Admin |
|---|---|---|---|---|---|
| Consultar Dashboard e base | ● | ● | ● | ● | ● |
| Executar contagem | ● | ● | ● | — | ● |
| Planos, regras e programações | — | ● | ● | — | ● |
| Distribuir / atribuir tarefas | — | ● | ● | — | ● |
| Alterar materiais, depósitos e localizações | — | — | — | — | ● |
| Importar base | — | — | — | — | ● |
| Tratar divergências | — | — | V0.6 | — | V0.6 |
O menu, por grupos
Base & cadastros
A contagem cíclica depende de uma base permanente: o material precisa existir, estar associado ao depósito correto e possuir ao menos uma localização ativa. O sistema trata o estoque por posição, permitindo que o mesmo material exista em mais de um endereço físico.
Cadastre a equipe
Na V0.5, os usuários continuam sendo contas do próprio WordPress. O Administrador cria ou edita cada usuário e atribui um dos perfis do Contagem Cíclica. Para entrar na distribuição automática, a pessoa precisa ter capacidade de execução — normalmente Conferente, Supervisor ou Controladoria.
Estrutura física: depósito → localização → material
Depósito
Armazém ou área lógica da unidade.
Localização
Endereço físico onde a equipe vai contar.
Material
Item permanente vinculado a uma ou mais posições.
Cadastre os depósitos
Informe a unidade, código, nome e status. O código é importante porque participa do QR padrão de localização. Uma mesma sigla de posição pode existir em depósitos diferentes sem conflito quando o QR completo é usado.
Cadastre os endereços físicos
Escolha o depósito, informe o código da posição e, opcionalmente, uma descrição. Se o campo QR Code ficar vazio, o sistema utiliza o padrão LOC|DEPÓSITO|LOCALIZAÇÃO. Também é possível gravar exatamente o código já usado no ERP ou em uma etiqueta existente.
Cadastre os materiais
Informe código, descrição, UM, classe ABC, criticidade, frequência, custo, próxima contagem e QR. Se o QR ficar vazio, o padrão é MAT|CÓDIGO. O código do material é único dentro da empresa.
Vincule o material às posições
Abra as localizações do material, selecione a posição e informe o estoque sistêmico daquela posição. Um vínculo pode ser marcado como Principal. Quando existem vínculos ativos, o estoque total do material é recalculado pela soma das posições.
Sem localização, não há tarefa
Um material vencido sem localização ativa não é programado com endereço vazio. O gerador informa quantos itens ficaram fora por falta de localização para que a base seja corrigida antes da contagem.
Carga de Dados por XLSX ou CSV
A forma mais rápida de montar a base é pelo módulo Carga de Dados. O arquivo é lido no próprio navegador, normalizado e enviado à API em lotes de 250 linhas. Isso reduz risco de timeout e permite acompanhar o progresso da importação.
Baixe o modelo e prepare o arquivo
Use Baixar modelo CSV para partir dos cabeçalhos reconhecidos. O leitor também entende aliases comuns, como Item, SKU, Almoxarifado, Locação, Saldo e Quantidade.
Selecione a unidade e valide
Escolha a unidade de destino, arraste o XLSX/CSV e clique em Validar arquivo. O sistema mostra linhas lidas, válidas, erros e uma prévia das primeiras linhas normalizadas.
Importe em lotes
Com a opção de criação automática marcada, depósitos e localizações inexistentes são criados durante a carga. Materiais existentes são atualizados; novos códigos são incluídos; e os vínculos Material × Localização recebem o estoque informado.
A carga é incremental
A importação atual trabalha como inclusão/atualização da base. Ela não possui um modo “apagar tudo e substituir”. Isso protege o histórico operacional e evita remover registros já utilizados pelo programa de contagem.
Regras de frequência
As regras dizem ao sistema com que frequência cada material deve ser contado. Elas podem considerar a classe ABC, a criticidade ou a combinação dos dois critérios.
Regras iniciais já cadastradas
Na instalação, o sistema cria como referência: Classe A = 7 dias, Classe B = 30 dias e Classe C = 90 dias. Esses valores podem ser editados para refletir a política da empresa.
Como o sistema escolhe a regra
Menor número de prioridade vence
Prioridade 5 é avaliada antes da prioridade 10. Use números menores para regras mais importantes.
Regra específica pode sobrepor a geral
Exemplo: “Classe A = 7 dias” pode coexistir com “Classe A + Crítica = 3 dias”. Dê prioridade maior à regra crítica.
Aplicar regras atualiza os materiais
O botão Aplicar regras aos materiais grava a frequência efetiva e, quando já existe última contagem, recalcula também a próxima data.
Crie ou revise as regras
Defina nome, classe ABC, criticidade, frequência em dias, prioridade e status. Deixe ABC ou criticidade em “Todas” quando a regra não precisar restringir aquele critério.
Propague a política para a base
Depois de ajustar as regras, aplique-as. O sistema avalia todos os materiais ativos e atualiza aqueles que correspondem às regras ativas.
Plano de Contagem & Agenda
O plano é a regra operacional do período. Ele define onde o programa vale, em quais datas pode gerar tarefas e qual a capacidade máxima por dia. A Agenda cruza o plano com as próximas datas dos materiais para mostrar o que vence e o que já foi efetivamente programado.
Campos do plano
Defina o escopo
Dê um nome claro, escolha a unidade e, se desejar, limite o plano a um depósito. Defina o período, o número máximo de tarefas por dia e os dias da semana em que a operação pode ser programada.
Decida como iniciar uma base nova
Na primeira implantação, alguns materiais ainda não terão “Próxima Contagem”. Com esta opção marcada, eles podem entrar na geração inicial; depois, a própria execução passa a alimentar o calendário.
Leia a agenda antes de gerar
A Agenda mostra uma janela de 14 dias com Vencem, Planejadas e Concluídas. O cartão de resumo também mostra quantos itens já estavam vencidos antes do início da janela.
Vencimento não é tarefa duplicada
Um material pode continuar aparecendo como vencido enquanto possui uma tarefa aberta, mas o gerador bloqueia uma segunda tarefa para o mesmo Material × Localização até que o ciclo anterior saia dos estados abertos.
Programação & distribuição das tarefas
A programação transforma vencimentos em trabalho executável. Cada tarefa representa uma combinação específica de Material × Localização para uma data. O gerador é idempotente: você pode executar novamente sem criar cópias da mesma tarefa.
Regras do gerador
Vencidos entram primeiro
O sistema ordena pela próxima data, depois pela classe ABC, valor e código.
O limite é um teto do dia
Se o plano permite 100 tarefas e já existem 80, uma nova geração só poderá acrescentar até 20.
Tarefa aberta bloqueia duplicação
O mesmo Material × Localização não entra novamente enquanto houver tarefa não concluída/aprovada/cancelada.
Sem localização fica fora
O sistema não cria tarefa com posição zero. A quantidade de materiais sem endereço é informada ao final.
Abra “Gerar programação”
Selecione o plano e a data. Opcionalmente, informe um limite para aquela geração. A data precisa estar dentro da vigência e em um dia da semana habilitado pelo plano.
Confira a fila planejada
A lista mostra prioridade, material, descrição, depósito, localização, ABC, responsável, vencimento e status. Use esta tela para conferir se o lote está pronto para ser distribuído.
Atribua uma tarefa individualmente
Em uma tarefa ainda Pendente, o Supervisor/Controladoria pode clicar em Alterar e escolher um usuário com capacidade de execução.
Use o rodízio automático
Selecione dois ou mais conferentes. Somente tarefas pendentes ainda não atribuídas entram no rodízio, respeitando a prioridade da programação.
Estados da tarefa na V0.5
Tarefa criada e disponível para atribuição/início.
O operador iniciou a tarefa; data, hora e usuário ficam registrados.
A quantidade física foi igual à referência da posição.
A diferença foi registrada e aguarda a recontagem da V0.6.
Execução da contagem
Na V0.5, a execução registra a primeira contagem de cada tarefa. Ela é cega, imutável e comparada com a quantidade sistêmica somente no servidor. O conferente pode trabalhar pela sua fila, pelo leitor QR Code ou pela Entrada Manual.
Contagem cega de verdade
A resposta operacional da API não inclui a quantidade de referência. O operador vê material, descrição, depósito, localização, vencimento e prioridade — nunca o número que o sistema espera antes de confirmar sua própria quantidade.
Opção A · Minha Contagem
Abra sua fila
Escolha a data e, se necessário, filtre por status ou busque material/localização. A tela mostra Minhas tarefas, Pendentes, Em contagem e Executadas.
Inicie a tarefa
Ao clicar em Iniciar contagem, a tarefa passa para “Em contagem”. Se ela ainda estivesse sem responsável, a primeira pessoa autorizada poderia assumir a tarefa no início; tarefas de outro conferente são bloqueadas, salvo para quem possui permissão de programação.
Informe a quantidade física
Digite somente o que foi encontrado e, opcionalmente, uma observação. Ao confirmar, o sistema grava a primeira contagem com usuário, data/hora e origem.
Opção B · Leitura sequencial por QR Code
O leitor usa a câmera traseira do celular quando o navegador permite. Quando BarcodeDetector está disponível, a leitura é automática. Caso contrário, você pode usar leitor QR Bluetooth/USB ou digitar o código no campo da própria tela.
O servidor confirma se a posição está ativa e resolve o depósito correto.
LOC|1000|A-01-05O sistema valida o vínculo Material × Localização e localiza a tarefa autorizada.
MAT|MAT-001Ative a câmera e confirme a posição
Aponte para o QR da localização. A tela mostra o depósito e a posição confirmada; somente então libera a etapa do material.
Valide o vínculo físico
Ao ler o material, o servidor verifica se ele pertence àquela posição, se existe tarefa aberta para a data e se o operador tem autorização para executá-la.
Registre a quantidade
A janela de contagem abre automaticamente. A origem fica gravada como QR. Depois da confirmação, o fluxo volta para “Leia a próxima localização”.
Localizações iguais em depósitos diferentes
Um código simples como “A-01-01” só é aceito quando não há ambiguidade na empresa. Se a mesma posição existir em dois depósitos, o sistema exige o QR completo com o código do depósito para evitar abrir a tarefa errada.
Opção C · Entrada Manual
Use quando a câmera não estiver disponível. Informe Material e Localização; o servidor aplica a mesma validação usada no QR Code. Se localizar uma tarefa Pendente ou Em contagem autorizada, a tela libera o botão para registrar a quantidade.
O que acontece depois de confirmar
Físico = sistêmico da posição
A tarefa fica Concluída. Quando todas as posições daquele material, dentro da mesma programação, terminarem sem divergência, o sistema grava a última contagem e calcula a próxima data usando a frequência da tarefa.
Físico ≠ sistêmico da posição
A tarefa fica Divergente, o sistema abre um caso de divergência, grava diferença em quantidade e valor e incrementa o histórico de divergências do material. O tratamento/recontagem será executado no módulo da V0.6.
A primeira contagem não pode ser sobrescrita
Existe uma chave única por tarefa/sequência. Uma segunda tentativa de gravar a primeira contagem é recusada. A futura recontagem será um novo evento, preservando o histórico original.
Dashboard & continuidade do programa
O Dashboard resume a operação do dia e a saúde da base permanente. Ele não encerra um inventário; mostra se o programa cíclico está andando e quais materiais precisam de atenção.
Indicadores disponíveis na V0.5
Saúde da base
Materiais ativos, localizações, depósitos, planos ativos, tarefas dos próximos 7 dias, valor do estoque, itens vencidos e divergências abertas.
Distribuição ABC
Quantidade de materiais A, B e C, útil para conferir se a classificação da base está coerente com a política de frequência.
Como a próxima data é formada
Última contagem + frequência aplicada
Quando todas as tarefas de localização do material naquela programação terminam como Concluídas, a data atual vira a última contagem e o sistema soma os dias da frequência registrada na tarefa.
Divergência interrompe o avanço normal
Se ao menos uma posição do material ficar Divergente, o ciclo daquele material não é avançado como se estivesse resolvido. Isso preserva a pendência para a recontagem e decisão que serão adicionadas na V0.6.
Próximas evoluções já previstas
Glossário & checklist
Referência rápida para quem configura, programa e executa a contagem cíclica.
Glossário
- Material
- Cadastro permanente do item. O mesmo material pode estar vinculado a uma ou mais localizações.
- Material × Localização
- Vínculo que representa uma posição física do material e guarda o estoque sistêmico daquela posição.
- Classe ABC
- Classificação A, B ou C usada para priorizar e definir frequências diferentes de contagem.
- Criticidade
- Critério adicional (Baixa, Normal, Alta ou Crítica) que pode tornar a regra de frequência mais específica.
- Regra de frequência
- Política que transforma ABC/criticidade em quantidade de dias entre contagens.
- Plano de Contagem
- Define unidade/depósito, período, dias habilitados, limite diário e se materiais sem próxima data entram na geração.
- Programação
- Lote de tarefas gerado para um plano e uma data específica.
- Tarefa
- Ordem para contar um material em uma localização específica.
- Contagem cega
- Registro feito sem expor a quantidade sistêmica ao operador. A comparação ocorre no servidor.
- Divergência
- Diferença entre a quantidade física informada e o estoque de referência da posição.
- QR padrão
MAT|CÓDIGOpara material eLOC|DEPÓSITO|LOCALIZAÇÃOpara posição. QR personalizado também é aceito.- Idempotente
- Uma ação que pode ser repetida sem criar duplicidade indevida. O gerador de programação usa esse princípio.
Checklist de implantação
- Usuários criados e perfis atribuídos corretamente.
- Depósitos e localizações cadastrados ou preparados na planilha.
- Materiais importados com estoque, custo, ABC e criticidade revisados.
- Material × Localização conferido para as posições que entrarão no programa.
- QR Codes definidos no padrão do sistema ou usando códigos existentes da empresa.
- Regras de frequência revisadas e aplicadas aos materiais.
- Plano de Contagem com escopo, período, dias e capacidade diária corretos.
- Agenda revisada e programação do dia gerada sem materiais pendentes de localização.
- Tarefas distribuídas entre os conferentes.
- Execução testada pelo QR Code e pelo modo manual antes do uso em escala.
Boas práticas
Conte por posição
Evite consolidar fisicamente duas localizações em uma única leitura. O vínculo por posição é o que torna a divergência rastreável.
Não revele o sistêmico ao conferente
A tela já protege o valor. Preserve também o procedimento operacional para evitar viés de confirmação durante a contagem.
Use QR completo para localização
Especialmente quando códigos de posição se repetem entre depósitos, o padrão LOC|DEPÓSITO|LOCALIZAÇÃO elimina ambiguidades.
Corrija a base antes de programar
Materiais sem localização ficam fora da programação. Trate esses casos como pendência de cadastro, não como exceção de campo.
Respeite a capacidade diária
Use o limite do plano para gerar uma carga de trabalho executável e evitar acúmulo artificial de tarefas vencidas.
Não tente corrigir uma contagem já gravada
A primeira contagem é imutável por projeto. A correção deve ocorrer por novo evento de recontagem, preservando a auditoria.
A essência da contagem cíclica
Não existe “finalizar o inventário”. O objetivo é manter o estoque correto todos os dias: uma tarefa termina, a próxima data nasce e o programa continua.