Solution/bpi2301 bakulin #160

Open
kudesn1k wants to merge 6 commits from kudesn1k/mtusi2026lab4:solution/bpi2301-bakulin into main
First-time contributor

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

Бакулин, БПИ2301. Целевая оценка 5, трек 2 — согласованность двух хранилищ.

Перенёс из ЛР 3 API мессенджера, PostgreSQL, сессии в Valkey, балансировку, идемпотентность отправки и серии экспериментов трека 1. Добавил загрузку и скачивание PNG/JPEG с проверкой формата и размеров. Байты хранятся в приватном SeaweedFS по SHA-256. Каждая отправка файла получает собственный UUID, имя и привязку к чату. Две загрузки одинакового изображения в разные чаты используют один постоянный объект, а права на скачивание проверяются отдельно.

PostgreSQL и S3 могут пережить сбой на разных этапах загрузки. Для исправления расхождений реализована сверка с режимами dry-run, --apply и --deep. Перед исправлением сервис берёт ту же блокировку по хэшу, что и при публикации, и заново проверяет ссылки. В эксперименте dry-run обнаружил 6 расхождений, apply исправил 5. Повторный apply выполнил 0 исправлений. Сверка сохранила используемый объект с повреждёнными байтами и сообщила о нём.

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

Для Windows в Git Bash выполните export PYTHONUTF8=1. Для команд нужны Docker Compose, Go с поддержкой -race, Make и Python.

cp .env.example .env
make secrets
make up
make test PYTHON=python
make check PYTHON=python
make unit
make vet

Результаты и ограничения

Прошли публичный smoke, Go-тесты с -race, go vet и проверка структуры контракта. Проверены сохранность данных после перезапуска, скачивание после остановки реплики, доступ к вложениям и согласованность при частичных отказах. Методика, команды воспроизведения, источники и результаты приведены в отчёте. REPORT.md · Вывод проверок и данные экспериментов

У каждого хранилища и балансировщика по одному узлу. Дедупликация экономит место, загрузочный трафик сохраняется. Повреждение объекта с сохранением размера обнаруживается при --deep. Для восстановления байтов требуется исправная копия. Дополнительная полная OpenAPI-валидация осталась непроверенной из-за недоступности зависимости.

Источники и использование ИИ

Контракт репозитория и документация SeaweedFS, minio-go, PostgreSQL и S3. Ссылки приведены в отчёте.

ИИ-ассистент использовался как парный программист: генерация кода, тестов и черновиков документации по моим архитектурным решениям с последующим ревью каждого модуля и переработкой по замечаниям; выбор стека, структура проекта, модель данных, обработка ошибок, логирование и границы модулей определены мной; все проверки воспроизведены мной вручную.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 4 Бакулин, БПИ2301. Целевая оценка **5**, трек 2 — **согласованность двух хранилищ**. Перенёс из ЛР 3 API мессенджера, PostgreSQL, сессии в Valkey, балансировку, идемпотентность отправки и серии экспериментов трека 1. Добавил загрузку и скачивание PNG/JPEG с проверкой формата и размеров. Байты хранятся в приватном SeaweedFS по SHA-256. Каждая отправка файла получает собственный UUID, имя и привязку к чату. Две загрузки одинакового изображения в разные чаты используют один постоянный объект, а права на скачивание проверяются отдельно. PostgreSQL и S3 могут пережить сбой на разных этапах загрузки. Для исправления расхождений реализована сверка с режимами `dry-run`, `--apply` и `--deep`. Перед исправлением сервис берёт ту же блокировку по хэшу, что и при публикации, и заново проверяет ссылки. В эксперименте dry-run обнаружил 6 расхождений, apply исправил 5. Повторный apply выполнил 0 исправлений. Сверка сохранила используемый объект с повреждёнными байтами и сообщила о нём. ### Запуск из чистого клона Для Windows в Git Bash выполните `export PYTHONUTF8=1`. Для команд нужны Docker Compose, Go с поддержкой `-race`, Make и Python. ```sh cp .env.example .env make secrets make up make test PYTHON=python make check PYTHON=python make unit make vet ``` ### Результаты и ограничения Прошли публичный smoke, Go-тесты с `-race`, `go vet` и проверка структуры контракта. Проверены сохранность данных после перезапуска, скачивание после остановки реплики, доступ к вложениям и согласованность при частичных отказах. Методика, команды воспроизведения, источники и результаты приведены в отчёте. [REPORT.md](https://gitea.privcloud.tech/kudesn1k/mtusi2026lab4/src/branch/solution/bpi2301-bakulin/REPORT.md) · [Вывод проверок и данные экспериментов](https://gitea.privcloud.tech/kudesn1k/mtusi2026lab4/src/branch/solution/bpi2301-bakulin/evidence) У каждого хранилища и балансировщика по одному узлу. Дедупликация экономит место, загрузочный трафик сохраняется. Повреждение объекта с сохранением размера обнаруживается при `--deep`. Для восстановления байтов требуется исправная копия. Дополнительная полная OpenAPI-валидация осталась непроверенной из-за недоступности зависимости. ### Источники и использование ИИ Контракт репозитория и документация SeaweedFS, minio-go, PostgreSQL и S3. Ссылки приведены в отчёте. ИИ-ассистент использовался как парный программист: генерация кода, тестов и черновиков документации по моим архитектурным решениям с последующим ревью каждого модуля и переработкой по замечаниям; выбор стека, структура проекта, модель данных, обработка ошибок, логирование и границы модулей определены мной; все проверки воспроизведены мной вручную. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
kudesn1k added 6 commits 2026-11-18 12:10:33 +03:00
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/kudesn1k/mtusi2026lab4 solution/bpi2301-bakulin:kudesn1k-solution/bpi2301-bakulin
git checkout kudesn1k-solution/bpi2301-bakulin
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/mtusi2026lab4#160