ADR Index
NOTE
53 принятых ADR на 2026-05-09. Этот файл — навигация по тематикам; для полного списка по дате —
ls docs/docs/20-architecture/adr/. Шаблон нового ADR —TEMPLATE.md. Правила (в т.ч. что не делать без ADR) —AGENTS.md.
Foundation (1-10) — изначальная архитектура
| # | Тема | Файл |
|---|---|---|
| 0001 | Monorepo + Clean Architecture модули | 0001-monorepo-with-clean-architecture-modules.md |
| 0002 | Kafka как event bus | 0002-kafka-as-event-bus.md |
| 0003 | Event Sourcing только для canonical-ядра | 0003-event-sourcing-for-canonical-only.md |
| 0004 | PostgreSQL как primary store + event store | 0004-postgres-as-primary-store-and-event-store.md |
| 0005 | Отказ от MongoDB → PG JSONB + S3 | 0005-drop-mongodb-use-s3-and-pg-jsonb.md |
| 0006 | Elasticsearch вместо OpenSearch | 0006-elasticsearch-over-opensearch.md |
| 0007 | Category-agnostic Identity Profiles | 0007-category-agnostic-identity-profiles.md |
| 0008 | Централизованный rate-limiter на Redis | 0008-rate-limiter-centralized-on-redis.md |
| 0009 | Multi-tenant supplier credentials | 0009-multi-tenant-supplier-credentials.md |
| 0010 | Pluggable credential schemas + app-level encryption | 0010-pluggable-credential-schemas.md |
Architecture pillars (11-23)
| # | Тема | Файл |
|---|---|---|
| 0011 | No-proxy architecture | 0011-no-proxy-architecture.md |
| 0012 | Data Visibility Policy engine | 0012-data-visibility-policy.md |
| 0013 | Suppliers as graph | 0013-suppliers-as-graph.md |
| 0014 | Graceful degradation без прогрева | 0014-graceful-degradation-without-warmup.md |
| 0015 | Multi-protocol public API (REST + gRPC + WS) | 0015-multi-protocol-public-api.md |
| 0016 | Extensible kind dictionaries | 0016-extensible-kind-dictionaries.md |
| 0017 | Event-driven supply-chain recalc | 0017-event-driven-supply-chain-recalc.md |
| 0018 | Master key + DEK rotation | 0018-master-key-and-dek-rotation.md |
| 0019 | ClickHouse для истории + аналитики | 0019-clickhouse-for-history-and-analytics.md |
| 0020 | Outbox pattern для Kafka publish | 0020-outbox-pattern-for-event-publishing.md |
| 0021 | Stdlib-first Go runtime | 0021-stdlib-first-go-service-runtime.md |
| 0022 | GitLab CI/CD + docs-as-code | 0022-gitlab-cicd-docs-as-code-and-release-governance.md |
| 0023 | Testing pyramid + provider contract tests | 0023-testing-pyramid-and-provider-contract-tests.md |
Suppliers + Ingestion (24-29, 33, 50)
| # | Тема | Файл |
|---|---|---|
| 0024 | Supplier connector contract | 0024-supplier-connector-contract.md |
| 0025 | Observation extensions: PriceSet/StockForecast/WarehouseKind/DeliveryTerm | 0025-price-and-stock-observation-extensions.md |
| 0026 | Marketplace observations + seller axis | 0026-marketplace-observations-and-seller-axis.md |
| 0027 | HTML scraper connector pattern (Pattern 4) | 0027-html-scraper-connector-pattern.md |
| 0028 | Federated identity taxonomies (ETIM/eCl@ss) | 0028-federated-identity-taxonomies.md |
| 0029 | Revision-based incremental sync | 0029-revision-based-incremental-sync.md |
| 0033 | Imitation service mandated per supplier | 0033-supplier-imitation-services-mandated.md |
| 0050 | DKC adapter + federated taxonomy (Cycle 4) | 0050-dkc-adapter-and-taxonomy.md |
| 0053 | Единицы СИ для характеристик | 0053-si-units-for-characteristics.md |
| 0054 | pgvector для поиска аналогов | 0054-pgvector-analogs-search.md |
| 0063 | Pooled bulk ingestion + canonical system observation owner | 0063-pooled-bulk-ingestion-canonical-owner.md |
Runtime + DI + Layout (30-32, 34)
| # | Тема | Файл |
|---|---|---|
| 0030 | Runtime DI через uber-go/fx | 0030-runtime-di-uber-fx.md |
| 0031 | Microkernel sub-modules per BC | 0031-microkernel-submodules-per-bounded-context.md |
| 0032 | Viewable ID scheme (TR-XXXXXXX) | 0032-viewable-id-scheme.md |
| 0034 | Canonical products as read-model в Phase 1-a (deviation от 0003) | 0034-canonical-as-read-model-iter-1.md |
Proposal pipeline + Pricing (35-39, 47)
| # | Тема | Файл |
|---|---|---|
| 0035 | Proposal pipeline layering | 0035-proposal-pipeline-layering.md |
| 0036 | PriceRule aggregate + auto-derivation (P2) | 0036-pricing-rule-aggregate-and-auto-derivation.md |
| 0037 | Stock Rule Aggregate (P2b) | 0037-stock-rule-aggregate.md |
| 0038 | Delivery Rule Aggregate (P2c) | 0038-delivery-rule-aggregate.md |
| 0039 | CustomPricingHandler Plugin Registry (P3) | 0039-custom-pricing-handler-plugin-registry.md |
| 0047 | Canonical_assignments policy + strategies + trust scale (cycle 2) | 0047-canonical-assignments-strategies.md |
Visibility + Credentials (40-41)
| # | Тема | Файл |
|---|---|---|
| 0040 | Visibility Policies (P4a) | 0040-visibility-policies.md |
| 0041 | Credentials Pool and Secrets Isolation (P4c-2) | 0041-credentials-pool-and-secrets-isolation.md |
Live refresh + Exchange (42)
| # | Тема | Файл |
|---|---|---|
| 0042 | Exchange Rate Layer 3a — CBR daily pull | 0042-exchange-rate-layer-3a.md |
Ingestion orchestration (43)
| # | Тема | Файл |
|---|---|---|
| 0043 | Ingestion orchestration — per-supplier tickers + advisory lease | 0043-ingestion-orchestration.md |
LLM + Matching + Canonical assignments (44-46, 49)
| # | Тема | Файл |
|---|---|---|
| 0044 | LLM gateway + char-pipeline foundation (charnorm) | 0044-llm-gateway-char-pipeline.md |
| 0045 | Tier 3 LLM matcher + moderation queue | 0045-tier3-llm-matcher.md |
| 0046 | canonical_assignments source field + manual-over-auto policy (cycle 1) | 0046-canonical-assignments-foundation.md |
| 0049 | LLM-resolution для canonical assignments (cycle 3) | 0049-canonical-assignments-llm-resolution.md |
Observability (48)
| # | Тема | Файл |
|---|---|---|
| 0048 | Prometheus метрики через OTel SDK + otelprom | 0048-prometheus-metrics-stack.md |
Auth (51)
| # | Тема | Файл |
|---|---|---|
| 0051 | Public API auth + API-key RBAC | 0051-public-api-auth-and-api-key-rbac.md |
Связанные документы
AGENTS.md— правила для записи и обновления ADR.TEMPLATE.md— шаблон для нового ADR.- Roadmap-уровневые memory:
tracium_path_to_launch.md,tracium_repo_state_2026-05-06.md.