📊 OPERAÇÃO: ESTOQUE DE CILINDROS

Estoque de Cilindros

Detalhamento completo das 3 telas de estoque do App Cilindros.
Cada tela é explicada com: o que mostra, filtros disponíveis, gráficos e quando usar.

📋 3 Telas de Estoque 🏭 Estoque Geral 🚚 Estoque por Romaneio 🔄 Estoque para Envase 📊 Gráficos e Dashboard 🔍 Filtros Avançados
🏭 Conceitos fundamentais do estoque: O sistema mantém o estoque atualizado em tempo real através das operações de produção, carregamento, entrega, recolhimento, retorno, empréstimo e devolução.
🏢 INTERNO
🚚 ROTA
👥 CLIENTE
🤝 EMPRESTADO
🔄 ENVASE
🎯 IMPORTANTE: O estoque é atualizado automaticamente. Todas as telas de estoque são consultas em tempo real e NÃO permitem edição direta.
📊 ESTRUTURA COMPLETA

🔄 Estrutura do Estoque de Cilindros

Visão completa de como os cilindros são distribuídos no sistema, com base em suas localizações e situações (CHEIO/VAZIO).

graph TD subgraph "ESTOQUE TOTAL" A[("📦 TODOS OS CILINDROS
Ativos e não baixados")] end subgraph "POR LOCALIZAÇÃO" B[🏢 INTERNO] C[🚚 ROTA] D[👥 CLIENTE] E[🤝 EMPRESTADO] F[🔄 ENVASE] end subgraph "DETALHAMENTO INTERNO" B1[🟢 CHEIOS
Prontos para carregamento] B2[🔴 VAZIOS
Aguardando enchimento] end subgraph "DETALHAMENTO ROTA" C1[🚚 Aguardando Entrega] C2[🔄 Aguardando Recolhimento] C3[🏠 Aguardando Retorno] end subgraph "DETALHAMENTO CLIENTE" D1[🟢 CHEIOS com cliente] D2[🔴 VAZIOS com cliente] end subgraph "DETALHAMENTO EMPRESTADO" E1[🟢 CHEIOS emprestados
Aguardando devolução] end subgraph "DETALHAMENTO ENVASE" F1[📥 Recolhidos para envase] F2[🏭 Aguardando enchimento] F3[✅ Prontos para entrega] end A --> B A --> C A --> D A --> E A --> F B --> B1 B --> B2 C --> C1 C --> C2 C --> C3 D --> D1 D --> D2 E --> E1 F --> F1 F1 --> F2 F2 --> F3 style A fill:#1e293b,stroke:#059669,stroke-width:2px style B fill:#1e293b,stroke:#3b82f6 style C fill:#1e293b,stroke:#f97316 style D fill:#1e293b,stroke:#22c55e style E fill:#1e293b,stroke:#eab308 style F fill:#1e293b,stroke:#ec4899
🏢 Estoque Interno 🚚 Estoque em Rota 👥 Cliente 🤝 Emprestado 🔄 Envase

📊 Localizações e Situações

Localização Ícone Situação Permitida Descrição
🏢 INTERNO 🏢 🟢 CHEIO / 🔴 VAZIO Cilindros na fábrica/empresa. CHEIOS prontos para carregamento, VAZIOS aguardando enchimento.
🚚 ROTA 🚚 🟢 CHEIO / 🔴 VAZIO Cilindros no veículo em viagem. Aguardando entrega, recolhimento ou retorno.
👥 CLIENTE 👥 🟢 CHEIO / 🔴 VAZIO Cilindros na posse do cliente. CHEIOS com cliente (empréstimo) ou VAZIOS aguardando recolhimento.
🤝 EMPRESTADO 🤝 🟢 CHEIO Cilindros emprestados ao cliente (não é troca, é empréstimo). Aguardando devolução.
🔄 ENVASE 🔄 🔴 VAZIO → 🟢 CHEIO Cilindros recolhidos para envase. Passam por: recolhido → enchimento → pronto para entrega.
✅ Estoque em Tempo Real: Todas as telas de estoque mostram dados atualizados automaticamente após cada operação.
📊 Visões diferentes: Cada tela de estoque foca em um aspecto diferente (geral, por romaneio, envase).
🔍 Filtros avançados: Todas as telas possuem filtros por tipo de gás, aplicação, capacidade, unidade, etc.
ID 211

🏭 Estoque Geral

🎯 O que mostra

Visão consolidada de todos os cilindros ativos, agrupados por produto (Tipo + Aplicação + Capacidade + Unidade). Apresenta total de cilindros, CHEIOS, VAZIOS, KG e M³.

📊 Colunas da tabela

  • Id - Ordenação do resumo
  • Tipo - Tipo de gás (Oxigênio, Nitrogênio, CO2, etc.)
  • Aplicação - Medicinal, Industrial, Alimentício
  • Capacidade - Tamanho do cilindro (01, 04, 07, 10, 18, etc.)
  • Unidade - M3 ou KG
  • Situação - CHEIO ou VAZIO
  • QTD - Quantidade total de cilindros
  • Vazio - Quantidade de cilindros VAZIOS
  • Cheio - Quantidade de cilindros CHEIOS
  • M3 - Volume total em metros cúbicos
  • KG - Peso total em quilogramas

🔍 Filtros disponíveis

IdReferênciaSituação (Cheio/Vazio) LocalizaçãoEndereçoFabricante PropriedadeProprietárioTipo AplicaçãoCapacidadeUnidade

💡 Por que existe

É a visão principal do estoque. Permite:

  • 📊 Visualizar total de cilindros por produto
  • 📈 Acompanhar volume disponível em M³ e KG
  • 🎯 Identificar produtos com maior/menor estoque
  • ⚖️ Analisar balanço CHEIO x VAZIO
  • 🏭 Planejar produção e carregamentos
✅Pré-requisitos: Nenhum. Tela de consulta em tempo real.
📊Taskbar: Buscar, filtros, atualizar, tabela, página, resumo, gráficos, imprimir, PDF, Excel, Dashboard.

📊 Gráficos disponíveis

📊 Estoque por produto
Gráfico de barras com quantidade, KG e M³ por produto completo
📊 Estoque por tipo, aplicação e capacidade
Análise detalhada excluindo a unidade
📊 Estoque por tipo, aplicação e unidade
Análise excluindo a capacidade
📊 Estoque por tipo e aplicação
Visão consolidada por tipo de gás e aplicação
📊 Estoque por tipo
Ranking dos gases em estoque
📊 Estoque por aplicação
Comparativo entre Medicinal, Industrial, Alimentício
📊 Estoque por capacidade
Análise por tamanho de cilindro
📊 Estoque por unidade
Distribuição entre M3 e KG
✅Pré-requisitos: Nenhum. Tela de consulta.
📊Funcionalidades: Possui filtros por período, tipo de gás, aplicação, capacidade, localização e opções de exportação (PDF, Excel).
💡Dica: Utilize o Dashboard para uma visão executiva do estoque. Os gráficos podem ser filtrados e exportados.
ID 262

🚚 Estoque por Romaneio

🎯 O que mostra

Estoque detalhado dos cilindros em um romaneio específico (veículo em rota). Apresenta todos os cilindros carregados, com informações de entrada, saída, saldo, situação e localização.

📊 Colunas da tabela

  • Id - Ordenação do registro
  • Cilindro - ID do cilindro (link para rastreabilidade)
  • Etiqueta - ID da etiqueta avulsa (se houver)
  • Produto - Descrição completa do produto
  • Situação - CHEIO ou VAZIO
  • Localização - ROTA (sempre)
  • Entrada - Quantidade que entrou no romaneio (1 por cilindro)
  • Saída - Quantidade que saiu do romaneio (entregas)
  • Saldo - Cilindros ainda no romaneio
  • Vazio - Quantidade de VAZIOS
  • Cheio - Quantidade de CHEIOS
  • M3 - Volume total no romaneio
  • KG - Peso total no romaneio

🔍 Filtros disponíveis

Romaneio (obrigatório)

Ao selecionar um romaneio, todos os dados são carregados automaticamente.

💡 Por que existe

Permite acompanhar em tempo real os cilindros que estão no veículo durante a viagem:

  • 🚛 Ver quais cilindros foram carregados
  • 📦 Acompanhar entregas realizadas vs pendentes
  • 🔄 Monitorar recolhimentos
  • 📊 Calcular volume total em rota (M³ e KG)
  • 🏠 Planejar retorno à fábrica
✅Pré-requisitos: Romaneio deve existir. Mostra apenas romaneios com status CARREGAMENTO, EM ROTA ou RETORNO.
📊Taskbar: Buscar, filtros, atualizar, tabela, página, resumo, gráficos, imprimir, PDF, Excel, Dashboard.

📊 Gráficos disponíveis

📊 Estoque por produto
Gráfico de barras com quantidade, KG e M³ por produto no romaneio
📊 Estoque por tipo, aplicação e capacidade
Análise detalhada dos cilindros no romaneio
📊 Estoque por tipo, aplicação e unidade
Análise excluindo a capacidade
📊 Estoque por tipo e aplicação
Visão consolidada por tipo de gás e aplicação
📊 Estoque por tipo
Ranking dos gases no romaneio
📊 Estoque por aplicação
Comparativo entre Medicinal, Industrial, Alimentício
📊 Estoque por capacidade
Análise por tamanho de cilindro
📊 Estoque por unidade
Distribuição entre M3 e KG
✅Pré-requisitos: Selecionar um romaneio na busca.
📊Funcionalidades: Gráficos, resumo e dashboard específicos para o romaneio selecionado.
💡Dica: Use esta tela para acompanhar a viagem em tempo real e planejar as próximas entregas.
ID 299

🔄 Estoque para Envase

🎯 O que mostra

Lista de cilindros que foram recolhidos para envase (cliente solicitou reabastecimento do próprio cilindro). Apresenta detalhes do cliente, cilindro, produto e situação.

📊 Colunas da tabela

  • Id - Ordenação do registro
  • Participante - ID do participante
  • Razão social - Nome do cliente
  • Cidade UF - Localização do cliente
  • Id etiqueta - Etiqueta avulsa (se houver)
  • Id cilindro - ID do cilindro (link para rastreabilidade)
  • Referência - Código do cilindro
  • Produto - Descrição do produto
  • Situação - VAZIO (recolhido) ou CHEIO (após envase)

🔍 Filtros disponíveis

ParticipanteRomaneioRota ProdutoFamília do produtoTipo do produto Id cilindroReferênciaData InicialData Final

💡 Por que existe

Gerencia o ciclo de envase de cilindros de clientes que desejam reabastecer seus próprios equipamentos:

  • 📥 Cilindros recolhidos para envase
  • 🏭 Aguardando processo de enchimento
  • ✅ Prontos para entrega após envase
  • 👥 Rastreabilidade por cliente
  • 📊 Controle de tempo no ciclo de envase
✅Pré-requisitos: Nenhum. Tela de consulta.
📊Taskbar: Buscar, filtros, atualizar, tabela, página, resumo, gráficos, imprimir, PDF, Excel, Dashboard.
✅Pré-requisitos: Nenhum. Tela de consulta.
📊Funcionalidades: Filtros por cliente, produto, período e opções de exportação (PDF, Excel).
💡Dica: Use esta tela para monitorar cilindros em processo de envase e planejar as entregas após o enchimento.
🎯Fluxo do envase: Recolhimento para envase → Enchimento → Entrega pós-envase. Cada etapa tem sua própria tela de registro.
🔍 Filtros

🔍 Filtros Avançados

Todas as telas de estoque possuem filtros avançados para refinar a consulta. Os filtros variam conforme a tela:

🏭 Estoque Geral (ID 211)

IdReferênciaSituaçãoLocalização EndereçoFabricantePropriedadeProprietário TipoAplicaçãoCapacidadeUnidade

🚚 Estoque por Romaneio (ID 262)

Romaneio (obrigatório)

Ao selecionar um romaneio, todos os dados são carregados.

🔄 Estoque para Envase (ID 299)

ParticipanteRomaneioRotaProduto Família do produtoTipo do produtoId cilindro ReferênciaData InicialData Final
🔍Busca inteligente: Os campos com ícone de busca (manage_search) permitem pesquisar no banco de dados enquanto digita.
📷Coleta de dados: Campos com ícone de tabela () permitem leitura por QR Code ou arquivo.
🗺️Geolocalização: Campos com ícone de mapa () buscam participantes próximos à localização atual.
📊 Dashboard

📊 Dashboard de Estoque

Todas as telas de estoque possuem um dashboard interativo com resumo executivo e indicadores-chave.

📊 Cards de Resumo

  • Total de cilindros em estoque
  • Total KG e M³ disponíveis
  • Quantidade de CHEIOS e VAZIOS
  • Percentual de CHEIOS vs VAZIOS
  • Média KG por cilindro
  • Produtos diferentes em estoque
  • Tipos de gás disponíveis
  • Capacidades em estoque

📈 Gráficos

  • Ranking por produto (QTD, KG, M³)
  • Ranking por tipo de gás
  • Ranking por aplicação
  • Ranking por capacidade
  • Ranking por unidade
  • Evolução temporal (quando disponível)
📊Como acessar: Clique no ícone de dashboard (dashboard) na taskbar de qualquer tela de estoque.
🔄Auto-Refresh: O dashboard pode ser configurado para atualizar automaticamente os dados.
📥Exportação: Os dados do dashboard podem ser exportados para Excel e PDF.
📄 Relatórios

📄 Relatórios de Estoque

Todas as telas de estoque permitem exportação de dados em diversos formatos:

📄 Formatos de exportação

  • 🖨️ Imprimir - Impressão direta da tabela
  • 📄 PDF - Geração de PDF com layout otimizado (formato A3 paisagem)
  • 📊 Excel - Exportação para arquivo Excel (.xlsx)

📋 Tipos de relatório

  • 📋 Tabela - Dados detalhados
  • 🌐 Página - Visualização por página
  • 📊 Resumo - Totais consolidados
  • 📈 Gráficos - Visualização gráfica
  • 📊 Dashboard - Visão executiva
📥Exportação: Todos os relatórios podem ser exportados com os filtros aplicados no momento da exportação.
🎯Dica: Utilize os filtros antes de exportar para obter relatórios mais específicos e direcionados.