ЛР 4 — БВТ2303 — Васюкова — на 4 #4

Closed
Vasyukova-Nat wants to merge 15 commits from Vasyukova-Nat/mtusi2026lab4:solution/BVT2303-Vasyukova into main
First-time contributor

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

Автор / группа: Васюкова Наталья, БВТ2303
Целевая оценка: 4
Трек 5: не заявлен

Что реализовано и что перенесено: Перенесён весь минимум lab1–lab3 (API, PostgreSQL, Redis-сессии, LB + 2 реплики, идемпотентность POST сообщений, X-Instance-Id). Добавлено: приватный bucket MinIO messenger-attachments + minio-init (идемпотентный bootstrap, ограниченные S3-credentials messenger-app); таблица attachments (метаданные) и message_attachments (связь с сообщением); POST /chats/{id}/attachments (сырые PNG/JPEG ≤10 MiB, ≤40M пикселей, MIME по содержимому, безопасный filename) → 201 ready; GET /attachments/{id} и /content — только участникам чата, без redirect; attachment_ids в POST /messages с проверкой принадлежности чату; компенсация orphan (удаление S3-объекта при сбое INSERT) + фоновая сверка S3↔БД s3_cleanup с grace period; /health/ready проверяет PostgreSQL, Redis и S3.

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

git clone https://gitflic.ru/project/vasyukova-nat/mtusi2026lab4.git
git checkout solution/BVT2303-Vasyukova
copy .env.example .env
docker compose --env-file .env up -d --build
curl.exe -s http://localhost:8080/health/ready

Результаты проверок и ссылка на REPORT.md: check_contract PASS, validate_openapi PASS, smoke.py PASS (lab4), resilience --mode persistence PASS, resilience --mode failover PASS (2 реплики, 8 записей, recovery=4.146 s), lab4_test_level4.py PASS (8/8 сценариев, компенсация: bucket не вырос 10→10, параллельные загрузки: пик RSS=88.94 MiB). Подробности — REPORT.md.

Ограничения / известные ошибки: один Docker-host, все stores и MinIO — единичные экземпляры (SPOF); тело загрузки читается в память (приемлемо при 10 MiB и лимите 512M); s3_cleanup best-effort — обратный случай (метаданные без объекта) только логируется как missing_object, не самолечится; идемпотентность только на POST сообщений; порядок (created_at, id) требует монотонных часов сервера. Трек 5 не заявлен.

Источники и использование ИИ: контракт contracts/openapi.json, contracts/README.md, README.md, COURSE.md, CONTRIBUTING.md; библиотеки fastapi 0.115.0, uvicorn 0.32.0, psycopg 3.2.3, psycopg_pool 3.2.3, redis 5.2.0, boto3 1.35.74, Pillow 11.0.0. ИИ (DeepSeek) — помощь в структурировании кода и отчёта; весь код проверен, отредактирован и запущен автором. Секретов в Git нет.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 4 Автор / группа: Васюкова Наталья, БВТ2303 Целевая оценка: 4 Трек 5: не заявлен **Что реализовано и что перенесено:** Перенесён весь минимум lab1–lab3 (API, PostgreSQL, Redis-сессии, LB + 2 реплики, идемпотентность POST сообщений, `X-Instance-Id`). Добавлено: приватный bucket MinIO `messenger-attachments` + `minio-init` (идемпотентный bootstrap, ограниченные S3-credentials `messenger-app`); таблица `attachments` (метаданные) и `message_attachments` (связь с сообщением); `POST /chats/{id}/attachments` (сырые PNG/JPEG ≤10 MiB, ≤40M пикселей, MIME по содержимому, безопасный filename) → `201 ready`; `GET /attachments/{id}` и `/content` — только участникам чата, без redirect; `attachment_ids` в `POST /messages` с проверкой принадлежности чату; компенсация orphan (удаление S3-объекта при сбое INSERT) + фоновая сверка S3↔БД `s3_cleanup` с grace period; `/health/ready` проверяет PostgreSQL, Redis и S3. **Команды запуска из чистого clone:** ``` git clone https://gitflic.ru/project/vasyukova-nat/mtusi2026lab4.git git checkout solution/BVT2303-Vasyukova copy .env.example .env docker compose --env-file .env up -d --build curl.exe -s http://localhost:8080/health/ready ``` **Результаты проверок и ссылка на REPORT.md:** `check_contract` PASS, `validate_openapi` PASS, `smoke.py` PASS (lab4), `resilience --mode persistence` PASS, `resilience --mode failover` PASS (2 реплики, 8 записей, recovery=4.146 s), `lab4_test_level4.py` PASS (8/8 сценариев, компенсация: bucket не вырос 10→10, параллельные загрузки: пик RSS=88.94 MiB). Подробности — [REPORT.md](REPORT.md). **Ограничения / известные ошибки:** один Docker-host, все stores и MinIO — единичные экземпляры (SPOF); тело загрузки читается в память (приемлемо при 10 MiB и лимите 512M); `s3_cleanup` best-effort — обратный случай (метаданные без объекта) только логируется как `missing_object`, не самолечится; идемпотентность только на POST сообщений; порядок `(created_at, id)` требует монотонных часов сервера. Трек 5 не заявлен. **Источники и использование ИИ:** контракт `contracts/openapi.json`, `contracts/README.md`, `README.md`, `COURSE.md`, `CONTRIBUTING.md`; библиотеки fastapi 0.115.0, uvicorn 0.32.0, psycopg 3.2.3, psycopg_pool 3.2.3, redis 5.2.0, boto3 1.35.74, Pillow 11.0.0. ИИ (DeepSeek) — помощь в структурировании кода и отчёта; весь код проверен, отредактирован и запущен автором. Секретов в Git нет. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
Vasyukova-Nat added 10 commits 2026-10-18 00:41:22 +03:00
Vasyukova-Nat changed title from Solution/bvt2303 vasyukova to ЛР 4 — БВТ2303 — Васюкова — на 4 2026-10-18 00:42:32 +03:00
Owner
  1. Повреждённые изображения сохраняются как ready. PNG с корректным IHDR и повреждённым IDAT размером 86 байт, а также обрезанный PNG возвращают 201 ready вместо 415. Независимый Pillow-декодер оба файла отвергает. Проверка ограничивается Image.open() и размерами: src/app/api/attachments.py:66.
  2. Не поддерживается обязательный диапазон до 10 MiB через LB. Корректные PNG размером 6 294 458 и 10 485 760 байт получают nginx 413 с HTML вместо ожидаемого 201. client_max_body_size в конфигурации не задан: infra/nginx.conf:17.
  3. Граничный пользовательский ввод вызывает 500. PNG-заголовок с размерами 20000×10000 вызывает необработанный PIL.Image.DecompressionBombError: фактически 500, ожидается 413 по лимиту пикселей. Исключение не входит в обработанные: src/app/api/attachments.py:68. Обычная граница проверена: ровно 40 млн пикселей принимаются, 40 005 000 отклоняются с 413.
  4. API получает административные credentials MinIO. Общий .env передаётся целиком через compose.yaml:160. В контейнере присутствуют MINIO_ROOT_USER/PASSWORD; с ними из API успешно создан другой bucket. Требуются отдельные наборы переменных для API и bootstrap.
  5. Отказ S3 обрабатывается несогласованно. После остановки MinIO /health/ready вернул 500 за 9,242 с вместо 503, upload — 504 за 10,007 с. После восстановления прежний оригинал скачивается без изменений. s3_unavailable создаётся в health.py:44, но обработчик выделяет только Redis: main.py:150. Нужны согласованные таймауты S3/LB и ответ недоступности по контракту.
1. Повреждённые изображения сохраняются как ready. PNG с корректным IHDR и повреждённым IDAT размером 86 байт, а также обрезанный PNG возвращают 201 ready вместо 415. Независимый Pillow-декодер оба файла отвергает. Проверка ограничивается Image.open() и размерами: [src/app/api/attachments.py:66](https://gitea.privcloud.tech/Vasyukova-Nat/mtusi2026lab4/src/commit/2ffe9c08f4837a4b887b73ff5aac09317f771162/src/app/api/attachments.py#L66). 2. Не поддерживается обязательный диапазон до 10 MiB через LB. Корректные PNG размером 6 294 458 и 10 485 760 байт получают nginx 413 с HTML вместо ожидаемого 201. client_max_body_size в конфигурации не задан: [infra/nginx.conf:17](https://gitea.privcloud.tech/Vasyukova-Nat/mtusi2026lab4/src/commit/2ffe9c08f4837a4b887b73ff5aac09317f771162/infra/nginx.conf#L17). 3. Граничный пользовательский ввод вызывает 500. PNG-заголовок с размерами 20000×10000 вызывает необработанный PIL.Image.DecompressionBombError: фактически 500, ожидается 413 по лимиту пикселей. Исключение не входит в обработанные: [src/app/api/attachments.py:68](https://gitea.privcloud.tech/Vasyukova-Nat/mtusi2026lab4/src/commit/2ffe9c08f4837a4b887b73ff5aac09317f771162/src/app/api/attachments.py#L68). Обычная граница проверена: ровно 40 млн пикселей принимаются, 40 005 000 отклоняются с 413. 4. API получает административные credentials MinIO. Общий .env передаётся целиком через [compose.yaml:160](https://gitea.privcloud.tech/Vasyukova-Nat/mtusi2026lab4/src/commit/2ffe9c08f4837a4b887b73ff5aac09317f771162/compose.yaml#L160). В контейнере присутствуют MINIO_ROOT_USER/PASSWORD; с ними из API успешно создан другой bucket. Требуются отдельные наборы переменных для API и bootstrap. 5. Отказ S3 обрабатывается несогласованно. После остановки MinIO /health/ready вернул 500 за 9,242 с вместо 503, upload — 504 за 10,007 с. После восстановления прежний оригинал скачивается без изменений. s3_unavailable создаётся в [health.py:44](https://gitea.privcloud.tech/Vasyukova-Nat/mtusi2026lab4/src/commit/2ffe9c08f4837a4b887b73ff5aac09317f771162/src/app/api/health.py#L44), но обработчик выделяет только Redis: [main.py:150](https://gitea.privcloud.tech/Vasyukova-Nat/mtusi2026lab4/src/commit/2ffe9c08f4837a4b887b73ff5aac09317f771162/src/app/main.py#L150). Нужны согласованные таймауты S3/LB и ответ недоступности по контракту.
Vasyukova-Nat added 2 commits 2026-10-22 14:17:12 +03:00
Vasyukova-Nat added 3 commits 2026-10-22 17:03:43 +03:00
Author
First-time contributor

Добрый день! Исправила все 5 замечаний.

Добрый день! Исправила все 5 замечаний.
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-10-24 16:17:41 +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/mtusi2026lab4#4