Files
mtusi2026lab3/openspec/changes/archive/2026-10-01-postgres-storage/specs/container-image/spec.md
T
ricoromaandClaude Opus 5.5 af4bca08c9 feat: carry lab 2 over and add X-Instance-Id and idempotency keys
- carry the lab 2 solution over and plan lab 3 (PLAN.md, OpenSpec
  change instance-id-idempotency)
- rename the compose project to mtusi-lab3 and the image to :lab3
- add X-Instance-Id to every response and instance_id to every log
  record ([app] instance_id, hostname by default)
- require Idempotency-Key on POST messages: keys table in Postgres,
  key and message in one transaction, replay returns the same 201,
  another body gets 409, TTL from [idempotency] ttl_seconds
- send the key from student-tests, k6 scenarios and the skill driver;
  add idempotency, X-Instance-Id, key race and fault tests

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-08 19:42:36 +03:00

2.5 KiB

Spec Delta

MODIFIED Requirements

Requirement: Сборка из чистого clone

docker build в корне свежего clone SHALL собирать образ без предварительных шагов: без make env_setup, без config.toml и .env. Зависимости SHALL устанавливаться строго по uv.lock. Если lock не соответствует pyproject.toml, сборка MUST завершаться ошибкой, а не пересчитывать версии.

Scenario: Свежий clone

  • WHEN в новом clone репозитория выполняется docker build -t mtusi-messenger:lab2 .
  • THEN образ собирается без ошибок

Scenario: Устаревший lock

  • WHEN в pyproject.toml добавлена зависимость, а uv.lock не обновлён
  • THEN сборка завершается ошибкой проверки lock

Requirement: Состав образа

Образ SHALL содержать только то, что нужно для работы сервиса и применения миграций: интерпретатор, зависимости времени выполнения, исходники src/, каталог миграций и конфигурацию инструмента миграций. В образе MUST NOT быть config.toml, .env, публичных и собственных тестов, контрактов, файлов .claude и openspec, а также инструментов сборки: uv и компиляторов.

Scenario: Нет конфигов и лишних каталогов

  • WHEN в образе просматривается рабочий каталог приложения
  • THEN в нём есть только исходники, миграции с их конфигурацией и окружение зависимостей, а config.toml и .env отсутствуют

Scenario: Нет uv в runtime

  • WHEN в контейнере запрашивается uv
  • THEN команда не найдена

Scenario: Миграции из образа

  • WHEN контейнер из этого образа запускается командой применения миграций с настройками подключения к Postgres
  • THEN миграции применяются без доступа к исходникам на хосте