# Tasks Как строить — `design.md` (дальше «решение N»), что должно получиться — дельты в `specs/`. Перед первым файлом слоя прочитать его правило: `auth.md`, `migrations.md`, `infra.md`, `repo-layer.md`, `service-layer.md`, `dto.md`, `api-layer.md`, `api-contract.md`, `settings.md`, `student-tests.md`. Evidence снимается с закоммиченного кода, коммит — только после подтверждения пользователя (`bench.md`, «Измеренное состояние — commit»). ## 1. Зависимость и настройки - [x] 1.1 `uv add argon2-cffi` в основную группу. Проверка: `uv lock --check` проходит, `uv run python -c "import argon2; print(argon2.profiles.RFC_9106_LOW_MEMORY)"` печатает t=3, m=65536, p=4. - [x] 1.2 Секция `Auth` в `src/config/settings.py`: `session_ttl_seconds` и `kdf_concurrency` (решение 6), оба в `config_example.toml` и рабочем `config.toml`; `.env.example` и compose не трогаются. Проверка: `uv run python -c "from src.config import settings; print(settings.auth.session_ttl_seconds)"` — 3600 без строки в `config.toml`, 600 при `session_ttl_seconds = 600` в нём, 2 при `AUTH__SESSION_TTL_SECONDS=2` в окружении поверх файла; `AUTH__SESSION_TTL_SECONDS=abc` и `0` — ошибка проверки настроек. ## 2. Схема - [x] 2.1 Модель `Session` (`src/infra/db/models/session.py`), `password_hash` в `User` с `CHECK` (решение 1). Проверка: `Base.metadata.sorted_tables` — пять таблиц, у ограничений есть имена. - [x] 2.2 Ревизия по решению 7: очистка лабы 1 с `warning` и числом пользователей, колонка, таблица; `downgrade` зеркалит `upgrade`. Проверка: на базе с данными лабы 1 `make upgrade` пишет число удалённых пользователей, повторный `make upgrade` ничего не пишет и не удаляет; `alembic downgrade 16c279725564` и снова `upgrade head` проходят; `alembic check` — «No new upgrade operations detected». ## 3. Пароль, repo и сервисы - [x] 3.1 `src/infra/password.py` (решение 3): профиль явно, `CapacityLimiter`, фиктивный хэш. Проверка: разовым скриптом верный пароль проходит, изменённый в последнем из 128 кириллических символов — нет; 20 одновременных хэшей при `kdf_concurrency=4` идут не больше чем по 4. - [x] 3.2 DTO (`dto.md`): `UserFullDTO` без хэша, отдельный DTO учётных данных для входа, `SessionDTO`, `CurrentSessionDTO`. Repo `user`: вставка с хэшем, учётные данные по username. Repo `session`: вставка, проверка токена одним `SELECT` с `JOIN` (решение 2), удаление по `id`. Проверка: `make lint`; `EXPLAIN` проверки токена идёт по уникальному индексу `token_hash`. - [x] 3.3 `UserService.register` с паролем (хэш до БД), без `identify`; `SessionService`: `login` (две транзакции, решение 3), `authenticate`, `revoke`; исключения `InvalidCredentials` и `Unauthenticated` вместо `Unidentified`; логи по спеку `service-logging`. Проверка: `grep -rn "Unidentified\|X-User-Id\| USER_ID_HEADER" src` пусто, `make lint` чистый. ## 4. API - [x] 4.1 `dependencies.py` (решения 4, 5): разбор Basic с ранним отсевом, `get_current_session` на `HTTPBearer`, `get_current_user` из неё; `errors.py` — `WWW-Authenticate` по типу исключения. Проверка: на `make run_dev` `GET /api/v1/users/me` без заголовка, с Basic и с неизвестным Bearer — 401 с `Bearer realm="messenger"`. - [x] 4.2 `CreateUser` с `password` (12–128, не только пробелы, `StrictStr`); роутер `session.py`: `POST /auth/sessions` 201 `Session`, `DELETE /auth/sessions/current` 204. Проверка: `make test` против `make run_dev` — `PASS`. - [x] 4.3 Документация API: `/openapi.json` объявляет `bearerAuth` и `basicAuth` как контракт, без `devUser` (спек `identification`). Проверка: `security` у `GET /api/v1/users/me`, `POST /api/v1/auth/sessions` и `POST /api/v1/users` — как в сценарии «Схема в openapi.json»; в `/docs` вход и запрос через Authorize работают с паролем из ASCII. ## 5. Собственные тесты - [x] 5.1 `api_client.py` (решение 8): токен в `Actor`, `register` с паролем и входом, `login`, `unregistered()` со случайным токеном, хелпер тела регистрации; тела регистрации в `test_users.py`, `test_race.py`, `test_rubric.py` — через него. Проверка: `make student_test` против `make run_dev` — тесты поведения лабы 1 проходят без правки ожиданий. - [x] 5.2 `test_identification.py` по дельте `identification`, `test_sessions.py` по `sessions`, тесты сценариев `users` («Нет пароля», «Граница длины пароля», «Пароль из пробелов», «Длинный пароль в UTF-8 целиком»), `health` («Неизвестный токен») и рубрики `student-tests` («Неверный пароль в рубрике», «Logout в рубрике»). Проверка: против `make run_dev` все проходят. Тесты отказов (401) проверены на ложную зелень: временная поломка в `SessionService.authenticate` (принять любой токен) роняет их, после отката правки они снова зелёные. - [x] 5.3 `/opsx:sync` и в том же шаге `spec_coverage.py`: `sessions` — в список отслеживаемых capability; исключения для сценариев, которые не проверить на обычном стенде: «Истёкший токен», «Срок не продлевается», «Прежний токен после рестарта», «БД остановлена при запросе с токеном», «Токена нет в хранилище» (`sessions`), «Хэш в БД» (`users`) — со ссылкой на evidence и `failure-checks`; текст исключения «Прежний пользователь после рестарта» — про токен; «Кнопка Authorize в Swagger» — про `bearerAuth` и `basicAuth` вместо `devUser`. Спеки `service-configuration`, `container-run` и `db-migrations` проверяются evidence, в сверку не входят. Purpose основного спека `identification` переписать руками: в нём «с лабы 2 её заменяет Bearer». Проверка: `make student_test` — все тесты прошли, в том числе `test_coverage.py`; `openspec validate --specs` без ошибок. ## 6. Инструменты и документы - [ ] 6.1 Скилл `run-mtusi-messenger`: `driver.py` регистрирует с паролем, входит и ходит с Bearer, `req --token` вместо `--user`; `SKILL.md` без `X-User-Id` и известных падений. Проверка: `python3 .claude/skills/run-mtusi-messenger/driver.py all` — `FAILED: none`, smoke `PASS`, student — все прошли. - [x] 6.2 `auth.md` — выбранные решения (сессии в PostgreSQL, отзыв удалением, лимит KDF, `HTTPBase` для `basicAuth`); `AGENTS.md` — «Переходное состояние» без пунктов про `X-User-Id`, `devUser`, `identification`/`users` и закрытых сценариев `session-auth`, карта кода (`session.py` во всех слоях, `infra/password.py`). Проверка: `grep -rn "X-User-Id" AGENTS.md .claude` — только история лабы 1 и правило, что он игнорируется. - [x] 6.3 Финальная проверка кода: `make lint`, `make check`, `openspec validate session-auth --strict`, `make test_isolated` — код 0. Затем показать изменения, предложить сообщение и после подтверждения пользователя закоммитить. ## 7. Evidence и отчёт - [ ] 7.1 Evidence по таблице решения 9 с закоммиченного кода. Проверка: в каждом файле дата, commit, стенд; паролей, токенов и `Authorization` в файлах нет; `drop-lab1-data.md` снят на рабочей базе до её очистки. - [ ] 7.2 `REPORT.md`: Argon2id и его параметры, сессии и их хранение, `SESSION_TTL_SECONDS` и `SESSION_STORE=postgres` в таблице соответствия, сценарий защиты (миграции → вход → сообщение → `make test-persistence` → logout), строки доказательств уровня «3» и logout/неверного пароля уровня «4» со ссылками на evidence, предупреждение об очистке данных лабы 1, удаление закрытых TODO. Проверка: у каждой строки таблицы доказательств есть команда, наблюдение и файл. - [ ] 7.3 `make lint`, `make check`, `openspec validate session-auth --strict`, `graphify update .`; показать изменения и после подтверждения пользователя закоммитить evidence и отчёт.