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>
2.6 KiB
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 создан ровно один пользователь