Initial top-reservation app: bookings, objects catalog, statistics, PWA

README.md

@@ -0,0 +1,29 @@
+# top-reservation
+
+Бронирования Фестиваль-Парк: создание брони, список бронирований с фильтрами, статистика по объектам за месяц. Полная замена прежнего Telegram-бота — та же логика (`/book`, `/week`, `/statistic`), но обычной веб-формой, со справочником объектов вместо свободного текста и кнопкой копирования сводки бронирования.
+
+## Запуск в Docker
+
+```bash
+cp .env.example .env
+# заполнить ADMIN_BOOTSTRAP_EMAIL / ADMIN_BOOTSTRAP_PASSWORD в .env
+
+docker compose up --build -d
+```
+
+Приложение слушает `:8087`. При первом старте контейнер сам применяет миграции, создаёт админ-аккаунт из `.env` и засеивает стартовый список объектов (Баня, Афрейм, Дом с ванной и т.д. — можно менять в **Настройки → Объекты**).
+
+## Локальная разработка
+
+```bash
+npm install
+cp .env.example .env
+npm run db:migrate
+npm run bootstrap-admin
+npm run seed-objects
+npm run dev
+```
+
+## Установка как приложение
+
+Страница отдаёт `manifest.webmanifest` — на телефоне через «Добавить на экран Домой» (Android Chrome) или «На экран Домой» (iOS Safari) можно поставить как обычное приложение, без адресной строки браузера.