stash

Stash es un sistema de inventario doméstico autoalojado para un solo hogar que trata los elementos principalmente como objetos etiquetados con códigos de barras o códigos QR. En lugar de servir como una herramienta de recetas o planificación de comidas, se centra en flujos rápidos de reabastecimiento/consumo, seguimiento de bajo stock y caducidad, etiquetas imprimibles y automatización opcional mediante webhooks salientes. Funcionalidades clave: - Escaneo continuo por cámara en modos Reabastecer (+1) y Consumir (−1) con sugerencias de formato, mayor resolución, enfoque automático, pitido audible, retroalimentación háptica y un conmutador de flash para poca luz. Los códigos de barras desconocidos crean automáticamente un nuevo elemento y abren una hoja rápida para la ubicación y el umbral. - Modelo unificado de elemento+código de barras compatible con UPC/EAN, códigos QR internos de emisión propia (con enlace profundo al elemento), códigos de emparejamiento Matter y números de serie manuales. Un único botón de impresión envía solo la simbología de código de barras seleccionada, lo que resulta importante cuando un elemento lleva múltiples códigos. - Modo activo (asset) para dispositivos físicos individuales, con seguimiento del estado, entrada de código de barras con número de serie y un registro de historial de mantenimiento; los elementos tipo activo están excluidos de la lógica de lista de la compra y bajo stock. - Ubicaciones y categorías anidadas representadas como un árbol sangrado, con búsqueda, filtros, ordenación, paginación y almacenamiento del último estado de filtro/ordenación utilizado. Las operaciones masivas permiten mover o eliminar los elementos seleccionados a la vez. - El detalle del elemento incluye cantidad, umbral de bajo stock, fechas de caducidad/garantía, precio con moneda predeterminada, edición integrada de nombre/unidad, archivos adjuntos y registros de ajuste/mantenimiento. - Archivos adjuntos para recibos, manuales, garantías y fotos. Cualquier imagen puede convertirse en el avatar representativo del elemento; las subidas se redimensionan automáticamente. - Panel de control que destaca el valor total del inventario, elementos con bajo stock, elementos a punto de caducar y elementos añadidos recientemente, además de una lista de verificación de inicio para ubicaciones, notificaciones y URL pública. - Lista de la compra creada a partir de elementos con bajo stock o entradas añadidas manualmente, con notas y una casilla de verificación de comprado; los elementos se eliminan automáticamente una vez que el stock supera su umbral. - Búsquedas de productos opcionales y conectables (Open Food Facts, UPCItemDB, Naver Shopping) por escaneo, o desactivadas por completo. - Importación/exportación CSV, incluidos los valores de código de barras, para la entrada masiva y la integración con hojas de cálculo. - Impresión de etiquetas como PNG individual o PDF de hoja de etiquetas A4, con un cuadro de búsqueda en el selector; la tipografía coreana es compatible mediante un subconjunto incluido de Noto Sans KR. - Notificaciones Web Push para eventos de caducidad/garantía y un resumen semanal de bajo stock. - Eliminación suave (soft delete) con aviso para deshacer, restauración y purga automática tras 30 días. - PWA apta para uso sin conexión: app shell en caché, respuestas de elementos en caché y una cola de escaneo sin conexión que se sincroniza cuando vuelve la conectividad. - Webhook saliente de inventario para automatizaciones de impresoras o Home Assistant, con los últimos fallos de entrega visibles en Configuración y verificación de firma HMAC-SHA256 opcional. - Cuentas familiares multiusuario con roles de administrador/general, inicialización del primer administrador, restablecimiento de contraseña de administrador de un solo uso, cierre de sesión en todas partes, copia de seguridad/restauración e internacionalización (i18n) ko/en con tema claro/oscuro. Fuera del alcance: planificación de recetas/comidas, multiarrendamiento por hogar dentro de un único proceso. El despliegue está disponible como Docker Compose o como un instalador Proxmox LXC de un solo clic. Una configuración de desarrollo local utiliza PostgreSQL, migraciones de Prisma y servidores de desarrollo API/web independientes. Las imágenes se publican en GitHub Container Registry, y las notas de producción cubren el servicio en subrutas, comprobación de estado y gestión de secretos.