Spoolman

Spoolman é um gerenciador de estoque de filamentos auto-hospedado, desenvolvido especificamente para entusiastas de impressão 3D e fazendas de impressão. Ele substitui planilhas ad-hoc e anotações manuscritas por um banco de dados estruturado e pesquisável que rastreia cada carretel de filamento, desde a compra até o último grama. Os perfis de material armazenam fabricante, cor, tipo de material, densidade e configurações de temperatura, para que os dados corretos estejam sempre à mão ao configurar uma nova impressão. O backend leve do SQLite funciona sem dependências externas, tornando o Spoolman fácil de implantar como um único contêiner em qualquer VPS — sem necessidade de configuração de banco de dados externo ou complexa.

Casos de Uso Comuns

Entusiastas domésticos usam o Spoolman para rastrear o filamento restante em dezenas de carretéis parcialmente usados, eliminando falhas no meio da impressão causadas pela falta inesperada de material. Fazendas de impressão o utilizam como um centro de inventário central — os operadores escaneiam a etiqueta QR em um carretel antes de carregá-lo, e o Moonraker registra automaticamente o peso estimado consumido assim que a impressão é concluída. Revendedores de filamentos e estúdios usam os perfis de material do Spoolman para manter um catálogo de produtos de cada material e cor em estoque, facilitando a consulta de especificações técnicas durante as consultas com clientes. Makerspaces compartilham uma única instância do Spoolman entre várias impressoras e membros, com cada carretel rastreado para uma máquina e usuário específicos para decisões precisas de custo e reabastecimento.

Principais Recursos

• Gerenciamento de estoque de carretéis: registre fabricante, material, cor, peso inicial e filamento restante para cada carretel
• Perfis de material e fabricante: armazene configurações reutilizáveis de temperatura, densidade e cor que se aplicam a todos os carretéis de um determinado tipo
• API REST: API CRUD completa para carretéis, materiais e fabricantes, acessível em /api/v1
• Integração com Klipper e Moonraker: o suporte nativo à API permite que sua impressora registre o uso do carretel automaticamente ao concluir a impressão
• Etiquetas de código QR: gere etiquetas QR escaneáveis para cada carretel que abrem o perfil completo em qualquer navegador móvel
• Atualizações em tempo real via WebSocket: as alterações de inventário são enviadas a todos os clientes instantaneamente, sem a necessidade de atualizar a página
• Múltiplos backends de banco de dados: SQLite por padrão; PostgreSQL, MariaDB e CockroachDB são suportados para cargas de trabalho multiusuário ou de alta gravação
• Backups automáticos do SQLite: backups programados do arquivo do banco de dados evitam a perda acidental de dados
• Endpoint de métricas Prometheus: exponha estatísticas de inventário ao Grafana e outras ferramentas de monitoramento via /metrics
• Executa como usuário não-root: o processo do contêiner é executado como um usuário de aplicativo restrito, melhorando a segurança do contêiner sem qualquer configuração extra

Por que implantar o Spoolman no VPS da Hostinger

Executar o Spoolman em um VPS da Hostinger oferece à sua oficina ou fazenda de impressão um servidor de inventário persistente e sempre ativo, acessível de qualquer dispositivo em sua rede ou na internet — sem depender de um PC que desativado, e nenhuma assinatura de nuvem é necessária. Todos os dados de inventário permanecem no seu servidor, sem que nenhum serviço de terceiros veja quais materiais você usa ou quanto você imprime. O backend leve do SQLite significa que até mesmo um pequeno plano de VPS lida com um grande catálogo de bobinas sem preocupações de desempenho, e o roteamento HTTPS do Traefik oferece uma URL segura e acessível pelo navegador, sem qualquer gerenciamento manual de certificados. Quando sua fazenda cresce, mudar para PostgreSQL ou MariaDB requer apenas algumas alterações nas variáveis de ambiente e uma migração de dados.