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`.
2.8 KiB
2.8 KiB
title, weight
| title | weight |
|---|---|
| Архитектура и философия | 1 |
Цель: изучить принципы проектирования, определяющие модульную структуру Quetza.
Философия проектирования
Соглашение важнее конфигурации (Convention over Configuration)
Quetza сокращает шаблонный код за счёт строгой структуры каталогов.
- Без центрального реестра: файловая система сама выступает реестром.
- Результат: чтобы подключить модуль, не нужно редактировать конфигурационные файлы — достаточно создать каталог.
Композиция важнее наследования (Composition over Inheritance)
Модули собираются из набора возможностей (capabilities), а не наследуются от базового класса.
- Гибкость: внутри модуля можно использовать любую архитектуру (функциональную или ООП), если модуль экспортирует обязательные интерфейсы.
Изоляция важнее интеграции (Isolation over Integration)
Модули не вызывают друг друга напрямую.
- Причина: исключает сильную связанность (tight coupling).
- Преимущество: любой модуль можно удалить без риска сломать остального бота.
Основные сущности
| Сущность | Роль | Жизненный цикл |
|---|---|---|
| Client | Локатор сервисов и оркестратор | Синглтон. Управляет всеми компонентами системы. |
| Module | Пространство имён для функций | Загружается при старте. |
| Command | Точка взаимодействия с пользователем | Без состояния (stateless). Запрос — ответ. |
| Event | Реактивный наблюдатель (observer) | Регистрируется при старте. |
| Controller | Менеджер состояния | Сохраняет состояние между запросами. |