Карта репозиториев

Previous Next

Структура монорепозитория AIOps и назначение основных директорий.

Корень репозитория

1
2
3
4
5
6
ai-ops/
├── services/           # Микросервисы
├── libs/               # Общие библиотеки
├── proto/              # Protocol Buffers (gRPC контракты)
├── infra/              # Инфраструктура и деплой
└── docs/               # Исходники документации

services/

Сервисы платформы.

auth-platform/

  • identity-service/ — Python, gRPC. Canonical identity registry (User, Identifier, Verification).
  • credential-service/ — Python, gRPC. Хранение и проверка паролей (Argon2id).
  • auth-service/ — (planned) Оркестрация authentication flows.
  • session-token-service/ — (planned) OAuth2/OIDC, выдача и валидация токенов.
  • account-service/ — (planned) Профили пользователей, PII.
  • herald/ — (planned) Доставка уведомлений (email/SMS).

api-gateway/

  • Control Plane (Go) — xDS сервер для Envoy, конфигурация.
  • Data Plane — Envoy Proxy (конфиги в репозитории или генерируются).

cloud-service/

  • (planned) Облачные сущности, топология, organizations, environments.

libs/python/

Общие Python-библиотеки. Пакеты сгруппированы по темам: common/, communication/, storage/, runtime/ (индекс и ссылки — в libs/python/README.md).

Пакет Назначение
grpc-stubs Сгенерированные gRPC/protobuf stubs
omni-box Реализация Transactional Outbox/Inbox
unit-of-work-kit Unit of Work
sqlalchemy-postgres-kit Сессии, базовые модели PostgreSQL
grpc-server-kit Lifecycle gRPC-сервера
grpc-interceptor-kit Interceptors (context, tracing, metrics, logging)
dishka-providers Провайдеры Dishka (DB, Redis, Kafka)
pydantic-settings-kit Настройки из env
service-observability Логи, метрики, трейсинг
kafka-publisher-kit Kafka producer
redis-client-kit Redis client
service-contracts Общие Pydantic-схемы/контракты

proto/

  • aiops/identity/v1/ — контракты Identity service.
  • aiops/credential/v1/ — контракты Credential service.

infra/

  • k8s/ — манифесты Kubernetes, Helm charts, Kustomize; в т.ч. docs/ — MkDocs и конфиг документации.
  • local/ — Docker Compose для локальной разработки (PostgreSQL, Redis, Kafka).

docs/

Исходники документации (Markdown). Сборка: MkDocs в infra/k8s/docs/.

  • start-here/ — с чего начать.
  • product/ — продукт, фичи, требования.
  • domains/ — доменная модель.
  • architecture/ — архитектура системы.
  • engineering/ — сервисы, backend, data, frontend, QA.
  • platform/ — инфраструктура, окружения, observability.
  • development/ — процесс разработки.
  • operations/ — эксплуатация.
  • analytics/ — аналитика.
  • governance/ — решения, безопасность, владельцы, глоссарий.

Связанные страницы

Локальная настройка Стандарты кода