Copy the committed lab 1 sources as-is: src/, student-tests/, bench/, Dockerfile, docker-compose.yml, pyproject.toml, uv.lock, .python-version, config_example.toml, AGENTS.md, CLAUDE.md, .claude/, openspec/, .graphifyignore and KNOWN_ISSUES.md. Lab 1 evidence stays in the lab 1 repository. Merge the new skeleton files with own sections: Makefile (lab 2 targets plus own run, docker, bench and common targets), .gitignore, .dockerignore and .env.example. Rename the image to mtusi-messenger:lab2 and point AGENTS.md at lab 2. The application is still the in-memory lab 1 implementation. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.3 KiB
identification Specification
Purpose
Выбор текущего пользователя на лабе 1 через заголовок X-User-Id и
порядок проверок «идентификация → доступ к ресурсу». Это учебная
идентификация, а не аутентификация: любой клиент может выдать себя за
другого. С лабы 2 её заменяет Bearer-сессия.
Requirements
Requirement: Защищённые эндпоинты требуют X-User-Id
Все эндпоинты, кроме POST /api/v1/users и health, SHALL требовать
заголовок X-User-Id с UUID существующего пользователя. Этот
пользователь SHALL считаться текущим для запроса.
Scenario: Корректный заголовок
- WHEN клиент вызывает
GET /api/v1/users/meсX-User-Idсуществующего пользователя - THEN ответ 200 с этим пользователем
Requirement: Отказ в идентификации — 401
Сервис SHALL отвечать 401 с code unauthorized, когда заголовок
X-User-Id отсутствует, не является UUID или указывает на
несуществующего пользователя. Эти три случая MUST давать одинаковый
ответ и MUST NOT давать 400.
Scenario: Нет заголовка
- WHEN клиент вызывает
GET /api/v1/users/meбезX-User-Id - THEN ответ 401 с
codeunauthorized
Scenario: Не UUID
- WHEN
X-User-Idравенnot-a-uuid - THEN ответ 401 с
codeunauthorized
Scenario: Неизвестный пользователь
- WHEN
X-User-Id— корректный UUID, но такого пользователя нет - THEN ответ 401 с
codeunauthorized
Requirement: Идентификация раньше доступа и валидации
Идентификация SHALL проверяться раньше доступа к конкретному ресурсу и раньше проверки пути, query и полей тела. Исключение, согласованное с преподавателем 2026-09-26: тело, которое не разбирается как JSON, отклоняется с 400 до идентификации.
Scenario: Чужой чат без заголовка
- WHEN клиент без
X-User-Idзапрашивает существующий чат - THEN ответ 401, а не 404
Scenario: Невалидное поле без заголовка
- WHEN клиент без
X-User-Idотправляет сообщение с{"text": ""} - THEN ответ 401, а не 400
Scenario: Битый JSON без заголовка
- WHEN клиент без
X-User-Idотправляет тело{bad - THEN ответ 400 с
codeinvalid_request
Requirement: Схема идентификации в документации API
Документация, которую отдаёт сервис (/openapi.json и /docs), SHALL
объявлять схему devUser так же, как contracts/openapi.json: apiKey
в заголовке X-User-Id. Защищённые операции SHALL ссылаться на неё,
публичные (POST /api/v1/users, health) MUST NOT. Объявление схемы
MUST NOT менять ответы: без заголовка по-прежнему 401, а не 400 или 403.
Scenario: Кнопка Authorize в Swagger
- WHEN разработчик открывает
/docs - THEN доступна кнопка Authorize с полем
X-User-Id, и введённое значение уходит заголовком в защищённые запросы
Scenario: Схема в openapi.json
- WHEN клиент запрашивает
/openapi.json - THEN
components.securitySchemes.devUserсовпадает с контрактом, уGET /api/v1/users/mesecurityравно[{"devUser": []}], а уPOST /api/v1/userssecurityнет