From 5f4b9ff61c4ff54417c1b014f2e572d6ce3e4560 Mon Sep 17 00:00:00 2001 From: roman Date: Thu, 22 Oct 2026 16:21:08 +0300 Subject: [PATCH] docs: archive upload-memory and sync its specs Co-Authored-By: Claude Opus 5.5 --- AGENTS.md | 11 ++++++----- PLAN.md | 2 +- .../2026-10-22-upload-memory}/.openspec.yaml | 0 .../2026-10-22-upload-memory}/design.md | 0 .../2026-10-22-upload-memory}/proposal.md | 0 .../specs/api-conventions/spec.md | 0 .../specs/attachments/spec.md | 0 .../specs/load-balancing/spec.md | 0 .../specs/load-benchmark/spec.md | 0 .../specs/service-configuration/spec.md | 0 .../specs/storage-consistency/spec.md | 0 .../specs/student-tests/spec.md | 0 .../2026-10-22-upload-memory}/tasks.md | 0 13 files changed, 7 insertions(+), 6 deletions(-) rename openspec/changes/{upload-memory => archive/2026-10-22-upload-memory}/.openspec.yaml (100%) rename openspec/changes/{upload-memory => archive/2026-10-22-upload-memory}/design.md (100%) rename openspec/changes/{upload-memory => archive/2026-10-22-upload-memory}/proposal.md (100%) rename openspec/changes/{upload-memory => archive/2026-10-22-upload-memory}/specs/api-conventions/spec.md (100%) rename openspec/changes/{upload-memory => archive/2026-10-22-upload-memory}/specs/attachments/spec.md (100%) rename openspec/changes/{upload-memory => archive/2026-10-22-upload-memory}/specs/load-balancing/spec.md (100%) rename openspec/changes/{upload-memory => archive/2026-10-22-upload-memory}/specs/load-benchmark/spec.md (100%) rename openspec/changes/{upload-memory => archive/2026-10-22-upload-memory}/specs/service-configuration/spec.md (100%) rename openspec/changes/{upload-memory => archive/2026-10-22-upload-memory}/specs/storage-consistency/spec.md (100%) rename openspec/changes/{upload-memory => archive/2026-10-22-upload-memory}/specs/student-tests/spec.md (100%) rename openspec/changes/{upload-memory => archive/2026-10-22-upload-memory}/tasks.md (100%) diff --git a/AGENTS.md b/AGENTS.md index fc3db632..26381ce1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -23,8 +23,9 @@ SeaweedFS с приватным bucket, bootstrap и клиент `src/infra/s3/ уборщик незавершённых загрузок — сервис `cleaner` (`python -m src.cleaner`, grace 900 с, свой пользователь S3 «чтение и удаление»), частичный индекс строк `pending`, новая capability -`storage-consistency`. Память и сроки загрузки — активный change -`upload-memory` (`openspec/changes/upload-memory/`): места загрузки на +`storage-consistency`. Память и сроки загрузки — change +`upload-memory` (заархивирован 2026-10-22, +`openspec/changes/archive/2026-10-22-upload-memory/`): места загрузки на процесс API (`[uploads]`: 4 места, очередь 16, ожидание 5 с, затем 429 `rate_limited` с `Retry-After`), срок тела 30 с (400), одна копия тела при PUT, буферы сокетов реплики 512 KiB и LB 256 / 128 KiB, `timeout server` @@ -41,9 +42,9 @@ LB пути загрузки 30 с, дренаж замены 90 с, профи — трек 2 лабы 2 (план запроса и восстановление), профили `failover` и `rollout`, серии трека 1 лабы 3 (`scaling-bench`, `scaling-improvement`, `profile-resources`). Changes лаб 2 и 3 и `s3-storage`, `attachments`, -`upload-consistency` лабы 4 — в `openspec/changes/archive/`; активен -один `upload-memory` (до archive), спеки синхронизированы, в том числе с -его дельтами (новые capability: с `s3-storage` — +`upload-consistency`, `upload-memory` лабы 4 — в +`openspec/changes/archive/`, активных нет, спеки синхронизированы +(новые capability: с `s3-storage` — `object-storage`, с `attachments` — `attachments`, с `upload-consistency` — `storage-consistency`); в `KNOWN_ISSUES.md` две открытые записи (bootstrap после удаления bucket; 408 LB на медленные заголовки текстом HAProxy). Отчёт, evidence и рабочий план лабы 3 остались в её diff --git a/PLAN.md b/PLAN.md index 91974741..06c6f713 100644 --- a/PLAN.md +++ b/PLAN.md @@ -230,7 +230,7 @@ RustFS. В `.claude/rules/settings.md` MinIO упомянут только пр | 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` для обеих реплик; правки 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; **код — `5b42bd2`; evidence 2026-10-21 с него: `evidence/attachments/consistency.md` и `cleaner-process.md`, `evidence/s3/cleaner-key.md`, `evidence/migrations/pending-index.md`, `evidence/tests/`; `REPORT.md` — раздел «Согласованность БД и S3», ответ на вопрос «PUT прошёл, COMMIT нет», строки уровня «4». Правки по verify (W1–W4, S1) — код `87c48b9`: пометка строки уборщиком до удаления объекта, тесты неизвестного COMMIT, загрузки дольше grace и сбоя уборки после удаления объекта; evidence 2026-10-21 с него: `evidence/tests/` (`failure_checks` 32 из 32, `student_test` 197, сверка 215 / 36, `test_isolated` 192 + 5 пропусков), `cleaner-process.md` раздел 7 (отказ S3 во время прохода); `REPORT.md` — пометка, остаточный риск и окно `rolling_update`. Правки по повторному verify (W1, S1, S2) — код `5889ca2`: уборщик в два шага, объект и строка одной транзакцией под блокировкой, смеси версий не хуже, чем до правки, порядок обновления; evidence 2026-10-21 с него: `evidence/tests/failure-checks.md` (32 из 32 за 228 с), `cleaner-process.md` раздел 7, S2 в `student-test-lb.md` (8 сценариев `storage-consistency`); `REPORT.md` — два шага, «Зачем DELETE объекта под блокировкой», смесь версий; заархивирован 2026-10-21** — `openspec/changes/archive/2026-10-21-upload-consistency/` | -| 4 | `upload-memory` | 4 | лимит загрузок на реплику, сроки тела, профиль `uploads` | замер ≥ 10 одновременных загрузок: пик памяти ограничен, механизм объяснён | +| 4 | `upload-memory` | 4 | лимит загрузок на реплику, сроки тела, профиль `uploads` | замер ≥ 10 одновременных загрузок: пик памяти ограничен, механизм объяснён; **код — `6cab9d3` (места загрузки, срок тела, одна копия тела при PUT, буферы и сроки LB) и `97a4be4` (буфер приёма LB от клиента 128 KiB); метка `evidence/uploads/baseline/` с `97a4be4` (commit `ce1ae2c`, принята с пометкой о swap хоста); evidence 2026-10-22: `evidence/uploads/lb-timeouts.md` и `rollout-upload.md`, `evidence/tests/` (`student_test` 198, `test_isolated` 193 + 5 пропусков); `REPORT.md` — «Память и сроки загрузки», гипотезы H1–H4 и выводы по метке. Правки по verify — код `9d2ee30`: разбор сводки профиля, спеки буфера LB и одной копии тела, срок тела «узкого» API 3 с; evidence с него: `evidence/tests/failure-checks.md` (37 из 37 за 263 с, commit `569a164`); заархивирован 2026-10-22** — `openspec/changes/archive/2026-10-22-upload-memory/` | | 5 | `track2-reconciler` | 5 | reconciler: dry-run / apply, классы расхождений, внедрение ошибок, доказательство безопасности | ошибки внесены с обеих сторон, обнаружены, исправлены; повторный запуск находит 0; под загрузками ничего подтверждённого не удалено | | 6 | `track2-reconcile-cost` | 5 | гипотезы, профиль стоимости обхода, стратегии, графики | метки в `evidence/`, выводы по гипотезам и ограничения в `REPORT.md` | | 7 | — (отчёт и PR) | 3–5 | сводка `REPORT.md`, чистый clone, шаблон PR, уборка этого файла | PR `ЛР 4 — БВТ2301 — Сафронов — на 5` | diff --git a/openspec/changes/upload-memory/.openspec.yaml b/openspec/changes/archive/2026-10-22-upload-memory/.openspec.yaml similarity index 100% rename from openspec/changes/upload-memory/.openspec.yaml rename to openspec/changes/archive/2026-10-22-upload-memory/.openspec.yaml diff --git a/openspec/changes/upload-memory/design.md b/openspec/changes/archive/2026-10-22-upload-memory/design.md similarity index 100% rename from openspec/changes/upload-memory/design.md rename to openspec/changes/archive/2026-10-22-upload-memory/design.md diff --git a/openspec/changes/upload-memory/proposal.md b/openspec/changes/archive/2026-10-22-upload-memory/proposal.md similarity index 100% rename from openspec/changes/upload-memory/proposal.md rename to openspec/changes/archive/2026-10-22-upload-memory/proposal.md diff --git a/openspec/changes/upload-memory/specs/api-conventions/spec.md b/openspec/changes/archive/2026-10-22-upload-memory/specs/api-conventions/spec.md similarity index 100% rename from openspec/changes/upload-memory/specs/api-conventions/spec.md rename to openspec/changes/archive/2026-10-22-upload-memory/specs/api-conventions/spec.md diff --git a/openspec/changes/upload-memory/specs/attachments/spec.md b/openspec/changes/archive/2026-10-22-upload-memory/specs/attachments/spec.md similarity index 100% rename from openspec/changes/upload-memory/specs/attachments/spec.md rename to openspec/changes/archive/2026-10-22-upload-memory/specs/attachments/spec.md diff --git a/openspec/changes/upload-memory/specs/load-balancing/spec.md b/openspec/changes/archive/2026-10-22-upload-memory/specs/load-balancing/spec.md similarity index 100% rename from openspec/changes/upload-memory/specs/load-balancing/spec.md rename to openspec/changes/archive/2026-10-22-upload-memory/specs/load-balancing/spec.md diff --git a/openspec/changes/upload-memory/specs/load-benchmark/spec.md b/openspec/changes/archive/2026-10-22-upload-memory/specs/load-benchmark/spec.md similarity index 100% rename from openspec/changes/upload-memory/specs/load-benchmark/spec.md rename to openspec/changes/archive/2026-10-22-upload-memory/specs/load-benchmark/spec.md diff --git a/openspec/changes/upload-memory/specs/service-configuration/spec.md b/openspec/changes/archive/2026-10-22-upload-memory/specs/service-configuration/spec.md similarity index 100% rename from openspec/changes/upload-memory/specs/service-configuration/spec.md rename to openspec/changes/archive/2026-10-22-upload-memory/specs/service-configuration/spec.md diff --git a/openspec/changes/upload-memory/specs/storage-consistency/spec.md b/openspec/changes/archive/2026-10-22-upload-memory/specs/storage-consistency/spec.md similarity index 100% rename from openspec/changes/upload-memory/specs/storage-consistency/spec.md rename to openspec/changes/archive/2026-10-22-upload-memory/specs/storage-consistency/spec.md diff --git a/openspec/changes/upload-memory/specs/student-tests/spec.md b/openspec/changes/archive/2026-10-22-upload-memory/specs/student-tests/spec.md similarity index 100% rename from openspec/changes/upload-memory/specs/student-tests/spec.md rename to openspec/changes/archive/2026-10-22-upload-memory/specs/student-tests/spec.md diff --git a/openspec/changes/upload-memory/tasks.md b/openspec/changes/archive/2026-10-22-upload-memory/tasks.md similarity index 100% rename from openspec/changes/upload-memory/tasks.md rename to openspec/changes/archive/2026-10-22-upload-memory/tasks.md