docs: подробный README (разбор проекта при переносе в Gitea)

Старый README сохранён как README.upstream.md.

README.upstream.md

@@ -0,0 +1,80 @@
+# vkmgr — StackWorks VK Hub
+
+Универсальное VK Mini App для групп ВКонтакте: заявки, услуги, клиенты, статусы, Telegram-уведомления и базовая админка.
+
+## Назначение
+
+`vkmgr` — SaaS/Mini App для владельцев групп VK. Первая версия закрывает самую частую боль групп: заявки теряются в личке, комментариях и сообщениях. Приложение даёт группе единый мини-кабинет: услуги, форма заявки, статусы, админка и уведомления.
+
+## Что внутри
+
+- `frontend/` — VK Mini App на React + VKUI + VK Bridge.
+- `backend/` — Node.js API на Express + SQLite.
+- `docs/` — roadmap, API, схема базы.
+- `infra/` — docker-compose и nginx-заготовка.
+- `install.sh` — базовый установщик на VPS.
+
+## MVP v0.1.0
+
+- Инициализация пользователя через VK launch params.
+- Подключение группы.
+- Каталог услуг.
+- Создание заявки клиентом.
+- Админский список заявок.
+- Смена статусов заявки.
+- Telegram-уведомление о новой заявке.
+- Базовые роли: owner, manager, client.
+
+## Быстрый запуск backend
+
+```bash
+cd backend
+cp .env.example .env
+npm install
+npm run dev
+```
+
+API будет доступен на `http://localhost:8080`.
+
+## Быстрый запуск frontend
+
+```bash
+cd frontend
+cp .env.example .env
+npm install
+npm run dev
+```
+
+Frontend будет доступен на `http://localhost:5173`.
+
+## Установка из репозитория на VPS
+
+```bash
+git clone https://github.com/viktor138irk/vkmgr.git
+cd vkmgr
+sudo bash install.sh
+```
+
+Можно задать домены перед запуском:
+
+```bash
+sudo FRONTEND_DOMAIN=vk.example.com API_DOMAIN=api-vk.example.com bash install.sh
+```
+
+После установки HTTPS:
+
+```bash
+certbot --nginx -d vk.example.com -d api-vk.example.com
+```
+
+## Для VK Mini Apps
+
+1. Создать приложение в кабинете VK-разработчика.
+2. Указать URL frontend в настройках mini app.
+3. В `frontend/.env` указать `VITE_API_URL`.
+4. В `backend/.env` указать `VK_APP_SECRET` для проверки подписи launch params.
+5. Для продакшна поставить HTTPS.
+
+## Важно
+
+Это стартовый MVP-скелет, не финальный SaaS. Перед боевым запуском нужно добавить полноценную проверку прав администратора группы через VK API, оплату тарифов, rate-limit, аудит действий и нормальную PostgreSQL/MySQL базу.