Files
mtusi2026lab4/REPORT.md
T
DaniilKuznetsovandЮгай Артур Рустамович 0c5c19bb09 ЛР4 на 3
Co-authored-by: Югай Артур Рустамович <f1ekserr@yandex.ru>
2026-11-16 22:00:33 +03:00

84 lines
6.1 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 — вложения в мессенджере
Кузнецов Даниил Русланович, БПИ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.
Для обычной работы:
```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) |
## Ограничения и источники
Это локальный учебный стенд. Автоматической очистки остатков и эксперимента с памятью
для уровня 4 здесь нет. Если S3 PUT прошёл, а сохранение в БД не подтвердилось,
объект может остаться без метаданных. При неизвестном результате COMMIT слепое удаление
опасно: транзакция могла завершиться. Готовые вложения автоматически не удаляются.
Основа — [реализация ЛР4 Артура Югая](https://gitea.privcloud.tech/ArturYugay/mtusi2026lab4/src/commit/8c57de52e02ac393fac7929878edfbecb9967f20).
Здесь отдельно подготовлен вариант на 3: упрощена публикация, убраны журнал и сервис
очистки, нагрузочный эксперимент; настройки, секреты, порты и проверки изолированы.
Задание, контракт и публичные тесты преподавателя сохранены.