REPO_MAP.md

КАРТА РЕПОЗИТОРИЯ

1. Карта верхнего уровня

• auth-service/ — пользователи и валидация токенов
• control-plane/ — флаги и runtime lifecycle экспериментов
• decision/ — детерминированная выдача варианта и fallback
• events/ — ingest событий, dedup и атрибуция
• metrics/ — определения метрик, recompute и построение отчётов
• review/ — lifecycle ревью и approvals
• guardrails/ — автоматические safety-check/action
• autopilot/ — автоматический ramp-up worker и read API
• library/ — библиотека learnings по экспериментам
• logs/ — audit/event logging
• infra/ — compose, миграции, Envoy, дашборды, тесты

2. Критичные точки входа infra

• infra/docker-compose.dev.yml
• infra/docker-compose.prod.yml
• infra/scripts/deploy.sh
• infra/migrator/run.sh
• infra/envoy/envoy.yaml
• infra/envoy/generate-descriptor.sh
• infra/prometheus/prometheus.yml
• infra/grafana/dashboards/ab-metrics-overview.json
• infra/grafana/dashboards/load-testing-overview.json

3. E2E и нагрузка

• infra/tests/e2e/run-sh.sh — shell-оркестратор e2e
• infra/tests/e2e/sh/direct_logic.sh
• infra/tests/e2e/sh/direct_chain.sh
• infra/tests/e2e/sh/envoy_logic.sh
• infra/tests/e2e/sh/envoy_chain.sh
• infra/tests/e2e/sh/automation_reads.sh
• infra/tests/run-load.sh — оркестратор нагрузочных сценариев
• infra/tests/load/events_common.js — общая k6-логика запросов
• infra/tests/load/dashboard_metrics_demo.js — базовый 5-минутный сценарий для дашбордов
• infra/tests/load/automation_lag.js — сценарий лага guardrails/autopilot

4. Proto-контракты

• infra/proto/auth/v1/auth.proto
• infra/proto/common/v1/types.proto
• infra/proto/control_plane/v1/control_plane.proto
• infra/proto/decision/v1/decision.proto
• infra/proto/events/v1/events.proto
• infra/proto/guardrails/v1/guardrails.proto
• infra/proto/metrics/v1/metrics.proto
• infra/proto/autopilot/v1/autopilot.proto
• review/proto/review/v1/review.proto
• review/proto/control_plane/v1/control_plane.proto

5. Критичные файлы потока (decide -> event -> report/guardrail)

• Decide fallback:
  • decision/internal/clients/controlplane/client.go
• Event ingest + attribution:
  • events/internal/events/server.go
  • events/internal/events/store.go
• Агрегация метрик/отчёт:
  • metrics/internal/service/*
• Guardrails evaluation/action:
  • guardrails/internal/app/service.go
  • guardrails/internal/grpc/server.go
• Autopilot ramp decisions:
  • autopilot/internal/app/runner/service.go
  • autopilot/internal/grpc/server.go

6. Точки входа сервисов

• auth-service/cmd/main.go
• control-plane/cmd/main.go
• decision/cmd/main.go
• events/cmd/main.go
• metrics/cmd/main.go
• review/cmd/main.go
• guardrails/cmd/main.go
• autopilot/cmd/main.go
• library/cmd/main.go
• logs/cmd/main.go

7. Индекс документации

• docs/RUNBOOK.md
• docs/HIGH_LOAD_REPORT.md
• docs/ARCHITECTURE.md
• docs/images/architecture.png
• docs/images/responsibility_areas.png
• docs/TEST_REPORT.md
• docs/TRACEABILITY_MATRIX.md
• docs/OPTIONAL_FEATURES.md