Подготовить отчёт и материалы сдачи

This commit is contained in:
Горбанюк
2026-10-30 17:31:18 +03:00
parent f1dbe61eaf
commit e85aba5296
3 changed files with 31 additions and 13 deletions
+10 -11
View File
@@ -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 и приватные ключи находятся вне репозитория.
+7 -2
View File
@@ -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 сохранены в исходном виде; их не следует трактовать как новый запуск измерений.
+14
View File
@@ -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"
}
}