estoque.sh - Gerenciamento de estoque/almoxarifado
Publicado por Ricardo Sabaliauskas (última atualização em 26/03/2013)
[ Hits: 5.721 ]
Download estoque.sh (versão 2)
Este script que uso diariamente tem por objetivo gerenciar de um modo simples um estoque/almoxarifado. Basicamente os materiais entram como "+x", onde "x" é um número inteiro e saem com "-x". Também existem várias maneiras de exibir o saldo, como por exemplo, saldo unitário, saldo de um conjunto, saldo total, saldo por funcionários, saldo de saídas semanal (para fornecer uma base para quantidade de reposição), etc...
Está licenciado sob GLP, seu uso é de sua inteira responsabilidade e não se deve alterar/remover a menção do autor.
###########################################################
########## 1.0) INFORMAÇÕES BÁSICAS
########### ************************************************
Nome deste script:
.estoque.sh
Objetivo deste script:
Gerenciamento de materiais de estoque
Autor:
Ricardo Sabaliauskas
Licença:
GLP (Sem nenhuma garantia direta ou indireta). Uso e risco por sua conta.
Versão:
1.0
Notas da versão:
Esta versão, "1.0" do shell-script ".estoque.sh" acrescentou novas funcionalidades referentes ao testes das respostas. Agora é necessário adicionar todos funcionários e também todos os materiais em seus respectivos diretórios e se na solicitação de materiais ou funcionários houver uma resposta que não coincida com os dados já fornecidos então a pergunta será refeita para que haja a devida correção.
Também houve uma melhor padronização e limpeza do código e também suporte à cores.
Dependências:
- bash em versão recente.
- Configuração e criação dos diretórios para os itens de materiais, funcionários e talvez observações.
- unix2dos (dependendo da configuração)
###########################################################
########## 2.0) FUNCIONAMENTO
########### ************************************************
Existe um software, muito bem falado, chamado "Stoq" e este tem por objetivo a gerência de estoque no GNU/Linux. É um software com muitas funções para uso empresarial. Este script foi feito para um uso mais limitado, com muitas menos funções, basicamente registra "+x" ou "-x" (onde "x" é um número) de material e também fornece o saldo dos materiais em estoque. Ele funciona em modo texto e possui um recurso para que haja a menor quantidade possível de digitação resultando um funcionamento de ações rápidas.
Com respeito a este recurso é necessário ressaltar como funcionam a ações de copiar e colar no GNU/Linux. No GNU/Linux não existe a necessidade, em muitos casos, de usar o "Ctrl + C" e o "Ctrl + V" para copiar alguma coisa e colá-la em outro lugar. Basta selecionar a frase a ser copiada com o mouse e depois clicar o roler para colá-la apenas usando a seta do mouse para indicar o local (roler é aquela rodinha que é usada para subir ou descer uma página, sem que haja necessidade de usar a "seta" do mouse). Sim, é isto mesmo, o roler também tem a função de clicar além de subir ou descer a página do navegador de Internet (o "Ctrl + C" e o "Ctrl + V" funcionam no GNU/Linux similarmente ao Windows, mas para este script é muito mais prático usar este sistema através do roler do mouse).
Com isto em mente, ao se fazer um registro de entrada ou saída de material do estoque, será exibido, durante os questionários de material, .funcionários .., uma listagem e através deste método devemos selecionar com mouse o item desejado, teclar "q" para sair da listagem, ("q" minúsculo), e depois com a seta do mouse "mirar" na linha abaixo da pergunta e clicar o roler do mouse. Com isto você digitará menos e também permitirá manter um padrão único nas referências à aquele material.
NOTE: Quando a listagem de itens for muito grande e ficar incômodo ficar procurando determinado item, o comando "less", que é responsável pela exibição desta listagem, tem um recurso de filtragem para podemos localizar mais rapidamente o item procurado. Vamos supor que você esteja procurando por algum item que se chama "sapato_qualquer-coisa", então você digitaria "/sapato" e teclaria o "ENTER" e o comando "less" vai realçar todos os item que tem a palavra "sapato".
Um outro ponto a ser comentado é os nomes de materiais no estoque. Seria interessante usar nomes padronizados. Eu, particularmente, sigo a seguinte fórmula:
- nome de materiais começam com as letras minúsculas.
(Isso facilita a digitação no caso acima mencionado, na filtragem do comando less)
- Não uso espaço em branco.
NOTE: Eu não recomendo o uso de espaço em branco, embora talvez isso não seja um problema. O uso de espaço em branco pode causar erros e este script não foi testado usando-os.
- A separação dos nomes é feita por uma letra maiúscula.
Exemplo:
botinaDeProtecao
vassouraDeJardineiro
- Comece sempre por um nome básico e depois acrescente alguma característica.
Exemplo:
botina
botinaPreta
botinaPretaDeProtecaoBicoDeMetal
botinaMarromDeProtecaoBicoDePlastico
- O nome do fabricante aparece depois do "-" (hífen). Exemplo:
botinaDeProteção-MarcaChule
vassouraDeJardineiro-SemMarca
- O "_" (underline) separa as medidas, tamanho... Exemplo:
botinaDeProteção-MarcaChule_40
botinaDeProteção-MarcaChule_41
fioDeCobreFlexivel-Cobrecom_1x25mm2
Você pode usar do modo que quiser mas lembre-se que certas funções, como a de "Saldo De Estoque De Um Conjunto", dependem de uma parte do nome para formar este conjunto.
Se executar o script "agenda.sh" seguido da letra "h" será exibido estas informações aqui. (Ou ainda; "-h", "help", "--help".)
Também é possível usar um outro parâmetro na execução deste script. Quando feito isso o retorno será o saldo de todos itens que conterem a palavra passada como parâmetro. Apenas lembre-se que no Linux letra maiúscula e minúscula são entendidas como palavras diferentes. Exemplo, "Casa" é diferente de "casa".
###########################################################
########## 3.0) CONFIGURAÇÃO DAS VARIÁVEIS
########### ************************************************
NOME DESTE SCRIPT
O nome deste script é "estoque.sh" e recomendo-o deixá-lo assim. Porém você é livre para mudar seu nome conforme sua necessidade.
Para que uma mudança de nome não prejudique algumas funções deste script foi criada a variável abaixo.
Renomeie conforme exemplos:
Default:
NameSHEstoque=".estoque.sh"
NOTE: O "." (ponto) no início do nome serve para tornar o arquivo oculto. Desta forma ele não aparece em listagem comuns com o comando "ls" nem no navegador de arquivos. Para visualiza-los será necessário usar o parâmetro "-a" no comando "ls" ou descriminar a opção "Mostrar arquivos ocultos" nos navegadores de arquivos.
Supondo que o novo nome seja "Saldo_de_Estoque.sh":
NameSHEstoque="Saldo_de_Estoque.sh"
LOCALIZAÇÃO DO DIRETÓRIO AONDE ARQUIVOS GERADOS POR ESTE SCRIPT SERÃO ENVIADOS.
Este script permite a formação de arquivos ".txt" com certos dados referentes ao estoque. Por exemplo, você quer uma listagem apenas com os itens sapatos_qualquer_coisa, para enviar a alguém. Neste caso, após você digitar 2 na opção; "2) Saldo De Estoque." e depois 2 na opção; "2) Saldo De Estoque De Um Conjunto." e depois escolher parte do nome de item, (neste caso "sapato") e após ser exibido todos saldos dos itens que contém a palavra sapato (tudo em letra minúscula, exemplo; sapatoProtecao_42, sapatoProtecao_44, sapatoSocial_43...) você terá um menu e neste menu você terá a opção "1) Enviar Para Um Arquivo.". Escolhendo a opção "1" neste ponto será criado um arquivo "/algum_lugar/SaldoConjunto-sapato.txt" com a listagem que exibida anteriormente.
Esse "algum_lugar" é definido aqui.
Default:
PathHome="/home/"$USER""
LOCALIZAÇÃO DO DIRETÓRIO AONDE OS ARQUIVOS/DIRETÓRIOS COM OS NOMES DOS MATERIAIS DE ESTOQUE SERÃO CRIADOS.
NOTE: O script ".estoque.sh" pode localizar-se aonde você quiser, mas por padrão ele se localiza neste diretório também.
Default:
PathDir="$PathHome/ESTOQUE"
LOCALIZAÇÃO DO DIRETÓRIO AONDE OS ARQUIVOS/DIRETÓRIOS COM OS NOMES DOS FUNCIONÁRIOS SERÃO CRIADOS.
Default:
PathFuncionarios="$PathHome/FUNCIONARIOS"
LOCALIZAÇÃO DO DIRETÓRIO AONDE OS ARQUIVOS/DIRETÓRIOS COM OS NOMES DAS OBSERVAÇÕES SERÃO CRIADOS.
Default:
PathOBS="$PathHome/OBSERVAÇÕES"
CASO não pretenda fazer um diretório para este fim então deixe a variável "PathOBS=" assim:
PathOBS="XxXxXxXxXxX"
DIRETÓRIOS OU ARQUIVOS
É necessário criar um diretório para os materiais e outro diretório para os solicitantes (Usuários). Nesses diretórios serão colocados os nomes de todos os possíveis solicitantes e dos todos os materiais que serão usados em seu estoque, em forma de arquivos ou diretórios, respectivamente. Para o funcionamento deste script é indiferente esta opção desde que o seu arquivo "bashrc" esteja configurado para uma listagem comum de diretórios e aquivos (ou seja, ao executar o comando "ls" ele não exibará arquivos executáveis com o "*" no final do nome, nem o "/" no final dos nomes de diretórios [Se você não entendeu o que estou dizendo, então deixe a opção em sua configuração default]). Essa configuração existe para o caso de você resolver guardas fotos, manuais ou qualquer outra informação dos materiais usado no estoque e queira aproveitar o diretório de materiais já usado por este script, tornando desnecessário a recriação de um novo diretório para este fim.
Para Diretórios:
Faca=mkdir
Para Arquivos (Default):
Faca=touch
LOCALIZAÇÃO E NOME DO ARQUIVO QUE SERÁ USADO COMO BANCO DE DADOS.
Default:
PathDirFile="$PathDir/.estoque.txt"
NOTE: O padrão também é um arquivo oculto (seu nome começa com ".")
NOME DE ARQUIVOS DE SAÍDA:
Este script permite a formação de arquivos .txt (tanto na formatação Unix como na formatação Windows, configuração disponível logo abaixo) com um conteúdo filtrado ou não. Para estes arquivos que serão formados é necessário um nome e esta configuração de nomes é feita aqui.
NOTE: Não coloque a extensão ".txt" porque esta será inserido automaticamente.
Para arquivos de "Saldo Unitários" de estoque:
Default:
SaldoUnitarioFile=SaldoUnitario
Para arquivos de "Saldo de Conjuntos" de estoque:
Default:
SaldoUnitarioFile=SaldoConjunto
Para arquivos de "Saldo Total" de estoque:
Default:
SaldoTotalFile=SaldoTotal
Para arquivos de "Saldo de itens por um Funcionário":
Default:
SaldoFuncionarioFile=SaldoFunionario
Para arquivos de "Saldo de itens de todos Funcionários":
Default:
SaldoFuncionariosFile=SaldoFunionarioS
Para arquivos com materiais maior que certa quantidade:
Default:
SaldoQuantidadeMaiorFile=SaldoQuantitativoMaior
Para arquivos com materiais iguai a certa quantidade:
Default:
SaldoQuantidadeIgualFile=SaldoQuantitativoIgual
Para arquivos com materiais menores que certa quantidade:
Default:
SaldoQuantidadeMenorFile=SaldoQuantitativoMenor
Para arquivo de "listagem de registros de movimentação completa".
Default:
ListagemCompleta=ListagemCompleta
Para arquivos de "listagem de registros de movimentação completa".
Default:
ListagemParcial=ListagemParcial
Para arquivos de "Saldo Semanais".
Default:
SaldoSemanalfile=SaldoSemanalfile
FORMATO DE SAÍDA DE ARQUIVOS.
Os formatos da saída dos arquivos são ".txt" na formatação Unix. Porém eles podem ser formatados para o .txt do Windows, desde que você tenha o pacote "unix2dos" instalado em seu sistema (Debian e derivados).
Default:
FormateTXT=""
Opcional:
FormateTXT=windows
COR INDICADORA DE QUANTIDADE:
Este script tem suporte a cores e este é usado para realçar as quantidades de materiais na função saldo. Quando as funções de saldo forem efetuadas os itens que possuírem a quantidade especificada serão realçadas com a cor indicada (para essa situação), os item com maiores quantidades com uma outra cor indicativa de maior quantidade e os itens com menores quantidades com a outra cor indicativa de menor quantidade. O número, ou essa base quantitativa, para o cálculo das cores (igual, maior ou menor) é indicada abaixo.
Default:
QuantidadeAlerta=1
CORES INDICATIVA DE QUANTIDADE NO SALDO ESTOQUE:
Conforme explicação nas linhas anteriores você pode escolher as cores indicativas, ou alertas, de quantidade.
As cores disponíveis são:
- Para rosa use $ROSA
- Para verde use $VERDE
- Para amarelo use $AMARELO
- Para azul escuro use $AZUL_ESCURO
- Para lilas use $LILAS
- Para azul claro use $AZUL_CLARO
- Para branco use $BRANCO
- Para vermelho use $VERMELHO
- Para branco bold use $BRANCO_BOLD
Veja os exemplos e depois configure a seu gosto.
- Para anular efeito de cores:
COR_MAIOR_UM=""
COR_IGUAL_UM=""
COR_MENOR_UM=""
- Para indicar somente com a cor vermelha apenas os itens menor que a base quantitativa:
COR_MAIOR_UM=""
COR_IGUAL_UM=""
COR_MENOR_UM=$VERMELHO
- Para indicar cor verde para maior e cor amarela para igual que a base quantitativa, e a cor vermelha para menor:
COR_MAIOR_UM=$VERDE
COR_IGUAL_UM=$AMARELO
COR_MENOR_UM=$VERMELHO
Default:
COR_MAIOR_UM=""
COR_IGUAL_UM=$AMARELO
COR_MENOR_UM=$VERMELHO
CASO NÃO IDENTIFIQUE O SOLICITANTE
Quando registramos uma entrada de material nem sempre queremos descriminar o fornecedor, que neste caso seria descriminado na opção "solicitante", e é por isso que este script permite o lançamento de solicitantes vazios ou nulos. Nesses casos a configuração de um nome para representar esses solicitantes nulos é feita aqui.
SolicitanteNulo=???
A QUANTIDADE DE REGISTROS DO HISTÓRICO DE LANÇAMENTOS A SEREM EXIBIDOS NOS LANÇAMENTOS DE ENTRADA E SAÍDA DE MATERIAIS.
Ao fazer um registro de entrada e saída de material é exibido um resumo do histórico do solicitante, se este não estiver vazio, ou do material ( caso o solicitante esteja vazio). Este resumo é simplesmente os últimos "X" quantidade de registro do material ou do solicitante. Este "X" números é configurado aqui. Se colocar "0" nada será exibido.
NumeroDeExibicoesNoLancamento=5
Este script permite você saber a média de saídas de um produto por semana. Esta função existe primariamente para auxiliar a obtenção de novos materiais, porque assim é possível ter uma base de consumo daquele material e calcular um consumo de quantidade por um período específico.
A semanas e o ano do qual se começará a calcular a média é setada aqui. O ano tem 53 semanas (1 a 53) e o número da semana é descrita nos dois últimos dígitos da data (por exemplo: 2013-02-25_Seg_08 o número 08 se refere à oitava semana do ano 2013).
AnoDaSemana=2013
NumeroDaSemana=08
Ao fazer a média normalmente o número resultante é fracionado. Para setar a quantidade de dígitos depois da vírgula (ou melhor, o ponto) acerte a variável abaixo conforme exemplos:
- Para dois dígitos após a virgula (ponto).
scale=2
- Para três dígitos após a virgula (ponto).
scale=3
Versão 2 - Enviado por Ricardo Sabaliauskas em 21/03/2013
Changelog: Versão '1.1', corrigido um problema do saldo conjunto eliminando o 'grep -w' e substituindo por 'grep -P
calcaJeans_48
calcaJeans_48-usada
NOTE: Não foi possível colocar todo o script aqui, porque tem mais de 3500 linhas.
Removendo kernels antigos no Ubuntu
Script para desligar o servidor
Script de Backup para FITA DAT usando "afio"
Enviar mensagem ao usuário trabalhando com as opções do php.ini
Meu Fork do Plugin de Integração do CVS para o KDevelop
Compartilhando a tela do Computador no Celular via Deskreen
Como Configurar um Túnel SSH Reverso para Acessar Sua Máquina Local a Partir de uma Máquina Remota
Configuração para desligamento automatizado de Computadores em um Ambiente Comercial
Compartilhamento de Rede com samba em modo Público/Anônimo de forma simples, rápido e fácil
Cups: Mapear/listar todas as impressoras de outro Servidor CUPS de forma rápida e fácil
Criando uma VPC na AWS via CLI
Tem como instalar o gerenciador AMD Adrenalin no Ubuntu 24.04? (8)