inventorEZ/README.md

📦 inventorEZ | Инвентаризация вещей без лишнего

Небольшое веб-приложение, чтобы знать, что где лежит: коробки, мешки, полки, шкафы. Списки с таблицами, перенос предметов, выгрузка в XLS и Word, QR-код на каждую коробку. Порядок везде!

✨ Возможности

• Списки двух видов. Стандартные (название, количество, категория, расположение) и пользовательские: колонки для них собирает админ.
• Типы списков. Коробка, мешок, полка и любые другие.
• Перенос и копирование. Выбрали предметы, отправили в новый или существующий список. Если колонки отличаются, вы узнаете, что будет потеряно.
• ИТОГ. Закрытый список превращается в аккуратную таблицу для просмотра или выгрузки.
• Выгрузка. XLS, Word (не данном этапе не рабочие) и PNG с QR-кодом.
• QR на коробку. Сканируйте QR что бы увидеть содержимое или отредактировать его.
• Админ-панель. Справочники, колонки, пользователи.

---

📥 Установка на хостинг

Нужен хостинг с PHP 8.1 или новее. Расширения и база данных не требуются.

1. Возьмите файлы ветки release: index.html, api.php, manifest.webmanifest и папку icons.
2. Загрузите их в папку сайта (например, www/ваш-домен/).
3. Откройте сайт и войдите: логин admin, пароль admin.
4. Сразу смените пароль: до этого работа с сайтом недоступна.
5. На вкладке «Пользователи» добавьте тех, кто будет работать со списками.
6. Откройте https://ваш-домен/data/users.json: страница не должна открываться (403 или 404). Если открывается, закройте папку data в настройках сайта или веб-сервера.

Папка data (списки, пароли, настройки) создаётся автоматически при первом входе.

---

🖥 Локальный запуск

Нужен PHP 8.1+ (Windows: https://windows.php.net/download/, архив Thread Safe, добавить в Path).

php -S localhost:8080

Запускать из папки с файлами проекта, затем открыть http://localhost:8080/. Данные пишутся в data/ рядом с файлами, в репозиторий они не попадают.

---