docs: archive attachments and sync its specs

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-21 02:28:30 +03:00
co-authored by Claude Opus 5.5
parent 6970dad871
commit d9d44c511c
16 changed files with 10 additions and 9 deletions
+9 -8
View File
@@ -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,
+1 -1
View File
@@ -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; под загрузками ничего подтверждённого не удалено |