Inventário de Cilindros
Detalhamento completo das 5 funcionalidades relacionadas ao inventário do App Cilindros.
Cada atividade é explicada com: o que faz, por que existe, pré-requisitos e quando usar.
🔄 Ciclo de Inventário de Cilindros
Visão completa do processo de inventário de cilindros. O inventário registra a situação dos cilindros em um momento específico, sem alterar os dados operacionais.
App Cilindros - ID 121"] B["🔘 2. LANÇAR CILINDROS
App Cilindros - ID 132"] C["📷 Leitura QR Code
Câmera / USB / Arquivo / Busca"] D["📊 Cilindro selecionado
Registro da situação atual"] E["💾 GRAVAR COLETA
Salva offline
NÃO valida"] F["✈️ FINALIZAR COLETA
Validar todos os cilindros"] H{"✅ Validação
NENHUMA!
Só registra o momento"} I["❌ ERRO
Cilindro não encontrado"] K["✅ Cilindro REGISTRADO
Snapshot salvo"] L["📝 3. EFEITO NO CILINDRO
NENHUM!
Situação e Localização NÃO alteram"] N["📊 4. STATUS FINAL
Inventário registrado
Consulta disponível"] %% FLUXO PRINCIPAL A --> B B --> C C --> D D --> E E --> F F --> H H -->|Sempre| K H -->|Cilindro inválido| I I --> B K --> L L --> N %% EXCLUSÃO - PODE SER FEITA ENQUANTO COLETA ESTIVER PENDENTE E -.->|Após vincular| P["🗑️ EXCLUIR CILINDRO
ID 136
Remove da lista"] K -.->|Após finalizar| P P -.->|Coleta ainda pendente| B %% ESTILOS style A fill:#1e293b,stroke:#0d9488,stroke-width:2px style B fill:#1e293b,stroke:#0d9488,stroke-width:2px style C fill:#1e293b,stroke:#0d9488 style D fill:#1e293b,stroke:#0d9488 style E fill:#1e293b,stroke:#0d9488 style F fill:#1e293b,stroke:#0d9488,stroke-width:2px style K fill:#1e293b,stroke:#0d9488 style L fill:#1e293b,stroke:#22c55e,stroke-width:2px style N fill:#1e293b,stroke:#0d9488,stroke-width:2px style P fill:#1e293b,stroke:#ef4444,stroke-width:2px style I fill:#1e293b,stroke:#ef4444
📋 Passo a passo do inventário
Cria um novo inventário com ID único e descrição. O inventário inicia com status 📝 ABERTO.
Selecione o inventário e bipe os QR Codes dos cilindros (câmera, USB, arquivo ou busca).
Valida todos os cilindros bipados. Não há restrições - qualquer cilindro pode ser inventariado, independente de situação ou localização.
NENHUM! O inventário apenas registra um snapshot da situação e localização do cilindro no momento da leitura.
🛠️ Correções e desvios
Remove um cilindro bipado por engano. Pode ser feito a qualquer momento enquanto a coleta estiver pendente - tanto antes quanto depois de finalizar a coleta.
Salva os cilindros bipados localmente. NÃO valida os cilindros - permite continuar depois sem perder dados.
📊 Estados durante o processo de inventário
| Etapa | Situação do Inventário | Situação do Cilindro | Localização | Efeito |
|---|---|---|---|---|
| 1. Criar Inventário | 📝 ABERTO | Qualquer | Qualquer | Criação do inventário |
| 2. Coleta (bipagem) | 📝 ABERTO | Registrada no snapshot | Registrada no snapshot | Gravar coleta, Excluir (a qualquer momento) |
| 3. Validação (Finalizar) | 📝 ABERTO | Verificação | Verificação | Registro definitivo |
| 4. Após Finalizar | ✅ FECHADO | NÃO ALTERADA | NÃO ALTERADA | Consulta, relatórios |
📋 Inventários
🎯 O que faz
É a gaveta de cilindros inventariados. Apresenta todos os cilindros que foram lançados em inventários, com filtros, gráficos e exportações.
🔍 Filtros disponíveis
📊 Taskbar - Ações disponíveis
💡 Por que existe
É a consulta de todos os inventários realizados. Permite visualizar:
- 📅 Data e hora do inventário
- 📝 Descrição do inventário
- 🔢 Identificação do cilindro (ID e Referência)
- 🧪 Detalhes técnicos (Tipo, Aplicação, Capacidade, Unidade)
- ⚪ Situação do cilindro no momento do inventário
- 👤 Membro responsável
- 📍 Localização no momento do inventário
➕ Criar Inventário
🎯 O que faz
Cria um novo inventário para registrar a situação dos cilindros em um momento específico. É a tela padrão de Coleta de Dados da plataforma.
Múltiplas formas de entrada:
- 📷 Leitura por câmera (contínua)
- 🔘 Leitura por leitor USB (bipar QR Code)
- 📄 Importação de arquivo .txt com lista de QR Codes
- 🔍 Busca direta no cadastro de cilindros
- ✏️ Digitação manual do QR Code
💡 Por que existe
Registra quais cilindros foram contados no inventário e qual era sua situação no momento da contagem.
Fluxo de trabalho:
- 📦 Gravar coleta (💾): Salva localmente, sem validar os cilindros. Permite continuar depois.
- ✈️ Finalizar: Valida e registra todos os cilindros bipados no inventário.
1. Crie um inventário com descrição
2. Selecione o inventário
3. Bipa os QR Codes dos cilindros
4. Gravar coleta (opcional) - salva offline
5. Finalizar - registra todos os cilindros
📱 Barra de ferramentas (Rodapé)
| Ícone | Funcionalidade | Descrição |
|---|---|---|
| Abrir câmera | Leitura contínua de QR Codes pela câmera do celular. Permite bipar vários cilindros sequencialmente. | |
| Fechar câmera | Para a leitura pela câmera. | |
| Ler arquivo | Importa arquivo .txt com lista de QR Codes (um por linha). Ideal para coleta offline ou pré-lista de cilindros. | |
| Buscar | Abre busca no cadastro de cilindros. Permite selecionar um cilindro para vincular. | |
| Resumo | Exibe resumo dos cilindros já vinculados nesta coleta. | |
| Gravar coleta | Salva a coleta localmente (offline). NÃO valida os cilindros - apenas armazena para continuar depois. Evita perda de dados. | |
| Finalizar | Registra todos os cilindros no inventário. Não há validação de situação/localização - qualquer cilindro pode ser inventariado. | |
| Remover slide | Fecha a tela atual. Dados não salvos são perdidos. | |
| Mais opções | Abre menu auxiliar com funcionalidades extras. |
📝 Campos do formulário
| Campo | Obrigatório | Observação |
|---|---|---|
| 🔘 Leitura QR Code | ✅ Sim | Campo com autofoco para leitura contínua. Aceita: leitor USB, câmera, digitação manual. |
| 📊 Contador | ❌ Leitura | Mostra quantos cilindros já foram bipados nesta coleta. |
| 📝 Descrição | ❌ Opcional | Anotação sobre a coleta. |
| 👤 Participante | ✅ Fixo | Usuário logado (automático). |
| 📊 Situação | ❌ Fixo | Sempre "Pendente" enquanto a coleta está em andamento. |
| 📅 Data | ❌ Automático | Data e hora da leitura. |
| 🔢 Quantidade | ✅ Fixo | Sempre 1 (um cilindro por leitura). |
| 🏷️ Inventário | ✅ Sim | Seleciona o inventário onde os cilindros serão registrados. Apenas inventários ABERTOS aparecem na busca. |
| 📦 Produto | ❌ Leitura | Carregado automaticamente após leitura do QR Code. |
🔘 Lançar Cilindros no Inventário
🎯 O que faz
Registra cilindros no inventário através da leitura do QR Code do cilindro. É a mesma tela de coleta usada para criar o inventário, mas permite selecionar um inventário existente.
💡 Por que existe
Permite continuar lançando cilindros em um inventário que já foi criado, mesmo após ter sido salvo parcialmente.
Fluxo de trabalho:
- 📦 Gravar coleta (💾): Salva localmente, sem validar os cilindros.
- ✈️ Finalizar: Valida e registra todos os cilindros bipados.
🗑️ Excluir Cilindro do Inventário
🎯 O que faz
É a gaveta de cilindros vinculados a um inventário com opção de exclusão. Apresenta todos os cilindros de um inventário específico, com filtros e ações, permitindo remover cilindros do inventário.
💡 Por que existe
Permite remover cilindros vinculados por engano a um inventário.
Importante: Só é possível excluir enquanto o inventário estiver ABERTO (antes de Finalizar).
📊 Resumo de Inventário
🎯 O que faz
É a tela de resumo/relatório dos inventários realizados. Apresenta os dados agrupados por produto (Tipo + Aplicação + Capacidade + Unidade), com filtros, gráficos e exportações.
🔍 Filtros disponíveis
📊 Taskbar - Ações disponíveis
💡 Por que existe
É a visão consolidada dos inventários. Permite:
- 📊 Visualizar total de cilindros inventariados por produto
- 📈 Acompanhar volume inventariado em M³ e KG
- 🎯 Identificar produtos mais frequentes no inventário
- 📅 Análise temporal dos inventários
- 👥 Análise por membro responsável
- ⚪ Comparativo CHEIO vs VAZIO por inventário
📝 Campos da tabela de resumo
| Campo | Descrição | Exemplo |
|---|---|---|
| 🔢 Id | Ordenação do resumo (agrupamento sequencial) | 1, 2, 3... |
| 🧪 Tipo | Tipo de gás | Oxigênio, Nitrogênio, CO2, Acetileno, Ar comprimido |
| 🎯 Aplicação | Uso do gás | Medicinal, Industrial, Alimentício |
| 📏 Capacidade | Tamanho do cilindro | 01, 04, 07, 09, 10, 18, 23, 25 |
| ⚖️ Unidade | Unidade de medida | M3, KG |
| ⚪ Situação | Status registrado no inventário | CHEIO, VAZIO |
| 📦 QTD | Quantidade de cilindros inventariados | 1.531, 792, 467 |
| 📦 M3 | Volume total inventariado | 10.717, 5.544, 6.520 |
| ⚖️ KG | Peso total inventariado | 350, 75, 45 |
📊 Gráficos disponíveis
Gráfico de barras com quantidade, KG e M³ por produto completo
Análise detalhada excluindo a unidade
Análise excluindo a capacidade
Visão consolidada por tipo de gás e aplicação
Ranking dos gases mais inventariados
Comparativo entre Medicinal, Industrial, Alimentício
Análise por tamanho de cilindro
Distribuição entre M3 e KG
Análise por operador
Evolução temporal dos inventários
Comparativo entre diferentes inventários
📱 QR Code do Inventário
🎯 O que faz
Cada inventário registrado recebe um QR Code único (tipo "iv") que permite:
- 🔍 Acesso rápido às informações do inventário
- 📊 Visualizar os cilindros inventariados
- 📄 Gerar relatório do inventário
- 📋 Comprovante de contagem física
- 📅 Rastreabilidade por período
💡 Por que existe
Facilita a consulta e comprovação do inventário. O QR Code pode ser impresso e anexado à documentação da contagem física.
QR Code: IV-12345 • Inventário: Contagem Mensal - 24/03/26