Factorizer/Cluster ERP WikiCluster ERP English
Ana sayfa / Platform

Referans

Referans veriler ve çekirdek i18n

Ülkelerin ve para birimlerinin kaynağı, para birimi rotaları, ortak seçenek listeleri ve core/i18n.py çeviri yardımcıları.

Bu sayfa platform çekirdeğinin sağladığı veya tohumladığı referans verileri ve küçük sunucu tarafı çeviri yardımcılarını listeler. core/currencies.py, server/routes/currencies.py, core/incoterms.py, core/blood_group.py, core/diet.py ve core/i18n.py dosyalarını kapsar ve ülke satırlarının nereden geldiğini belirtir. İstemci tarafı çeviri dosyaları i18n ve diller sayfasında belgelenir.

Kapsam ve kaynak

  • Tanımlandığı yer: yukarıdaki dosyalar ve src/cluster_erp/modules/parties/settings/models.py içindeki ülke modeli
  • Sayı: 2 tohumlanan referans tablosu (core_currencies, parties_countries); 7 para birimi rotası (src/cluster_erp/server/routes/currencies.py içindeki @router. dekoratörlerinden sayıldı); 11, 8 ve 9 girdili 3 seçenek listesi (ChoiceMeta( girdilerinden sayıldı); 2 çeviri yardımcısı

Para birimleri

core_currencies çekirdekte tanımlanır (src/cluster_erp/core/currencies.py:57-89) ve açılışta currencies modülü tarafından CurrencyService.seed_iso_currencies ile tohumlanır (src/cluster_erp/modules/currencies/module.py:31-47). Tohum, simgeleri ve Türkçe adları olan düzenlenmiş bir listeyi alır, ardından diğer her ISO 4217 para birimini pycountry paketinden ekler; sayısal kodu boş veya kullanılmış bir para birimi atlanır (src/cluster_erp/core/currencies.py:559, src/cluster_erp/core/currencies.py:1811-1852). Var olan kodların üzerine yazılmaz (src/cluster_erp/core/currencies.py:281-290).

core_exchange_rates, kurları Numeric(18, 6) olarak ve varsayılanı TCMB olan bir kaynakla tutar (src/cluster_erp/core/currencies.py:91-132). Bkz. para ve Decimal.

Para birimi rotaları

server/routes/currencies.py öneksiz bir yönlendirici tanımlar. currencies modülü onu kendi önekiyle ekler; bu yüzden yollar /api/v1/currencies/... biçimindedir (src/cluster_erp/server/routes/currencies.py:18, src/cluster_erp/modules/currencies/module.py:74-82).

Yöntem ve yol İzin Amaç Kaynak
GET / (sorgu active_only, search) currency.read Para birimlerini listele src/cluster_erp/server/routes/currencies.py:21-30
POST /update-from-internet currency.create Listeyi pycountry içindeki ISO 4217 kaydından yenile src/cluster_erp/server/routes/currencies.py:33-40
POST / currency.create Para birimi oluştur src/cluster_erp/server/routes/currencies.py:43-51
GET /{currency_id} currency.read Bir para birimini getir src/cluster_erp/server/routes/currencies.py:54-64
PUT /{currency_id} currency.update Adı, simgeyi, ondalık basamakları, çevirileri veya etkin bayrağını değiştir src/cluster_erp/server/routes/currencies.py:67-78
DELETE /{currency_id} currency.delete Bir para birimini kullanımdan kaldır src/cluster_erp/server/routes/currencies.py:81-89
POST /seed currency.seed ISO tohumunu yeniden çalıştır src/cluster_erp/server/routes/currencies.py:92-98

Ülkeler

Ülkeler, parties modülüne ait parties_countries satırlarıdır (src/cluster_erp/modules/parties/settings/models.py:12-13). Modül ISO 3166 listesini açılışta pycountry paketinden tohumlar ve düzenlenmiş satırların üzerine yazmaz; telefon kodları bilerek boş bırakılır (src/cluster_erp/modules/parties/module.py:41-61, src/cluster_erp/modules/parties/settings/services.py:38-50). Diğer modüller bir ülkeyi GetCountryByCode sorgusuyla okur (src/cluster_erp/core/contracts.py:2529-2533). Bkz. ayarlar ve referans veriler.

Ortak seçenek listeleri

Bu listeler modül metadata'sında doğrudan kullanılan ChoiceMeta nesneleridir.

Sabit Girdiler Kullanıldığı yer Kaynak
INCOTERMS_2020 EXW'den DDP'ye Incoterms 2020'nin 11 ticari terimi src/cluster_erp/modules içinde 11 dosya (satın alma belgeleri) src/cluster_erp/core/incoterms.py:1-77
BLOOD_GROUP_CHOICES 8 ABO ve Rh grubu 2 dosya src/cluster_erp/core/blood_group.py:1-18
DIET_CHOICES other dahil 9 diyet türü 2 dosya src/cluster_erp/core/diet.py:1-20

Kullanım sayıları src/cluster_erp/modules ve src/cluster_erp/server üzerinde grep -rlw <name> ile yapıldı. Her girdi kendi İngilizce ve Türkçe etiketini taşır; örneğin src/cluster_erp/core/incoterms.py:12-15.

Çeviri yardımcıları

İşlev Davranış Kaynak
resolve_display_name(translations, default_name, lang) Dizgiyse translations[lang]["name"], değilse default_name döndürür src/cluster_erp/core/i18n.py:6-17
resolve_field(translations, field, default_value, lang) Herhangi bir alan adı için aynısı src/cluster_erp/core/i18n.py:20-32

resolve_display_name 5 dosyada kullanılır; resolve_field'ın core/i18n.py dışında çağıranı yoktur (grep -rlw ile sayıldı). İstek dili, Accept-Language başlığının ilk iki harfini okuyan ve varsayılanı en olan get_language işlevinden gelir (src/cluster_erp/server/dependencies.py:247-249).

Kısıtlar ve doğrulama

  • Bir belgede kullanılan para birimi kodu core_currencies içinde etkin bir satır olmalıdır; assert_known_currency diğerlerini CURRENCY_UNKNOWN ve HTTP 422 ile reddeder (src/cluster_erp/core/currencies.py:30-49).
  • Para birimi ve ülke kodları yalnızca canlı satırlar arasında benzersizdir (src/cluster_erp/core/currencies.py:61-74, src/cluster_erp/modules/parties/settings/models.py:15-34).

Tutarsızlıklar

Tanıtılan terimler

Terim Kod tanımlayıcısı Tanım Türkçe terim Kaynak
reference data core_currencies, parties_countries Koda yazılmak yerine veritabanına tohumlanan standart listeler. referans veri src/cluster_erp/core/currencies.py:57
Incoterms INCOTERMS_2020 ICC'nin 2020'de yayımladığı 11 uluslararası ticari terim. Incoterms src/cluster_erp/core/incoterms.py:11

İlgili sayfalar


92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.

Doğrulanan commit 92f8051 · 2026-11-13