Source: mtusi2026lab4-safronov, solution/bvt2301-safronov, 2546deb. Contracts, public tests and evidence of lab 4 are not carried over. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
5.9 KiB
users Specification
Purpose
Регистрация пользователей мессенджера и получение текущего пользователя. Пользователь — участник чатов и отправитель сообщений.
Requirements
Requirement: Регистрация пользователя
POST /api/v1/users SHALL быть публичным и принимать тело
{"username": ..., "display_name": ..., "password": ...}. При успехе
сервис SHALL отвечать 201 с объектом User: id, username,
display_name, created_at, без других полей: пароля и его хэша в
ответе нет. id и created_at назначает сервер.
Scenario: Успешная регистрация
- WHEN клиент отправляет
{"username": "alice", "display_name": "Алиса", "password": ...}с допустимым паролем - THEN ответ 201,
usernameиdisplay_nameсовпадают с отправленными,id— новый UUID, полей кроме четырёх полейUserнет
Requirement: Формат username
username SHALL целиком соответствовать ^[a-z0-9_]{3,32}$. Иначе
сервис SHALL отвечать 400 invalid_request.
Scenario: Заглавные буквы
- WHEN
usernameравенAlice - THEN ответ 400
Scenario: Слишком короткий
- WHEN
usernameравенab - THEN ответ 400
Scenario: Перевод строки в конце
- WHEN
usernameравен"alice\n" - THEN ответ 400
Requirement: Формат display_name
display_name SHALL содержать от 1 до 100 Unicode code points и MUST
NOT состоять только из пробельных символов. Значение SHALL сохраняться
без изменений, в том числе без обрезки пробелов.
Scenario: Граница длины
- WHEN
display_nameиз 100 code points, затем из 101 - THEN первый запрос даёт 201, второй — 400
Scenario: Только пробелы
- WHEN
display_nameравен" " - THEN ответ 400
Requirement: Формат пароля
password SHALL содержать от 12 до 128 Unicode code points и MUST NOT
состоять только из пробельных символов. Допустимы любые символы
Unicode, в том числе :. Значение SHALL использоваться без изменений:
без обрезки, нормализации и усечения по байтам. Иначе сервис SHALL
отвечать 400 invalid_request.
Scenario: Нет пароля
- WHEN тело регистрации не содержит
password - THEN ответ 400
Scenario: Граница длины пароля
- WHEN
passwordиз 11 code points, затем из 12, из 128 и из 129 - THEN первый и последний запросы дают 400, остальные — 201
Scenario: Пароль из пробелов
- WHEN
passwordиз 12 пробелов - THEN ответ 400
Scenario: Длинный пароль в UTF-8 целиком
- WHEN пользователь зарегистрировался с паролем из 128 кириллических символов, затем входит с паролем, где изменён только последний символ
- THEN вход отклонён 401: пароль сравнивается целиком, а не по первым байтам
Requirement: Пароль хранится только хэшем
Сервис SHALL хранить пароль только как результат библиотечного password KDF с солью. Пароль MUST NOT храниться в открытом виде или как быстрый хэш (SHA-256 и подобные) и MUST NOT попадать в ответы API и журнал.
Scenario: Хэш в БД
- WHEN пользователь зарегистрирован с паролем P
- THEN в его строке в PostgreSQL нет P, а хранимое значение — строка KDF с параметрами и солью; у двух пользователей с одинаковым паролем хранимые значения разные
Requirement: Уникальность username
username SHALL быть уникальным. Повторная регистрация занятого
username SHALL давать 409 с code conflict. При одновременной
регистрации одного username несколькими клиентами MUST успешно
завершиться ровно одна.
Scenario: Повтор username
- WHEN клиент повторно регистрирует уже занятый
username - THEN ответ 409 с
codeconflict
Scenario: Одновременная регистрация
- WHEN 10 клиентов одновременно регистрируют одинаковый
username - THEN ровно один получает 201, остальные — 409
Requirement: Текущий пользователь
GET /api/v1/users/me SHALL возвращать 200 с объектом User владельца
сессии, чей токен передан (capability identification).
Scenario: Совпадает с регистрацией
- WHEN пользователь запрашивает
GET /api/v1/users/meсо своим токеном - THEN тело ответа равно телу ответа на его регистрацию