Остаток теории

Author: leobrn

docs/theory/metadata/business_processes.md

@@ -0,0 +1,11 @@
+---
+sidebar_position: 30
+sidebar_label: Бизнес-процессы и Задачи
+title: Бизнес-процессы и Задачи
+---
+
+**Бизнес-процессы** позволяют создавать экземпляры процессов, которые следуют определённому маршруту, включающему различные точки и действия. Они реализуют концепцию **Workflow**, обеспечивая ролевую маршрутизацию заданий между пользователями.
+
+**Задачи** представляют собой задания, которые возникают в ходе выполнения бизнес-процессов и могут быть адресованы конкретным пользователям или ролям. Они являются "движущей силой" бизнес-процессов, обеспечивая переход процесса на следующую точку маршрута после выполнения задачи. Могут использоваться автономно.
+
+При формировании списка задач для конкретного сотрудника, используется регистр сведений, который обеспечивает нахождение соответствий роль-сотрудник согласно системе адресации, настроенной в задаче.

docs/theory/metadata/calculation_registers.md

@@ -0,0 +1,20 @@
+---
+sidebar_position: 29
+sidebar_label: Регистры расчета
+title: Регистры расчета
+---
+**Регистры расчета** — это объекты конфигурации, предназначенные для регистрации результатов периодических расчетов с поддержкой сложных взаимосвязей между ними
+
+### Ответы на ключевые вопросы
+
+#### 1. Какие таблицы бывают у регистра? 
+Зависит от типа регистра. Есть таблицы База и данные графика, если связан с регистром сведений.
+
+#### 2.  Зачем нужны регистры расчета, если можно решить через регистры накопления? Регистры расчета отслеживают зависимости от одного вида расчета от другого?
+Да, основное преимущество регистров расчета перед регистрами накопления — реализация сложных расчетных механизмов:
+
+* **Механизм вытеснения** — записи одного вида расчета (например, "Отпуск") исключают пересекающиеся записи другого (например, "Оклад")
+* **Механизм перерасчетов** — при изменении базового расчета автоматически пересчитываются зависящие от него
+* **Учет базового периода** — для расчетов, основанных на данных за предыдущие периоды
+
+Хотя связи между расчетами настраиваются в плане видов расчета, сами механизмы (вытеснение, перерасчет, сторно) реализованы именно в регистрах расчета.

docs/theory/metadata/calculation_types_plans.md

@@ -0,0 +1,20 @@
+---
+sidebar_position: 25
+sidebar_label: План видов расчета
+title: План видов расчета
+---
+**План видов расчета (ПВР)** — служат для описания видов расчета, которые имеют сложные взаимные влияния во времени. 
+
+### Типы влияний между видами расчета
+
+**Базовые** — результаты которых используются при перерасчете;
+
+**Ведущие** — изменения в которых требуют перерасчета зависимого вида;
+
+**Вытесняющие** — которые могут вытеснять другие виды расчета по периоду действия
+
+| Тип влияния | Логика работы | Пример | Как настраивается |
+|---|---|---|---|
+| **Зависимость по базовому периоду** | Вид Б нужен для вычисления вида А. Система гарантирует, что при изменении Б пересчитается А. | `Премия` → зависит от `Оклада`. Премия считается от суммы оклада. | В свойствах вида А (`Премия`) в поле **"Зависимость по базовному периоду"** добавляется вид Б (`Оклад`). |
+| **Вытеснение по периоду действия** | Вид В "отменяет" действие вида Г на общей части их периодов действия. | `Больничный` → вытесняет `Оклад`. За дни больничного оклад не начисляется. | При описании расчета Оклад следует отметить Больничный как вытесняющий.
+| **Ведущие виды расчета** | Изменение ведуших требует перерасчета зависимых | Если `Больничный` вытесняет `Оклад`, а `Премия` зависит от `Оклада`, то `Больничный` — ведущий для `Премии`. | Для Премии нужно вручную включить в список ведущих как Оклад, так и Больничный |

docs/theory/metadata/commands.md

@@ -0,0 +1,33 @@
+---
+sidebar_position: 13
+sidebar_label: Команды, группы команд и общие команды
+title: Команды, группы команд и общие команды
+---
+**Три взаимосвязанных объекта метаданных для построения интерфейса и навигации в 1С.**
+
+### Ключевые свойства
+
+| Объект метаданных | Описание | Внешний вид |
+|---|---|---|
+| **Команда** | Конкретное действие | Кнопка или гиперссылка |
+| **Группа команд** | Контейнер для объединения команд | Панель, меню, раздел |
+| **Общая команда** | Глобальная команда для всей конфигурации | Доступна везде |
+
+### Ответы на ключевые вопросы
+
+#### 1. Что такое команды и группы команд?
+**Команды** — кнопки или гиперссылки, выполняющие конкретное действие (создать, провести, удалить).
+
+**Группы команд** — контейнеры для объединения связанных команд в интерфейсе (меню, панели инструментов).
+
+#### 2. Директивы компиляции в модуле команды?
+```bsl
+// Доступные директивы:
+&НаКлиенте            // Выполняется на клиенте
+&НаСервере            // Выполняется на сервере  
+&НаКлиентеНаСервере   // для клиента и сервера
+```
+
+#### 3. Когда можно указывать тип параметра?
+1. ✅ **Команда формы списка** — параметр = выделенный элемент
+2. ✅ **Команда объекта** — параметр = текущий объект 

docs/theory/metadata/definable_types.md

@@ -0,0 +1,60 @@
+---
+sidebar_position: 11
+sidebar_label: Определяемые типы
+title: Определяемые типы
+---
+**Объект метаданных, определяющий набор допустимых типов данных.** Контейнеры для наборов типов данных, которые обеспечивают единообразие и централизацию. Используются когда одни и те же типы нужны в разных местах конфигурации или когда нужно гарантировать одинаковые форматы данных в разных базах. Особенно полезны для финансовых показателей (точность сумм), кодов (валют, стран) и сложных структур данных.
+
+### Практическое применение
+
+#### 1. **Единство между разными базами**:
+```bsl
+// Определяемый тип "ТипКонтрагента":
+• Число
+• СправочникСсылка.ФизическиеЛица
+• СправочникСсылка.ЮридическиеЛица
+
+// Использование в реквизитах:
+Документ.Реализация.Контрагент → Тип: ОпределяемыйТип.ТипКонтрагента
+// В разных базах может быть разный состав, но имя типа одинаковое
+```
+
+#### 2. **Централизация настроек** (пример с разрядностью):
+```bsl
+// Определяемый тип "ВалютаКод":
+• Строка (Длина = 3)  // USD, EUR, RUB
+// Используется везде, где нужны коды валют
+```
+
+### Примеры использования
+
+#### 1. Настройки точности:
+```bsл
+// Централизованная настройка точности
+ОпределяемыйТип "Сумма":
+• Число (Длина = 15, Точность = 2)
+
+// Использование в разных местах:
+Документ.Реализация.Сумма → ОпределяемыйТип.Сумма
+Регистр.Продажи.Сумма → ОпределяемыйТип.Сумма
+Отчет.Обороты.Сумма → ОпределяемыйТип.Сумма
+```
+
+### Критические нюансы
+
+#### Преимущества:
+1. **Централизованное управление** — изменение в одном месте
+2. **Единство данных** — одинаковые типы везде
+3. **Упрощение миграции** — легко изменить для всех объектов
+
+### Рекомендации по использованию
+
+#### Использовать определяемые типы, когда:
+- ✅ Один и тот же набор типов используется в разных местах
+- ✅ Нужно гарантировать единство данных между базами
+- ✅ Частые изменения точности/форматов
+- ✅ Интеграция с внешними системами (стандартные форматы)
+
+#### Типичные применения:
+1. **Финансовые показатели** — точность сумм, ставок
+2. **Коды и идентификаторы** — длина, формат

docs/theory/metadata/documents.md

@@ -3,7 +3,51 @@ sidebar_position: 19
 sidebar_label: Документы
 title: Документы
 ---
-Объект метаданных для фиксации хозяйственных операций с временной привязкой.
+**Документы** — объекты для регистрации хозяйственных операций и событий предприятия (накладные, счета, платежки). Имеют **временную последовательность** и могут **проводиться** для изменения учетных данных.
+
+### Основные события
+
+#### **Модуль объекта:**
+| Событие | Когда вызывается | Для чего используется |
+|---|---|---|
+| **`ПередЗаписью()`** | Перед записью | Валидация, расчеты |
+| **`ПриЗаписи()`** | Во время записи | Дополнительные проверки, запись связанных данных |
+| **`ОбработкаПроведения()`** | При проведении | Создание движений |
+| **`ОбработкаЗаполнения()`** | При создании | Автозаполнение полей |
+
+### Удаление движений
+
+Свойство **«Удаление движений»** управляет автоматическим удалением записей регистров при работе с документом. Влияет на параллельность работы и производительность.
+
+| Вариант | Когда удаляет движения | Когда НЕ удаляет | Для чего используется |
+|---|---|---|---|
+| **Удалять автоматически при отмене проведения** (стандарт) | 1. Удаление документа  2. Отмена проведения | Перепроведение (перезаписывает) |  |
+| **Удалять автоматически** | 1. Перепроведение  2. Удаление  3. Отмена проведения | Всегда удаляет старые | **Когда нужна полная очистка** перед новыми движениями |
+| **Не удалять автоматически** | Никогда автоматически | Всегда | Оперативный учет в реальном времени или построчное проведение |
+
+### Влияние на блокировки и производительность
+
+#### **«Удалять автоматически» (плохо для параллельности):**
+```
+    Начало транзакции
+🔒  УДАЛЕНИЕ старых движений (X-блокировка)
+🔒  Длительные вычисления и прочие действия
+🔒  Запись движений
+🔒  Контроль остатков
+    Фиксация
+```
+При перепроведении этого документа, еще до выполнения процедуры `ОбработкаПроведения`, движения будут удалены.
+Что бы удалить данные платформа накладывает **X** блокировку, которая держится до конца транзакции.
+
+#### **«Удалять автоматически при отмене проведения» (лучше для параллельности):**
+```
+    Начало транзакции
+    Длительные вычисления и прочие действия
+🔒  Запись движений
+🔒  Контроль остатков
+    Фиксация
+```
+**Преимущество:** Во втором случае, данные будут заблокированы на гораздо меньшее время, чем в первом. А чем меньше длится блокировка, тем меньше вероятность возникновения проблем при многопользовательской работе.
 
 ## Последовательности
 
@@ -33,4 +77,13 @@ title: Документы
 ```bsl
 - Если ввод интерактивный в обработчике ОбработкаПроверкиЗаполнения
 - Если программно тогда явно вызвать ПроверитьЗаполнение()
-```
+```
+
+#### 3. Чем отличаются три варианта удаления движений?
+- **«При отмене»**: удаляет только при удалении/отмене документа  
+- **«Автоматически»**: удаляет при любом перепроведении  
+- **«Не удалять»**: никогда автоматически, нужно управлять вручную
+
+#### 4. Как влияет на производительность?
+**«Автоматически»** блокирует движения **в начале** транзакции → плохо при долгих расчетах.  
+**«Не удалять»** блокирует в **конце** → лучше для параллельности.

docs/theory/metadata/enumerating_values.md

@@ -0,0 +1,26 @@
+---
+sidebar_position: 21
+sidebar_label: Перечисления
+title: Перечисления
+---
+**Объект метаданных для хранения фиксированных наборов значений, задаваемых в конфигураторе.** 
+
+### Ключевые моменты
+
+|  | Описание | Пример |
+|---|---|---|
+| **Фиксированный набор** | Значения задаются в конфигураторе | Ставки НДС, статусы заказов |
+| **Неизменяемость** | Не меняются в процессе работы | Только добавление в новых версиях |
+| **Тип ссылки** | Используется как тип данных | `ПеречислениеСсылка.СтатусЗаказа` |
+
+### Ответ на вопрос
+
+#### Динамическое ограничение значений перечисления?
+
+Для динамического ограничения выбора используется обработчик `ОбработкаПолученияДанныхВыбора` в модуле менеджера перечисления. Это позволяет программно фильтровать доступные значения в зависимости от условий (констант, настроек, прав)."
+
+### Рекомендации
+
+#### Когда создавать перечисления:
+- ✅ Фиксированные наборы значений (статусы, типы)
+- ✅ Когда значения НЕ меняются в процессе работы