🏭 OPERAÇÃO: PRODUÇÃO (ENCHIMENTO)

Lotes de Produção e Enchimento

Detalhamento completo das 5 funcionalidades relacionadas à produção do App Cilindros.
Cada atividade é explicada com: o que faz, por que existe, pré-requisitos e quando usar.

📋 5 Funcionalidades 🏷️ QR Code do Lote 📊 3 Situações 🔄 Vazio → Cheio 🔍 Rastreabilidade
📊 FLUXO COMPLETO

🔄 Ciclo de Enchimento dos Cilindros

Visão completa do processo de enchimento de cilindros. As operações integram o App Lotes de Produção (criação do lote) e o App Cilindros (vinculação dos cilindros).

graph TD %% NÓS PRINCIPAIS A["📦 1. CRIAR LOTE
App Lotes de Produção
ID 27"] B["🟡 Lote ABERTO
Aguardando cilindros"] C["🔘 2. VINCULAR CILINDROS
App Cilindros - ID 101"] D["📷 Leitura QR Code
Câmera / USB / Arquivo / Busca"] E["📊 Cilindro adicionado
Contador +1"] F["💾 GRAVAR COLETA
Salva offline
NÃO valida"] G["✈️ FINALIZAR COLETA
Validar todos os cilindros"] H{"✅ Validação
INTERNO + VAZIO?"} I["❌ ERRO
Cilindro não pode ser enchido"] J["🛠️ CORRIGIR
Alterar Localização (688)
ou Situação (687)"] K["✅ Cilindro APROVADO
Vinculado ao lote"] L["🔒 3. FECHAR LOTE"] M["🟢 Lote FECHADO"] N["🟢 4. EFEITO NO CILINDRO
Vazio → Cheio"] O["🚚 Cilindro pronto para
Carregamento e Entrega"] %% FLUXO PRINCIPAL A --> B B --> C C --> D D --> E E --> F F --> G G --> H H -->|Sim| K H -->|Não| I I --> J J --> G K --> L L --> M M --> N N --> O %% EXCLUSÃO - PODE SER FEITA ENQUANTO LOTE ESTIVER ABERTO E -.->|Após vincular| P["🗑️ EXCLUIR CILINDRO
ID 102
Remove do lote"] K -.->|Após finalizar| P P -.->|Lote ainda ABERTO| C %% ESTILOS style A fill:#1e293b,stroke:#8b5cf6,stroke-width:2px style B fill:#1e293b,stroke:#f59e0b,stroke-width:2px style C fill:#1e293b,stroke:#22c55e,stroke-width:2px style D fill:#1e293b,stroke:#22c55e style E fill:#1e293b,stroke:#22c55e style F fill:#1e293b,stroke:#22c55e style G fill:#1e293b,stroke:#22c55e,stroke-width:2px style K fill:#1e293b,stroke:#22c55e style L fill:#1e293b,stroke:#3b82f6,stroke-width:2px style M fill:#1e293b,stroke:#3b82f6 style N fill:#1e293b,stroke:#22c55e,stroke-width:2px style O fill:#1e293b,stroke:#22c55e style P fill:#1e293b,stroke:#ef4444,stroke-width:2px style I fill:#1e293b,stroke:#ef4444 style J fill:#1e293b,stroke:#f97316
📦 App Lotes de Produção 🔘 App Cilindros - Ação principal 🔄 Transição de estado 🟡 Lote Aberto 🟢 Lote Fechado / Cilindro Cheio 🗑️ Exclusão (lote ABERTO) 🛠️ Correção manual

📋 Passo a passo do enchimento

1 Criar Lote de Produção (ID 27)

Cria a "capa" do lote no App Lotes de Produção. O lote inicia com situação 🟡 ABERTO.

2 Vincular Cilindros (ID 101)

No App Cilindros, selecione o lote e bipe os QR Codes dos cilindros (câmera, USB, arquivo ou busca).

3 Finalizar Coleta

Valida todos os cilindros bipados. Critérios: cilindro deve estar 🏢 INTERNO e 🔴 VAZIO.

4 Fechar Lote

Altera a situação do lote para 🟢 FECHADO. Todos os cilindros vinculados são marcados como 🟢 CHEIO.

🛠️ Correções e desvios

delete_forever Excluir Cilindro do Lote (ID 102)

Remove um cilindro bipado por engano. Pode ser feito a qualquer momento enquanto o lote estiver ABERTO - tanto antes quanto depois de finalizar a coleta.

location_on Alterar Localização (ID 688)

Corrige cilindro que não está INTERNO. Usar antes de finalizar a coleta.

radio_button_checked Alterar Situação (ID 687)

Corrige cilindro que não está VAZIO. Usar antes de finalizar a coleta.

save Gravar Coleta (ID 101)

Salva os cilindros bipados localmente. NÃO valida os cilindros - permite continuar depois sem perder dados.

📊 Estados do Cilindro durante o processo

Etapa Situação do Lote Situação do Cilindro Localização Ações Permitidas
1. Criação do Lote 🟡 ABERTO 🔴 VAZIO 🏢 INTERNO Criar, Alterar Lote
2. Vinculação 🟡 ABERTO 🔴 VAZIO 🏢 INTERNO Vincular, Gravar coleta, Excluir (a qualquer momento)
3. Validação (Finalizar) 🟡 ABERTO Verificação Verificação Corrigir erros (ID 687/688), Excluir (a qualquer momento)
4. Após Validação 🟡 ABERTO 🔴 VAZIO 🏢 INTERNO Excluir (ainda pode remover), Fechar Lote
5. Fechamento do Lote 🟢 FECHADO 🟢 CHEIO 🏢 INTERNO Apenas consulta (não pode mais excluir)
6. Pronto para Entrega 🟢 FECHADO 🟢 CHEIO 🏢 INTERNO Carregamento, Entrega
Pré-requisito para enchimento: Cilindro deve estar 🔴 VAZIO e 🏢 INTERNO.
⚠️ Validade: Se cilindro estiver com validade vencida, sistema bloqueia enchimento (exceto se lote for de Revalidação).
🗑️ Exclusão: Pode excluir um cilindro do lote a qualquer momento enquanto o lote estiver 🟡 ABERTO. Após fechar o lote, não é mais possível.
📌 Após o fechamento do lote: O cilindro fica 🟢 CHEIO e pronto para o Carregamento e Entrega.
🚫 Não é possível: Encher cilindro que está em ROTA, CLIENTE ou EMPRESTADO. Apenas cilindros INTERNOS podem ser enchidos.
💡 Dica: Utilize Gravar coleta periodicamente durante o processo para não perder dados em caso de interrupção. Use Finalizar apenas quando todos os cilindros estiverem bipados. Excluir pode ser usado a qualquer momento para corrigir erros antes de fechar o lote.
ID 27 📦 App Lotes de Produção

➕ Incluir Lote de Produção

📌 Funcionalidade do App Lotes de Produção
Esta funcionalidade não faz parte do App Cilindros, mas é apresentada aqui para entendimento do fluxo completo. O lote é a "capa" que agrupa os cilindros que serão enchidos.

🎯 O que faz

Cria um novo lote de produção (capa). Após criar o lote, é possível vincular os cilindros que serão enchidos.

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

  • 🔍 Nome/Razão Social (cliente - produção para terceiros)
  • 🔍 Tipo (Enchimento, Revalidação, etc)
  • 🔍 Situação (Aberto, Em análise, Fechado)
  • 🔍 Fórmula (opcional)
  • 🔍 Membro (responsável)

💡 Por que existe

Todo enchimento precisa de um lote para agrupar os cilindros e rastrear a produção. É o registro do evento de enchimento.

Sem o lote, os cilindros não podem ser marcados como "Cheios" no sistema.

📋 Analogia

Assim como uma ordem de produção na indústria, o lote agrupa todos os cilindros produzidos em um mesmo período.

📝 Campos do formulário

Campo Obrigatório Observação
🔢 Id❌ NãoGerado automaticamente após salvar. QR Code é gerado.
👤 Participante✅ SimFixado automaticamente com o usuário logado.
📅 Data hora inclusão❌ NãoAutomático.
🏢 Nome/Razão Social❌ OpcionalCliente dono dos cilindros (produção para terceiros).
📝 Descrição✅ SimNome do lote de produção.
🔢 Número do lote❌ OpcionalNúmero de controle interno.
📄 Nota fiscal❌ OpcionalNota fiscal de compra de gás (se aplicável).
📅 Data da nota❌ OpcionalData da nota fiscal.
📅 Data do lote❌ OpcionalData de produção.
🏷️ Tipo✅ SimEnchimento, Revalidação, etc. Busca em lista pré-cadastrada.
📊 Situação✅ SimPadrão: Aberto. Pode ser alterado conforme fluxo.
🧪 Fórmula❌ OpcionalFórmula utilizada no enchimento.
👤 Membro❌ OpcionalResponsável pelo lote.
📌Pré-requisitos: Ter os cilindros que serão enchidos cadastrados no sistema.
🏁Após criar o lote: O lote fica com situação Aberto e é possível vincular os cilindros.
📱QR Code: Gerado automaticamente para o lote.
🚫Quando NÃO usar: Para alterar lote existente → use "Alterar Lote" na tela de Lotes de Produção.
ID 72

📋 Enchimentos

🎯 O que faz

É a gaveta de cilindros enchidos. Apresenta todos os cilindros que foram vinculados a lotes de produção, com filtros, gráficos e exportações.

🔍 Filtros disponíveis

IdLote produçãoId cilindroReferência TipoAplicaçãoCapacidadeUnidade MembroTipo lote produçãoData InicialData Final

📊 Taskbar - Ações disponíveis

🔍 Buscar
🧹 Abrir filtros
⏳ Atualizar
📋 Tabela
🌐 Página
📊 Resumo
📈 Gráficos
🖨️ Imprimir
📄 PDF
📊 Excel
📊 Dashboard

💡 Por que existe

É a consulta de todos os enchimentos realizados. Permite visualizar:

  • 📅 Data e hora do enchimento
  • 🏷️ Lote de produção responsável
  • 🔢 Identificação do cilindro (ID e Referência)
  • 🧪 Detalhes técnicos (Tipo, Aplicação, Capacidade, Unidade)
  • 👤 Membro que realizou o enchimento
Pré-requisitos: Nenhum. Tela de consulta.
ID 101

🔘 Vincular cilindro ao lote de produção

🎯 O que faz

Vincula cilindros a um lote de produção através da leitura do QR Code do cilindro. É 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 serão enchidos neste lote. Cada cilindro é um ID único (QR Code).

Fluxo de trabalho:

  • 📦 Gravar coleta (💾): Salva localmente, sem validar os cilindros. Permite continuar depois.
  • ✈️ Finalizar: Valida todos os cilindros (Interno + Vazio) e vincula ao lote.
🔘 Processo de vinculação

1. Selecione o lote (apenas ABERTOS)
2. Bipa os QR Codes dos cilindros
3. Gravar coleta (opcional) - salva offline
4. Finalizar - valida e vincula ao lote

📱 Barra de ferramentas (Rodapé)

ÍconeFuncionalidadeDescrição
Abrir câmeraLeitura contínua de QR Codes pela câmera do celular. Permite bipar vários cilindros sequencialmente.
Fechar câmeraPara a leitura pela câmera.
Ler arquivoImporta arquivo .txt com lista de QR Codes (um por linha). Ideal para coleta offline ou pré-lista de cilindros.
BuscarAbre busca no cadastro de cilindros. Permite selecionar um cilindro para vincular.
ResumoExibe resumo dos cilindros já vinculados nesta coleta.
Gravar coletaSalva a coleta localmente (offline). NÃO valida os cilindros - apenas armazena para continuar depois. Evita perda de dados.
FinalizarValida todos os cilindros e vincula ao lote. Critérios: cilindro deve estar 🏢 INTERNO e 🔴 VAZIO. Após validar, todos são vinculados ao lote.
Remover slideFecha a tela atual. Dados não salvos são perdidos.
Mais opçõesAbre menu auxiliar com funcionalidades extras (ver tabela abaixo).
📷 Abrir câmera - Leitura contínua de QR Codes
⏹️ Fechar câmera - Para a leitura
📄 Ler arquivo - Importa lista de QR Codes
🔍 Buscar - Busca cilindro no cadastro
📊 Resumo - Resumo dos cilindros vinculados
💾 Gravar coleta - Salva offline (sem validar)
✈️ Finalizar - Valida e vincula ao lote
❌ Remover slide - Fecha a tela
➕ Mais opções - Menu auxiliar

➕ Menu "Mais Opções" (Auxiliar)

FuncionalidadeDescrição
Alterar situação do cilindroAbre tela para corrigir situação (CHEIO/VAZIO) de um cilindro.
Alterar localização do cilindroAbre tela para corrigir localização (INTERNO/ROTA/CLIENTE/EMPRESTADO).
Alterar situação da etiquetaPara etiquetas avulsas (cilindros não cadastrados).
Alterar localização da etiquetaPara etiquetas avulsas.
Alternar câmeraAlterna entre câmera frontal e traseira.
Explorar dadosAbre navegação para explorar dados relacionados.
🔄 Alterar situação do cilindro - Correção manual
📍 Alterar localização do cilindro - Correção manual
🏷️ Alterar situação da etiqueta - Para etiquetas avulsas
📍 Alterar localização da etiqueta - Para etiquetas avulsas
📷 Alternar câmera - Frontal/Traseira
🔍 Explorar dados - Navegação

📝 Campos do formulário

CampoObrigatórioObservação
🔘Leitura QR Code✅ SimCampo com autofoco para leitura contínua. Aceita: leitor USB, câmera, digitação manual.
📊Contador❌ LeituraMostra quantos cilindros já foram bipados nesta coleta.
📝Descrição❌ OpcionalAnotação sobre a coleta.
👤Participante✅ FixoUsuário logado (automático).
📊Situação❌ FixoSempre "Pendente" enquanto o lote está aberto.
📅Data❌ AutomáticoData e hora da leitura.
🔢Quantidade✅ FixoSempre 1 (um cilindro por leitura).
🏷️Lote de produção✅ SimSeleciona o lote onde os cilindros serão vinculados. Apenas lotes ABERTOS aparecem na busca.
📦Produto❌ LeituraCarregado automaticamente após leitura do QR Code.
🔘 Leitura QR Code Obrigatório
Campo com autofoco. Bipa o QR Code do cilindro.
📊 Contador Leitura
Total de cilindros bipados.
🏷️ Lote de produção Obrigatório
Apenas lotes ABERTOS.
Pré-requisitos: Lote de produção deve estar ABERTO.
📦Gravar coleta (💾): Salva os cilindros bipados localmente. NÃO valida se o cilindro está Interno e Vazio. Permite continuar depois sem perder dados.
✈️Finalizar: Valida todos os cilindros bipados. Critérios: cilindro deve estar 🏢 INTERNO e 🔴 VAZIO. Após validação, todos são vinculados ao lote.
⚠️Validações no Finalizar: Sistema verifica se o cilindro existe, está cadastrado, está INTERNO e VAZIO. Se houver erro, o cilindro é destacado e não é vinculado.
🚫Quando NÃO usar: Se o cilindro já está CHEIO ou se o lote já foi FECHADO.
💡Dica: Use Gravar coleta periodicamente para não perder dados em caso de interrupção. Use Finalizar apenas quando todos os cilindros estiverem bipados.
ID 102

🗑️ Excluir cilindro do lote de produção

🎯 O que faz

É a gaveta de cilindros vinculados a um lote com opção de exclusão. Apresenta todos os cilindros de um lote específico, com filtros e ações, permitindo remover cilindros do lote.

💡 Por que existe

Permite remover cilindros vinculados por engano a um lote de produção.

Importante: Só é possível excluir enquanto o lote estiver ABERTO.

Pré-requisitos: Lote deve estar ABERTO. Cilindro deve estar vinculado ao lote.
🔒Restrições: Não é possível excluir cilindro se o lote já foi FECHADO.
🚫Quando NÃO usar: Para corrigir dados do cilindro → use rotinas de cadastro. Esta rotina é apenas para desvincular do lote.
ID 176

📊 Resumo de enchimento por cilindro

🎯 O que faz

É a tela de resumo/relatório dos enchimentos realizados. Apresenta os dados agrupados por produto (Tipo + Aplicação + Capacidade + Unidade), com filtros, gráficos e exportações.

🔍 Filtros disponíveis

IdLote produçãoId cilindroReferência TipoAplicaçãoCapacidadeUnidade MembroTipo lote produçãoData InicialData Final

📊 Taskbar - Ações disponíveis

🔍 Buscar
🧹 Abrir filtros
⏳ Atualizar
📋 Tabela
🌐 Página
📊 Resumo
📈 Gráficos
🖨️ Imprimir
📄 PDF
📊 Excel
📊 Dashboard

💡 Por que existe

É a visão consolidada da produção. Permite:

  • 📊 Visualizar total de cilindros enchidos por produto
  • 📈 Acompanhar volume produzido em M³ e KG
  • 🎯 Identificar produtos mais produzidos
  • 📅 Análise temporal da produção
Pré-requisitos: Nenhum. Tela de consulta.
📊Funcionalidades: Possui gráficos interativos, dashboard com resumo executivo e opções de exportação.

📝 Campos da tabela de resumo

CampoDescriçãoExemplo
🔢 IdOrdenação do resumo (agrupamento sequencial)1, 2, 3...
🧪 TipoTipo de gásOxigênio, Nitrogênio, CO2, Acetileno, Ar comprimido
🎯 AplicaçãoUso do gásMedicinal, Industrial, Alimentício, Medicinal (USP), Medicinal SAMU
📏 CapacidadeTamanho do cilindro01, 03, 04, 05, 06, 07, 09, 10, 18, 23, 25, 2.5
⚖️ UnidadeUnidade de medidaM3, KG
⚪ SituaçãoStatus do cilindro após enchimentoCHEIO
📦 QTDQuantidade de cilindros enchidos1.531, 792, 467, 652
📦 M3Volume total produzido10.717, 5.544, 6.520, 820
⚖️ KGPeso total produzido350, 75, 45, 40
🔢 Id - Ordenação do resumo
🧪 Tipo / 🎯 Aplicação - Identificação do produto
📏 Capacidade / ⚖️ Unidade - Especificação técnica
📦 QTD / M3 / KG - Totais de produção

📊 Gráficos disponíveis

📊 Enchimento por produto
Gráfico de barras com quantidade, KG e M³ por produto completo (Tipo + Aplicação + Capacidade + Unidade)
📊 Enchimento por tipo, aplicação e capacidade
Análise detalhada excluindo a unidade
📊 Enchimento por tipo e aplicação
Visão consolidada por tipo de gás e aplicação
📊 Enchimento por tipo
Ranking dos gases mais produzidos
📊 Enchimento por aplicação
Comparativo entre Medicinal, Industrial, Alimentício
📊 Enchimento por capacidade
Distribuição por tamanho de cilindro
📊 Enchimento por unidade
Análise por M3, KG, L

📊 Dashboard - Resumo Executivo

🏭
TOTAL CILINDROS
4.042
cilindros enchidos no período
📦
TOTAL M³
27.308
metros cúbicos produzidos
⚖️
TOTAL KG
672,50
quilogramas produzidos
🧪
PRODUTOS DIFERENTES
41
tipos de cilindros produzidos
🟢
CHEIOS
4.042
100% dos cilindros
📏
MÉDIA POR PRODUTO
98,6
cilindros/produto
Pré-requisitos: Nenhum. Tela de consulta.
📊Funcionalidades: Possui filtros por período, tipo de gás, aplicação, capacidade, e opções de exportação (PDF, Excel).
💡Dica: Utilize o Dashboard para uma visão executiva da produção. Os gráficos podem ser filtrados e exportados.
🚫Quando NÃO usar: Esta tela é para consulta e relatórios. Para vincular cilindros, use "Vincular cilindro ao lote de produção" (101).
Situações

📊 Situações do Lote de Produção

🟡 ABERTO

Lote em andamento
Pode vincular/excluir cilindros.

🔵 EM ANÁLISE

Lote em análise
Verificação de qualidade.

🟢 FECHADO

Lote concluído
Não pode mais ser alterado.

🔄Fluxo normal: Aberto → Em análise → Fechado.
🔒Importante: Ao fechar o lote, todos os cilindros vinculados são marcados como CHEIO no sistema.
QR Code

📱 QR Code do Lote de Produção

🎯 O que faz

Cada lote de produção recebe um QR Code único (tipo "lp") que permite:

  • 🔍 Acesso rápido às informações do lote
  • 📊 Visualizar os cilindros vinculados
  • 📄 Gerar relatório do lote

💡 Por que existe

Facilita a consulta do lote no ambiente de produção. O QR Code pode ser impresso e fixado no painel de controle da produção.

qr_code_2
QR Code: LP-12345 • Lote: Enchimento Oxigênio 10 M3