ADR 0005: Canonical financial naming#
Context#
Source abbreviations are unstable and often hide financial meaning or units.
Decision#
Expose versioned English snake_case names with explicit price, count, volume, value, date,
timestamp, identifier, currency, and unit semantics.
Alternatives#
Preserving source names and publishing aliases were considered.
Consequences#
Downstream data is provider-independent; version 1.0 requires user code changes.
Rejected shortcuts#
Legacy aliases, silent float coercion, and null-to-zero conversion are rejected.
Operational implications#
Semantic changes require a canonical schema version and data-dictionary update.