Один исполняемый файл весом около 10 МБ, старт быстрее 20 миллисекунд и меньше 25 МБ оперативной памяти — так работает домашняя система адресного хранения HomeStorage под лицензией Apache-2.0. Разработчик Евгений (@GraviJohn) выкинул из стека всё, что обычно тянут в пет-проекты по привычке: PostgreSQL, SQLite, Redis, Nginx и Docker. Вся база лежит в одном читаемом JSON-файле, а интерфейс на React 19 зашит прямо внутрь бинарника.
Зачем гаражу своя WMS и почему облака здесь мешают
Знакомая картина: в гараже и кладовке годами копятся остатки стройматериалов, запчасти для машины, материалы для хобби и снаряжение вроде лыж. В какой-то момент проще купить новую деталь, чем перевернуть десять коробок в поисках старой.
На настоящих складах эту задачу решают WMS — системы адресного хранения, где у каждого стеллажа, полки и контейнера есть короткий код. Но корпоративные решения слишком тяжелы для семьи: им нужны серверы, роли и стабильный интернет. Облачные сервисы тоже быстро утомляют — в подвале или гараже Wi-Fi еле ловит, а платить подписку за список собственных саморезов мало кому хочется.
Отсюда выросли простые требования к домашнему инструменту. Режим Offline-First в локальной сети, чтобы всё летало и на домашнем компьютере, и на старом смартфоне в подвале. Никаких логинов и паролей внутри семьи, чтобы домочадцы реально пользовались сервисом. Быстрая фотосъёмка прямо из формы добавления без засорения личной галереи телефона. И резервное копирование обычным копированием одного файла с данными и папки с фото.
Бэкенд в одном файле: db.json, sync.RWMutex и //go:embed
Серверную часть написали на чистом Go (net/http) без единой внешней зависимости. Вся структура локаций, категорий и карточек вещей живёт в памяти в DatabaseSnapshot и сериализуется в один читаемый файл db.json.
Чтобы запросы из разных вкладок не подрались и файл не записался наполовину, конкурентный доступ и атомарную перезапись закрыли стандартным sync.RWMutex. Это блокировка чтения-записи: RLock пускает много параллельных читателей сразу, а Lock на долю миллисекунды отдаёт файл одному писателю, пока снимок целиком не ляжет на диск.
Собранный фронтенд (dist/) зашили прямо внутрь программы директивой //go:embed — специальным комментарием, по которому компилятор Go упаковывает статику в итоговый бинарник.
// Встраиваем собранный React-фронтенд внутрь Go-бинарника
//go:embed all:dist
var staticFiles embed.FS
// Хранилище защищает снимок db.json от гонок при записи
type Store struct {
mu sync.RWMutex
data DatabaseSnapshot
}
На выходе получается один файл для Windows, Linux, macOS или Raspberry Pi, который легко оформить как службу через systemd или NSSM. Собирается проект четырьмя командами.
# Собираем статику фронтенда через Vite
npm install
npm run build
# Компилируем Go-бэкенд без отладочных символов
cd go-backend
go build -ldflags="-s -w" -o inventory.exe main.go
Флаги -s -w убирают таблицу символов и отладочную информацию, ужимая inventory.exe примерно до 10 МБ. При запуске сервер сразу раздаёт интерфейс, принимает API-запросы и укладывается в 25 МБ памяти.
Фотографии не стали кодировать в base64 и не стали тащить объектное хранилище. Снимки лежат на диске в подпапках, которые повторяют код и имя места хранения, например uploads/h-c1-s3-b1_Box_1/. Имя файла всегда начинается с префикса [item_id]_[timestamp]_[rand].jpg. Простая схема именования заменяет кучу кода: при удалении или переносе вещи сервер проверяет префикс за константное время O(1), не задевает чужие фото в той же коробке, переносит нужные файлы в новую папку и удаляет опустевшую старую.
Фронтенд для гаража: матрёшка, камера и плохой Wi-Fi
Клиентская часть собрана на React 19, TypeScript, Tailwind CSS v4 и Vite. Всю логику уложили в жёсткую четырёхуровневую иерархию по принципу «матрёшки»: Локация (Дом) → Мебель (Шкаф) → Полка (счёт снизу вверх) → Контейнер (Коробка).
Полки и коробки можно перетаскивать между шкафами через Drag-and-Drop. При любой перестановке клиент и сервер синхронно пересчитывают короткие коды вида h-c1-s3-b1 и блокируют циклические зависимости.
От случайных ошибок в спешке защищает Safe Deletion: система не даст удалить полку или коробку, если внутри неё или в дочерних контейнерах числится хотя бы одна вещь. Вместо потери данных она покажет список предметов и предложит перенести их. Пощёлкай макет ниже, чтобы увидеть, как меняется адресный код, путь к файлу и реакция на удаление.
Интерактивный макет: адресный код, путь фото и Safe Deletion
Один и тот же адресный код попадает на бумажную наклейку, в дерево интерфейса и в название папки на диске. Даже если программа перестанет запускаться через пять лет, достаточно открыть uploads/ в проводнике, и всё останется понятным.
От обрывов Wi-Fi в подвале спасает идемпотентность — свойство операции, при котором повторная отправка формы с тем же уникальным ID обновляет запись, а не плодит дубли. Дедупликация работает с обеих сторон: в клиентском inventoryStorage.ts и серверном storage.go.
Для съёмки деталей со смартфона хватило одного HTML-атрибута capture со значением environment.
<!-- Открывает сразу тыловую камеру телефона (user — фронтальную) -->
<input type="file" accept="image/*" capture="environment" />
Мобильный браузер минует галерею и сразу включает основную камеру. А если ты сфотографировал болты, передумал и закрыл форму без сохранения, клиент тут же отправляет DELETE /api/upload, чтобы на диске не копились «сиротские» файлы.
Печать этикеток, автономный фолбэк и границы минимализма
Генерацию наклеек полностью перенесли в браузер: библиотека qrcode рисует QR-коды на HTML5 Canvas, а кастомный SVG-генератор собирает штрихкоды Code-128 под рулонные термопринтеры и листы А4.
Состояние на клиенте инкапсулировано в InventoryStorageManager. Поиск работает в реальном времени по подстроке сразу по названию, SKU, штрихкоду, габаритам, заметкам, категории и адресному коду. При открытии страницы клиент пытается синхронизироваться с сервером через syncWithServer, а если бэкенд недоступен (например, открыли статическое демо), прозрачно переходит на localStorage. Плюс добавили мультиязычность на 11 языков, включая RTL (письмо справа налево для арабского), на LanguageContext и обычном JSON-словаре.
За такой минимализм приходится платить двумя понятными ограничениями. Первое — масштаб: db.json под sync.RWMutex отлично тянет 1–5 пользователей и тысячи карточек, но при десятках тысяч вещей и частых параллельных записях полная перезапись файла станет узким местом. Тогда без потери формата «один бинарник» стоит перейти на SQLite (в чистом Go — через modernc.org/sqlite), а для десятков сотрудников и ролей уже поднимать PostgreSQL.
Второе ограничение — безопасность. Отказ от паролей удобен только в доверенной домашней сети. Выставлять HomeStorage в открытый интернет напрямую нельзя: для удалённого доступа перед бинарником нужен reverse-proxy с авторизацией или вход через VPN.

![Node.JS [ru]](/api/digests/it_development/daily/20261122/assets/sources/we-use-js.jpg?v=8a922c4c9193ead8575dd869ae7a5dafe5bd8590efaaa20c7d3842b3cedee257)

