Files
opora_members/README.md
T

38 lines
4.8 KiB
Markdown

# Реестр участников «ОПОРА РОССИИ» — ДНР
Локальный веб-сервис: Python (стандартная библиотека) + SQLite + HTML/CSS/JavaScript без внешних зависимостей.
## Запуск
```bash
python3 app.py
```
Откройте http://127.0.0.1:8765. При первом запуске приложение создаёт `members.db`. Реальная база, фотографии и исходный список участников исключены из Git и должны храниться локально в защищённом месте.
При первом открытии создайте администратора: задайте имя, логин и уникальный пароль длиной не менее 12 символов. После этого регистрация закрывается; администратор создаёт остальные учётные записи. Сессия хранится в HttpOnly cookie до 8 часов.
Для доступа по локальной сети запустите `HOST=0.0.0.0 python3 app.py`; ограничьте сеть и используйте только в доверенной среде. Не выставляйте приложение в интернет без HTTPS, ограничения доступа и регулярного резервного копирования.
Гостевой режим показывает публичный список (ФИО, фото, статус, город/район, роль), скрывая контакты и заметки. Изменения через API доступны только вошедшим ролям согласно их правам. Модератор и администратор могут загружать JPEG, PNG или WebP до 3 МБ; фото сохраняются в `uploads/`. Фото доступно в публичном списке. Ограничьте доступ к этой папке и включите её в резервные копии.
## Публикация в Git
После настройки HTTPS-аутентификации в Git Credential Manager публикуйте изменения командой `./publish.sh` (не передавайте токены и пароли аргументами). Скрипт фиксирует только код, README и статические файлы; локальная база, фото и исходный файл участников исключены через `.gitignore`. Перед отправкой проверьте `git status`.
## Структура
- `app.py` — HTTP-сервер и JSON API.
- `db.py` — SQLite-схема и CRUD-операции.
- `data/members.json` — исходные имена и телефоны для первого импорта.
- `static/` — интерфейс.
- `members.db` — локальная база, создаётся при запуске.
Роли: **пользователь** — просмотр и поиск; **модератор** — просмотр, создание и изменение карточек, экспорт CSV; **администратор** — все полномочия, включая удаление записей, создание пользователей, назначение ролей и отключение учётных записей. Интерфейс в тёмной теме позволяет фильтровать участников по статусу (включая «Кандидат»). Для персональных данных ограничьте доступ к компьютеру и резервным копиям, собирайте только необходимые сведения и проверьте наличие правового основания для обработки. Приложение намеренно не собирает паспортные данные.
## Использованные библиотеки/наборы
Внешние библиотеки и UI-наборы не используются. Интерфейс реализован нативными HTML, CSS и JavaScript, бэкенд — стандартными модулями Python; сторонние лицензионные материалы не включены.
Пароли хранятся как scrypt-хэши, серверные сессии — в SQLite в виде хэша случайного токена; cookie HttpOnly/SameSite и изменяющие запросы защищены CSRF-токеном. Первая настройка создаёт админа только при пустой таблице учётных записей.