Parties ayarları ve başvuru verileri

Bu sayfa parties modülünün başvuru verilerini listeler: src/cluster_erp/modules/parties/settings/ içindeki ülkeler, adres seviyeleri ve adres seviyesi değerleri ve her birinin nasıl tohumlandığı. Bu tablolar, bir adresin kod değişikliği olmadan herhangi bir ülkenin yapısını izlemesini sağlar. Kanal türleri de bu modülün başvuru verileridir; iletişim kanalları sayfasında listelenir.

Kapsam ve kaynak¶

• Tanımlandığı yer: src/cluster_erp/modules/parties/settings/models.py (Country, AddressLevel, AddressLevelValue), services.py (CountryService, AddressLevelService, AddressLevelValueService), routes.py, seed_data.py (ADDRESS_LEVEL_TEMPLATES), metadata.py (COUNTRY_META, ADDRESS_LEVEL_META, ADDRESS_LEVEL_VALUE_META, CHANNEL_TYPE_META).
• Sayım: 3 tablo; 18 uç (routes.py içindeki @router. dekoratörleri); 43 ülke için adres seviyesi şablonu (ADDRESS_LEVEL_TEMPLATES üst düzey anahtarları).
• Web'de bu tablolar taraflar uygulamasının Ayarlar bölümündeki country, address_level ve channel_type sekmeleridir (src/cluster_erp/modules/parties/module.py:627-637). Ayarlar görünümü genel ağaç ve ayarlar sayfasında anlatılır.

Ülkeler¶

Her başlangıçta seed_iso_countries, pycountry paketindeki henüz bulunmayan her ISO 3166 ülkesini yaygın ad ve resmî adla ekler. Var olan bir satırı asla değiştirmez ve phone_code alanını boş bırakır; docstring pycountry paketinin arama kodlarını taşımadığını belirtir (src/cluster_erp/modules/parties/module.py:44-61, src/cluster_erp/modules/parties/settings/services.py:38-86). İnternetten Güncelle aksiyonu aynı paketlenmiş pycountry verisini okuyan fetch_from_internet yöntemini çağırır. Var olan ülkelerin kodlarını ve adlarını günceller ve eksik olanları ekler (src/cluster_erp/modules/parties/settings/services.py:102-139). Liste, translations alanından çözülen ve istek dilinde olan bir display_name döndürür (src/cluster_erp/modules/parties/settings/routes.py:38-52). Diğer modüller bir ülkeyi alfa-2 veya alfa-3 koduyla GetCountryByCode üzerinden arar (src/cluster_erp/modules/parties/module.py:271-301).

Adres seviyeleri¶

Adres Seviyelerini Oluştur aksiyonu bir ülkenin seviyelerini ADDRESS_LEVEL_TEMPLATES içinden oluşturur (src/cluster_erp/modules/parties/settings/routes.py:133-146, src/cluster_erp/modules/parties/settings/services.py:239-282). Ülkenin zaten seviyeleri varsa yalnızca şablondaki eksik çevirileri ekler. Ülke kodu için şablon yoksa hiçbir şey oluşturmaz ve bunu bildirir. Örneğin TR şablonunda dört seviye vardır: il, ilçe, mahalle ve posta kodu; sonuncusu isteğe bağlıdır (src/cluster_erp/modules/parties/settings/seed_data.py:6-11).

Adres seviyesi değerleri¶

Bir değer canlı satırlar arasında seviye, metin ve üst değer başına benzersizdir (src/cluster_erp/modules/parties/settings/models.py:85-94). GET /settings/address-levels/{level_id}/values bir seviyenin değerlerini metne göre sıralı listeler ve isteğe bağlı olarak parent_id ile süzer; bu, bir formun yalnızca seçilen ilin ilçelerini sunmasını sağlar (src/cluster_erp/modules/parties/settings/routes.py:223-235, src/cluster_erp/modules/parties/settings/services.py:289-302).

Uçlar¶

Tüm yollar /api/v1/parties/settings altındadır.

Kısıtlar ve doğrulama¶

• Canlı bir ülkenin zaten sahip olduğu bir kodla ülke oluşturmak bir çakışma yanıtı verir (src/cluster_erp/modules/parties/settings/routes.py:72-74).
• Ülke kodları büyük harfle saklanır (src/cluster_erp/modules/parties/settings/services.py:141-153).
• Bir ülkeyi, seviyeyi veya değeri silmek deleted_at alanını ayarlar; hiçbir şey kaldırılmaz (src/cluster_erp/modules/parties/settings/services.py:166-177).

Tutarsızlıklar¶

Tanıtılan terimler¶

İlgili sayfalar¶

• Parties modülü
• Adresler
• İletişim kanalları
• Başvuru verileri ve çekirdek i18n

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