Currencies modülü (currencies)

src/cluster_erp/modules/currencies/ içindeki currencies modülü üç tür finans başvuru verisi sunar: para birimleri, kurlar ve ödeme koşulları. Para birimi ve kur modelleri platform çekirdeğinde, src/cluster_erp/core/currencies.py içinde bulunur; bu modül onları tohumlar, uçlarını bağlar ve ekranlarını bildirir. Ödeme koşulları modülün kendi tablosudur. Diğer modüller bu kayıtları formlarında yabancı anahtar kaynağı olarak kullanır.

Bir bakışta¶

Modül ne yapar¶

• Her başlangıçta ISO 4217 para birimi listesini ve standart ödeme koşullarını, var olan satırların üzerine yazmadan tohumlar (src/cluster_erp/modules/currencies/module.py:31-62).
• Para birimlerini listeler, oluşturur, günceller ve geçici olarak siler; listeyi paketlenmiş ISO verisinden yeniler (src/cluster_erp/server/routes/currencies.py:21-98).
• Kurları para birimi çifti ve tarih başına saklar, bir tutarı dönüştürür ve Türkiye merkez bankasının günlük kurlarını içe aktarır (src/cluster_erp/modules/currencies/exchange_rates/routes.py:29-144).
• Ödeme koşullarını bir kategori, net gün sayısı ve erken ödeme iskontosuyla tutar (src/cluster_erp/modules/currencies/payment_terms/models.py:12-62).

Alt modüller¶

Para birimi yönlendiricisi sunucu katmanında tanımlanır ve modül yönlendiricisi altına ilk olarak eklenir; yönlendiricinin tamamı currencies uygulama yetkisine bağlıdır (src/cluster_erp/modules/currencies/module.py:64-82). exchange_rates/models.py yalnızca çekirdek modeli yeniden dışa aktarır (src/cluster_erp/modules/currencies/exchange_rates/models.py:1-5).

Veri modeli¶

Tohumlama ve çekirdek uçlar başvuru verileri ve çekirdek i18n sayfasında da anlatılır.

Ekranlar ve metadata¶

get_metadata modüle Para Birimleri ve Ödeme Koşulları (İngilizce Currencies & Payment Terms) etiketini ve iki bölümlü bir Finans Ayarları kenar çubuğu grubunu verir: currency, exchange_rate ve payment_term sekmeli bir ayarlar görünümü ve bir Ödeme Koşulları listesi (src/cluster_erp/modules/currencies/module.py:103-151). Web uygulaması modülü SYSTEM_APP_SETTINGS içinde listeler; bu yüzden ayar sekmeleri Ayarlar, ardından Sistem Uygulamaları üzerinden açılır; kod yorumu finans başvuru verilerinin kendine ait bir uygulaması olmadığını belirtir (webapp/js/home.js (SYSTEM_APP_SETTINGS)). Ödeme koşulu kategorileri altı seçenek olarak sunulur: peşin/avans, vadeli, erken ödeme iskontolu, ay sonu, taksitli ve uluslararası (src/cluster_erp/modules/currencies/metadata.py:294-299).

Durumlar ve aksiyonlar¶

Kayıtların bir is_active bayrağı vardır, durum alanı yoktur (src/cluster_erp/core/currencies.py:88, src/cluster_erp/modules/currencies/payment_terms/models.py:53-57).

İş kuralları¶

• Para birimi tohumu, sembolleri ve çevirileri olan seçilmiş bir listeyi alır ve pycountry paketinden diğer tüm ISO 4217 para birimlerini ekler; sayısal kodu boş veya zaten kullanılmış bir para birimi atlanır (src/cluster_erp/core/currencies.py:1811-1852). Var olan kodlar değiştirilmez (src/cluster_erp/core/currencies.py:281-309).
• İnternetten Güncelle aynı paketlenmiş veriyi okur ve var olan para birimlerinin sayısal kodunu, adını, sembolünü ve çevirilerini yeniler; ağ isteği yapmaz (src/cluster_erp/core/currencies.py:311-357).
• Aynı para birimi arasında dönüştürme tutarı kur 1 ile döndürür. Aksi halde verilen tarihin doğrudan kurunu, tarih verilmemişse en yeni doğrudan kuru amount x rate / unit olarak kullanır; o da yoksa eşleşen ters kuru amount x unit / rate olarak kullanır. Sonuçlar altı basamağa yuvarlanır (src/cluster_erp/core/currencies.py:383-446). Hiç kur yoksa uç bulunamadı yanıtı verir (src/cluster_erp/modules/currencies/exchange_rates/routes.py:66-79).
• Dönüştürmedeki quantize hiçbir yuvarlama kipi vermez ve src/ içinde getcontext ve setcontext için yapılan grep ondalık bağlamında hiçbir değişiklik bulmaz; bu yüzden Python'un decimal modülünün varsayılan bağlamı geçerlidir.
• TCMB Senkronize Et, merkez bankasının günlük XML dosyasını tcmb_url ayarındaki adresten tcmb_timeout_seconds zaman aşımıyla çeker. Her yabancı para birimini TRY karşısında alış, satış ve ortalama kurla saklar; o tarihin satırını oluşturur veya günceller (src/cluster_erp/modules/currencies/exchange_rates/routes.py:131-144, src/cluster_erp/core/currencies.py:448-552, src/cluster_erp/config/settings.py:418-420). Çekme bir işçi iş parçacığında çalışır; bir başarısızlık fırlatılmaz, hata sayısı olarak döndürülür (src/cluster_erp/core/currencies.py:454-461).
• Elle girilen bir kur, başka bir kaynak verilmedikçe manual kaynağını alır; para birimi kodları büyük harfle saklanır (src/cluster_erp/modules/currencies/exchange_rates/schemas.py:16-24, src/cluster_erp/modules/currencies/exchange_rates/services.py:80-93).
• Bir ödeme koşulu kodu canlı koşullar arasında boş olmalıdır (src/cluster_erp/modules/currencies/payment_terms/services.py:452-455). Tohum altı kategoride 45 standart koşul içerir (src/cluster_erp/modules/currencies/payment_terms/services.py:32-409, code anahtarlı girdiler).
• assert_known_currency, canlı ve etkin bir para birimi olmayan bir kodu CURRENCY_UNKNOWN ve HTTP 422 ile reddeder (src/cluster_erp/core/currencies.py:30-49). Bu commit'te onu subscriptions modülü çağırır (assert_known_currency için grep).

Olaylar ve sorgular¶

Modül hiçbir sözleşme tüketmez ve üretmez; register_events boştur (src/cluster_erp/modules/currencies/module.py:84-85). Diğer modüller kayıtlarını metadata'da yabancı anahtar kaynağı olarak kullanır: diğer modüllerin 10 dosyasında module="currencies" olan 33 ForeignKeySource girdisi (grep).

Yetkiler¶

Gizlilik, saklama ve geçmiş¶

Modül kişisel veri saklamaz ve privacy_handlers.py dosyası yoktur. Silme deleted_at alanını ayarlar (src/cluster_erp/core/currencies.py:273-279, src/cluster_erp/modules/currencies/exchange_rates/services.py:109-133). Değişiklikler değişiklik geçmişi tarafından kaydedilir.

Analitik olguları¶

Bu modülün analytics_facts.py dosyası yoktur.

Ayarlar ve başvuru verileri¶

Bkz. ayarlar başvurusu.

Testler¶

tests/ içinde modules.currencies ve core.currencies için grep ile ve web-client/ içinde dosya adıyla bulundu.

Tutarsızlıklar¶

Tanıtılan terimler¶

İlgili sayfalar¶

• Modüller dizini
• Başvuru verileri ve çekirdek i18n
• Para ve Decimal
• Ayarlar başvurusu
• Bu modülün API başvurusu

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