From f7e6707f4af4667d36078eabfcfa696b41f3b357 Mon Sep 17 00:00:00 2001 From: Alina Dykhanova Date: Fri, 6 Nov 2026 17:28:41 +0300 Subject: [PATCH] changed report --- .github/pull_request_template.md | 40 +++++++++++++++++++++----------- REPORT.md | 2 +- evidence/runtime-checks.json | 6 +++++ 3 files changed, 33 insertions(+), 15 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 1bec547..e78e208 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,18 +1,30 @@ ## Лабораторная 4 -Автор / группа: TODO -Целевая оценка (3/4/5): TODO -Трек 5, если заявлен: TODO +Автор / группа: Дыханова Алина, БВТ2301 +Целевая оценка (3/4/5): 5 +Трек 5, если заявлен: трек 2 — согласованность PostgreSQL/S3 -Что реализовано и что перенесено: TODO -Команды запуска из чистого clone: TODO -Результаты проверок и ссылка на REPORT.md: TODO -Ограничения / известные ошибки: TODO -Источники и использование ИИ: TODO +Что реализовано и что перенесено: Добавлены синхронная загрузка PNG/JPEG в приватный RustFS (S3), авторизованное скачивание, проверка типа/размера/числа пикселей и метаданные вложений в PostgreSQL с привязкой к сообщениям. Перенесены возможности lab3: регистрация и Argon2id-аутентификация, сессии, чаты, keyset-пагинация и идемпотентность сообщений. Добавлены Compose-инфраструктура с двумя API-репликами, HAProxy, persistent volumes, отдельные ограниченные S3 credentials и reconciler для orphan/missing объектов с dry-run, grace period и повторной проверкой перед удалением. -- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. -- [ ] Контракт и публичные тесты не ослаблены. -- [ ] make check и make test выполнены; приложен реальный вывод. -- [ ] Сценарии отказов/безопасности своего уровня воспроизведены. -- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. -- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. +Команды запуска из чистого clone: +```sh +python3 scripts/bootstrap.py +docker compose config --quiet +docker compose up -d --build --scale api=2 --wait --wait-timeout 180 +make check +make test +python3 tests/attachments_negative.py +``` + +Результаты проверок и ссылка на REPORT.md: `make check` — PASS; `make test` — `PASS: lab4 public API scenario; infrastructure and grading evidence remain separate.`; `python3 tests/attachments_negative.py` — PASS (PNG/JPEG, лимиты, повреждённое изображение, подмена MIME, чужой доступ и cross-chat). Также PASS: persistence, API failover, S3 outage, private bucket, 10-way upload load и track 2 reconciliation experiment. Подробные методика, результаты и ограничения: [REPORT.md](../REPORT.md). Реальные результаты сохранены в `evidence/runtime-checks.json`, `evidence/upload-load.json`, `evidence/reconcile-experiment.json` и `evidence/reconcile-inventory.json`. + +Ограничения / известные ошибки: Нагрузочные результаты получены на локальном Docker Desktop; Docker stats опрашивался примерно раз в секунду, поэтому краткий пик памяти мог быть пропущен. Между PostgreSQL и S3 нет общей транзакции; обычные ошибки компенсируются удалением объекта, аварийные расхождения исправляет reconciler. UI и presigned upload не входят в обязательный контракт и не реализованы. + +Источники и использование ИИ: Задание и контракт этого репозитория (`readme.md`, `contracts/openapi.json`, `contracts/README.md`, тесты и карта курса); официальная документация используемых библиотек и RustFS. При разработке и проверке использовался Codex. + +- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. +- [x] Контракт и публичные тесты не ослаблены. +- [x] make check и make test выполнены; реальный вывод smoke приведён выше, результаты зафиксированы в evidence. +- [x] Сценарии отказов/безопасности своего уровня воспроизведены. +- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. +- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. diff --git a/REPORT.md b/REPORT.md index 24d3db4..927dd40 100644 --- a/REPORT.md +++ b/REPORT.md @@ -87,4 +87,4 @@ S3 и PostgreSQL не образуют общую транзакцию. При ## Ограничения и следующие шаги -Работа подтверждена на локальном учебном стенде, но не является production deployment. Reconciler не восстанавливает утраченные bytes; он сохраняет metadata missing объекта для диагностики. Полный обход текущего bucket (424 metadata и 424 objects) занял 0,1364 с; стоимость на больших bucket надо измерять отдельно. Распределённой транзакции между S3 и PostgreSQL нет. Полный пик памяти может быть выше sampled Docker stats. Полную OpenAPI-валидацию (`make validate`) не удалось запустить: `openapi-spec-validator` отсутствовал локально, а установка из package index была недоступна из этой среды; `make check` и все runtime smoke/negative проверки выполнены. Не реализованы UI, thumbnail/background worker и presigned flow: они не входят в обязательный контракт lab4. +Работа подтверждена на локальном учебном стенде, но не является production deployment. Reconciler не восстанавливает утраченные bytes; он сохраняет metadata missing объекта для диагностики. Полный обход текущего bucket (424 metadata и 424 objects) занял 0,1364 с; стоимость на больших bucket надо измерять отдельно. Распределённой транзакции между S3 и PostgreSQL нет. Полный пик памяти может быть выше sampled Docker stats. Полная OpenAPI 3.1 и JSON Schema валидация (`make validate PYTHON=.venv/bin/python`) выполнена успешно. Не реализованы UI, thumbnail/background worker и presigned flow: они не входят в обязательный контракт lab4. diff --git a/evidence/runtime-checks.json b/evidence/runtime-checks.json index e6298a5..371ea09 100644 --- a/evidence/runtime-checks.json +++ b/evidence/runtime-checks.json @@ -42,6 +42,12 @@ "name": "make check", "result": "PASS" }, + { + "name": "make validate", + "result": "PASS", + "command": "make validate PYTHON=.venv/bin/python", + "observed": "PASS: full OpenAPI 3.1 and JSON Schema validation; application NOT tested." + }, { "name": "public lab4 smoke", "result": "PASS",