Initial commit: InviteMe event registration app

README.md

@@ -0,0 +1,76 @@
+# InviteMe
+
+Приложение для регистрации гостей на корпоративные мероприятия. Аналог Timepad с упрощённым функционалом.
+
+## Возможности
+
+- Загрузка списка гостей из Excel
+- Хранение фото гостей и привязка по названию файла
+- Генерация персональных QR-кодов
+- Автоматическая рассылка приглашений на email
+- Ручное добавление/удаление/блокировка участников
+- Проверка входа по QR-коду или поиску по ФИО
+- Аналитика посещаемости для администратора
+- Выгрузка отчётов в Excel
+
+## Стек
+
+- Python 3.10+
+- Flask + Flask-SQLAlchemy
+- SQLite
+- Bootstrap 5
+- html5-qrcode
+- SMTP
+
+## Быстрый старт
+
+```bash
+cd C:\Projects\Integrita\InviteMe
+python -m venv venv
+venv\Scripts\activate
+pip install -r requirements.txt
+```
+
+Создайте файл `.env` в корне проекта (см. `docs/DEPLOY.md`) и запустите:
+
+```bash
+flask --app run.py run --host=0.0.0.0 --port=5000
+```
+
+## Учётные записи по умолчанию
+
+- Админ: `admin` / `admin`
+- Сотрудник на входе: `staff` / `staff`
+
+> Обязательно смените пароли в production через переменные окружения или `.env`.
+
+## Структура проекта
+
+```
+InviteMe/
+├── app/
+│   ├── __init__.py
+│   ├── models.py           # Модели Guest и CheckIn
+│   ├── routes.py           # Все маршруты приложения
+│   ├── services/           # QR, email, Excel
+│   ├── static/
+│   │   ├── css/
+│   │   ├── js/
+│   │   └── uploads/        # Фото и QR-коды
+│   └── templates/
+│       ├── admin/
+│       ├── checkin/
+│       └── email/
+├── config.py               # Конфигурация
+├── docs/
+│   └── DEPLOY.md           # Подробная инструкция по развёртыванию
+├── requirements.txt
+├── run.py
+└── README.md
+```
+
+## Контекст проекта
+
+Проект разрабатывается для компании **Integrita**. Планируется развёртывание на виртуальной машине.
+
+См. `docs/DEPLOY.md` для инструкций по настройке SMTP, запуску в production и резервному копированию.