Sistema de gestão logística industrial com assistente de inteligência artificial e monitoramento autônomo.
O SLR é uma plataforma web para gerenciamento de almoxarifados e operações logísticas industriais. Permite controlar produtos, estoque, movimentações e ordens de serviço, com o apoio de um assistente de IA (ARIA) e um agente autônomo de vigilância (ARIA Guardião) que monitora o sistema 24 horas por dia.
- Controlar o cadastro de produtos e seus códigos (QR Code e código de barras)
- Acompanhar o estoque em tempo real, com alertas de quantidade mínima
- Registrar movimentações de entrada, saída e ajuste
- Gerenciar ordens de serviço de separação, expedição e recebimento
- Organizar a localização física dos produtos no almoxarifado
- Consultar a IA para análises e sugestões de reposição
- Monitorar a saúde do sistema automaticamente, com recuperação de falhas
Cadastro de produtos com código único, unidade, categoria e fornecedor. Controle de estoque com alertas de quantidade mínima. Movimentações de entrada, saída e ajuste com registro de operador. Localização física por rua, prateleira e nível.
Criação de ordens de separação, expedição e recebimento, com controle de status, prioridade e itens por ordem.
Assistente integrado baseado em Claude (Anthropic) para consultas em linguagem natural sobre o estoque e sugestões automáticas de reposição. Possui modo de contingência quando a IA não está disponível.
Login com JWT (JSON Web Token), senhas criptografadas com bcrypt e perfis de acesso para administrador e operador. Os usuários padrão são criados automaticamente no primeiro acesso.
Agente autônomo que verifica a saúde do sistema a cada 5 minutos, reinicia serviços com falha, registra o histórico de incidentes e sinaliza quando é necessária intervenção humana.
cp backend/.env.example backend/.env
# Edite o .env e informe sua ANTHROPIC_API_KEY
docker compose up -dO backend fica disponível em http://localhost:8000 e o frontend em http://localhost:3000.
Backend:
cd backend
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
uvicorn app.main:app --host 0.0.0.0 --port 8000Frontend:
cd frontend
npm install
npm run devARIA Guardião:
pm2 start backend/guardian.py --name aria-guardian --interpreter python3
pm2 save| Método | Rota | Descrição |
|---|---|---|
| GET | /health | Status do sistema |
| POST | /auth/login | Autentica e retorna o token JWT |
| GET | /auth/me | Dados do usuário autenticado |
| GET | /dashboard/ | Painel com indicadores gerais |
| GET | /produtos/ | Lista os produtos |
| POST | /produtos/ | Cadastra um produto |
| GET | /estoque/ | Lista o estoque |
| GET | /estoque/alertas | Produtos abaixo do estoque mínimo |
| POST | /movimentacoes/ | Registra uma movimentação |
| GET | /ordens/ | Lista as ordens de serviço |
| POST | /ia/consulta | Consulta a assistente ARIA |
A documentação interativa completa está disponível em /docs (Swagger UI).
O ARIA Guardião monitora a saúde dos serviços e executa as seguintes ações:
- Verifica, a cada 5 minutos, se os processos estão ativos e respondendo.
- Reinicia automaticamente qualquer serviço que apresentar falha.
- Registra cada incidente em um arquivo de histórico (
guardian_history.json). - Após duas tentativas sem sucesso, sinaliza que é necessária intervenção humana.
Para acompanhar os registros em tempo real:
pm2 logs aria-guardian- Atualizar o frontend para autenticação JWT
- Notificações do ARIA Guardião via Telegram
- Relatórios exportáveis (PDF e Excel)
- Suporte completo a banco MySQL em produção
Robson Vieira