Files
mtusi2026lab2/openspec/specs/users/spec.md
T
ricoromaandClaude Opus 5.5 7b775a29a9 chore: carry over lab 1 solution into lab 2 skeleton
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>
2026-09-30 22:11:46 +03:00

3.4 KiB
Raw Blame History

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 с 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 со своим X-User-Id
  • THEN тело ответа равно телу ответа на его регистрацию