diff --git a/AGENTS.md b/AGENTS.md index e30fe08e..1f51417c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -12,9 +12,11 @@ S3-совместимое хранилище и вложения-изображ следующую лабу». S3 в стенде — change `s3-storage` (заархивирован 2026-10-20, `openspec/changes/archive/2026-10-20-s3-storage/`): SeaweedFS с приватным bucket, bootstrap и клиент `src/infra/s3/`. -Вложения — change `attachments` (активный): ручки загрузки, метаданных -и скачивания, структурная проверка PNG/JPEG, `attachment_ids` в -сообщениях, таблицы `attachments` и `message_attachments`. План работ, решения и +Вложения — change `attachments` (заархивирован 2026-10-21, +`openspec/changes/archive/2026-10-21-attachments/`): ручки загрузки, +метаданных и скачивания, структурная проверка PNG/JPEG, +`attachment_ids` в сообщениях, таблицы `attachments` и +`message_attachments`. План работ, решения и трек «5» — `PLAN.md`. Из лабы 2: PostgreSQL как источник истины, вход по Basic → Bearer-сессия, Valkey — кэш карточек чатов. Из лабы 3: HAProxy перед ≥2 репликами API @@ -25,11 +27,10 @@ SeaweedFS с приватным bucket, bootstrap и клиент `src/infra/s3/ строгие курсор и UUID на входе (`strict-id-validation`). Стенд `bench/` — трек 2 лабы 2 (план запроса и восстановление), профили `failover` и `rollout`, серии трека 1 лабы 3 (`scaling-bench`, `scaling-improvement`, -`profile-resources`). Changes лаб 2 и 3 и `s3-storage` лабы 4 — в -`openspec/changes/archive/`, спеки синхронизированы (с `s3-storage` — -новая capability `object-storage`); дельты активного `attachments` -уже синхронизированы в основные спеки (новая capability `attachments`); -в `KNOWN_ISSUES.md` одна открытая запись (bootstrap после удаления +`profile-resources`). Changes лаб 2 и 3 и `s3-storage`, `attachments` +лабы 4 — в `openspec/changes/archive/`, активных нет, спеки +синхронизированы (новые capability: с `s3-storage` — `object-storage`, +с `attachments` — `attachments`); в `KNOWN_ISSUES.md` одна открытая запись (bootstrap после удаления bucket). Отчёт, evidence и рабочий план лабы 3 остались в её репозитории (`REPORT.md`, `evidence/`, `git show 063eedb:PLAN.md`). Стек: Python 3.12, uv, FastAPI, pydantic v2, pydantic-settings, diff --git a/PLAN.md b/PLAN.md index 133cf601..d588a1f0 100644 --- a/PLAN.md +++ b/PLAN.md @@ -228,7 +228,7 @@ RustFS. В `.claude/rules/settings.md` MinIO упомянут только пр |---|---|---|---|---| | 0 | — (подготовка) | — | этот план; выбор трека и S3-сервера | план сохранён 2026-10-20; трек 2, SeaweedFS, решения 3 и 7 подтверждены 2026-10-20 | | 1 | `s3-storage` | 3 (+4: bootstrap, права, консоль, приватность) | S3 в стенде, bootstrap, клиент в `src/infra/s3/`, настройки, все стенды знают о S3 | bootstrap дважды без ошибок, анонимный GET / LIST → 403, ключ API не может admin-операций, `make test-persistence` перезапускает и S3; **заархивирован 2026-10-20** — `openspec/changes/archive/2026-10-20-s3-storage/` | -| 2 | `attachments` | 3 (+4: тесты) | миграция, домен `attachment`, ручки, `attachment_ids` в сообщениях, тесты | зелёные `make test`, `test-persistence`, `test-failover`, свой сценарий отказа загрузившей реплики; негативные тесты; evidence исключений переснят; **код — `116d8d3`, гонка `bench_restore` — `d56b892`; evidence 2026-10-20 с `d56b892`: `evidence/attachments/`, исключения, `evidence/tests/` (196 / 191 + 5 пропусков / 23 из 23), `test-failover` для обеих реплик, `bench_rollout` `attachments` (ошибок 0, 12 001 = 12 001)** | +| 2 | `attachments` | 3 (+4: тесты) | миграция, домен `attachment`, ручки, `attachment_ids` в сообщениях, тесты | зелёные `make test`, `test-persistence`, `test-failover`, свой сценарий отказа загрузившей реплики; негативные тесты; evidence исключений переснят; **код — `116d8d3`, гонка `bench_restore` — `d56b892`; evidence 2026-10-20 с `d56b892`: `evidence/attachments/`, исключения, `evidence/tests/` (196 / 191 + 5 пропусков / 23 из 23), `test-failover` для обеих реплик; правки verify — `dba40bc`, после них `student_test` 197 и `failure_checks` 24 из 24, `bench_rollout` `attachments` переснят с `e1f8531` на чистом дереве (8,67 с, ошибок 0, 12 001 = 12 001); заархивирован 2026-10-21** — `openspec/changes/archive/2026-10-21-attachments/` | | 3 | `upload-consistency` | 4 | намерение до PUT, компенсация, уборщик с grace period, тесты отказов | `make failure_checks` с отказами S3 и БД посреди загрузки: нет 500, нет неучтённых объектов старше grace period | | 4 | `upload-memory` | 4 | лимит загрузок на реплику, сроки тела, профиль `uploads` | замер ≥ 10 одновременных загрузок: пик памяти ограничен, механизм объяснён | | 5 | `track2-reconciler` | 5 | reconciler: dry-run / apply, классы расхождений, внедрение ошибок, доказательство безопасности | ошибки внесены с обеих сторон, обнаружены, исправлены; повторный запуск находит 0; под загрузками ничего подтверждённого не удалено | diff --git a/openspec/changes/attachments/.openspec.yaml b/openspec/changes/archive/2026-10-21-attachments/.openspec.yaml similarity index 100% rename from openspec/changes/attachments/.openspec.yaml rename to openspec/changes/archive/2026-10-21-attachments/.openspec.yaml diff --git a/openspec/changes/attachments/design.md b/openspec/changes/archive/2026-10-21-attachments/design.md similarity index 100% rename from openspec/changes/attachments/design.md rename to openspec/changes/archive/2026-10-21-attachments/design.md diff --git a/openspec/changes/attachments/proposal.md b/openspec/changes/archive/2026-10-21-attachments/proposal.md similarity index 100% rename from openspec/changes/attachments/proposal.md rename to openspec/changes/archive/2026-10-21-attachments/proposal.md diff --git a/openspec/changes/attachments/specs/api-conventions/spec.md b/openspec/changes/archive/2026-10-21-attachments/specs/api-conventions/spec.md similarity index 100% rename from openspec/changes/attachments/specs/api-conventions/spec.md rename to openspec/changes/archive/2026-10-21-attachments/specs/api-conventions/spec.md diff --git a/openspec/changes/attachments/specs/attachments/spec.md b/openspec/changes/archive/2026-10-21-attachments/specs/attachments/spec.md similarity index 100% rename from openspec/changes/attachments/specs/attachments/spec.md rename to openspec/changes/archive/2026-10-21-attachments/specs/attachments/spec.md diff --git a/openspec/changes/attachments/specs/data-storage/spec.md b/openspec/changes/archive/2026-10-21-attachments/specs/data-storage/spec.md similarity index 100% rename from openspec/changes/attachments/specs/data-storage/spec.md rename to openspec/changes/archive/2026-10-21-attachments/specs/data-storage/spec.md diff --git a/openspec/changes/attachments/specs/db-migrations/spec.md b/openspec/changes/archive/2026-10-21-attachments/specs/db-migrations/spec.md similarity index 100% rename from openspec/changes/attachments/specs/db-migrations/spec.md rename to openspec/changes/archive/2026-10-21-attachments/specs/db-migrations/spec.md diff --git a/openspec/changes/attachments/specs/idempotency/spec.md b/openspec/changes/archive/2026-10-21-attachments/specs/idempotency/spec.md similarity index 100% rename from openspec/changes/attachments/specs/idempotency/spec.md rename to openspec/changes/archive/2026-10-21-attachments/specs/idempotency/spec.md diff --git a/openspec/changes/attachments/specs/load-benchmark/spec.md b/openspec/changes/archive/2026-10-21-attachments/specs/load-benchmark/spec.md similarity index 100% rename from openspec/changes/attachments/specs/load-benchmark/spec.md rename to openspec/changes/archive/2026-10-21-attachments/specs/load-benchmark/spec.md diff --git a/openspec/changes/attachments/specs/messages/spec.md b/openspec/changes/archive/2026-10-21-attachments/specs/messages/spec.md similarity index 100% rename from openspec/changes/attachments/specs/messages/spec.md rename to openspec/changes/archive/2026-10-21-attachments/specs/messages/spec.md diff --git a/openspec/changes/attachments/specs/service-configuration/spec.md b/openspec/changes/archive/2026-10-21-attachments/specs/service-configuration/spec.md similarity index 100% rename from openspec/changes/attachments/specs/service-configuration/spec.md rename to openspec/changes/archive/2026-10-21-attachments/specs/service-configuration/spec.md diff --git a/openspec/changes/attachments/specs/service-logging/spec.md b/openspec/changes/archive/2026-10-21-attachments/specs/service-logging/spec.md similarity index 100% rename from openspec/changes/attachments/specs/service-logging/spec.md rename to openspec/changes/archive/2026-10-21-attachments/specs/service-logging/spec.md diff --git a/openspec/changes/attachments/specs/student-tests/spec.md b/openspec/changes/archive/2026-10-21-attachments/specs/student-tests/spec.md similarity index 100% rename from openspec/changes/attachments/specs/student-tests/spec.md rename to openspec/changes/archive/2026-10-21-attachments/specs/student-tests/spec.md diff --git a/openspec/changes/attachments/tasks.md b/openspec/changes/archive/2026-10-21-attachments/tasks.md similarity index 100% rename from openspec/changes/attachments/tasks.md rename to openspec/changes/archive/2026-10-21-attachments/tasks.md