Arian Khodro

Appearance

Architecture Decision Records (ADRs) Index ​

Executive Summary ​

Architecture Decision Records (ADRs) capture critical technical choices, their business context, alternatives considered, and long-term consequences. This registry documents the six foundational architectural decisions accepted for the Arian Khodro Core Platform.

text
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                        FOUNDATIONAL ARCHITECTURAL DECISIONS                            β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚  ADR-001 β–Ί Modular Monolith Architecture over Premature Microservices                  β”‚
β”‚  ADR-002 β–Ί Anti-Corruption Layer (ACL) for Safe Legacy Tadark Coexistence              β”‚
β”‚  ADR-003 β–Ί PostgreSQL 16+ as Primary Enterprise Database Engine                        β”‚
β”‚  ADR-004 β–Ί Central VIN Golden Record & Master Data Management Architecture             β”‚
β”‚  ADR-005 β–Ί Hybrid Document OCR Pipeline with Mandatory Human-in-the-Loop Review        β”‚
β”‚  ADR-006 β–Ί In-House Engineering Squad over Turnkey Proprietary Vendor Outsourcing      β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Approved Architectural Decisions Registry ​

ADR NumberTitleStatusDate AcceptedPrimary Driver
ADR-001Modular Monolith vs. MicroservicesAccepted2026-09-04High operational velocity without distributed transaction complexity.
ADR-002Anti-Corruption Layer for TadarkAccepted2026-09-04Prevent legacy Delphi locks while ensuring financial consistency.
ADR-003PostgreSQL as Primary Relational DBAccepted2026-09-04Enterprise ACID reliability, advanced JSONB, and zero license fees.
ADR-004VIN Golden Record & MDMAccepted2026-09-04Immutable single source of truth for vehicles; zero double-booking.
ADR-005Hybrid Document OCR PipelineAccepted2026-09-04High accuracy on foreign manifests combined with human verification.
ADR-006In-House Squad vs. OutsourcingAccepted2026-09-04Long-term IP ownership, agility, and ending costly vendor lock-in.

Conclusion & Governance Checkpoint ​

  • Key Decisions: Enforce ADR-001 through ADR-006 as the binding architectural constitution for all platform code.
  • Open Questions: Drafting ADR-007 for telemetry metrics exporter stack selection.
  • Next Actions: Read ADR-001 Modular Monolith to review the core architecture decision.