deytenit
b3638f4d63
🤖 PR generated for branch `fix/cyrillic-fonts-dev-certs-and-page-head`.
### Changes Summary
- **Fonts**: Add Cyrillic glyph subsets for Lato, EB Garamond, and Fira
Code.
- **Dev**: Support remote Root CA and encrypted dev CA key in
`.env.dev`.
- **UI & Kits**: Add size variant to `Breadcrumbs` component and enlarge
`PageHead` breadcrumbs with tuned collapse scroll threshold.
- **ESLint**: Add `no-hanging-particles` i18n & markdown typography rule
with auto-fixer.
- **Content & i18n**: Apply `ru-text` editorial and typography polish
(em dashes, number ranges, «ё» restoration, non-breaking spaces) across
`services/www` and `services/docs`.
46 lines
2.8 KiB
Markdown
46 lines
2.8 KiB
Markdown
---
|
|
title: Архитектура и философия
|
|
weight: 1
|
|
---
|
|
|
|
**Цель:** изучить принципы проектирования, определяющие модульную структуру Quetza.
|
|
|
|
## Философия проектирования
|
|
|
|
### Соглашение важнее конфигурации (Convention over Configuration)
|
|
|
|
Quetza сокращает шаблонный код за счёт строгой структуры каталогов.
|
|
|
|
- **Без центрального реестра:** файловая система сама выступает реестром.
|
|
- **Результат:** чтобы подключить модуль, не нужно редактировать конфигурационные файлы — достаточно создать каталог.
|
|
|
|
### Композиция важнее наследования (Composition over Inheritance)
|
|
|
|
Модули собираются из набора возможностей (capabilities), а не наследуются от базового класса.
|
|
|
|
- **Гибкость:** внутри модуля можно использовать любую архитектуру (функциональную или ООП), если модуль экспортирует обязательные интерфейсы.
|
|
|
|
### Изоляция важнее интеграции (Isolation over Integration)
|
|
|
|
Модули не вызывают друг друга напрямую.
|
|
|
|
- **Причина:** исключает сильную связанность (tight coupling).
|
|
- **Преимущество:** любой модуль можно удалить без риска сломать остального бота.
|
|
|
|
## Основные сущности
|
|
|
|
| Сущность | Роль | Жизненный цикл |
|
|
| :--- | :--- | :--- |
|
|
| **Client** | Локатор сервисов и оркестратор | Синглтон. Управляет всеми компонентами системы. |
|
|
| **Module** | Пространство имён для функций | Загружается при старте. |
|
|
| **Command** | Точка взаимодействия с пользователем | Без состояния (stateless). Запрос — ответ. |
|
|
| **Event** | Реактивный наблюдатель (observer) | Регистрируется при старте. |
|
|
| **Controller** | Менеджер состояния | Сохраняет состояние между запросами. |
|
|
|
|
---
|
|
|
|
## См. также
|
|
|
|
- [Паттерн Service Locator](https://ru.wikipedia.org/wiki/Локатор_служб)
|
|
- [Паттерн Observer](https://ru.wikipedia.org/wiki/Наблюдатель_(шаблон_проектирования))
|