Add black-box tests for the strict-id-validation change: a server-issued cursor with one field changed (non-string or non-canonical item id, v=true, extra field) on both lists, member_ids with values of other JSON types, a non-array member_ids and other UUID notations, and chat_id in the path of the three chat endpoints. Sync the change's delta specs into api-conventions, chats and pagination so the coverage check knows the new scenarios. The cursor and UUID-notation tests fail on the current code by design; the fix follows in the next commit. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.1 KiB
6.1 KiB
Proposal
Why
Рецензия лабы 3 нашла дефект: повреждённый курсор даёт 500 вместо 400
(src/utils/cursor.py:67). Если в выданном сервером курсоре заменить
ключ элемента "i" на [], {}, 123 или false, UUID(...)
бросает AttributeError. Этого исключения нет среди перехватываемых, и
запрос уходит в общий обработчик 500. Рецензент попросил ещё тесты на те
же значения вместо UUID.
Разбор показал, что и остальной вход с UUID шире контракта:
- pydantic принимает UUID без дефисов, с префиксом
urn:uuid:и в фигурных скобках. ТакGET /chats/<32 hex>отвечает 200, аmember_ids: ["urn:uuid:…"]создаёт чат; - контракт объявляет
chat_idи элементыmember_idsкакformat: uuid(contracts/openapi.json),contracts/README.md— «неверные … UUID → 400»; - курсор после подмены
"v": trueили записи"i"в другой форме разбирается как настоящий:True == 1, аUUID()из stdlib тоже нестрог.
Пользователь решил чинить всё найденное, чтобы вход совпадал с контрактом и требованиями.
What Changes
- Курсор принимается только в записи, которую выдал сервер.
- Значения не того типа больше не роняют разбор.
- Подмена любого поля —
"i","t","v", лишнее поле, другая запись UUID или времени — даёт 400invalid_request, а не 500 и не 200.
- UUID на входе — только запись 8-4-4-4-12. Это
chat_idв пути трёх ручек (GET /chats/{chat_id},GETиPOST /chats/{chat_id}/messages) и элементыmember_idsвPOST /chats.- Шестнадцатеричные цифры принимаются в любом регистре (RFC 9562), в ответах id по-прежнему в нижнем регистре.
- Без дефисов, с
urn:uuid:, в скобках, с пробелами и любой другой тип — 400invalid_request. - BREAKING (для нестандартных клиентов):
chat_idиmember_idsв записи без дефисов,urn:uuid:или{…}раньше принимались и давали 200 / 201, теперь — 400. Smoke, собственные тесты и k6 стендаbench/шлют только id, выданные сервером, и это их не задевает.
- Тесты black-box в
student-tests/.- Подменённый курсор на обоих списках: история и список чатов.
member_ids:[],{},123,falseвместо UUID, не массив вместо массива, другая запись UUID, верхний регистр.chat_idв пути трёх ручек: те же значения и те же записи.- Тесты курсора и записи UUID красные на текущем коде и зелёные после
исправления. Тесты типов
member_idsуже должны быть зелёными: их сейчас нет, рецензент просил подтвердить поведение.
- Документы:
- правило
api-contract.md(раздел «Валидация → 400») — где pydantic шире контракта; REPORT.md— таблица доказательств и число тестов;- evidence прогонов «до/после».
- правило
Capabilities
New Capabilities
Нет.
Modified Capabilities
api-conventions: новое требование «UUID на входе»: запись 8-4-4-4-12 без учёта регистра, другие типы и записи — 400; общее для пути и тела.pagination: требование «Курсор непрозрачен и привязан к списку» — изменённый курсор, в том числе с ключом не того типа, — 400, а не 500.chats: «Создание чата» —member_idsв ответе совпадает с переданным списком как те же UUID в том же порядке, в нижнем регистре; «Валидация чата» —member_idsне массив → 400.
Impact
- Код:
src/utils/cursor.py— разбор курсора;src/api/schemas/common.py— общий тип UUID входа;src/api/schemas/chat.py—member_ids;src/api/routers/v1/chat.py,message.py—chat_id;src/utils/constants.py— шаблон записи UUID.
- Тесты:
student-tests/test_pagination.py,test_chats.py,test_api_conventions.py, при необходимости хелперыapi_client.py. - Без изменений:
- схема БД, миграции, сервисы и repo;
- HAProxy, compose, стенд
bench/, проверки отказов; - формат курсора: сервер выдаёт тот же, и уже выданные курсоры продолжают работать.
- Совместимость при поочерёдной замене. Старая и новая реплики выдают одинаковые курсоры. Старая принимает нестрогие UUID, новая — нет. Других различий нет.
- Стенд. Новый код доходит до реплик через
make rolling_update; проверки —make test_isolatedиmake student_testчерез LB.