ЛР 2 — БПИ2302— Кашкарова — на 3 #170

Open
ari_kash wants to merge 3 commits from ari_kash/mtusi2026lab2:solution/bpi_kashkarova into master
First-time contributor

Лабораторная 2

Автор / группа: Кашкарова Арина, БПИ2302
Целевая оценка (3/4/5): 3
Трек 5, если заявлен: Не заявлен

Что реализовано и что перенесено:

  • Перенесен работающий минимум Lab 1 (пользователи, чаты, сообщения, cursor-пагинация).
  • In-memory хранилище заменено на PostgreSQL (образ postgres:16.1).
  • Реализована новая аутентификация: регистрация с хешированием пароля (SHA-256 pre-hash + bcrypt), вход через Basic auth (/api/v1/auth/sessions), защищенные эндпоинты требуют Bearer токен.
  • Добавлены идемпотентные SQL-миграции (src/migrations/001_initial.sql) с первичными/внешними ключами, уникальностью username и индексами для пагинации.
  • Создание чата выполняется атомарно в одной транзакции.
  • Настроен docker-compose.yaml с именованным volume postgres_data для сохранения состояния.
  • Реализован скрипт перезапуска scripts/restart.bat для корректного прохождения теста на устойчивость в среде Windows/Git Bash.

Команды запуска из чистого clone:
`# 1. Клонирование и переход в директорию
git clone https://gitea.privcloud.tech/ari_kash/mtusi2026lab2.git
cd mtusi2026lab2

2. Создание и активация виртуального окружения (Windows / Git Bash)

python -m venv .venv
source .venv/Scripts/activate # или .venv\Scripts\activate

3. Установка зависимостей

pip install -r requirements.txt
pip install -r requirements-dev.txt

4. Запуск стенда (API + PostgreSQL)

docker compose up -d --build

5. Проверка готовности

curl http://localhost:8080/health/ready

6. Запуск тестов

python tests/smoke.py --base-url "http://localhost:8080"
python tests/resilience.py --mode persistence --action-script "scripts/restart.bat" --base-url "http://localhost:8080"

7. Безопасная остановка (данные сохраняются)

docker compose down

Полное удаление данных (для сброса): docker compose down -v`

Результаты проверок и ссылка на REPORT.md:
Результат smoke теста:
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.
Результат persistence теста:
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.
Подробная инструкция, архитектура и доказательства критериев описаны в файле REPORT.md.

Ограничения / известные ошибки:

  • Скрипт перезапуска реализован как restart.bat вместо restart.sh из-за особенностей работы Docker Desktop и Git Bash в ОС Windows.
  • Уровень 3: не используется Redis/Valkey для сессий, нет connection pool и EXPLAIN-анализа индексов (это требования для оценки «4»).
  • TTL сессий фиксирован, автоматическая фоновая очистка истекших сессий не реализована (проверка происходит через WHERE expires_at > NOW() при чтении).

Источники и использование ИИ:
Python 3.11, FastAPI, Uvicorn, Pydantic, PostgreSQL 16.1, psycopg2-binary, bcrypt, Docker, Docker Compose. ИИ использовался для генерации начального скелета кода, отладки форматирования ответов под OpenAPI контракт (в частности, обработки WWW-Authenticate заголовков и сериализации datetime) и настройки конфигурации Docker Compose.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 Автор / группа: Кашкарова Арина, БПИ2302 Целевая оценка (3/4/5): 3 Трек 5, если заявлен: Не заявлен Что реализовано и что перенесено: - Перенесен работающий минимум Lab 1 (пользователи, чаты, сообщения, cursor-пагинация). - In-memory хранилище заменено на PostgreSQL (образ postgres:16.1). - Реализована новая аутентификация: регистрация с хешированием пароля (SHA-256 pre-hash + bcrypt), вход через Basic auth (/api/v1/auth/sessions), защищенные эндпоинты требуют Bearer токен. - Добавлены идемпотентные SQL-миграции (src/migrations/001_initial.sql) с первичными/внешними ключами, уникальностью username и индексами для пагинации. - Создание чата выполняется атомарно в одной транзакции. - Настроен docker-compose.yaml с именованным volume postgres_data для сохранения состояния. - Реализован скрипт перезапуска scripts/restart.bat для корректного прохождения теста на устойчивость в среде Windows/Git Bash. Команды запуска из чистого clone: `# 1. Клонирование и переход в директорию git clone https://gitea.privcloud.tech/ari_kash/mtusi2026lab2.git cd mtusi2026lab2 # 2. Создание и активация виртуального окружения (Windows / Git Bash) python -m venv .venv source .venv/Scripts/activate # или .venv\Scripts\activate # 3. Установка зависимостей pip install -r requirements.txt pip install -r requirements-dev.txt # 4. Запуск стенда (API + PostgreSQL) docker compose up -d --build # 5. Проверка готовности curl http://localhost:8080/health/ready # 6. Запуск тестов python tests/smoke.py --base-url "http://localhost:8080" python tests/resilience.py --mode persistence --action-script "scripts/restart.bat" --base-url "http://localhost:8080" # 7. Безопасная остановка (данные сохраняются) docker compose down # Полное удаление данных (для сброса): docker compose down -v` Результаты проверок и ссылка на REPORT.md: Результат smoke теста: `PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.` Результат persistence теста: `Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.` Подробная инструкция, архитектура и доказательства критериев описаны в файле [REPORT.md.](https://gitea.privcloud.tech/ari_kash/mtusi2026lab2/src/branch/solution/bpi_kashkarova/README.md) Ограничения / известные ошибки: - Скрипт перезапуска реализован как restart.bat вместо restart.sh из-за особенностей работы Docker Desktop и Git Bash в ОС Windows. - Уровень 3: не используется Redis/Valkey для сессий, нет connection pool и EXPLAIN-анализа индексов (это требования для оценки «4»). - TTL сессий фиксирован, автоматическая фоновая очистка истекших сессий не реализована (проверка происходит через WHERE expires_at > NOW() при чтении). Источники и использование ИИ: Python 3.11, FastAPI, Uvicorn, Pydantic, PostgreSQL 16.1, psycopg2-binary, bcrypt, Docker, Docker Compose. ИИ использовался для генерации начального скелета кода, отладки форматирования ответов под OpenAPI контракт (в частности, обработки WWW-Authenticate заголовков и сериализации datetime) и настройки конфигурации Docker Compose. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
ari_kash added 3 commits 2026-11-11 23:19:06 +03:00
Some required checks failed
1 workflow awaiting approval

The workflow will only run after approval from the repository maintainer.

Skeleton contracts / contracts (pull_request) Canceled after 0s
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u https://gitea.privcloud.tech/ari_kash/mtusi2026lab2 solution/bpi_kashkarova:ari_kash-solution/bpi_kashkarova
git checkout ari_kash-solution/bpi_kashkarova
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab2#170