silinhas / stock-manager

Sistema Full-Stack avançado para gestão de estoque de produtos, oferecendo uma interface amigável e uma dashboard para controle.

IStock

IStock é uma ferramenta fácil de utilizar para gerenciamento de estoque.

📲 Funcionalidades

• Controle de produtos em estoque.
• Registro de vendas.
• Geração de etiquetas para produtos.
• Vendas agéis utilizando o QR Code da Etiqueta em dispositivos móveis.
• Controle de categorias.
• Controle de funcionários.
• Controle de fornecedores.
• Controle de viagens para reabastecimento de estoque.
• Dashboard com diversos dados.

🧰 Tecnologias

🔧 Como Instalar

Requisitos:

• Node.js 18 ou superior
• npm 9 ou superior
• Git

# Atualize seu npm
npm install npm@9 -g

git clone https://github.com/viniciusg23/stock-manager.git
cd stock-manager

Configuração do Ambiente: Utilizando algum editor, crie um novo arquivo na raiz do diretório stock-manager chamado .env e nele adicione.

#URI do MongoDB (Faça as mudanças necessárias)
MONGODB_URI=mongodb+srv://user:[e-mail]/database_name?retryWrites=true&w=majority

#Segredo do Json Web Token
JWT_SECRET=your-secret


#Senha do sistema para algumas operações específicas
SYSTEM_CONTROL_PASSWORD=your-system-password


#Ambiente (por padrão é development)
ENVIROMENT=development

🐋 Docker

Se você possui o docker instalado em seu computador, você pode fazer deploy do sistema com apenas um comando e poucos segundos:

sudo docker run -p 5000:3000 --env-file .env -d viniciusgg/istock:v1.0.0

O valor 5000 pode ser alterado para o número da porta que deseja que seu sistema seja executado em sua máquina. Utilizando o valor 5000 após executar este comando o sistema já estará disponível em http://localhost:5000/.

🚀 Produção

Edite o arquivo .env.

ENVIROMENT=production

Para executar o sistema em produção:

# Windows
npm run win-prod

# Linux
npm run prod

Outros comandos úteis do pm2:

# listar todos os serviços em execução
npx pm2 list

# reinicia o serviço
npx pm2 restart app_name

# encerra o serviço
npx pm2 stop app_name

# apaga o serviço
npx pm2 delete app_name

🧪 Desenvolvimento

Para executar o sistema em desenvolvimento:

# Instalação do node_modules
npm run setup

# Execução do ambiente de desenvolvimento
npm run dev

Agora IStock está rodando em http://localhost:3001/

📄 Informações da API

Pode acessar uma documentação extensa da API em:

Documentação API

Assim como pode obter um arquivo para visualizar e editar o collection da API.

💻 Informações Sobre o Sistema

Gerenciamento de Produtos:

Gerenciamento de Estoque:

Gerenciamento de Funcionários:

Vendas:

Validação de uma viagem para reabastecimento de Estoque:

Dashboard: