Files
mtusi2026lab4/openspec/changes/verify-lab4-grade3-sqlalchemy/design.md
T

2.3 KiB

Context

API перенесён на SQLAlchemy в 41700c27e5. Перенос проверен 404 собственными тестами и smoke; уровень 3 требует реальных отказов и persistence.

Goals / Non-Goals

Goals: повторяемые доказательства текущего кода. Non-goals: менять API или архитектуру.

Decisions

Новая серия evidence/sqlalchemy-2026-11-06/grade3. capture_evidence.py записывает UTC, полный SHA, команду, разрешённые параметры окружения, сырой stdout/stderr и exit code; существующий файл не перезаписывается. Абсолютный путь репозитория заменяется на . Скрипты доказательств принимают EVIDENCE_DIR, старые серии не удаляются.

Стенд hlpipe-lab4-grades-20261106 использует свежие именованные volumes, HTTP 18084, статистика 24844. Внутренние API/S3-порты не публикуются. Другие контейнеры не останавливаются. Данные сохраняются после make down. Источник метаданных — PostgreSQL, байтов — RustFS; intent → PUT под блокировкой → ready COMMIT не меняется. Границы портов зон прежние.

Порядок: check/lint/student-test → build → smoke → persistence → failover → upload-failover → три S3-outage наблюдения → негативные файлы → приватность и layout → LB/retry. Перестройка контейнеров между отказами только внутри выбранного project.

Risks / Trade-offs

Системный прокси macOS ломает loopback → NO_PROXY для localhost/127.0.0.1/::1. Доказательства могут завершиться раньше ошибки из pipe → capture проверяет исходный exit code. Старые цифры REPORT относятся к asyncpg → отдельные текущие заметки и явная маркировка старой серии.