Empréstimos e Gestão de Cilindros Emprestados
Detalhamento completo das 4 funcionalidades relacionadas aos empréstimos do App Cilindros.
Cada atividade é explicada com: o que faz, por que existe, pré-requisitos e quando usar.
🔄 Ciclo de Empréstimo de Cilindros
Visão completa do processo de empréstimo de cilindros. O empréstimo ocorre quando o cliente não tem um cilindro vazio para devolver na troca.
Situação: EM ROTA"] B["🤝 2. REALIZAR EMPRÉSTIMO
App Cilindros - ID 119"] C["📷 Leitura QR Code
Câmera / USB / Arquivo / Busca"] D["📊 Cilindro selecionado
Verificação de dados"] E["💾 GRAVAR COLETA
Salva offline
NÃO valida"] F["✈️ FINALIZAR COLETA
Validar todos os cilindros"] H{"✅ Validação
ROTA/INTERNO + CHEIO?"} I["❌ ERRO
Cilindro não pode ser emprestado"] J["🛠️ CORRIGIR
Alterar Localização (688)
ou Situação (687)"] K["✅ Cilindro APROVADO
Emprestado ao cliente"] L["📝 3. EFEITO NO CILINDRO
Cheio → Cheio (mantém)"] M["🏢 Localização: ROTA/INTERNO → EMPRESTADO"] N["🤝 4. STATUS FINAL
Cilindro EMPRESTADO
Aguardando devolução"] %% FLUXO PRINCIPAL A --> B B --> C C --> D D --> E E --> F F --> H H -->|Sim| K H -->|Não| I I --> J J --> F K --> L L --> M M --> N %% EXCLUSÃO - PODE SER FEITA ENQUANTO COLETA ESTIVER PENDENTE E -.->|Após vincular| P["🗑️ EXCLUIR EMPRÉSTIMO
ID 130
Remove da lista"] K -.->|Após finalizar| P P -.->|Coleta ainda pendente| B %% ESTILOS style A fill:#1e293b,stroke:#3b82f6,stroke-width:2px style B fill:#1e293b,stroke:#eab308,stroke-width:2px style C fill:#1e293b,stroke:#eab308 style D fill:#1e293b,stroke:#eab308 style E fill:#1e293b,stroke:#eab308 style F fill:#1e293b,stroke:#eab308,stroke-width:2px style K fill:#1e293b,stroke:#eab308 style L fill:#1e293b,stroke:#22c55e,stroke-width:2px style M fill:#1e293b,stroke:#eab308 style N fill:#1e293b,stroke:#eab308,stroke-width:2px style P fill:#1e293b,stroke:#ef4444,stroke-width:2px style I fill:#1e293b,stroke:#ef4444 style J fill:#1e293b,stroke:#f97316
📋 Passo a passo do empréstimo
O romaneio deve estar com situação 🔵 EM ROTA. Os cilindros estão marcados como 🚚 ROTA ou podem ser retirados do estoque interno.
No App Cilindros, selecione o romaneio e bipe os QR Codes dos cilindros (câmera, USB, arquivo ou busca).
Valida todos os cilindros bipados. Critérios: cilindro deve estar 🚚 ROTA ou 🏢 INTERNO e 🟢 CHEIO.
Cilindro mantém situação 🟢 CHEIO e sua localização muda para 🤝 EMPRESTADO.
🛠️ 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.
Corrige cilindro que não está em ROTA ou INTERNO. Usar antes de finalizar a coleta.
Corrige cilindro que não está CHEIO. Usar antes de finalizar a coleta.
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 Romaneio | Situação do Cilindro | Localização | Ações Permitidas |
|---|---|---|---|---|
| 1. Antes do Empréstimo | 🔵 EM ROTA | 🟢 CHEIO | 🚚 ROTA ou 🏢 INTERNO | Carregar, Emprestar |
| 2. Coleta (bipagem) | 🔵 EM ROTA | 🟢 CHEIO | 🚚 ROTA ou 🏢 INTERNO | Gravar coleta, Excluir (a qualquer momento) |
| 3. Validação (Finalizar) | 🔵 EM ROTA | Verificação | Verificação | Corrigir erros (ID 687/688), Excluir (a qualquer momento) |
| 4. Após Empréstimo | 🔵 EM ROTA | 🟢 CHEIO | 🤝 EMPRESTADO | Devolução |
| 5. Após Devolução | 🔵 EM ROTA ou 🟣 RETORNO | 🔴 VAZIO | 🚚 ROTA | Retorno, Enchimento |
🤝 Empréstimos
🎯 O que faz
É a gaveta de cilindros emprestados. Apresenta todos os cilindros que estão emprestados a clientes, com filtros, gráficos e exportações.
🔍 Filtros disponíveis
📊 Taskbar - Ações disponíveis
💡 Por que existe
É a consulta de todos os empréstimos realizados. Permite visualizar:
- 📅 Data e hora do empréstimo
- 🏷️ Romaneio de transporte
- 👤 Cliente que recebeu o empréstimo
- 🔢 Identificação do cilindro (ID e Referência)
- 🧪 Detalhes técnicos (Tipo, Aplicação, Capacidade, Unidade)
- 🚛 Veículo e Motorista responsáveis
- ⏱️ Prazo de devolução (se informado)
🤝 Realizar Empréstimo
🎯 O que faz
Registra o empréstimo de cilindros para o cliente 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 foram emprestados ao cliente quando ele não tem um vazio para devolver.
Fluxo de trabalho:
- 📦 Gravar coleta (💾): Salva localmente, sem validar os cilindros. Permite continuar depois.
- ✈️ Finalizar: Valida todos os cilindros (Rota/Interno + Cheio) e registra o empréstimo.
1. Selecione o romaneio (apenas EM ROTA)
2. Bipa os QR Codes dos cilindros
3. Informe o motivo do empréstimo (obrigatório)
4. Opcional: informe prazo de devolução
5. Gravar coleta (opcional) - salva offline
6. Finalizar - valida e registra o empréstimo
📱 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 | Valida todos os cilindros e registra o empréstimo. Critérios: cilindro deve estar 🚚 ROTA ou 🏢 INTERNO e 🟢 CHEIO. Após validar, todos são emprestados. | |
| Remover slide | Fecha a tela atual. Dados não salvos são perdidos. | |
| Mais opções | Abre menu auxiliar com funcionalidades extras. |
➕ Menu "Mais Opções" (Auxiliar)
| Funcionalidade | Descrição |
|---|---|
| Alterar situação do cilindro | Abre tela para corrigir situação (CHEIO/VAZIO) de um cilindro. |
| Alterar localização do cilindro | Abre tela para corrigir localização (INTERNO/ROTA/CLIENTE/EMPRESTADO). |
| Alternar câmera | Alterna entre câmera frontal e traseira. |
| Explorar dados | Abre navegação para explorar dados relacionados. |
📝 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). |
| 🏷️ Romaneio | ✅ Sim | Seleciona o romaneio onde os cilindros serão emprestados. Apenas romaneios EM ROTA aparecem na busca. |
| 👥 Cliente | ✅ Sim | Seleciona o cliente que receberá os cilindros emprestados. |
| 📦 Produto | ❌ Leitura | Carregado automaticamente após leitura do QR Code. |
| 📝 Motivo | ✅ Sim | Razão do empréstimo (ex: "cliente sem vazio", "primeira entrega"). |
| ⏱️ Prazo Devolução | ❌ Opcional | Data limite para devolução do cilindro emprestado. |
🗑️ Excluir Empréstimo
🎯 O que faz
É a gaveta de cilindros vinculados a um empréstimo com opção de exclusão. Apresenta todos os cilindros de um empréstimo específico, com filtros e ações, permitindo remover cilindros do empréstimo.
💡 Por que existe
Permite remover cilindros vinculados por engano a um empréstimo.
Importante: Só é possível excluir enquanto a coleta estiver pendente (antes de Finalizar).
📊 Resumo de Empréstimo por Cilindro
🎯 O que faz
É a tela de resumo/relatório dos empréstimos 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 empréstimos. Permite:
- 📊 Visualizar total de cilindros emprestados por produto
- 📈 Acompanhar volume emprestado em M³ e KG
- 🎯 Identificar produtos mais emprestados
- 📅 Análise temporal dos empréstimos
- 👥 Análise por cliente, rota, veículo e motorista
- ⏱️ Monitorar prazos de devolução
📝 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 após empréstimo | CHEIO (emprestado mantém CHEIO) |
| 📦 QTD | Quantidade de cilindros emprestados | 1.531, 792, 467 |
| 📦 M3 | Volume total emprestado | 10.717, 5.544, 6.520 |
| ⚖️ KG | Peso total emprestado | 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 emprestados
Comparativo entre Medicinal, Industrial, Alimentício
Evolução temporal dos empréstimos
Distribuição por viagem
Ranking dos clientes
Distribuição geográfica
Ranking das rotas
Análise por veículo
Ranking dos motoristas
Análise por operador
📱 QR Code do Empréstimo
🎯 O que faz
Cada empréstimo registrado recebe um QR Code único (tipo "em") que permite:
- 🔍 Acesso rápido às informações do empréstimo
- 📊 Visualizar os cilindros emprestados
- 📄 Gerar relatório do empréstimo
- 👥 Comprovante de empréstimo para o cliente
- ⏱️ Acompanhar prazo de devolução
💡 Por que existe
Facilita a consulta e comprovação do empréstimo. O QR Code pode ser impresso e entregue ao cliente como comprovante.
QR Code: EM-12345 • Empréstimo: Hospital Regional - 24/03/26