Документация

Требования

• Сервер (физический или виртуальная машина) в локальной сети компании.
• ОС: Ubuntu 22.04 / 24.04, Debian 12, AlmaLinux / Rocky Linux 9 — либо любой хост с Docker.
• 2 ядра CPU, 2 ГБ RAM, 20 ГБ диска (минимум 10 ГБ свободно).
• Доступ к серверу по SSH с правами root/sudo для установки.
• Клиенты: современные браузеры. Для сканирования — смартфон или планшет с камерой.

Установка

Дистрибутив поставляется архивом. Установка выполняется одной командой:

tar -xzf inventory-1.0.tar.gz
cd inventory-1.0
sudo bash install.sh

Установщик спросит адрес системы, логин администратора и лицензионный ключ, затем: поставит веб-сервер и PHP, создаст базу данных, развернёт приложение, настроит сертификат для работы камеры и ежедневные резервные копии.

Вариант для Docker — отдельный комплект (веб-сервер, PHP и база в контейнерах):

cd inventory-docker
cp .env.example .env      # указать пароли и ключ
docker compose up -d

Точные команды и параметры установщика приведены в руководстве из архива — оно соответствует вашей версии и редакции ОС.

Первый вход

1. Откройте адрес системы в браузере — вас встретит страница входа (доступ к системе только после авторизации).
2. Войдите логином администратора, заданным при установке (или стандартным admin, если он был создан установщиком — смените пароль сразу).
3. В админке → Настройки укажите название организации, размеры этикеток и (при необходимости) параметры доменной авторизации.

Наполнение: кабинеты, виды, техника

• Локации и кабинеты — сначала создайте структуру помещений (здание → этаж → кабинет).
• Виды техники — ПК, ноутбук, МФУ, ИБП, монитор и т. д.
• Импорт из Excel (админка → Активы → Импорт): система сопоставит колонки по названиям (рус/англ), нормализует статусы и критичность, распределит технику по кабинетам. Дубликаты определяются по серийному номеру.
• Вручную — карточка актива: вид, производитель, модель, серийный и инвентарный номера, имя устройства, кабинет, ответственный, статус, URL, IP, критичность, доступность из интернета, примечание, фото.

Печать QR-кодов и этикеток

• Лист A4 по кабинету — QR всех устройств кабинета, чтобы наклеить на технику.
• QR кабинета — большой код на дверь: при сканировании открывается кабинет и кнопка «Начать обход».
• Этикетки — размеры задаются в настройках (ширина/высота в мм, размер QR).
• ZPL для Zebra — готовый файл для термопринтера (по кабинету).

QR-коды ведут на защищённый адрес системы, поэтому сканирование с телефона сразу попадает на нужную страницу.

Обход: как это выглядит на телефоне

1. Меню Обход → выберите кабинет (или откройте его, сканировав QR на двери).
2. Нажмите Включить камеру и наведите её на QR устройства — устройство отметится как «на месте», в списке появится галочка, прогресс обновится.
3. Если устройство из другого кабинета: раздаётся сигнал и вибрация, экран закрывает красная плашка «Актив не из этого кабинета», обход приостанавливается. Видно, где устройство числится и где найдено. После подтверждения обход продолжается.
4. Если камеру использовать нельзя — отметьте устройство вручную: серийный номер, имя или ID в поле под камерой.
5. Кнопка Завершить обход показывает результат: на месте / отсутствует / перемещено.

Камера и HTTPS — важный момент

Браузеры разрешают доступ к камере только на защищённом соединении. Поэтому:

• Обращайтесь к системе по адресу https://… (установщик настраивает сертификат для вашей сети).
• На телефон один раз нужно принять сертификат сайта: в инструкции поставляется файл сертификата и пошаговая памятка для Android и iPhone.
• Если HTTPS невозможен, обход полностью работает в режиме ручного ввода.

Пользователи и роли

• Администратор — всё: справочники, пользователи, настройки, решения по перемещениям.
• Редактор — ведёт технику и обходы; решения по перемещениям недоступны (это ответственность администратора).
• Наблюдатель — только просмотр карточек и отчётов.
• Опционально — вход через домен (LDAP/Active Directory) с проверкой группы доступа.

Обслуживание и резервные копии

• Ежедневный бэкап базы и файлов по расписанию (по умолчанию 03:10, хранение 14 дней) в каталог /var/backups/inventory.
• Ручной бэкап — из админки одним нажатием.
• Обновление версии — скриптом из нового архива: данные и настройки сохраняются.

Лицензия и продление

• Лицензия выдаётся файлом (подписанный и зашифрованный ключ) и привязана к числу устройств в вашем тарифе.
• Срок продлевается файлом лицензии — без доступа к интернету.
• После окончания срока система переходит в режим «только просмотр»: данные и отчёты доступны и выгружаются, но изменения и обходы блокируются до продления.
• Если оплата задерживается — можно запросить продление срока: мы выдаём дополнительный файл.

Частые вопросы