Схема: Клиент → 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
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Лабораторная 4
Автор / группа: Журавский Егор БВТ2301
Целевая оценка (3/4/5): 4
Перенесены 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-сети.
Принято. Закрываю МР.
Pull request closed