Editing architecture and security docs

content/documentation/admin/architecture/functional-architecture.ru.md

@@ -12,7 +12,7 @@ weight: 10
 **Основные функции:**
 
 * Отображение пользовательского интерфейса для управления сервисами, окружениями и ресурсами.
-* Обработка пользовательских действий и передача запросов в Backend через REST API.
+* Обработка пользовательских действий и передача запросов в DDP Backend через REST API.
 
 **Технические характеристики:**
 
@@ -81,7 +81,7 @@ weight: 10
 **Redis** — это хранилище данных в памяти, используемое платформой для работы с очередями задач.
 
 {{< alert level="info" >}}
-**Redis** может быть установлен в составе модуля DDP для тестовых и демонстрационных целей. В промышленной эксплуатации рекомендуется использование выделенных инстансов Redis.
+Redis может быть установлен в составе модуля DDP для тестовых и демонстрационных целей. В промышленной эксплуатации рекомендуется использование выделенных инстансов Redis.
 {{< /alert >}}
 
 **Основные функции:**

content/documentation/admin/architecture/workers.ru.md

@@ -5,11 +5,11 @@ weight: 20
 
 Воркеры — это компоненты платформы, которые обрабатывают задачи из очереди в фоновом режиме. Они обеспечивают асинхронное выполнение различных операций, таких как:
 
-- Синхронизация данных из источников данных
-- Запуск действий и процессов
-- Проверки статуса сущностей
+- Синхронизация данных из источников данных.
+- Запуск действий и процессов.
+- Проверки статуса сущностей.
 
-Воркеры работают независимо от основного приложения и позволяют масштабировать нагрузку на систему, перенося ресурсоемкие операции на выделенные реплики.
+Воркеры работают независимо от основного приложения и позволяют масштабировать нагрузку на систему, перенося ресурсоёмкие операции на выделенные реплики.
 
 ## Конфигурация
 
@@ -23,88 +23,92 @@ weight: 20
 
 Параметр `workers.maxTasks` определяет, сколько задач может обрабатываться параллельно каждым воркером.
 
-**Важно:** Общее количество задач, обрабатываемых одновременно всей системой, рассчитывается как `workers.replicas × workers.maxTasks`. Например, при 2 воркерах и 10 задачах на воркер система может обрабатывать до 20 задач одновременно.
+{{< alert level="info" >}}
+Общее количество задач, обрабатываемых одновременно всей системой, рассчитывается как `workers.replicas × workers.maxTasks`. Например, при 2 воркерах и 10 задачах на каждый воркер, система может обрабатывать до 20 задач одновременно.
+{{< /alert >}}
 
 ## Мониторинг
 
 Для мониторинга работы воркеров и очереди задач доступен виджет **Очередь задач** ([подробнее](../../widgets/types/#очередь-задач)), который отображает:
 
-- Размер очереди (общее количество задач)
-- Количество ожидающих задач
-- Количество активных воркеров (консьюмеров)
-- Детальную информацию о задачах в очереди
-- Статус каждой задачи (новая, в обработке)
+- Размер очереди (общее количество задач).
+- Количество ожидающих задач.
+- Количество активных воркеров (консьюмеров).
+- Детальную информацию о задачах в очереди.
+- Статус каждой задачи (новая, в обработке).
 
 ## Настройка через переменные окружения
 
 Параметры воркеров также можно настроить через переменные окружения:
 
-- `WORKER_MAX_TASKS` — максимальное количество параллельных задач на воркер (по умолчанию: 10)
+- `WORKER_MAX_TASKS` — максимальное количество параллельных задач на воркер (по умолчанию: 10).
 
-**Пример:**
+Пример применения настроек:
 
 ```bash
 export WORKER_MAX_TASKS=15
 ```
 
 **Приоритет настроек:**
-1. Значение из конфигурационного файла
-2. Значение из переменной окружения
-3. Значение по умолчанию
+1. Значение из конфигурационного файла.
+1. Значение из переменной окружения.
+1. Значение по умолчанию.
 
 ## Типы обрабатываемых задач
 
 Воркеры обрабатывают следующие типы задач:
 
 ### Задачи проверки статуса сущностей
 
-Задачи проверки статуса сущностей выполняются воркерами для определения статуса сущностей на основе настроенных правил. Это позволяет:
+Задачи проверки статуса выполняются воркерами, которые определяют состояние сущностей на основе настроенных правил. Такой подход позволяет:
 
-- Разгрузить основной сервер от выполнения проверок
-- Обеспечить стабильность работы при большом количестве сущностей
-- Гарантировать выполнение проверок даже при высокой нагрузке на основное приложение
+- Снизить нагрузку на основной сервер.
+- Обеспечить стабильность работы при большом количестве сущностей.
+- Гарантировать выполнение проверок даже при высокой нагрузке на основное приложение.
 
 ### Задачи синхронизации источников данных
 
 Воркеры обрабатывают задачи синхронизации данных из внешних источников, что позволяет:
 
-- Выполнять синхронизацию в фоновом режиме
-- Не блокировать интерфейс пользователя
-- Обрабатывать большие объемы данных
+- Выполнять синхронизацию в фоновом режиме.
+- Не блокировать интерфейс пользователя.
+- Обрабатывать большие объемы данных.
 
 ### Задачи выполнения действий
 
 Действия, требующие длительного выполнения, обрабатываются воркерами, что обеспечивает:
 
-- Асинхронное выполнение действий
-- Возможность отслеживания прогресса выполнения
-- Стабильность работы интерфейса
+- Асинхронное выполнение действий.
+- Возможность отслеживания прогресса выполнения.
+- Стабильность работы интерфейса.
 
 ## Масштабирование
 
 При необходимости увеличения производительности системы можно:
 
-1. **Увеличить количество реплик воркеров** — это позволит обрабатывать больше задач одновременно
-2. **Увеличить количество параллельных задач на воркер** — это повысит утилизацию каждого воркера
+1. Увеличить количество реплик воркеров — это позволит обрабатывать больше задач одновременно.
+1. Увеличить количество параллельных задач на воркер — это повысит утилизацию каждого воркера.
 
-**Важно:** При увеличении нагрузки на воркеры необходимо убедиться, что у кластера достаточно ресурсов (CPU, память) для обработки всех задач.
+{{< alert level="info" >}}
+При увеличении нагрузки на воркеры необходимо убедиться, что у кластера достаточно ресурсов (CPU, память) для обработки всех задач.
+{{< /alert >}}
 
-## Устранение проблем
+## Устранение неполадок
 
 ### Воркеры не обрабатывают задачи
 
 Если задачи накапливаются в очереди и не обрабатываются:
 
-1. Проверьте, что воркеры развернуты и работают (через виджет `Очередь задач`)
-2. Убедитесь, что количество реплик воркеров больше 0
-3. Проверьте логи воркеров на наличие ошибок
-4. Убедитесь, что у воркеров достаточно ресурсов (CPU, память)
+1. Проверьте, что воркеры развернуты и работают (через виджет «Очередь задач»).
+1. Убедитесь, что количество реплик воркеров больше 0.
+1. Проверьте логи воркеров на наличие ошибок.
+1. Убедитесь, что у воркеров достаточно ресурсов (CPU, память).
 
 ### Медленная обработка задач
 
 Если задачи обрабатываются медленно:
 
-1. Увеличьте количество реплик воркеров
-2. Увеличьте количество параллельных задач на воркер (если позволяет ресурсная база)
-3. Проверьте производительность внешних систем, с которыми работают воркеры
-4. Убедитесь, что нет узких мест в сети или базе данных
+1. Увеличьте количество реплик воркеров.
+1. Увеличьте количество параллельных задач на воркер (если позволяет ресурсная база).
+1. Проверьте производительность внешних систем, с которыми работают воркеры.
+1. Убедитесь, что нет узких мест в сети или базе данных.