Обновить README.md

README.md

@@ -0,0 +1,51 @@
+<p align="center">
+  <img src="icons/icon-512.png" width="140" alt="inventorEZ">
+</p>
+
+# 📦 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/` рядом с файлами, в репозиторий они не попадают.
+
+* * *
+
+## Поддержка
+
+Если хотите меня поддержать, то прошу на мой Boosty: https://boosty.to/flooxik
+