diff --git a/.github/workflows/application.yml b/.github/workflows/application.yml index dbe0659..b9ba4fc 100644 --- a/.github/workflows/application.yml +++ b/.github/workflows/application.yml @@ -42,6 +42,7 @@ jobs: with: version: v2.12.2 - run: make coverage + - run: make test-faults - uses: actions/upload-artifact@v4 if: always() with: diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index d339ec6..e0aef64 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -33,6 +33,10 @@ Memory store и локальный limiter сохранены для незав Фактические проверки и эксплуатационные ограничения, включая process-local cursor key, приведены в [REPORT](REPORT.md). Указанные Go conventions проверяются formatter/lint и AST-тестом направления импортов; они не заменяют анализ ответственности компонентов. +## Классификация ошибок + +PostgreSQL нормализует сетевые ошибки, разрыв соединения, deadline и SQLSTATE недоступности в `store.ErrUnavailable`, сохраняя исходную причину для `errors.Is`. `service.ErrUnavailable` — alias этой общей категории интерфейса хранилища; controller не импортирует драйвер или store. Это сохраняет классификацию и на пути проверки сессии, и в бизнес-операциях. HTTP-слой возвращает фиксированный 503/unavailable без деталей. Неизвестные ошибки SQL остаются 500; ограничения уникальности и отсутствие записи сохраняют прежнее отображение. + ## Развёртывание [Helm chart](charts/messenger) — единственный источник ресурсов стенда. Values задают образ, API-конфигурацию, ресурсы и число шардов. Изменение конфигурации меняет checksum pod template и вызывает rollout API. Namespace изолирует лабораторную; имена StatefulSet и PVC стабильны. Credentials создаются отдельно и передаются по именам Secret, без записи паролей в Helm values. diff --git a/Makefile b/Makefile index 27ea44b..50bed46 100644 --- a/Makefile +++ b/Makefile @@ -76,3 +76,7 @@ ready: @for attempt in $$(seq 1 60); do curl --fail --silent --max-time 1 "$(BASE_URL)/health/ready" >/dev/null && exit 0; sleep 1; done; echo 'API readiness timeout' >&2; exit 1 reshard: SHARDS="$(SHARDS)" scripts/scale-shards.sh + +.PHONY: test-faults +test-faults: + scripts/test-faults.sh diff --git a/REPORT.md b/REPORT.md index 6d4f8f3..78dfe19 100644 --- a/REPORT.md +++ b/REPORT.md @@ -54,7 +54,7 @@ Persistence перезапускает API, PostgreSQL и все Valkey, зат Go-проверки: `make vet`, `make lint`, `make test-student`. Полная проверка `make coverage` требует `DATABASE_URL`, `VALKEY_SHARDS`, `TEST_DATABASE_URL`, `TEST_VALKEY_ADDRESS`, указывающих на **изолированные тестовые** зависимости. Она запускает race, интеграционные тесты, настоящий сервер, smoke и SIGTERM; shell/awk объединяют профили и проверяют ≥90% statements отдельно в каждом исполняемом Go-файле. CI создаёт зависимости автоматически. Без TEST-переменных интеграционные тесты пропускаются. -Проверки после перехода на Helm: [adoption и upgrade](evidence/helm-deployment.txt), [smoke](evidence/helm-smoke.txt), [persistence](evidence/helm-persistence.txt), [coverage](evidence/helm-coverage-per-file.json). Более ранние измерения и их область действия перечислены в [evidence/README](evidence/README.md). Удалённый CI не запускался; Git push и PR не выполнялись. +Проверки после перехода на Helm: [adoption и upgrade](evidence/helm-deployment.txt), [smoke](evidence/helm-smoke.txt), [persistence](evidence/helm-persistence.txt), [coverage](evidence/helm-coverage-per-file.json). Более ранние измерения и их область действия перечислены в [evidence/README](evidence/README.md). Удалённый CI не подтверждён; актуальная публикация и PR указаны ниже. ## SQL-эксперимент @@ -76,8 +76,24 @@ make research - Истёкшие сессии отвергаются запросом к БД, но фоновая очистка строк ещё не реализована. - PVC на `microk8s-hostpath` обеспечивает сохранность при рестарте pod; он не заменяет резервную копию. -Версии Go и зависимостей закреплены в `go.mod`, `go.sum` и Dockerfile. Источники решений: [ADR-0001](docs/decisions/0001-postgres-sessions-shards.md), [ADR-0002](docs/decisions/0002-helm.md). При разработке использован Codex. ФИО, группа и URL PR не указаны. +Версии Go и зависимостей закреплены в `go.mod`, `go.sum` и Dockerfile. Источники решений: [ADR-0001](docs/decisions/0001-postgres-sessions-shards.md), [ADR-0002](docs/decisions/0002-helm.md). При разработке использован Codex. Автор: Агапов Владислав, БПИ2303; PR №52 указан ниже. ## Репозиторий Gitea Решение перенесено 2026-10-15 в `ssh://git@gitea.privcloud.tech:2222/vlad_marlo/mtusi2026lab2.git`. Go-модуль и imports обновлены под новый адрес. [Проверки переноса](evidence/gitea-transfer-tests.txt) относятся к новой рабочей копии; прежние измерения и опубликованный образ относятся к снимку от 2026-10-07. Повторное развёртывание, новый image build и Git push при переносе не выполнялись. + +## Исправление классификации отказов — 2026-10-16 + +В PostgreSQL-адаптере недоступность соединения и timeout выделены в отдельную категорию. HTTP возвращает `503 unavailable` с безопасным сообщением, включая отказ на этапе проверки сессии. Неожиданные ошибки SQL сохраняют `500 internal_error`. + +```sh +make test-faults +``` + +Сценарий воспроизводится из отдельного clone с Docker, curl, jq, rg, OpenSSL и shasum. Он создаёт собственные PostgreSQL 17.6 и Valkey 8.1.3, собирает API из рабочего дерева, проверяет реальные `stop` и `pause` каждого backend и удаляет временные ресурсы. Ни существующие Docker-контейнеры, ни dev-кластер не используются. В начале вывода сохраняются базовая Git-ревизия и SHA-256 исходников: проверенный снимок включает ещё не закоммиченные изменения. + +[Результат](evidence/fault-regression.txt): все четыре сценария прошли. История с действующей сессией возвращала 503 за 0.002–0.508 с; зависание ограничено timeout 500 мс и внешним HTTP deadline 3 с. Проверены отсутствие анонимного доступа и обхода через X-User-Id/повреждённый/неизвестный Bearer, безопасный error envelope, liveness/readiness. После каждого восстановления исходная сессия читает то же сообщение без повторного входа. При отказе Valkey admission отклоняет запрос до аутентификации, поэтому анонимный запрос тоже получает 503, а не данные. + +Свежие [race/integration/coverage](evidence/fault-coverage.txt), [покрытие по файлам](evidence/fault-coverage-per-file.json), [lint](evidence/fault-lint.txt), [vet](evidence/fault-vet.txt) и [contract check](evidence/fault-contract.txt) прошли. Все 57 исполняемых Go-файлов имеют покрытие ≥90%. Fault-сценарий добавлен в application CI; удалённый runner этим локальным прогоном не проверяется. Кластерный образ в рамках этого исправления не обновлялся. + +Работа сдаётся в [PR №52](https://gitea.privcloud.tech/mtusi2026/mtusi2026lab2/pulls/52), ветка `main` → `master`, автор Агапов Владислав, БПИ2303. diff --git a/docs/PLAN.md b/docs/PLAN.md index 1d9ff0d..66992c4 100644 --- a/docs/PLAN.md +++ b/docs/PLAN.md @@ -14,8 +14,9 @@ | L2-T10 | L2-REQ-09,11,12 | Helm chart, values, adoption без потери данных, upgrade, reshard 3→2→3; [проверка](../evidence/helm-deployment.txt) | Выполнено в dev | | L2-T11 | L2-REQ-08,10,12 | [Покрытие shell/awk](../evidence/helm-coverage-per-file.json), [SQL-эксперимент](../evidence/sql-research-helm.txt), сокращённый REPORT; собственные Python-скрипты удалены | Выполнено | -Обязательные contracts и публичные tests сохранены. Lab1 и соседние реализации не изменялись. Контейнерный образ опубликован; Git push/PR и защита не выполнены; ФИО, группа и URL PR неизвестны. Код, локальные измерения, кластерная проверка и принятие работы учитываются отдельно. +Обязательные contracts и публичные tests сохранены. Lab1 и соседние реализации не изменялись. Контейнерный образ опубликован; решение находится в main и PR №52 (Агапов Владислав, БПИ2303). Результат защиты не зафиксирован. Код, локальные измерения, кластерная проверка и принятие работы учитываются отдельно. | Задача | Требования | Результат и проверка | Статус | | --- | --- | --- | --- | -| L2-T12 | L2-REQ-13 | Перенесены 182 файла; module/imports обновлены; build, vet, race, lint, chart-check и неизменность публичных материалов проверены; [результаты](../evidence/gitea-transfer-tests.txt) | Выполнено локально; без push и redeploy | +| L2-T12 | L2-REQ-13 | Перенесены 182 файла; module/imports обновлены; build, vet, race, lint, chart-check и неизменность публичных материалов проверены; [результаты](../evidence/gitea-transfer-tests.txt) | Перенос проверен; main опубликован, PR №52 открыт; без redeploy | +| L2-T13 | L2-REQ-03,04 | Классификация PostgreSQL, unit-регрессии, make test-faults: stop/pause обоих backend, запрет анонимного доступа, recovery; evidence/fault-regression.txt; race/coverage ≥90% по каждому файлу | Выполнено локально | diff --git a/docs/SPEC.md b/docs/SPEC.md index 7353029..137c622 100644 --- a/docs/SPEC.md +++ b/docs/SPEC.md @@ -40,3 +40,7 @@ L2-REQ-12: единственный источник Kubernetes-ресурсов ## Перенос в Gitea L2-REQ-13: решение размещается в репозитории `ssh://git@gitea.privcloud.tech:2222/vlad_marlo/mtusi2026lab2.git`. Имя Go-модуля и внутренние imports соответствуют новому хосту. Задание, contracts и публичные tests нового репозитория сохраняются. Секреты, runtime-данные и история исходного `.git` не переносятся. Проверки: сборка, unit/race, vet, chart lint и неизменность публичных материалов. Измерения от 2026-10-07 остаются историческими и не подменяют проверки переноса. + +## Классификация отказов зависимостей + +Уточнение L2-REQ-04: потеря соединения, timeout и недоступность PostgreSQL возвращают HTTP 503 / `unavailable`, включая проверку действительной сессии. Ошибки SQL/неизвестные ошибки сохраняют безопасный 500. Воспроизводимый `make test-faults` создаёт изолированные Docker-зависимости, останавливает PostgreSQL и Valkey по очереди, проверяет историю с прежним токеном, отсутствие анонимного доступа, readiness/liveness и восстановление. Пользовательский кластер и данные не затрагиваются. diff --git a/evidence/README.md b/evidence/README.md index 59b7817..1b8db6e 100644 --- a/evidence/README.md +++ b/evidence/README.md @@ -53,3 +53,5 @@ SQL-результаты содержат snapshot исходников на м Репозиторий: `ssh://git@gitea.privcloud.tech:2222/vlad_marlo/mtusi2026lab2.git`. При переносе обновлены имя Go-модуля, imports и local-prefixes formatter. Исходный skeleton Gitea: `65003b6`. Публичные задания, tests и contracts сохранены без изменений. Свежие проверки переноса находятся в `gitea-transfer-tests.txt`: сборка, vet и race-тесты. Интеграционные тесты PostgreSQL/Valkey требуют отдельного окружения и в этом запуске пропускаются; развёртывание в Kubernetes не выполнялось. Остальные файлы evidence содержат прежние измерения от 2026-10-07 с исходными hash и именем модуля. Они не являются измерениями новой ревизии. + +Проверки исправления от 2026-10-16: `fault-regression.txt` — изолированный реальный stop/pause PostgreSQL и Valkey через HTTP, базовая ревизия и SHA-256 проверенного рабочего дерева; `fault-coverage.txt` / `fault-coverage-per-file.json` — race/integration и покрытие каждого файла; `fault-lint.txt`, `fault-vet.txt`, `fault-contract.txt` — статические проверки. Старые измерения не переписываются. diff --git a/evidence/fault-contract.txt b/evidence/fault-contract.txt new file mode 100644 index 0000000..9a55330 --- /dev/null +++ b/evidence/fault-contract.txt @@ -0,0 +1,2 @@ +python3 scripts/check_contract.py +PASS: offline skeleton structure, local refs and Python syntax; application NOT tested. diff --git a/evidence/fault-coverage-per-file.json b/evidence/fault-coverage-per-file.json new file mode 100644 index 0000000..30bd5e1 --- /dev/null +++ b/evidence/fault-coverage-per-file.json @@ -0,0 +1,73 @@ +{"threshold_per_file":90,"files":[ +{"file":"internal/cursor/codec.go","statements":33,"covered":31,"percent":93.93939394,"sha256":"a5bc7aac6d1764929fb11365c9f8b6a45ff65e47b3a317a7ccd9ec6dd1b2713a"}, +{"file":"internal/valkey/client.go","statements":35,"covered":34,"percent":97.14285714,"sha256":"f50de7f2ac53fae218eb7c580436d5b726de5abe3a9cc6f9696f28b52ad6ec07"}, +{"file":"internal/controller/http/fiber/handlers.go","statements":37,"covered":36,"percent":97.29729730,"sha256":"b5473469ee1bd63610bc7b1bc167ecf01633dc5f06dae64b7816e8123ee0733e"}, +{"file":"internal/service/production/members.go","statements":19,"covered":19,"percent":100.00000000,"sha256":"652833512d878ee000da0cdb278f25245a3ce79bf2c1638d62621126d881be25"}, +{"file":"internal/service/production/creation.go","statements":12,"covered":12,"percent":100.00000000,"sha256":"13f76cd64c9aec923504e077f1db74ff66a96fb72523dd5e1a2cc29efd0682d5"}, +{"file":"internal/controller/interface.go","statements":0,"covered":0,"percent":null,"sha256":"24b6b06d6fab919cd2130697b44fd0d358265184dca0ca8362e0b4fcc2ae5a68"}, +{"file":"internal/model/http/models.go","statements":0,"covered":0,"percent":null,"sha256":"8c183b065bc3ab4cad20570eab79f334ca75a3309186fdf832fb1aa598894465"}, +{"file":"internal/config/config.go","statements":17,"covered":17,"percent":100.00000000,"sha256":"8cb675a0bef8b1645071e4cb85b79a467620e99b375db5d8d3e16a54b4c5b5fa"}, +{"file":"internal/service/production/messages.go","statements":18,"covered":18,"percent":100.00000000,"sha256":"99a25471826d78b0655be2e4ccfcc1fd0b79ba15454f0fd66a5cf06dcdba9e9c"}, +{"file":"internal/service/production/service.go","statements":10,"covered":10,"percent":100.00000000,"sha256":"6592e1bd6979036609d052c85b4f73484a0148a5592a3ef415557c1779104d60"}, +{"file":"internal/service/errors.go","statements":0,"covered":0,"percent":null,"sha256":"9dd4d2998e37c48e104298ae7bc9f311f193ff5212608f9c579cd569941d5054"}, +{"file":"cmd/server/logger.go","statements":10,"covered":9,"percent":90.00000000,"sha256":"fd0801324362cb74dd1b9d78d9dcc001d9e107e4a329cb48b0390dd33fa641cb"}, +{"file":"internal/model/dto/session.go","statements":0,"covered":0,"percent":null,"sha256":"896a694b0c217240343077d4287f4a6e447338c38571abbebcb3d16a519137fb"}, +{"file":"internal/service/production/pagination.go","statements":21,"covered":21,"percent":100.00000000,"sha256":"ef3da5e89d7a1f8798d006760db07409df185b9315a16cdebec6bb22afedbccf"}, +{"file":"internal/service/production/validation.go","statements":13,"covered":13,"percent":100.00000000,"sha256":"4adb55d349befbc2a1e79b40c5547e22f558cbe10f9866b8fe9ddfbebabb6699"}, +{"file":"cmd/server/healthcheck.go","statements":19,"covered":18,"percent":94.73684211,"sha256":"29e339c55781d61de8e30fa07b9b21927d9553f7d3f6a63f43c49e86977b2503"}, +{"file":"internal/store/memory/capacity.go","statements":7,"covered":7,"percent":100.00000000,"sha256":"70d7def3fab2ab41f71b6b88dea8bd4181d4ea619f17daa795c7097ba056bd7c"}, +{"file":"internal/service/cache.go","statements":0,"covered":0,"percent":null,"sha256":"e43e37991f18f27738877538e9c8304d06e18fa5cd8c773273d3d70185c6c5eb"}, +{"file":"internal/service/production/pages.go","statements":17,"covered":16,"percent":94.11764706,"sha256":"9d8c2d2ed63382586c5e0e405cd90e02e96cbbc05e1fa4e00e80821a7fdc031f"}, +{"file":"internal/config/environment.go","statements":14,"covered":14,"percent":100.00000000,"sha256":"027761b059b76898a84318ec1a8b43158d8bafd6e0b15b52efbe902b4d8c5ea3"}, +{"file":"internal/model/dto/models.go","statements":0,"covered":0,"percent":null,"sha256":"e2ecd732848d10f4471567c9603aa7359fcb1af7b2708ead477f4949f7a2fa4a"}, +{"file":"internal/valkey/cache.go","statements":19,"covered":18,"percent":94.73684211,"sha256":"cb8805b347358fe683baa2927ff00a454a6fd928c7899170aa69493ac004199d"}, +{"file":"internal/service/interface.go","statements":0,"covered":0,"percent":null,"sha256":"30dd7d5ce30c7fa0c9b54dc38bdee15b71e7afd2c32aac1675b966585bebb203"}, +{"file":"internal/controller/http/fiber/routes.go","statements":56,"covered":56,"percent":100.00000000,"sha256":"826fe61b8d59465de7190c175b6abaa118f4a7deacdb1b9c628e25bb7f4feb3b"}, +{"file":"internal/controller/http/fiber/health.go","statements":7,"covered":7,"percent":100.00000000,"sha256":"7328c3474e6036acbe8c2c0adb91d26e3822ef003d0c2214c89f39a27f2538b2"}, +{"file":"internal/service/auth.go","statements":0,"covered":0,"percent":null,"sha256":"c39b43224191bb74e3deb2c24830de9e8e17f5778f6e03d301893973d661f068"}, +{"file":"internal/admission/limiter.go","statements":16,"covered":16,"percent":100.00000000,"sha256":"a373c9539167a4b7c35d45334d35ffd4e9d124c1740c88c12094fededd9643b4"}, +{"file":"internal/service/production/chats.go","statements":22,"covered":22,"percent":100.00000000,"sha256":"97f7d01d0b2c679910176b473c722f21996f79a164b209f0d71b3f240eaa4100"}, +{"file":"internal/config/logger.go","statements":7,"covered":7,"percent":100.00000000,"sha256":"3a69e20a00fa2ed816f344a990e9e0ef0077e1607d4207858b4b00e4ff5d1988"}, +{"file":"internal/store/postgres/sessions.go","statements":13,"covered":13,"percent":100.00000000,"sha256":"889a63b51b29012f4ae5499d1c0577fe29f2f2959b05629f8e123715cfc1f75f"}, +{"file":"internal/store/memory/chats.go","statements":31,"covered":31,"percent":100.00000000,"sha256":"8da28709d323b71c4e1a301f4f4e4401568ac50c052abe812a145e19ada8115e"}, +{"file":"internal/store/memory/messages.go","statements":19,"covered":18,"percent":94.73684211,"sha256":"7e01358be57c6608f3fce2b72a76bb870a7d9ef76b035dfd473bd5f89abe0745"}, +{"file":"internal/controller/http/fiber/dependencies.go","statements":0,"covered":0,"percent":null,"sha256":"6ee07f110bdb29d8d2191ab8889ba60474b33a5b225739875c8a57d8434be15d"}, +{"file":"cmd/server/app.go","statements":8,"covered":8,"percent":100.00000000,"sha256":"f66db68f6697b4066bbfb6c8884851d0c1f6736a664a7711ab2249583e5180cf"}, +{"file":"internal/store/postgres/chats.go","statements":26,"covered":24,"percent":92.30769231,"sha256":"6bfacaeabe25f14cc400f3ce83aca807692872c4d364797abf20969e65cdf6a4"}, +{"file":"internal/controller/http/fiber/auth.go","statements":29,"covered":29,"percent":100.00000000,"sha256":"fa9da03281a9efc946f5ef3cbd768b18d37880f29fff9755ed347f5308f8c8a9"}, +{"file":"cmd/server/commands.go","statements":6,"covered":6,"percent":100.00000000,"sha256":"7290636ea31539d87bd97bb78cb28658409da966be8983e748ce1701f6f9f8f6"}, +{"file":"internal/controller/http/fiber/error_codes.go","statements":0,"covered":0,"percent":null,"sha256":"3351a019c43d0360ee0fd68afabb5200422d065ae7bd908b1c0a5c02a0c1ad41"}, +{"file":"internal/controller/http/fiber/controller.go","statements":10,"covered":10,"percent":100.00000000,"sha256":"4a74bc4bfc6955ab1bf9a3a8e933381a807b5eafdd9049480be3486f87f1032e"}, +{"file":"internal/config/controller.go","statements":24,"covered":23,"percent":95.83333333,"sha256":"e784d7b934c4604065cd00bf4ff2b0c74741e759b1b7c81162adfc206d160153"}, +{"file":"internal/controller/http/fiber/error_registry.go","statements":2,"covered":2,"percent":100.00000000,"sha256":"9d5da8d98ece2706e324cb2deca915e0811b6ad98f7aaac5805ca0f3cc0a1f9a"}, +{"file":"internal/service/production/access.go","statements":27,"covered":27,"percent":100.00000000,"sha256":"4d39d5ad2ae82c62637d5f2a0a9d5030569ffe65a23eeecba6c1229c35feefd0"}, +{"file":"internal/password/password.go","statements":18,"covered":17,"percent":94.44444444,"sha256":"fe2df6990331573bbf0202ebc81c58263a7c16a29b713eefa0f0e852e4ee4a76"}, +{"file":"internal/controller/http/fiber/middleware.go","statements":34,"covered":33,"percent":97.05882353,"sha256":"d551a81ada306536a235fe684170e68613b72a847b6d16d3195edabd83e250aa"}, +{"file":"internal/controller/fx.go","statements":1,"covered":1,"percent":100.00000000,"sha256":"af72da25fea9811c13a50c8133e9e8b35e070c5295069c40c0ae89cdc0aff19a"}, +{"file":"internal/strictjson/decode.go","statements":37,"covered":36,"percent":97.29729730,"sha256":"ef9bfaf3bd684fded87c92a15b3e5c706a794caf04cc4ef711c4185e9c7fb12a"}, +{"file":"internal/store/memory/ordering.go","statements":6,"covered":6,"percent":100.00000000,"sha256":"b5a20aa3473c42d06ad1b26a318afcc94e7397d34c106844bcf69eebaf210747"}, +{"file":"internal/controller/http/fiber/decode.go","statements":6,"covered":6,"percent":100.00000000,"sha256":"edc7124058479046b7f2ac3db7ff84a7bfb4602265c549cf7808906d6fb48dfb"}, +{"file":"internal/store/postgres/messages.go","statements":21,"covered":20,"percent":95.23809524,"sha256":"45984d4dd4548f3ed96557bf5f8dac8b3b9fdf729e2b1296ef39f7860f0410db"}, +{"file":"internal/config/persistence.go","statements":15,"covered":15,"percent":100.00000000,"sha256":"671f92c52c827989ce194f3928b02f707292022bb97d3c483410e97cf626b4af"}, +{"file":"internal/service/production/errors.go","statements":5,"covered":5,"percent":100.00000000,"sha256":"fd37a3018f9d7ab72bc8d2b130be94967c4becd2bb09033cfb3caf26d4a5142d"}, +{"file":"internal/hashring/ring.go","statements":21,"covered":20,"percent":95.23809524,"sha256":"e205901cec2e66011ec764b70879b0eb0d28a78c4dea8913a9fb30c2d778fa8c"}, +{"file":"internal/admission/distributed.go","statements":0,"covered":0,"percent":null,"sha256":"41ef40897886c0878cbfe52f6716bdcb8433fb7eaddcfff298e1d54c55db423d"}, +{"file":"internal/store/memory/store.go","statements":3,"covered":3,"percent":100.00000000,"sha256":"473cd854d928b02b5a5f50dd7eae87c3f644259b1db0a0ad1e653f3691828c9e"}, +{"file":"internal/store/interface.go","statements":0,"covered":0,"percent":null,"sha256":"7e48fc1130123b259ce4c7d8b699262728d73ba0756c4607e0ad8ec4100c0e4b"}, +{"file":"cmd/server/main.go","statements":3,"covered":3,"percent":100.00000000,"sha256":"c22d8cdf4ce31fde29945e967d3f025e280a7dc4d2022329d51be972d2a0f495"}, +{"file":"internal/store/postgres/store.go","statements":46,"covered":43,"percent":93.47826087,"sha256":"697b8e9bd462b88b6a3d0e5027b1a6157cbb5567f42042b561ffff8274d4faae"}, +{"file":"internal/controller/http/fiber/mapping.go","statements":19,"covered":19,"percent":100.00000000,"sha256":"dfb7cb698cd2fa6b592d04f0986416a0ec58004be23deb3d44a5f55a9ea698e1"}, +{"file":"internal/controller/http/fiber/public_errors.go","statements":13,"covered":12,"percent":92.30769231,"sha256":"eb6b147bbfe46b7ea519d3d65d813e8b28eeaa735dbb77ffa74bae285bc91536"}, +{"file":"internal/controller/http/fiber/errors.go","statements":28,"covered":28,"percent":100.00000000,"sha256":"dbefa0ce973d65b269dfc5f229799b2c5bf16a99547d348eaf6668660a536fcf"}, +{"file":"internal/store/postgres/users.go","statements":21,"covered":20,"percent":95.23809524,"sha256":"034cd07af2e065a3a49ff8cca619ce1f4aaef96758a1fa0d12d1fb1319dcf9e9"}, +{"file":"internal/service/production/users.go","statements":19,"covered":19,"percent":100.00000000,"sha256":"b1bec2c45ca926d193f7956ae3e3ae0868e4e0f722577d0095c737c2484e4da5"}, +{"file":"internal/service/authentication/service.go","statements":48,"covered":47,"percent":97.91666667,"sha256":"398b9c206556e2cd0f57f8ebd0757ab50e061683483d63a3f4ed33d1978bb27d"}, +{"file":"internal/store/memory/users.go","statements":22,"covered":21,"percent":95.45454545,"sha256":"750fbcdb34c66262c9b39f535a7d0acb3403f85d1158e9719356fc312b7ec932"}, +{"file":"cmd/server/persistence.go","statements":18,"covered":18,"percent":100.00000000,"sha256":"e109fb168675a92f990a1c983656623b150ed866062caf718e6b1a1068e19f46"}, +{"file":"internal/controller/http/fiber/configure.go","statements":7,"covered":7,"percent":100.00000000,"sha256":"be356cf26c228958d51f5bafa4305d7325e81ab01065575acbc9b2d7a6ddd4bd"}, +{"file":"internal/service/cursor.go","statements":0,"covered":0,"percent":null,"sha256":"478c8c9aca24d0fc7c471dfba43dcdd3c5b78a9d2c4d97c87fbcc058640c99d0"}, +{"file":"internal/controller/http/fiber/lifecycle.go","statements":24,"covered":22,"percent":91.66666667,"sha256":"f39cf7a0049a2ed39d6cc1fcc66b44656d9d6120914d0e973b032e12f3d0de08"}, +{"file":"internal/controller/http/fiber/headers.go","statements":0,"covered":0,"percent":null,"sha256":"d32a9a01a8b391f4d986e14947a25a0504f4363335ea1524df05e0dd8e9e61bd"}, +{"file":"internal/config/memory.go","statements":11,"covered":11,"percent":100.00000000,"sha256":"86cdf9e90b576f4484946bfd9605333fc52077f38d3a39c5d71ddca4cdeecda0"}, +{"file":"internal/valkey/admission.go","statements":45,"covered":45,"percent":100.00000000,"sha256":"a25eb9130eeb832411fd7ab8a359a6d4e0ba39f7e12b71ec62917594293343f0"} +],"passed":true} diff --git a/evidence/fault-coverage.txt b/evidence/fault-coverage.txt new file mode 100644 index 0000000..743e22e --- /dev/null +++ b/evidence/fault-coverage.txt @@ -0,0 +1,92 @@ +GO="go" scripts/coverage.sh +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/cmd/server 2.112s coverage: 31.0% of statements in ./... +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/admission 1.352s coverage: 1.5% of statements in ./... +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/config 1.352s coverage: 7.6% of statements in ./... + gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/controller coverage: 0.0% of statements +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/controller/http/fiber 1.607s coverage: 55.5% of statements in ./... +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/cursor 1.350s coverage: 2.8% of statements in ./... +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/hashring 1.919s coverage: 1.8% of statements in ./... +? gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/model/dto [no test files] +? gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/model/http [no test files] +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/password 2.497s coverage: 1.6% of statements in ./... +? gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/service [no test files] +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/service/authentication 1.352s coverage: 4.9% of statements in ./... +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/service/production 1.369s coverage: 19.1% of statements in ./... +? gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/store [no test files] +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/store/memory 1.356s coverage: 8.4% of statements in ./... +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/store/postgres 2.388s coverage: 11.0% of statements in ./... +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/strictjson 1.255s coverage: 3.3% of statements in ./... +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/valkey 1.334s coverage: 10.6% of statements in ./... +ok gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/student-tests 1.313s coverage: 0.0% of statements in ./... +PASS: lab2 public API scenario; infrastructure and grading evidence remain separate. + 93.94% internal/cursor/codec.go + 97.14% internal/valkey/client.go + 97.30% internal/controller/http/fiber/handlers.go + 100.00% internal/service/production/members.go + 100.00% internal/service/production/creation.go + N/A internal/controller/interface.go + N/A internal/model/http/models.go + 100.00% internal/config/config.go + 100.00% internal/service/production/messages.go + 100.00% internal/service/production/service.go + N/A internal/service/errors.go + 90.00% cmd/server/logger.go + N/A internal/model/dto/session.go + 100.00% internal/service/production/pagination.go + 100.00% internal/service/production/validation.go + 94.74% cmd/server/healthcheck.go + 100.00% internal/store/memory/capacity.go + N/A internal/service/cache.go + 94.12% internal/service/production/pages.go + 100.00% internal/config/environment.go + N/A internal/model/dto/models.go + 94.74% internal/valkey/cache.go + N/A internal/service/interface.go + 100.00% internal/controller/http/fiber/routes.go + 100.00% internal/controller/http/fiber/health.go + N/A internal/service/auth.go + 100.00% internal/admission/limiter.go + 100.00% internal/service/production/chats.go + 100.00% internal/config/logger.go + 100.00% internal/store/postgres/sessions.go + 100.00% internal/store/memory/chats.go + 94.74% internal/store/memory/messages.go + N/A internal/controller/http/fiber/dependencies.go + 100.00% cmd/server/app.go + 92.31% internal/store/postgres/chats.go + 100.00% internal/controller/http/fiber/auth.go + 100.00% cmd/server/commands.go + N/A internal/controller/http/fiber/error_codes.go + 100.00% internal/controller/http/fiber/controller.go + 95.83% internal/config/controller.go + 100.00% internal/controller/http/fiber/error_registry.go + 100.00% internal/service/production/access.go + 94.44% internal/password/password.go + 97.06% internal/controller/http/fiber/middleware.go + 100.00% internal/controller/fx.go + 97.30% internal/strictjson/decode.go + 100.00% internal/store/memory/ordering.go + 100.00% internal/controller/http/fiber/decode.go + 95.24% internal/store/postgres/messages.go + 100.00% internal/config/persistence.go + 100.00% internal/service/production/errors.go + 95.24% internal/hashring/ring.go + N/A internal/admission/distributed.go + 100.00% internal/store/memory/store.go + N/A internal/store/interface.go + 100.00% cmd/server/main.go + 93.48% internal/store/postgres/store.go + 100.00% internal/controller/http/fiber/mapping.go + 92.31% internal/controller/http/fiber/public_errors.go + 100.00% internal/controller/http/fiber/errors.go + 95.24% internal/store/postgres/users.go + 100.00% internal/service/production/users.go + 97.92% internal/service/authentication/service.go + 95.45% internal/store/memory/users.go + 100.00% cmd/server/persistence.go + 100.00% internal/controller/http/fiber/configure.go + N/A internal/service/cursor.go + 91.67% internal/controller/http/fiber/lifecycle.go + N/A internal/controller/http/fiber/headers.go + 100.00% internal/config/memory.go + 100.00% internal/valkey/admission.go diff --git a/evidence/fault-lint.txt b/evidence/fault-lint.txt new file mode 100644 index 0000000..18235ca --- /dev/null +++ b/evidence/fault-lint.txt @@ -0,0 +1,2 @@ +golangci-lint run ./... +0 issues. diff --git a/evidence/fault-regression.txt b/evidence/fault-regression.txt new file mode 100644 index 0000000..283d50d --- /dev/null +++ b/evidence/fault-regression.txt @@ -0,0 +1,27 @@ +scripts/test-faults.sh +UTC 2026-10-16T07:16:07Z +b90581f613aa82866be2dce08afe725d9a7426a9 +6bfacaeabe25f14cc400f3ce83aca807692872c4d364797abf20969e65cdf6a4 internal/store/postgres/chats.go +1d0179aa490fa03ed545141f9dc5b40e454a197689a8a40c244358d9ed3f229e internal/store/postgres/errors_test.go +45984d4dd4548f3ed96557bf5f8dac8b3b9fdf729e2b1296ef39f7860f0410db internal/store/postgres/messages.go +889a63b51b29012f4ae5499d1c0577fe29f2f2959b05629f8e123715cfc1f75f internal/store/postgres/sessions.go +697b8e9bd462b88b6a3d0e5027b1a6157cbb5567f42042b561ffff8274d4faae internal/store/postgres/store.go +601c9cde6c08314c6107bfaa79cbcc50e02768d38998d921ae825d0877cdc729 internal/store/postgres/store_test.go +034cd07af2e065a3a49ff8cca619ce1f4aaef96758a1fa0d12d1fb1319dcf9e9 internal/store/postgres/users.go +9dd4d2998e37c48e104298ae7bc9f311f193ff5212608f9c579cd569941d5054 internal/service/errors.go +7e48fc1130123b259ce4c7d8b699262728d73ba0756c4607e0ad8ec4100c0e4b internal/store/interface.go +eb6b147bbfe46b7ea519d3d65d813e8b28eeaa735dbb77ffa74bae285bc91536 internal/controller/http/fiber/public_errors.go +97614aa2647c42caecc9ab265673702e4c7eede8d0f2281acf16f44ac1d0e6da scripts/test-faults.sh +PASS: postgres stop authenticated history => 503 unavailable (0.001530s) +PASS: postgres stop rejects anonymous/spoofed/malformed/unknown identity; liveness=200 readiness=503 +PASS: postgres stop recovery preserves the original session and message +PASS: postgres pause authenticated history => 503 unavailable (0.507818s) +PASS: postgres pause rejects anonymous/spoofed/malformed/unknown identity; liveness=200 readiness=503 +PASS: postgres pause recovery preserves the original session and message +PASS: valkey stop authenticated history => 503 unavailable (0.503123s) +PASS: valkey stop rejects anonymous/spoofed/malformed/unknown identity; liveness=200 readiness=503 +PASS: valkey stop recovery preserves the original session and message +PASS: valkey pause authenticated history => 503 unavailable (0.506513s) +PASS: valkey pause rejects anonymous/spoofed/malformed/unknown identity; liveness=200 readiness=503 +PASS: valkey pause recovery preserves the original session and message +PASS: real dependency fault scenarios completed diff --git a/evidence/fault-vet.txt b/evidence/fault-vet.txt new file mode 100644 index 0000000..8b94ad5 --- /dev/null +++ b/evidence/fault-vet.txt @@ -0,0 +1 @@ +go vet ./... diff --git a/internal/controller/http/fiber/public_errors.go b/internal/controller/http/fiber/public_errors.go index fefce5a..f69b7c1 100644 --- a/internal/controller/http/fiber/public_errors.go +++ b/internal/controller/http/fiber/public_errors.go @@ -25,6 +25,8 @@ func publicFailure(code, message string) error { // Unknown errors receive a fixed response without exposing their details. func publicError(err error) error { switch { + case errors.Is(err, service.ErrUnavailable): + return publicFailure(codeUnavailable, "dependency unavailable") case errors.Is(err, service.ErrInvalid): return fielderr.WithStatus(err, fielderr.NewStatusCode(codeInvalid), "invalid request") case errors.Is(err, service.ErrUnauthorized): diff --git a/internal/controller/http/fiber/public_errors_test.go b/internal/controller/http/fiber/public_errors_test.go index c8f4ea6..801337c 100644 --- a/internal/controller/http/fiber/public_errors_test.go +++ b/internal/controller/http/fiber/public_errors_test.go @@ -32,3 +32,12 @@ func TestPublicErrorSafety(t *testing.T) { } }) } + +// TestPublicErrorUnavailable keeps dependency details out of the public envelope. +func TestPublicErrorUnavailable(t *testing.T) { + err := publicError(fmt.Errorf("private database detail: %w", service.ErrUnavailable)) + response := errorResponse(err, "request") + if response.Error.Code != codeUnavailable || response.Error.Message != "dependency unavailable" { + t.Fatalf("unexpected response: %+v", response) + } +} diff --git a/internal/service/errors.go b/internal/service/errors.go index d49f305..738fdd9 100644 --- a/internal/service/errors.go +++ b/internal/service/errors.go @@ -1,8 +1,15 @@ package service -import "errors" +import ( + "errors" + + "gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/store" +) var ( + // ErrUnavailable preserves the dependency failure category across service boundaries. + ErrUnavailable = store.ErrUnavailable + // ErrInvalid indicates invalid operation input. ErrInvalid = errors.New("invalid request") // ErrUnauthorized indicates an unresolved current user. diff --git a/internal/store/interface.go b/internal/store/interface.go index a6598a5..02dff4d 100644 --- a/internal/store/interface.go +++ b/internal/store/interface.go @@ -11,6 +11,9 @@ import ( ) var ( + // ErrUnavailable means a required storage dependency cannot serve the operation. + ErrUnavailable = errors.New("storage unavailable") + // ErrNotFound means a record does not exist. ErrNotFound = errors.New("record not found") diff --git a/internal/store/postgres/chats.go b/internal/store/postgres/chats.go index 8bd91bc..518a34c 100644 --- a/internal/store/postgres/chats.go +++ b/internal/store/postgres/chats.go @@ -43,16 +43,16 @@ func (s *Store) Chats(ctx context.Context, userID uuid.UUID, position dto.Positi "user": userID, "time": position.CreatedAt, "id": position.ID, "limit": limit, }) if err != nil { - return nil, err + return nil, normalize(err) } defer rows.Close() chats := make([]dto.ChatDTO, 0) for rows.Next() { var chat dto.ChatDTO if err := rows.Scan(&chat.ID, &chat.Title, &chat.CreatedAt, &chat.MemberIDs); err != nil { - return nil, err + return nil, normalize(err) } chats = append(chats, chat) } - return chats, rows.Err() + return chats, normalize(rows.Err()) } diff --git a/internal/store/postgres/errors_test.go b/internal/store/postgres/errors_test.go new file mode 100644 index 0000000..2257de0 --- /dev/null +++ b/internal/store/postgres/errors_test.go @@ -0,0 +1,52 @@ +package postgres + +import ( + "context" + "errors" + "fmt" + "io" + "net" + "testing" + + "github.com/jackc/pgx/v5/pgconn" + + "gitea.privcloud.tech/vlad_marlo/mtusi2026lab2/internal/store" +) + +// TestNormalizeUnavailable classifies dependency failures while retaining their causes. +func TestNormalizeUnavailable(t *testing.T) { + cases := []struct { + name string + err error + }{ + {"deadline", context.DeadlineExceeded}, + {"closed stream", io.EOF}, + {"truncated stream", io.ErrUnexpectedEOF}, + {"network", &net.OpError{Op: "dial", Net: "tcp", Err: errors.New("refused")}}, + {"connection exception", &pgconn.PgError{Code: "08006"}}, + {"connection limit", &pgconn.PgError{Code: "53300"}}, + {"shutdown", &pgconn.PgError{Code: "57P01"}}, + {"crash", &pgconn.PgError{Code: "57P02"}}, + {"starting", &pgconn.PgError{Code: "57P03"}}, + } + for _, tc := range cases { + t.Run(tc.name, func(t *testing.T) { + err := normalize(fmt.Errorf("operation failed: %w", tc.err)) + if !errors.Is(err, store.ErrUnavailable) || !errors.Is(err, tc.err) { + t.Fatalf("failure category or cause lost: %T", tc.err) + } + }) + } +} + +// TestNormalizeUnexpected preserves programming errors instead of misclassifying them as outages. +func TestNormalizeUnexpected(t *testing.T) { + for _, code := range []string{"42601", "23503", "42P01"} { + t.Run(code, func(t *testing.T) { + err := &pgconn.PgError{Code: code} + if normalize(err) != err { + t.Fatal("unexpected SQL error was reclassified") + } + }) + } +} diff --git a/internal/store/postgres/messages.go b/internal/store/postgres/messages.go index f363b04..ced60b3 100644 --- a/internal/store/postgres/messages.go +++ b/internal/store/postgres/messages.go @@ -35,16 +35,16 @@ func (s *Store) Messages(ctx context.Context, chatID uuid.UUID, position dto.Pos "chat": chatID, "time": position.CreatedAt, "id": position.ID, "limit": limit, }) if err != nil { - return nil, err + return nil, normalize(err) } defer rows.Close() messages := make([]dto.MessageDTO, 0) for rows.Next() { var message dto.MessageDTO if err := rows.Scan(&message.ID, &message.ChatID, &message.SenderID, &message.Text, &message.CreatedAt); err != nil { - return nil, err + return nil, normalize(err) } messages = append(messages, message) } - return messages, rows.Err() + return messages, normalize(rows.Err()) } diff --git a/internal/store/postgres/sessions.go b/internal/store/postgres/sessions.go index 17b5406..3e64d27 100644 --- a/internal/store/postgres/sessions.go +++ b/internal/store/postgres/sessions.go @@ -32,5 +32,5 @@ func (s *Store) RevokeSession(ctx context.Context, hash string) error { ctx, cancel := context.WithTimeout(ctx, s.timeout) defer cancel() _, err := s.pool.Exec(ctx, `DELETE FROM sessions WHERE token_hash=@hash`, pgx.StrictNamedArgs{"hash": hash}) - return err + return normalize(err) } diff --git a/internal/store/postgres/store.go b/internal/store/postgres/store.go index 10c6bda..cf75cfb 100644 --- a/internal/store/postgres/store.go +++ b/internal/store/postgres/store.go @@ -6,6 +6,9 @@ import ( _ "embed" "errors" "fmt" + "io" + "net" + "strings" "time" "github.com/jackc/pgx/v5" @@ -105,8 +108,20 @@ func normalize(err error) error { if errors.Is(err, pgx.ErrNoRows) { return store.ErrNotFound } - if databaseError, ok := errors.AsType[*pgconn.PgError](err); ok && databaseError.Code == "23505" { - return store.ErrConflict + if databaseError, ok := errors.AsType[*pgconn.PgError](err); ok { + if databaseError.Code == "23505" { + return store.ErrConflict + } + if strings.HasPrefix(databaseError.Code, "08") || strings.HasPrefix(databaseError.Code, "53") || + databaseError.Code == "57P01" || databaseError.Code == "57P02" || databaseError.Code == "57P03" { + return fmt.Errorf("%w: %w", store.ErrUnavailable, err) + } + } + var networkError net.Error + var connectError *pgconn.ConnectError + if errors.Is(err, context.DeadlineExceeded) || errors.Is(err, io.EOF) || errors.Is(err, io.ErrUnexpectedEOF) || + errors.As(err, &networkError) || errors.As(err, &connectError) || pgconn.SafeToRetry(err) { + return fmt.Errorf("%w: %w", store.ErrUnavailable, err) } return err } diff --git a/internal/store/postgres/users.go b/internal/store/postgres/users.go index 40513b1..db22c47 100644 --- a/internal/store/postgres/users.go +++ b/internal/store/postgres/users.go @@ -54,5 +54,5 @@ func (s *Store) UsersExist(ctx context.Context, ids []uuid.UUID) (bool, error) { var exists bool err := s.pool.QueryRow(ctx, `SELECT NOT EXISTS (SELECT id FROM unnest(@ids::uuid[]) AS requested(id) WHERE NOT EXISTS (SELECT 1 FROM users WHERE users.id=requested.id))`, pgx.StrictNamedArgs{"ids": ids}).Scan(&exists) - return exists, err + return exists, normalize(err) } diff --git a/scripts/test-faults.sh b/scripts/test-faults.sh new file mode 100755 index 0000000..b80a7e0 --- /dev/null +++ b/scripts/test-faults.sh @@ -0,0 +1,112 @@ +#!/bin/sh +# Exercise real dependency outages on disposable containers; never target the dev cluster. +set -eu +cd "$(dirname "$0")/.." +umask 077 +work=$(mktemp -d) +name="lab2-fault-$(basename "$work" | tr '[:upper:].' '[:lower:]-')" +containers= +cleanup() { + for container in $containers; do + docker unpause "$container" >/dev/null 2>&1 || true + docker rm -f "$container" >/dev/null 2>&1 || true + done + docker network rm "$name" >/dev/null 2>&1 || true + docker image rm "$name" >/dev/null 2>&1 || true + rm -rf "$work" +} +trap cleanup EXIT +trap 'exit 130' INT +trap 'exit 143' TERM +printf 'UTC %s\n' "$(date -u '+%Y-%m-%dT%H:%M:%SZ')" +git rev-parse HEAD +shasum -a 256 internal/store/postgres/*.go internal/service/errors.go internal/store/interface.go internal/controller/http/fiber/public_errors.go scripts/test-faults.sh +# Build the working tree, including uncommitted fixes, without publishing an image. +docker build -q -t "$name" . > "$work/build.txt" +docker network create "$name" >/dev/null +pg=$(docker run -d --network "$name" --network-alias postgres -e POSTGRES_PASSWORD=synthetic-fault-password -e POSTGRES_DB=messenger postgres:17.6-alpine) +containers="$pg" +cache=$(docker run -d --network "$name" --network-alias valkey valkey/valkey:8.1.3-alpine) +containers="$containers $cache" +for attempt in $(seq 1 60); do + if docker exec "$pg" pg_isready -U postgres >/dev/null 2>&1; then break; fi + sleep 1 + done +api=$(docker run -d --network "$name" -p 127.0.0.1::8080 \ + -e DATABASE_URL=postgres://postgres:synthetic-fault-password@postgres:5432/messenger?sslmode=disable \ + -e VALKEY_SHARDS=shard0=valkey:6379 -e VALKEY_COORDINATOR=shard0 \ + -e DEPENDENCY_TIMEOUT_MS=500 -e LOG_LEVEL=error "$name") +containers="$containers $api" +base="http://$(docker port "$api" 8080/tcp)" +: > "$work/anonymous" +wait_ready() { + for attempt in $(seq 1 60); do + if curl -fsS --max-time 2 "$base/health/ready" >/dev/null 2>&1; then return; fi + sleep 1 + done + echo 'FAIL: API did not recover within 60 seconds' >&2 + exit 1 +} +# Credentials remain in private temporary curl config files, never in evidence or argv. +request() { + method=$1; path=$2; expected=$3; auth=$4 + shift 4 + result=$(curl -sS --max-time 3 --config "$work/$auth" -X "$method" \ + -H 'Content-Type: application/json' -o "$work/response" \ + -w '%{http_code} %{time_total}' "$base$path" "$@") + status=${result%% *} + elapsed=${result#* } + if [ "$status" != "$expected" ]; then + printf 'FAIL: %s %s expected=%s actual=%s\n' "$method" "$path" "$expected" "$status" >&2 + exit 1 + fi +} +assert_error() { + jq -e --arg code "$1" '.error.code == $code and (.error.request_id | type == "string") and (has("items") | not)' "$work/response" >/dev/null + if rg -qi 'postgres|synthetic-fault-password|dial tcp|SELECT |SQLSTATE|redis|valkey|token_hash' "$work/response"; then + echo 'FAIL: internal dependency details exposed' >&2 + exit 1 + fi +} +wait_ready +request POST /api/v1/users 201 anonymous --data '{"username":"fault_actor","display_name":"Synthetic","password":"synthetic-user-password"}' +user=$(jq -er .id "$work/response") +printf 'header = "Authorization: Basic %s"\n' "$(printf 'fault_actor:synthetic-user-password' | openssl base64 -A)" > "$work/basic" +request POST /api/v1/auth/sessions 201 basic +jq -er '"header = \"Authorization: Bearer " + .token + "\""' "$work/response" > "$work/bearer" +printf 'header = "X-User-Id: %s"\n' "$user" > "$work/spoofed" +printf 'header = "Authorization: Bearer malformed"\n' > "$work/malformed" +printf 'header = "Authorization: Bearer AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"\n' > "$work/unknown" +request POST /api/v1/chats 201 bearer --data "{\"title\":\"Synthetic fault chat\",\"member_ids\":[\"$user\"]}" +chat=$(jq -er .id "$work/response") +history="/api/v1/chats/$chat/messages" +request POST "$history" 201 bearer --data '{"text":"confirmed before outage"}' +cp "$work/response" "$work/message" +request GET "$history" 200 bearer +for dependency in "$pg" "$cache"; do + if [ "$dependency" = "$pg" ]; then label=postgres; else label=valkey; fi + for fault in stop pause; do + docker "$fault" "$dependency" >/dev/null + request GET "$history" 503 bearer + assert_error unavailable + printf 'PASS: %s %s authenticated history => 503 unavailable (%ss)\n' "$label" "$fault" "$elapsed" + request GET /health/ready 503 anonymous + assert_error unavailable + request GET /health/live 200 anonymous + for auth in anonymous spoofed malformed unknown; do + expected=503 + if [ "$label" = postgres ] && [ "$auth" != unknown ]; then expected=401; fi + request GET "$history" "$expected" "$auth" + if [ "$expected" = 401 ]; then assert_error unauthorized; else assert_error unavailable; fi + done + printf 'PASS: %s %s rejects anonymous/spoofed/malformed/unknown identity; liveness=200 readiness=503\n' "$label" "$fault" + if [ "$fault" = stop ]; then docker start "$dependency" >/dev/null; else docker unpause "$dependency" >/dev/null; fi + wait_ready + request GET "$history" 200 bearer + jq -e --slurpfile message "$work/message" '.items == $message' "$work/response" >/dev/null + request GET "$history" 401 anonymous + assert_error unauthorized + printf 'PASS: %s %s recovery preserves the original session and message\n' "$label" "$fault" + done + done +printf 'PASS: real dependency fault scenarios completed\n' diff --git a/student-tests/README.md b/student-tests/README.md index 04839ea..a477fa3 100644 --- a/student-tests/README.md +++ b/student-tests/README.md @@ -6,4 +6,8 @@ Go-тесты расположены рядом с кодом. `quality_test.go` Тестовые controller fixtures заменяют только Authentication/Admission/Readiness: fixture Bearer равен UUID для изоляции бизнес-сценариев. Production Authentication всегда использует случайный токен и PostgreSQL; это отдельно проверяют unit tests authentication и настоящие HTTP smoke/expiry/persistence. Fixture токены не являются доступным режимом приложения. -`make research` запускает SQL из `research.sql` и `plans.sql` в новом временном контейнере, с ограничениями 1 CPU и 512 MiB. Исследуемые запросы находятся непосредственно в SQL, shell отвечает только за запуск PostgreSQL и dump/restore. Сохранённые ранее HTTP-проверки отказов и TTL описаны в `evidence/dependencies.json`; прежняя Python-обвязка удалена. Регрессионные проверки TTL и отказов клиентов остаются в Go-тестах рядом с реализацией. +`make research` запускает SQL из `research.sql` и `plans.sql` в новом временном контейнере, с ограничениями 1 CPU и 512 MiB. Исследуемые запросы находятся непосредственно в SQL, shell отвечает только за запуск PostgreSQL и dump/restore. + +`make test-faults` — воспроизводимый HTTP-сценарий реальных отказов PostgreSQL и Valkey. Нужны Docker, curl, jq, rg, OpenSSL и shasum. Скрипт собирает текущий код в локальный образ, создаёт отдельную Docker-сеть и временные контейнеры. Каждый backend по очереди останавливается и приостанавливается (`stop`/`pause`). Проверяются 503/unavailable с действительным токеном, ограничение ожидания 3 секундами при timeout зависимости 500 мс, readiness=503, liveness=200, отсутствие доступа без токена, по X-User-Id, с повреждённым и неизвестным Bearer. После каждого восстановления прежняя сессия читает подтверждённое сообщение без повторного входа. Секреты находятся только во временных файлах; вывод не содержит токенов или тел сообщений. Ресурсы удаляются через trap, dev-кластер не используется. + +Свежий результат: [fault-regression.txt](../evidence/fault-regression.txt). Старые проверки в [dependencies.json](../evidence/dependencies.json) остаются историческими измерениями; текущий сценарий не зависит от удалённой Python-обвязки. TTL отдельно проверяется Go-тестами.