forked from mtusi2026/mtusi2026lab5
39 lines
3.3 KiB
Markdown
39 lines
3.3 KiB
Markdown
# Переход 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-контракт,
|
||
авторизация, доступ к чатам и идемпотентность сообщений продолжают работать.
|