Миграция: <Название Миграции>
Назначение
Опиши изменение схемы, данных, контрактов или read models, причину миграции и production risk.
Классификация
| Поле | Значение |
|---|
| Тип миграции | Schema / Data / Contract / Projection / ReferenceData |
| Сервис | <service-name> |
| Владелец | <team> |
| Риск | Low / Medium / High |
| Downtime | None / <window> |
| Backward compatible | Да/Нет |
Изменяемые Модели
| Модель/таблица/контракт | Изменение | Совместимость | Владелец |
|---|
<name> | <add/rename/remove/backfill> | <compatible/breaking> | <service> |
Новая Или Измененная Модель <ModelName>
| Поле | Тип | Обязательность | Default/backfill | Совместимость |
|---|
<FieldName> | <Type> | Да/Нет | <value/rule> | <old readers behavior> |
План Внедрения
| Шаг | Действие | Проверка | Откат |
|---|
| 1 | <deploy compatible readers> | <check> | <rollback action> |
| 2 | <apply schema change> | <check> | <rollback action> |
| 3 | <backfill> | <check> | <rollback action> |
| 4 | <enable writers> | <check> | <rollback action> |
План Backfill
| Аспект | Правило |
|---|
| Source | <source model/query> |
| Batch size | <number> |
| Ordering | <key/order> |
| Idempotency | <safe rerun rule> |
| Throttling | <limit> |
| Resume key | <checkpoint> |
Валидация Данных
| Проверка | Query/tool | Ожидание |
|---|
<check> | <query> | <expected count/range> |
Безопасность
| Риск | Контроль |
|---|
| Tenant leakage | Каждый migration query фильтрует или сохраняет TenantId. |
| PII exposure | Backfill logs исключают sensitive значения. |
Мониторинг
| Metric/Log | Порог | Действие |
|---|
<metric> | <threshold> | <rollback/pause/continue> |
Критерии Acceptance
- Migration можно безопасно повторить или остановить с typed checkpoint.
- Старые и новые версии приложения ведут себя согласно compatibility plan.
- Rollback и forward-fix пути описаны.
- Связанные API/event/entity docs обновлены.
Обратные ссылки
Автоссылки: где используется этот документ.