VEU.WathBody/1-docs/2-db/src/func_specs/migration_insert.md

src.migration_insert

Фиксация применённой миграции в журнале (пишет --mode migrate).

Параметр	Тип	Обяз.	Описание
p_filename	text	да	имя применённого psql-файла из 2-db\migrations\

Возвращает int — id записи журнала.

Логика/особенности: повтор имени — исключение UNIQUE (миграция считается неприменённой, если её нет в журнале; повторный вызов = ошибка процесса миграции, а не идемпотентное действие).

Пример вызова

SELECT src.migration_insert('0001_init.sql');

Тесты

№	Тип	Условие	Ожидаемый результат
1	основной сценарий	p_filename = 'TEST-0001.sql'	id > 0; строка в src.migration с applied_at ≈ now()
2	исключение	повтор p_filename = 'TEST-0001.sql'	исключение UNIQUE
3	исключение	p_filename = NULL	исключение NOT NULL