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.pyiçindeki ülke modeli - Sayı: 2 tohumlanan referans tablosu (
core_currencies,parties_countries); 7 para birimi rotası (src/cluster_erp/server/routes/currencies.pyiç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_currenciesiçinde etkin bir satır olmalıdır;assert_known_currencydiğerleriniCURRENCY_UNKNOWNve 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ı.