forked from mtusi2026/mtusi2026lab5
Подготовить отчёт и материалы сдачи
This commit is contained in:
@@ -1,17 +1,16 @@
|
||||
## Лабораторная 5
|
||||
|
||||
Автор / группа: Горбанюк / БВТ2301.
|
||||
Целевая оценка: **5**, трек 2 — идемпотентность versioned pipeline.
|
||||
Целевая оценка: 5. Трек: 2 — идемпотентность versioned pipeline.
|
||||
|
||||
Сохранён обязательный API предыдущих работ; upload переведён на 202 queued. Добавлены persistent Valkey Streams, transactional outbox/relay, отдельный ограниченный worker, thumbnail/crop/WebP, retries/leases/failed/replay и безопасный retention GC. Версии v1/v2 и fencing проверены автоматическими отказами и дубликатами.
|
||||
Реализация и воспроизводимая последовательность запуска: [REPORT.md](../REPORT.md).
|
||||
Исходники приложения — src/, собственные проверки — student-tests/, результаты — evidence/.
|
||||
Сохранено 84 собственных проверочных случаев; условия и результаты конкретных запусков приведены в отчёте.
|
||||
|
||||
Запуск: `uv sync --locked`, `make bootstrap`, `make up`, `make check validate test PYTHON=.venv/bin/python`. Полная инструкция с test override, результатами и ограничениями — [REPORT.md](../REPORT.md), raw evidence в `evidence/`.
|
||||
Контракт, исходное задание и публичные тесты сохранены. Секреты создаются локально и не входят в Git.
|
||||
Ограничения и использованные первичные источники перечислены в REPORT.md.
|
||||
|
||||
Ограничения: один host и по одному state store, локальный HTTP, без backup/удалённого TLS; воспроизводимые сценарии не доказывают все возможные interleavings. Источники приведены в отчёте.
|
||||
|
||||
- [x] Минимум текущей/предыдущих работ сохранён с объявленными переходами.
|
||||
- [x] Контракт и публичные tests не ослаблены.
|
||||
- [x] make check/validate/test и собственные тесты выполнены, приложен вывод.
|
||||
- [x] Отказы уровня 4 и выбранный трек 5 воспроизведены.
|
||||
- [x] Secrets/private keys находятся вне Git, в evidence нет tokens.
|
||||
- [x] README задания сохранён, REPORT.md описывает именно эту реализацию.
|
||||
- [x] Реализован обязательный минимум и заявленный трек.
|
||||
- [x] Приведены команды запуска, проверок и безопасной остановки.
|
||||
- [x] Сохранены результаты проверок и ограничения выводов.
|
||||
- [x] Credentials и приватные ключи находятся вне репозитория.
|
||||
|
||||
@@ -1,8 +1,9 @@
|
||||
# Лабораторная 5 — очереди и обработка изображений
|
||||
|
||||
|
||||
**Горбанюк, БВТ2301. Целевая оценка: 5, трек 2 — идемпотентность versioned pipeline с внедрением отказов.**
|
||||
|
||||
Работа подготовлена локально, без fork/push/МР. Ветка `solution/bvt2301-gorbanyuk`, проверенная версия — тег `lab5-verified`. Будущее название МР: **«ЛР 5 — БВТ2301 — Горбанюк — на 5»**. README задания, COURSE, CONTRIBUTING, контракты и публичные тесты сохранены.
|
||||
Решение подготовлено для отправки в форк исходного проекта и оформления МР преподавателю. Ветка `solution/bvt2301-gorbanyuk`, проверенная версия — тег `lab5-verified`. Будущее название МР: **«ЛР 5 — БВТ2301 — Горбанюк — на 5»**. README задания, COURSE, CONTRIBUTING, контракты и публичные тесты сохранены.
|
||||
|
||||
## Запуск из самостоятельного clone
|
||||
|
||||
@@ -95,7 +96,7 @@ docker compose --env-file .env exec worker python -m messenger.operator failed
|
||||
docker compose --env-file .env exec worker python -m messenger.operator replay <attachment-uuid>
|
||||
docker compose --env-file .env exec worker python -m messenger.operator new-version <attachment-uuid>
|
||||
docker compose --env-file .env run --rm reconciler
|
||||
docker compose --env-file .env run --rm reconciler --apply
|
||||
docker compose --env-file .env run --rm reconciler python -m messenger.cleanup --apply
|
||||
```
|
||||
|
||||
CLI доступен только оператору локального стенда, не публичному HTTP клиенту. Replay разрешён только для failed с retained source: CLI проверяет наличие объекта, сохраняет job_id/версию, начинает новый ограниченный цикл попыток с audit. Ready replay отклоняется. New-version реализует **v1→v2**: optimized WebP quality 82→76; другие преобразования одинаковы. Source key фиксирован в job; для reprocess готового attachment берётся опубликованный original.
|
||||
@@ -202,3 +203,7 @@ Python 3.14.7; FastAPI 0.143.3/Pydantic 2.14.1/Uvicorn 0.54.0; psycopg 3.3.6, Po
|
||||
Отдельный clone исходного commit `25e4ff9` с новыми secrets и пустыми volumes прошёл сборку, lint/format, offline/full contract checks, публичный smoke, все 84 собственных теста, полную матрицу из 10 сценариев и публичный persistence с той же сессией. Реальные StartedAt изменились у API, PG, S3, брокера, кэша, worker, relay и LB. SHA-256 каждого установленного Python-модуля совпал с исходниками на обеих API-репликах; OCI revision соответствует проверенному commit. Порты API не опубликованы. Raw второй матрицы — `evidence/clean-pipeline.json`.
|
||||
|
||||
После проверки временные контейнеры/volumes и clone удалены. Основной стенд остановлен, его данные сохранены. Финальный commit добавляет только отчёт/доказательства; исходники соответствуют проверенному `25e4ff9`. ЛР1–ЛР4 остались на прежних чистых версиях.
|
||||
|
||||
## Соответствие ревизий
|
||||
|
||||
После редактуры отчёта, шаблона и служебных метаданных сохранено соответствие прежних и текущих Git-ревизий: [revision-map.json](evidence/revision-map.json). Код приложения, миграции, зависимости, Dockerfile, конфигурация сервисов и исходные публичные проверки не изменены. Численные результаты и исторические image/source identifiers в evidence сохранены в исходном виде; их не следует трактовать как новый запуск измерений.
|
||||
|
||||
@@ -0,0 +1,14 @@
|
||||
{
|
||||
"scope": "Редактура документации и метаданных рисунка",
|
||||
"runtime_sources_unchanged": true,
|
||||
"migrations_dependencies_and_infrastructure_unchanged": true,
|
||||
"instructor_contract_and_public_tests_unchanged": true,
|
||||
"measurement_values_unchanged": true,
|
||||
"original_head": "dc11d065fb13d155c19612b95d9b42704da60f9f",
|
||||
"rewritten_history_head": "f1dbe61eafc3c7254d2351a160ed63099cb38678",
|
||||
"commit_map": {
|
||||
"25e4ff977ee932e507524d565e10c2cb9de8296e": "1f432c2e848c89ca538c02aa5d7c41332d62b0c7",
|
||||
"276dbdad8a34da4c5b57fbf1879ca169b581d75b": "276dbdad8a34da4c5b57fbf1879ca169b581d75b",
|
||||
"dc11d065fb13d155c19612b95d9b42704da60f9f": "f1dbe61eafc3c7254d2351a160ed63099cb38678"
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user