# ЛР4 — вложения в мессенджере Кузнецов Даниил Русланович, БПИ2304. Целевая оценка — **3**. ## Запуск Нужны Git, Python 3.13 и Docker с Compose (на Windows — запущенный Docker Desktop). Из папки репозитория: ```powershell python -X utf8 scripts/lab.py verify ``` Команда сама создаёт `.venv`, локальный `.env` и новые секреты, собирает образ, запускает стенд и все проверки. Повторный запуск сохраняет настройки и данные. API доступен на `http://127.0.0.1:18104`. TTL проверяется отдельно на порту 18114. После TTL-проверки временные контейнеры и сети убираются, volumes сохраняются. Для обычной работы: ```powershell python -X utf8 scripts/lab.py start python -X utf8 scripts/lab.py test python -X utf8 scripts/lab.py restart-check python -X utf8 scripts/lab.py failover-check python -X utf8 scripts/lab.py stop ``` `stop` сохраняет volumes. Если нужно специально стереть учебные данные: `docker compose -p kuznetsov-lab4 --env-file .env down --volumes`. На Linux можно запускать те же команды через `python3`. Команды преподавателя: `make check`, `make validate PYTHON=.venv/bin/python`, `make test BASE_URL=http://127.0.0.1:18104`. На Windows скрипт вызывает те же Python-проверки напрямую. ## Что работает Клиент → HAProxy → две API-реплики → PostgreSQL + SeaweedFS. Из ЛР3 сохранены парольный вход, Bearer-сессии, доступ по участникам чата, курсорная пагинация и идемпотентная отправка сообщений. Оригиналы лежат в приватном bucket `kuznetsov-lab4-attachments`, метаданные и связи с сообщениями — в БД. Имена объектов назначает сервер. Загрузка принимает PNG/JPEG до 10 MiB и 40 млн пикселей, проверяет MIME, имя, целостность и SHA-256. Скачивание идёт через API с проверкой участника чата. Тело пишется потоком во временный файл; файл и декодирование проверяются до публикации. На реплику разрешены две обработки, ожидание и чтение ограничены 15 секундами. S3 имеет таймауты 2/5 секунд; лимит контейнера API — 768 MiB. Сначала выполняется S3 PUT, затем SQL-транзакция с метаданными. Ответ `201 ready` возвращается после обоих сохранений. Python 3.13.14, PostgreSQL 17.11, SeaweedFS 4.54 и HAProxy 3.2.26 закреплены в Dockerfile/Compose с digest; библиотеки — в lock-файлах. Секреты передаются файлами. Наружу открыт только LB, у S3 и БД портов на хосте нет. ## Проверки Полный сценарий: `python -X utf8 scripts/lab.py verify`. | Проверка | Результат | Доказательство | | --- | --- | --- | | Структура, OpenAPI, Compose, публичный smoke | PASS | [Лог](evidence/verification.txt) | | Авторизация, Unicode, конкуренция, идемпотентность и файлы | 37 тестов, PASS | [Лог](evidence/verification.txt) | | PNG/JPEG, точные байты и SHA-256, доступ участников, лимиты | PASS | [Тесты](student-tests/test_attachments.py) и лог | | Прямое анонимное чтение S3 | 403 | [JSON](evidence/private-s3.json) | | Перезапуск обеих API, БД, S3 и LB | Сессии, сообщения и файлы сохранены | [Рестарт](evidence/restart.json), [данные](evidence/persistence.json) | | Остановка каждой загрузившей реплики | Другая возвращает тот же оригинал | [JSON](evidence/attachment-failover.json) | | Идемпотентность при отказе каждой реплики | Без потерь подтверждённых сообщений и дублей | [JSON](evidence/failover.json) | | Недоступность БД и S3 | live 200, ready/download 503; после восстановления 200 | [Сводка](evidence/summary.json) | | Logout и TTL=2 после рестарта API | Отозванный/истёкший токен получает 401 | [JSON](evidence/expiry.json), [данные](evidence/persistence.json) | ## Чистый клон Полный `verify` прошёл на коммите [41799ee](https://gitea.privcloud.tech/DaniilKuznetsov/mtusi2026lab4/commit/41799eec533d5625016dabc81eb809f6d52a21e9) из опубликованной ветки: новые секреты, новые volumes, порты 18124/18134. Команда: `python -X utf8 scripts/lab.py verify --project kuznetsov-lab4-clean-final --port 18124 --test-port 18134`. [Сводка](evidence/clean-clone.json), [полный лог](evidence/clean-clone-verification.txt), [результаты](evidence/clean-clone-summary.json). Первая попытка упёрлась в занятые подсети Docker; [причина и повтор](evidence/clean-clone-first-attempt.json) сохранены. Освобождены только сети временных стендов Даниила, volumes сохранены. ## Ограничения и источники Это локальный учебный стенд. Автоматической очистки остатков и эксперимента с памятью для уровня 4 здесь нет. Если S3 PUT прошёл, а сохранение в БД не подтвердилось, объект может остаться без метаданных. При неизвестном результате COMMIT слепое удаление опасно: транзакция могла завершиться. Готовые вложения автоматически не удаляются. Основа — [реализация ЛР4 Артура Югая](https://gitea.privcloud.tech/ArturYugay/mtusi2026lab4/src/commit/8c57de52e02ac393fac7929878edfbecb9967f20). Здесь отдельно подготовлен вариант на 3: упрощена публикация, убраны журнал и сервис очистки, нагрузочный эксперимент; настройки, секреты, порты и проверки изолированы. Задание, контракт и публичные тесты преподавателя сохранены.