Parties modülü (parties)

src/cluster_erp/modules/parties/ içindeki parties modülü, işletmenin tanıdığı herkes için tek bir kayıt tutar: taraf (Party, şirketin ilişkide olduğu bir kişi veya kuruluş). Müşteriler, tedarikçiler, çalışanlar ve sahip olunan kuruluşlar ayrı kartlar değil, bir tarafın rolleridir; bu model taraf birleştirme sayfasında açıklanır. Modül ayrıca adresleri, iletişim kanallarını, konuşulan dilleri ve ülke, adres seviyesi ve kanal türü başvuru verilerini tutar. Bu sayfa modülün genel görünümüdür; her alt modülün kendi başvuru sayfası vardır.

Bir bakışta¶

Modül ne yapar¶

• Her kişi veya kuruluş için yıllık iş koduna, türe, görünen ada, vergi alanlarına, notlara ve etkinlik bayrağına sahip tek bir taraf kartı tutar (src/cluster_erp/modules/parties/parties/models.py:18-55).
• Bir tarafın oynadığı rolleri, diğer modüllerin EventBus üzerinden güncel tuttuğu üç bayrak olarak kaydeder: is_customer, is_supplier ve is_employee (src/cluster_erp/modules/parties/module.py:168-195).
• Seviyeleri ülke başvuru verilerinden gelen yapılandırılmış adresleri saklar; bkz. adresler.
• E-posta ve telefon gibi iletişim kanallarını saklar; bkz. iletişim kanalları.
• Bir kişinin konuştuğu dilleri saklar; bkz. kişi dilleri.
• Başlangıçta ISO ülke listesini ve varsayılan kanal türlerini tohumlar (src/cluster_erp/modules/parties/module.py:37-74); bkz. ayarlar ve başvuru verileri.
• Her taraf için ortak ek deposunda bir profil fotoğrafı tutar (src/cluster_erp/modules/parties/parties/routes.py:153-249).

Alt modüller¶

Beş yönlendiricinin tamamı, önce settings olmak üzere tek bir modül yönlendiricisi altında toplanır ve yönlendiricinin tamamı parties uygulama yetkisine bağlıdır (src/cluster_erp/modules/parties/module.py:96-103). Aynı öneke sahip iki yönlendirici daha sunucu katmanında bulunur: rehberli oluşturma (POST /api/v1/parties/composite) ve rol etkinleştirme (POST /api/v1/parties/{party_id}/roles/...); ikisi de taraf birleştirme sayfasında anlatılır.

Veri modeli¶

Şema modülün on bir tablosunu ve yabancı anahtarlarını gösterir.

erDiagram
 Party ||--o| Individual : "party_id"
 Party ||--o| OrganisationInfo : "party_id"
 Party ||--o{ Address : "party_id"
 Party ||--o{ CommunicationChannel : "party_id"
 Party ||--o{ PersonLanguage : "party_id"
 Address ||--o{ AddressComponent : "address_id"
 Country ||--o{ Address : "country_id"
 Country ||--o{ AddressLevel : "country_id"
 AddressLevel ||--o{ AddressLevelValue : "level_id"
 AddressLevelValue ||--o{ AddressComponent : "level_value_id"
 ChannelType ||--o{ CommunicationChannel : "channel_type_id"

Düz anlatımla: bir Party en çok bir canlı Individual satırına ve en çok bir canlı OrganisationInfo satırına, ayrıca istenen sayıda adrese, kanala ve konuşulan dile sahiptir. Bir Address bir Country kaydına bağlıdır ve her biri o ülkenin bir AddressLevel ve bir AddressLevelValue kaydını gösteren AddressComponent satırlarından oluşur. Bir CommunicationChannel bir ChannelType kaydına sahiptir.

Her varlık BaseModel sınıfından türer; bu yüzden satırlar bir ULID birincil anahtar, denetim sütunları ve geçici silme sütunları taşır; bkz. temel model ve kimlikler ve geçici silme ve kullanımdan kaldırma.

Ekranlar ve metadata¶

get_metadata dört bölümlü tek bir Taraflar (İngilizce Parties) kenar çubuğu grubu bildirir (src/cluster_erp/modules/parties/module.py:557-641):

• Taraflar: iki varlık sekmeli bir liste; party listesi ve owned_organisations modülünün organisation listesi (Kuruluşlar) (src/cluster_erp/modules/parties/module.py:570-599).
• Adresler ve İletişim Kanalları: list_all uçlarını kullanan ve sekme çubuğundan gizlenen iki liste (src/cluster_erp/modules/parties/module.py:603-626).
• Ayarlar: country, address_level ve channel_type sekmeleriyle (src/cluster_erp/modules/parties/module.py:627-637).

Taraf listesinde kod, ad, tür, vergi numarası, aktif ve oluşturulma sütunları ile Tür ve Rol adlı iki süzgeç vardır (src/cluster_erp/modules/parties/parties/metadata.py:440-508). Taraf ayrıntısında Genel, Adresler, İletişim Kanalları, Konuştuğu Diller ve Çalışma Takvimi sekmeleri vardır; sonuncusu calendars modülünün özel bileşenidir (src/cluster_erp/modules/parties/parties/metadata.py:509-544). Rol bölümleri aynı kartta beş FacetMeta girdisiyle görünür (src/cluster_erp/modules/parties/parties/metadata.py:550-763). Taraf kartı ayrıca rehberli oluşturmayı, oluşturmada belge eklemeyi, kiracı alanı kovalarını, call, message ve mail hızlı aksiyonlarını ve bir fotoğrafı bildirir (src/cluster_erp/modules/parties/parties/metadata.py:313-378). Web uygulaması bunları genel olarak işler; bkz. genel ayrıntı ve genel form.

Durumlar ve aksiyonlar¶

Bir tarafın durum alanı yoktur; bir is_active bayrağı vardır (src/cluster_erp/modules/parties/parties/models.py:32). Modül altı ActionMeta girdisi bildirir (pakette grep "ActionMeta(" ile sayıldı).

İş kuralları¶

• Yeni bir taraf code değerini party yıllık dizisinden alır (src/cluster_erp/modules/parties/parties/services.py:116); bkz. temel model ve kimlikler.
• Liste araması görünen adla, kodla ve aranabilir kiracı alanlarıyla eşleşir (src/cluster_erp/modules/parties/parties/services.py:64-73).
• Rol süzgeci üç rol bayrağını okur (src/cluster_erp/modules/parties/parties/services.py:55-61).
• Oluşturma, yükteki is_customer, is_supplier veya is_employee değerlerini satıra kopyalamaz (src/cluster_erp/modules/parties/parties/services.py:117-126). Bayrakları rol uçları, PartyRoleSet ve bir başlangıç uzlaştırması ayarlar (src/cluster_erp/server/app.py:1002-1055).
• Bir güncelleme satırın version değerini yalnızca bir alan değiştiyse artırır ve yeni görünen ad ve vergi numarasıyla PartyUpdated yayar (src/cluster_erp/modules/parties/parties/services.py:197-212).
• Bir tarafı silmek deleted_at alanını ayarlar ve PartyDeleted yayar; toplu silme her kimlik için bir PartyDeleted yayar (src/cluster_erp/modules/parties/parties/services.py:216-233).
• Fotoğraf JPEG, PNG, WebP veya GIF olmalı, boş olmamalı ve en fazla 5 MB olmalıdır (src/cluster_erp/modules/parties/parties/routes.py:153-154, src/cluster_erp/modules/parties/parties/routes.py:196-203).

Olaylar ve sorgular¶

Modül 14 sözleşme tüketir ve 3 sözleşme üretir. Tüketmek, paket içinde subscribe( veya register_query_handler( çağrısına ilk argüman olarak verilmek demektir; üretmek, paket içinde sözleşme sınıf adının ardından ( gelmesi demektir. Modüller arası üreticiler ve tüketiciler sözleşmeler başvurusu sayfasında listelenir.

Yetkiler¶

İzin kodlarının nasıl tohumlandığı ve denetlendiği roller ve izinler sayfasında açıklanır.

Gizlilik, saklama ve geçmiş¶

privacy_handlers.py, privacy modülünün iki yayılım olayını bu modülün tabloları için yanıtlar (src/cluster_erp/modules/parties/privacy_handlers.py:1-10). collect_subject_data tarafın, bireysel ve kurumsal ayrıntılarının, adreslerinin, kanallarının ve dillerinin bir kopyasını döndürür (src/cluster_erp/modules/parties/privacy_handlers.py:69-100). anonymise_subject tanımlayıcı değerlerin üzerine talebin işaretini yazar, vergi alanlarını ve notları temizler, kişisel kiracı alanlarını siler, satırları talebin nedeniyle kullanımdan kaldırır ve dosyayı privacy modülünün kaldırması için fotoğraf ekini bildirir (src/cluster_erp/modules/parties/privacy_handlers.py:234-291). GetPartyContactValues tarafın canlı kanallarındaki e-posta adreslerini ve telefon numaralarını döndürür (src/cluster_erp/modules/parties/privacy_handlers.py:35-66). Genel akış gizlilik ve ilgili kişi talepleri sayfasındadır. Değişiklikler değişiklik geçmişi tarafından kaydedilir.

Analitik olguları¶

analytics_facts.py, parties_parties üzerinde tek bir olgu kümesi, party, bildirir; boyutları taraf türü, üç rol bayrağı, aktif ve oluşturulma tarihidir, tek ölçüsü party_count'tur (src/cluster_erp/modules/parties/analytics_facts.py:17-72). Modül DescribeAnalyticsFacts olayını bununla yanıtlar (src/cluster_erp/modules/parties/analytics_facts.py:75-77).

Ayarlar ve başvuru verileri¶

Ülkeler, adres seviyeleri, adres seviyesi değerleri ve kanal türleri veritabanındaki başvuru verileridir. Ülkeler pycountry paketinin ISO 3166 listesinden gelir ve başlangıçta tohumlanır; var olan satırların üzerine yazılmaz (src/cluster_erp/modules/parties/settings/services.py:38-86). Ayrıntılar ayarlar ve başvuru verileri sayfasındadır.

Testler¶

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

Tutarsızlıklar¶

Tanıtılan terimler¶

İlgili sayfalar¶

• Modüller dizini
• Taraf birleştirme
• Parties alt modülü
• Adresler
• İletişim kanalları
• Kişi dilleri
• Ayarlar ve başvuru verileri
• Owned organisations modülü
• Bu modülün API başvurusu
• İlgili malzeme, tarihsel, doğrulanmadı: ağaç içi not src/cluster_erp/modules/parties/docs/how-to.md. Konuşulan dilleri, rehberli oluşturmayı ve rol etkinleştirmeyi kapsamaz.

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