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>
3.4 KiB
users Specification
Purpose
Регистрация пользователей мессенджера и получение текущего пользователя. Пользователь — участник чатов и отправитель сообщений.
Requirements
Requirement: Регистрация пользователя
POST /api/v1/users SHALL быть публичным и принимать тело
{"username": ..., "display_name": ...}. При успехе сервис SHALL
отвечать 201 с объектом User: id, username, display_name,
created_at, без других полей. id и created_at назначает сервер.
Scenario: Успешная регистрация
- WHEN клиент отправляет
{"username": "alice", "display_name": "Алиса"} - THEN ответ 201,
usernameиdisplay_nameсовпадают с отправленными,id— новый UUID
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: Уникальность 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со своимX-User-Id - THEN тело ответа равно телу ответа на его регистрацию