Правки

Author: leobrn

docs/theory/client_server.md

@@ -56,7 +56,7 @@ title: Клиент-серверное взаимодействие
 *   **Избегайте вызовов в циклах:** Не делайте серверный вызов для каждой строки таблицы. Соберите данные на клиенте и обработайте пакетом за один вызов.
 *   **Задача разработчика — минимизировать количество и объем серверных вызовов.** Код нужно явно разделять между клиентом и сервером.
 
-## Сетевое взаимодействие с кластером «1С»
+## Сетевое взаимодействие с кластером
 
 1.  **Протокол и адресация:** Все компоненты (клиенты, рабочие процессы, менеджеры) общаются по **TCP/IP**. Каждый процесс имеет уникальный адрес: **имя сервера + номер порта**.
 

docs/theory/metadata/accounting_registers.md

@@ -36,36 +36,26 @@ title: Регистры бухгалтерии
 
 ## Ответы на ключевые вопросы
 
-#### 1. Отличие от регистров накопления
-**Вопрос:** *Чем регистр бухгалтерии отличается от регистра накопления?*  
-**Ответ:**  
+#### 1. Чем регистр бухгалтерии отличается от регистра накопления?   
 - **Привязка к плану счетов** — обязательная связь с конкретным планом счетов
 - **Субконто** — многоуровневая аналитика через план видов характеристик
 - **Корреспонденция** — поддержка двойной записи (Дт/Кт)
 - **Балансовый контроль** — проверка равенства сумм по дебету и кредиту
 
-#### 2. Работа с субконто
-**Вопрос:** *Как настроить субконто для счета?*  
-**Ответ:**  
+#### 2. Как настроить субконто для счета?*  
 1. В **плане счетов** открыть свойства нужного счета
 2. В разделе **"Субконто"** добавить типы субконто (Склады, Контрагенты и т.д.)
 3. В **регистре бухгалтерии** проверить количество включенных субконто
 
-#### 3. Параметр `МетодДополнения`
-**Вопрос:** *Зачем нужен параметр `МетодДополнения`?*  
-**Ответ:**  
+#### 3. Зачем нужен параметр `МетодДополнения`?  
 Управляет включением в результат записей **без оборотов за период, но с остатками**.  
 
-#### 4. Таблица `ДвиженияССубконто`
-**Вопрос:** *Когда использовать `ДвиженияССубконто` вместо `Остатки`?*  
-**Ответ:**  
+#### 4. Когда использовать `ДвиженияССубконто` вместо `Остатки`?    
 Использовать `ДвиженияССубконто` когда нужно:
 - Получить **детальные проводки** с развернутыми субконто
 - Сделать **отбор по значениям субконто** (например, все операции по конкретному контрагенту)
 - Увидеть **все записи**, включая неактивные (сторнированные)
 
-#### 5. Балансовый признак
-**Вопрос:** *В каком сценарии отключают балансовый признак у измерения?*  
-**Ответ:**  
+#### 5. В каком сценарии отключают балансовый признак у измерения?  
 При **валютных операциях между разными организациями**.  
-Пример: Перевод валюты из ОрганизацииА в ОрганизациюБ. В дебете — ОрганизацияА, в кредите — ОрганизацияБ. Без отключения балансового признака система выдаст ошибку.
+**Пример:** Перевод валюты из ОрганизацииА в ОрганизациюБ. В дебете — ОрганизацияА, в кредите — ОрганизацияБ. Без отключения балансового признака система выдаст ошибку.

docs/theory/metadata/common_modules.md

@@ -35,7 +35,7 @@ title: Общие модули
 #### Глобальный общий модуль
 *   Функции доступны **без указания имени модуля**.
 *   **Требование уникальности имен** функций в рамках всей конфигурации.
-*   **Осторожно!** Может привести к конфликтам имен и усложнить чтение кода ("откуда эта функция?"
+*   **Осторожно!** Может привести к конфликтам имен и усложнить чтение кода ("откуда эта функция?")
 
 #### Вызов сервера
 * Устанавливать признак "Вызов сервера" только для тех серверных общих модулей, чьи экспортные методы действительно должны вызываться с клиента

docs/theory/metadata/documents.md

@@ -25,29 +25,29 @@ title: Документы
 | **Удалять автоматически** | 1. Перепроведение  2. Удаление  3. Отмена проведения | Всегда удаляет старые | **Когда нужна полная очистка** перед новыми движениями |
 | **Не удалять автоматически** | Никогда автоматически | Всегда | Оперативный учет в реальном времени или построчное проведение |
 
-### Влияние на блокировки и производительность
-
-#### **«Удалять автоматически» (плохо для параллельности):**
-```
-    Начало транзакции
-🔒  УДАЛЕНИЕ старых движений (X-блокировка)
-🔒  Длительные вычисления и прочие действия
-🔒  Запись движений
-🔒  Контроль остатков
-    Фиксация
-```
-При перепроведении этого документа, еще до выполнения процедуры `ОбработкаПроведения`, движения будут удалены.
-Что бы удалить данные платформа накладывает **X** блокировку, которая держится до конца транзакции.
-
-#### **«Удалять автоматически при отмене проведения» (лучше для параллельности):**
-```
-    Начало транзакции
-    Длительные вычисления и прочие действия
-🔒  Запись движений
-🔒  Контроль остатков
-    Фиксация
-```
-**Преимущество:** Во втором случае, данные будут заблокированы на гораздо меньшее время, чем в первом. А чем меньше длится блокировка, тем меньше вероятность возникновения проблем при многопользовательской работе.
+#### Влияние на блокировки и производительность
+
+- **«Удалять автоматически» (плохо для параллельности):**
+    ```
+        Начало транзакции
+    🔒  УДАЛЕНИЕ старых движений (X-блокировка)
+    🔒  Длительные вычисления и прочие действия
+    🔒  Запись движений
+    🔒  Контроль остатков
+        Фиксация
+    ```
+    При перепроведении этого документа, еще до выполнения процедуры `ОбработкаПроведения`, движения будут удалены.
+    Что бы удалить данные платформа накладывает **X** блокировку, которая держится до конца транзакции.
+
+- **«Удалять автоматически при отмене проведения» (лучше для параллельности):**
+    ```
+        Начало транзакции
+        Длительные вычисления и прочие действия
+    🔒  Запись движений
+    🔒  Контроль остатков
+        Фиксация
+    ```
+    **Преимущество:** Во втором случае, данные будут заблокированы на гораздо меньшее время, чем в первом. А чем меньше длится блокировка, тем меньше вероятность возникновения проблем при многопользовательской работе.
 
 ## Последовательности
 

docs/theory/metadata/event_subscriptions.md

@@ -50,7 +50,7 @@ title: Подписки на события
 
 ### Особенности реализации
 
-### Требования к общим модулям:
+#### Требования к общим модулям:
 - Сервер: Да
 - Внешнее соединение: Да (для COM)
 

docs/theory/metadata/exchange_plans.md

@@ -50,7 +50,7 @@ title: Планы обмена и РИБ
 - Уникальный номер в рамках плана обмена
 - Подтверждения приема через номер последнего принятого сообщения
 
-##  Особенности РИБ (как специализации)
+##  Особенности РИБ
 
 | Аспект | Обычный план обмена | РИБ |
 |---|---|---|

docs/theory/request.md

@@ -21,7 +21,7 @@ title: Запросы
 
 **Решение:** Создать дополнительный индекс или (осторожно) изменить порядок измерений.
 
-## Работа с составными типами (ссылочные поля)
+## Работа с составными типами
 **Главная проблема:** Обращение к полю через точку (`Документ.Регистратор.Дата`) для поля составного типа приводит к **неявному соединению со ВСЕМИ** таблицами возможных типов (например, со всеми видами документов). Это резко замедляет запрос.
 
 **Решение:**
@@ -38,7 +38,7 @@ title: Запросы
 
 **Пример:** Получение "последней цены" через `ПО ... В (ВЫБРАТЬ МАКСИМУМ(Период) ...)` лучше делать в два шага через временную таблицу.
 
-## Виртуальные таблицы (остатки, срезы)
+## Виртуальные таблицы
 1.  **Всегда передавайте условия отбора в ПАРАМЕТРЫ виртуальной таблицы**, а не в `ГДЕ` основного запроса.
     *   `...Остатки(, Склад = &Склад)` (ПРАВИЛЬНО)
     *   `...Остатки() ГДЕ Склад = &Склад` (НЕПРАВИЛЬНО)
@@ -54,7 +54,7 @@ title: Запросы
     *   `МЕСЯЦ(Дата) = 1` -> `Дата МЕЖДУ ДАТАВРЕМЯ(2023,01,01) И ДАТАВРЕМЯ(2023,01,31,23,59,59)`
 *   **Конструкцию `ВЫБОР`** используйте только в дополнительных условиях в секции `ГДЕ`.
 
-## Временные таблицы (рекомендации по использованию)
+## Временные таблицы
 *   **Индексируйте** большие временные таблицы, участвующие в соединениях или условиях `В(...)`.
 *   **Не помещайте** во временную таблицу лишние поля или записи.
 *   **Не создавайте** временные таблицы в цикле. Создайте одну до цикла.

docs/theory/sql.md

@@ -94,17 +94,17 @@ WHERE РегистрСведений.Цены.Номенклатура = 'Тов
 
 ## Планы запросов
 
-### Что такое план запроса и зачем он нужен?
+#### Что такое план запроса и зачем он нужен?
 
 **План запроса** — это **пошаговая инструкция от СУБД**, показывающая конкретные алгоритмы выполнения SQL-запроса. Это "отладчик" для SQL-кода, который показывает реальную работу СУБД изнутри.
 
-### Зачем анализировать планы?
+#### Зачем анализировать планы?
 - **Понимать реальную производительность** (не только на тестовых данных)
 - **Находить узкие места** — операции, которые "съедают" время
 - **Предотвращать проблемы** в боевой системе при росте данных
 - **Оптимизировать запросы** на основе реального поведения СУБД
 
-## Ключевые концепции и операторы
+### Ключевые концепции и операторы
 
 **Базовые алгоритмы СУБД**
 СУБД использует понятные алгоритмы, знакомые программистам:
@@ -140,7 +140,7 @@ WHERE РегистрСведений.Цены.Номенклатура = 'Тов
 Источники данных → Фильтрация → Соединения → Сортировка → Результат
 ```
 
-## Как читать и анализировать планы
+### Как читать и анализировать планы
 
 **Ключевые метрики:**
 
@@ -163,7 +163,7 @@ WHERE РегистрСведений.Цены.Номенклатура = 'Тов
 3. **Проанализировать вложенность** (операторы внутри операторов)
 4. **Оценить количество обрабатываемых строк**
 
-## Инструменты для работы с планами
+### Инструменты для работы с планами
 
 **Для MS SQL Server:**
 
@@ -188,7 +188,7 @@ WHERE РегистрСведений.Цены.Номенклатура = 'Тов
    - Технологический журнал 1С
    - PgAdmin (через `EXPLAIN ANALYZE`)
 
-## Типичные проблемы 1С и их признаки в планах
+### Типичные проблемы 1С и их признаки в планах
 
 **1. Общий поиск ("Поиск подобно")**
 - **Признак:** `LIKE '%значение%'` по нескольким полям
@@ -223,7 +223,7 @@ WHERE РегистрСведений.Цены.Номенклатура = 'Тов
 - **Запрос:** `WHERE Организация = ? AND Номенклатура = ?` (пропущен "Склад")
 - **Результат:** Index Scan может быть МЕДЛЕННЕЕ Sequential Scan
 
-## Процесс анализа на боевой базе
+### Процесс анализа на боевой базе
 
 **Этап 1: Поиск проблемных запросов**
 
@@ -253,7 +253,7 @@ WHERE РегистрСведений.Цены.Номенклатура = 'Тов
 3. Переписать сложные запросы (особенно "Срезы последних")
 4. Проверить актуальность статистики
 
-## Критические выводы и рекомендации
+### Критические выводы и рекомендации
 
 **Общие принципы:**
 1. **Не тестируйте на маленьких данных!** Поведение на миллионах записей — совершенно другое