Architecture Decision Records (ADRs)
Architecture Decision Records
Section titled “Architecture Decision Records”This section documents the key technical decisions behind TDI2’s architecture. Each ADR explains why a particular approach was chosen and the trade-offs involved.
Core Decisions
Section titled “Core Decisions”| ADR | Decision | Status |
|---|---|---|
| ADR-001 | AST Transformation vs Runtime Reflection | Active |
| ADR-002 | Valtio for Service State Management | Active |
| ADR-003 | Interface-Based DI Tokens | Active |
| ADR-004 | Build-Time vs Runtime DI | Active |
| ADR-005 | Spring Boot Decorator Conventions | Active |
| ADR-006 | Client-First, SSR Later | Active |
Purpose
Section titled “Purpose”These ADRs help developers understand:
- Why specific technologies were chosen
- What trade-offs were made
- How decisions impact the framework’s behavior
- When these decisions might need to be reconsidered
Each ADR follows a simple format: Context → Decision → Consequence.