Spoolman

O Spoolman é um gestor de inventário de filamentos autoalojado, construído especificamente para entusiastas de impressão 3D e quintas de impressão. Substitui folhas de cálculo ad-hoc e notas manuscritas por uma base de dados estruturada e pesquisável que rastreia cada bobina de filamento desde a compra até ao último grama. Os perfis de material armazenam o 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 quaisquer dependências externas, tornando o Spoolman fácil de implementar como um único contentor em qualquer VPS – sem necessidade de configuração de base de dados externa ou configuração complexa.

Casos de Uso Comuns

Os entusiastas domésticos utilizam o Spoolman para rastrear o filamento restante em dezenas de bobinas parcialmente usadas, eliminando falhas a meio da impressão causadas pela falta inesperada de material. As quintas de impressão utilizam-no como um centro de inventário central – os operadores digitalizam a etiqueta QR numa bobina antes de a carregar, e o Moonraker regista automaticamente o peso estimado consumido assim que a impressão é concluída. Os revendedores de filamentos e estúdios utilizam os perfis de material do Spoolman para manter um catálogo de produtos de cada material e cor em stock, facilitando a consulta de especificações técnicas durante as consultas com os clientes. Os Makerspaces partilham uma única instância do Spoolman em várias impressoras e entre membros, com cada bobina rastreada para uma máquina e utilizador específicos para decisões precisas de custo e reabastecimento.

Funcionalidades Principais

• Gestão de inventário de bobinas: registe o fabricante, material, cor, peso inicial e filamento restante para cada bobina
• Perfis de material e fabricante: armazene configurações reutilizáveis de temperatura, densidade e cor que se aplicam a todas as bobinas de um determinado tipo
• REST API: API CRUD completa para bobinas, materiais e fabricantes acessível em /api/v1
• Integração Klipper e Moonraker: o suporte nativo da API permite que a sua impressora registe automaticamente o uso da bobina após a conclusão da impressão
• Etiquetas de código QR: gere etiquetas QR digitalizáveis para cada bobina que abrem o perfil completo em qualquer navegador móvel
• Atualizações em tempo real do WebSocket: as alterações de inventário são enviadas para todos os clientes instantaneamente sem atualização da página
• Múltiplos backends de base de dados: SQLite por predefinição; PostgreSQL, MariaDB e CockroachDB suportados para cargas de trabalho multiutilizador ou de alta escrita
• Backups automáticos do SQLite: backups agendados do ficheiro da base 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 monitorização via /metrics
• Executa como utilizador não-root: o processo do contentor executa como um utilizador de aplicação restrito, melhorando a segurança do contentor sem qualquer configuração extra

Porquê implementar o Spoolman num VPS da Hostinger

Executar o Spoolman num VPS da Hostinger oferece à sua oficina ou quinta de impressão um servidor de inventário persistente e sempre ativo, acessível a partir de qualquer dispositivo na sua rede ou na internet – sem depender de um PC que fica

desativado, e não é necessária subscrição na cloud. Todos os dados de inventário permanecem no seu servidor, sem que nenhum serviço de terceiros veja que materiais utiliza ou quanto imprime. O backend SQLite leve significa que mesmo um pequeno plano VPS lida com um grande catálogo de filamentos sem preocupações de desempenho, e o encaminhamento HTTPS do Traefik oferece-lhe um URL seguro e acessível por navegador sem qualquer gestão manual de certificados. Quando a sua quinta cresce, mudar para PostgreSQL ou MariaDB requer apenas algumas alterações nas variáveis de ambiente e uma migração de dados.