Очистка истории от тестовых данных и обновление документации
- Удалены все файлы из app/static/uploads/ из истории git - Обновлен .gitignore для сохранения структуры .gitkeep в подпапках uploads - Обновлены docs/CONTEXT.md и docs/DEPLOY.md: убраны начальные пользователи admin/admin, staff/staff, упоминание конкретных путей и компании - Добавлены актуальные пути к папкам мероприятий
This commit is contained in:
+3
-2
@@ -12,8 +12,9 @@ instance/
|
|||||||
*.db
|
*.db
|
||||||
*.sqlite3
|
*.sqlite3
|
||||||
|
|
||||||
app/static/uploads/*
|
app/static/uploads/**
|
||||||
!app/static/uploads/.gitkeep
|
!app/static/uploads/**/
|
||||||
|
!app/static/uploads/**/.gitkeep
|
||||||
|
|
||||||
*.log
|
*.log
|
||||||
.DS_Store
|
.DS_Store
|
||||||
|
|||||||
+3
-8
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
## Назначение
|
## Назначение
|
||||||
|
|
||||||
InviteMe — внутреннее веб-приложение для компании **Integrita**, предназначенное для организации регистрации гостей на корпоративные мероприятия. Является упрощённым аналогом Timepad: загрузка списка участников, генерация персональных QR-кодов, рассылка приглашений, контроль входа на мероприятии и административная аналитика.
|
InviteMe — веб-приложение для организации регистрации гостей на корпоративные мероприятия. Является упрощённым аналогом Timepad: загрузка списка участников, генерация персональных QR-кодов, рассылка приглашений, контроль входа на мероприятии и административная аналитика.
|
||||||
|
|
||||||
## Бизнес-процесс
|
## Бизнес-процесс
|
||||||
|
|
||||||
@@ -18,7 +18,7 @@ InviteMe — внутреннее веб-приложение для компа
|
|||||||
- `название фото`
|
- `название фото`
|
||||||
4. Собирает фотографии гостей. Название каждого файла должно совпадать со значением в столбце `название фото`.
|
4. Собирает фотографии гостей. Название каждого файла должно совпадать со значением в столбце `название фото`.
|
||||||
5. В админ-панели выбирает созданное мероприятие и загружает Excel. Система создаёт записи гостей в рамках этого мероприятия и генерирует для каждого уникальный QR-код.
|
5. В админ-панели выбирает созданное мероприятие и загружает Excel. Система создаёт записи гостей в рамках этого мероприятия и генерирует для каждого уникальный QR-код.
|
||||||
6. Загружает фото (по одному или ZIP-архивом) в папку `app/static/uploads/photos/`.
|
6. Загружает фото (по одному или ZIP-архивом) — они сохраняются в папке мероприятия `app/static/uploads/photos/event_<id>/`.
|
||||||
7. При необходимости вручную добавляет, редактирует или блокирует гостей.
|
7. При необходимости вручную добавляет, редактирует или блокирует гостей.
|
||||||
8. Запускает массовую рассылку приглашений. Каждый гость получает письмо с QR-кодом.
|
8. Запускает массовую рассылку приглашений. Каждый гость получает письмо с QR-кодом.
|
||||||
|
|
||||||
@@ -51,12 +51,7 @@ InviteMe — внутреннее веб-приложение для компа
|
|||||||
| Организатор | Создание и управление своими мероприятиями, гостями, рассылка, аналитика, отчёты |
|
| Организатор | Создание и управление своими мероприятиями, гостями, рассылка, аналитика, отчёты |
|
||||||
| Сотрудник на входе | Страница `/check-in`: выбор мероприятия, сканирование QR, поиск, отметка входа |
|
| Сотрудник на входе | Страница `/check-in`: выбор мероприятия, сканирование QR, поиск, отметка входа |
|
||||||
|
|
||||||
Пользователи создаются и управляются через веб-интерфейс администратора. При первом запуске создаются учётные записи по умолчанию:
|
Пользователи создаются и управляются через веб-интерфейс администратора. При первом запуске открывается страница создания первого администратора.
|
||||||
|
|
||||||
- `admin` / `admin`
|
|
||||||
- `staff` / `staff`
|
|
||||||
|
|
||||||
> В production пароли обязательно меняются через переменные окружения или файл `.env`.
|
|
||||||
|
|
||||||
## Архитектура
|
## Архитектура
|
||||||
|
|
||||||
|
|||||||
+6
-9
@@ -11,7 +11,7 @@
|
|||||||
### 1. Подготовка окружения
|
### 1. Подготовка окружения
|
||||||
|
|
||||||
```cmd
|
```cmd
|
||||||
cd C:\Projects\Integrita\InviteMe
|
cd InviteMe
|
||||||
python -m venv venv
|
python -m venv venv
|
||||||
venv\Scripts\activate
|
venv\Scripts\activate
|
||||||
pip install -r requirements.txt
|
pip install -r requirements.txt
|
||||||
@@ -23,10 +23,6 @@ pip install -r requirements.txt
|
|||||||
|
|
||||||
```env
|
```env
|
||||||
SECRET_KEY=your-strong-secret-key-here
|
SECRET_KEY=your-strong-secret-key-here
|
||||||
ADMIN_USERNAME=admin
|
|
||||||
ADMIN_PASSWORD=your-admin-password
|
|
||||||
STAFF_USERNAME=staff
|
|
||||||
STAFF_PASSWORD=your-staff-password
|
|
||||||
DEFAULT_EVENT_NAME=Архивное мероприятие
|
DEFAULT_EVENT_NAME=Архивное мероприятие
|
||||||
|
|
||||||
MAIL_SERVER=smtp.yandex.ru
|
MAIL_SERVER=smtp.yandex.ru
|
||||||
@@ -38,7 +34,7 @@ MAIL_DEFAULT_SENDER=your-email@yandex.ru
|
|||||||
```
|
```
|
||||||
|
|
||||||
> Для Yandex Mail используйте пароль приложения, а не основной пароль.
|
> Для Yandex Mail используйте пароль приложения, а не основной пароль.
|
||||||
> `ADMIN_USERNAME`/`ADMIN_PASSWORD` и `STAFF_USERNAME`/`STAFF_PASSWORD` используются только для создания начальных пользователей при первом запуске. Дальнейшее управление пользователями выполняется через веб-интерфейс администратора.
|
> При первом запуске откроется страница создания первого администратора.
|
||||||
|
|
||||||
### 3. Запуск в режиме разработки
|
### 3. Запуск в режиме разработки
|
||||||
|
|
||||||
@@ -77,8 +73,9 @@ BASE_URL=https://your-domain-or-ip
|
|||||||
|
|
||||||
Важные данные для бэкапа:
|
Важные данные для бэкапа:
|
||||||
- `instance/inviteme.db` — база данных
|
- `instance/inviteme.db` — база данных
|
||||||
- `app/static/uploads/photos/` — фото гостей
|
- `app/static/uploads/photos/event_*` — фото гостей
|
||||||
- `app/static/uploads/qrcodes/` — QR-коды
|
- `app/static/uploads/qrcodes/event_*` — QR-коды
|
||||||
|
- `app/static/uploads/tickets/event_*` — сгенерированные билеты
|
||||||
- `.env` — конфигурация
|
- `.env` — конфигурация
|
||||||
|
|
||||||
## Инструкция для сотрудников на входе
|
## Инструкция для сотрудников на входе
|
||||||
@@ -107,4 +104,4 @@ BASE_URL=https://your-domain-or-ip
|
|||||||
|
|
||||||
### Фото не отображаются
|
### Фото не отображаются
|
||||||
- Проверьте, что название фото в Excel совпадает с именем файла (с расширением)
|
- Проверьте, что название фото в Excel совпадает с именем файла (с расширением)
|
||||||
- Фото должны быть в папке `app/static/uploads/photos/`
|
- Фото должны быть в папке мероприятия `app/static/uploads/photos/event_<id>/`
|
||||||
|
|||||||
Reference in New Issue
Block a user