kern/v4/docs/index.md

kern -- модульные компоненты

kern позволяет строить проекты на модульном принципе. Этот принцип позволяет бесшовно переходить от модульного монолита к микросервисам. Первый подход (монолит) удобен в стартапах. Второй подход удобен, когда понятно, какие части масштабировать.

---

🎯 Что это?

kern — фреймворк для создания модульных компонентов ядра с высокой надёжностью. Он поддерживает эволюцию от модульного монолита к микросервисной архитектуре без потери производительности или надёжности.

Ключевые принципы

• Модульность — изолированные компоненты с чёткими границами
• Надёжность — 100% покрытие тестами, strict типизация
• Эволюция — монолит → микросервисы без больших refactors
• Документация — прямые и обратные ссылки между материалами

---

📦 Ядро

Базовые компоненты и интерфейсы для построения надёжных микросервисов.

Состав проекта

• Алиасы — пользовательские типы для усиления типизации
• Типы (интерфейсы) — интерфейсы для ослабления зацепления
• Шина — реактивная шина сообщений
• Контекст ядра — центральный контекст для компонентов
• Модули — структура модульной архитектуры
• Монолит — подход модульного монолита
• Сервер HTTP — встроенный HTTP-сервер
• Хранилище key-value — быстрое хранилище данных

---

🧩 Компоненты

Вспомогательные утилиты для работы с контекстом, логированием и типизацией.

• Помощники — полезные утилиты
• Локальный контекст — контекст на уровне компонента
• Буфер логирования — реактивный буфер логов
• Потокобезопасный реактивный bool — реактивный буфер
• Потокобезопасный int — реактивный счётчик
• Потокобезопасный string — реактивная строка

---

🏗️ Модули

Готовые модульные компоненты с собственной логикой и конфигурацией.

• Модуль контекста ядра — центральный контекст
• Модуль сторожа ядра — сторож компонентов
• Модуль сервера HTTP — HTTP-сервер
• Модуль веб-интерфейса — веб-интерфейс

---

🔗 Обратные связи

Из ядра

• Ядро → Компоненты
• Ядро → Модули

Из компонентов

• Помощники → Ядро

Из модулей

• Модуль контекста → Ядро
• Модуль HTTP → Сервер HTTP

---

📚 Дополнительные материалы

• Типы интерфейсов — интерфейсы для ослабления зацепления
• IDictTopicServe — кастомный обработчик входящих запросов

---

📖 Навигация

Быстрый старт

• Начните здесь →
• Ядро →
• Компоненты →
• Модули →

Для разработчиков

• Архитектура →
• Типизация →
• Модульность →

Для администраторов

• Контекст →
• Логирование →
• HTTP сервер →

---

🔄 Обновления

• v4 — текущая версия
• v3 — предыдущая версия

Сделать

• +++ разложить Hassert и Assert на условия и действие!!!
• перевести все базовые типы на внутренние
• контрактные внутренние типы;
• TUF сериализация/десериализация (собственная разработка, замена JSON);
• сильное разделение на модули (WASI);
• WASI модули (для надёжных модульных монолитов);
• HTTP-сервер на stdlib (для PWA и WASM приложений);
• KeyValue хранилище (собственная реализация);
• KeyValue хранилище (поверх SQLite, надёжное);

Вернуться наверх ↑