13 KiB
Отчёт — лабораторная 2
- Автор: Владислав Гавриленко, БПИ2303.
- Целевая оценка: 3, трек 5 не заявлен.
- Ветка:
solution/bpi2303-gavrilenkoв форке Gitea. - MR: ЛР 2 — БПИ2303 — Гавриленко — на 3, #174.
- Основа: собственная lab1, commit
714ead4d671b20814c011a3c7e6cbdf15687b0a9. Перенесены HTTP Handler, APIError/require, проверка JSON/строк/UUID, формат ошибок, логирование и student-tests/check.py. Словари, общая блокировка и курсоры в памяти заменены SQL-транзакциями и keyset SQL. - Источники: контракт текущего skeleton; Psycopg 3 transactions,
Python hashlib.scrypt,
PostgreSQL transactions.
Зависимость приложения —
psycopg[binary]==3.2.10; HTTP, JSON, UUID, secrets и KDF — стандартная библиотека Python. Реализация, проверки и отчёт подготовлены с помощью Codex; чужие решения не переносились.
Запуск из чистого clone
Нужны Git, Docker Engine с Compose v2 (поддержка up --wait), Python 3.9+ для проверок.
Образы: python:3.13.7-slim-bookworm, postgres:17.6-alpine3.22.
git clone -b solution/bpi2303-gavrilenko https://gitea.privcloud.tech/sxdees/mtusi2026lab2.git
cd mtusi2026lab2
scripts/setup.sh
docker compose config --quiet
docker compose up -d --build --wait
make check
make test BASE_URL=http://localhost:8082
python3 student-tests/check.py --base-url http://localhost:8082
docker compose exec -T api python - < student-tests/db_check.py
make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://localhost:8082
setup.sh создаёт случайный пароль PostgreSQL, DSN и .env; существующие файлы не перезаписывает.
Каталог secrets/ закрыт правами 0700; файл DSN читается непривилегированным UID 10001 внутри API через read-only mount.
Секреты не включены в образ и Git. PostgreSQL не публикует порт на host, API доступен только на 127.0.0.1.
HOST_PORT=8082 выбран, чтобы одновременно сохранить запущенную lab1 на 8080.
При смене HOST_PORT передайте соответствующий BASE_URL проверкам.
SESSION_TTL_SECONDS по умолчанию 3600; для smoke/persistence использовать не менее 300.
APP_HOST/APP_PORT и DATABASE_URL_FILE установлены в compose.yaml; APP_ENV, SESSION_STORE, CACHE_URL_FILE не нужны: Redis не используется.
Миграции выполняются автоматически перед HTTP-сервером. Отдельный повторный запуск:
docker compose exec api python src/db.py
Проверка короткого TTL с восстановлением обычного режима:
SESSION_TTL_SECONDS=2 docker compose up -d --wait api
python3 student-tests/expiry.py --base-url http://localhost:8082
docker compose up -d --wait api
Безопасная остановка: docker compose down — именованный volume сохраняется.
Повторный запуск: docker compose up -d --wait.
Намеренное удаление учебных данных: docker compose down -v — необратимо удаляет БД этого проекта; для обычного рестарта не применять.
Не удалять secrets при сохранённом volume: новый пароль сам не изменит пароль внутри существующей БД.
Архитектура и решения
Клиент → один Python ThreadingHTTPServer → PostgreSQL в именованном volume gavrilenko-lab2_postgres_data.
БД — источник истины для пользователей, чатов, участников, сообщений, сессий и версий миграций.
Схема и транзакционные границы описаны до запросов в infra/schema.md.
PK/FK и UNIQUE username поддерживаются БД. Составной FK сообщения запрещает отправителя, не состоящего в чате.
Один HTTP-запрос — одно соединение и транзакция; COMMIT завершается до отправки успешного ответа.
Создание чата вместе с участниками атомарно. Миграции под advisory lock применяются один раз, при ошибке старта HTTP не запускается.
Переход lab1 → lab2: регистрация требует password; Basic только для создания сессии; защищённые endpoint требуют Bearer. X-User-Id не используется и не переопределяет текущего пользователя. Password KDF: scrypt N=16384, r=8, p=1, 16 случайных байт соли, digest 64 байта; сравнение constant-time через hmac.compare_digest. Весь диапазон 12–128 Unicode code points поддерживается без усечения. Токен имеет 256 бит случайности, сервер хранит только SHA-256 токена, user_id и абсолютный expires_at. SHA-256 применяется к высокоэнтропийному токену, а не к паролю. Logout удаляет сессию; expiry проверяется часами БД при каждом запросе. Перезапуск не продлевает TTL. User не содержит пароль/хеш/токен; ошибки и логи не содержат SQL и credentials.
История выбирается WHERE chat_id = ... AND (created_at,id) > (...) ORDER BY created_at,id LIMIT limit+1.
Курсор — base64url JSON с областью списка, временем и UUID последней записи; проверяются формат, область и существование записи.
Курсор не является правом доступа: членство проверяется независимо. Индекс (chat_id,created_at,id) поддерживает keyset.
Список чатов ограничен текущим участником и также использует keyset. Читаем напрямую из PostgreSQL, кэша нет:
подтверждённая запись видна следующему чтению. Между страницами нет snapshot; при переводе часов назад новая запись может оказаться до курсора.
/health/live проверяет процесс без обращения к БД; /health/ready требует PostgreSQL.
Таймаут соединения 3 с, SQL 5 с; недоступность БД возвращает 503 в общем формате.
Доказательства критериев
Реальный вывод: evidence/checks.txt, evidence/restart.txt, evidence/expiry.txt, evidence/postman.txt.
| Критерий уровня 3 | Команда/сценарий | Наблюдаемый результат |
|---|---|---|
| Контракт сохранён | make check |
PASS; contracts/ и публичные tests/ не менялись |
| Минимум lab1 с новым auth | make test BASE_URL=http://localhost:8082 |
PASS: пользователи, чат, сообщения, Unicode, членство, keyset, ошибки |
| Basic/Bearer, logout, X-User-Id | публичный smoke | неверный пароль/Basic вместо Bearer/X-User-Id без токена → 401; после logout → 401 |
| Схема с нуля и единый запуск | scripts/setup.sh, docker compose up -d --build --wait |
API и PostgreSQL healthy на новом именованном volume |
| Уникальность username | smoke и student-tests/check.py | повторная регистрация → 409 |
| FK и атомарная транзакция | docker compose exec -T api python - < student-tests/db_check.py |
FK отклоняет неизвестного участника; вставка чата откатывается |
| Повторные миграции | тот же db_check.py дважды вызывает migrate | версии и количества записей не меняются |
| KDF и валидация | check.py и db_check.py | пароль 128 code points с emoji и двоеточием работает; 11/129 → 400; БД содержит соль/digest |
| Expiry | TTL=2 + student-tests/expiry.py | сначала 200; спустя 3 с чтение и logout → 401 |
| Сохранность и прежняя сессия | make test-persistence ACTION_SCRIPT=scripts/restart.sh BASE_URL=http://localhost:8082 |
PASS: прежний токен читает прежнее сообщение без повторного входа |
| Полный restart | inspect до/после в restart.txt | StartedAt обоих контейнеров изменился, имя PostgreSQL volume сохранилось |
| Независимая проверка ready | Postman CLI request с тремя assertions | HTTP 200, JSON status=ok, X-Request-Id; 3 passed |
Добавлен отдельный application job в GitHub workflow: Compose, smoke, собственные проверки, persistence. CI в Gitea ожидает одобрения сопровождающего для первого вклада из форка; удалённое выполнение не подтверждено. Локальные результаты приведены отдельно.
Эксперимент перезапуска и ограничения
Локальный учебный стенд: macOS arm64, OrbStack Docker 29.8.2; конфигурация VM — 11 CPU, 9 GiB RAM, отдельных cgroup-лимитов нет. Функциональные проверки используют синтетические данные; нагрузка, RPS/latency и треки 4/5 не заявлены. Гипотеза: подтверждённые данные и сессии переживают остановку всех используемых процессов при сохранении volume. Hook останавливает API и БД, затем запускает БД и API с ожиданием healthy; не удаляет volumes, не делает seed. Эксперимент прошёл, точные отметки времени приведены в restart.txt. Потери подтверждённого сообщения не обнаружено.
Проверена штатная остановка/перезапуск, а не аварийное отключение питания, повреждение диска или потеря host. Используются штатные fsync/synchronous_commit PostgreSQL; гарантия durability зависит также от диска и файловой системы. При первом запуске Docker сообщил о заполненном внутреннем диске; после освобождения части кэша сборки стенд поднят. Другие лабораторные и их volumes не удалялись.
Один API и одна БД, без HA, backup/restore, Redis, connection pool, защиты от перебора и нагрузочного исследования.
Сессии после expiry недействительны, но просроченные строки не очищаются автоматически; для длительной эксплуатации нужен регламент очистки.
HTTP без TLS допустим здесь только на loopback с синтетическими данными. http.server и соединение на каждый запрос — учебные упрощения.
Получение оценки требует защиты и объяснения реализации; smoke сам оценку не выставляет.