Cadastro de Cilindros

🎯 O que faz

É a gaveta principal de todos os cilindros cadastrados. Apresenta os cilindros em formato de tabela com filtros, gráficos, exportações e ações por linha.

💡 Por que existe

É o ponto de partida para qualquer operação. Sem esta tela, você não teria visão geral do parque de cilindros.

🎯 O que faz

Formulário de cadastro de um novo cilindro no sistema. Gera QR Code único automaticamente.

Possui busca inteligente (getdata) para selecionar valores de listas pré-cadastradas:

• 🔍 Fabricante
• 🔍 Propriedade (Próprio/Terceiro)
• 🔍 Proprietário (se for terceiro)
• 🔍 Tipo de Gás
• 🔍 Aplicação (Medicinal/Industrial)
• 🔍 Capacidade
• 🔍 Unidade (M3, KG, L)
• 🔍 Endereço

💡 Por que existe

Todo cilindro físico precisa de um registro digital para ser rastreado. É o nascimento do cilindro no sistema — onde ele ganha seu "CPF digital" (QR Code).

Sem este cadastro, o cilindro não existe no sistema e não pode ser movimentado.

🎯 O que faz

Edita dados cadastrais de cilindros já cadastrados. O sistema controla automaticamente quais campos podem ser alterados.

💡 Por que existe

Corrigir erros de digitação ou atualizar informações que não afetam o histórico do cilindro.

🎯 O que faz

Muda as características técnicas do cilindro:

• Tipo de gás (ex: Oxigênio → Nitrogênio)
• Aplicação (Medicinal ↔ Industrial)
• Capacidade (ex: 10 M3 → 07 M3)
• Unidade (M3 ↔ KG ↔ L)

Exemplo: Cilindro de "Oxigênio Medicinal 10 M3" para "Oxigênio Industrial 10 M3".

💡 Por que existe

Cilindros podem ser reclassificados ao longo da vida útil:

• Limpeza e revalidação (ex: oxigênio medicinal → oxigênio industrial)
• Erro de cadastro (capacidade errada)
• Mudança de uso do cliente

🎯 O que faz

Atualiza a data de validade do cilindro após teste hidrostático ou revalidação.

O formulário apresenta:

• 🔍 Busca do cilindro (ID ou referência)
• 📦 Produto (para conferência)
• 📅 Validade antes (data atual registrada)
• 📅 Validade depois (nova data que será registrada)

💡 Por que existe

Cilindros têm prazo de validade determinado por norma técnica:

• Cilindros de aço: revalidação a cada 10 anos
• Cilindros de alumínio/composite: prazos específicos
• Medicamentos (ANVISA): controle rigoroso de validade

Sem esta rotina, o sistema bloquearia o enchimento de cilindros revalidados.

🎯 O que faz

Transfere a propriedade física de um cilindro de um dono para outro.

O formulário apresenta:

• 🔍 Busca de cilindro (apenas cilindros de outros participantes)
• 📝 Referência e descrição (para conferência)
• 👤 Participante de (dono atual do cilindro)
• 👥 Participante para (novo dono - já pré-preenchido com seu participante)

Exemplo: Cliente vende cilindro para sua empresa, ou sua empresa vende cilindro para cliente.

💡 Por que existe

Cilindros mudam de propriedade ao longo da vida útil. Esta rotina registra transferências mantendo a rastreabilidade.

🎯 O que faz

Encerra o ciclo de um cilindro e transfere sua continuidade para um novo cilindro com perfil diferente.

Exemplo: Cilindro "Oxigênio Medicinal 10 M3" com movimentações precisa virar "Oxigênio Industrial 10 M3".

O formulário apresenta:

• 🔍 Busca do cilindro de origem (já cadastrado)
• 📦 Produto (para conferência)
• 🔄 Produto atual (busca do novo cilindro que será criado)

💡 Por que existe

Quando um cilindro com movimentações precisa mudar seu perfil técnico, não se pode alterar diretamente (isso quebraria a rastreabilidade). A solução é criar um novo cilindro e transferir a continuidade.

🎯 O que faz

Tela de consulta rápida para visualizar informações de um cilindro específico.

Após selecionar o cilindro, você pode:

• 🔍 Buscar - localizar o cilindro pelo ID ou referência
• 🚀 Visualizar informações - abrir tela de rastreabilidade completa (ID 28)
• 📊 Linha do tempo - abrir histórico de movimentações (App 0024)

💡 Por que existe

Nem sempre você precisa ver todos os cilindros em uma tabela. Às vezes você só quer:

• Verificar onde está um cilindro específico
• Consultar a validade de um cilindro
• Ver o histórico de movimentações rapidamente

É a forma mais rápida de acessar o histórico completo de um cilindro.

🎯 O que faz

Corrige manualmente a situação do cilindro entre CHEIO e VAZIO.

O formulário apresenta:

• 🔍 Busca do cilindro (ID ou referência)
• 📦 Produto (para conferência)
• 📊 Situação antes (status atual, carregado automaticamente)
• 📊 Situação depois (novo status que será aplicado)

Importante: Ao selecionar o cilindro, o sistema copia automaticamente a situação atual para o campo "Situação antes".

💡 Por que existe

Correção de desvios quando o fluxo normal falha:

• ❌ Cilindro foi enchido mas não registrado no lote de produção
• ❌ Cilindro foi usado (descarregado) mas não registrado no recolhimento
• ❌ Erro operacional que precisa ser corrigido manualmente

Esta rotina é para correção, não para operações normais.

🎯 O que faz

Corrige manualmente a localização do cilindro entre as quatro opções:

• 🏢 INTERNO - estoque da empresa
• 🚚 ROTA - no caminhão/em entrega
• 👥 CLIENTE - na posse do cliente
• 🤝 EMPRESTADO - emprestado sem troca

O formulário apresenta:

• 🔍 Busca do cilindro (ID ou referência)
• 📦 Produto (para conferência)
• 📍 Localização antes (status atual, carregado automaticamente)
• 📍 Localização depois (nova localização)

💡 Por que existe

Correção de desvios quando o fluxo normal falha:

• ❌ Cilindro entregue mas não bipado no app (sistema mostra ROTA)
• ❌ Cilindro recolhido mas não registrado (sistema mostra CLIENTE)
• ❌ Cilindro movido entre setores sem registro
• ❌ Erro operacional que precisa ser corrigido manualmente

Esta rotina é para correção, não para operações normais.