Files
mtusi2026lab2/openspec/specs/data-storage/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

2.6 KiB

data-storage Specification

Purpose

Где живёт состояние мессенджера на лабе 1 и какие гарантии оно даёт: память одного процесса, потеря при рестарте, защита от гонок при параллельных запросах.

Requirements

Requirement: Состояние только в памяти одного процесса

Пользователи, чаты и сообщения SHALL храниться только в памяти одного процесса сервиса. Сервис MUST NOT использовать базы данных, Redis, файлы состояния и внешние сервисы. Все запросы экземпляра SHALL обслуживаться одним общим состоянием, без нескольких worker-процессов с независимой памятью.

Scenario: Созданное видно сразу

  • WHEN клиент создал пользователя и следующим запросом использует его id в X-User-Id
  • THEN пользователь найден

Requirement: Потеря состояния при рестарте

После перезапуска процесса состояние SHALL быть пустым. Это ожидаемое поведение лабы 1.

Scenario: Прежний пользователь после рестарта

  • WHEN сервис перезапущен и клиент использует X-User-Id, созданный до рестарта
  • THEN ответ 401

Requirement: Параллельные запросы не повреждают состояние

Параллельные запросы MUST NOT терять, дублировать или повреждать записи. Проверки с последующей записью (уникальность username) SHALL выполняться атомарно.

Scenario: 100 сообщений от 10 клиентов

  • WHEN 10 клиентов одновременно отправляют по 10 сообщений в один чат
  • THEN получено 100 ответов 201, а полный обход истории возвращает ровно 100 сообщений с уникальными id

Scenario: Гонка за username

  • WHEN несколько клиентов одновременно регистрируют одинаковый username
  • THEN создан ровно один пользователь