Skip to content

Architecture Decision Records (ADR)

Collection of ADRs describing the key architectural decisions behind IRIS.

All ADRs follow the MADR format:

  • Title: ADR-NUMBER: Title
  • Status: Proposed | Accepted | Deprecated | Superseded
  • Date: YYYY-MM-DD
  • Context: the problem or situation that requires a decision
  • Decision: the chosen decision
  • Consequences: positive and negative consequences
  • See also: related ADRs

Starting with ADR 0023, files and paths follow one naming rule: adr/<number>-<decision-slug>.md.

Contents

# ADR Status Date
0001 Event-Driven Runtime Accepted 2025-01-15
0002 Persistence Architecture Accepted 2025-01-16
0003 Control Plane for Event Routing Accepted 2025-01-17
0004 Signal Fusion Layer Accepted 2025-01-18
0005 Analytical Snapshot API Semantics Accepted 2025-01-19
0006 Portfolio Engine Separation Accepted 2025-01-20
0007 Cross-Market Intelligence Accepted 2025-01-21
0008 Research vs Production Runtime Accepted 2025-01-22
0009 Signals Service/Engine Split Accepted 2025-02-01
0010 Caller Owns Commit Boundary Accepted 2025-02-02
0011 Analytical Engines Never Fetch Accepted 2025-02-03
0012 Services Return Domain Contracts Accepted 2025-02-04
0013 Async Classes for Orchestration, Pure Functions for Analysis Accepted 2025-02-05
0014 Post-Commit Side Effects Only Accepted 2025-02-06
0015 AI Platform Layer Accepted 2025-03-01
0016 Error Taxonomy Boundary Localization Accepted 2026-03-16
0017 Text Ownership Localization Scope Accepted 2026-01-15
0018 Message Key Taxonomy Naming Accepted 2026-01-20
0019 Package Structure Import Rules Accepted 2026-03-16
0020 Dependency Direction Import Boundaries Accepted 2026-03-16
0021 Generated Presentation Artifact Ownership Accepted 2026-03-16
0022 Platform Maturity Additions Accepted 2026-03-01
0023 Documentation Structure and Naming Accepted 2026-03-15
0024 Frontend Dashboard Composition and Route-Owned Bootstrapping Accepted 2026-03-15
0025 Runtime Proxy Registry for Public Market Sources Accepted 2026-03-16
0026 Observed Asset Inventory Is DB-Owned Accepted 2026-03-16
0027 Live Market-Source Capability Registry in Redis Accepted 2026-03-16
0028 Market Data Source Catalog and Support Tiers Accepted 2026-03-16
0029 Frontend Dashboard Live Stream Over Normalized SSE Accepted 2026-03-16