From e85aba5296e51862a27eb556c6f080d2bcb3b0e2 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=93=D0=BE=D1=80=D0=B1=D0=B0=D0=BD=D1=8E=D0=BA?= Date: Fri, 30 Oct 2026 17:31:18 +0300 Subject: [PATCH] =?UTF-8?q?=D0=9F=D0=BE=D0=B4=D0=B3=D0=BE=D1=82=D0=BE?= =?UTF-8?q?=D0=B2=D0=B8=D1=82=D1=8C=20=D0=BE=D1=82=D1=87=D1=91=D1=82=20?= =?UTF-8?q?=D0=B8=20=D0=BC=D0=B0=D1=82=D0=B5=D1=80=D0=B8=D0=B0=D0=BB=D1=8B?= =?UTF-8?q?=20=D1=81=D0=B4=D0=B0=D1=87=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .github/pull_request_template.md | 21 ++++++++++----------- REPORT.md | 9 +++++++-- evidence/revision-map.json | 14 ++++++++++++++ 3 files changed, 31 insertions(+), 13 deletions(-) create mode 100644 evidence/revision-map.json diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 5774e95..ce885a6 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -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 и приватные ключи находятся вне репозитория. diff --git a/REPORT.md b/REPORT.md index d08cbd5..bbdedb5 100644 --- a/REPORT.md +++ b/REPORT.md @@ -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 docker compose --env-file .env exec worker python -m messenger.operator new-version 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 сохранены в исходном виде; их не следует трактовать как новый запуск измерений. diff --git a/evidence/revision-map.json b/evidence/revision-map.json new file mode 100644 index 0000000..6438708 --- /dev/null +++ b/evidence/revision-map.json @@ -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" + } +}