ЛР5 — БПИ2302 — Бондаренко — на 4 #78

Open
Mari wants to merge 4 commits from Mari/mtusi2026lab5:main into main
First-time contributor

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

Автор / группа: Бондаренко Мария, БПИ2302
Целевая оценка (3/4/5): 4

Что реализовано и что перенесено:

  1. Базовый функционал
  • API и Аутентификация: Управление пользователями, авторизация по Basic/Bearer токенам через Redis, создание чатов и отправка текстовых сообщений с поддержкой идемпотентности (Idempotency-Key)
  • Пагинация и Безопасность: Курсорная пагинация истории сообщений с HMAC-подписью курсоров и изоляцией реплик API (X-Instance-Id)
  • Асинхронный пайплайн вложений: Загрузка файлов в S3 через staging-зону, регистрация метаданных в PostgreSQL и базовая очередь задач на базе Redis Streams
  • Обработка изображений: Автоматическое считывание EXIF-ориентации, проверка размеров/форматов и генерация базового thumbnail
  1. Продвинутый функционал и отказоустойчивость
  • Расширенные варианты изображений: Реализована генерация трех вариантов:
    • thumbnail (JPEG, макс. 256×256),
    • optimized (WebP, макс. 1280×1280),
    • crop (точный квадрат 128×128 по центру).
  • Паттерн Outbox: Введена таблица outbox в PostgreSQL. Запись метаданных вложения и постановка задачи в очередь происходят в рамках одной транзакции, что исключает потерю задач при падении между БД и брокером. Фоновый поток в API (outbox_publisher) гарантирует доставку сообщений
  • Многопоточность воркера: В воркере задействован ThreadPoolExecutor с настраиваемым параметром WORKER_CONCURRENCY для параллельной обработки задач
  • Отказоустойчивость и управление ошибками:
    • Backoff + Jitter: Экспоненциальная задержка с добавлением случайного шума при временных сетевых или ресурсных сбоях
    • DLQ: Выделенный стрим attachment_jobs_dlq для задач, исчерпавших все лимиты попыток
    • Replay: Реализован эндпоинт /api/v1/attachments/{id}/replay для ручного или автоматического перезапуска неудачных/упавших вложений
  • Защита от зависаний и очистка:
    • Периодический фоновый XAUTOCLAIM для перехвата "зависших" сообщений при падении воркеров
    • Жесткие лимиты времени выполнения задач с безопасным сбросом таймеров
    • Регулярная фоновая очистка устаревших файлов из staging/ в S3
## Лабораторная 5 Автор / группа: Бондаренко Мария, БПИ2302 Целевая оценка (3/4/5): 4 Что реализовано и что перенесено: 1. Базовый функционал * API и Аутентификация: Управление пользователями, авторизация по Basic/Bearer токенам через Redis, создание чатов и отправка текстовых сообщений с поддержкой идемпотентности (Idempotency-Key) * Пагинация и Безопасность: Курсорная пагинация истории сообщений с HMAC-подписью курсоров и изоляцией реплик API (X-Instance-Id) * Асинхронный пайплайн вложений: Загрузка файлов в S3 через staging-зону, регистрация метаданных в PostgreSQL и базовая очередь задач на базе Redis Streams * Обработка изображений: Автоматическое считывание EXIF-ориентации, проверка размеров/форматов и генерация базового thumbnail 2. Продвинутый функционал и отказоустойчивость * Расширенные варианты изображений: Реализована генерация трех вариантов: * thumbnail (JPEG, макс. 256×256), * optimized (WebP, макс. 1280×1280), * crop (точный квадрат 128×128 по центру). * Паттерн Outbox: Введена таблица outbox в PostgreSQL. Запись метаданных вложения и постановка задачи в очередь происходят в рамках одной транзакции, что исключает потерю задач при падении между БД и брокером. Фоновый поток в API (outbox_publisher) гарантирует доставку сообщений * Многопоточность воркера: В воркере задействован ThreadPoolExecutor с настраиваемым параметром WORKER_CONCURRENCY для параллельной обработки задач * Отказоустойчивость и управление ошибками: * Backoff + Jitter: Экспоненциальная задержка с добавлением случайного шума при временных сетевых или ресурсных сбоях * DLQ: Выделенный стрим attachment_jobs_dlq для задач, исчерпавших все лимиты попыток * Replay: Реализован эндпоинт /api/v1/attachments/{id}/replay для ручного или автоматического перезапуска неудачных/упавших вложений * Защита от зависаний и очистка: * Периодический фоновый XAUTOCLAIM для перехвата "зависших" сообщений при падении воркеров * Жесткие лимиты времени выполнения задач с безопасным сбросом таймеров * Регулярная фоновая очистка устаревших файлов из staging/ в S3
Mari added 4 commits 2026-11-16 21:05:18 +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/Mari/mtusi2026lab5 main:Mari-main
git checkout Mari-main
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/mtusi2026lab5#78