Real Decision
Problem
Enterprise APIs evolve over time, but breaking changes cannot disrupt existing clients.
Decision
Business endpoints are versioned through URL namespaces (`/v1`, `/v2`), while shared infrastructure endpoints remain version-independent. This allows gradual evolution without forcing simultaneous client upgrades.