Adresler başvurusu · Cluster ERP Wiki

Bu sayfa src/cluster_erp/modules/parties/addresses/ içindeki addresses alt modülünün alanlarını, uçlarını ve kurallarını listeler. Bir adres tek bir tarafa ve tek bir ülkeye aittir ve ülkenin adres seviyelerini ve değerlerini gösteren bileşenlerden oluşur. Seviyeler ve değerler başvuru verileridir; ayarlar ve başvuru verileri sayfasında anlatılır.

Kapsam ve kaynak¶

Tanımlandığı yer: src/cluster_erp/modules/parties/addresses/models.py (Address, AddressComponent), schemas.py (AddressType, AddressCreate, AddressUpdate), services.py (AddressService), routes.py; metadata ADDRESS_META, src/cluster_erp/modules/parties/parties/metadata.py:1181 içinde.
Sayım: 2 tablo; 7 uç (routes.py içindeki @router. dekoratörleri); 7 adres türü (AddressType üyeleri).

Adres alanları¶

Ad	Tür	Varsayılan	Anlam	Kaynak
`code`	`String(20)`, benzersiz	`address` dizisinden	İş anahtarı	`src/cluster_erp/modules/parties/addresses/models.py:19`, `src/cluster_erp/modules/parties/addresses/services.py:57`
`party_id`	`parties_parties.id` alanına yabancı anahtar	yok	Sahip taraf	`src/cluster_erp/modules/parties/addresses/models.py:20-22`
`country_id`	`parties_countries.id` alanına yabancı anahtar	yok	Adresin ülkesi	`src/cluster_erp/modules/parties/addresses/models.py:23-27`
`address_type`	`String(30)`	yok	`billing`, `shipping`, `headquarters`, `branch`, `home`, `work`, `other` değerlerinden biri	`src/cluster_erp/modules/parties/addresses/models.py:28`, `src/cluster_erp/modules/parties/addresses/schemas.py:10-17`
`label`	`String(100)`	yok	Adresin kısa adı	`src/cluster_erp/modules/parties/addresses/models.py:29`
`street_line_1`, `street_line_2`	`String(500)`	yok	Sokak satırları	`src/cluster_erp/modules/parties/addresses/models.py:30-31`
`postal_code`	`String(20)`	yok	Posta kodu	`src/cluster_erp/modules/parties/addresses/models.py:32`
`full_text`	`Text`	hesaplanır	Servisin oluşturduğu tek satırlık metin	`src/cluster_erp/modules/parties/addresses/models.py:33`, `src/cluster_erp/modules/parties/addresses/services.py:194-208`
`is_primary`	bool	`False`	Tarafın birincil adresi	`src/cluster_erp/modules/parties/addresses/models.py:34`
`is_active`	bool	`True`	Etkinlik bayrağı	`src/cluster_erp/modules/parties/addresses/models.py:35`

Adres bileşenleri¶

Ad	Tür	Anlam	Kaynak
`address_id`	`parties_addresses.id` alanına yabancı anahtar	Adres	`src/cluster_erp/modules/parties/addresses/models.py:47-51`
`address_level_id`	`parties_address_levels.id` alanına yabancı anahtar	Seviye, örneğin il	`src/cluster_erp/modules/parties/addresses/models.py:52-56`
`level_value_id`	`parties_address_level_values.id` alanına yabancı anahtar	O seviyede seçilen değer	`src/cluster_erp/modules/parties/addresses/models.py:57-61`

Uçlar¶

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

Yöntem ve yol	Amaç	İzin	Kaynak
`GET /addresses/all`	Taraflar arası adres sayfası; `search`, `party_id`, `address_type` süzgeçleri	`address.read`	`src/cluster_erp/modules/parties/addresses/routes.py:29-89`
`GET /{party_id}/addresses`	Bir tarafın adresleri	`address.read`	`src/cluster_erp/modules/parties/addresses/routes.py:92-101`
`POST /{party_id}/addresses`	Oluşturma	`address.create`	`src/cluster_erp/modules/parties/addresses/routes.py:104-116`
`GET /addresses/{address_id}`	Tek adres	`address.read`	`src/cluster_erp/modules/parties/addresses/routes.py:119-129`
`PUT /addresses/{address_id}`	Güncelleme	`address.update`	`src/cluster_erp/modules/parties/addresses/routes.py:132-143`
`POST /addresses/bulk-delete`	Birkaçını geçici silme	`address.bulk_delete`	`src/cluster_erp/modules/parties/addresses/routes.py:146-154`
`DELETE /addresses/{address_id}`	Birini geçici silme	`address.delete`	`src/cluster_erp/modules/parties/addresses/routes.py:157-165`

GET /addresses/all ucunun party_id ve address_type süzgeçleri diğer formlardaki bağımlı teslimat adresi seçicisine hizmet eder: seçilen bir taraf yalnızca kendi adreslerinden tek bir türdekileri gösterir (src/cluster_erp/modules/parties/addresses/services.py:156-161).

Kısıtlar ve doğrulama¶

Oluşturma veya güncellemede is_primary ayarlamak, tarafın diğer canlı adreslerindeki bayrağı temizler (src/cluster_erp/modules/parties/addresses/services.py:54-55, src/cluster_erp/modules/parties/addresses/services.py:92-93, src/cluster_erp/modules/parties/addresses/services.py:184-192).
components gönderen bir güncelleme eski bileşenleri geçici olarak siler ve yenilerini ekler (src/cluster_erp/modules/parties/addresses/services.py:100-111).
full_text bileşen değerlerini (address_level_id değerine göre sıralı), sokak satırlarını ve posta kodunu virgüllerle birleştirir ve her oluşturma ve güncellemeden sonra yeniden kurulur (src/cluster_erp/modules/parties/addresses/services.py:82, src/cluster_erp/modules/parties/addresses/services.py:114, src/cluster_erp/modules/parties/addresses/services.py:194-208).
Taraflar arası liste silinmiş tarafların adreslerini dışarıda bırakır (src/cluster_erp/modules/parties/addresses/services.py:142-154).
Diğer modüller adresleri GetAddressById ve GetPartyPrimaryAddress ile okur. İkincisi istenen türdeki birincil adresi, yoksa herhangi bir birincil adresi, o da yoksa en eski canlı adresi döndürür (src/cluster_erp/modules/parties/module.py:227-269).

Tanıtılan terimler¶

Terim	Kod tanımlayıcısı	Tanım	Türkçe terim	Kaynak
address component	`AddressComponent`	Bir adresin tek bir seviye değeri, örneğin ili veya ilçesi.	Adres bileşeni	`src/cluster_erp/modules/parties/addresses/models.py:44`
primary address	`is_primary`	Bir tarafın ana adresi olarak işaretlediği tek adres.	Birincil adres	`src/cluster_erp/modules/parties/addresses/models.py:34`

İlgili sayfalar¶

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