2.6 KiB
2.6 KiB
InviteMe
Приложение для регистрации гостей на корпоративные мероприятия. Аналог Timepad с упрощённым функционалом.
Возможности
- Загрузка списка гостей из Excel
- Хранение фото гостей и привязка по названию файла
- Генерация персональных QR-кодов
- Автоматическая рассылка приглашений на email
- Ручное добавление/удаление/блокировка участников
- Проверка входа по QR-коду или поиску по ФИО
- Аналитика посещаемости для администратора
- Выгрузка отчётов в Excel
Стек
- Python 3.10+
- Flask + Flask-SQLAlchemy
- SQLite
- Bootstrap 5
- html5-qrcode
- SMTP
Быстрый старт
cd C:\Projects\Integrita\InviteMe
python -m venv venv
venv\Scripts\activate
pip install -r requirements.txt
Создайте файл .env в корне проекта (см. docs/DEPLOY.md) и запустите:
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 и резервному копированию.