docs: Large editorial pass — terminology, formatting, markup

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

@@ -5,33 +5,35 @@ weight: 10
 
 ## Описание компонентов
 
+В состав Deckhouse Development Platform (DDP) входят следующие компоненты.
+
 ### DDP Frontend
 
-**DDP Frontend** — это веб-интерфейс платформы, построенный на Vue.js 3 с TypeScript. Компонент предоставляет пользователям графический интерфейс для работы с платформой через веб-браузер.
+DDP Frontend — это веб-интерфейс платформы, построенный на Vue.js 3 с TypeScript. Компонент предоставляет пользователям графический интерфейс для работы с платформой через веб-браузер.
 
-**Основные функции:**
+Основные функции:
 
 * Отображение пользовательского интерфейса для управления сервисами, окружениями и ресурсами.
 * Обработка пользовательских действий и передача запросов в DDP Backend через REST API.
 
-**Технические характеристики:**
+Технические характеристики:
 
 * Принимает входящие соединения от пользователей.
 * Взаимодействует с DDP Backend.
 
 ### DDP Backend
 
-**DDP Backend** — это серверная часть платформы, реализованная на языке Go. Компонент предоставляет REST API для управления всеми механизмами платформы.
+DDP Backend — это серверная часть платформы, реализованная на языке Go. Компонент предоставляет REST API для управления всеми механизмами платформы.
 
-**Основные функции:**
+Основные функции:
 
 * Предоставление REST API для программного взаимодействия с платформой.
 * Обработка бизнес-логики платформы.
 * Реализация системы контроля доступа (RBAC) и управления правами пользователей.
 * Интеграция с внешними инфраструктурными сервисами для выполнения различных операций.
 * Управление данными через взаимодействие с PostgreSQL и Redis.
 
-**Технические характеристики:**
+Технические характеристики:
 
 * Принимает API-запросы от пользователей и DDP Frontend.
 * Выполняет валидацию токенов доступа локально, используя кэшированные ключи подписи.
@@ -40,15 +42,15 @@ weight: 10
 
 ### DDP Worker
 
-**DDP Worker** — это компонент для выполнения фоновых задач и асинхронных операций, реализованный на языке Go. Worker обрабатывает задачи из очередей Redis Streams и выполняет операции по запуску действий и синхронизации источников данных.
+DDP Worker — это компонент для выполнения фоновых задач и асинхронных операций, реализованный на языке Go. Worker обрабатывает задачи из очередей Redis Streams и выполняет операции по запуску действий и синхронизации источников данных.
 
-**Основные функции:**
+Основные функции:
 
 * Синхронизация данных из внешних источников.
 * Выполнение действий в асинхронном режиме.
 * Выполнение проверок статуса сущностей.
 
-**Технические характеристики:**
+Технические характеристики:
 
 * Может быть развернут в нескольких экземплярах для обеспечения масштабируемости.
 * Использует Redis Streams для получения задач из очередей.
@@ -57,46 +59,46 @@ weight: 10
 
 ### Dex
 
-**Dex** — это компонент системы аутентификации и авторизации, выполняющий роль identity provider. Dex обеспечивает единую точку входа для пользователей и интегрируется с различными внешними провайдерами аутентификации.
+Dex — это компонент системы аутентификации и авторизации, выполняющий роль identity provider. Dex обеспечивает единую точку входа для пользователей и интегрируется с различными внешними провайдерами аутентификации.
 
 {{< alert level="warning" >}}
-**Dex** не входит в состав модуля DDP (Deckhouse Development Platform) и является частью DKP (Deckhouse Kubernetes Platform).
+Dex не входит в состав модуля DDP и является частью Deckhouse Kubernetes Platform (DKP).
 {{< /alert >}}
 
-**Основные функции:**
+Основные функции:
 
 * Управление процессом аутентификации пользователей.
 * Выдача токенов доступа.
 * Интеграция с внешними провайдерами аутентификации (Keycloak, LDAP и другими).
 * Предоставление ключей подписи для проверки токенов.
 
-**Технические характеристики:**
+Технические характеристики:
 
 * Выписывает токены для аутентификации в DDP Backend.
 * Периодически предоставляет ключи подписи токенов для проверки.
 * Интегрируется с внешними провайдерами аутентификации через стандартные протоколы (OIDC, LDAP и др.).
 
 ### Redis
 
-**Redis** — это хранилище данных в памяти, используемое платформой для работы с очередями задач.
+Redis — это хранилище данных в памяти, используемое платформой для работы с очередями задач.
 
 {{< alert level="info" >}}
 Redis может быть установлен в составе модуля DDP для тестовых и демонстрационных целей. В промышленной эксплуатации рекомендуется использование выделенных инстансов Redis.
 {{< /alert >}}
 
-**Основные функции:**
+Основные функции:
 
 * Реализация очередей задач через Redis Streams для асинхронной обработки.
 * Поддержка распределенных блокировок для координации работы нескольких экземпляров Worker.
 * Хранение событий, генерируемых при изменениях сущностей.
 
-**Технические характеристики:**
+Технические характеристики:
 
 * Используется для хранения очередей задач, которые обрабатываются DDP Worker.
 
 ### PostgreSQL
 
-**PostgreSQL** — это основная реляционная база данных платформы, используемая для хранения всей постоянной информации.
+PostgreSQL — это основная реляционная база данных платформы, используемая для хранения всей постоянной информации.
 
 {{< alert level="info" >}}
 PostgreSQL может быть установлен в составе модуля DDP для тестовых и демонстрационных целей. В промышленной эксплуатации рекомендуется использование выделенных инстансов PostgreSQL.
@@ -108,20 +110,20 @@ PostgreSQL может быть установлен в составе модул
 
 ### Входящие соединения
 
-* Пользователи подключаются к **DDP Frontend** по протоколу HTTPS (TCP/443) для работы с веб-интерфейсом.
-* Пользователи могут напрямую обращаться к **DDP Backend** по протоколу HTTPS (TCP/443) для использования REST API.
+* Пользователи подключаются к DDP Frontend по протоколу HTTPS (TCP/443) для работы с веб-интерфейсом.
+* Пользователи могут напрямую обращаться к DDP Backend по протоколу HTTPS (TCP/443) для использования REST API.
 
 ### Взаимодействие между компонентами платформы
 
-* **DDP Frontend** → **DDP Backend** (TCP/8080, опционально mTLS): Frontend передает запросы пользователей в Backend для обработки.
-* **DDP Backend** ↔ **Dex** (TCP/443): Backend получает ключи подписи от Dex для проверки токенов.
-* **DDP Backend** ↔ **Redis** (TCP/6379): Backend использует Redis для координации очередей задач и хранения событий.
-* **DDP Backend** ↔ **PostgreSQL** (TCP/5432): Backend выполняет операции чтения и записи постоянных данных.
-* **DDP Worker** ↔ **Redis** (TCP/6379): Worker получает задачи из очередей Redis Streams и использует распределенные блокировки.
-* **DDP Worker** ↔ **PostgreSQL** (TCP/5432): Worker обновляет данные в базе после выполнения задач.
+* DDP Frontend → DDP Backend (TCP/8080, опционально mTLS): Frontend передает запросы пользователей в Backend для обработки.
+* DDP Backend ↔ Dex (TCP/443): Backend получает ключи подписи от Dex для проверки токенов.
+* DDP Backend ↔ Redis (TCP/6379): Backend использует Redis для координации очередей задач и хранения событий.
+* DDP Backend ↔ PostgreSQL (TCP/5432): Backend выполняет операции чтения и записи постоянных данных.
+* DDP Worker ↔ Redis (TCP/6379): Worker получает задачи из очередей Redis Streams и использует распределенные блокировки.
+* DDP Worker ↔ PostgreSQL (TCP/5432): Worker обновляет данные в базе после выполнения задач.
 
 ### Интеграция с внешними сервисами
 
-* **Dex** ↔ **Провайдеры аутентификации** (Keycloak, LDAP и др.): Dex интегрируется с внешними системами управления пользователями.
-* **DDP Backend** ↔ **Инфраструктурные сервисы** (TCP/443): Backend взаимодействует с внешними сервисами для получения информации.
-* **DDP Worker** ↔ **Инфраструктурные сервисы** (TCP/443): Worker выполняет операции с внешними сервисами при синхронизации данных и выполнении действий.
+* Dex ↔ Провайдеры аутентификации (Keycloak, LDAP и др.): Dex интегрируется с внешними системами управления пользователями.
+* DDP Backend ↔ Инфраструктурные сервисы (TCP/443): Backend взаимодействует с внешними сервисами для получения информации.
+* DDP Worker ↔ Инфраструктурные сервисы (TCP/443): Worker выполняет операции с внешними сервисами при синхронизации данных и выполнении действий.