29 lines
4.1 KiB
Markdown
29 lines
4.1 KiB
Markdown
## Context
|
|
|
|
См. proposal.md. Единственный источник — immutable snapshot ЛР5 f88e9ba43cdfd7eb6a5a7ae5feb4247b4e820071, база diff 64d5c67. ЛР6 содержит собственные OTel-порты, instrumentations и незакоммиченную инфраструктуру. Источник не изменяется.
|
|
|
|
## Goals / Non-Goals
|
|
|
|
Сохранить бизнес-поведение и обновить основу без стирания OTel. Новые грейды, переработка наблюдаемости и нагрузочные измерения не входят в перенос.
|
|
|
|
## Decisions
|
|
|
|
1. Трёхстороннее слияние по файлам с разрешённым списком путей. Копирование поверх всего каталога отброшено: потеряло бы локальный OTel. За сохранение обоих наборов изменений платим ручным разрешением конфликтов.
|
|
2. Перенести SQLAlchemy 2.0.45 и Alembic 1.16.5 из snapshot без новой схемы поверх уже проверенной. Порты UoW сохраняются, адаптеры зон используют ORM/Core и async_sessionmaker; shared содержит только engine, базу моделей и общую UoW. Получаем единый транзакционный механизм, цена — ORM-mapping и контроль RETURNING.
|
|
3. Alembic принимает legacy-журнал только после проверки checksum и каталога схемы, под advisory lock. Миграции аддитивны; пользовательские строки и volumes не удаляются. Неизвестная схема останавливает мигратор.
|
|
4. FastStream/aio-pika и ручной ack остаются: успешный handler завершает COMMIT до ack. OTel observer и контекст отложенных событий сохраняются при слиянии, SQL client spans остаются через instrumentation asyncpg под SQLAlchemy. SDK после fork, batch/periodic exporters и выключение OTEL_SDK_DISABLED не меняются.
|
|
5. Compose сохраняет OTel WIP, non-root, secrets через файлы, healthcheck и лимиты. API 18086; остальные опубликованные порты 26000–26999. Только свой project mtusi2026lab6, без удаления volumes. Никакой остановки чужих контейнеров.
|
|
|
|
## Risks / Trade-offs
|
|
|
|
- Конфликты UoW и OTel → make lint/student-test, включая наблюдателей, HTTP spans и миграции.
|
|
- Старые данные → тесты legacy upgrade со строками, идемпотентности и отказа при drift.
|
|
- Общий Docker host → записать фон и условия; smoke и функциональные тесты не выдавать за нагрузочный эксперимент.
|
|
- REPORT/evidence остаются неизменными → результаты переноса и ограничения остаются в verification.md для отдельного отчётного этапа.
|
|
|
|
## Migration Plan
|
|
|
|
Сохранить WIP и контрольные суммы защищённых файлов; перенести diff; обновить lockfile; проверить check/lint/student-test. Поднять собственный стенд с включённым SDK, выполнить smoke и повторный migrate. Остановить свой стенд без удаления volumes. Откат приложения возможен предыдущим образом при сохранённых данных; автоматический downgrade с удалением таблиц не выполняется.
|
|
|
|
Документация проверена через Context7: SQLAlchemy rel_2_0_45 (async_sessionmaker, pool) и Alembic rel_1_16_5 (async env, run_sync, stamp).
|