nixel2007 · Sep 29, 2026 · Sep 29, 2026 · Sep 29, 2026 · Sep 29, 2026
diff --git a/docs/README.md b/docs/README.md
@@ -60,6 +60,7 @@
 #### Параметр
 ```bsl
 // Получает и возвращает значение из индекса параметров
+// Индекс строится один раз в Прочитать(), чтение потокобезопасно и выполняется без блокировок
 //
 // Параметры:
 //   ИмяПараметра        - Строка - имя параметра
@@ -85,6 +86,8 @@
 #### ПрочитанныеПараметры
 ```bsl
 // Возвращает соответствие прочитанных параметров (сырой результат без обработки конструктором)
+// Изменения возвращенного соответствия не попадают в Параметр(): индекс параметров
+// строится в Прочитать(), для применения изменений нужно повторно вызвать Прочитать()
 //
 // Возвращаемое значение:
 //   Соответствие - прочитанные параметры
@@ -95,6 +98,9 @@
 #### Прочитать
 ```bsl
 // Выполняет чтения параметров из доступных провайдеров
+// Новый индекс параметров строится полностью и только потом подменяет прежний,
+// поэтому Параметр() можно вызывать параллельно с Прочитать(): до подмены читается прежний индекс.
+// Параллельные вызовы Прочитать() между собой не поддерживаются
 //
 ```
 

diff --git a/packagedef b/packagedef
@@ -4,7 +4,7 @@
 //
 
 Описание.Имя("configor")
-        .Версия("0.12.0")
+        .Версия("0.12.1")
         .Автор("Khorev Aleksey")
         .АдресАвтора("Khorevaa@gmail.com")
         .Описание("Библиотека для работы с конфигурационными файлами в формате json, yaml")

diff --git a/src/Классы/internal/Классы/ИндексЗначений.os b/src/Классы/internal/Классы/ИндексЗначений.os
@@ -2,68 +2,80 @@
 #Использовать logos
 
 Перем Лог;
-Перем ИндексКоллекция; // Соответствие
-Перем ИндексСформирован; // Булево
-Перем КоллекцияИндекса; // Произвольный
+Перем ИндексКоллекция; // Соответствие - опубликованный индекс, Неопределено - коллекция не установлена.
+                       // Строится целиком в локальную карту и публикуется одним присваиванием,
+                       // после публикации не изменяется: читается без блокировок из любых потоков
 
 Функция Коллекция(Знач ВходящаяКоллекция) Экспорт
 
-	КоллекцияИндекса = ВходящаяКоллекция;
-	ИндексСформирован = Ложь;
+	НовыйИндекс = ПостроитьИндекс(ВходящаяКоллекция);
+
+	// Читатели видят либо прежний индекс, либо новый целиком
+	ИндексКоллекция = НовыйИндекс;
 
 	Возврат ЭтотОбъект;
 
 КонецФункции
 
 Процедура Очистить() Экспорт
 
-	КоллекцияИндекса = Неопределено;
-	ИндексСформирован = Ложь;
+	ИндексКоллекция = Неопределено;
 
 КонецПроцедуры
 
+// Возвращает опубликованный индекс. Индекс общий для всех потоков, изменять его нельзя
+//
+// Возвращаемое значение:
+//   Соответствие - плоский индекс значений коллекции
+//
 Функция ПолучитьИндекс() Экспорт
 
-	ПроверитьИндекс();
-
-	Возврат ИндексКоллекция;
+	Возврат ОпубликованныйИндекс();
 
 КонецФункции
 
 Функция Значение(Знач КлючИндекса) Экспорт
 
-	ПроверитьИндекс();
+	Индекс = ОпубликованныйИндекс();
 
 	Если ТипЗнч(КлючИндекса) = Тип("Строка") Тогда
 		КлючИндекса = НРег(КлючИндекса);
 	КонецЕсли;
 
-	ЗначениеИзИндекса = ИндексКоллекция[КлючИндекса];
+	ЗначениеИзИндекса = Индекс[КлючИндекса];
 
 	Возврат ЗначениеИзИндекса;
 
 КонецФункции
 
-Процедура СформироватьИндекс()
+Функция ПостроитьИндекс(Знач ИсходнаяКоллекция)
 
-	ИндексКоллекция = Новый Соответствие;
+	Индекс = Новый Соответствие;
 
 	// Рекурсивный вызов для входящих параметров
-	ДобавитьЗначениеПараметра("", КоллекцияИндекса);
+	ДобавитьЗначениеПараметра(Индекс, "", ИсходнаяКоллекция);
 
-КонецПроцедуры
+	Возврат Индекс;
 
-Процедура ПроверитьИндекс()
+КонецФункции
 
-	Если КоллекцияИндекса = Неопределено Тогда
-		ВызватьИсключение Новый ИнформацияОбОшибке("Коллекция индекса не установлена");
-	КонецЕсли;
+// Поле читается один раз, дальше работа идет с локальной ссылкой,
+// которую не подменят параллельные Коллекция() и Очистить()
+//
+// Возвращаемое значение:
+//   Соответствие - опубликованный индекс
+//
+Функция ОпубликованныйИндекс()
 
-	Если НЕ ИндексСформирован Тогда
-		СформироватьИндекс();
+	Индекс = ИндексКоллекция;
+
+	Если Индекс = Неопределено Тогда
+		ВызватьИсключение "Коллекция индекса не установлена";
 	КонецЕсли;
+
+	Возврат Индекс;
 
-КонецПроцедуры
+КонецФункции
 
 Функция ЭтоМассив(Знач Значение)
 	Возврат ТипЗнч(Значение) = Тип("Массив");
@@ -81,7 +93,7 @@
 	Возврат ТипЗнч(Значение) = Тип("Сценарий");
 КонецФункции
 
-Процедура ДобавитьПараметрВИндекс(Знач ИмяПараметра, Знач ЗначениеПараметра)
+Процедура ДобавитьПараметрВИндекс(Индекс, Знач ИмяПараметра, Знач ЗначениеПараметра)
 
 	// Вставляем все значение целиком
 	Если Не ПустаяСтрока(ИмяПараметра) Тогда
@@ -91,27 +103,25 @@
 			ИмяПараметра = НРег(ИмяПараметра);
 		КонецЕсли;
 
-		ИндексКоллекция.Вставить(ИмяПараметра, ЗначениеПараметра);
+		Индекс.Вставить(ИмяПараметра, ЗначениеПараметра);
 	КонецЕсли;
 
 	// Рекурсивное заполнение значения параметра
-	ДобавитьЗначениеПараметра(ИмяПараметра, ЗначениеПараметра);
+	ДобавитьЗначениеПараметра(Индекс, ИмяПараметра, ЗначениеПараметра);
 
 КонецПроцедуры
 
-Процедура ДобавитьЗначениеПараметра(Знач ИмяПараметра, Знач ЗначениеПараметра)
+Процедура ДобавитьЗначениеПараметра(Индекс, Знач ИмяПараметра, Знач ЗначениеПараметра)
 
 	Если ЭтоМассив(ЗначениеПараметра) Тогда
-		ДобавитьПараметрМассивВИндекс(ЗначениеПараметра, ИмяПараметра);
-	ИначеЕсли ЭтоСоответствие(ЗначениеПараметра) Тогда
-		ДобавитьСоответствиеВИндекс(ЗначениеПараметра, ИмяПараметра);
-	ИначеЕсли ЭтоСтруктура(ЗначениеПараметра) Тогда
-		ДобавитьСоответствиеВИндекс(ЗначениеПараметра, ИмяПараметра);
+		ДобавитьПараметрМассивВИндекс(Индекс, ЗначениеПараметра, ИмяПараметра);
+	ИначеЕсли ЭтоСоответствие(ЗначениеПараметра) Или ЭтоСтруктура(ЗначениеПараметра) Тогда
+		ДобавитьСоответствиеВИндекс(Индекс, ЗначениеПараметра, ИмяПараметра);
 	КонецЕсли;
 
 КонецПроцедуры
 
-Процедура ДобавитьПараметрМассивВИндекс(Знач МассивЗначений, Знач ИмяРодителя = "")
+Процедура ДобавитьПараметрМассивВИндекс(Индекс, Знач МассивЗначений, Знач ИмяРодителя = "")
 
 	Лог.Отладка("Обрабатываю массив значений <%1> ", ИмяРодителя);
 
@@ -124,13 +134,13 @@
 	Для ИндексЗначения = 0 По МассивЗначений.ВГраница() Цикл
 
 		ИмяПараметра = СтрШаблон(ШаблонИмениПараметра, ИндексЗначения);
-		ДобавитьПараметрВИндекс(ИмяПараметра, МассивЗначений[ИндексЗначения]);
+		ДобавитьПараметрВИндекс(Индекс, ИмяПараметра, МассивЗначений[ИндексЗначения]);
 
 	КонецЦикла;
 
 КонецПроцедуры
 
-Процедура ДобавитьСоответствиеВИндекс(Знач ВходящиеПараметры, Знач ИмяРодителя = "")
+Процедура ДобавитьСоответствиеВИндекс(Индекс, Знач ВходящиеПараметры, Знач ИмяРодителя = "")
 
 	Лог.Отладка("Обрабатываю соответствие значений <%1> ", ИмяРодителя);
 
@@ -147,7 +157,7 @@
 		ИмяПараметра = СтрШаблон(ШаблонИмениПараметра, КлючЗначение.Ключ);
 		ЗначениеПараметра = КлючЗначение.Значение;
 
-		ДобавитьПараметрВИндекс(ИмяПараметра, ЗначениеПараметра);
+		ДобавитьПараметрВИндекс(Индекс, ИмяПараметра, ЗначениеПараметра);
 
 	КонецЦикла;
 

diff --git a/src/Классы/МенеджерПараметров.os b/src/Классы/МенеджерПараметров.os
@@ -24,6 +24,7 @@
 #Область Экспортных_процедур
 
 // Получает и возвращает значение из индекса параметров
+// Индекс строится один раз в Прочитать(), чтение потокобезопасно и выполняется без блокировок
 //
 // Параметры:
 //   ИмяПараметра        - Строка - имя параметра
@@ -55,6 +56,8 @@
 КонецФункции
 
 // Возвращает соответствие прочитанных параметров
+// Изменения возвращенного соответствия не попадают в Параметр(): индекс параметров
+// строится в Прочитать(), для применения изменений нужно повторно вызвать Прочитать()
 //
 // Возвращаемое значение:
 //   Соответствие - прочитанные параметров
@@ -64,10 +67,12 @@
 КонецФункции
 
 // Выполняет чтения параметров из доступных провайдеров
+// Новый индекс параметров строится полностью и только потом подменяет прежний,
+// поэтому Параметр() можно вызывать параллельно с Прочитать(): до подмены читается прежний индекс.
+// Параллельные вызовы Прочитать() между собой не поддерживаются
 //
 Процедура Прочитать() Экспорт
 
-	ИндексПараметров.Очистить();
 	ПрочитанныеПараметры.Очистить();
 	ВыполнитьЧтениеПровайдеров();