ЛР 4 — БПИ2303 — Мартинес — на 4 #164

Open
Mirariel wants to merge 1 commits from Mirariel/mtusi2026lab4:solution/bpi2303-martines into main
First-time contributor

Лабораторная 4 — отчёт

Мартинес Анастасия, БПИ2303. Целевая оценка: 4. Ветка:
solution/bpi2303-martines.

Запуск

python scripts/bootstrap.py
docker compose config --quiet
docker compose up -d --build
python -X utf8 tests/smoke.py --base-url http://127.0.0.1:8080

Стенд содержит HAProxy, две API-реплики, PostgreSQL, Redis, MinIO и cleanup
worker. Внешний API доступен только на 127.0.0.1:8080; S3 API локально
опубликован для отрицательной проверки private bucket, административная
консоль MinIO наружу не публикуется. Secrets генерируются в игнорируемой
secrets/; docker compose down сохраняет данные, down -v удаляет
учебные volumes намеренно.

Использованы Python 3.12.8, PostgreSQL 16.6, Redis 7.4.1, HAProxy 3.0.6,
MinIO pinned digest, Flask/Gunicorn/Psycopg/Redis-py/Boto3/Pillow с pinned
версиями. Контракт, README и публичные tests не менялись.

Архитектура и решения

Из lab3 сохранены общие сессии, LB, две реплики и idempotency. Метаданные
attachment лежат в PostgreSQL, байты — в приватном S3 bucket messenger.
API получает отдельные credentials с правами на object prefixes; root keys
используются только bootstrap-контейнером. Filename используется для
отображения, object key генерирует сервер.

Upload принимает только сырые PNG/JPEG, ограничивает тело 10 MiB до записи,
проверяет MIME по содержимому и ограничивает 40 млн пикселей Pillow. Файл
сначала пишется в S3, затем metadata — в БД. Таблица object_intents
служит durable журналом намерения: cleanup удаляет старые unreferenced
objects после grace period. Поэтому сбой между S3 и PostgreSQL не оставляет
вечные orphan objects. Запись metadata и удаление intent происходят одной
транзакцией. Download доступен только участнику чата и отдаёт байты через API,
без redirect.

Составной message сохраняет attachment_ids; attachment другого чата,
чужой attachment и failed attachment отвергаются до записи сообщения.
Ограниченный semaphore и SpooledTemporaryFile не позволяют одной загрузке
занять неограниченную RAM; 10 одновременных upload операций разрешены в
пределах лимита.

Проверки

Публичный smoke:

PASS: lab4 public API scenario; infrastructure and grading evidence remain separate.

Smoke проверяет upload 201 ready, checksum/size, авторизованный download,
сообщение с attachment и отсутствие доступа у outsider. Дополнительный
student-tests/attachments.py покрывает повреждённый файл, MIME spoof,
опасное имя, >10 MiB, чужой ID, private bucket и 10 concurrent upload.
Сценарии lab3 tests/resilience.py используются для persistence/failover;
lab3 проверка до переноса дала: две реплики, 24 concurrent idempotent requests
создали одну запись, отказ каждой реплики восстанавливался примерно за 1.1 с,
rolling recreation сохранял подтверждённые сообщения.

Память контейнеров во время расширенной проверки сохраняется в
evidence/attachment-resources.txt. Cleanup — dry-run по умолчанию и
--apply --loop только внутри Compose. При сбое S3 API возвращает
ограниченную ошибку; неавторизованный пользователь не узнаёт существование
attachment.

Ограничения

Один MinIO/DB/LB и один Docker host остаются SPOF. Reconciliation удаляет
только intents старше часа; аварийный orphan моложе grace period ожидает
следующего прохода. Тест памяти зависит от ресурсов ноутбука и не является
production SLA. HTTPS и mTLS относятся к lab7, исследовательский track 5
не заявлен.

Помощь ИИ: Codex подготовил реализацию, тесты, измерения и отчёт. Все fixtures
синтетические; секреты, токены и private keys в Git не попадают.

# Лабораторная 4 — отчёт Мартинес Анастасия, БПИ2303. Целевая оценка: **4**. Ветка: `solution/bpi2303-martines`. ## Запуск ```sh python scripts/bootstrap.py docker compose config --quiet docker compose up -d --build python -X utf8 tests/smoke.py --base-url http://127.0.0.1:8080 ``` Стенд содержит HAProxy, две API-реплики, PostgreSQL, Redis, MinIO и cleanup worker. Внешний API доступен только на 127.0.0.1:8080; S3 API локально опубликован для отрицательной проверки private bucket, административная консоль MinIO наружу не публикуется. Secrets генерируются в игнорируемой `secrets/`; `docker compose down` сохраняет данные, `down -v` удаляет учебные volumes намеренно. Использованы Python 3.12.8, PostgreSQL 16.6, Redis 7.4.1, HAProxy 3.0.6, MinIO pinned digest, Flask/Gunicorn/Psycopg/Redis-py/Boto3/Pillow с pinned версиями. Контракт, README и публичные tests не менялись. ## Архитектура и решения Из lab3 сохранены общие сессии, LB, две реплики и idempotency. Метаданные attachment лежат в PostgreSQL, байты — в приватном S3 bucket `messenger`. API получает отдельные credentials с правами на object prefixes; root keys используются только bootstrap-контейнером. Filename используется для отображения, object key генерирует сервер. Upload принимает только сырые PNG/JPEG, ограничивает тело 10 MiB до записи, проверяет MIME по содержимому и ограничивает 40 млн пикселей Pillow. Файл сначала пишется в S3, затем metadata — в БД. Таблица `object_intents` служит durable журналом намерения: cleanup удаляет старые unreferenced objects после grace period. Поэтому сбой между S3 и PostgreSQL не оставляет вечные orphan objects. Запись metadata и удаление intent происходят одной транзакцией. Download доступен только участнику чата и отдаёт байты через API, без redirect. Составной message сохраняет `attachment_ids`; attachment другого чата, чужой attachment и failed attachment отвергаются до записи сообщения. Ограниченный semaphore и SpooledTemporaryFile не позволяют одной загрузке занять неограниченную RAM; 10 одновременных upload операций разрешены в пределах лимита. ## Проверки Публичный smoke: ``` PASS: lab4 public API scenario; infrastructure and grading evidence remain separate. ``` Smoke проверяет upload 201 ready, checksum/size, авторизованный download, сообщение с attachment и отсутствие доступа у outsider. Дополнительный `student-tests/attachments.py` покрывает повреждённый файл, MIME spoof, опасное имя, >10 MiB, чужой ID, private bucket и 10 concurrent upload. Сценарии lab3 `tests/resilience.py` используются для persistence/failover; lab3 проверка до переноса дала: две реплики, 24 concurrent idempotent requests создали одну запись, отказ каждой реплики восстанавливался примерно за 1.1 с, rolling recreation сохранял подтверждённые сообщения. Память контейнеров во время расширенной проверки сохраняется в `evidence/attachment-resources.txt`. Cleanup — dry-run по умолчанию и `--apply --loop` только внутри Compose. При сбое S3 API возвращает ограниченную ошибку; неавторизованный пользователь не узнаёт существование attachment. ## Ограничения Один MinIO/DB/LB и один Docker host остаются SPOF. Reconciliation удаляет только intents старше часа; аварийный orphan моложе grace period ожидает следующего прохода. Тест памяти зависит от ресурсов ноутбука и не является production SLA. HTTPS и mTLS относятся к lab7, исследовательский track 5 не заявлен. Помощь ИИ: Codex подготовил реализацию, тесты, измерения и отчёт. Все fixtures синтетические; секреты, токены и private keys в Git не попадают.
Mirariel added 1 commit 2026-11-20 19:01:31 +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/Mirariel/mtusi2026lab4 solution/bpi2303-martines:Mirariel-solution/bpi2303-martines
git checkout Mirariel-solution/bpi2303-martines
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#164