У меня есть гараж и кладовка в доме, где годами копились самые разные вещи: материалы для хобби, остатки стройматериалов, автомобильные запчасти и снаряжение для отдыха вроде лыж. Каждый раз, глядя на эти завалы, я откладывал уборку на потом, потому что не понимал, как вообще можно структурировать настолько разнородный хлам и потом быстро в нём ориентироваться. Доходило до абсурда: порой было проще и быстрее купить новую деталь или инструмент, чем откопать старый в этом бардаке.

Гараж не мой, но похож
Гараж не мой, но похож

Изучив коммерческие складские системы (WMS), я понял, что мне нужно адресное хранение. Однако громоздкие корпоративные решения для дома не подходят — чтобы системой реально пользовалась вся семья, она должна быть максимально простой, быстрой и независимой от облаков. Так родилась идея написать собственный инструмент.

Каким я видел идеальный домашний склад

Перед стартом разработки я определил для себя концепцию идеального домашнего сервиса. Главной болью был поиск: мне хотелось находить любую вещь за пару секунд по названию, артикулу или месту, не переворачивая все коробки вверх дном. Чтобы связать физический мир с цифровым, система должна была сама генерировать короткие адресные коды и макеты наклеек со штрихкодами и QR-кодами, которые можно распечатать и наклеить на каждый стеллаж, полку и контейнер.

Отдельное внимание я уделил сценариям использования со смартфона. Когда стоишь в гараже с коробкой в руках, некогда заполнять длинные анкеты: нужно сфотографировать предмет прямо из формы добавления, чтобы снимок сразу улетел в карточку товара, не засоряя личную галерею телефона. Кроме того, вещи и целые коробки постоянно кочуют с места на место, поэтому их перенос в интерфейсе должен занимать пару кликов.

С точки зрения эксплуатации мне требовался абсолютный минимализм: никакого развёртывания отдельных СУБД, облачных подписок и зависимости от интернета. Приложение должно работать по принципу Offline-First в домашней локальной сети на любом устройстве — от десктопа до старого смартфона в подвале, где плохо ловит Wi-Fi. Поскольку сервис крутится только внутри домашней сети для членов семьи, я осознанно отказался от системы паролей и ролей в пользу мгновенного доступа. А для полного спокойствия за сохранность базы резервное копирование должно было сводиться к обычному копированию одного файла с данными и папки с фотографиями. Проект изначально задумывался как Open Source.

Бэкенд: ни одной внешней зависимости и старт за 20 мс

Чтобы добиться нулевого порога входа при установке, решено было написать серверную часть на чистом Go (net/http) с использованием исключительно стандартной библиотеки. Это позволило полностью отказаться от PostgreSQL, SQLite, Redis и даже Docker.

Вместо классической базы данных вся реляционная структура — локации, категории и карточки вещей — сериализуется в единый читаемый файл db.json (структура DatabaseSnapshot). Конкурентный доступ из разных вкладок и устройств, а также атомарная перезапись файла на диск защищены стандартным мьютексом sync.RWMutex. Благодаря такому подходу сервер при запуске потребляет меньше 25 МБ оперативной памяти и стартует быстрее чем за 20 миллисекунд.

Работа с фотографиями построена напрямую поверх файловой системы, чтобы избежать лишних накладных расходов и защитить данные от перезаписи. Загружаемые снимки раскладываются по физическим подпапкам, имена которых дублируют код и название места хранения, например: uploads/h-c1-s3-b1_Box_1/. Каждому файлу присваивается префикс с идентификатором вещи формата [item_id]_[timestamp]_[rand].jpg. Когда пользователь удаляет или переносит предмет, сервер проверяет префикс за константное время \(O(1)\). Это гарантирует, что чужие фотографии в той же коробке никогда не затрутся, а при перемещении вещи её снимки физически переедут в новую директорию на диске, попутно удалив опустевшую старую папку.

Чтобы избавить пользователя от ручной настройки веб-сервера, собранный фронтенд (dist/) встраивается прямо внутрь Go-бинарника с помощью директивы embed. На выходе получается один исполняемый файл весом около 10 МБ, который без проблем запускается на Windows, Linux, macOS или Raspberry Pi и легко оформляется как системная служба через systemd или NSSM.

Фронтенд: строгая иерархия, защита от ошибок и работа с камерой

Клиентская часть построена на связке React 19, TypeScript и Tailwind CSS v4 со сборкой через Vite. Всю логику домашнего учёта я уложил в жёсткую четырёхуровневую иерархию по принципу «матрёшки»: Локация (Дом) → Мебель (Шкаф) → Полка (счёт идёт снизу вверх) → Контейнер (Коробка). При любых перестановках фронтенд и бэкенд синхронно пересчитывают короткие адресные коды вида h-c1-s3-b1 и следят, чтобы в дереве не возникло циклических зависимостей. Сами коробки и полки можно перетаскивать между шкафами прямо в визуальном дереве через Drag-and-Drop.

Так как системой пользуются живые люди в спешке, я заложил в интерфейс защиту от случайных действий и сбоев связи. Например, функция Safe Deletion физически не даст удалить полку или коробку, если внутри неё или её дочерних контейнеров числится хотя бы один предмет — сначала приложение покажет список вещей и предложит перенести их в другое место. На случай плохого сигнала Wi-Fi в гараже или подвале и на клиенте (inventoryStorage.ts), и на сервере (storage.go) реализована идемпотентность: дедупликация по уникальным ID гарантирует, что повторная отправка формы при обрыве связи обновит существующую запись, а не наплодит дублей.

Для работы с «железом» смартфона хватило стандартных возможностей браузера. В форме добавления товара используется атрибут <input type="file" capture="environment" />, который сразу открывает основную камеру телефона для фотофиксации детали. Если же пользователь сделал снимок, но передумал и закрыл окно без сохранения карточки, клиент мгновенно отправляет запрос DELETE /api/upload, чтобы на диске сервера не копились «сиротские» файлы. Печать этикеток также полностью перенесена в браузер: библиотека qrcode на HTML5 Canvas и кастомный SVG-генератор штрихкодов (Code-128) формируют готовые макеты наклеек как под рулонные термопринтеры, так и под обычные листы А4.

Наконец, чтобы поиск и интерфейс оставались отзывчивыми при любом сценарии, вся работа с состоянием инкапсулирована в InventoryStorageManager. Поиск работает в реальном времени и ищет по подстроке одновременно по названию, артикулу (SKU), штрихкоду, габаритам, заметкам, категории и адресному коду. При открытии страницы фронтенд пытается связаться с Go-сервером (syncWithServer), чтобы синхронизироваться с db.json. Если же открыть интерфейс автономно — например, как статическую демо-версию без бэкенда — он прозрачно продолжит работу через localStorage браузера. В завершение я добавил компактную мультиязычность на 11 языков (включая RTL-поддержку для арабского) на базе LanguageContext и обычного JSON-словаря, обойдясь без тяжёлых сторонних библиотек локализации.

Быстрый старт

Запуск готового релиза для Windows:

  1. Скачайте архив с GitHub и распакуйте его в любую папку.

  2. Запустите файл inventory.exe.

Сборка из исходников (на примере Windows x64):

bash

# Собираем фронтенд
npm install
npm run build

# Компилируем бэкенд
cd go-backend
go build -ldflags="-s -w" -o inventory.exe main.go

После сборки запускаем inventory.exe и начинаем наводить порядок )