From 044962bfd2c5c8a78324429aa8bc5cb7330584b7 Mon Sep 17 00:00:00 2001
From: Flooxik <m.rekunovi@mail.ru>
Date: Sat, 24 Oct 2026 14:09:12 +0000
Subject: [PATCH] =?UTF-8?q?=D0=97=D0=B0=D0=B3=D1=80=D1=83=D0=B7=D0=B8?=
 =?UTF-8?q?=D1=82=D1=8C=20=D1=84=D0=B0=D0=B9=D0=BB=D1=8B=20=D0=B2=20=C2=AB?=
 =?UTF-8?q?/=C2=BB?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..05698f5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,70 @@
+<p align="center">
+  <img src="icons/icon-512.png" width="140" alt="inventorEZ">
+</p>
+
+# 📦 inventorEZ | Инвентаризация вещей без лишнего
+
+Небольшое веб-приложение, чтобы знать, что где лежит: коробки, мешки, полки, шкафы. Списки с таблицами, перенос предметов, выгрузка в XLS и Word, QR-код на каждую коробку. Порядок везде!
+
+<p align="center">
+  <img src="screenshots/main.png" alt="Главная страница inventorEZ" width="860">
+</p>
+
+* * *
+
+## ✨ Возможности
+
+- **Списки двух видов.** Стандартные (название, количество, категория, расположение) и пользовательские: колонки для них собирает админ.
+- **Типы списков.** Коробка, мешок, полка и любые другие.
+- **Перенос и копирование.** Выбрали предметы, отправили в новый или существующий список. Если колонки отличаются, вы узнаете, что будет потеряно.
+- **ИТОГ.** Закрытый список превращается в аккуратную таблицу для просмотра или выгрузки. 
+- **Выгрузка.** XLS, Word (не данном этапе не рабочие) и PNG с QR-кодом.
+- **QR на коробку.** Сканируйте QR что бы увидеть содержимое или отредактировать его.
+- **Админ-панель.** Справочники, колонки, пользователи.
+
+* * *
+
+## 📸 Скриншоты
+
+<details>
+<summary>Нажмите, чтобы развернуть</summary>
+
+| Вход | Перенос между списками |
+| --- | --- |
+| <img src="screenshots/login.png" width="420"> | <img src="screenshots/transfer.png" width="420"> |
+
+| Итог с QR-кодом | Тёмная тема |
+| --- | --- |
+| <img src="screenshots/qr.png" width="420"> | <img src="screenshots/dark.png" width="420"> |
+
+</details>
+
+* * *
+
+## 📥 Установка на хостинг
+
+Нужен хостинг с **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/` рядом с файлами, в репозиторий они не попадают.
+
+* * *
+