ЛР 4 — БПИ-2304 — Саламатин — на 4 #158

Closed
gwalut wants to merge 3 commits from gwalut/mtusi2026lab4:solution/bpi-2304-salamatin into main
First-time contributor

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

Автор: Саламатин, БПИ-2304. Целевая оценка — 4, весь минимум на 3 и все пункты на 4. Треки на 5 не выполнялись.

Добавил изображения в сообщения: PNG и JPEG загружаются в приватный MinIO, а метаданные и связь с чатом сохраняются в PostgreSQL. Оригинал скачивается через авторизованный API без перекодирования. Сохранил собственную реализацию lab3: две API-реплики за HAProxy, Redis-сессии, историю с cursor и Idempotency-Key для сообщений.

Что сделано

  • Проверка реального формата изображения, размера до 10 MiB и не более 40 млн пикселей. Опасные имена файлов отклоняются, ключ S3 назначает сервер.
  • Доступ к метаданным и оригиналу только для участников чата. Файл из другого чата прикрепить нельзя.
  • Перед PUT сохраняется запись pending. После сбоя между S3 и БД cleanup удаляет старые pending с часовым grace period; активные операции защищены блокировкой строки.
  • Идемпотентный bootstrap bucket, отдельные ограниченные S3 credentials для приложения, закрытая административная консоль и volumes для хранилищ.

Запуск из чистого clone

Нужны Docker Desktop с Linux containers и Compose. На Windows из корня репозитория:

./start.ps1

Или с установленным Python:

python scripts/init_local.py
docker compose build api checks minio
docker compose up -d --no-build --wait --wait-timeout 180
python scripts/verify.py

API доступен на http://127.0.0.1:8084. Первая сборка занимает несколько минут: MinIO собирается из закреплённого официального релиза исходников, поскольку готовые образы не удалось скачать.

Что проверил

Публичные make check и make test прошли, как и 17 собственных интеграционных тестов. Проверены повреждённое изображение, подмена MIME, слишком большой файл, чужие ID, отказ S3, обрыв загрузки и ошибка после PUT до подтверждения БД. Прямые анонимные list/GET в S3 возвращают 403, повторный bootstrap сохраняет файлы.

Restart сохранил прежнюю сессию и оригинал. Оба публичных прогона failover прошли, восстановление записи — примерно 2,3 секунды. Отдельно остановлена именно загрузившая файл API-реплика: другая скачала тот же оригинал.

В опыте с 10 одновременными загрузками примерно по 7,79 MiB все файлы загрузились и скачались с совпавшими SHA-256. Выборочные пики памяти двух API — 248,3 и 217,6 MiB при лимите 512 MiB на реплику.

Отчёт с командами и результатами, доказательства проверок, понятный разбор в Word.

Ограничения и источники

Учебный стенд работает на одном компьютере. PostgreSQL, Redis, MinIO и LB остаются одиночными точками отказа; backup и удалённый HTTPS не реализованы. Опыт с памятью — один локальный функциональный прогон, не измерение предельной производительности.

Основа — собственная lab3. Использованы контракт задания, официальные исходники MinIO/mc и документация Pillow/boto3. Библиотеки: FastAPI, Pydantic, Uvicorn, Psycopg, redis-py, boto3 и Pillow. Codex помог с кодом, проверками и документацией.

  • Обязательный минимум сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены, реальный вывод приложен.
  • Сценарии отказов и проверки уровня 4 воспроизведены.
  • Секреты и приватные ключи исключены из Git.
  • README задания сохранён, REPORT.md описывает запуск моего решения.
## Лабораторная 4 Автор: Саламатин, БПИ-2304. Целевая оценка — 4, весь минимум на 3 и все пункты на 4. Треки на 5 не выполнялись. Добавил изображения в сообщения: PNG и JPEG загружаются в приватный MinIO, а метаданные и связь с чатом сохраняются в PostgreSQL. Оригинал скачивается через авторизованный API без перекодирования. Сохранил собственную реализацию lab3: две API-реплики за HAProxy, Redis-сессии, историю с cursor и Idempotency-Key для сообщений. ### Что сделано - Проверка реального формата изображения, размера до 10 MiB и не более 40 млн пикселей. Опасные имена файлов отклоняются, ключ S3 назначает сервер. - Доступ к метаданным и оригиналу только для участников чата. Файл из другого чата прикрепить нельзя. - Перед PUT сохраняется запись pending. После сбоя между S3 и БД cleanup удаляет старые pending с часовым grace period; активные операции защищены блокировкой строки. - Идемпотентный bootstrap bucket, отдельные ограниченные S3 credentials для приложения, закрытая административная консоль и volumes для хранилищ. ### Запуск из чистого clone Нужны Docker Desktop с Linux containers и Compose. На Windows из корня репозитория: ```powershell ./start.ps1 ``` Или с установленным Python: ```sh python scripts/init_local.py docker compose build api checks minio docker compose up -d --no-build --wait --wait-timeout 180 python scripts/verify.py ``` API доступен на http://127.0.0.1:8084. Первая сборка занимает несколько минут: MinIO собирается из закреплённого официального релиза исходников, поскольку готовые образы не удалось скачать. ### Что проверил Публичные make check и make test прошли, как и 17 собственных интеграционных тестов. Проверены повреждённое изображение, подмена MIME, слишком большой файл, чужие ID, отказ S3, обрыв загрузки и ошибка после PUT до подтверждения БД. Прямые анонимные list/GET в S3 возвращают 403, повторный bootstrap сохраняет файлы. Restart сохранил прежнюю сессию и оригинал. Оба публичных прогона failover прошли, восстановление записи — примерно 2,3 секунды. Отдельно остановлена именно загрузившая файл API-реплика: другая скачала тот же оригинал. В опыте с 10 одновременными загрузками примерно по 7,79 MiB все файлы загрузились и скачались с совпавшими SHA-256. Выборочные пики памяти двух API — 248,3 и 217,6 MiB при лимите 512 MiB на реплику. [Отчёт с командами и результатами](https://gitea.privcloud.tech/gwalut/mtusi2026lab4/src/branch/solution/bpi-2304-salamatin/REPORT.md), [доказательства проверок](https://gitea.privcloud.tech/gwalut/mtusi2026lab4/src/branch/solution/bpi-2304-salamatin/evidence), [понятный разбор в Word](https://gitea.privcloud.tech/gwalut/mtusi2026lab4/src/branch/solution/bpi-2304-salamatin/docs/REVIEW.docx). ### Ограничения и источники Учебный стенд работает на одном компьютере. PostgreSQL, Redis, MinIO и LB остаются одиночными точками отказа; backup и удалённый HTTPS не реализованы. Опыт с памятью — один локальный функциональный прогон, не измерение предельной производительности. Основа — собственная lab3. Использованы контракт задания, официальные исходники MinIO/mc и документация Pillow/boto3. Библиотеки: FastAPI, Pydantic, Uvicorn, Psycopg, redis-py, boto3 и Pillow. Codex помог с кодом, проверками и документацией. - [x] Обязательный минимум сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены, реальный вывод приложен. - [x] Сценарии отказов и проверки уровня 4 воспроизведены. - [x] Секреты и приватные ключи исключены из Git. - [x] README задания сохранён, REPORT.md описывает запуск моего решения.
gwalut added 2 commits 2026-11-17 13:34:51 +03:00
gwalut added 1 commit 2026-11-17 13:36:40 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-17 19:25:44 +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#158