Solution/bpi2304 sirenko #190

Closed
nothingredmouth wants to merge 8 commits from nothingredmouth/mtusi2026lab2-fork:solution/BPI2304-sirenko into master
First-time contributor

ЛР 2 — БПИ2304 — Сиренко — на 3

Что реализовано

  • PostgreSQL-слой: таблицы users, chats, messages, sessions (UUID, timestamptz, индексы, внешние ключи); соединение через psycopg с пулом; репозиторий с типизированными запросами.
  • Атомарное создание чата: участники вставляются в той же транзакции, что и сам чат (REPEATABLE READ), откат всей операции при ошибке.
  • Argon2id хеширование паролей (argon2-cffi, PasswordHasher).
  • Basic → Bearer: вход по Authorization: Basic возвращает Bearer-токен сессии; сессии хранятся в БД с TTL (дефолт 3600 с, SESSION_TTL_SECONDS) и отзывом (POST /auth/logout), истёкшие/отозванные сессии отклоняются.
  • Миграции с нуля (messenger/migrate.py + migrations/001_initial.sql): отслеживание применённых версий, идемпотентный повтор — повторный запуск не ломает схему.
  • Keyset-пагинация списка сообщений (стабильна при появлении новых строк).
  • HTTP API на Flask (Waitress), точка запуска python -m messenger; конфиг из переменных окружения.
  • Выживание данных и сессий при рестарте: данные в PostgreSQL, сессии в БД — после рестарта API-процесса старые данные и активные Bearer-сессии продолжают работать (проверено make test-persistence).
  • Dockerfile + Compose-стенд с secrets и именованным volume, скрипты init_local.py/start.sh/restart.sh, собственные интеграционные тесты (student-tests/) и CI-проверка (.github/workflows/application.yml), доказательства локальных проверок в evidence/.

Валидация

Окружение: PostgreSQL 17 (127.0.0.1:5432, БД lab2db), Python 3.13 (venv с Flask 3.1.0, Waitress 3.0.2, psycopg 3.2.6, argon2-cffi), API на http://127.0.0.1:8082.

Команда Факт. результат
make check PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.
make validate PYTHON=$PY PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested.
DATABASE_URL=$DBURL $PY -m messenger.migrate (2 раза) PASS: «Migrations applied successfully (already applied versions skipped)» — идемпотентность подтверждена
curl -fsS http://127.0.0.1:8082/health/ready PASS: {"status":"ok"}
make test BASE_URL=http://127.0.0.1:8082 PYTHON=$PY PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
DATABASE_URL=$DBURL $PY -m unittest discover -s student-tests -v PASS: 5 тестов OK (atomic chat + повтор миграции, аутентификация/logout, expiry + restart, пагинация, строгая валидация + private chat)
make test-persistence ACTION_SCRIPT=/tmp/lab2_restart.sh PYTHON=$PY BASE_URL=http://127.0.0.1:8082 PASS: persistence preserved confirmed data and existing session.

Ограничения

  • Docker в среде подготовки отсутствует: compose-стенд не поднимался, Dockerfile/compose.yaml/scripts/init_local.py не проверялись выполнением (только синтаксис/структура).
  • Persistence проверялась локальным рестартом API-процесса (временный hook в /tmp, не входит в репозиторий): убивался только процесс API, БД и volumes не трогались.
  • make test-persistence с compose-скриптом (scripts/restart.sh в Docker-стенде) требует Docker и в этой среде не выполнялся.
  • Redis/Valkey не заявлены (не входит в требование на оценку 3).

Коммиты

9e81517 Заполнить отчёт лабораторной работы
87d279b Добавить restart-hook и доказательства локальных проверок
39197c2 Добавить собственные интеграционные тесты и CI-проверку
d7a30a6 Добавить Dockerfile и Compose-стенд с secrets и именованным volume
d876930 Собрать HTTP API на Flask и точку запуска Waitress
c061392 Добавить аутентификацию: Argon2id, Basic-вход, Bearer-сессии с TTL и отзывом
7eba9cc Реализовать PostgreSQL-слой: соединения, репозиторий, keyset-пагинацию
fd3eb67 Добавить схему БД, миграции и проект транзакционных границ

Ветка: solution/BPI2304-sirenko (создана от master, 2 исходных коммита).

# ЛР 2 — БПИ2304 — Сиренко — на 3 ## Что реализовано - **PostgreSQL-слой**: таблицы `users`, `chats`, `messages`, `sessions` (UUID, `timestamptz`, индексы, внешние ключи); соединение через `psycopg` с пулом; репозиторий с типизированными запросами. - **Атомарное создание чата**: участники вставляются в той же транзакции, что и сам чат (`REPEATABLE READ`), откат всей операции при ошибке. - **Argon2id** хеширование паролей (`argon2-cffi`, `PasswordHasher`). - **Basic → Bearer**: вход по `Authorization: Basic` возвращает Bearer-токен сессии; сессии хранятся в БД с TTL (дефолт 3600 с, `SESSION_TTL_SECONDS`) и отзывом (`POST /auth/logout`), истёкшие/отозванные сессии отклоняются. - **Миграции с нуля** (`messenger/migrate.py` + `migrations/001_initial.sql`): отслеживание применённых версий, **идемпотентный повтор** — повторный запуск не ломает схему. - **Keyset-пагинация** списка сообщений (стабильна при появлении новых строк). - **HTTP API** на Flask (Waitress), точка запуска `python -m messenger`; конфиг из переменных окружения. - **Выживание данных и сессий при рестарте**: данные в PostgreSQL, сессии в БД — после рестарта API-процесса старые данные и активные Bearer-сессии продолжают работать (проверено `make test-persistence`). - Dockerfile + Compose-стенд с secrets и именованным volume, скрипты `init_local.py`/`start.sh`/`restart.sh`, собственные интеграционные тесты (`student-tests/`) и CI-проверка (`.github/workflows/application.yml`), доказательства локальных проверок в `evidence/`. ## Валидация Окружение: PostgreSQL 17 (127.0.0.1:5432, БД `lab2db`), Python 3.13 (venv с Flask 3.1.0, Waitress 3.0.2, psycopg 3.2.6, argon2-cffi), API на `http://127.0.0.1:8082`. | Команда | Факт. результат | |---|---| | `make check` | PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. | | `make validate PYTHON=$PY` | PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested. | | `DATABASE_URL=$DBURL $PY -m messenger.migrate` (2 раза) | PASS: «Migrations applied successfully (already applied versions skipped)» — идемпотентность подтверждена | | `curl -fsS http://127.0.0.1:8082/health/ready` | PASS: `{"status":"ok"}` | | `make test BASE_URL=http://127.0.0.1:8082 PYTHON=$PY` | PASS: lab2 public API scenario; infrastructure and grading evidence remain separate. | | `DATABASE_URL=$DBURL $PY -m unittest discover -s student-tests -v` | PASS: 5 тестов OK (atomic chat + повтор миграции, аутентификация/logout, expiry + restart, пагинация, строгая валидация + private chat) | | `make test-persistence ACTION_SCRIPT=/tmp/lab2_restart.sh PYTHON=$PY BASE_URL=http://127.0.0.1:8082` | PASS: persistence preserved confirmed data and existing session. | ## Ограничения - Docker в среде подготовки отсутствует: **compose-стенд не поднимался**, `Dockerfile`/`compose.yaml`/`scripts/init_local.py` не проверялись выполнением (только синтаксис/структура). - Persistence проверялась **локальным рестартом API-процесса** (временный hook в `/tmp`, не входит в репозиторий): убивался только процесс API, БД и volumes не трогались. - `make test-persistence` с compose-скриптом (`scripts/restart.sh` в Docker-стенде) требует Docker и в этой среде не выполнялся. - Redis/Valkey не заявлены (не входит в требование на оценку 3). ## Коммиты ``` 9e81517 Заполнить отчёт лабораторной работы 87d279b Добавить restart-hook и доказательства локальных проверок 39197c2 Добавить собственные интеграционные тесты и CI-проверку d7a30a6 Добавить Dockerfile и Compose-стенд с secrets и именованным volume d876930 Собрать HTTP API на Flask и точку запуска Waitress c061392 Добавить аутентификацию: Argon2id, Basic-вход, Bearer-сессии с TTL и отзывом 7eba9cc Реализовать PostgreSQL-слой: соединения, репозиторий, keyset-пагинацию fd3eb67 Добавить схему БД, миграции и проект транзакционных границ ``` Ветка: `solution/BPI2304-sirenko` (создана от `master`, 2 исходных коммита).
nothingredmouth added 8 commits 2026-11-17 10:06:25 +03:00
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-17 11:04:51 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab2#190