4.1 KiB
Context
См. proposal.md. Единственный источник — immutable snapshot ЛР5 f88e9ba43c, база diff 64d5c67. ЛР6 содержит собственные OTel-порты, instrumentations и незакоммиченную инфраструктуру. Источник не изменяется.
Goals / Non-Goals
Сохранить бизнес-поведение и обновить основу без стирания OTel. Новые грейды, переработка наблюдаемости и нагрузочные измерения не входят в перенос.
Decisions
- Трёхстороннее слияние по файлам с разрешённым списком путей. Копирование поверх всего каталога отброшено: потеряло бы локальный OTel. За сохранение обоих наборов изменений платим ручным разрешением конфликтов.
- Перенести SQLAlchemy 2.0.45 и Alembic 1.16.5 из snapshot без новой схемы поверх уже проверенной. Порты UoW сохраняются, адаптеры зон используют ORM/Core и async_sessionmaker; shared содержит только engine, базу моделей и общую UoW. Получаем единый транзакционный механизм, цена — ORM-mapping и контроль RETURNING.
- Alembic принимает legacy-журнал только после проверки checksum и каталога схемы, под advisory lock. Миграции аддитивны; пользовательские строки и volumes не удаляются. Неизвестная схема останавливает мигратор.
- FastStream/aio-pika и ручной ack остаются: успешный handler завершает COMMIT до ack. OTel observer и контекст отложенных событий сохраняются при слиянии, SQL client spans остаются через instrumentation asyncpg под SQLAlchemy. SDK после fork, batch/periodic exporters и выключение OTEL_SDK_DISABLED не меняются.
- 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).