Раздел описывает технические аспекты реализации платформы AIOps: архитектуру сервисов, паттерны разработки, стандарты кода и инструменты.
По задаче
| Задача | Куда смотреть |
|---|---|
| Найти сервис, его API и зависимости | Services → Service Catalog |
| Паттерны backend (Clean Arch, Outbox, UoW) | Backend → Service Patterns, Event-Driven |
| Схемы событий Kafka, контракты данных | Data → Event Schema Catalog, Data Contracts |
| Как писать API (gRPC, REST) | Backend / API Guidelines |
| Тесты, QA, качество | QA/Quality |
| Frontend (planned) | Frontend |
Основные направления
Services
Каталог всех сервисов платформы с детальным описанием архитектуры, зависимостей и API.
Текущие сервисы: - Identity service — canonical identity registry - Credential service — isolated credential storage - API Gateway — trust boundary
Запланированные: - Auth Service, Session Token service, Account service, Herald, Cloud service
Подробнее: Services
Backend
Архитектурные паттерны, best practices и стандарты backend-разработки.
Ключевые паттерны: - Clean Architecture (Core, Use Case, Infrastructure, API) - Transactional Outbox для событий - Unit of Work для транзакций - Repository Pattern для доступа к данным
Подробнее: Backend
Frontend
Архитектура frontend-приложений, UI компоненты, state management.
Статус: Planned
Подробнее: Frontend
Data
Архитектура данных, ETL/ELT пипелайны, data warehouse, качество данных.
Ключевые темы: - Event Schema Catalog — каталог событий Kafka - Data Contracts — контракты между сервисами - Data Warehouse — аналитическое хранилище
Подробнее: Data
ML/DS
Machine Learning и Data Science: модели, feature store, training/inference пипелайны.
Статус: Planned
Подробнее: ML/DS
QA/Quality
Стратегия тестирования, тестовые окружения, автоматизация.
Подробнее: QA
Технологический стек
Backend
- Языки: Python 3.12+, Go 1.26
- Frameworks: gRPC, FastAPI (planned), Envoy
- ORM: SQLAlchemy 2.x (async)
- DI: Dishka 1.7+
Data Stores
- PostgreSQL — основное хранилище (Crunchy PGO)
- Redis — кеширование, rate limiting (Redis Operator)
- Kafka — event streaming (Strimzi Operator)
Observability
- Metrics: Prometheus / Victoria Metrics
- Logging: Loki + Structured logs (structlog)
- Tracing: Tempo / OpenTelemetry
- Dashboards: Grafana
Infrastructure
- Orchestration: Kubernetes
- Package Management: Helm, Kustomize
- CI/CD: GitLab CI
- Secrets: Vault
Связанные страницы
Сервисы
- Service Catalog — полный список сервисов с зависимостями
- Identity service — пример реализации Clean Architecture
Архитектура
- Architecture — системная архитектура
- Диаграмма компонентов (C4) — компонентная диаграмма
- Architecture Principles — принципы проектирования
Домены
- Domains — доменная модель
- Identity Domain — пример доменного проектирования
Разработка
- Development — процесс разработки
- Coding Standards — стандарты кода
- Git Workflow — работа с Git
Платформа
- Platform — инфраструктура
- Platform / Infrastructure — инфраструктурные компоненты и кластер