stash

O Stash é um sistema de inventário doméstico auto-hospedado para uma única residência que trata os itens principalmente como objetos etiquetados com códigos de barras ou QR codes. Em vez de servir como uma ferramenta de receitas ou planejamento de refeições, ele foca em fluxos rápidos de reabastecimento/consumo, rastreamento de estoque baixo e validade, etiquetas imprimíveis e automação opcional via webhooks de saída. Principais recursos: - Escaneamento contínuo por câmera nos modos Reabastecer (+1) e Consumir (−1) com dicas de formato, alta resolução, foco automático, sinal sonoro, feedback tátil e alternância de flash para pouca luz. Códigos de barras desconhecidos criam automaticamente um novo item e abrem uma janela rápida para localização e limite. - Modelo unificado de item+código de barras com suporte a UPC/EAN, QR codes internos próprios (com deep-link para o item), códigos de pareamento Matter e números de série manuais. Um único botão de impressão envia apenas a simbologia de código de barras selecionada, o que é importante quando um item possui múltiplos códigos. - Modo de ativo (Asset) para dispositivos físicos individuais, com rastreamento de estado de conservação, entrada de código de barras com número de série e histórico de manutenção; itens de ativos são excluídos da lógica de lista de compras e estoque baixo. - Localizações e categorias aninhadas exibidas como uma árvore recuada, com busca, filtros, ordenação, paginação e memorização do último estado de filtro/ordenação utilizado. Operações em massa permitem mover ou excluir itens selecionados de uma só vez. - Detalhes do item incluem quantidade, limite de estoque baixo, datas de validade/garantia, preço com moeda padrão, edição direta de nome/unidade, anexos e logs de ajuste/manutenção. - Anexos de arquivos para recibos, manuais, garantias e fotos. Qualquer imagem pode se tornar o avatar representativo do item; os uploads são redimensionados automaticamente. - Painel (Dashboard) destacando valor total do inventário, itens com estoque baixo, itens próximos da validade e itens adicionados recentemente, além de uma lista de verificação de integração para localizações, notificações e URL pública. - Lista de compras gerada a partir de itens com estoque baixo ou entradas adicionadas manualmente, com notas e caixa de seleção de comprado; os itens saem automaticamente assim que o estoque ultrapassa o limite. - Consultas de produtos plugáveis opcionais (Open Food Facts, UPCItemDB, Naver Shopping) por escaneamento, ou totalmente desativadas. - Importação/exportação CSV, incluindo valores de códigos de barras, para entrada em massa e transferência de dados com planilhas. - Impressão de etiquetas como PNG individual ou folha de etiquetas PDF em formato A4, com caixa de busca no seletor; tipografia em coreano é suportada por meio de um subconjunto integrado do Noto Sans KR. - Notificações Web Push para eventos de validade/garantia e um resumo semanal de estoque baixo. - Exclusão lógica (Soft delete) com aviso de desfazer, restauração e depuração automática em 30 dias. - PWA amigável para uso offline: app shell em cache, respostas de itens em cache e uma fila de escaneamento offline que sincroniza quando a conexão retorna. - Webhook de inventário de saída para automações de impressora ou Home Assistant, com falhas de última entrega visíveis nas Configurações e verificação de assinatura HMAC-SHA256 opcional. - Contas familiares de múltiplos usuários com funções de administrador/geral, inicialização do primeiro administrador, redefinição de senha de administrador única, desconectar de todos os dispositivos, backup/restauração e i18n em ko/en com tema claro/escuro. Fora do escopo: planejamento de receitas/refeições, suporte a múltiplas residências (multi-tenancy) dentro de um único processo. A implantação está disponível via Docker Compose ou através de um instalador Proxmox LXC com um clique. Uma configuração de desenvolvimento local utiliza PostgreSQL, migrações Prisma e servidores de desenvolvimento web/API separados. As imagens são publicadas no GitHub Container Registry, e as notas de produção cobrem serviço em subcaminho (subpath), verificação de integridade (health check) e gerenciamento de segredos.