Reference data and core i18n

This page lists the reference data that the platform core provides or seeds, and the small server-side translation helpers. It covers core/currencies.py, server/routes/currencies.py, core/incoterms.py, core/blood_group.py, core/diet.py, and core/i18n.py, and it states where country rows come from. Client-side translation files are documented on i18n and languages.

Scope and source¶

• Defined in: the files above, plus the country model in src/cluster_erp/modules/parties/settings/models.py
• Count: 2 seeded reference tables (core_currencies, parties_countries); 7 currency routes (counted from the @router. decorators in src/cluster_erp/server/routes/currencies.py); 3 choice lists with 11, 8, and 9 entries (counted from the ChoiceMeta( entries); 2 translation helpers

Currencies¶

core_currencies is defined in the core (src/cluster_erp/core/currencies.py:57-89) and seeded by the currencies module at start-up with CurrencyService.seed_iso_currencies (src/cluster_erp/modules/currencies/module.py:31-47). The seed takes a curated list with symbols and Turkish names, then adds every other ISO 4217 currency from pycountry; a currency whose numeric code is blank or already used is skipped (src/cluster_erp/core/currencies.py:559, src/cluster_erp/core/currencies.py:1811-1852). Existing codes are not overwritten (src/cluster_erp/core/currencies.py:281-290).

core_exchange_rates holds rates as Numeric(18, 6) with a source, TCMB by default (src/cluster_erp/core/currencies.py:91-132). See money and Decimal.

Currency routes¶

server/routes/currencies.py defines a router without a prefix. The currencies module includes it under its own prefix, so the paths are /api/v1/currencies/... (src/cluster_erp/server/routes/currencies.py:18, src/cluster_erp/modules/currencies/module.py:74-82).

Countries¶

Countries are rows of parties_countries, owned by the parties module (src/cluster_erp/modules/parties/settings/models.py:12-13). The module seeds the ISO 3166 list from pycountry at start-up and does not overwrite edited rows; telephone codes are left empty on purpose (src/cluster_erp/modules/parties/module.py:41-61, src/cluster_erp/modules/parties/settings/services.py:38-50). Other modules read a country through the query GetCountryByCode (src/cluster_erp/core/contracts.py:2529-2533). See settings and reference data.

Shared choice lists¶

These lists are ChoiceMeta objects used directly in module metadata.

Usage counts were made with grep -rlw <name> over src/cluster_erp/modules and src/cluster_erp/server. Each entry carries its own English and Turkish label, for example src/cluster_erp/core/incoterms.py:12-15.

Translation helpers¶

resolve_display_name is used in 5 files; resolve_field has no caller outside core/i18n.py (counted with grep -rlw). The request language comes from get_language, which reads the first two letters of Accept-Language and defaults to en (src/cluster_erp/server/dependencies.py:247-249).

Constraints and validation¶

• A currency code used in a document must be an active row of core_currencies; assert_known_currency refuses others with CURRENCY_UNKNOWN and HTTP 422 (src/cluster_erp/core/currencies.py:30-49).
• Currency and country codes are unique among live rows only (src/cluster_erp/core/currencies.py:61-74, src/cluster_erp/modules/parties/settings/models.py:15-34).

Discrepancies¶

Terms introduced¶

Related pages¶

• Platform core
• Money and Decimal
• Currencies
• Settings and reference data
• Data-driven languages

Verified against commit 92f8051 on 2026-11-13.