Files
mtusi2026lab5/docs/ARCHITECTURE.md
T

3.3 KiB
Raw Blame History

Переход Lab4 → Lab5

Часть Lab4 Lab5
Приём файла S3 PUT и 201 ready Приватный staging, метаданные, job и outbox, затем 202 queued
Преобразования Нет Worker: JPEG thumbnail, JPEG crop, WebP optimized
Брокер Нет RabbitMQ, durable quorum queue, persistent messages, publisher confirms
Надёжность публикации Не требуется OutboxDispatcher читает PostgreSQL и публикует с подтверждением
Повторная доставка Только отправка сообщений Дополнительно job_id, состояние, advisory lock, lease, детерминированные S3 keys
Ошибки Синхронный HTTP Ограниченные попытки, backoff/jitter, failed registry и явный replay
Интерфейс Превью готового оригинала Опрос queued/processing, затем прежняя галерея и скачивание

Процессы

Один образ C# запускается в нескольких ролях. API обрабатывает HTTP. Worker запускается с --worker, dispatcher с --dispatcher. Это отдельные контейнеры и процессы. Миграции и создание bucket выполняются одноразовыми сервисами. Worker запускает короткоживущий дочерний процесс --render-image для SkiaSharp: его можно принудительно остановить при превышении времени декодирования.

PostgreSQL хранит метаданные, состояния, аренду работы, outbox и журнал событий. SeaweedFS хранит staging, оригинал и варианты. Redis сохраняет прежнюю роль кэша сессий. RabbitMQ переносит только идентификаторы и служебные поля.

Файлы

  • Services/AttachmentService.cs: приём, проверка, лимит очереди, staging и транзакция приёма.
  • Data/Migrations/005_pipeline.sql: jobs, outbox, журнал, новые статусы и варианты.
  • Pipeline/OutboxDispatcher.cs: надёжная публикация в RabbitMQ.
  • Pipeline/PipelineWorker.cs: получение, ограниченная обработка, запись S3 и результата.
  • Pipeline/ImageRenderer.cs: EXIF orientation, resize, crop, JPEG/WebP.
  • Pipeline/JobStore.cs: захват работы, lease, повтор, восстановление и replay.
  • Pipeline/PipelineMaintenance.cs: очистка staging с проверкой состояния.
  • Pipeline/FaultInjection.cs: выключенные по умолчанию локальные точки остановки для тестов.
  • wwwroot/attachments.js: ожидание обработки и просмотр изображения.

Program.cs выбирает режим процесса и подключает зависимости. HTTP-контракт, авторизация, доступ к чатам и идемпотентность сообщений продолжают работать.