Files
mtusi2026lab5/docs/ARCHITECTURE.md
T

39 lines
3.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Переход 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-контракт,
авторизация, доступ к чатам и идемпотентность сообщений продолжают работать.