Потокобезопасные транзакции: соединение на контекст исполнения

.bsl-language-server.json

@@ -3,7 +3,10 @@
         "parameters": {
             "IncorrectLineBreak": {
                 "listOfIncorrectFirstSymbol": ";|,\\s*\\S+"
+            },
+            "Typo": {
+                "userWordsToIgnore": "переиспользование,Переиспользование,переиспользования,Переиспользования,переиспользованию,Переиспользованию,переиспользованием,Переиспользованием,переиспользовано,Переиспользовано,переиспользовать,Переиспользовать,переиспользует,Переиспользует,переиспользуется,Переиспользуется,переиспользуются,Переиспользуются"
             }
         }
     }
-}
+}

.github/copilot-instructions.md

@@ -23,13 +23,17 @@ docker run --rm --name postgres -d -p 5432:5432 -e POSTGRES_PASSWORD=postgres -e
 Для запуска тестов используется команда:
 
 ```sh
-TESTRUNNER_RUN_POSTGRES_TESTS=true TESTRUNNER_RUN_SQLITE_TESTS=false oscript tasks/test.os
+TESTRUNNER_RUN_POSTGRES_TESTS=true TESTRUNNER_RUN_SQLITE_TESTS=false \
+  ./oscript_modules/bin/oneunit execute
 ```
 
 Для запуска тестов с замером покрытия используется команда:
 
 ```sh
-TESTRUNNER_RUN_POSTGRES_TESTS=true TESTRUNNER_RUN_SQLITE_TEST=false oscript tasks/coverage.os
+TESTRUNNER_RUN_POSTGRES_TESTS=true TESTRUNNER_RUN_SQLITE_TESTS=false \
+  ./oscript_modules/bin/oneunit execute \
+    --genericExecution out/tests.xml \
+    --genericCoverage out/genericCoverage.xml
 ```
 
 Замеры покрытия доступны в подкаталоге `out`.

.github/workflows/main.yml

@@ -14,7 +14,7 @@ jobs:
       fail-fast: false
       matrix:
         os: [ubuntu-latest, windows-latest, macos-15-intel]
-        oscript_version: ['1.9.2', 'stable']
+        oscript_version: ['2.0.0', 'stable']
     steps:
     - uses: actions/checkout@v7
 
@@ -32,9 +32,9 @@ jobs:
 
     - name: Install dependencies
       run: |
-        opm install opm@1.0.2
+        opm install opm
         opm install -l
-        opm install -l 1commands 1testrunner coverage@0.6.1
+        opm install -l --dev
 
     - name: Install docker
       uses: docker/setup-docker-action@v5
@@ -53,4 +53,4 @@ jobs:
         TESTRUNNER_RUN_POSTGRES_TESTS: true
         TESTRUNNER_RUN_SQLITE_TESTS: "${{ matrix.os == 'windows-latest' }}"
       run: |
-        oscript ./tasks/test.os
+        ./oscript_modules/bin/oneunit execute

.github/workflows/qa.yml

@@ -17,13 +17,13 @@ jobs:
     - name: Setup Onescript Action
       uses: otymko/setup-onescript@v1.5
       with:
-        version: "1.9.2"
+        version: "2.0.0"
 
     - name: Install dependencies
       run: |
-        opm install opm@1.0.2
+        opm install opm
         opm install -l
-        opm install -l 1commands 1testrunner coverage@0.6.1
+        opm install -l --dev
 
     - name: Install docker
       uses: docker/setup-docker-action@v5
@@ -49,7 +49,9 @@ jobs:
         TESTRUNNER_RUN_POSTGRES_TESTS: true
         TESTRUNNER_RUN_SQLITE_TESTS: false
       run: |
-        oscript ./tasks/coverage.os
+        ./oscript_modules/bin/oneunit execute \
+          --genericExecution out/tests.xml \
+          --genericCoverage out/genericCoverage.xml
 
     - name: Setup sonarqube
       uses: warchant/setup-sonar-scanner@v10

.mcp.json

@@ -0,0 +1,13 @@
+{
+    "mcpServers": {
+        "bsl-language-server": {
+            "type": "http",
+            "url": "http://localhost:8234/mcp"
+        },
+        "oneunit": {
+            "type": "stdio",
+            "command": "./oscript_modules/bin/oneunit",
+            "args": ["mcp"]
+        }
+    }
+}

.vscode/settings.json

@@ -1,4 +1,5 @@
 {
     "language-1c-bsl.linterEntryPoint": "./src/fake-entrypoint.os",
-    "coverage-gutters.xmlname": "out/coverage.xml"
+    "language-1c-bsl.languageServerMcpEnabled": true,
+    "language-1c-bsl.languageServerMcpPort": "8234"
 }

CLAUDE.md

@@ -0,0 +1,25 @@
+# Работа над entity
+
+## Порядок работы
+
+- **Сначала тесты, потом реализация.** Тест пишется до кода, который он проверяет,
+  и должен падать на текущем поведении. Это относится и к исправлениям дефектов:
+  сперва тест, воспроизводящий дефект, затем починка.
+- **Правки кода — только файловыми инструментами** (Read/Edit/Write). Редактировать
+  исходники через `sed`, `python`, `cat >> файл` и прочие перенаправления оболочки
+  нельзя без явного разрешения.
+
+## Прогон тестов
+
+```
+opm install opm@1.0.2
+opm install -l
+opm install -l --dev
+./oscript_modules/bin/oneunit execute
+```
+
+Тесты гоняет [oneunit](https://github.com/sfaqer/oneunit). Переменные среды
+`TESTRUNNER_RUN_SQLITE_TESTS` и `TESTRUNNER_RUN_POSTGRES_TESTS` — единственный
+способ сказать, какие базы доступны. Наборы, которым нужна конкретная база,
+выключаются аннотацией `&ВключенЕсли`, читающей ту же переменную; наборы,
+работающие с любой из двух, выбирают по ним базу сами.

README.md

@@ -569,6 +569,21 @@
 
 При использовании in-memory базы данных в моделях больше, чем с одним типом сущности, строка соединения должна выглядеть так: `"FullUri=file::memory:?cache=shared"`
 
+> Внимание!
+
+База данных в памяти живет ровно столько, сколько открыто хотя бы одно соединение к ней. Как только закрывается последнее, база уничтожается вместе с таблицами и данными.
+
+Поэтому in-memory базу нельзя сочетать с **нулевым размером пула соединений**: при нулевом размере соединение открывается на операцию и закрывается сразу после нее, то есть между операциями открытых соединений не остается. Следующая операция откроет уже пустую базу и получит `no such table`. Переживет база такой промежуток или нет, зависит от внутреннего пулинга провайдера, то есть воспроизводится через раз.
+
+Для in-memory базы используйте ненулевой размер пула — тогда пул придерживает соединения открытыми и база живет, пока жив менеджер сущностей. Если нулевой размер нужен принципиально, держите отдельное соединение к той же базе на все время работы:
+
+```bsl
+Держатель = Новый КоннекторSQLite;
+Держатель.Открыть("FullUri=file::memory:?cache=shared", Новый Массив);
+// ... работа через менеджер сущностей ...
+Держатель.Закрыть();
+```
+
 <a id="library-structure-connector-postgresql" />
 
 ### КоннекторPostgreSQL

docs/README.md

@@ -18,3 +18,7 @@
 * [ВидСравнения](ВидСравнения.md)
 * [ТипыКолонок](ТипыКолонок.md)
 * [ТипыПодчиненныхТаблиц](ТипыПодчиненныхТаблиц.md)
+
+### Прочее
+
+* [Потокобезопасная работа с БД](ПотокобезопаснаяРаботаСБД.md)

docs/МенеджерСущностей.md

@@ -8,9 +8,18 @@
 // Параметры:
 //   ТипКоннектора - Тип - Тип класса, реализующего интерфейс Коннектор.
 //   СтрокаСоединения - Строка - Строка соединения к БД, к которой подключается коннектор.
-//   ППараметрыКоннектора - Массив - Массив дополнительных параметров коннектора. Содержимое произвольное.
+//   ПараметрыКоннектора - Массив - Массив дополнительных параметров коннектора. Содержимое произвольное.
+//   РазмерПулаСоединений - Число - Предел параллельной работы с БД: когда все места заняты,
+//     следующий контекст ждет освобождения, но не дольше предела ожидания - иначе получает ошибку.
+//     Нулевой размер снимает предел, но постоянно живущих соединений не держит - каждое обращение
+//     к БД открывает свое соединение и закрывает его по завершении.
 //
-Процедура ПриСозданииОбъекта(Знач ТипКоннектора, Знач СтрокаСоединения = "", Знач ППараметрыКоннектора = Неопределено) 
+Процедура ПриСозданииОбъекта(
+	Знач ТипКоннектора,
+	Знач СтрокаСоединения = "",
+	Знач ПараметрыКоннектора = Неопределено,
+	Знач РазмерПулаСоединений = 10
+)
 ```
 
 ### ДобавитьКлассВМодель
@@ -134,37 +143,65 @@
 ### НачатьТранзакцию
 
 ```bsl
-// Посылает коннектору запрос на начало транзакции.
+// Начинает транзакцию для текущего контекста исполнения.
+//
+// Контекст занимает соединение и держит его до фиксации или отмены, поэтому все его операции
+// попадают в эту транзакцию, а завершить ее другое фоновое задание не может.
 //
 Процедура НачатьТранзакцию() 
 ```
 
 ### ЗафиксироватьТранзакцию
 
 ```bsl
-// Посылает коннектору запрос на фиксацию транзакции.
+// Фиксирует транзакцию текущего контекста исполнения и возвращает его соединение в пул.
 //
 Процедура ЗафиксироватьТранзакцию() 
 ```
 
 ### ОтменитьТранзакцию
 
 ```bsl
-// Посылает коннектору запрос на отмену транзакции.
+// Отменяет транзакцию текущего контекста исполнения и возвращает его соединение в пул.
 //
 Процедура ОтменитьТранзакцию() 
 ```
 
-### ПолучитьКоннектор
+### ВыполнитьСКоннектором
 
 ```bsl
-// Возвращает текущий активный коннектор.
+// Выполняет алгоритм коннектором из пула.
 //
-//  Возвращаемое значение:
-//   АбстрактныйКоннектор - Возвращает экземпляр коннектора. Конкретная реализация определяется параметром
-//      ТипКоннектора при вызове конструктора МенеджерСущностей.
+// Прямой доступ к БД в обход библиотеки. Соединение занимается на время выполнения алгоритма и
+// сразу возвращается в пул, поэтому держать его за пределами вызова нельзя. Если текущий контекст
+// исполнения начал транзакцию, алгоритм получает коннектор этой транзакции и попадает в нее.
+//
+// Параметры:
+//   Алгоритм - Строка - Лямбда-выражение с одним параметром - коннектором.
+//   Контекст - Структура - Значения, доступные в алгоритме по именам ключей.
+//   Объект - Сценарий - Объект, поля и методы которого доступны в алгоритме.
+//
+Процедура ВыполнитьСКоннектором(Знач Алгоритм, Знач Контекст = Неопределено, Знач Объект = Неопределено) 
+```
+
+### ВычислитьСКоннектором
+
+```bsl
+// Вычисляет значение алгоритмом, выполненным коннектором из пула.
+//
+// Прямой доступ к БД в обход библиотеки. Соединение занимается на время выполнения алгоритма и
+// сразу возвращается в пул, поэтому держать его за пределами вызова нельзя. Если текущий контекст
+// исполнения начал транзакцию, алгоритм получает коннектор этой транзакции и попадает в нее.
+//
+// Параметры:
+//   Алгоритм - Строка - Лямбда-выражение с одним параметром - коннектором.
+//   Контекст - Структура - Значения, доступные в алгоритме по именам ключей.
+//   Объект - Сценарий - Объект, поля и методы которого доступны в алгоритме.
+//
+// Возвращаемое значение:
+//   Произвольный - Результат алгоритма.
 //
-Функция ПолучитьКоннектор() 
+Функция ВычислитьСКоннектором(Знач Алгоритм, Знач Контекст = Неопределено, Знач Объект = Неопределено) 
 ```
 
 ### ПолучитьХранилищеСущностей