ЛР 2 - БПИ2302 - Гилим - на 3 #172

Open
altng wants to merge 2 commits from altng/mtusi2026lab2:solution/BPI2302-gilim into master
First-time contributor

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

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

Что реализовано и что перенесено:
Перенесён минимум lab1 (пользователи, чаты, членство, сообщения, keyset-пагинация по (created_at, id)). Все данные перенесены в PostgreSQL 16, доступ через JDBC + HikariCP, параметризованные запросы через PreparedStatement.
Изменения в API относительно lab1:

POST /api/v1/users принимает password (обязателен, 12–128 символов), хешируется BCrypt (Spring Security Crypto).

POST /api/v1/auth/sessions принимает Basic username:password, выдаёт opaque Bearer-токен (64 hex) с expires_at и token_type: "Bearer".

Все бизнес-эндпоинты требуют Authorization: Bearer . X-User-Id игнорируется. Basic на защищённых эндпоинтах → 401 с WWW-Authenticate: Bearer.

DELETE /api/v1/auth/sessions/current — отзыв текущей сессии (204); повторный вызов с тем же токеном → 401.

Сессии хранятся в PostgreSQL (sessions), TTL из SESSION_TTL_SECONDS (по умолчанию 3600 с). Активные сессии переживают рестарт API и БД.

Схема — Flyway (src/main/resources/db/migration/V1__initial_schema.sql), применяется при старте API. Повторный запуск идемпотентен (flyway_schema_history). Ручной applyMigrations() из lab1 удалён.

POST /api/v1/chats — одна транзакция: проверка всех member_ids (SELECT 1 FROM users WHERE id = ?), INSERT INTO chats ... RETURNING, батч INSERT INTO chat_members, COMMIT; при любой ошибке (включая несуществующего участника) — rollback(), ни чата, ни членства в БД не остаётся.

GET /health/ready выполняет SELECT 1 и возвращает 503 {"error":{"code":"unavailable",...}} при недоступности БД.

Инфраструктура: Dockerfile (multi-stage: maven build → jre), docker-compose.yml (postgres:16-alpine с named volume pgdata, healthcheck pg_isready; api с healthcheck на /health/ready), .env.example, scripts/restart.sh (перезапуск API и БД с сохранением volumes). .env в .gitignore.

Команды запуска из чистого clone:

git clone https://gitea.privcloud.tech/altng/mtusi2026lab2.git
cd mtusi2026lab2
cp .env.example .env
docker compose --env-file .env up -d --build
# дождаться готовности:
curl http://localhost:8080/health/ready    # {"status":"ok"}

make check
make test
make test-persistence ACTION_SCRIPT=scripts/restart.sh   # из WSL

# остановка (данные сохраняются):
docker compose down
# намеренное удаление учебных данных:
docker compose down -v

Результаты проверок и ссылка на REPORT.md:

$ make check
PASS: offline skeleton structure, local refs and Python syntax; application NOT tested.

$ make test
PASS: lab2 public API scenario; infrastructure and grading evidence remain separate.

$ make test-persistence ACTION_SCRIPT=scripts/restart.sh
Executing explicit persistence hook; hook output suppressed to avoid leaking secrets.
PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence.

Сырые выводы: evidence/smoke.txt, evidence/persistence.txt, evidence/check.txt, evidence/flyway.txt, evidence/bcrypt.txt, evidence/rollback.txt. Полный отчёт с архитектурой, таблицей доказательств и ограничениями — REPORT.md.

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

  • Целевая оценка — 3. Redis/Valkey для сессий, EXPLAIN на ≥10 000 сообщениях, тест недоступности зависимости, failover между репликами API не реализованы — это уровень 4/5, в работе не заявлен.

  • createChat делает N+1 SELECT на каждого участника; getChats — N+1 SELECT участников на каждый чат. Для «3» допустимо, для «4» нужно заменить на WHERE id = ANY(?) и JOIN.

  • FAIL_ON_UNKNOWN_PROPERTIES в ObjectMapper выключен: лишние поля в запросе игнорируются, строгая проверка additionalProperties: false для запросов не выполняется (для ответов — выполняется, контракт не ослаблен).

  • GET /health/ready возвращает 503 при недоступности БД, но сквозной сценарий «БД упала во время запроса» не прогонялся.

  • Persistence-тест подтверждает, что docker compose restart сохраняет volumes и сессии; hook scripts/restart.sh не удаляет volumes, операторский вывод hook скрыт тестом (stdout=DEVNULL). Свидетельство области действия hook — docker compose ps до/после в evidence/persistence.txt (при необходимости добавляется отдельно).

Источники и использование ИИ:
README курса, contracts/openapi.json, contracts/README.md, документация Flyway 10, PostgreSQL JDBC 42.7.3, Javalin 6, Spring Security Crypto, RFC 7617 (Basic). ИИ использовался для отладки сборки (Flyway 10 модуляризация, ServicesResourceTransformer в shade), Jackson/record (-parameters, @JsonProperty), setObject(Instant) → OffsetDateTime, и синтаксиса PowerShell/WSL при запуске тестов. Код проверен запуском make test и make test-persistence; контракт и публичные тесты не менялись.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 Автор / группа: Гилим А.Р., БПИ2302 Целевая оценка (3/4/5): 3 Трек 5, если заявлен: не завялен Что реализовано и что перенесено: Перенесён минимум lab1 (пользователи, чаты, членство, сообщения, keyset-пагинация по (created_at, id)). Все данные перенесены в PostgreSQL 16, доступ через JDBC + HikariCP, параметризованные запросы через PreparedStatement. Изменения в API относительно lab1: POST /api/v1/users принимает password (обязателен, 12–128 символов), хешируется BCrypt (Spring Security Crypto). POST /api/v1/auth/sessions принимает Basic username:password, выдаёт opaque Bearer-токен (64 hex) с expires_at и token_type: "Bearer". Все бизнес-эндпоинты требуют Authorization: Bearer <token>. X-User-Id игнорируется. Basic на защищённых эндпоинтах → 401 с WWW-Authenticate: Bearer. DELETE /api/v1/auth/sessions/current — отзыв текущей сессии (204); повторный вызов с тем же токеном → 401. Сессии хранятся в PostgreSQL (sessions), TTL из SESSION_TTL_SECONDS (по умолчанию 3600 с). Активные сессии переживают рестарт API и БД. Схема — Flyway (src/main/resources/db/migration/V1__initial_schema.sql), применяется при старте API. Повторный запуск идемпотентен (flyway_schema_history). Ручной applyMigrations() из lab1 удалён. POST /api/v1/chats — одна транзакция: проверка всех member_ids (SELECT 1 FROM users WHERE id = ?), INSERT INTO chats ... RETURNING, батч INSERT INTO chat_members, COMMIT; при любой ошибке (включая несуществующего участника) — rollback(), ни чата, ни членства в БД не остаётся. GET /health/ready выполняет SELECT 1 и возвращает 503 {"error":{"code":"unavailable",...}} при недоступности БД. Инфраструктура: Dockerfile (multi-stage: maven build → jre), docker-compose.yml (postgres:16-alpine с named volume pgdata, healthcheck pg_isready; api с healthcheck на /health/ready), .env.example, scripts/restart.sh (перезапуск API и БД с сохранением volumes). .env в .gitignore. Команды запуска из чистого clone: ``` git clone https://gitea.privcloud.tech/altng/mtusi2026lab2.git cd mtusi2026lab2 cp .env.example .env docker compose --env-file .env up -d --build # дождаться готовности: curl http://localhost:8080/health/ready # {"status":"ok"} make check make test make test-persistence ACTION_SCRIPT=scripts/restart.sh # из WSL # остановка (данные сохраняются): docker compose down # намеренное удаление учебных данных: docker compose down -v ``` Результаты проверок и ссылка на REPORT.md: ``` $ make check PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. $ make test PASS: lab2 public API scenario; infrastructure and grading evidence remain separate. $ make test-persistence ACTION_SCRIPT=scripts/restart.sh Executing explicit persistence hook; hook output suppressed to avoid leaking secrets. PASS: persistence preserved confirmed data and existing session. Hook scope needs operator evidence. ``` Сырые выводы: evidence/smoke.txt, evidence/persistence.txt, evidence/check.txt, evidence/flyway.txt, evidence/bcrypt.txt, evidence/rollback.txt. Полный отчёт с архитектурой, таблицей доказательств и ограничениями — REPORT.md. Ограничения / известные ошибки: - Целевая оценка — 3. Redis/Valkey для сессий, EXPLAIN на ≥10 000 сообщениях, тест недоступности зависимости, failover между репликами API не реализованы — это уровень 4/5, в работе не заявлен. - createChat делает N+1 SELECT на каждого участника; getChats — N+1 SELECT участников на каждый чат. Для «3» допустимо, для «4» нужно заменить на WHERE id = ANY(?) и JOIN. - FAIL_ON_UNKNOWN_PROPERTIES в ObjectMapper выключен: лишние поля в запросе игнорируются, строгая проверка additionalProperties: false для запросов не выполняется (для ответов — выполняется, контракт не ослаблен). - GET /health/ready возвращает 503 при недоступности БД, но сквозной сценарий «БД упала во время запроса» не прогонялся. - Persistence-тест подтверждает, что docker compose restart сохраняет volumes и сессии; hook scripts/restart.sh не удаляет volumes, операторский вывод hook скрыт тестом (stdout=DEVNULL). Свидетельство области действия hook — docker compose ps до/после в evidence/persistence.txt (при необходимости добавляется отдельно). Источники и использование ИИ: README курса, contracts/openapi.json, contracts/README.md, документация Flyway 10, PostgreSQL JDBC 42.7.3, Javalin 6, Spring Security Crypto, RFC 7617 (Basic). ИИ использовался для отладки сборки (Flyway 10 модуляризация, ServicesResourceTransformer в shade), Jackson/record (-parameters, @JsonProperty), setObject(Instant) → OffsetDateTime, и синтаксиса PowerShell/WSL при запуске тестов. Код проверен запуском make test и make test-persistence; контракт и публичные тесты не менялись. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
altng added 1 commit 2026-11-12 18:01:00 +03:00
lab2: PostgreSQL, Flyway migrations, Basic->Bearer sessions, evidence
Skeleton contracts / contracts (pull_request) Canceled after 0s
12a3496bc6
altng added 1 commit 2026-11-12 18:01:58 +03:00
report update
Skeleton contracts / contracts (pull_request) Canceled after 0s
61775836db
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/altng/mtusi2026lab2 solution/BPI2302-gilim:altng-solution/BPI2302-gilim
git checkout altng-solution/BPI2302-gilim
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#172