Propose verifying lab 5 grade 3 on SQLAlchemy

This commit is contained in:
Artyom
2026-11-06 09:16:40 +03:00
parent 02228a2847
commit f1ecb74dc4
4 changed files with 55 additions and 0 deletions
@@ -0,0 +1,3 @@
schema: spec-driven
created: 2026-11-06
skip_specs: true
@@ -0,0 +1,25 @@
## Context
Уровни 3/4 реализованы, сейчас требуется квалификация SQLAlchemy-кода. PostgreSQL — источник истины, S3 хранит байты, RabbitMQ — at-least-once транспорт. FastStream consumer использует manual ack после COMMIT результата, relay — confirms/mandatory/persistent.
## Goals / Non-Goals
Подтвердить пять пунктов уровня 3 на действительном стенде без повторной реализации. Итоговый REPORT не редактируется, заметки и ограничения передаются через evidence. Новые возможности pipeline версии 2 — следующий отдельный цикл.
## Decisions
- Project mtusi2026lab5, LB 18085, stats 25085, broker UI 25086; PostgreSQL/S3/AMQP наружу не публикуются. Локальные обращения исключаются из proxy через NO_PROXY.
- Все команды сохраняются capture_evidence.py с UTC, полным SHA и exit code. Новые артефакты лежат в отдельном каталоге и не перезаписывают старые измерения.
- Последовательность: проверки кода → сборка/готовность → smoke → persistence → failover/restore → suite level3 → негативные проверки унаследованных API → инфраструктурные наблюдения. Одновременных нагрузок нет.
- В доказательства отказов добавить фактические имена/ID и docker ps -a остановленных контейнеров. Сообщение очереди содержит только поля jobs.schema.json.
- Проверки уровней используют существующие hook и suite; сбои записываются даже при ненулевом exit. Исправляются только major: обязательный сценарий, безопасность, данные или доступность.
## Risks / Trade-offs
- Старые volumes могут содержать failed/DLQ → suite использует собственные ID и исходный размер DLQ; данные не очищаются.
- Перенесённый демонстратор reconciler ЛР4 ожидает 201 → сохраняется как minor и не используется для доказательства ЛР5.
- Один skipped RLIMIT_AS на macOS → ограничение памяти проверяется внутри Linux worker на уровне 4.
## Migration Plan
Дополнительных миграций для квалификации нет. Стенд останавливается без удаления volumes после всех последовательных циклов; промежуточные результаты коммитятся после make lint.
@@ -0,0 +1,19 @@
## Why
Уровень «3» реализован, но прежние evidence относятся к asyncpg. После переноса основы на SQLAlchemy/Alembic нужны реальные проверки актуального кода по всем пяти пунктам рубрики README.
## What Changes
Новый набор evidence: smoke, persistence, failover, минимальная совместимость вложений, топология брокера, остановленный worker, рестарт API/broker, дубли, retry и failed. При обнаружении обязательного неработающего сценария исправляется причина, не assertion. Старые результаты не перезаписываются.
## Capabilities
Новых или изменённых требований нет: проверяются lab5-attachment-pipeline, lab5-job-delivery и унаследованные контракты. skip_specs=true, поскольку это повторная квалификация существующего поведения.
## Impact
Обезличенные evidence/sqlalchemy-2026-11-06/grade3 и заметки для отдельного автора REPORT. Источник реализации: перенос snapshot ЛР4 d7478726a85791c21e065d58f610735a9e687433, HEAD 02228a2847f0d2292e827b98662d37651b267050. Строки будущего REPORT: все критерии «3» и наследование lab4.
## Non-goals
Уровни 4/5 в этом цикле, OTel/TLS и прочие Out of scope openspec/config.yaml. Итоговый REPORT, публикация и нагрузочная фаза выполняются отдельно.
@@ -0,0 +1,8 @@
## 1. Квалификация уровня 3
- [ ] 1.1 Добавить SHA и фактическое состояние контейнеров в результаты suite.
- [ ] 1.2 Выполнить make check/validate/lint/student-test и собрать стенд.
- [ ] 1.3 Выполнить smoke, persistence, failover и restore с реальными выводами.
- [ ] 1.4 Выполнить level3 suite и проверки унаследованного минимума lab4.
- [ ] 1.5 Сохранить топологию, лимиты, очереди и протокол ручного ack; оформить таблицу критериев и ограничения для REPORT.
- [ ] 1.6 Зафиксировать evidence и архивировать реально завершённый цикл.