# 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 с `code` `conflict` #### 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** тело ответа равно телу ответа на его регистрацию