Л4 Гусак БПИ2303 - на 4 #135

Closed
GusakDA wants to merge 1 commits from GusakDA/mtusi2026lab4:solution/bpi2303-gusak into main
First-time contributor

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

Автор / группа: Гусак Дмитрий / БПИ2303
Целевая оценка: 4
Трек 5: не заявлен

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

Перенесена функциональность лабораторной 3: Java Spring Boot API, две реплики, HAProxy, PostgreSQL, Redis, общие сессии, идемпотентность сообщений, Flyway-миграции, healthcheck, failover и rolling update.

Добавлено в лабораторной 4:

  • MinIO как приватное S3-хранилище;
  • хранение метаданных вложений в PostgreSQL;
  • хранение бинарных данных в MinIO;
  • загрузка PNG/JPEG до 10 MiB;
  • проверка MIME по содержимому;
  • ограничение до 40 млн пикселей;
  • проверка повреждённых изображений;
  • авторизованное скачивание файлов;
  • проверка доступа к вложениям по участию в чате;
  • связь сообщений с вложениями через attachment_ids;
  • отдельный S3-пользователь с ограниченными правами;
  • идемпотентный bootstrap bucket;
  • компенсационное удаление S3-объекта при ошибке записи метаданных;
  • тест 10 одновременных загрузок с измерением памяти.
    Команды запуска из чистого clone:

cp .env.example .env

Сгенерировать CURSOR_SECRET:

openssl rand -base64 32 | tr '+/' '-_' | tr -d '='

Полученное значение добавить в .env. Также указать локальные S3 credentials.

docker compose --env-file .env config --quiet

docker compose --env-file .env up -d --build --scale api=2

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

make check

make validate PYTHON=.venv/bin/python

make test

make test-grade4

make test-upload-memory

make test-rolling

make test-persistence ACTION_SCRIPT=scripts/restart.sh

make test-failover ACTION_SCRIPT=scripts/stop-one.sh

Остановить стенд без удаления данных:

docker compose --env-file .env down

Удалить учебные volumes:

docker compose --env-file .env down -v

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

./gradlew clean build — BUILD SUCCESSFUL

make check — PASS

make validate — PASS

make test — PASS

make test-grade4 — PASS

make test-upload-memory — PASS

make test-rolling — PASS

make test-persistence — PASS

make test-failover — PASS

В тесте загрузок 10 из 10 параллельных upload завершились успешно. Пиковое потребление памяти API составило 382.8 MiB при установленном лимите 512 MiB.

В failover-тесте после остановки одной API-реплики вложение успешно скачивалось через вторую реплику. Данные, сессии и файлы сохранились.

Подробное описание архитектуры, запуска и результатов находится в REPORT.md.

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

  • MinIO, PostgreSQL и HAProxy являются одиночными компонентами на одном Docker-хосте.
  • Отказ самого Docker-хоста не обрабатывается.
  • TLS в учебном стенде не настроен.
  • Автоматический фоновый reconciler для orphan-объектов не реализован; предусмотрена компенсация и ручная сверка с grace period 24 часа.
  • Presigned upload и исследовательский трек оценки 5 не реализованы.
  • Консоль MinIO не публикуется наружу.
    Источники и использование ИИ:

Использовалась официальная документация Docker Compose, MinIO S3, Spring Boot, PostgreSQL, Redis и Java ImageIO. ИИ использовался для разбора задания, проектирования архитектуры, объяснения кода, подготовки тестов и проверки реализации. Код и результаты тестов проверены локально.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов и безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
##Лабораторная 4 Автор / группа: Гусак Дмитрий / БПИ2303 Целевая оценка: 4 Трек 5: не заявлен Что реализовано и что перенесено: Перенесена функциональность лабораторной 3: Java Spring Boot API, две реплики, HAProxy, PostgreSQL, Redis, общие сессии, идемпотентность сообщений, Flyway-миграции, healthcheck, failover и rolling update. Добавлено в лабораторной 4: - MinIO как приватное S3-хранилище; - хранение метаданных вложений в PostgreSQL; - хранение бинарных данных в MinIO; - загрузка PNG/JPEG до 10 MiB; - проверка MIME по содержимому; - ограничение до 40 млн пикселей; - проверка повреждённых изображений; - авторизованное скачивание файлов; - проверка доступа к вложениям по участию в чате; - связь сообщений с вложениями через attachment_ids; - отдельный S3-пользователь с ограниченными правами; - идемпотентный bootstrap bucket; - компенсационное удаление S3-объекта при ошибке записи метаданных; - тест 10 одновременных загрузок с измерением памяти. Команды запуска из чистого clone: cp .env.example .env Сгенерировать CURSOR_SECRET: openssl rand -base64 32 | tr '+/' '-_' | tr -d '=' Полученное значение добавить в .env. Также указать локальные S3 credentials. docker compose --env-file .env config --quiet docker compose --env-file .env up -d --build --scale api=2 curl -i http://localhost:8080/health/ready make check make validate PYTHON=.venv/bin/python make test make test-grade4 make test-upload-memory make test-rolling make test-persistence ACTION_SCRIPT=scripts/restart.sh make test-failover ACTION_SCRIPT=scripts/stop-one.sh Остановить стенд без удаления данных: docker compose --env-file .env down Удалить учебные volumes: docker compose --env-file .env down -v Результаты проверок и ссылка на REPORT.md: ./gradlew clean build — BUILD SUCCESSFUL make check — PASS make validate — PASS make test — PASS make test-grade4 — PASS make test-upload-memory — PASS make test-rolling — PASS make test-persistence — PASS make test-failover — PASS В тесте загрузок 10 из 10 параллельных upload завершились успешно. Пиковое потребление памяти API составило 382.8 MiB при установленном лимите 512 MiB. В failover-тесте после остановки одной API-реплики вложение успешно скачивалось через вторую реплику. Данные, сессии и файлы сохранились. Подробное описание архитектуры, запуска и результатов находится в REPORT.md. Ограничения / известные ошибки: - MinIO, PostgreSQL и HAProxy являются одиночными компонентами на одном Docker-хосте. - Отказ самого Docker-хоста не обрабатывается. - TLS в учебном стенде не настроен. - Автоматический фоновый reconciler для orphan-объектов не реализован; предусмотрена компенсация и ручная сверка с grace period 24 часа. - Presigned upload и исследовательский трек оценки 5 не реализованы. - Консоль MinIO не публикуется наружу. Источники и использование ИИ: Использовалась официальная документация Docker Compose, MinIO S3, Spring Boot, PostgreSQL, Redis и Java ImageIO. ИИ использовался для разбора задания, проектирования архитектуры, объяснения кода, подготовки тестов и проверки реализации. Код и результаты тестов проверены локально. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов и безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
GusakDA added 1 commit 2026-11-13 20:30:02 +03:00
Owner

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

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-15 20:58:14 +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#135