ЛР 2 — БВТ2301 — Козырев — на 5 #22

Closed
kozyrev_matvey wants to merge 6 commits from kozyrev_matvey/mtusi2026lab2:solution/bvt2301-kozyrev into master
First-time contributor

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

Автор / группа: Козырев Матвей / БВТ2301
Целевая оценка (3/4/5): 5
трек 1 - согласованность кэша

Что реализовано и что перенесено: перенесён REST API мессенджера из lab1. Данные пользователей, чатов, участников, сообщений и сессий хранятся в PostgreSQL; добавлены версионируемые миграции. Регистрация требует пароль, пароль хешируется Argon2. Вход выполняется через Basic, бизнес-API использует opaque Bearer-сессии с TTL и logout. Redis используется для кэша первой страницы истории; PostgreSQL остаётся источником истины. Для track 5 добавлена защита от cache stampede через Redis-lock.

Команды запуска из чистого clone: приведены в REPORT.md: создание локальных secret-файлов, docker compose --env-file .env.example up -d --build, затем make test, make test-persistence ACTION_SCRIPT=scripts/restart.sh и make test-grade4.

Результаты проверок и ссылка на REPORT.md: make check, OpenAPI-валидация, uv lock --check, make test, make test-persistence ACTION_SCRIPT=scripts/restart.sh, make test-grade4, проверка TTL и restart Redis прошли. Отчёт и evidence: REPORT.md, evidence/.

Ограничения / известные ошибки: измерение track 5 выполнено локально в одном прогоне с 20 конкурентными читателями; результаты не являются универсальной оценкой производительности. При недоступности Redis API безопасно обходит кэш и использует PostgreSQL. При недоступности PostgreSQL /health/ready возвращает 503.

Источники и использование ИИ: использованы материалы задания и контракта репозитория, официальная документация PostgreSQL, Redis и RFC 7617. Codex использовался для переноса кода, реализации, рефакторинга и подготовки проверок; итоговые smoke, persistence, level 4 и track 5 проверки выполнены локально.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 2 Автор / группа: Козырев Матвей / БВТ2301 Целевая оценка (3/4/5): 5 трек 1 - согласованность кэша Что реализовано и что перенесено: перенесён REST API мессенджера из lab1. Данные пользователей, чатов, участников, сообщений и сессий хранятся в PostgreSQL; добавлены версионируемые миграции. Регистрация требует пароль, пароль хешируется Argon2. Вход выполняется через Basic, бизнес-API использует opaque Bearer-сессии с TTL и logout. Redis используется для кэша первой страницы истории; PostgreSQL остаётся источником истины. Для track 5 добавлена защита от cache stampede через Redis-lock. Команды запуска из чистого clone: приведены в `REPORT.md`: создание локальных secret-файлов, `docker compose --env-file .env.example up -d --build`, затем `make test`, `make test-persistence ACTION_SCRIPT=scripts/restart.sh` и `make test-grade4`. Результаты проверок и ссылка на REPORT.md: `make check`, OpenAPI-валидация, `uv lock --check`, `make test`, `make test-persistence ACTION_SCRIPT=scripts/restart.sh`, `make test-grade4`, проверка TTL и restart Redis прошли. Отчёт и evidence: `REPORT.md`, `evidence/`. Ограничения / известные ошибки: измерение track 5 выполнено локально в одном прогоне с 20 конкурентными читателями; результаты не являются универсальной оценкой производительности. При недоступности Redis API безопасно обходит кэш и использует PostgreSQL. При недоступности PostgreSQL `/health/ready` возвращает 503. Источники и использование ИИ: использованы материалы задания и контракта репозитория, официальная документация PostgreSQL, Redis и RFC 7617. Codex использовался для переноса кода, реализации, рефакторинга и подготовки проверок; итоговые smoke, persistence, level 4 и track 5 проверки выполнены локально. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
kozyrev_matvey added 4 commits 2026-10-08 19:57:23 +03:00
Owner

Существенные проблемы:

  • Повторное чтение кэшированной страницы с продолжением возвращает 500. В чате с шестью сообщениями два одинаковых GET /api/v1/chats/{id}/messages?limit=2: первый — 200 с курсором, второй — 500 internal_error, ожидался 200. Повторено также через вторую API-реплику после подтверждённых записей. В history_cache.py (line 62) даты сериализуются через default=str; после json.loads остаются строками. cursor.py (line 32) вызывает created_at.astimezone(UTC). Реальный traceback: AttributeError: 'str' object has no attribute 'astimezone'. Публичный smoke этого не ловит: повторного чтения первой страницы в нём нет.
  • Инструкция запуска из чистого clone неполна. Команды REPORT.md (line 14) не создают secrets/cache_url, обязательный для compose.yaml (line 65). Изолированный запуск с отсутствующим файлом завершился ошибкой bind mount. Команда awk на строке 16 также воспроизводимо добавляет буквальное \n в имя БД вместо перевода строки.
Существенные проблемы: - Повторное чтение кэшированной страницы с продолжением возвращает 500. В чате с шестью сообщениями два одинаковых GET /api/v1/chats/{id}/messages?limit=2: первый — 200 с курсором, второй — 500 internal_error, ожидался 200. Повторено также через вторую API-реплику после подтверждённых записей. В [history_cache.py (line 62)](/Users/veprickiy/sources/mtusi/lab2-worktree/worktrees/pr-22-kozyrev-20261009/src/storage/history_cache.py:62) даты сериализуются через default=str; после json.loads остаются строками. [cursor.py (line 32)](/Users/veprickiy/sources/mtusi/lab2-worktree/worktrees/pr-22-kozyrev-20261009/src/cursor.py:32) вызывает created_at.astimezone(UTC). Реальный traceback: AttributeError: 'str' object has no attribute 'astimezone'. Публичный smoke этого не ловит: повторного чтения первой страницы в нём нет. - Инструкция запуска из чистого clone неполна. Команды [REPORT.md (line 14)](/Users/veprickiy/sources/mtusi/lab2-worktree/worktrees/pr-22-kozyrev-20261009/REPORT.md:14) не создают secrets/cache_url, обязательный для [compose.yaml (line 65)](/Users/veprickiy/sources/mtusi/lab2-worktree/worktrees/pr-22-kozyrev-20261009/compose.yaml:65). Изолированный запуск с отсутствующим файлом завершился ошибкой bind mount. Команда awk на строке 16 также воспроизводимо добавляет буквальное \n в имя БД вместо перевода строки.
Owner

На 5 еще не хватает:

  • После отказа Redis кэш и защита не возобновляются без рестарта API. Данные читаются правильно через PostgreSQL, но восстановление работы механизма кэширования неполное.
На 5 еще не хватает: - После отказа Redis кэш и защита не возобновляются без рестарта API. Данные читаются правильно через PostgreSQL, но восстановление работы механизма кэширования неполное.
kozyrev_matvey added 1 commit 2026-10-09 20:38:46 +03:00
restore Redis cache after outage
Skeleton contracts / contracts (pull_request) Canceled after 0s
7cda433085
kozyrev_matvey added 1 commit 2026-10-09 21:06:34 +03:00
fix cached history pagination and setup docs
Skeleton contracts / contracts (pull_request) Canceled after 0s
b538b2db39
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-11 18:59:00 +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#22