ЛР4 - БВТ2301 - Журавский - на 4 #77

Closed
ejur22 wants to merge 1 commits from ejur22/mtusi2026lab4:solution/БВТ2301-Журавский into main
First-time contributor

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

Автор / группа: Журавский Егор БВТ2301
Целевая оценка (3/4/5): 4

  • Что перенесено из lab3
    Перенесены src/ (app, config, db, errors, instance, invalidation, migrate, pagination, repositories, security, sessions, state), migrations/, student-tests/, Dockerfile, infra/nginx.conf, scripts/ (restart/stop-one/gen-secrets/restore/rolling), requirements, Makefile. Не копировались .git, .env, contracts/, публичные tests/, README/COURSE, volumes.

Схема: Клиент → nginx LB → API ×2 → PostgreSQL (метаданные) + Valkey (кэш сессий) + SeaweedFS S3 (байты). Публикуется только порт балансировщика; реплики API и S3 доступны лишь внутри compose-сети.

  • Метаданные — PostgreSQL, байты — S3. Таблица attachments (+ message_attachments) хранит s3_key, content_type, size_bytes, sha256, status, error_code. Ключ объекта назначает сервер (chats/{chat_id}/{attachment_id}), filename — только для отображения. Bucket приватный, у API отдельные ограниченные S3-креды (identity messenger-api, действия Read/Write/List:); root используется только одноразовым s3-init.
  • Транзакционная граница двух хранилищ. Синхронный upload: поток → временный spill-to-disk файл (жёсткий лимит байт) → проверка изображения → S3 PUT → INSERT метаданных в одной транзакции. Если COMMIT не удался после PUT, объект удаляется best-effort (компенсация). Окно падения (краш между PUT и COMMIT) закрывает сверка src.reconcile с grace period.
  • Проверка изображений по содержимому. Формат и размеры определяет Pillow по байтам, а не Content-Type/filename. Предел пикселей проверяется по заголовку до полного декодирования (защита от decompression bomb). >10 MiB → 413, не PNG/JPEG или повреждённый → 415, опасный filename → 400.
  • Доступ. Любой участник чата читает метаданные и байты вложения; посторонний получает 404 (не 403). Привязать к сообщению можно только вложение этого чата в статусе ready.
  • Синхронный 201. Lab4 возвращает 201 ready сразу после сохранения оригинала и метаданных (асинхронный режим — с lab5).
  • Масштабирование (перенос lab3). Балансировщик, ≥2 взаимозаменяемые реплики, общие PostgreSQL/Valkey, X-Instance-Id, идемпотентность сообщений через общую таблицу idempotency_keys + advisory-lock. Хэш запроса сообщения теперь включает attachment_ids (отсутствие ≡ [], порядок не значим).
  • Отказоустойчивость зависимостей. PostgreSQL и S3 критичны для синхронного пути: /health/ready = 503 при недоступности любого из них. Недоступность Valkey обходится (кэш сессий не источник истины). Каждая операция S3/Valkey ограничена таймаутом и mini circuit breaker, т.к. DNS остановленного контейнера может блокироваться.
  • Соответствие .env.example
## Лабораторная 4 Автор / группа: Журавский Егор БВТ2301 Целевая оценка (3/4/5): 4 - Что перенесено из lab3 Перенесены src/ (app, config, db, errors, instance, invalidation, migrate, pagination, repositories, security, sessions, state), migrations/, student-tests/, Dockerfile, infra/nginx.conf, scripts/ (restart/stop-one/gen-secrets/restore/rolling), requirements, Makefile. Не копировались .git, .env, contracts/, публичные tests/, README/COURSE, volumes. Схема: Клиент → nginx LB → API ×2 → PostgreSQL (метаданные) + Valkey (кэш сессий) + SeaweedFS S3 (байты). Публикуется только порт балансировщика; реплики API и S3 доступны лишь внутри compose-сети. - Метаданные — PostgreSQL, байты — S3. Таблица attachments (+ message_attachments) хранит s3_key, content_type, size_bytes, sha256, status, error_code. Ключ объекта назначает сервер (chats/{chat_id}/{attachment_id}), filename — только для отображения. Bucket приватный, у API отдельные ограниченные S3-креды (identity messenger-api, действия Read/Write/List:<bucket>); root используется только одноразовым s3-init. - Транзакционная граница двух хранилищ. Синхронный upload: поток → временный spill-to-disk файл (жёсткий лимит байт) → проверка изображения → S3 PUT → INSERT метаданных в одной транзакции. Если COMMIT не удался после PUT, объект удаляется best-effort (компенсация). Окно падения (краш между PUT и COMMIT) закрывает сверка src.reconcile с grace period. - Проверка изображений по содержимому. Формат и размеры определяет Pillow по байтам, а не Content-Type/filename. Предел пикселей проверяется по заголовку до полного декодирования (защита от decompression bomb). >10 MiB → 413, не PNG/JPEG или повреждённый → 415, опасный filename → 400. - Доступ. Любой участник чата читает метаданные и байты вложения; посторонний получает 404 (не 403). Привязать к сообщению можно только вложение этого чата в статусе ready. - Синхронный 201. Lab4 возвращает 201 ready сразу после сохранения оригинала и метаданных (асинхронный режим — с lab5). - Масштабирование (перенос lab3). Балансировщик, ≥2 взаимозаменяемые реплики, общие PostgreSQL/Valkey, X-Instance-Id, идемпотентность сообщений через общую таблицу idempotency_keys + advisory-lock. Хэш запроса сообщения теперь включает attachment_ids (отсутствие ≡ [], порядок не значим). - Отказоустойчивость зависимостей. PostgreSQL и S3 критичны для синхронного пути: /health/ready = 503 при недоступности любого из них. Недоступность Valkey обходится (кэш сессий не источник истины). Каждая операция S3/Valkey ограничена таймаутом и mini circuit breaker, т.к. DNS остановленного контейнера может блокироваться. - Соответствие .env.example
ejur22 added 1 commit 2026-11-06 17:20:39 +03:00
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-07 17:46:41 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab4#77