--- name: onec-transactions-and-locks description: "Проектирует и проверяет транзакции, управляемые блокировки (БлокировкаДанных), контроль отрицательных остатков, кэширование и часовые пояса в 1С:Предприятии. Используй при проведении документов, параллельной работе пользователей, списании запасов/резервов и устранении взаимоблокировок или гонок." --- # Транзакции, управляемые блокировки и контроль остатков Используй навык, когда операция 1С читает остатки/лимиты и принимает решение о записи или проведении, выполняется параллельно несколькими пользователями или фоновыми заданиями, использует явные транзакции либо кэширует расчётные данные. Чтение метаданных регистров, режима управления блокировками и модулей проведения выполняй через `edt-mcp`. ## Сначала проверь режим блокировок и контекст транзакции Через `get_configuration_properties` и `get_metadata_details` установи: - режим управления блокировкой данных конфигурации и затронутых объектов (`Управляемый` или `Автоматический`); - вызывается ли код внутри уже открытой платформенной транзакции (`ОбработкаПроведения`, `ПередЗаписью`, `ПриЗаписи`) или из внешней серверной процедуры. В `ОбработкаПроведения` платформа **уже открыла транзакцию**: повторный `НачатьТранзакцию()` создаёт лишь вложенный уровень и не фиксирует изменения в СУБД до завершения внешнего проведения, тогда как непарный вызов или проглоченное исключение без `ОтменитьТранзакцию()` нарушает контракт транзакции. ## Управляемая блокировка до ответственного чтения Обычный запрос к таблице остатков в управляемом режиме читает зафиксированные данные без блокировки конкурентов: два параллельных сеанса увидят один и тот же свободный остаток `10 шт.` и оба спишут по `10 шт.`, образовав `-10 шт.`. 1. **Порядок «сначала заблокируй — потом прочитай»**: создай `Новый БлокировкаДанных`, добавь элементы блокировки по пространствам регистров в едином каноническом порядке (по алфавиту полных имён метаданных, чтобы исключить встречные взаимоблокировки `Deadlock`), заполни измерения из набора записей или таблицы значений (`ИсточникДанных`) и вызови `Блокировка.Заблокировать()` **до** запроса контроля остатков. 2. **Точность измерений**: блокируй только фактически изменяемые комбинации измерений (например, `Организация`, `Склад`, `Номенклатура`, `Серия`). Пустое измерение в элементе управляемой блокировки расширяет блокировку на все значения этого измерения и парализует работу соседних складов или менеджеров. 3. **Агрегация строк документа**: перед проверкой остатка сверни табличную часть по ключу измерений регистра. Две строки одного товара по `6 шт.` при остатке `10 шт.` пройдут построчную проверку по отдельности, но дадут дефицит `-2 шт.` в сумме. ## Новая и классическая методики контроля остатков Различай момент запроса к регистру относительно записи движений текущего документа: | Методика | Порядок действий | Главная ловушка | |---|---|---| | **Контроль после записи движений** (рекомендуемая для типовых регистров остатков) | Сформировать наборы движений → установить управляемую блокировку → `Движения.Записать()` → проверить отсутствие строк с `КоличествоОстаток < 0` в виртуальной таблице `Остатки(МоментВремени() / Граница(..., Включая))` по товарам документа → при дефиците выставить `Отказ = Истина` | Запрос без `Граница(..., ВидГраницы.Включая)` на момент документа не увидит только что записанный расход самого документа или пропустит будущие отрицательные точки на оси времени | | **Контроль до записи движений** | Установить управляемую блокировку → прочитать доступный остаток без старых движений перепроводимого документа (`Регистратор <> &Ссылка` или предварительное очищение) → сравнить со свёрнутой потребностью | Забытый прежний вклад этого же документа при перепроведении ложно удваивает расход и блокирует сохранение уменьшенного количества | При `Отказ = Истина` внутри `ОбработкаПроведения` платформа сама откатывает записанные в этой транзакции движения; не оставляй побочных записей вне транзакции. ## Внешние вызовы и длительные действия — строго вне транзакции Никогда не выполняй внутри открытой транзакции (`НачатьТранзакцию() ... ЗафиксироватьТранзакцию()`, `ОбработкаПроведения`, `ПередЗаписью`, `ПриЗаписи`): - синхронные вызовы HTTP/Web-сервисов, отправку почты, обращение к внешним СУБД или очередям сообщений; - ожидание файловых сетевых ресурсов, торгового оборудования или генерацию тяжёлых внешних файлов; - обращение к LLM/внешним API распознавания. Сетевой таймаут внутри транзакции удерживает блокировки таблиц СУБД для всех пользователей кластера, а откат транзакции после уже отправленного внешнего HTTP-запроса создаёт неустранимое расхождение систем. Используй двухфазную схему (регистрация задания в регистре очереди внутри транзакции → отправка фоновым заданием вне транзакции). ## Полнота ключа кэша и границы дат / часовых поясов - При использовании модулей `ПовтИсп` или прикладного кэша проверяй **полноту ключа**: если результат зависит от организации, валюты, даты среза, склада или прав текущего пользователя (RLS), все эти параметры обязаны входить в аргументы закэшированной функции. При частичной ошибке расчёта не сохраняй неполный результат в кэш как успешный. - Различай `ТекущаяДата()` (время клиентского компьютера, ненадёжное для учёта) и `ТекущаяДатаСеанса()` (серверное время с учётом часового пояса сеанса). Границы суток (`НачалоДня`, `КонецДня`) и запрета изменений вычисляй в часовом поясе хозяйственной операции / организации, а не произвольного фонового процесса. ## Чем доказывается надёжность Чтение модуля или одиночный прогон одного документа не доказывают защиту от гонки. Проверь: - перепроведение уже проведённого документа с тем же, меньшим и большим количеством; - документ с двумя строками одной номенклатуры; - конкурентную попытку списания одного остатка из двух пересекающихся сеансов (один должен зафиксировать списание, второй — получить предметный отказ без отрицательного остатка в регистре).