@dxtmisha/wiki 0.25.1 → 0.39.2

package/src/media/functional/functional-basic/classes/ErrorCenter/ErrorCenter.ru.mdx

@@ -0,0 +1,95 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ErrorCenter - Управление ошибками'/>
+
+# ErrorCenter
+
+Статическая обертка для `ErrorCenterInstance`, предоставляющая централизованное управление хранением, извлечением и обработкой ошибок. Он выступает в роли глобального реестра причин ошибок и предоставляет механизм для регистрации и вызова пользовательских обработчиков для различных групп ошибок.
+
+Класс следует паттерну "Статического моста", делегируя все операции синглтон-экземпляру, сохраняя при этом чистый, глобально доступный API.
+
+## Ключевые особенности
+
+- **Статический доступ** — глобальный статус к управлению ошибками без необходимости ручного создания экземпляров.
+- **Централизованный реестр** — хранит стандартизированные причины ошибок для единообразной обратной связи.
+- **Групповая обработка** — позволяет регистрировать несколько функций обратного вызова для конкретных категорий.
+- **Chainable API** — методы добавления причин и обработчиков поддерживают цепочки вызовов.
+- **Предустановленные значения** — по умолчанию настроен стандартными сетевыми ошибками (`timeout`, `offline`, `notFound` и т.д.).
+
+## Методы проверки
+
+- `has(code: string, group?: string): boolean` — Проверяет наличие причины ошибки в реестре.
+- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Извлекает полный объект причины ошибки.
+
+## Получение инстанса
+
+- `getItem(): ErrorCenterInstance` — Возвращает базовый экземпляр, используемый оберткой.
+
+## Конфигурация
+
+- `add(cause: ErrorCenterCauseItem): this` — Добавляет одну причину ошибки в хранилище.
+- `addList(causes: ErrorCenterCauseList): this` — Добавляет список причин ошибок в реестр.
+- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Регистрирует функцию обратного вызова для группы.
+- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Регистрирует набор обработчиков.
+
+## Методы действий
+
+### `on`
+
+Запускает обработку указанной ошибки. Метод ищет предварительно зарегистрированные данные для указанного кода ошибки, объединяет их с входной причиной (`cause`), выполняет все зарегистрированные обработчики для этой группы и выводит ошибку в консоль.
+
+**Параметры:**
+- `cause: ErrorCenterCauseItem` — Причина для запуска. Код и группа обязательны, если причина была зарегистрирована ранее через `add()`.
+
+**Возвращает:** `this`
+
+## Типы
+
+### `ErrorCenterCauseItem`
+
+Основной объект, используемый для определения причины ошибки.
+
+- `group?: ErrorCenterGroup` — категория/группа, к которой относится ошибка.
+- `code: string` — уникальный идентификатор ошибки.
+- `label?: string` — понятное человеку название ошибки.
+- `message?: string` — подробное описание ошибки.
+- `details?: any` — необязательный объект для дополнительных данных.
+
+### `ErrorCenterGroup`
+
+Простое определение типа для категорий ошибок: `string | undefined`.
+
+## Стандартные причины ошибок
+
+`ErrorCenter` автоматически наполняется следующими стандартными сетевыми причинами:
+
+- `unknown` — **Неизвестная ошибка**: Произошла непредвиденная ошибка. Пожалуйста, попробуйте еще раз.
+- `timeout` — **Тайм-аут запроса**: Запрос занял слишком много времени. Пожалуйста, проверьте соединение.
+- `offline` — **Нет соединения**: Вы находитесь в автономном режиме. Пожалуйста, проверьте интернет-соединение.
+- `notFound` — **Не найдено**: Запрошенный ресурс не найден.
+- `server` — **Ошибка сервера**: Произошла внутренняя ошибка сервера.
+
+## Пример использования
+
+```javascript
+import { ErrorCenter } from '@dxtmisha/functional-basic'
+
+// 1. Настройка глобальных обработчиков
+ErrorCenter.addHandler('api', (cause) => {
+  notification.error({
+    title: cause.label,
+    message: cause.message
+  })
+})
+
+// 2. Регистрация специфических причин ошибок
+ErrorCenter.add({
+  group: 'auth',
+  code: 'token_expired',
+  label: 'Сессия истекла',
+  message: 'Ваша сессия истекла. Пожалуйста, войдите снова.'
+})
+
+// 3. Вызов ошибки через реестр
+ErrorCenter.on({ group: 'auth', code: 'token_expired' })
+```

package/src/media/functional/functional-basic/classes/ErrorCenter/ErrorCenter.vi.mdx

@@ -0,0 +1,95 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/ErrorCenter - Quản lý lỗi'/>
+
+# ErrorCenter
+
+Một lớp tĩnh (static wrapper) cho `ErrorCenterInstance` cung cấp quản lý tập trung cho việc lưu trữ, truy xuất và xử lý lỗi dựa trên sự kiện. Nó đóng vai trò như một bộ lưu trữ toàn cầu cho các nguyên nhân gây lỗi và cung cấp cơ chế để đăng ký cũng như kích hoạt các trình xử lý tùy chỉnh cho các nhóm lỗi khác nhau.
+
+Lớp này tuân theo mô hình "Static Bridge", chuyển giao tất cả các hoạt động cho một thực thể duy nhất (singleton instance) trong khi vẫn duy trì một API sạch sẽ, có thể truy cập toàn cầu.
+
+## Các tính năng chính
+
+- **Truy cập tĩnh** — Truy cập toàn cầu vào quản lý lỗi mà không cần khởi tạo thủ công.
+- **Bộ lưu trữ tập trung** — Lưu trữ các nguyên nhân lỗi được tiêu chuẩn hóa để phản hồi UI nhất quán.
+- **Xử lý theo nhóm** — Cho phép đăng ký nhiều hàm gọi lại cho các danh mục lỗi cụ thể.
+- **Chainable API** — Các phương thức thêm nguyên nhân và trình xử lý hỗ trợ thiết kế giao diện linh hoạt.
+- **Giá trị mặc định** — Đi kèm với các nguyên nhân lỗi mạng tiêu chuẩn (`timeout`, `offline`, `notFound`, v.v.).
+
+## Các phương thức kiểm tra
+
+- `has(code: string, group?: string): boolean` — Kiểm tra xem một nguyên nhân lỗi có tồn tại trong bộ lưu trữ hay không.
+- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Truy xuất đối tượng nguyên nhân lỗi đầy đủ.
+
+## Truy xuất thực thể
+
+- `getItem(): ErrorCenterInstance` — Trả về thực thể nền tảng được sử dụng bởi lớp tĩnh.
+
+## Cấu hình
+
+- `add(cause: ErrorCenterCauseItem): this` — Thêm một nguyên nhân lỗi duy nhất vào bộ lưu trữ toàn cầu.
+- `addList(causes: ErrorCenterCauseList): this` — Thêm nhiều nguyên nhân lỗi vào bộ lưu trữ cùng một lúc.
+- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Đăng ký một hàm gọi lại cho một nhóm lỗi cụ thể.
+- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Đăng ký một loạt các trình xử lý.
+
+## Các phương thức hành động
+
+### `on`
+
+Kích hoạt xử lý lỗi cho nguyên nhân được chỉ định. Nó tìm kiếm dữ liệu đã đăng ký trước đó cho mã lỗi (nếu có), hợp nhất với nguyên nhân đầu vào (`cause`), thực thi tất cả các trình xử lý đã đăng ký cho nhóm đó và ghi lỗi vào bảng điều khiển (console).
+
+**Tham số:**
+- `cause: ErrorCenterCauseItem` — Nguyên nhân lỗi cần kích hoạt. Chỉ cần cung cấp mã và nhóm nếu nguyên nhân đó đã được đăng ký trước đó qua `add()`.
+
+**Trả về:** `this`
+
+## Các kiểu dữ liệu
+
+### `ErrorCenterCauseItem`
+
+Đối tượng chính được sử dụng để xác định nguyên nhân gây lỗi.
+
+- `group?: ErrorCenterGroup` — danh mục/nhóm mà lỗi thuộc về.
+- `code: string` — mã định danh duy nhất cho lỗi.
+- `label?: string` — tên lỗi dễ đọc cho người dùng.
+- `message?: string` — mô tả chi tiết về lỗi.
+- `details?: any` — đối tượng tùy chọn cho các dữ liệu bổ sung.
+
+### `ErrorCenterGroup`
+
+Định nghĩa kiểu đơn giản để phân loại lỗi: `string | undefined`.
+
+## Các nguyên nhân lỗi mặc định
+
+`ErrorCenter` được điền sẵn tự động với các nguyên nhân mạng tiêu chuẩn sau:
+
+- `unknown` — **Lỗi không xác định**: Đã xảy ra lỗi không mong muốn. Vui lòng thử lại.
+- `timeout` — **Yêu cầu hết hạn**: Yêu cầu mất quá nhiều thời gian. Vui lòng kiểm tra kết nối.
+- `offline` — **Không có kết nối**: Bạn đang ngoại tuyến. Vui lòng kiểm tra mạng.
+- `notFound` — **Không tìm thấy**: Tài nguyên được yêu cầu không thể tìm thấy.
+- `server` — **Lỗi máy chủ**: Đã xảy ra lỗi nội bộ máy chủ.
+
+## Ví dụ sử dụng
+
+```javascript
+import { ErrorCenter } from '@dxtmisha/functional-basic'
+
+// 1. Cấu hình trình xử lý toàn cục
+ErrorCenter.addHandler('api', (cause) => {
+  notification.error({
+    title: cause.label,
+    message: cause.message
+  })
+})
+
+// 2. Đăng ký các nguyên nhân lỗi cụ thể
+ErrorCenter.add({
+  group: 'auth',
+  code: 'token_expired',
+  label: 'Phiên làm việc hết hạn',
+  message: 'Vui lòng đăng nhập lại.'
+})
+
+// 3. Kích hoạt lỗi qua mã và nhóm
+ErrorCenter.on({ group: 'auth', code: 'token_expired' })
+```

package/src/media/functional/functional-basic/classes/ErrorCenterHandler/ErrorCenterHandler.en.mdx

@@ -0,0 +1,69 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/ErrorCenterHandler - Handler Management'/>
+
+# ErrorCenterHandler
+
+A core utility class for managing and triggering error handlers based on defined groups. It allows for flexible error response strategies, such as showing global notifications for API errors while performing silent logging for background tasks.
+
+## Key Features
+
+- **Handler Registration** — Easily add multiple callback functions to specific error groups.
+- **Group Filtering** — Target specific categories of errors (e.g., `api`, `auth`, `validation`).
+- **Global Fallback** — Support for an `undefined` group handler that catches any error without a specific handler.
+- **Sequential Execution** — Triggers all registered callbacks for a group in the order they were added.
+- **Integrated Logging** — Automatically outputs error details to the browser console for debugging.
+
+## Check Methods
+
+- `has(group: ErrorCenterGroup): boolean` — Checks if any handlers are registered for a specific group.
+- `get(group: ErrorCenterGroup): ErrorCenterHandlerItem | undefined` — Retrieves the handler mapping for a group.
+
+## Configuration
+
+- `add(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Adds a single callback function to a group.
+- `addList(handlers: ErrorCenterHandlerList): this` — Registers a batch of handlers.
+
+## Action Methods
+
+### `on`
+
+Triggers all registered handlers for the provided error cause's group. If no specific handlers are found, it falls back to the handlers registered for the `undefined` group (if any). Always logs the error details to the console internally.
+
+**Parameters:**
+- `cause: ErrorCenterCauseItem` — The error details to pass to handlers.
+
+**Returns:** `this`
+
+## Types
+
+### `ErrorCenterHandlerCallback`
+
+The function signature for error handling callbacks.
+
+- `(cause: ErrorCenterCauseItem) => void` — Receives the merged error cause object.
+
+## Usage Example
+
+```javascript
+import { ErrorCenterHandler } from '@dxtmisha/functional-basic'
+
+const handlerManager = new ErrorCenterHandler()
+
+// 1. Register a specific group handler
+handlerManager.add('api', (cause) => {
+  console.log('[API Handler]', cause.message)
+})
+
+// 2. Register a global fallback handler
+handlerManager.add(undefined, (cause) => {
+  console.error('[Global Fallback]', cause.code)
+})
+
+// 3. Triggering an error
+handlerManager.on({
+  group: 'api',
+  code: '500',
+  message: 'Internal Server Error'
+})
+```

package/src/media/functional/functional-basic/classes/ErrorCenterHandler/ErrorCenterHandler.ru.mdx

@@ -0,0 +1,69 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ErrorCenterHandler - Управление обработчиками'/>
+
+# ErrorCenterHandler
+
+Основной вспомогательный класс для управления и вызова обработчиков ошибок на основе определенных групп. Он позволяет реализовывать гибкие стратегии реагирования на ошибки, такие как отображение глобальных уведомлений для ошибок API при выполнении скрытого логирования для фоновых задач.
+
+## Ключевые особенности
+
+- **Регистрация обработчиков** — Удобное добавление нескольких функций обратного вызова к конкретным группам.
+- **Групповая фильтрация** — Возможность нацеливаться на конкретные категории ошибок.
+- **Глобальный обработчик** — Поддержка группы `undefined`, которая перехватывает любую ошибку без специфического обработчика.
+- **Последовательное выполнение** — Запускает все зарегистрированные функции в порядке их добавления.
+- **Интегрированное логирование** — Автоматически выводит детали ошибки в консоль браузера.
+
+## Методы проверки
+
+- `has(group: ErrorCenterGroup): boolean` — Проверяет, зарегистрированы ли обработчики для группы.
+- `get(group: ErrorCenterGroup): ErrorCenterHandlerItem | undefined` — Извлекает элемент обработчика для группы.
+
+## Конфигурация
+
+- `add(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Добавляет одну функцию обратного вызова в группу.
+- `addList(handlers: ErrorCenterHandlerList): this` — Регистрирует пакет обработчиков.
+
+## Методы действий
+
+### `on`
+
+Запускает все зарегистрированные обработчики для группы предоставленной причины ошибки. Если специфические обработчики не найдены, метод переходит к обработчикам, зарегистрированным для группы `undefined` (если они есть). Всегда выводит детали ошибки в консоль внутри.
+
+**Параметры:**
+- `cause: ErrorCenterCauseItem` — Детали ошибки для передачи обработчикам.
+
+**Возвращает:** `this`
+
+## Типы
+
+### `ErrorCenterHandlerCallback`
+
+Сигнатура функции для обратных вызовов обработки ошибок.
+
+- `(cause: ErrorCenterCauseItem) => void` — получает объединенный объект причины ошибки.
+
+## Пример использования
+
+```javascript
+import { ErrorCenterHandler } from '@dxtmisha/functional-basic'
+
+const handlerManager = new ErrorCenterHandler()
+
+// 1. Регистрация обработчика конкретной группы
+handlerManager.add('api', (cause) => {
+  console.log('[API Handler]', cause.message)
+})
+
+// 2. Регистрация глобального обработчика
+handlerManager.add(undefined, (cause) => {
+  console.error('[Global Fallback]', cause.code)
+})
+
+// 3. Вызов ошибки
+handlerManager.on({
+  group: 'api',
+  code: '500',
+  message: 'Внутренняя ошибка сервера'
+})
+```

package/src/media/functional/functional-basic/classes/ErrorCenterHandler/ErrorCenterHandler.vi.mdx

@@ -0,0 +1,69 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/vi/functional-basic/Classes/ErrorCenterHandler - Quản lý trình xử lý'/>
+
+# ErrorCenterHandler
+
+Một lớp tiện ích cốt lõi để quản lý và kích hoạt các trình xử lý lỗi dựa trên các nhóm đã được định nghĩa. Nó cho phép các chiến lược phản hồi lỗi linh hoạt, chẳng hạn như hiển thị thông báo toàn cục cho các lỗi API trong khi thực hiện ghi nhật ký âm thầm cho các tác vụ nền.
+
+## Các tính năng chính
+
+- **Đăng ký trình xử lý** — Dễ dàng thêm nhiều hàm gọi lại cho các nhóm lỗi cụ thể.
+- **Lọc theo nhóm** — Nhắm mục tiêu các danh mục lỗi cụ thể (ví dụ: `api`, `auth`, `validation`).
+- **Dự phòng toàn cục** — Hỗ trợ trình xử lý cho nhóm `undefined` để bắt bất kỳ lỗi nào không có trình xử lý cụ thể.
+- **Thực thi tuần tự** — Kích hoạt tất cả các hàm gọi lại theo thứ tự chúng được thêm vào.
+- **Tích hợp ghi nhật ký** — Tự động xuất chi tiết lỗi ra console trình duyệt.
+
+## Các phương thức kiểm tra
+
+- `has(group: ErrorCenterGroup): boolean` — Kiểm tra xem có trình xử lý nào được đăng ký cho một nhóm không.
+- `get(group: ErrorCenterGroup): ErrorCenterHandlerItem | undefined` — Truy xuất ánh xạ trình xử lý cho một nhóm.
+
+## Cấu hình
+
+- `add(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Thêm một hàm gọi lại cho một nhóm.
+- `addList(handlers: ErrorCenterHandlerList): this` — Đăng ký một loạt các trình xử lý.
+
+## Các phương thức hành động
+
+### `on`
+
+Kích hoạt tất cả các trình xử lý đã đăng ký cho nhóm của nguyên nhân lỗi được cung cấp. Nếu không tìm thấy trình xử lý cụ thể nào, nó sẽ quay về các trình xử lý được đăng ký cho nhóm `undefined` (nếu có). Luôn xuất chi tiết lỗi ra bảng điều khiển nội bộ.
+
+**Tham số:**
+- `cause: ErrorCenterCauseItem` — Chi tiết lỗi để chuyển cho các trình xử lý.
+
+**Trả về:** `this`
+
+## Các kiểu dữ liệu
+
+### `ErrorCenterHandlerCallback`
+
+Hàm cho các callback xử lý lỗi.
+
+- `(cause: ErrorCenterCauseItem) => void` — Nhận đối tượng nguyên nhân lỗi đã được hợp nhất.
+
+## Ví dụ sử dụng
+
+```javascript
+import { ErrorCenterHandler } from '@dxtmisha/functional-basic'
+
+const handlerManager = new ErrorCenterHandler()
+
+// 1. Đăng ký trình xử lý cho nhóm cụ thể
+handlerManager.add('api', (cause) => {
+  console.log('[API Handler]', cause.message)
+})
+
+// 2. Đăng ký trình xử lý dự phòng toàn cục
+handlerManager.add(undefined, (cause) => {
+  console.error('[Global Fallback]', cause.code)
+})
+
+// 3. Kích hoạt một lỗi
+handlerManager.on({
+  group: 'api',
+  code: '500',
+  message: 'Lỗi máy chủ nội bộ'
+})
+```

package/src/media/functional/functional-basic/classes/ErrorCenterInstance/ErrorCenterInstance.en.mdx

@@ -0,0 +1,123 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/en/functional-basic/Classes/ErrorCenterInstance - Error Instance'/>
+
+# ErrorCenterInstance
+
+A class for managing error storage and handling within a specific instance. It provides the core logic for maintaining a registry of error causes and orchestrating their notification through a handler manager.
+
+While `ErrorCenter` provides a global static bridge, `ErrorCenterInstance` can be used directly for isolated error tracking or custom error management systems.
+
+## Key Features
+
+- **Isolated Storage** — Maintain a local list of error causes separate from the global state.
+- **Data Merging** — Automatically supplements triggered errors with pre-registered label and message data.
+- **Handler Delegation** — Uses a dedicated `ErrorCenterHandler` to manage and execute callbacks.
+- **Predefined Causes** — Can be initialized with a list of default error causes.
+- **Chainable Methods** — Supports fluent configuration for adding causes and handlers.
+
+## Check Methods
+
+- `has(code: string, group?: string): boolean` — Checks if a cause exists in the instance's registry.
+- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Retrieves the stored error cause object.
+
+## Configuration
+
+- `add(cause: ErrorCenterCauseItem): this` — Adds a single error cause to the storage.
+- `addList(causes: ErrorCenterCauseList): this` — Adds multiple error causes.
+- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Registers a callback for a specific error group.
+- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Registers a collection of handlers.
+
+## Action Methods
+
+### `on`
+
+Triggers error handling. It looks up the pre-registered data for the provided error code, merges it with the input `cause`, and passes it to the internal handler.
+
+**Parameters:**
+- `cause: ErrorCenterCauseItem` — The error information to trigger.
+
+**Returns:** `this`
+
+## Types
+
+### `ErrorCenterCauseItem`
+
+The main object used to define an error cause in this instance.
+
+- `group?: ErrorCenterGroup` — The category/group the error belongs to.
+- `code: string` — Unique identifier for the error.
+- `label?: string` — Human-readable name of the error.
+- `message?: string` — Detailed description of the error.
+- `details?: any` — Optional object for additional context or technical data.
+
+## Guide: Managing Errors and Listeners
+
+Using the `ErrorCenterInstance` involves three main steps: defining error causes, setting up listeners (handlers), and triggering the errors.
+
+### 1. Adding Error Causes
+
+Error causes act as a dictionary for your application. By pre-registering them, you ensure that consistent labels and messages are used throughout your platform.
+
+```javascript
+import { ErrorCenterInstance } from '@dxtmisha/functional-basic'
+
+const myErrorCenter = new ErrorCenterInstance()
+
+// Register a single error cause
+myErrorCenter.add({
+  group: 'auth',
+  code: 'token_expired',
+  label: 'Session Expired',
+  message: 'Your login session has expired. Please log in again.'
+})
+
+// Register multiple causes at once
+myErrorCenter.addList([
+  { group: 'api', code: '404', label: 'Not Found', message: 'The requested data does not exist.' },
+  { group: 'api', code: '500', label: 'Server Error', message: 'Something went wrong on the server.' }
+])
+```
+
+### 2. Adding Listeners
+
+Listeners (handlers) are callback functions that execute when a specific error occurs. You assign listeners to a specific `group` so they only react to relevant errors.
+
+```javascript
+// Add a listener specifically for the "auth" group
+myErrorCenter.addHandler('auth', (cause) => {
+  // E.g., redirect to login or show an alert
+  console.log(`[AUTH ERROR] ${cause.label}: ${cause.message}`)
+})
+
+// Add a listener for the "api" group
+myErrorCenter.addHandler('api', (cause) => {
+  // E.g., show a toast notification
+  console.error(`[API ERROR ${cause.code}] ${cause.message}`)
+})
+
+// Add a global fallback listener (catches errors without a specific group handler)
+myErrorCenter.addHandler(undefined, (cause) => {
+  console.warn(`[UNKNOWN ERROR]`, cause)
+})
+```
+
+### 3. Triggering Errors
+
+When an error occurs in your application, you trigger the handling process using the `on` method. You only need to provide the `code` and the `group`. The `ErrorCenterInstance` will automatically merge this with the pre-registered `label` and `message` before passing it to the listeners.
+
+```javascript
+// Trigger an authentication error
+// The listeners for "auth" will receive the full ErrorCenterCauseItem
+myErrorCenter.on({
+  group: 'auth',
+  code: 'token_expired'
+})
+
+// Trigger an unregistered error (will fallback to the undefined group listener)
+myErrorCenter.on({
+  group: 'database',
+  code: 'connection_lost',
+  message: 'Lost connection to DB.' // You can pass inline data as well
+})
+```

package/src/media/functional/functional-basic/classes/ErrorCenterInstance/ErrorCenterInstance.ru.mdx

@@ -0,0 +1,123 @@
+import {Meta} from '@storybook/addon-docs/blocks'
+
+<Meta title='@dxtmisha/ru/functional-basic/Classes/ErrorCenterInstance - Экземпляр ошибок'/>
+
+# ErrorCenterInstance
+
+Класс для управления хранилищем ошибок и их обработкой внутри конкретного экземпляра. Он обеспечивает основную логику для ведения реестра причин ошибок и организации уведомлений о них через менеджер обработчиков.
+
+Хотя `ErrorCenter` предоставляет глобальный статический мост, `ErrorCenterInstance` можно использовать напрямую для изолированного отслеживания ошибок или создания пользовательских систем управления.
+
+## Ключевые особенности
+
+- **Изолированное хранилище** — Ведение локального списка причин ошибок отдельно от глобального состояния.
+- **Объединение данных** — Автоматически дополняет возникающие ошибки данными о заголовках и сообщениях из реестра.
+- **Делегирование обработки** — Использует выделенный `ErrorCenterHandler` для выполнения функций обратного вызова.
+- **Предопределенные причины** — Может быть инициализирован со списком причин ошибок по умолчанию.
+- **Chainable API** — Поддерживает удобную конфигурацию для добавления причин и обработчиков.
+
+## Методы проверки
+
+- `has(code: string, group?: string): boolean` — Проверяет, существует ли причина с конкретным кодом в реестре.
+- `get(code: string, group?: string): ErrorCenterCauseItem | undefined` — Извлекает сохраненный объект причины ошибки.
+
+## Конфигурация
+
+- `add(cause: ErrorCenterCauseItem): this` — Добавляет одну причину ошибки в хранилище экземпляра.
+- `addList(causes: ErrorCenterCauseList): this` — Добавляет список причин ошибок.
+- `addHandler(group: ErrorCenterGroup, handler: ErrorCenterHandlerCallback): this` — Регистрирует обработчик для конкретной группы.
+- `addHandlerList(handlers: ErrorCenterHandlerList): this` — Регистрирует список обработчиков.
+
+## Методы действий
+
+### `on`
+
+Запускает обработку ошибки. Метод ищет предварительно зарегистрированные данные для указанного кода ошибки, объединяет их с входной причиной (`cause`) и передает внутреннему обработчику.
+
+**Параметры:**
+- `cause: ErrorCenterCauseItem` — Информация об ошибке для запуска.
+
+**Возвращает:** `this`
+
+## Типы
+
+### `ErrorCenterCauseItem`
+
+Основной объект, используемый для определения причины ошибки в этом экземпляре.
+
+- `group?: ErrorCenterGroup` — категория/группа, к которой относится ошибка.
+- `code: string` — уникальный идентификатор ошибки.
+- `label?: string` — понятное человеку название ошибки.
+- `message?: string` — подробное описание ошибки.
+- `details?: any` — необязательный объект для дополнительных данных.
+
+## Руководство: Управление причинами ошибок и обработчиками
+
+Использование `ErrorCenterInstance` включает три основных шага: определение причин ошибок, настройка слушателей (обработчиков) и вызов ошибок.
+
+### 1. Добавление причин ошибок
+
+Причины ошибок действуют как словарь для вашего приложения. Предварительно регистрируя их, вы обеспечиваете единообразие заголовков и сообщений по всей платформе.
+
+```javascript
+import { ErrorCenterInstance } from '@dxtmisha/functional-basic'
+
+const myErrorCenter = new ErrorCenterInstance()
+
+// Регистрация одной причины ошибки
+myErrorCenter.add({
+  group: 'auth',
+  code: 'token_expired',
+  label: 'Сессия истекла',
+  message: 'Срок действия вашей сессии истек. Пожалуйста, войдите снова.'
+})
+
+// Регистрация нескольких причин сразу
+myErrorCenter.addList([
+  { group: 'api', code: '404', label: 'Не найдено', message: 'Запрошенные данные не существуют.' },
+  { group: 'api', code: '500', label: 'Ошибка сервера', message: 'На сервере что-то пошло не так.' }
+])
+```
+
+### 2. Добавление слушателей
+
+Слушатели (обработчики) — это функции обратного вызова, которые выполняются при возникновении определенной ошибки. Вы назначаете слушателей для конкретной группы (`group`), чтобы они реагировали только на соответствующие ошибки.
+
+```javascript
+// Добавление слушателя специально для группы "auth"
+myErrorCenter.addHandler('auth', (cause) => {
+  // Например, перенаправление на страницу входа или показ уведомления
+  console.log(`[ОШИБКА АВТОРИЗАЦИИ] ${cause.label}: ${cause.message}`)
+})
+
+// Добавление слушателя для группы "api"
+myErrorCenter.addHandler('api', (cause) => {
+  // Например, показ всплывающего уведомления
+  console.error(`[ОШИБКА API ${cause.code}] ${cause.message}`)
+})
+
+// Добавление глобального запасного слушателя (перехватывает ошибки без специфического обработчика)
+myErrorCenter.addHandler(undefined, (cause) => {
+  console.warn(`[НЕИЗВЕСТНАЯ ОШИБКА]`, cause)
+})
+```
+
+### 3. Вызов ошибок
+
+Когда в вашем приложении происходит ошибка, вы запускаете процесс обработки с помощью метода `on`. Вам нужно указать только код (`code`) и группу (`group`). `ErrorCenterInstance` автоматически объединит это с предварительно зарегистрированными данными (`label` и `message`) перед передачей слушателям.
+
+```javascript
+// Запуск ошибки авторизации
+// Слушатели для "auth" получат полный объект ErrorCenterCauseItem
+myErrorCenter.on({
+  group: 'auth',
+  code: 'token_expired'
+})
+
+// Запуск незарегистрированной ошибки (сработает обработчик группы undefined)
+myErrorCenter.on({
+  group: 'database',
+  code: 'connection_lost',
+  message: 'Потеряно соединение с БД.' // Данные можно передавать "на лету"
+})
+```