Files
mtusi2026lab4/.github/pull_request_template.md
T

27 lines
4.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
## Лабораторная 4
Автор указывается при публикации. Группа: БПИ2301.
Целевая оценка: **5**.
Трек 2: **согласованность двух хранилищ**.
Перенесены API/БД/сессии/балансировка/идемпотентность lab3 и её серии экспериментов. Добавлены приватный SeaweedFS, ограниченные S3 identities, потоковые PNG/JPEG upload/download и проверка изображений, content-addressed `files` и отдельные ACL-вложения с UUID, атомарные связи сообщений и reconciler с dry-run/apply/deep.
Повторная загрузка одинаковых байтов создаёт новое логическое вложение, сохраняя единственную постоянную копию содержимого. Сборщик сериализуется с публикацией по хэшу, защищает свежие и используемые данные, обнаруживает missing/orphan и безопасно повторяет исправления.
Запуск: на Windows/Git Bash `export PYTHONUTF8=1`; затем `cp .env.example .env`, `make secrets`, `make up`, `make test PYTHON=python`, `make check PYTHON=python`, `make unit`, `make vet`. Полные команды, решения, границы согласованности, результаты и ограничения измерений — в [REPORT.md](../REPORT.md), исходные данные — в `evidence/`.
Изменения базы lab3, выделенные при переносе: обычный shutdown увеличен для активных бинарных запросов; старт ожидает свежие ответы LB. После ревью исправлены оценка памяти progressive JPEG/широкого PNG, дедлайн GET метаданных и классификация обрывов S3. S3 bootstrap ждёт регистрации сохранённых volumes, а не только ответа gateway.
Ограничения: один узел каждого хранилища и LB; HTTP только локально; нет удаления клиентских вложений и резервного восстановления повреждённых байтов. Дедупликация экономит хранение, не трафик; полная проверка изображения требует ограниченной, но существенной памяти. Числа лабораторного опыта не являются production SLA.
Источники: контракт репозитория, документация SeaweedFS/minio-go/PostgreSQL/S3, ссылки в REPORT.
ИИ-ассистент использовался как парный программист: генерация кода, тестов и черновиков документации по моим архитектурным решениям с последующим ревью каждого модуля и переработкой по замечаниям; выбор стека, структура проекта, модель данных, обработка ошибок, логирование и границы модулей определены мной; все проверки воспроизведены мной вручную.
- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
- [x] Контракт и публичные тесты не ослаблены.
- [x] make check и make test выполнены; приложен реальный вывод.
- [x] Сценарии отказов/безопасности своего уровня воспроизведены.
- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.