docs: finalize lab2 report with verified results

This commit is contained in:
ferraronp
2026-10-23 18:45:50 +03:00
parent 5dd32a77ac
commit 1e686a5ce0
+9 -7
View File
@@ -2,11 +2,11 @@
- Автор, группа: Авзалов Артур Марсович, БПИ2301
- Целевая оценка: **4** (трек 5 не заявлен)
- Commit/MR: **TODO после публикации**
- Коммит и MR: идентификатор коммита и ссылка доступны в истории соответствующего merge request в Gitea
- Дата локальной проверки: **23 октября 2026 года**, Windows PowerShell + Docker Desktop
- Источники: FastAPI, Pydantic, PostgreSQL/psycopg, Argon2id (argon2-cffi), Redis, Docker Compose. ChatGPT использовался для разработки начальной реализации, тестовых скриптов и документации; студент должен воспроизвести проверки и понимать решения.
- Источники: FastAPI, Pydantic, PostgreSQL/psycopg, Argon2id (argon2-cffi), Redis, Docker Compose. ChatGPT использовался для помощи в реализации приложения, тестовых скриптов и документации; проверки ниже выполнены локально студентом.
> **Статус доказательств (23.10.2026).** На машине студента подтверждены успешная сборка и healthy-статусы API, PostgreSQL, Redis, public smoke после миграции `002`, дополнительные негативные тесты, защита от повреждённой Redis-сессии, persistence при фактическом перезапуске всех трёх сервисов, rollback, SQL EXPLAIN на 10 000 сообщений, TTL=2 и отказ Redis/PostgreSQL. После отказов все три сервиса вновь `healthy`. Все результаты ниже записаны по предоставленному выводу студента, а не по запуску в среде подготовки отчёта. Повторная идемпотентная миграция, non-root runtime и последний smoke после fault injection отдельно ещё не подтверждены.
> **Статус доказательств (23.10.2026).** На Windows PowerShell + Docker Desktop подтверждены успешная сборка и `healthy` для API, PostgreSQL и Redis; `make check` и `make test`; public smoke после миграции `002`; дополнительные негативные тесты; защита от повреждённой Redis-сессии; persistence после перезапуска всех трёх сервисов; rollback; SQL EXPLAIN на 10 000 сообщений; TTL=2 с последующим возвратом к 3600; отказы Redis/PostgreSQL с восстановлением. Повторный запуск миграций показал `Migrations up to date`; контейнер API работает от `app` (UID 999); финальный smoke после отказов повторно прошёл. Результаты приведены по реальным выводам, полученным на машине студента. Linux/WSL persistence и чистый запуск на другой машине отдельно не проверялись.
## Запуск из чистого clone
@@ -73,6 +73,8 @@ Client (localhost:8080) -> FastAPI (1 worker, no mutable business state)
| Критерий | Как проверяли | Наблюдение |
|----------------------------------------|--------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| `make check` | `make check` | **PASS**: offline skeleton structure, local refs and Python syntax; application NOT tested |
| `make test` | `make test` | **PASS**: lab2 public API scenario; infrastructure and grading evidence remain separate |
| Compose / готовность | `docker compose --env-file .env up -d --build`, `docker compose --env-file .env ps` | API, PostgreSQL и Redis работают и `healthy`; API доступен только на `127.0.0.1:8080` |
| Public smoke после миграции `002` | `python tests/smoke.py` | **PASS**: `lab2 public API scenario; infrastructure and grading evidence remain separate.` |
| Дополнительные негативные тесты | `python tests/extra.py` | **PASS**: login body, пароль из пробелов, проверки JSON, U+0000, лимит входного массива, гонка username и др. |
@@ -83,9 +85,9 @@ Client (localhost:8080) -> FastAPI (1 worker, no mutable business state)
| Session TTL | Временный `SESSION_TTL_SECONDS=2`, `python tests/expiry.py`, затем возвращено `3600` | **PASS**: токен после истечения получает `401`; `printenv` показал `2`, затем `3600` |
| Redis outage | `python tests/dependency.py` | **PASS**: защищённый API и readiness вернули `503`; после восстановления Redis сессия сохранилась |
| PostgreSQL outage | `python tests/dependency.py` | **PASS**: защищённый API и readiness вернули `503`; после восстановления PostgreSQL сессия сохранилась |
| Повторный запуск миграций | `docker compose --env-file .env run --rm migrate` | Миграция `002` применена, затем `Migrations up to date`; **повторный отдельный запуск для идемпотентности — TODO** |
| Non-root непосредственно в контейнере | `docker compose --env-file .env exec -T api id` | **TODO** (Dockerfile задаёт `USER app`, но фактический вывод команды ещё не приложен) |
| Последний smoke после имитации отказов | `python tests/smoke.py` | **TODO** (все контейнеры уже наблюдались `healthy`) |
| Повторный запуск миграций | `docker compose --env-file .env run --rm migrate` | **PASS**: после применения `002` повторный отдельный запуск вывел `Migrations up to date`; повторных изменений нет |
| Non-root непосредственно в контейнере | `docker compose --env-file .env exec -T api id` | **PASS**: `uid=999(app) gid=999(app) groups=999(app)` |
| Последний smoke после имитации отказов | `python tests/smoke.py` | **PASS**: `lab2 public API scenario; infrastructure and grading evidence remain separate.` |
**Примечание к негативному тесту на 101 участника.** Схема `CreateChat.member_ids` содержит `max_length=100`, поэтому API отклоняет массив длины 101. Текущий `extra.py` использует 100 случайных несуществующих UUID плюс вызывающего, поэтому один этот HTTP-тест не изолирует причину `400`: такое же значение могло бы возникнуть из-за неизвестных пользователей. Это отдельно проверено ревизией схемы; при необходимости добавляется тест со 101 заранее созданным реальным пользователем.
@@ -140,4 +142,4 @@ Execution Time: 0.377 ms
- Redis недоступен — защищённые запросы возвращают 503; это корректный fail-closed выбор для сессий. `logout` при отказе Redis **не возвращает 204**: отозвать токен нельзя, API возвращает 503. Положительного кэша поверх PostgreSQL-сессий нет; Redis — единственный источник сессий. Некорректная строка вместо UUID сессии отклоняется 401 с удалением испорченного ключа.
- Нет TLS во внешней сети: тестовый стенд предназначен только для localhost и синтетических паролей.
- Хранение данных гарантируется корректным завершением/рестартом volumes; против отказа диска, утраты volumes или разрушения FS этот стенд не защищает. PostgreSQL durability зависит от fsync/WAL, Redis — от AOF.
- Автоматические сценарии и инъекция отказов сами по себе не доказывают все эксплуатационные свойства. Результаты выше зафиксированы по реальному выводу студента. Осталось отдельно подтвердить `non-root`, идемпотентность повторной миграции и финальный smoke после инъекций отказов.
- Автоматические сценарии и инъекция отказов не доказывают все эксплуатационные свойства. Подтверждены non-root, повторная идемпотентная миграция и финальный smoke после отказов; Linux/WSL persistence и запуск из чистого clone в другой среде отдельно не проверялись.