Files
mtusi2026lab6/openspec/specs/users/spec.md
T
ricoromaandClaude Opus 5.5 9cc6c0c7a6 chore: port lab 5 solution into the lab 6 skeleton
Source: mtusi2026lab5-safronov, solution/bvt2301-safronov, 046ec9e.
Contracts, public tests and evidence of lab 5 are not carried over.
The compose project, image and CI prefix are renamed to lab6; the first
broker start defect is recorded in KNOWN_ISSUES.md; PLAN.md outlines the
OpenSpec changes of lab 6.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 04:46:56 +03:00

5.9 KiB
Raw Blame History

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