diff --git a/REPORT.md b/REPORT.md index 213bb78..7c35e97 100644 --- a/REPORT.md +++ b/REPORT.md @@ -140,7 +140,7 @@ WHERE chat_id = $1 AND (created_at, id) > ($2, $3) ORDER BY created_at, id LIMIT $4 ``` -Cursor — base64 от JSON `[область, created_at, id]` последней выданной записи; область привязывает его к конкретному чату или к списку чатов конкретного пользователя. Запрашивается `limit + 1` строк: лишняя строка показывает, есть ли следующая страница. +Cursor — base64 от JSON `[область, created_at, id]` последней выданной записи; область привязывает его к конкретному чату или к списку чатов конкретного пользователя. Разбор строгий: посторонние символы в base64 не пропускаются, внутри должен быть список ровно из трёх строк, время — в формате сервера, id — UUID в каноническом виде; затем cursor кодируется заново и сравнивается с присланным. Любое отклонение даёт 400 `invalid_request`. Запрашивается `limit + 1` строк: лишняя строка показывает, есть ли следующая страница. **Семантика при конкурентных вставках.** `created_at` — это `now()` PostgreSQL, то есть время начала транзакции. Две параллельные транзакции могут зафиксироваться не в порядке своих `created_at`. Поэтому сообщение с чуть более ранним временем может появиться в истории уже после того, как клиент прошёл это место по cursor, и при обходе вперёд он его не увидит (окно — миллисекунды, длительность транзакции вставки). Повторов при обходе нет. Чтение после записи выполняется: ответ 201 приходит после COMMIT, следующий `GET` это сообщение видит. @@ -161,11 +161,13 @@ Cursor — base64 от JSON `[область, created_at, id]` последне Перенесены: структура `src/`, формат ошибок и `X-Request-Id`, валидация JSON, cursor-пагинация, логирование без содержимого, Dockerfile (непривилегированный пользователь, healthcheck, корректная остановка по SIGTERM), собственные тесты. +Исправлено по замечанию к lab1: некорректный cursor мог вернуть 200 (посторонние символы в base64, неканоничные время и UUID); теперь он всегда даёт 400, проверка — тест `test_cursor_format_is_checked`. + Изменено: хранилище в памяти заменено на PostgreSQL; `X-User-Id` заменён на пароль, Basic и Bearer; добавлены миграции, Redis, compose, проверка зависимостей в `/health/ready` и ответ 503. Строки теперь проверяются ещё и на символ NUL, который PostgreSQL не хранит. Контракт и публичные тесты не менялись. ## Доказательства критериев -Стенд: Apple M3 Pro, 11 CPU, 18 ГБ RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0, без ограничений CPU/RAM для контейнеров. Все файлы получены из чистого clone на пустых volumes, commit `6473fd0`. +Стенд: Apple M3 Pro, 11 CPU, 18 ГБ RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0, без ограничений CPU/RAM для контейнеров. Все файлы получены из чистого clone на пустых volumes, commit `6473fd0`. Файл `evidence/02-student-tests.txt` получен заново на commit `31530fc` после ужесточения проверки cursor. | Критерий README | Команда/сценарий | Наблюдаемый результат | Файл доказательства | | --- | --- | --- | --- | diff --git a/evidence/02-student-tests.txt b/evidence/02-student-tests.txt index c8921eb..d75ee2d 100644 --- a/evidence/02-student-tests.txt +++ b/evidence/02-student-tests.txt @@ -1,5 +1,5 @@ # Собственные тесты API -# дата: 2026-10-08T15:55Z, commit: 6473fd0 +# дата: 2026-10-09T10:55Z, commit: 31530fc (после исправления проверки cursor) # стенд: Apple M3 Pro, 11 CPU, 18 GB RAM, macOS 26.1, Docker 29.3.0, Compose 5.1.0 $ make student-test @@ -37,6 +37,7 @@ test_chat_cursor_belongs_to_user (test_pagination.ChatPaginationTest.test_chat_c test_walk_chat_list (test_pagination.ChatPaginationTest.test_walk_chat_list) ... ok test_bad_cursor (test_pagination.MessagePaginationTest.test_bad_cursor) ... ok test_bad_limit (test_pagination.MessagePaginationTest.test_bad_limit) ... ok +test_cursor_format_is_checked (test_pagination.MessagePaginationTest.test_cursor_format_is_checked) ... ok test_cursor_from_another_chat (test_pagination.MessagePaginationTest.test_cursor_from_another_chat) ... ok test_default_limit (test_pagination.MessagePaginationTest.test_default_limit) ... ok test_exact_page_has_no_cursor (test_pagination.MessagePaginationTest.test_exact_page_has_no_cursor) ... ok @@ -65,7 +66,7 @@ test_password_is_never_returned (test_validation.UserValidationTest.test_passwor test_password_length_limits (test_validation.UserValidationTest.test_password_length_limits) ... ok ---------------------------------------------------------------------- -Ran 59 tests in 1.690s +Ran 60 tests in 1.798s OK