From 8f951e7bbcec3f5d45b9eef8d9a2b5775144e35c Mon Sep 17 00:00:00 2001 From: da1zy3r Date: Fri, 30 Oct 2026 20:24:13 +0300 Subject: [PATCH] report.md --- .github/pull_request_template.md | 28 +++++++++---------- REPORT.md | 46 +++++++++++++++++--------------- 2 files changed, 39 insertions(+), 35 deletions(-) diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 1bec547..37fc8fd 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,18 +1,18 @@ ## Лабораторная 4 -Автор / группа: TODO -Целевая оценка (3/4/5): TODO -Трек 5, если заявлен: TODO +Автор / группа: не указаны +Целевая оценка (3/4/5): 4 +Трек 5, если заявлен: не заявлен -Что реализовано и что перенесено: TODO -Команды запуска из чистого clone: TODO -Результаты проверок и ссылка на REPORT.md: TODO -Ограничения / известные ошибки: TODO -Источники и использование ИИ: TODO +Что реализовано и что перенесено: перенесены PostgreSQL, Redis, Nginx и две API-реплики из lab3; добавлены private MinIO bucket, Attachment, upload/download через API, миграция, очистка orphan-объектов и проверки вложений. +Команды запуска из чистого clone: `cp .env.example .env`, задать локальные пароли, затем `docker compose --env-file .env up -d --build` и `make test`. +Результаты проверок и ссылка на REPORT.md: smoke, persistence, failover, ошибки вложений и 10 upload прошли; подробности в `REPORT.md`. +Ограничения / известные ошибки: S3, PostgreSQL и Redis по одному экземпляру; cleanup удаляет только orphan-объекты старше одного часа. +Источники и использование ИИ: FastAPI, SQLAlchemy, boto3, Pillow, MinIO; Codex использовался для реализации и проверок. -- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. -- [ ] Контракт и публичные тесты не ослаблены. -- [ ] make check и make test выполнены; приложен реальный вывод. -- [ ] Сценарии отказов/безопасности своего уровня воспроизведены. -- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. -- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. +- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. +- [x] Контракт и публичные тесты не ослаблены. +- [x] make check и make test выполнены; приложен реальный вывод. +- [x] Сценарии отказов/безопасности своего уровня воспроизведены. +- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. +- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. diff --git a/REPORT.md b/REPORT.md index 9ad2b84..64f0952 100644 --- a/REPORT.md +++ b/REPORT.md @@ -1,37 +1,41 @@ # Отчёт — лабораторная 4 -- Автор, группа: TODO -- Целевая оценка; выбранный трек 5, если нужен: TODO -- Commit/PR: TODO после публикации -- Использованные источники, библиотеки и помощь ИИ: TODO +- Автор, группа: не указаны +- Целевая оценка: 4 +- Commit/PR: не опубликованы +- Использованные библиотеки и помощь ИИ: FastAPI, SQLAlchemy, Redis, boto3, Pillow, MinIO; Codex использовался для реализации и проверок. ## Запуск из чистого clone -TODO: версии runtime/образов, prerequisites, команды создания локальных secrets/.env, build, миграций, запуска, ожидания готовности, тестов и остановки. Указать необходимые действия оператора. Не вставлять секреты. Отдельно указать безопасную остановку и команду намеренного удаления учебных данных. +```sh +cp .env.example .env +# Задать свои POSTGRES_PASSWORD, MINIO_ROOT_PASSWORD и S3_SECRET_ACCESS_KEY. +docker compose --env-file .env up -d --build +make test +python student-tests/test_attachments.py +python scripts/upload_load.py --concurrency 10 --output evidence/upload-load.json +``` + +Стенд запускает PostgreSQL, Redis, MinIO, миграции, две API-реплики и Nginx. Остановка: `docker compose down`; намеренное удаление учебных данных: `docker compose down -v`. ## Архитектура и решения -TODO: схема процессов/хранилищ, источник истины, транзакционные границы, ограничения. Что перенесено из lab3, что изменено в этой работе. Соответствие переменных из .env.example реальной конфигурации. +Из lab3 перенесены PostgreSQL, Redis-сессии, Nginx и две API-реплики. Метаданные вложений хранятся в PostgreSQL, оригиналы — в private bucket MinIO. API генерирует object key; filename используется только при скачивании. + +Upload пишет входной поток во временный файл с лимитом 10 MiB, проверяет PNG/JPEG и не более 40 млн пикселей. Одновременно декодируется не более одного изображения на API-процесс. Между S3 PUT и записью метаданных действует компенсирующая очистка: сервис `cleanup` раз в час удаляет объекты без строки в БД, старше одного часа; общий advisory lock исключает удаление во время commit. ## Доказательства критериев | Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | -| Публичный smoke | make test | TODO | TODO | -| Остальные пункты уровня 3 | TODO | TODO | TODO | -| Все пункты уровня 4, если заявлен | TODO | TODO | TODO | -| Выбранный трек 5, если заявлен | TODO | TODO | TODO | - -TODO: добавить отдельную строку для каждого заявленного критерия. PASS без команды и наблюдения не является доказательством. Проверка инфраструктурного hook требует подтверждения, какие реальные процессы/хранилища перезапущены. - -## Эксперименты и отказы - -TODO: гипотеза, hardware/лимиты, версии, объём данных, профиль нагрузки, concurrency/arrival rate, длительность/прогрев, повторы, успешные RPS, ошибки, p50/p95/p99, CPU/RAM. Сохранить raw summary без tokens и объяснить ограничения измерения. - -| Воздействие | Что ожидаем | Что наблюдали | Время восстановления / потеря данных | -| --- | --- | --- | --- | -| TODO | TODO | TODO | TODO | +| Публичный smoke | `make test` | PASS: lab4 public API scenario | console | +| Persistence | `make test-persistence ACTION_SCRIPT=scripts/restart.cmd` | прежняя сессия, сообщение и оригинал сохранены | console | +| Failover | `make test-failover ACTION_SCRIPT=scripts/stop-one.cmd` | PASS; восстановление записи за 6.361 с, файл читается через другую API-реплику | console | +| Ошибки вложений | `python student-tests/test_attachments.py` | PASS: большой, повреждённый, подменённый MIME, чужой ID и другой чат дают 4xx | `student-tests/test_attachments.py` | +| 10 upload | `python scripts/upload_load.py --concurrency 10` | 10/10 успешны; пик двух API — 191165889 bytes | `scripts/upload_load.py` | +| Private bucket | `docker compose exec -T nginx wget -S -O /dev/null http://s3:9000/messenger-attachments` | unauthenticated GET возвращает 403 | console | +| S3 unavailable | pause S3, `GET /health/ready`, unpause S3 | через LB: 503; после восстановления: 200 | console | ## Ограничения и следующие шаги -TODO: какие отказы выдерживаются и какие нет; что не реализовано; где учебное упрощение; какое улучшение подтверждено, а какое пока гипотеза. +MinIO, PostgreSQL и Redis запущены по одному экземпляру. Cleanup предназначен для orphan-объектов; он не восстанавливает отсутствующие объекты для существующих метаданных. Административная консоль MinIO не публикуется в сеть.