🏠 На главную | 🧭 Руководство (RU) | 🛡️ Архитектура
🛡️ Обзор архитектуры и платформы (RU)
Этот раздел содержит высокоуровневый обзор архитектурных паттернов и основополагающих компонентов, предоставляемых библиотекой codex-core.
Структура доменов
Мы разделяем платформу на три основных домена, каждый из которых служит определенной цели:
| Домен | Описание | Основные компоненты |
|---|---|---|
| 🛡️ Core | Основные модели данных и безопасность. | BaseDTO, Маскировка PII, mask_value. |
| 🛠️ Common | Стандартизированные функции-утилиты. | normalize_phone, normalize_name, TaskLogContext. |
| ⚙️ Settings | Конфигурация инфраструктуры. | BaseCommonSettings, redis_url. |
Основные принципы
- Безопасность прежде всего: Защита PII интегрирована на уровне базового DTO.
- Неизменяемость: Модели данных по умолчанию заморожены для предотвращения побочных эффектов.
- Стандартизация: Общие задачи (телефон, имя, логирование) решаются один раз для всех проектов Codex.
- Удобство для разработчиков: Подробная документация и подсказки типов обеспечивают плавную работу.
Что дальше?
- Узнайте о 🛡️ Core: PII и DTO.
- Изучите 🛠️ Общие утилиты (Common).
- Разберитесь в ⚙️ Архитектуре настроек (Settings).